node-autotask 0.37.1 → 0.38.0

package/dist/{chunk-7IADHNBZ.js → chunk-4QHGCYEI.js}

@@ -1,6 +1,9 @@
 import {
   CAPABILITIES
-} from "./chunk-KQ6HMBB4.js";
+} from "./chunk-U3K6IDKB.js";
+import {
+  wrapUntrusted
+} from "./chunk-5VHSLJMR.js";
 
 // src/auth.ts
 var AUTH_HEADERS = {
@@ -2067,7 +2070,7 @@ function validateCondition(cond, path) {
   }
   if (op === "in" || op === "notIn") {
     if (!Array.isArray(cond.value)) {
-      throw new AutotaskConfigError(`Operator "${op}" requires an array "value" at ${path}`);
+      throw new AutotaskConfigError(`Operator "${op}" requires an array or comma-separated string "value" at ${path}`);
     }
   }
   if (cond.value !== void 0) {
@@ -2125,7 +2128,7 @@ function validateFilter(filter) {
   }
 }
 function buildFilter(conditions) {
-  const list = Array.isArray(conditions) ? conditions : [conditions];
+  const list = normalizeInValues(Array.isArray(conditions) ? conditions : [conditions]);
   if (list.length === 0) {
     throw new AutotaskConfigError("buildFilter requires at least one condition");
   }
@@ -2136,12 +2139,32 @@ function buildFilter(conditions) {
 }
 function normalizedConditions(filter) {
   if (filter === void 0 || filter === null) return void 0;
-  if (Array.isArray(filter)) return filter;
-  if (isRecord2(filter) && Array.isArray(filter.filter)) return filter.filter;
+  if (Array.isArray(filter)) return normalizeInValues(filter);
+  if (isRecord2(filter) && Array.isArray(filter.filter)) return normalizeInValues(filter.filter);
   throw new AutotaskConfigError(
     `filter must be a conditions array or { filter: [...] } (e.g. { filter: [{ field: 'status', op: 'eq', value: 'Open' }] }) \u2014 got ${refusedFilterShape(filter)}`
   );
 }
+function normalizeInValues(conditions, path = "filter") {
+  const out = conditions.map((cond, i) => normalizeInCondition(cond, `${path}[${i}]`));
+  return out.every((cond, i) => cond === conditions[i]) ? conditions : out;
+}
+function normalizeInCondition(cond, path) {
+  if (!isRecord2(cond)) return cond;
+  if (Array.isArray(cond.items)) {
+    const items = normalizeInValues(cond.items, `${path}.items`);
+    return items === cond.items ? cond : { ...cond, items };
+  }
+  if (cond.op !== "in" && cond.op !== "notIn" || typeof cond.value !== "string") return cond;
+  const tokens = cond.value.split(",").map((t) => t.trim()).filter((t) => t.length > 0);
+  if (tokens.length === 0) {
+    throw new AutotaskConfigError(
+      `Operator "${cond.op}" at ${path} has an empty value list \u2014 pass an array or a comma-separated string with at least one value (e.g. "1,2,3")`
+    );
+  }
+  const value = cond.udf === true ? tokens : tokens.map((t) => String(Number(t)) === t ? Number(t) : t);
+  return { ...cond, value };
+}
 function refusedFilterShape(filter) {
   if (isRecord2(filter) && !("filter" in filter)) return "an object missing the filter field";
   if (isRecord2(filter)) return "an object whose filter is not a conditions array";
@@ -2149,6 +2172,19 @@ function refusedFilterShape(filter) {
   if (t === "object" || t === "function") return "an object";
   return t === "string" ? "a string" : `a ${t}`;
 }
+function assertNoRelationLeaf(conditions, operation) {
+  if (!Array.isArray(conditions)) return;
+  for (const c of conditions) {
+    if (!isRecord2(c)) continue;
+    if (Array.isArray(c.items)) assertNoRelationLeaf(c.items, operation);
+    else if (c.udf !== true && typeof c.field === "string" && c.field.includes(".")) {
+      throw new AutotaskConfigError(
+        `${operation}: filter field "${c.field}" is a relation filter that was not resolved on this path \u2014 the request was not issued`,
+        { operation, suggestedAction: "Use a query surface that resolves relation filters (query, queryAll, queryBounded, count, operations.aggregate), or filter by the <relation>ID field directly." }
+      );
+    }
+  }
+}
 
 // src/http/request-builders.ts
 function assertSafePath(path) {
@@ -17452,6 +17488,7 @@ var HttpClient = class {
     const url = buildUrl(this.baseUrl, opts.path, opts.query);
     const headers = withAuthHeaders(opts.headers, this.auth);
     assertCredentialShape(headers, this.auth);
+    if (opts.path.includes("/query")) assertNoQueryRelationLeaf(opts);
     if (opts.body !== void 0) headers["Content-Type"] = "application/json";
     const bodyText = opts.body !== void 0 ? JSON.stringify(opts.body) : void 0;
     const correlationId = newCorrelationId();
@@ -17539,6 +17576,20 @@ var HttpClient = class {
     }
   }
 };
+function assertNoQueryRelationLeaf(opts) {
+  const operation = opts.operation ?? opts.path;
+  const body = opts.body;
+  if (body !== null && typeof body === "object") assertNoRelationLeaf(body.filter, operation);
+  const search = opts.query?.["search"];
+  if (typeof search !== "string") return;
+  let parsed;
+  try {
+    parsed = JSON.parse(search);
+  } catch {
+    return;
+  }
+  if (parsed !== null && typeof parsed === "object") assertNoRelationLeaf(parsed.filter, operation);
+}
 
 // src/operations/requiredFields.ts
 function effectiveRequiredFields(record, zoneFacts) {
@@ -17663,395 +17714,1227 @@ function resolveFieldsPreset(name, resourceKey, explicitIncludeFields) {
   return [...preset.fields];
 }
 
-// src/resources/base/types.ts
-var BOUNDED_QUERY_DEFAULT_LIMIT = 500;
-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();
+// src/operations/expandResourceNames.ts
+var EXPAND_RESOURCE_NAMES_MAX_IDS = 500;
+function composeName(record) {
+  const parts = [];
+  for (const field of ["firstName", "middleName", "lastName"]) {
+    const value = record[field];
+    if (typeof value === "string" && value.trim() !== "") parts.push(value.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 = EMPTY_REASON_STAMPS[key]?.update;
-  if (pinned === void 0) return;
-  err.details = { ...err.details ?? {}, emptyReason: pinned };
+  return parts.length > 0 ? parts.join(" ") : null;
 }
-function buildDryRunResult(spec, policy = { redactPersonalData: true }) {
-  if (spec.operation === "") {
-    throw new AutotaskConfigError("dry-run: the operation name is required");
+async function expandResourceNames(client, ids2, opts = {}) {
+  if (opts.maxIds !== void 0 && (!Number.isInteger(opts.maxIds) || opts.maxIds < 1)) {
+    throw new AutotaskConfigError(`expandResourceNames: maxIds must be an integer >= 1 (got ${String(opts.maxIds)})`);
   }
-  const wouldApply = spec.checks.every((check) => check.ok);
-  const resource = 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: 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 });
+  const cap = Math.min(EXPAND_RESOURCE_NAMES_MAX_IDS, opts.maxIds ?? EXPAND_RESOURCE_NAMES_MAX_IDS);
+  if (!Array.isArray(ids2) || ids2.length === 0) {
+    throw new AutotaskConfigError(
+      "expandResourceNames: ids must be a non-empty array of vendor numeric resource ids (a zero-id call is a shape error, not a no-op)",
+      { suggestedAction: "Pass at least one vendor numeric resource id \u2014 safe integer, or the canonical integer string for ids above 2^53." }
+    );
   }
-  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;
+  if (ids2.length > cap) {
+    throw new AutotaskConfigError(
+      `expandResourceNames: ${ids2.length} ids over the ${cap}-id cap (EXPAND_RESOURCE_NAMES_MAX_IDS = ${EXPAND_RESOURCE_NAMES_MAX_IDS}; maxIds may lower, never raise) \u2014 zero ids were fetched (pre-request)`,
+      { suggestedAction: `Split the call into groups of <= ${cap} ids.` }
+    );
   }
-  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");
+  const problems = [];
+  const canonical = [];
+  for (let i = 0; i < ids2.length; i += 1) {
+    const at = `ids[${i}]`;
+    const raw = ids2[i];
+    try {
+      canonical[i] = parseIdentifier(raw, at);
+    } catch {
+      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") {
+        problems.push(`${at}: ${raw} is not a non-negative safe integer (a JS number this large is already corrupted \u2014 pass the canonical integer string form)`);
+      } else {
+        problems.push(`${at}: required \u2014 the vendor numeric resource id (safe integer, or the canonical integer string for ids above 2^53)`);
       }
-      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 DEPLURAL_EXCEPTIONS[stripped] ?? stripped;
-  }
-  return snake;
-}
-
-// src/resources/base/query.ts
-var QueryBase = class {
-  http;
-  config;
-  /** Default page size for query walks (the client's resolved `pageSize`). */
-  defaultPageSize;
-  /** Versioned global URL segment (from the config), e.g. '/V1.0/Companies'. */
-  get resourcePath() {
-    return this.config.resourcePath;
-  }
-  /** The vendor entity this resource's ids identify (issue #116 — the `details.idRefs` label, e.g. `company`). */
-  get entityName() {
-    return entityNameFromPath(this.resourcePath);
-  }
-  /** Parent-scoped template (from the config); undefined for top-level resources. */
-  get parentScopedPath() {
-    return this.config.parentScopedPath;
-  }
-  /** Parent field used to narrow the global query (from the config). */
-  get parentField() {
-    return this.config.parentField;
-  }
-  /** The bounded client-scan caps (section 19.2; resolved per client). */
-  get resolutionCaps() {
-    return this.http.resolution;
+  if (problems.length > 0) {
+    throw new AutotaskConfigError(`expandResourceNames: ${problems.length} problem(s) found pre-request (zero wire was issued)
+- ` + problems.join("\n- "), {
+      suggestedAction: "Fix every id above and call again \u2014 the ids are vendor NUMERIC resource ids only (name-to-id resolution is operations.resolveAny territory)."
+    });
   }
-  constructor(http, config, pageSize) {
-    if (config.key === "" || config.resourcePath === "") {
-      throw new AutotaskConfigError("BaseResource requires a non-empty key and resourcePath");
+  const unique = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const id of canonical) {
+    const k = String(id);
+    if (!seen.has(k)) {
+      seen.add(k);
+      unique.push(id);
     }
-    this.http = http;
-    this.config = config;
-    this.defaultPageSize = clampPageSize(pageSize ?? DEFAULT_PAGE_SIZE);
   }
-  // ------------------------------------------------------------------
-  // Query walk (wired to the G3 walker; cursor-follow per the pinned wire)
-  // ------------------------------------------------------------------
-  /** One page fetch: page 1 POSTs the QueryModel body; later pages POST the same body (`buildQueryBody`) to the absolute cursor (issue #118). */
-  async fetchPage(params, page, pageSize, state) {
-    const operation = `${this.config.key}.query`;
-    if (page === 1) {
-      const req = buildQueryRequest(this.http.baseUrl, this.resourcePath, { ...params, maxRecords: pageSize });
-      const body2 = await this.http.request({ ...req, operation });
-      return this.readPage(body2, page, pageSize, state);
-    }
-    const cursor = state.cursor;
-    if (cursor === null) {
-      throw new AutotaskError(`No pagination cursor available for page ${page} of ${operation}`, {
-        code: "INVALID_RESPONSE",
-        category: "server",
-        operation
-      });
+  const holder = client.resources;
+  const cache = client.http.resourceNameCache;
+  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 hit = cache.get(id);
+      if (hit !== void 0) {
+        byId.set(k, { name: hit.name, blind: hit.blind });
+        continue;
+      }
     }
-    const body = buildQueryBody({ ...params, maxRecords: pageSize });
-    const res = await this.http.request({
-      method: "POST",
-      path: cursorToPath(this.http.baseUrl, cursor),
-      body,
-      operation,
-      idempotent: true
-    });
-    return this.readPage(res, page, pageSize, state);
-  }
-  /** @internal */
-  readPage(body, page, pageSize, state) {
-    const { items, pageDetails } = unwrapItems(body, `${this.config.key}.query`);
-    state.cursor = pageDetails.nextPageUrl ?? null;
-    const hasMore = state.cursor !== null;
-    return {
-      items,
-      page,
-      pageSize,
-      // Verbatim vendor echo of MaxRecords — NOT a match count (live-verified).
-      requestCount: pageDetails.requestCount,
-      // No vendor total exists: the pages known so far (exact on the last page).
-      totalPages: hasMore ? page + 1 : items.length === 0 ? page - 1 : page,
-      hasMore
-    };
+    const epoch = cache?.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);
   }
-  /** Build the per-walk fetcher (closure keeps cursor state private to this walk). */
-  pageFetcher(params) {
-    const state = { cursor: null };
-    const p = params ?? {};
-    return (page, pageSize) => this.fetchPage(p, page, pageSize, state);
+  const results = [];
+  for (const id of canonical) {
+    const out = byId.get(String(id));
+    results.push({ id, name: out.name, blind: out.blind, ...out.error !== void 0 ? { error: out.error } : {} });
   }
-  /** @internal */
-  walkPageSize(params) {
-    return clampPageSize(params?.maxRecords ?? this.defaultPageSize);
+  const resolved = results.filter((r) => r.name !== null).length;
+  const blind = results.filter((r) => r.blind === true).length;
+  const failed = results.filter((r) => r.error !== void 0).length;
+  return { results, resolved, blind, failed };
+}
+
+// src/operations/entityType.ts
+function buildEntityTypeMap() {
+  const exact = {};
+  for (const [resource, entry] of Object.entries(RELATIONSHIP_MAP)) {
+    const apiEntity = entry.apiEntity;
+    if (typeof apiEntity !== "string" || apiEntity === "") continue;
+    if (exact[apiEntity] === void 0) exact[apiEntity] = resource;
   }
-  /** Stream items across pages (the resource `query` surface). */
-  queryItems(params) {
-    return paginateItems(this.pageFetcher(params), { pageSize: this.walkPageSize(params) });
+  const aliases = {};
+  for (const [apiEntity, resource] of Object.entries(exact)) {
+    if (!apiEntity.endsWith("s") || apiEntity.endsWith("ss")) continue;
+    const singular = apiEntity.slice(0, -1);
+    if (exact[singular] !== void 0 || aliases[singular] !== void 0) continue;
+    aliases[singular] = resource;
   }
-  /** Stream page objects (the resource `queryPages` surface). */
-  queryPageIter(params) {
-    return paginate(this.pageFetcher(params), { pageSize: this.walkPageSize(params) });
+  return { ...exact, ...aliases };
+}
+var ENTITY_TYPE_TO_RESOURCE = buildEntityTypeMap();
+var ENUMERABLE_RESOURCES = new Set(
+  CAPABILITIES.filter((rec) => rec.resource !== "operations" && (rec.operation === "query" || rec.operation === "get")).map(
+    (rec) => rec.resource
+  )
+);
+function resourceForEntityType(entityType) {
+  if (typeof entityType !== "string" || entityType === "") return null;
+  return ENTITY_TYPE_TO_RESOURCE[entityType] ?? null;
+}
+function isEnumerableResource(resource) {
+  if (typeof resource !== "string" || resource === "") return false;
+  return ENUMERABLE_RESOURCES.has(resource);
+}
+
+// src/operations/types.ts
+var WORKFLOW_RESOURCES = [
+  "companies",
+  "tickets",
+  "contacts",
+  "configuration_items",
+  "projects"
+];
+
+// src/operations/fieldCatalog.ts
+var MAX_FIELD_CATALOG_WIRE = 60;
+var FIELD_CATALOG_HONESTY_NOTE = "Live field metadata reports the SHAPE of a field (existence, requiredness, type, maxLength, read-only, queryable, picklist-ness) as FLAGS and NAMES: picklist-ness as a flag (isPickList) and picklist field names (picklistFields). With the opt-in `labels: true`, picklist rows carry the vendor's exposed picklist VALUES (labels next to each value); without it the op serves no VALUES. It cannot resolve a picklist VALUE the vendor does not expose to this API user (the W-A4 wall \u2014 e.g. the attachments Type picklist): retrying the catalog will not surface a withheld value; that gap is vendor-side, not a client defect.";
+var FIELD_CATALOG_OPT_KEYS = ["resources", "include", "fresh", "fields", "labels"];
+function projectFieldRow(raw, labels = false, udf = false) {
+  const r = typeof raw === "object" && raw !== null ? raw : {};
+  const name = typeof r.name === "string" ? r.name : "";
+  const type = typeof r.dataType === "string" ? r.dataType : typeof r.type === "string" ? r.type : "";
+  const values = labels && r.isPickList === true && Array.isArray(r.picklistValues) && r.picklistValues.length > 0 ? r.picklistValues : void 0;
+  const referenceEntityType = typeof r.referenceEntityType === "string" ? r.referenceEntityType : "";
+  const targetResource = resourceForEntityType(referenceEntityType);
+  return {
+    name,
+    ...typeof r.label === "string" && r.label !== "" ? { label: r.label } : {},
+    type,
+    isRequired: r.isRequired === true,
+    isReadOnly: r.isReadOnly === true,
+    // Issue #219 N7: a UDF row never serves the vendor's isQueryable (it is
+    // true for UDFs while a plain filter on a UDF name is refused); it serves
+    // the marker the filter actually needs.
+    ...udf ? { filterable: "udf-marker" } : { isQueryable: r.isQueryable === true },
+    isPickList: r.isPickList === true,
+    ...isObjectOrArrayType(type) ? { writeShape: "replace-all" } : {},
+    maxLength: typeof r.length === "number" ? r.length : null,
+    referenceEntityType,
+    targetResource,
+    targetEnumerable: isEnumerableResource(targetResource),
+    ...values !== void 0 ? { picklistValues: values } : {}
+  };
+}
+function isObjectOrArrayType(type) {
+  const t = type.trim().toLowerCase();
+  return t === "object" || t === "array" || t === "collection" || t.endsWith("[]");
+}
+function exposesPicklistValues(raw) {
+  const r = typeof raw === "object" && raw !== null ? raw : {};
+  return Array.isArray(r.picklistValues) && r.picklistValues.length > 0;
+}
+function applyFieldsFilter(projected, filter, row) {
+  const kept = filter === void 0 ? projected : projected.filter((f) => filter.includes(f.name));
+  if (filter !== void 0) {
+    const present = new Set(projected.map((f) => f.name));
+    row.unmatchedFields = filter.filter((n) => !present.has(n));
+    row.projected = true;
   }
-  /** Collect every item across all pages (the resource `queryAll` surface; 1000-page guarded). */
-  async queryAllItems(params) {
-    return collectAll(this.pageFetcher(params), { pageSize: this.walkPageSize(params), maxRecords: params?.maxTotalRecords });
+  row.fields = kept;
+  row.required = kept.filter((f) => f.isRequired).map((f) => f.name);
+  row.readOnly = kept.filter((f) => f.isReadOnly).map((f) => f.name);
+  row.queryable = kept.filter((f) => f.isQueryable).map((f) => f.name);
+  row.picklistFields = kept.filter((f) => f.isPickList).map((f) => f.name);
+}
+function capabilitySets() {
+  const fieldOps = /* @__PURE__ */ new Map();
+  const udfCapable = /* @__PURE__ */ new Set();
+  const resources = /* @__PURE__ */ new Set();
+  for (const rec of CAPABILITIES) {
+    if (rec.resource === "operations") continue;
+    resources.add(rec.resource);
+    if (rec.operation === "getFieldInfo") fieldOps.set(rec.resource, rec);
+    if (rec.udfCapable) udfCapable.add(rec.resource);
   }
-  /**
-   * `queryBounded` — server-side pagination (the MCP query surface): ONE call
-   * walks the vendor cursor internally until `limit` TOTAL records are
-   * collected or the cursor is exhausted, and returns a bounded,
-   * complete-enough result. The client never owns the walk:
-   * - `limit` = total records (default 500, hard max 2500 — above it throws
-   *   AutotaskConfigError; it is NOT a page size). The page-1 request uses
-   *   the internal page size min(500, limit) (the `latest` mechanism sizes
-   *   its walk from the matching count); every follow-up page POSTs the
-   *   SAME QueryModel body (`buildQueryBody`: MaxRecords, IncludeFields and
-   *   the preserved filter) to the absolute cursor (issue #118 — the vendor
-   *   honours IncludeFields there and ignores MaxRecords, serving its own
-   *   page size), so the walk reuses `fetchPage` (the shared cursor machinery)
-   *   with a per-walk closure state (walks never share state).
-   * - The 1000-page guard still applies as a SOFT stop: a walk that would
-   *   fetch a 1001st page stops with `hasMore: true` (never a throw — this
-   *   is a bounded read, not the `paginate` generator's error path).
-   * - `hasMore` = (truncated by limit OR guard) AND (a non-null next cursor
-   *   was seen at the stop point OR the final page was sliced to meet the
-   *   limit). Cursor exhausted, or a short/empty page with no truncation →
-   *   false (never claims more than the cursor + the slice say exist).
-   * - `count` is always omitted: `pageDetails.count` is the current page's
-   *   record count (vendor-documented), never a total — `<resource>.count`
-   *   is the total.
-   * - Issue #59: `latest: N` (validated pre-request, zero wire) delegates to
-   *   `latestWalk` — the count-anchored N-highest-id mechanism; ABSENT, the
-   *   walk below is bit-for-bit the existing path.
-   * Pure read; no mutation paths involved.
-   */
-  async queryBounded(params) {
-    if (Array.isArray(params)) {
-      throw new AutotaskConfigError(
-        "queryBounded: params must be an object { filter?, limit?, latest?, includeFields? } \u2014 a bare conditions array is not accepted (wrap it: { filter: [...] })"
-      );
+  return { fieldOps, udfCapable, resources };
+}
+var derivedIndex = null;
+function derivedFieldsFor(resource) {
+  if (derivedIndex === null) {
+    derivedIndex = /* @__PURE__ */ new Map();
+    for (const rec of CAPABILITIES) {
+      const declared = rec.metadata?.derivedFields;
+      if (!Array.isArray(declared) || derivedIndex.has(rec.resource)) continue;
+      const rows = [];
+      for (const row of declared) {
+        if (typeof row?.field !== "string" || typeof row.rule !== "string") continue;
+        rows.push({
+          field: row.field,
+          rule: row.rule,
+          ...typeof row.writableRoute === "string" ? { writableRoute: row.writableRoute } : {}
+        });
+      }
+      derivedIndex.set(rec.resource, rows);
     }
-    const limit = params?.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`
+  }
+  return derivedIndex.get(resource) ?? [];
+}
+function apiEntityFor(rec) {
+  const m = /^GET \/V1\.0\/([^/]+)\/entityInformation\/fields$/.exec(rec.endpoint ?? "");
+  if (m === null) {
+    throw new AutotaskConfigError(
+      `fieldCatalog: the plan's getFieldInfo endpoint for "${rec.resource}" has no /V1.0/<Entity>/entityInformation/fields shape (${rec.endpoint}) \u2014 plan defect`,
+      { operation: "operations.fieldCatalog" }
+    );
+  }
+  return m[1];
+}
+function validateCatalogOptsShape(opts) {
+  if (opts !== void 0 && (typeof opts !== "object" || opts === null || Array.isArray(opts))) {
+    throw new AutotaskConfigError(
+      "fieldCatalog: opts must be an object { resources?: string[], include?: (info|fields|udf)[], fresh?: boolean, fields?: string[], labels?: boolean }"
+    );
+  }
+  for (const key of Object.keys(opts ?? {})) {
+    if (!FIELD_CATALOG_OPT_KEYS.includes(key)) {
+      throw new AutotaskConfigError(
+        `fieldCatalog: unknown opts key "${key}" \u2014 the bag is closed: ${FIELD_CATALOG_OPT_KEYS.join(", ")}`,
+        { suggestedAction: "Drop the unknown key (autotask_describe(operations.fieldCatalog) shows the exact bag)." }
       );
     }
-    const noteChars = params?.noteChars;
-    if (noteChars !== void 0 && (!Number.isInteger(noteChars) || noteChars < 1)) {
+  }
+}
+function resolveInclude(opts) {
+  const includeRaw = opts?.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)");
+  }
+  const include = [];
+  for (const kind of includeRaw) {
+    if (typeof kind !== "string" || !FIELD_CACHE_KINDS.includes(kind)) {
       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)`
+        `fieldCatalog: unknown include kind "${String(kind)}" \u2014 the valid kinds are: ${FIELD_CACHE_KINDS.join(", ")}`,
+        { suggestedAction: `Filter with one or more of: ${FIELD_CACHE_KINDS.join(", ")} (default ['fields']).` }
       );
     }
-    const walkParams = params?.fieldsPreset !== void 0 ? { ...params, includeFields: resolveFieldsPreset(params.fieldsPreset, this.config.key, params.includeFields) } : params ?? {};
-    const latest = walkParams.latest;
-    if (latest !== void 0) {
-      if (!Number.isInteger(latest) || latest < 1 || latest > BOUNDED_QUERY_MAX_LIMIT) {
-        throw new AutotaskConfigError(
-          `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 (params?.limit !== void 0 && limit < latest) {
+    if (!include.includes(kind)) include.push(kind);
+  }
+  return include;
+}
+function resolveTargets(opts, fieldOps, allResources) {
+  const resourcesRaw = opts?.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");
+  }
+  const targets = [];
+  for (const r of resourcesRaw) {
+    if (typeof r !== "string" || r.trim() === "") {
+      throw new AutotaskConfigError(
+        `fieldCatalog: opts.resources must contain non-empty plan resource key strings (got ${typeof r === "string" && r.trim() === "" ? "a blank string" : typeof r})`
+      );
+    }
+    const key = r.trim();
+    const fieldOp = fieldOps.get(key);
+    if (fieldOp === void 0) {
+      if (allResources.has(key)) {
         throw new AutotaskConfigError(
-          `queryBounded: limit (${String(limit)}) must be >= latest (${String(latest)}) \u2014 latest governs the returned count and limit is the walk window`
+          `fieldCatalog: resource "${key}" has no field catalog \u2014 the vendor defines the entityInformation trio for the ${fieldOps.size} plan entity resources only`,
+          { suggestedAction: `Pass one of the ${fieldOps.size} field-capable plan keys (list them with autotask_catalog).` }
         );
       }
-      return this.applyNoteChars(await this.latestWalk(walkParams, Math.max(limit, latest), latest), noteChars);
+      throw new AutotaskError(
+        `fieldCatalog: unknown resource "${key}" \u2014 the plan has ${fieldOps.size} field-capable resources`,
+        {
+          code: "RESOURCE_UNKNOWN",
+          category: "validation",
+          suggestedAction: "Pass the exact plan resource key (snake_case) from autotask_catalog (e.g. tickets, companies, configuration_items)."
+        }
+      );
     }
-    const { items, pages, guard, sliced, cursor } = await this.walkBounded(walkParams, limit);
-    const hasMore = (items.length >= limit || guard) && (sliced > 0 || cursor !== null);
-    const result = { items, fetched: items.length, hasMore, pagesWalked: pages };
-    this.stampEmptyQueryResult(result, params);
-    return this.applyNoteChars(result, noteChars);
+    if (!targets.includes(key)) targets.push(key);
   }
-  /** Issue #61 (slice A): the noteChars truncation at the SINGLE chokepoint
-   *  of `queryBounded` — the normal walk and the `latest` paths both
-   *  produced their `BoundedQueryResult` here (the single chokepoint the
-   *  plan pins: R5). Copy-on-truncate (the input records are never
-   *  mutated); the additive `noteCharsTruncated` stamp = the truncated-
-   *  field count, ABSENT when 0. The resource's untrusted-class field set
-   *  is the generated stamp (the SAME plan column the registry's
-   *  `metadata.untrustedFields` channel stamps — zero second source of
-   *  truth); an absent set = the cap is a no-op for the resource (bit-for-
-   *  bit the pre-slice result).
-   * @internal */
-  applyNoteChars(result, noteChars) {
-    if (noteChars === void 0) return result;
-    const fields = UNTRUSTED_FIELDS_BY_RESOURCE[this.config.key];
-    if (fields === void 0 || fields.length === 0) return result;
-    const [items, truncated] = truncateNoteChars(result.items, noteChars, fields);
-    if (truncated > 0) {
-      return { ...result, items, noteCharsTruncated: truncated };
+  return targets;
+}
+function resolveFieldsFilter(opts) {
+  const fieldsRaw = opts?.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");
+  }
+  const names = [];
+  for (const f of fieldsRaw) {
+    if (typeof f !== "string" || f.trim() === "") {
+      throw new AutotaskConfigError(
+        `fieldCatalog: opts.fields must contain non-empty vendor field name strings (got ${typeof f === "string" && f.trim() === "" ? "a blank string" : typeof f})`
+      );
     }
-    return result;
+    const name = f.trim();
+    if (!names.includes(name)) names.push(name);
   }
-  /** The bounded walk loop (shared by the normal `queryBounded` path and the
-   *  `latest` modes): walks the vendor cursor until `limit` TOTAL records
-   *  are collected or the cursor is exhausted; the 1000-page guard is a
-   *  SOFT stop (never a throw). ONE per-walk closure (walks never share
-   *  state).
-   * @internal */
-  async walkBounded(p, limit) {
-    const state = { cursor: null };
-    const items = [];
-    let pages = 0;
-    let sliced = 0;
-    let guard = false;
-    const pageSize = Math.min(MAX_PAGE_SIZE, limit);
-    for (; ; ) {
-      if (pages >= MAX_PAGES) {
-        guard = true;
-        break;
+  return names;
+}
+function resolveLabels(opts) {
+  if (opts !== void 0 && opts.labels !== void 0 && typeof opts.labels !== "boolean") {
+    throw new AutotaskConfigError(
+      `fieldCatalog: opts.labels must be a boolean (got ${typeof opts.labels})`
+    );
+  }
+  return opts?.labels === true;
+}
+function assertWithinWireCap(targetCount, kindCount) {
+  const cost = targetCount * kindCount;
+  if (cost > MAX_FIELD_CATALOG_WIRE) {
+    throw new AutotaskConfigError(
+      `fieldCatalog: ${targetCount} resource(s) \xD7 ${kindCount} kind(s) = ${cost} metadata reads exceed the wire cap of ${MAX_FIELD_CATALOG_WIRE} \u2014 the call is refused above its cap (never truncated)`,
+      { suggestedAction: `Pass a smaller resources list or a narrower include set so the product stays \u2264 ${MAX_FIELD_CATALOG_WIRE}.` }
+    );
+  }
+}
+function kindFetches(holder, resource) {
+  return {
+    info: () => holder?.getEntityInfo?.() ?? Promise.reject(new AutotaskError(`fieldCatalog: the client exposes no getEntityInfo read for "${resource}"`, { code: "INVALID_RESPONSE", category: "server" })),
+    fields: () => holder?.getFieldInfo?.() ?? Promise.reject(new AutotaskError(`fieldCatalog: the client exposes no getFieldInfo read for "${resource}"`, { code: "INVALID_RESPONSE", category: "server" })),
+    udf: () => holder?.getUdfInfo?.() ?? Promise.reject(new AutotaskError(`fieldCatalog: the client exposes no getUdfInfo read for "${resource}"`, { code: "INVALID_RESPONSE", category: "server" }))
+  };
+}
+async function sweepResource(ctx, resource, tally) {
+  const { client, include, fieldsFilter, labels, fresh } = ctx;
+  const cache = client.http.fieldCache;
+  const fieldOp = ctx.fieldOps.get(resource);
+  if (fieldOp === void 0) return void 0;
+  const apiEntity = apiEntityFor(fieldOp);
+  const holder = client[camelKey(resource)];
+  const row = {
+    resource,
+    apiEntity,
+    udfCapable: ctx.udfCapable.has(resource),
+    // Issue #219 N7: the UDF surface is declared with the mechanism, not a boolean.
+    ...ctx.udfCapable.has(resource) ? { udfFilter: "udf-marker", udfWriteShape: "merge" } : {},
+    unmatchedFields: [],
+    required: [],
+    readOnly: [],
+    queryable: [],
+    picklistFields: [],
+    cache: { hit: false, age: null },
+    wire: 0,
+    error: null
+  };
+  const fetches = kindFetches(holder, resource);
+  if (fresh) cache?.invalidate(resource);
+  const projectList = (kind, list) => {
+    const projected = list.map((f) => projectFieldRow(f, labels, kind === "udf"));
+    if (kind === "fields") applyFieldsFilter(projected, fieldsFilter, row);
+    else row.udf = projected;
+    for (const f of list) if (exposesPicklistValues(f)) tally.anyPicklistValues = true;
+  };
+  let allCached = true;
+  const ages = [];
+  for (const kind of include) {
+    const peek = cache !== void 0 && !fresh ? cache.peek(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);
+      if (kind === "info") row.info = value2 ?? null;
+      else projectList(kind, Array.isArray(value2) ? value2 : []);
+      if (peek.age !== null) ages.push(peek.age);
+      continue;
+    }
+    let value;
+    try {
+      value = await fetches[kind]();
+    } catch (err) {
+      if (!isAutotaskError(err) || err.code === "ABORTED") throw err;
+      tally.wireUsed += 1;
+      row.wire += 1;
+      if (row.error === null) row.error = { code: err.code, message: err.message };
+      continue;
+    }
+    tally.wireUsed += 1;
+    row.wire += 1;
+    if (kind === "info") {
+      row.info = value ?? null;
+    } else {
+      if (!Array.isArray(value)) {
+        if (row.error === null) row.error = { code: "INVALID_RESPONSE", message: `fieldCatalog: the ${kind} response for ${resource} was not a list` };
+        continue;
       }
-      const page = await this.fetchPage(p, pages + 1, pageSize, state);
-      pages += 1;
-      const remaining = limit - items.length;
-      const take = page.items.slice(0, remaining);
-      sliced += Math.max(0, page.items.length - remaining);
-      items.push(...take);
-      if (items.length >= limit) break;
-      if (!page.hasMore || page.items.length === 0) break;
+      projectList(kind, value);
     }
-    return { items, pages, guard, sliced, cursor: state.cursor };
   }
-  /** A walk stop is TRUNCATED when the 1000-page guard fired, or the limit
-   *  was met with a live next cursor (or a sliced final page): rows exist
-   *  past the stop point, and a top-N-by-id over the collected set alone is
-   *  unprovable (the `latest` mechanism refuses instead of guessing).
-   * @internal */
-  walkTruncated(limit, stop) {
-    return stop.guard || stop.itemsLength >= limit && (stop.sliced > 0 || stop.cursor !== null);
+  row.cache = allCached ? { hit: true, age: ages.length > 0 ? Math.max(...ages) : 0 } : { hit: false, age: null };
+  const declared = derivedFieldsFor(resource);
+  if (declared.length > 0) {
+    const byField = new Map(declared.map((d) => [d.field, d]));
+    row.derivedFields = declared;
+    for (const field of row.fields ?? []) {
+      const derivation = byField.get(field.name);
+      if (derivation === void 0) continue;
+      field.derived = {
+        rule: derivation.rule,
+        ...derivation.writableRoute !== void 0 ? { writableRoute: derivation.writableRoute } : {}
+      };
+    }
   }
-  /** The 0-item result stamping — the ONE source of truth (the normal walk
-   *  and the `latest` empty outcome both ride it): the typed blind-surface
-   *  sentinel + the pinned empty-reason, through the filter-aware predicate
+  return row;
+}
+async function fieldCatalog(client, opts) {
+  validateCatalogOptsShape(opts);
+  const { fieldOps, udfCapable, resources: allResources } = capabilitySets();
+  const include = resolveInclude(opts);
+  const targets = resolveTargets(opts, fieldOps, allResources);
+  const fieldsFilter = resolveFieldsFilter(opts);
+  const labels = resolveLabels(opts);
+  assertWithinWireCap(targets.length, include.length);
+  const cache = client.http.fieldCache;
+  const zone = client.config.zone ?? "unknown";
+  const rows = [];
+  const tally = { wireUsed: 0, anyPicklistValues: false };
+  const ctx = { client, include, fieldsFilter, labels, fresh: opts?.fresh === true, fieldOps, udfCapable };
+  for (const resource of targets) {
+    const row = await sweepResource(ctx, resource, tally);
+    if (row !== void 0) rows.push(row);
+  }
+  return {
+    zone,
+    label: zone,
+    cached: cache !== void 0,
+    labels,
+    ttlMs: cache?.ttlMs ?? null,
+    fetchedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    rows,
+    wireUsed: tally.wireUsed,
+    cap: MAX_FIELD_CATALOG_WIRE,
+    truncated: false,
+    counts: {
+      resources: targets.length,
+      fieldCapableResources: fieldOps.size,
+      udfCapableResources: udfCapable.size,
+      cached: rows.filter((r) => r.cache.hit === true).length
+    },
+    honesty: {
+      picklistValues: tally.anyPicklistValues ? "partial" : "unexposed",
+      note: FIELD_CATALOG_HONESTY_NOTE
+    }
+  };
+}
+
+// src/field-sets.ts
+var MODEL_FIELD_SETS = {
+  "appointments": ["id", "createDateTime", "creatorResourceID", "description", "endDateTime", "resourceID", "startDateTime", "title", "updateDateTime"],
+  "billing_codes": ["id", "afterHoursWorkType", "billingCodeType", "department", "description", "externalNumber", "generalLedgerAccount", "isActive", "isExcludedFromNewContracts", "markupRate", "name", "taxCategoryID", "unitCost", "unitPrice", "useType"],
+  "billing_item_approval_levels": ["id", "approvalDateTime", "approvalLevel", "approvalResourceID", "timeEntryID"],
+  "billing_items": ["id", "accountManagerWhenApprovedID", "billingCodeID", "billingItemType", "companyID", "configurationItemID", "contractBlockID", "contractChargeID", "contractID", "contractServiceAdjustmentID", "contractServiceBundleAdjustmentID", "contractServiceBundleID", "contractServiceBundlePeriodID", "contractServiceID", "contractServicePeriodID", "description", "expenseItemID", "extendedPrice", "internalCurrencyExtendedPrice", "internalCurrencyRate", "internalCurrencyTaxDollars", "internalCurrencyTotalAmount", "invoiceID", "itemApproverID", "itemDate", "itemName", "lineItemFullDescription", "lineItemGroupDescription", "milestoneID", "nonBillable", "organizationalLevelAssociationID", "ourCost", "postedDate", "postedOnTime", "projectChargeID", "projectID", "purchaseOrderNumber", "quantity", "rate", "roleID", "serviceBundleID", "serviceID", "sortOrderID", "subType", "taskID", "taxDollars", "ticketChargeID", "ticketID", "timeEntryID", "totalAmount", "vendorID", "webServiceDate"],
+  "change_request_links": ["id", "changeRequestTicketID", "problemOrIncidentTicketID"],
+  "checklist_libraries": ["id", "description", "entityType", "isActive", "name"],
+  "checklist_library_checklist_items": ["id", "checklistLibraryID", "isImportant", "itemName", "knowledgebaseArticleID", "position", "soapParentPropertyId"],
+  "classification_icons": ["id", "description", "isActive", "isSystem", "name", "relativeUrl"],
+  "companies": ["id", "additionalAddressInformation", "address1", "address2", "alternatePhone1", "alternatePhone2", "apiVendorID", "assetValue", "billToCompanyLocationID", "billToAdditionalAddressInformation", "billingAddress1", "billingAddress2", "billToAddressToUse", "billToAttention", "billToCity", "billToCountryID", "billToState", "billToZipCode", "city", "classification", "companyCategoryID", "companyName", "companyNumber", "companyType", "competitorID", "countryID", "createDate", "createdByResourceID", "currencyID", "fax", "impersonatorCreatorResourceID", "invoiceEmailMessageID", "invoiceMethod", "invoiceNonContractItemsToParentCompany", "invoiceTemplateID", "isActive", "isClientPortalActive", "isEnabledForComanaged", "isSample", "isTaskFireActive", "isTaxExempt", "lastActivityDate", "lastTrackedModifiedDateTime", "marketSegmentID", "ownerResourceID", "parentCompanyID", "phone", "postalCode", "purchaseOrderTemplateID", "quoteEmailMessageID", "quoteTemplateID", "sicCode", "state", "stockMarket", "stockSymbol", "surveyCompanyRating", "taxID", "taxRegionID", "territoryID", "webAddress", "userDefinedFields"],
+  "company_alerts": ["id", "alertText", "alertTypeID", "companyID", "soapParentPropertyId"],
+  "company_locations": ["id", "address1", "address2", "alternatePhone1", "alternatePhone2", "city", "companyID", "countryID", "description", "fax", "isActive", "isPrimary", "isTaxExempt", "overrideCompanyTaxSettings", "name", "phone", "postalCode", "roundtripDistance", "state", "taxRegionID", "soapParentPropertyId"],
+  "company_notes": ["id", "actionType", "assignedResourceID", "companyID", "completedDateTime", "contactID", "createDateTime", "endDateTime", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "lastModifiedDate", "name", "note", "opportunityID", "startDateTime", "soapParentPropertyId"],
+  "company_site_configurations": ["id", "companyID", "locationName", "soapParentPropertyId", "userDefinedFields"],
+  "company_webhooks": ["id", "deactivationUrl", "isActive", "isReady", "isSubscribedToCreateEvents", "isSubscribedToDeleteEvents", "isSubscribedToUpdateEvents", "name", "notificationEmailAddress", "ownerResourceID", "secretKey", "sendThresholdExceededNotification", "webhookGUID", "webhookUrl"],
+  "configuration_item_billing_product_associations": ["id", "billingProductID", "configurationItemID", "effectiveDate", "expirationDate", "soapParentPropertyId"],
+  "configuration_item_categories": ["id", "displayColorRGB", "isActive", "isClientPortalDefault", "isGlobalDefault", "name", "nickname"],
+  "configuration_item_category_udf_associations": ["id", "configurationItemCategoryID", "isRequired", "userDefinedFieldDefinitionID", "soapParentPropertyId"],
+  "configuration_item_dns_records": ["id", "createDateTime", "data", "installedProductID", "timeToLiveSeconds", "dnsType", "soapParentPropertyId"],
+  "configuration_item_notes": ["id", "configurationItemID", "createDateTime", "creatorResourceID", "description", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "lastActivityDate", "noteType", "title", "soapParentPropertyId"],
+  "configuration_item_related_items": ["id", "configurationItemID", "relatedConfigurationItemID", "relationship", "soapParentPropertyId"],
+  "configuration_item_ssl_subject_alternative_names": ["id", "configurationItemID", "name", "soapParentPropertyId"],
+  "configuration_item_types": ["id", "isActive", "name"],
+  "configuration_item_webhooks": ["id", "deactivationUrl", "isActive", "isReady", "isSubscribedToCreateEvents", "isSubscribedToDeleteEvents", "isSubscribedToUpdateEvents", "name", "notificationEmailAddress", "ownerResourceID", "secretKey", "sendThresholdExceededNotification", "webhookGUID", "webhookUrl"],
+  "configuration_items": ["id", "apiVendorID", "configurationItemCategoryID", "companyID", "companyLocationID", "configurationItemType", "contactID", "contractID", "contractServiceBundleID", "contractServiceID", "createDate", "createdByPersonID", "dailyCost", "dattoAvailableKilobytes", "dattoDeviceMemoryMegabytes", "dattoDrivesErrors", "dattoHostname", "dattoInternalIP", "dattoKernelVersionID", "dattoLastCheckInDateTime", "dattoNICSpeedKilobitsPerSecond", "dattoNumberOfAgents", "dattoNumberOfDrives", "dattoNumberOfVolumes", "dattoOffsiteUsedBytes", "dattoOSVersionID", "dattoPercentageUsed", "dattoProtectedKilobytes", "dattoRemoteIP", "dattoSerialNumber", "dattoUptimeSeconds", "dattoUsedKilobytes", "dattoZFSVersionID", "deviceNetworkingID", "domain", "domainRegistrarID", "domainRegistrationDateTime", "domainLastUpdatedDateTime", "domainExpirationDateTime", "hourlyCost", "impersonatorCreatorResourceID", "installDate", "installedByContactID", "installedByID", "isActive", "lastActivityPersonID", "lastActivityPersonType", "lastModifiedTime", "location", "monthlyCost", "notes", "numberOfUsers", "parentConfigurationItemID", "perUseCost", "productID", "referenceNumber", "referenceTitle", "rmmDeviceAuditAntivirusStatusID", "rmmDeviceAuditArchitectureID", "rmmDeviceAuditBackupStatusID", "rmmDeviceAuditDescription", "rmmDeviceAuditDeviceTypeID", "rmmDeviceAuditDisplayAdaptorID", "rmmDeviceAuditDomainID", "rmmDeviceAuditExternalIPAddress", "rmmDeviceAuditHostname", "rmmDeviceAuditIPAddress", "rmmDeviceAuditLastUser", "rmmDeviceAuditMacAddress", "rmmDeviceAuditManufacturerID", "rmmDeviceAuditFirmwareID", "rmmDeviceAuditMemoryBytes", "rmmDeviceAuditMissingPatchCount", "rmmDeviceAuditMobileNetworkOperatorID", "rmmDeviceAuditMobileNumber", "rmmDeviceAuditModelID", "rmmDeviceAuditMotherboardID", "rmmDeviceAuditOperatingSystem", "rmmDeviceAuditPatchStatusID", "rmmDeviceAuditProcessorID", "rmmDeviceAuditServicePackID", "rmmDeviceAuditSNMPContact", "rmmDeviceAuditSNMPLocation", "rmmDeviceAuditSNMPName", "rmmDeviceAuditSoftwareStatusID", "rmmDeviceAuditStorageBytes", "rmmDeviceID", "rmmDeviceUID", "rmmVsaxDeviceID", "rmmOpenAlertCount", "serialNumber", "serviceBundleID", "serviceID", "serviceLevelAgreementID", "setupFee", "sourceChargeID", "sourceChargeType", "sslSource", "sslCommonName", "sslValidFromDateTime", "sslValidUntilDateTime", "sslIssuedBy", "sslOrganization", "sslOrganizationUnit", "sslLocation", "sslSerialNumber", "sslSignatureAlgorithm", "vendorID", "warrantyExpirationDate", "rmmIsInMaintenanceMode", "rmmIsMobileDeviceManagementEnrolled", "rmmDeviceUrl", "userDefinedFields"],
+  "contact_group_contacts": ["id", "contactId", "contactGroupId", "soapParentPropertyId"],
+  "contact_groups": ["id", "name", "isActive"],
+  "contact_webhooks": ["id", "deactivationUrl", "isActive", "isReady", "isSubscribedToCreateEvents", "isSubscribedToDeleteEvents", "isSubscribedToUpdateEvents", "name", "notificationEmailAddress", "ownerResourceID", "secretKey", "sendThresholdExceededNotification", "webhookGUID", "webhookUrl"],
+  "contacts": ["id", "additionalAddressInformation", "addressLine", "addressLine1", "alternatePhone", "apiVendorID", "bulkEmailOptOutTime", "city", "companyID", "companyLocationID", "countryID", "createDate", "emailAddress", "emailAddress2", "emailAddress3", "extension", "externalID", "facebookUrl", "faxNumber", "firstName", "impersonatorCreatorResourceID", "isActive", "isOptedOutFromBulkEmail", "lastActivityDate", "lastModifiedDate", "lastName", "linkedInUrl", "middleInitial", "mobilePhone", "namePrefix", "nameSuffix", "note", "receivesEmailNotifications", "phone", "primaryContact", "roomNumber", "solicitationOptOut", "solicitationOptOutTime", "state", "surveyOptOut", "title", "twitterUrl", "zipCode", "soapParentPropertyId", "userDefinedFields"],
+  "contract_billing_rules": ["id", "contractID", "createChargesAsBillable", "dailyProratedCost", "dailyProratedPrice", "determineUnits", "endDate", "executionMethod", "includeItemsInChargeDescription", "invoiceDescription", "isActive", "isDailyProrationEnabled", "maximumUnits", "minimumUnits", "productID", "startDate", "soapParentPropertyId"],
+  "contract_block_hour_factors": ["id", "blockHourMultiplier", "contractHourlyRate", "contractID", "internalCurrencyContractHourlyRate", "roleID", "soapParentPropertyId"],
+  "contract_blocks": ["id", "contractID", "datePurchased", "endDate", "hourlyRate", "hours", "hoursApproved", "invoiceNumber", "isPaid", "paymentNumber", "paymentType", "startDate", "status", "soapParentPropertyId"],
+  "contract_charges": ["id", "billableAmount", "billingCodeID", "chargeType", "contractID", "contractServiceBundleID", "contractServiceID", "createDate", "creatorResourceID", "datePurchased", "description", "extendedCost", "internalCurrencyBillableAmount", "internalCurrencyUnitPrice", "internalPurchaseOrderNumber", "isBillableToCompany", "isBilled", "name", "notes", "organizationalLevelAssociationID", "productID", "purchaseOrderNumber", "status", "statusLastModifiedBy", "statusLastModifiedDate", "unitCost", "unitPrice", "unitQuantity", "soapParentPropertyId"],
+  "contract_exclusion_billing_codes": ["id", "billingCodeID", "contractID", "soapParentPropertyId"],
+  "contract_exclusion_roles": ["id", "contractID", "roleID", "soapParentPropertyId"],
+  "contract_exclusion_set_excluded_roles": ["id", "contractExclusionSetID", "excludedRoleID", "soapParentPropertyId"],
+  "contract_exclusion_set_excluded_work_types": ["id", "contractExclusionSetID", "excludedWorkTypeID", "soapParentPropertyId"],
+  "contract_exclusion_sets": ["id", "description", "isActive", "name"],
+  "contract_milestones": ["id", "amount", "billingCodeID", "contractID", "createDate", "creatorResourceID", "dateDue", "description", "internalCurrencyAmount", "isInitialPayment", "organizationalLevelAssociationID", "status", "title", "soapParentPropertyId"],
+  "contract_notes": ["id", "contractID", "createDateTime", "creatorResourceID", "description", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "lastActivityDate", "title", "soapParentPropertyId"],
+  "contract_rates": ["id", "contractHourlyRate", "contractID", "internalCurrencyContractHourlyRate", "roleID", "soapParentPropertyId"],
+  "contract_retainers": ["id", "amount", "amountApproved", "contractID", "datePurchased", "endDate", "internalCurrencyAmount", "internalCurrencyAmountApproved", "invoiceNumber", "isPaid", "paymentID", "paymentNumber", "startDate", "status", "soapParentPropertyId"],
+  "contract_role_costs": ["id", "contractID", "rate", "resourceID", "roleID", "soapParentPropertyId"],
+  "contract_service_bundle_units": ["id", "approveAndPostDate", "contractID", "contractServiceBundleID", "cost", "endDate", "internalCurrencyPrice", "organizationalLevelAssociationID", "price", "serviceBundleID", "startDate", "units", "soapParentPropertyId"],
+  "contract_service_bundles": ["id", "adjustedPrice", "contractID", "internalCurrencyAdjustedPrice", "internalCurrencyUnitPrice", "internalDescription", "invoiceDescription", "quoteItemID", "serviceBundleID", "unitPrice", "soapParentPropertyId"],
+  "contract_service_units": ["id", "approveAndPostDate", "contractID", "contractServiceID", "cost", "endDate", "internalCurrencyPrice", "organizationalLevelAssociationID", "price", "serviceID", "startDate", "units", "vendorCompanyID", "soapParentPropertyId"],
+  "contract_services": ["id", "contractID", "internalCurrencyAdjustedPrice", "internalCurrencyUnitPrice", "internalDescription", "invoiceDescription", "quoteItemID", "serviceID", "unitCost", "unitPrice", "soapParentPropertyId"],
+  "contract_ticket_purchases": ["id", "contractID", "datePurchased", "endDate", "invoiceNumber", "isPaid", "paymentNumber", "paymentType", "perTicketRate", "startDate", "status", "ticketsPurchased", "ticketsUsed", "soapParentPropertyId"],
+  "contracts": ["id", "billingPreference", "billToCompanyContactID", "billToCompanyID", "companyID", "contactID", "contactName", "contractCategory", "contractExclusionSetID", "contractName", "contractNumber", "contractPeriodType", "contractType", "description", "endDate", "estimatedCost", "estimatedHours", "estimatedRevenue", "exclusionContractID", "internalCurrencyOverageBillingRate", "internalCurrencySetupFee", "isCompliant", "isDefaultContract", "lastModifiedDateTime", "opportunityID", "organizationalLevelAssociationID", "overageBillingRate", "purchaseOrderNumber", "renewedContractID", "serviceLevelAgreementID", "setupFee", "setupFeeBillingCodeID", "startDate", "status", "timeReportingRequiresStartAndStopTimes", "userDefinedFields"],
+  "countries": ["id", "addressFormatID", "countryCode", "displayName", "invoiceTemplateID", "isActive", "isDefaultCountry", "name", "purchaseOrderTemplateID", "quoteTemplateID"],
+  "currencies": ["id", "currencyNegativeFormat", "currencyPositiveFormat", "description", "displaySymbol", "exchangeRate", "isActive", "isInternalCurrency", "lastModifiedDateTime", "name", "updateResourceId"],
+  "departments": ["id", "description", "name", "number", "primaryLocationID"],
+  "domain_registrars": ["id", "name", "url"],
+  "expense_item_attachments": ["id", "attachDate", "attachedByContactID", "attachedByResourceID", "attachmentType", "contentType", "creatorType", "expenseItemID", "expenseReportID", "fileSize", "fullPath", "impersonatorCreatorResourceID", "opportunityID", "parentID", "publish", "title", "data", "parentType", "soapParentPropertyId", "isTaskAttachment"],
+  "expense_items": ["id", "companyID", "description", "destination", "entertainmentLocation", "expenseCategory", "expenseCurrencyExpenseAmount", "expenseCurrencyID", "expenseDate", "expenseReportID", "glCode", "haveReceipt", "internalCurrencyExpenseAmount", "internalCurrencyReimbursementAmount", "isBillableToCompany", "isReimbursable", "isRejected", "miles", "odometerEnd", "odometerStart", "origin", "paymentType", "projectID", "purchaseOrderNumber", "reimbursementCurrencyReimbursementAmount", "taskID", "ticketID", "workType", "soapParentPropertyId"],
+  "expense_reports": ["id", "amountDue", "approvedDate", "approverID", "departmentNumber", "internalCurrencyCashAdvanceAmount", "internalCurrencyExpenseTotal", "name", "organizationalLevelAssociationID", "quickBooksReferenceNumber", "reimbursementCurrencyAmountDue", "reimbursementCurrencyCashAdvanceAmount", "reimbursementCurrencyID", "rejectionReason", "status", "submit", "submitDate", "submitterID", "weekEnding"],
+  "holiday_sets": ["id", "holidaySetDescription", "holidaySetName"],
+  "holidays": ["id", "holidayDate", "holidayName", "holidaySetID", "soapParentPropertyId"],
+  "inventory_products": ["id", "availableUnits", "backOrderQuantity", "bin", "createDateTime", "createdByResourceID", "inventoryLocationID", "onHandUnits", "pickedUnits", "productID", "quantityMaximum", "quantityMinimum", "referenceNumber", "reservedUnits", "unitsOnOrder"],
+  "invoice_templates": ["id", "coveredByBlockRetainerContractLabel", "coveredByRecurringServiceFixedPricePerTicketContractLabel", "currencyNegativeFormat", "currencyPositiveFormat", "dateFormat", "displayFixedPriceContractLabor", "displayRecurringServiceContractLabor", "displaySeparateLineItemForEachTax", "displayTaxCategory", "displayTaxCategorySuperscripts", "displayZeroAmountRecurringServicesAndBundles", "groupBy", "itemizeItemsInEachGroup", "itemizeServicesAndBundles", "name", "nonBillableLaborLabel", "numberFormat", "pageLayout", "pageNumberFormat", "paymentTerms", "rateCostExpression", "showGridHeader", "showVerticalGridLines", "sortBy", "timeFormat"],
+  "invoices": ["id", "batchID", "comments", "companyID", "createDateTime", "creatorResourceID", "dueDate", "fromDate", "invoiceDateTime", "invoiceEditorTemplateID", "invoiceNumber", "invoiceTotal", "isVoided", "orderNumber", "paidDate", "paymentTerm", "taxGroup", "taxRegionName", "toDate", "totalTaxValue", "voidedByResourceID", "voidedDate", "webServiceDate"],
+  "notification_history": ["id", "companyID", "entityNumber", "entityTitle", "initiatingContactID", "initiatingResourceID", "isActive", "isDeleted", "isTemplateJob", "notificationHistoryTypeID", "notificationSentTime", "opportunityID", "projectID", "quoteID", "recipientDisplayName", "recipientEmailAddress", "taskID", "templateName", "ticketID", "timeEntryID"],
+  "opportunities": ["id", "advancedField1", "advancedField2", "advancedField3", "advancedField4", "advancedField5", "amount", "assessmentScore", "barriers", "closedDate", "companyID", "contactID", "cost", "createDate", "creatorResourceID", "description", "helpNeeded", "impersonatorCreatorResourceID", "lastActivity", "leadSource", "lossReason", "lossReasonDetail", "lostDate", "market", "monthlyCost", "monthlyRevenue", "nextStep", "onetimeCost", "onetimeRevenue", "opportunityCategoryID", "organizationalLevelAssociationID", "ownerResourceID", "primaryCompetitor", "probability", "productID", "projectedCloseDate", "promisedFulfillmentDate", "promotionName", "quarterlyCost", "quarterlyRevenue", "rating", "relationshipAssessmentScore", "revenueSpread", "revenueSpreadUnit", "salesOrderID", "salesProcessPercentComplete", "semiannualCost", "semiannualRevenue", "stage", "startDate", "status", "technicalAssessmentScore", "throughDate", "title", "totalAmountMonths", "useQuoteTotals", "winReason", "winReasonDetail", "yearlyCost", "yearlyRevenue", "userDefinedFields"],
+  "opportunity_attachments": ["id", "attachDate", "attachedByContactID", "attachedByResourceID", "attachmentType", "contentType", "creatorType", "fileSize", "fullPath", "impersonatorCreatorResourceID", "opportunityID", "parentAttachmentID", "parentID", "publish", "title", "data", "parentType", "soapParentPropertyId", "isTaskAttachment"],
+  "opportunity_categories": ["id", "displayColorRGB", "isActive", "isGlobalDefault", "name", "nickname"],
+  "organizational_level1s": ["id", "description", "isActive", "name"],
+  "organizational_level2s": ["id", "description", "isActive", "name"],
+  "organizational_level_associations": ["id", "isActive", "organizationalLevel1ID", "organizationalLevel2ID"],
+  "phases": ["id", "createDate", "creatorResourceID", "description", "dueDate", "estimatedHours", "externalID", "isScheduled", "lastActivityDateTime", "parentPhaseID", "phaseNumber", "projectID", "startDate", "title", "soapParentPropertyId"],
+  "product_vendors": ["id", "isActive", "isDefault", "productID", "vendorCost", "vendorID", "vendorPartNumber", "soapParentPropertyId"],
+  "products": ["id", "billingType", "chargeBillingCodeID", "createdByResourceID", "createdTime", "defaultVendorID", "description", "doesNotRequireProcurement", "externalProductID", "impersonatorCreatorResourceID", "internalProductID", "isActive", "isEligibleForRma", "isSerialized", "link", "manufacturerName", "manufacturerProductName", "markupRate", "msrp", "name", "periodType", "priceCostMethod", "productBillingCodeID", "productCategory", "sku", "unitCost", "unitPrice", "vendorProductNumber", "defaultInstalledProductCategoryID", "userDefinedFields"],
+  "project_charges": ["id", "billableAmount", "billingCodeID", "chargeType", "contractServiceBundleID", "contractServiceID", "createDate", "creatorResourceID", "datePurchased", "description", "estimatedCost", "extendedCost", "internalCurrencyBillableAmount", "internalCurrencyUnitPrice", "internalPurchaseOrderNumber", "isBillableToCompany", "isBilled", "name", "notes", "organizationalLevelAssociationID", "productID", "projectID", "purchaseOrderNumber", "status", "statusLastModifiedBy", "statusLastModifiedDate", "unitCost", "unitPrice", "unitQuantity", "soapParentPropertyId"],
+  "project_notes": ["id", "createDateTime", "createdByContactID", "creatorResourceID", "description", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "isAnnouncement", "lastActivityDate", "noteType", "projectID", "publish", "title", "soapParentPropertyId"],
+  "projects": ["id", "actualBilledHours", "actualHours", "changeOrdersBudget", "changeOrdersRevenue", "companyID", "companyOwnerResourceID", "completedDateTime", "completedPercentage", "contractID", "createDateTime", "creatorResourceID", "department", "description", "duration", "endDateTime", "estimatedSalesCost", "estimatedTime", "extProjectNumber", "extProjectType", "impersonatorCreatorResourceID", "laborEstimatedCosts", "laborEstimatedMarginPercentage", "laborEstimatedRevenue", "lastActivityDateTime", "lastActivityPersonType", "lastActivityResourceID", "opportunityID", "organizationalLevelAssociationID", "originalEstimatedRevenue", "projectCostEstimatedMarginPercentage", "projectCostsBudget", "projectCostsRevenue", "projectLeadResourceID", "projectName", "projectNumber", "projectType", "purchaseOrderNumber", "sgda", "startDateTime", "status", "statusDateTime", "statusDetail", "userDefinedFields"],
+  "purchase_approvals": ["id", "costType", "isApproved", "rejectNote"],
+  "purchase_order_item_receiving": ["id", "purchaseOrderItemID", "quantityBackOrdered", "quantityNowReceiving", "quantityPreviouslyReceived", "receiveDate", "receivedByResourceID", "serialNumber", "vendorInvoiceNumber", "soapParentPropertyId"],
+  "purchase_order_items": ["id", "chargeID", "contractID", "estimatedArrivalDate", "internalCurrencyUnitCost", "inventoryLocationID", "memo", "orderID", "productID", "projectID", "quantity", "salesOrderID", "ticketID", "unitCost", "soapParentPropertyId"],
+  "purchase_orders": ["id", "cancelDateTime", "createDateTime", "creatorResourceID", "externalPONumber", "fax", "freight", "generalMemo", "impersonatorCreatorResourceID", "internalCurrencyFreight", "latestEstimatedArrivalDate", "paymentTerm", "phone", "purchaseForCompanyID", "purchaseOrderNumber", "purchaseOrderTemplateID", "shippingDate", "shippingType", "shipToAddress1", "shipToAddress2", "shipToCity", "shipToName", "shipToPostalCode", "shipToState", "showEachTaxInGroup", "showTaxCategory", "status", "submitDateTime", "taxRegionID", "useItemDescriptionsFrom", "vendorID", "vendorInvoiceNumber", "additionalVendorInvoiceNumbers"],
+  "quote_items": ["id", "averageCost", "chargeID", "description", "expenseID", "highestCost", "internalCurrencyLineDiscount", "internalCurrencyUnitDiscount", "internalCurrencyUnitPrice", "isOptional", "isTaxable", "laborID", "lineDiscount", "markupRate", "name", "percentageDiscount", "periodType", "productID", "quantity", "quoteID", "quoteItemType", "serviceBundleID", "serviceID", "shippingID", "sortOrderID", "taxCategoryID", "totalEffectiveTax", "unitCost", "unitDiscount", "unitPrice", "soapParentPropertyId"],
+  "quote_locations": ["id", "address1", "address2", "city", "postalCode", "state"],
+  "quote_templates": ["id", "calculateTaxSeparately", "createDate", "createdBy", "currencyNegativeFormat", "currencyPositiveFormat", "dateFormat", "description", "displayTaxCategorySuperscripts", "isActive", "lastActivityBy", "lastActivityDate", "name", "numberFormat", "pageLayout", "pageNumberFormat", "showEachTaxInGroup", "showGridHeader", "showTaxCategory", "showVerticalGridLines"],
+  "quotes": ["id", "approvalStatus", "approvalStatusChangedByResourceID", "approvalStatusChangedDate", "billToLocationID", "calculateTaxSeparately", "comment", "companyID", "contactID", "createDate", "creatorResourceID", "description", "effectiveDate", "expirationDate", "extApprovalContactResponse", "extApprovalResponseDate", "extApprovalResponseSignature", "externalQuoteNumber", "groupByID", "impersonatorCreatorResourceID", "isActive", "lastActivityDate", "lastModifiedBy", "lastPublishedByResourceID", "lastPublishedDateTime", "name", "opportunityID", "paymentTerm", "paymentType", "primaryQuote", "proposalProjectID", "purchaseOrderNumber", "quoteNumber", "quoteTemplateID", "shippingType", "shipToLocationID", "showEachTaxInGroup", "showTaxCategory", "soldToLocationID", "taxRegionID"],
+  "resource_role_queues": ["id", "queueID", "resourceID", "soapParentPropertyId"],
+  "resource_roles": ["id", "departmentID", "isActive", "queueID", "resourceID", "roleID", "soapParentPropertyId"],
+  "resource_skills": ["id", "resourceID", "skillDescription", "skillID", "skillLevel", "soapParentPropertyId"],
+  "resource_time_off_approvers": ["id", "resourceID", "approverResourceID", "approvalLevel", "soapParentPropertyId"],
+  "resource_time_off_balances": ["id", "resourceID", "floatingHolidayAnnualAllowance", "floatingHolidayBalance", "floatingHolidayPlanned", "floatingHolidayUsed", "floatingHolidayWaitingApproval", "personalTimeAnnualAllowance", "personalTimeBalance", "personalTimePlanned", "personalTimeUsed", "personalTimeWaitingApproval", "sickTimeAnnualAllowance", "sickTimeBalance", "sickTimePlanned", "sickTimeUsed", "sickTimeWaitingApproval", "vacationTimeAnnualAllowance", "vacationTimeBalance", "vacationTimePlanned", "vacationTimeUsed", "vacationTimeWaitingApproval", "year", "soapParentPropertyId"],
+  "resources": ["id", "accountingReferenceID", "dateFormat", "defaultServiceDeskRoleID", "email", "email2", "email3", "emailTypeCode", "emailTypeCode2", "emailTypeCode3", "firstName", "gender", "greeting", "hireDate", "homePhone", "initials", "internalCost", "isActive", "lastName", "licenseType", "locationID", "middleName", "mobilePhone", "numberFormat", "officeExtension", "officePhone", "payrollIdentifier", "payrollType", "resourceType", "suffix", "surveyResourceRating", "timeFormat", "title", "travelAvailabilityPct", "userName", "userType"],
+  "roles": ["id", "description", "hourlyFactor", "hourlyRate", "isActive", "isExcludedFromNewContracts", "isSystemRole", "name", "quoteItemDefaultTaxCategoryId", "roleType"],
+  "sales_orders": ["id", "additionalBillToAddressInformation", "additionalShipToAddressInformation", "billingAddress1", "billingAddress2", "billToCity", "billToCountryID", "billToPostalCode", "billToState", "companyID", "contactID", "impersonatorCreatorResourceID", "opportunityID", "organizationalLevelAssociationID", "ownerResourceID", "promisedFulfillmentDate", "salesOrderDate", "shipToAddress1", "shipToAddress2", "shipToCity", "shipToCountryID", "shipToPostalCode", "shipToState", "status", "title", "soapParentPropertyId", "userDefinedFields"],
+  "service_call_task_resources": ["id", "resourceID", "serviceCallTaskID", "soapParentPropertyId"],
+  "service_call_tasks": ["id", "serviceCallID", "taskID", "soapParentPropertyId"],
+  "service_call_ticket_resources": ["id", "resourceID", "serviceCallTicketID", "soapParentPropertyId"],
+  "service_call_tickets": ["id", "serviceCallID", "ticketID", "soapParentPropertyId"],
+  "service_calls": ["id", "cancelationNoticeHours", "canceledByResourceID", "canceledDateTime", "companyID", "companyLocationID", "createDateTime", "creatorResourceID", "description", "duration", "endDateTime", "impersonatorCreatorResourceID", "isComplete", "lastModifiedDateTime", "startDateTime", "status"],
+  "service_level_agreement_results": ["id", "firstResponseElapsedHours", "firstResponseInitiatingResourceID", "firstResponseResourceID", "isFirstResponseMet", "isResolutionMet", "isResolutionPlanMet", "resolutionElapsedHours", "resolutionPlanElapsedHours", "resolutionPlanResourceID", "resolutionResourceID", "serviceLevelAgreementName", "ticketID", "soapParentPropertyId"],
+  "services": ["id", "billingCodeID", "createDate", "creatorResourceID", "description", "invoiceDescription", "isActive", "lastModifiedDate", "markupRate", "name", "periodType", "serviceLevelAgreementID", "unitCost", "unitPrice", "updateResourceID", "vendorCompanyID", "manufacturerServiceProvider", "manufacturerServiceProviderProductNumber", "catalogNumberPartNumber", "sku", "internalID", "externalID", "url", "userDefinedFields"],
+  "skills": ["id", "categoryID", "description", "isActive", "name"],
+  "subscription_periods": ["id", "periodCost", "periodDate", "periodPrice", "postedDate", "purchaseOrderNumber", "subscriptionID", "soapParentPropertyId"],
+  "subscriptions": ["id", "configurationItemID", "description", "effectiveDate", "expirationDate", "impersonatorCreatorResourceID", "materialCodeID", "organizationalLevelAssociationID", "periodCost", "periodPrice", "periodType", "purchaseOrderNumber", "status", "subscriptionName", "totalCost", "totalPrice", "vendorID", "userDefinedFields"],
+  "survey_results": ["id", "companyID", "companyRating", "completeDate", "contactID", "contactRating", "resourceRating", "sendDate", "surveyID", "surveyRating", "ticketID"],
+  "surveys": ["id", "description", "displayName", "name"],
+  "tag_aliases": ["id", "alias", "tagID", "soapParentPropertyId"],
+  "tag_groups": ["id", "displayColor", "isActive", "isSystem", "label"],
+  "tags": ["id", "createDateTime", "isActive", "isExcludedFromAutomaticTagging", "isSystem", "label", "lastModifiedDateTime", "tagGroupID"],
+  "task_secondary_resources": ["id", "resourceID", "roleID", "taskID", "soapParentPropertyId"],
+  "tasks": ["id", "assignedResourceID", "assignedResourceRoleID", "billingCodeID", "canClientPortalUserCompleteTask", "companyLocationID", "completedByResourceID", "completedByType", "completedDateTime", "createDateTime", "creatorResourceID", "creatorType", "departmentID", "description", "endDateTime", "estimatedHours", "externalID", "hoursToBeScheduled", "isTaskBillable", "isVisibleInClientPortal", "lastActivityDateTime", "lastActivityPersonType", "lastActivityResourceID", "phaseID", "priority", "priorityLabel", "projectID", "purchaseOrderNumber", "remainingHours", "startDateTime", "status", "taskCategoryID", "taskNumber", "taskType", "title", "soapParentPropertyId", "userDefinedFields"],
+  "tax_regions": ["id", "isActive", "name"],
+  "ticket_additional_configuration_items": ["id", "configurationItemID", "ticketID", "soapParentPropertyId"],
+  "ticket_additional_contacts": ["id", "contactID", "ticketID", "soapParentPropertyId"],
+  "ticket_attachments": ["id", "attachDate", "attachedByContactID", "attachedByResourceID", "attachmentType", "contentType", "creatorType", "fileSize", "fullPath", "impersonatorCreatorResourceID", "opportunityID", "parentAttachmentID", "parentID", "publish", "ticketID", "ticketNoteID", "timeEntryID", "title", "data", "parentType", "soapParentPropertyId", "isTaskAttachment"],
+  "ticket_categories": ["id", "displayColorRGB", "isActive", "isApiOnly", "isGlobalDefault", "name", "nickname"],
+  "ticket_category_field_defaults": ["id", "description", "estimatedHours", "issueTypeID", "organizationalLevelAssociationID", "priority", "purchaseOrderNumber", "queueID", "resolution", "serviceLevelAgreementID", "sourceID", "status", "subIssueTypeID", "ticketCategoryID", "ticketTypeID", "title", "workTypeID", "soapParentPropertyId"],
+  "ticket_change_request_approvals": ["id", "approveRejectDateTime", "approveRejectNote", "contactID", "isApproved", "resourceID", "ticketID", "soapParentPropertyId"],
+  "ticket_charges": ["id", "billableAmount", "billingCodeID", "chargeType", "contractServiceBundleID", "contractServiceID", "createDate", "creatorResourceID", "datePurchased", "description", "extendedCost", "internalCurrencyBillableAmount", "internalCurrencyUnitPrice", "internalPurchaseOrderNumber", "isBillableToCompany", "isBilled", "name", "notes", "organizationalLevelAssociationID", "productID", "purchaseOrderNumber", "status", "statusLastModifiedBy", "statusLastModifiedDate", "ticketID", "unitCost", "unitPrice", "unitQuantity", "soapParentPropertyId"],
+  "ticket_checklist_items": ["id", "completedByResourceID", "completedDateTime", "isCompleted", "isImportant", "itemName", "knowledgebaseArticleID", "position", "ticketID", "soapParentPropertyId"],
+  "ticket_history": ["id", "action", "date", "detail", "resourceID", "ticketID", "soapParentPropertyId"],
+  "ticket_note_attachments": ["id", "attachDate", "attachedByContactID", "attachedByResourceID", "attachmentType", "contentType", "creatorType", "fileSize", "fullPath", "impersonatorCreatorResourceID", "opportunityID", "parentID", "publish", "ticketID", "ticketNoteID", "title", "data", "parentType", "soapParentPropertyId", "isTaskAttachment"],
+  "ticket_note_webhooks": ["id", "deactivationUrl", "isActive", "isReady", "isSubscribedToCreateEvents", "isSubscribedToDeleteEvents", "isSubscribedToUpdateEvents", "name", "notificationEmailAddress", "ownerResourceID", "secretKey", "sendThresholdExceededNotification", "webhookGUID", "webhookUrl"],
+  "ticket_notes": ["id", "createDateTime", "createdByContactID", "creatorResourceID", "description", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "lastActivityDate", "noteType", "publish", "ticketID", "title", "soapParentPropertyId"],
+  "ticket_secondary_resources": ["id", "resourceID", "roleID", "ticketID", "soapParentPropertyId"],
+  "ticket_webhooks": ["id", "deactivationUrl", "isActive", "isReady", "isSubscribedToCreateEvents", "isSubscribedToDeleteEvents", "isSubscribedToUpdateEvents", "name", "notificationEmailAddress", "ownerResourceID", "secretKey", "sendThresholdExceededNotification", "webhookGUID", "webhookUrl"],
+  "tickets": ["id", "apiVendorID", "assignedResourceID", "assignedResourceRoleID", "billingCodeID", "changeApprovalBoard", "changeApprovalStatus", "changeApprovalType", "changeInfoField1", "changeInfoField2", "changeInfoField3", "changeInfoField4", "changeInfoField5", "companyID", "companyLocationID", "completedByResourceID", "completedDate", "configurationItemID", "contactID", "contractID", "contractServiceBundleID", "contractServiceID", "createDate", "createdByContactID", "creatorResourceID", "creatorType", "currentServiceThermometerRating", "description", "dueDateTime", "estimatedHours", "externalID", "firstResponseAssignedResourceID", "firstResponseDateTime", "firstResponseDueDateTime", "firstResponseInitiatingResourceID", "hoursToBeScheduled", "impersonatorCreatorResourceID", "isAssignedToComanaged", "issueType", "isVisibleToComanaged", "lastActivityDate", "lastActivityPersonType", "lastActivityResourceID", "lastCustomerNotificationDateTime", "lastCustomerVisibleActivityDateTime", "lastTrackedModificationDateTime", "monitorID", "monitorTypeID", "opportunityID", "organizationalLevelAssociationID", "previousServiceThermometerRating", "priority", "problemTicketId", "projectID", "purchaseOrderNumber", "queueID", "resolution", "resolutionPlanDateTime", "resolutionPlanDueDateTime", "resolvedDateTime", "resolvedDueDateTime", "rmaStatus", "rmaType", "rmmAlertID", "serviceLevelAgreementHasBeenMet", "serviceLevelAgreementID", "serviceLevelAgreementPausedNextEventHours", "serviceThermometerTemperature", "source", "status", "subIssueType", "ticketCategory", "ticketNumber", "ticketType", "title", "userDefinedFields"],
+  "time_entries": ["id", "billingApprovalDateTime", "billingApprovalLevelMostRecent", "billingApprovalResourceID", "billingCodeID", "contractID", "contractServiceBundleID", "contractServiceID", "createDateTime", "creatorUserID", "dateWorked", "endDateTime", "hoursToBill", "hoursWorked", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "internalBillingCodeID", "internalNotes", "isInternalNotesVisibleToComanaged", "isNonBillable", "lastModifiedDateTime", "lastModifiedUserID", "offsetHours", "resourceID", "roleID", "showOnInvoice", "startDateTime", "summaryNotes", "taskID", "ticketID", "timeEntryType"],
+  "time_entry_attachments": ["id", "attachDate", "attachedByContactID", "attachedByResourceID", "attachmentType", "contentType", "creatorType", "fileSize", "fullPath", "impersonatorCreatorResourceID", "opportunityID", "parentID", "publish", "taskID", "ticketID", "timeEntryID", "title", "data", "parentType", "soapParentPropertyId", "isTaskAttachment"],
+  "time_off_requests": ["id", "approvedDateTime", "approveRejectResourceID", "createdByResourceID", "createDateTime", "endTime", "hours", "impersonatorApproveRejectResourceID", "lastModifiedByResourceID", "lastModifiedDateTime", "lastApprovedLevel", "reason", "rejectReason", "requestDate", "resourceID", "startTime", "status", "timeOffRequestType", "soapParentPropertyId"]
+};
+var MODEL_DATE_FIELDS = {
+  "appointments": ["createDateTime", "endDateTime", "startDateTime", "updateDateTime"],
+  "billing_item_approval_levels": ["approvalDateTime"],
+  "billing_items": ["itemDate", "postedDate", "postedOnTime", "webServiceDate"],
+  "companies": ["createDate", "lastActivityDate", "lastTrackedModifiedDateTime"],
+  "company_notes": ["completedDateTime", "createDateTime", "endDateTime", "lastModifiedDate", "startDateTime"],
+  "configuration_item_billing_product_associations": ["effectiveDate", "expirationDate"],
+  "configuration_item_dns_records": ["createDateTime"],
+  "configuration_item_notes": ["createDateTime", "lastActivityDate"],
+  "configuration_items": ["createDate", "dattoLastCheckInDateTime", "domainRegistrationDateTime", "domainLastUpdatedDateTime", "domainExpirationDateTime", "installDate", "lastModifiedTime", "sslValidFromDateTime", "sslValidUntilDateTime", "warrantyExpirationDate"],
+  "contacts": ["bulkEmailOptOutTime", "createDate", "lastActivityDate", "lastModifiedDate", "solicitationOptOutTime"],
+  "contract_billing_rules": ["endDate", "startDate"],
+  "contract_blocks": ["datePurchased", "endDate", "startDate"],
+  "contract_charges": ["createDate", "datePurchased", "statusLastModifiedDate"],
+  "contract_milestones": ["createDate", "dateDue"],
+  "contract_notes": ["createDateTime", "lastActivityDate"],
+  "contract_retainers": ["datePurchased", "endDate", "startDate"],
+  "contract_service_bundle_units": ["approveAndPostDate", "endDate", "startDate"],
+  "contract_service_units": ["approveAndPostDate", "endDate", "startDate"],
+  "contract_ticket_purchases": ["datePurchased", "endDate", "startDate"],
+  "contracts": ["endDate", "lastModifiedDateTime", "startDate"],
+  "currencies": ["lastModifiedDateTime"],
+  "expense_item_attachments": ["attachDate"],
+  "expense_items": ["expenseDate"],
+  "expense_reports": ["approvedDate", "submitDate", "weekEnding"],
+  "holidays": ["holidayDate"],
+  "inventory_products": ["createDateTime"],
+  "invoices": ["createDateTime", "dueDate", "fromDate", "invoiceDateTime", "paidDate", "toDate", "voidedDate", "webServiceDate"],
+  "notification_history": ["notificationSentTime"],
+  "opportunities": ["closedDate", "createDate", "lastActivity", "lostDate", "projectedCloseDate", "promisedFulfillmentDate", "startDate", "throughDate"],
+  "opportunity_attachments": ["attachDate"],
+  "phases": ["createDate", "dueDate", "lastActivityDateTime", "startDate"],
+  "products": ["createdTime"],
+  "project_charges": ["createDate", "datePurchased", "statusLastModifiedDate"],
+  "project_notes": ["createDateTime", "lastActivityDate"],
+  "projects": ["completedDateTime", "createDateTime", "endDateTime", "lastActivityDateTime", "startDateTime", "statusDateTime"],
+  "purchase_order_item_receiving": ["receiveDate"],
+  "purchase_order_items": ["estimatedArrivalDate"],
+  "purchase_orders": ["cancelDateTime", "createDateTime", "latestEstimatedArrivalDate", "shippingDate", "submitDateTime"],
+  "quote_templates": ["createDate", "lastActivityDate"],
+  "quotes": ["approvalStatusChangedDate", "createDate", "effectiveDate", "expirationDate", "extApprovalResponseDate", "lastActivityDate", "lastPublishedDateTime"],
+  "resources": ["hireDate"],
+  "sales_orders": ["promisedFulfillmentDate", "salesOrderDate"],
+  "service_calls": ["canceledDateTime", "createDateTime", "endDateTime", "lastModifiedDateTime", "startDateTime"],
+  "services": ["createDate", "lastModifiedDate"],
+  "subscription_periods": ["periodDate", "postedDate"],
+  "subscriptions": ["effectiveDate", "expirationDate"],
+  "survey_results": ["completeDate", "sendDate"],
+  "tags": ["createDateTime", "lastModifiedDateTime"],
+  "tasks": ["completedDateTime", "createDateTime", "endDateTime", "lastActivityDateTime", "startDateTime"],
+  "ticket_attachments": ["attachDate"],
+  "ticket_change_request_approvals": ["approveRejectDateTime"],
+  "ticket_charges": ["createDate", "datePurchased", "statusLastModifiedDate"],
+  "ticket_checklist_items": ["completedDateTime"],
+  "ticket_history": ["date"],
+  "ticket_note_attachments": ["attachDate"],
+  "ticket_notes": ["createDateTime", "lastActivityDate"],
+  "tickets": ["completedDate", "createDate", "dueDateTime", "firstResponseDateTime", "firstResponseDueDateTime", "lastActivityDate", "lastCustomerNotificationDateTime", "lastCustomerVisibleActivityDateTime", "lastTrackedModificationDateTime", "resolutionPlanDateTime", "resolutionPlanDueDateTime", "resolvedDateTime", "resolvedDueDateTime"],
+  "time_entries": ["billingApprovalDateTime", "createDateTime", "dateWorked", "endDateTime", "lastModifiedDateTime", "startDateTime"],
+  "time_entry_attachments": ["attachDate"],
+  "time_off_requests": ["approvedDateTime", "createDateTime", "endTime", "lastModifiedDateTime", "requestDate", "startTime"]
+};
+
+// src/resources/base/types.ts
+var BOUNDED_QUERY_DEFAULT_LIMIT = 500;
+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 = EMPTY_REASON_STAMPS[key]?.update;
+  if (pinned === void 0) return;
+  err.details = { ...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 = 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: 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 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 };
+  if (includeFields !== void 0) body.IncludeFields = includeFields;
+  const res = await http.request({
+    method: "POST",
+    idempotent: true,
+    path,
+    body,
+    operation
+  });
+  const { items, pageDetails } = unwrapItems(res, operation);
+  const capped = items.length >= limit;
+  return { items, capped, hasMore: capped && pageDetails.nextPageUrl != null };
+}
+
+// src/resources/special/_shared/relation-filters.ts
+var JOIN_SET_CAP = 300;
+function capJoinSet(ids2, cap = JOIN_SET_CAP) {
+  const sorted = [...new Set(ids2)].sort((a, b) => a - b);
+  if (sorted.length <= cap) return { ids: sorted, truncated: false };
+  return { ids: sorted.slice(0, cap), truncated: true };
+}
+var RELATION_TARGETS = {
+  ticket: { resource: "tickets", path: "/V1.0/Tickets/query" },
+  task: { resource: "tasks", path: "/V1.0/Tasks/query" },
+  project: { resource: "projects", path: "/V1.0/Projects/query" }
+};
+function relationsFor(resourceKey) {
+  const fields = MODEL_FIELD_SETS[resourceKey] ?? [];
+  return Object.keys(RELATION_TARGETS).filter((rel) => fields.includes(`${rel}ID`));
+}
+var isRelationLeaf = (c) => isRecord2(c) && c.op !== "and" && c.op !== "or" && typeof c.field === "string" && c.field.includes(".");
+function hasRelationConditions(conditions) {
+  if (conditions === void 0) return false;
+  return conditions.some((c) => isRelationLeaf(c) || isRecord2(c) && Array.isArray(c.items) && hasRelationConditions(c.items));
+}
+function validateRelationLeaves(resourceKey, conditions, op) {
+  const valid = relationsFor(resourceKey);
+  const walk = (conds) => {
+    for (const c of conds) {
+      if (isRecord2(c) && Array.isArray(c.items)) walk(c.items);
+      if (!isRelationLeaf(c)) continue;
+      const field = c.field;
+      const [rel, sub, ...rest] = field.split(".");
+      const fail = (why) => {
+        throw new AutotaskConfigError(`${op}: relation filter "${field}" ${why} \u2014 the request was not issued`, {
+          operation: op,
+          suggestedAction: valid.length > 0 ? `Use ${valid.map((r) => `${r}.<${RELATION_TARGETS[r].resource} field>`).join(" or ")} (one hop; field names from operations.fieldCatalog).` : `${resourceKey} has no relation filters; filter on its own fields.`
+        });
+      };
+      if (c.udf === true) fail("cannot be a UDF condition");
+      if (rest.length > 0 || !sub) fail("is not <relation>.<field> (multi-hop relations are not supported)");
+      if (!valid.includes(rel)) fail(`names an unknown relation for ${resourceKey} (valid: ${valid.join(", ") || "none"})`);
+      const parentFields = MODEL_FIELD_SETS[RELATION_TARGETS[rel].resource];
+      if (parentFields !== void 0 && !parentFields.includes(sub)) {
+        fail(`names a field unknown on ${RELATION_TARGETS[rel].resource}`);
+      }
+    }
+  };
+  walk(conditions);
+}
+async function rewriteRelationFilters(http, resourceKey, conditions, op) {
+  if (!hasRelationConditions(conditions)) return void 0;
+  const conds = conditions;
+  validateRelationLeaves(resourceKey, conds, op);
+  const parentIds = async (rel, leaves) => {
+    const target = RELATION_TARGETS[rel];
+    const parentConds = buildFilter(leaves.map((l) => ({ ...l, field: l.field.slice(rel.length + 1) }))).filter;
+    const res = await boundedPart(http, target.path, parentConds, JOIN_SET_CAP, op, ["id"]);
+    if (res.hasMore) {
+      throw new AutotaskConfigError(
+        `${op}: the ${rel}.* conditions match more than ${JOIN_SET_CAP} ${target.resource} \u2014 the ${resourceKey} query was not issued (a partial ${rel} set would give partial results)`,
+        { operation: op, suggestedAction: `Narrow the ${rel}.* conditions (e.g. add a ${rel} date or status condition) or filter ${resourceKey} by ${rel}ID directly.` }
+      );
+    }
+    return capJoinSet(res.items.map((r) => Number(r.id)).filter((n) => Number.isFinite(n) && n > 0)).ids;
+  };
+  const NEVER = null;
+  const rewrite = async (list, mode) => {
+    const out = [];
+    const byRel = /* @__PURE__ */ new Map();
+    for (const c of list) {
+      if (isRelationLeaf(c)) {
+        const rel = c.field.split(".")[0];
+        if (mode === "and") {
+          byRel.set(rel, [...byRel.get(rel) ?? [], c]);
+          continue;
+        }
+        const ids2 = await parentIds(rel, [c]);
+        if (ids2.length > 0) out.push({ field: `${rel}ID`, op: "in", value: ids2 });
+        continue;
+      }
+      if (isRecord2(c) && (c.op === "and" || c.op === "or") && Array.isArray(c.items) && hasRelationConditions(c.items)) {
+        const items = await rewrite(c.items, c.op);
+        if (items === NEVER) {
+          if (mode === "and") return NEVER;
+          continue;
+        }
+        out.push({ ...c, items });
+        continue;
+      }
+      out.push(c);
+    }
+    for (const [rel, leaves] of byRel) {
+      const ids2 = await parentIds(rel, leaves);
+      if (ids2.length === 0) return NEVER;
+      out.push({ field: `${rel}ID`, op: "in", value: ids2 });
+    }
+    return out.length === 0 && mode === "or" ? NEVER : out;
+  };
+  const rewritten = await rewrite(conds, "and");
+  if (rewritten === NEVER) {
+    return { never: true, note: `no parent record matched the relation conditions \u2014 0 ${resourceKey} rows (the ${resourceKey} query was not issued)` };
+  }
+  return { never: false, conditions: rewritten };
+}
+
+// src/resources/base/query.ts
+var QueryBase = class {
+  http;
+  config;
+  /** Default page size for query walks (the client's resolved `pageSize`). */
+  defaultPageSize;
+  /** Versioned global URL segment (from the config), e.g. '/V1.0/Companies'. */
+  get resourcePath() {
+    return this.config.resourcePath;
+  }
+  /** The vendor entity this resource's ids identify (issue #116 — the `details.idRefs` label, e.g. `company`). */
+  get entityName() {
+    return entityNameFromPath(this.resourcePath);
+  }
+  /** Parent-scoped template (from the config); undefined for top-level resources. */
+  get parentScopedPath() {
+    return this.config.parentScopedPath;
+  }
+  /** Parent field used to narrow the global query (from the config). */
+  get parentField() {
+    return this.config.parentField;
+  }
+  /** The bounded client-scan caps (section 19.2; resolved per client). */
+  get resolutionCaps() {
+    return this.http.resolution;
+  }
+  constructor(http, config, pageSize) {
+    if (config.key === "" || config.resourcePath === "") {
+      throw new AutotaskConfigError("BaseResource requires a non-empty key and resourcePath");
+    }
+    this.http = http;
+    this.config = config;
+    this.defaultPageSize = clampPageSize(pageSize ?? DEFAULT_PAGE_SIZE);
+  }
+  // ------------------------------------------------------------------
+  // Query walk (wired to the G3 walker; cursor-follow per the pinned wire)
+  // ------------------------------------------------------------------
+  /** One page fetch: page 1 POSTs the QueryModel body; later pages POST the same body (`buildQueryBody`) to the absolute cursor (issue #118). */
+  async fetchPage(params, page, pageSize, state) {
+    const operation = `${this.config.key}.query`;
+    if (page === 1) {
+      const req = buildQueryRequest(this.http.baseUrl, this.resourcePath, { ...params, maxRecords: pageSize });
+      const body2 = await this.http.request({ ...req, operation });
+      return this.readPage(body2, page, pageSize, state);
+    }
+    const cursor = state.cursor;
+    if (cursor === null) {
+      throw new AutotaskError(`No pagination cursor available for page ${page} of ${operation}`, {
+        code: "INVALID_RESPONSE",
+        category: "server",
+        operation
+      });
+    }
+    const body = buildQueryBody({ ...params, maxRecords: pageSize });
+    const res = await this.http.request({
+      method: "POST",
+      path: cursorToPath(this.http.baseUrl, cursor),
+      body,
+      operation,
+      idempotent: true
+    });
+    return this.readPage(res, page, pageSize, state);
+  }
+  /** @internal */
+  readPage(body, page, pageSize, state) {
+    const { items, pageDetails } = unwrapItems(body, `${this.config.key}.query`);
+    state.cursor = pageDetails.nextPageUrl ?? null;
+    const hasMore = state.cursor !== null;
+    return {
+      items,
+      page,
+      pageSize,
+      // Verbatim vendor echo of MaxRecords — NOT a match count (live-verified).
+      requestCount: pageDetails.requestCount,
+      // No vendor total exists: the pages known so far (exact on the last page).
+      totalPages: hasMore ? page + 1 : items.length === 0 ? page - 1 : page,
+      hasMore
+    };
+  }
+  /** Build the per-walk fetcher (closure keeps cursor state private to this walk). */
+  pageFetcher(params) {
+    const state = { cursor: null };
+    const p = params ?? {};
+    return (page, pageSize) => this.fetchPage(p, page, pageSize, state);
+  }
+  /** @internal */
+  walkPageSize(params) {
+    return clampPageSize(params?.maxRecords ?? this.defaultPageSize);
+  }
+  /** Issue #281: relation filters (`ticket.<field>` …) resolve before a walk,
+   *  through the same rewrite as queryBounded / count. `undefined` = no parent
+   *  matched, so nothing can match (the walk is skipped: zero child wire). */
+  async relationWalkParams(params, op) {
+    const p = params ?? {};
+    const relation = await rewriteRelationFilters(this.http, this.config.key, normalizedConditions(p.filter), op);
+    if (relation?.never === true) return void 0;
+    return relation === void 0 ? p : { ...p, filter: relation.conditions };
+  }
+  /**
+   * Stream items across pages (the resource `query` surface — the MCP
+   * server's `output_path` walk). Issue #281: relation filters resolve first
+   * (as queryBounded), and each page's rows carry the default label siblings
+   * (issue #276, the same `labelRows`) unless `names: false`. Labelling runs
+   * per page, so the cold name-read cap (20) applies per page; a capped id
+   * gets a null `*Name` (an iterator has no result envelope for the `names`
+   * summary). A resource built without a client (bare `HttpClient`) yields
+   * raw rows.
+   */
+  async *queryItems(params) {
+    const { names, ...rest } = params ?? {};
+    const label = readNamesOpt(names, `${this.config.key}.query`);
+    const walk = await this.relationWalkParams(rest, `${this.config.key}.query`);
+    if (walk === void 0) return;
+    const client = this.http.client;
+    if (!label || client === void 0) {
+      yield* paginateItems(this.pageFetcher(walk), { pageSize: this.walkPageSize(walk) });
+      return;
+    }
+    for await (const page of paginate(this.pageFetcher(walk), { pageSize: this.walkPageSize(walk) })) {
+      const labelled = await labelRows(client, this.config.key, page.items);
+      yield* labelled.rows;
+    }
+  }
+  /** Stream page objects (the resource `queryPages` surface; relation filters resolve first, #281). */
+  async *queryPageIter(params) {
+    const walk = await this.relationWalkParams(params, `${this.config.key}.query`);
+    if (walk === void 0) return;
+    yield* paginate(this.pageFetcher(walk), { pageSize: this.walkPageSize(walk) });
+  }
+  /** Collect every item across all pages (the resource `queryAll` surface; 1000-page guarded; relation filters resolve first, #281). */
+  async queryAllItems(params) {
+    const walk = await this.relationWalkParams(params, `${this.config.key}.query`);
+    if (walk === void 0) return [];
+    return collectAll(this.pageFetcher(walk), { pageSize: this.walkPageSize(walk), maxRecords: walk.maxTotalRecords });
+  }
+  /**
+   * `queryBounded` — server-side pagination (the MCP query surface): ONE call
+   * walks the vendor cursor internally until `limit` TOTAL records are
+   * collected or the cursor is exhausted, and returns a bounded,
+   * complete-enough result. The client never owns the walk:
+   * - `limit` = total records (default 500, hard max 2500 — above it throws
+   *   AutotaskConfigError; it is NOT a page size). The page-1 request uses
+   *   the internal page size min(500, limit) (the `latest` mechanism sizes
+   *   its walk from the matching count); every follow-up page POSTs the
+   *   SAME QueryModel body (`buildQueryBody`: MaxRecords, IncludeFields and
+   *   the preserved filter) to the absolute cursor (issue #118 — the vendor
+   *   honours IncludeFields there and ignores MaxRecords, serving its own
+   *   page size), so the walk reuses `fetchPage` (the shared cursor machinery)
+   *   with a per-walk closure state (walks never share state).
+   * - The 1000-page guard still applies as a SOFT stop: a walk that would
+   *   fetch a 1001st page stops with `hasMore: true` (never a throw — this
+   *   is a bounded read, not the `paginate` generator's error path).
+   * - `hasMore` = (truncated by limit OR guard) AND (a non-null next cursor
+   *   was seen at the stop point OR the final page was sliced to meet the
+   *   limit). Cursor exhausted, or a short/empty page with no truncation →
+   *   false (never claims more than the cursor + the slice say exist).
+   * - `count` is always omitted: `pageDetails.count` is the current page's
+   *   record count (vendor-documented), never a total — `<resource>.count`
+   *   is the total.
+   * - Issue #59: `latest: N` (validated pre-request, zero wire) delegates to
+   *   `latestWalk` — the count-anchored N-highest-id mechanism; ABSENT, the
+   *   walk below is bit-for-bit the existing path.
+   * Pure read; no mutation paths involved.
+   */
+  async queryBounded(params) {
+    if (Array.isArray(params)) {
+      throw new AutotaskConfigError(
+        "queryBounded: params must be an object { filter?, limit?, latest?, includeFields? } \u2014 a bare conditions array is not accepted (wrap it: { filter: [...] })"
+      );
+    }
+    const limit = params?.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 = params?.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 = params?.fieldsPreset !== void 0 ? { ...params, includeFields: resolveFieldsPreset(params.fieldsPreset, this.config.key, params.includeFields) } : params ?? {};
+    const latest = walkParams.latest;
+    if (latest !== void 0) {
+      if (!Number.isInteger(latest) || latest < 1 || latest > BOUNDED_QUERY_MAX_LIMIT) {
+        throw new AutotaskConfigError(
+          `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 (params?.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 (relation?.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);
+    }
+    const { items, pages, guard, sliced, cursor } = await this.walkBounded(walkParams, limit);
+    const hasMore = (items.length >= limit || guard) && (sliced > 0 || cursor !== null);
+    const result = { items, fetched: items.length, hasMore, pagesWalked: pages };
+    this.stampEmptyQueryResult(result, params);
+    return this.applyNoteChars(result, noteChars);
+  }
+  /** Issue #61 (slice A): the noteChars truncation at the SINGLE chokepoint
+   *  of `queryBounded` — the normal walk and the `latest` paths both
+   *  produced their `BoundedQueryResult` here (the single chokepoint the
+   *  plan pins: R5). Copy-on-truncate (the input records are never
+   *  mutated); the additive `noteCharsTruncated` stamp = the truncated-
+   *  field count, ABSENT when 0. The resource's untrusted-class field set
+   *  is the generated stamp (the SAME plan column the registry's
+   *  `metadata.untrustedFields` channel stamps — zero second source of
+   *  truth); an absent set = the cap is a no-op for the resource (bit-for-
+   *  bit the pre-slice result).
+   * @internal */
+  applyNoteChars(result, noteChars) {
+    if (noteChars === void 0) return result;
+    const fields = UNTRUSTED_FIELDS_BY_RESOURCE[this.config.key];
+    if (fields === void 0 || fields.length === 0) return result;
+    const [items, truncated] = truncateNoteChars(result.items, noteChars, fields);
+    if (truncated > 0) {
+      return { ...result, items, noteCharsTruncated: truncated };
+    }
+    return result;
+  }
+  /** The bounded walk loop (shared by the normal `queryBounded` path and the
+   *  `latest` modes): walks the vendor cursor until `limit` TOTAL records
+   *  are collected or the cursor is exhausted; the 1000-page guard is a
+   *  SOFT stop (never a throw). ONE per-walk closure (walks never share
+   *  state).
+   * @internal */
+  async walkBounded(p, limit) {
+    const state = { cursor: null };
+    const items = [];
+    let pages = 0;
+    let sliced = 0;
+    let guard = false;
+    const pageSize = Math.min(MAX_PAGE_SIZE, limit);
+    for (; ; ) {
+      if (pages >= MAX_PAGES) {
+        guard = true;
+        break;
+      }
+      const page = await this.fetchPage(p, pages + 1, pageSize, state);
+      pages += 1;
+      const remaining = limit - items.length;
+      const take = page.items.slice(0, remaining);
+      sliced += Math.max(0, page.items.length - remaining);
+      items.push(...take);
+      if (items.length >= limit) break;
+      if (!page.hasMore || page.items.length === 0) break;
+    }
+    return { items, pages, guard, sliced, cursor: state.cursor };
+  }
+  /** A walk stop is TRUNCATED when the 1000-page guard fired, or the limit
+   *  was met with a live next cursor (or a sliced final page): rows exist
+   *  past the stop point, and a top-N-by-id over the collected set alone is
+   *  unprovable (the `latest` mechanism refuses instead of guessing).
+   * @internal */
+  walkTruncated(limit, stop) {
+    return stop.guard || stop.itemsLength >= limit && (stop.sliced > 0 || stop.cursor !== null);
+  }
+  /** The 0-item result stamping — the ONE source of truth (the normal walk
+   *  and the `latest` empty outcome both ride it): the typed blind-surface
+   *  sentinel + the pinned empty-reason, through the filter-aware predicate
    *  `blindStampFor` (`unfiltered-blind` surfaces stamp ONLY the unfiltered
    *  call — a filtered empty result is a true absence; live-verified
    *  S12-B P1: the filtered tickets.query returns data on ww29). Additive:
@@ -18335,7 +19218,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 conditions = normalizedConditions(params?.filter);
+    const relation = await rewriteRelationFilters(this.http, this.config.key, normalizedConditions(params?.filter), `${this.config.key}.count`);
+    if (relation?.never === true) return 0;
+    const conditions = relation !== void 0 ? relation.conditions : normalizedConditions(params?.filter);
     const body = {};
     body.filter = conditions === void 0 ? [] : buildFilter(conditions).filter;
     const res = await this.http.request({
@@ -19385,1453 +20270,1075 @@ var MutationBase = class extends MetaBase {
    * `lastModifiedDate` and the model carries the field → fetch the current
    * record and compare before the mutating request (mismatch throws
    * STALE_OBJECT; a vanished record propagates the vendor's NotFoundError).
-   */
-  async guardStaleBeforeMutation(id, opts, operation, parentId) {
-    if (opts.lastModifiedDate === void 0 || this.config.staleField === void 0) return;
-    let current;
-    try {
-      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) attachUpdateTargetMissReason(err, this.config.key);
-      throw err;
-    }
-    this.staleObjectCheck(current, opts, operation);
-  }
-  /**
-   * `create` dry-run: input validation + parent verification (scoped
-   * resources) + the pinned envelope. NO request is issued (scoped parent
-   * verification is a read). Duplicate detection has no reliable lookup for
-   * a plain create (that is `createIfNotExists`), so it is not claimed.
-   */
-  async runCreateDryRun(data, parentId) {
-    const checks = [];
-    const warnings = [];
-    checks.push({ name: "input-validation", ok: isRecord2(data) && Object.keys(data).length > 0 });
-    const deleteBoundaryNote = DELETE_BOUNDARY_NOTES[this.config.key];
-    if (deleteBoundaryNote !== void 0) {
-      checks.push({ name: "delete-boundary", ok: true });
-      warnings.push(deleteBoundaryNote);
-    }
-    let path = this.resourcePath;
-    if (parentId !== void 0) {
-      path = this.scopedCollectionPath(parentId);
-      const parentPath = this.config.parentPath;
-      if (parentPath === void 0) {
-        throw new AutotaskConfigError(
-          `dry-run: ${this.config.key} is parent-scoped but has no parentPath configured`
-        );
-      }
-      let parent = null;
-      if (typeof parentId === "number" && Number.isInteger(parentId) && parentId >= 0) {
-        try {
-          parent = await this.fetchRecordRaw(parentPath, parentId, true);
-        } catch (err) {
-          if (!(err instanceof NotFoundError)) throw err;
-        }
-      }
-      checks.push({ name: "parent-exists", ok: parent !== null });
-      if (parent === null) {
-        warnings.push(`parent ${parentId} not found; the vendor would reject the create`);
-      }
-    }
-    if (isRecord2(data)) {
-      const eff = effectiveRequiredFields(void 0, RELATIONSHIP_MAP[this.config.key]?.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`);
-      }
-    }
-    if (this.config.key === "companies") {
-      warnings.push('the vendor auto-creates a "Primary Address" location for a new company (rename it with company_locations.update; it cannot be deleted via the API)');
-    }
-    return buildDryRunResult({
-      operation: `${this.config.key}.create`,
-      method: "POST",
-      path,
-      ids: [],
-      checks,
-      impact: { affected: 1, scope: "single-record", reversible: true },
-      warnings,
-      data
-    }, { redactPersonalData: this.http.redactPersonalData });
-  }
-  /**
-   * `update` dry-run: input validation + current-record fetch (a missing
-   * record carries `warnings` and no `diff` — pinned), the stale-object
-   * check (mismatch throws STALE_OBJECT) and the best-effort `diff`. NO
-   * mutating request is issued.
-   */
-  async runUpdateDryRun(id, data, opts = {}, parentId) {
-    const operation = `${this.config.key}.update`;
-    const checks = [];
-    const warnings = [];
-    checks.push({ name: "input-validation", ok: isRecord2(data) && Object.keys(data).length > 0 });
-    const scopedUpdate = parentId !== void 0 && this.config.parentScopedPath !== void 0;
-    const collectionUpdate = scopedUpdate || this.config.collectionUpdate === true;
-    const path = scopedUpdate ? this.scopedCollectionPath(parentId) : collectionUpdate ? this.resourcePath : `${this.resourcePath}/${id}`;
-    const method = scopedUpdate ? "PATCH" : "PUT";
-    let current = null;
-    try {
-      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 = EMPTY_REASON_STAMPS[this.config.key]?.update;
-        checks.push({
-          name: "current-record-exists",
-          ok: false,
-          ...updateReason !== void 0 ? { note: updateReason.note } : {}
-        });
-        warnings.push(`current record ${id} not fetchable; no diff`);
-        return buildDryRunResult({
-          operation,
-          method,
-          path,
-          ids: [id],
-          checks,
-          impact: { affected: 1, scope: "single-record", reversible: true },
-          warnings,
-          data,
-          ...updateReason !== void 0 ? { emptyReason: updateReason } : {}
-        }, { redactPersonalData: this.http.redactPersonalData });
-      }
-      throw err;
-    }
-    checks.push({ name: "current-record-exists", ok: true });
-    if (this.staleObjectCheck(current, opts, operation)) {
-      checks.push({ name: "stale-check", ok: true });
-    }
-    let envelopeData = data;
-    if (parentId === void 0 && this.config.collectionUpdate === true && opts.raw !== true) {
-      envelopeData = mergePartialBody(
-        current,
-        this.normalizeMutationBody(data)
-      );
-    }
-    return buildDryRunResult({
-      operation,
-      method,
-      path,
-      ids: [id],
-      checks,
-      diff: computeFieldDiff(current, data),
-      impact: { affected: 1, scope: "single-record", reversible: true },
-      warnings,
-      data: envelopeData
-    }, { redactPersonalData: this.http.redactPersonalData });
-  }
-  /**
-   * `delete` dry-run: current-record verification + the stale-object check +
-   * the pinned envelope (no diff — a delete has no before/after fields). NO
-   * mutating request is issued.
-   */
-  async runDeleteDryRun(id, opts = {}, parentId) {
-    const operation = `${this.config.key}.delete`;
-    const checks = [];
-    const warnings = [];
-    const path = parentId === void 0 ? `${this.resourcePath}/${id}` : this.scopedItemPath(parentId, id);
-    let current = null;
+   */
+  async guardStaleBeforeMutation(id, opts, operation, parentId) {
+    if (opts.lastModifiedDate === void 0 || this.config.staleField === void 0) return;
+    let current;
     try {
       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) {
-        checks.push({ name: "current-record-exists", ok: false });
-        warnings.push(`record ${id} not fetchable; the vendor would reject the delete`);
-        return buildDryRunResult({
-          operation,
-          method: "DELETE",
-          path,
-          ids: [id],
-          checks,
-          impact: { affected: 1, scope: "single-record", reversible: false },
-          warnings
-        }, { redactPersonalData: this.http.redactPersonalData });
-      }
+      if (err instanceof NotFoundError) attachUpdateTargetMissReason(err, this.config.key);
       throw err;
     }
-    checks.push({ name: "current-record-exists", ok: true });
-    if (this.staleObjectCheck(current, opts, operation)) {
-      checks.push({ name: "stale-check", ok: true });
-    }
-    return buildDryRunResult({
-      operation,
-      method: "DELETE",
-      path,
-      ids: [id],
-      checks,
-      impact: { affected: 1, scope: "single-record", reversible: false },
-      warnings
-    }, { redactPersonalData: this.http.redactPersonalData });
-  }
-};
-
-// src/resources/base/BaseResource.ts
-var BaseResource = class extends MutationBase {
-};
-
-// src/resources/billing_codes.ts
-var BillingCodesResource = class extends BaseResource {
-  constructor(http, pageSize) {
-    super(http, {
-      key: "billing_codes",
-      resourcePath: "/V1.0/BillingCodes",
-      deletable: false,
-      udfCapable: false,
-      searchFields: ["name"]
-    }, pageSize);
-  }
-  /** Query BillingCode records with the G3 filter surface (server-side JSON filter). */
-  query(params) {
-    return this.queryItems(params);
-  }
-  /** Get every BillingCode record (the MCP-preferred read; 1000-page guarded). */
-  async queryAll(params) {
-    return this.queryAllItems(params);
-  }
-  /** Count matching records (queryCount envelope unwrapped to a plain number). */
-  async count(params) {
-    return this.countGlobal(params);
-  }
-  /** 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, opts?.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
-   * non-match returns null; ambiguity throws RESOLUTION_AMBIGUOUS (candidate ids) and a
-   * cap-tripped bounded client scan throws RESOLUTION_TRUNCATED (never a silent null).
-   * The compact shape is the structural alias of the full record; `expand: true` is the
-   * type-level escape hatch. */
-  async resolve(identifier, opts = {}) {
-    void opts;
-    return this.resolveBase(identifier);
-  }
-  /** 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: opts?.limit });
-  }
-};
-
-// src/resources/special/dateWindow.ts
-var DAY_MS = 864e5;
-var DEFAULT_LIMIT = 500;
-var MAX_LIMIT = 500;
-function clampWindowLimit(limit) {
-  const n = limit === void 0 ? DEFAULT_LIMIT : Math.trunc(limit);
-  if (!Number.isInteger(n) || n < 1) {
-    throw new AutotaskConfigError(`limit must be an integer >= 1 (got ${String(limit)})`);
-  }
-  return Math.min(n, MAX_LIMIT);
-}
-var iso = (ms) => new Date(ms).toISOString().slice(0, 19) + "Z";
-var WEEKDAYS = { Sun: 0, Mon: 1, Tue: 2, Wed: 3, Thu: 4, Fri: 5, Sat: 6 };
-function wallParts(tz, ms) {
-  const parts = new Intl.DateTimeFormat("en-US", {
-    timeZone: tz,
-    year: "numeric",
-    month: "2-digit",
-    day: "2-digit",
-    hour: "2-digit",
-    minute: "2-digit",
-    second: "2-digit",
-    hour12: false,
-    weekday: "short"
-  }).formatToParts(new Date(ms));
-  const w = {};
-  let weekday = -1;
-  for (const p of parts) {
-    switch (p.type) {
-      case "year":
-        w.y = Number(p.value);
-        break;
-      case "month":
-        w.m = Number(p.value);
-        break;
-      case "day":
-        w.d = Number(p.value);
-        break;
-      case "hour":
-        w.h = Number(p.value) % 24;
-        break;
-      case "minute":
-        w.mi = Number(p.value);
-        break;
-      case "second":
-        w.s = Number(p.value);
-        break;
-      case "weekday":
-        weekday = WEEKDAYS[p.value] ?? -1;
-        break;
-    }
-  }
-  if (weekday < 0 || [w.y, w.m, w.d, w.h, w.mi, w.s].some((v) => v === void 0 || Number.isNaN(v))) {
-    throw new AutotaskConfigError(`dateWindow: could not read the wall-clock parts for timezone "${tz}" (the Intl format returned an incomplete or unmapped part)`);
-  }
-  return { y: w.y, m: w.m, d: w.d, h: w.h, mi: w.mi, s: w.s, weekday };
-}
-function tzOffsetMs(tz, ms) {
-  const p = wallParts(tz, ms);
-  return Date.UTC(p.y, p.m - 1, p.d, p.h, p.mi, p.s) - ms;
-}
-function localDayStartMs(y, m, d, tz) {
-  if (tz === void 0) return Date.UTC(y, m - 1, d);
-  const candidate2 = Date.UTC(y, m - 1, d);
-  const offset = tzOffsetMs(tz, candidate2);
-  let start = candidate2 - offset;
-  if (tzOffsetMs(tz, start) !== offset) {
-    start = candidate2 - tzOffsetMs(tz, start);
-  }
-  const p = wallParts(tz, start);
-  if (p.d !== d) start += 864e5 - ((p.h * 60 + p.mi) * 60 + p.s) * 1e3;
-  return start;
-}
-function localDayEndMs(y, m, d, tz) {
-  if (tz === void 0) return Date.UTC(y, m - 1, d) + DAY_MS - 1;
-  const next = new Date(Date.UTC(y, m - 1, d + 1));
-  return localDayStartMs(next.getUTCFullYear(), next.getUTCMonth() + 1, next.getUTCDate(), tz) - 1;
-}
-function validateZone(tz, opName = "dateWindow") {
-  if (typeof tz !== "string" || tz.length === 0) {
-    throw new AutotaskConfigError(
-      `${opName}: tz must be a non-empty IANA timezone string (got ${JSON.stringify(tz)}; e.g. 'Australia/Sydney' \u2014 omitted tz = UTC)`,
-      { operation: opName }
-    );
-  }
-  try {
-    new Intl.DateTimeFormat("en-US", { timeZone: tz });
-  } catch {
-    throw new AutotaskConfigError(
-      `${opName}: tz is not a valid IANA timezone (${JSON.stringify(tz)}; e.g. 'Australia/Sydney' \u2014 omitted tz = UTC)`,
-      { operation: opName }
-    );
+    this.staleObjectCheck(current, opts, operation);
   }
-  return tz;
-}
-var utcDayStart = (ms) => {
-  const d = new Date(ms);
-  return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate());
-};
-var utcDayEnd = (ms) => utcDayStart(ms) + DAY_MS - 1;
-function utcDateWindowBounds(kind, now) {
-  const t = now.getTime();
-  let from;
-  let to;
-  switch (kind) {
-    case "today":
-      from = utcDayStart(t);
-      to = utcDayEnd(t);
-      break;
-    case "yesterday":
-      from = utcDayStart(t - DAY_MS);
-      to = utcDayEnd(t - DAY_MS);
-      break;
-    case "last24h":
-      from = t - DAY_MS;
-      to = t;
-      break;
-    case "last7":
-    case "last14":
-    case "last30":
-    case "last90": {
-      const days = Number(kind.slice(4));
-      from = utcDayStart(t - days * DAY_MS);
-      to = utcDayEnd(t);
-      break;
-    }
-    case "lastFullWeek":
-    case "lastFullFortnight": {
-      const d = new Date(t);
-      const daysSinceMonday = (d.getUTCDay() + 6) % 7;
-      const thisMonday = utcDayStart(t) - daysSinceMonday * DAY_MS;
-      const daysBack = kind === "lastFullWeek" ? 7 : 14;
-      from = thisMonday - daysBack * DAY_MS;
-      to = thisMonday - 1;
-      break;
+  /**
+   * `create` dry-run: input validation + parent verification (scoped
+   * resources) + the pinned envelope. NO request is issued (scoped parent
+   * verification is a read). Duplicate detection has no reliable lookup for
+   * a plain create (that is `createIfNotExists`), so it is not claimed.
+   */
+  async runCreateDryRun(data, parentId) {
+    const checks = [];
+    const warnings = [];
+    checks.push({ name: "input-validation", ok: isRecord2(data) && Object.keys(data).length > 0 });
+    const deleteBoundaryNote = DELETE_BOUNDARY_NOTES[this.config.key];
+    if (deleteBoundaryNote !== void 0) {
+      checks.push({ name: "delete-boundary", ok: true });
+      warnings.push(deleteBoundaryNote);
     }
-    case "lastFullMonth": {
-      const d = new Date(t);
-      const y = d.getUTCFullYear();
-      const m = d.getUTCMonth() - 1;
-      from = Date.UTC(y, m, 1);
-      to = Date.UTC(y, m + 1, 1) - 1;
-      break;
+    let path = this.resourcePath;
+    if (parentId !== void 0) {
+      path = this.scopedCollectionPath(parentId);
+      const parentPath = this.config.parentPath;
+      if (parentPath === void 0) {
+        throw new AutotaskConfigError(
+          `dry-run: ${this.config.key} is parent-scoped but has no parentPath configured`
+        );
+      }
+      let parent = null;
+      if (typeof parentId === "number" && Number.isInteger(parentId) && parentId >= 0) {
+        try {
+          parent = await this.fetchRecordRaw(parentPath, parentId, true);
+        } catch (err) {
+          if (!(err instanceof NotFoundError)) throw err;
+        }
+      }
+      checks.push({ name: "parent-exists", ok: parent !== null });
+      if (parent === null) {
+        warnings.push(`parent ${parentId} not found; the vendor would reject the create`);
+      }
     }
-    case "lastFullQuarter": {
-      const d = new Date(t);
-      let q = Math.floor(d.getUTCMonth() / 3) - 1;
-      let y = d.getUTCFullYear();
-      if (q < 0) {
-        q = 3;
-        y -= 1;
+    if (isRecord2(data)) {
+      const eff = effectiveRequiredFields(void 0, RELATIONSHIP_MAP[this.config.key]?.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`);
       }
-      const first = q * 3;
-      from = Date.UTC(y, first, 1);
-      to = Date.UTC(y, first + 3, 1) - 1;
-      break;
     }
+    if (this.config.key === "companies") {
+      warnings.push('the vendor auto-creates a "Primary Address" location for a new company (rename it with company_locations.update; it cannot be deleted via the API)');
+    }
+    return buildDryRunResult({
+      operation: `${this.config.key}.create`,
+      method: "POST",
+      path,
+      ids: [],
+      checks,
+      impact: { affected: 1, scope: "single-record", reversible: true },
+      warnings,
+      data
+    }, { redactPersonalData: this.http.redactPersonalData });
   }
-  return { from: iso(from), to: iso(to) };
-}
-function dateWindowBounds(kind, now, tz) {
-  if (tz === void 0) return utcDateWindowBounds(kind, now);
-  const zone = validateZone(tz);
-  const t = now.getTime();
-  if (kind === "last24h") {
-    return { from: iso(t - DAY_MS), to: iso(t) };
-  }
-  const { y, m, d, weekday } = wallParts(zone, t);
-  const shifted = (dy) => new Date(Date.UTC(y, m - 1, d + dy));
-  const dayStart = (dy) => {
-    const dt = shifted(dy);
-    return localDayStartMs(dt.getUTCFullYear(), dt.getUTCMonth() + 1, dt.getUTCDate(), zone);
-  };
-  const dayStartAt = (instant) => {
-    const p = wallParts(zone, instant);
-    return localDayStartMs(p.y, p.m, p.d, zone);
-  };
-  const dayEndAt = (instant) => {
-    const p = wallParts(zone, instant);
-    return localDayEndMs(p.y, p.m, p.d, zone);
-  };
-  let from;
-  let to;
-  switch (kind) {
-    case "today":
-      from = dayStartAt(t);
-      to = dayEndAt(t);
-      break;
-    case "yesterday":
-      from = dayStart(-1);
-      to = dayStart(0) - 1;
-      break;
-    case "last7":
-    case "last14":
-    case "last30":
-    case "last90": {
-      const days = Number(kind.slice(4));
-      from = dayStart(-days);
-      to = dayEndAt(t);
-      break;
+  /**
+   * `update` dry-run: input validation + current-record fetch (a missing
+   * record carries `warnings` and no `diff` — pinned), the stale-object
+   * check (mismatch throws STALE_OBJECT) and the best-effort `diff`. NO
+   * mutating request is issued.
+   */
+  async runUpdateDryRun(id, data, opts = {}, parentId) {
+    const operation = `${this.config.key}.update`;
+    const checks = [];
+    const warnings = [];
+    checks.push({ name: "input-validation", ok: isRecord2(data) && Object.keys(data).length > 0 });
+    const scopedUpdate = parentId !== void 0 && this.config.parentScopedPath !== void 0;
+    const collectionUpdate = scopedUpdate || this.config.collectionUpdate === true;
+    const path = scopedUpdate ? this.scopedCollectionPath(parentId) : collectionUpdate ? this.resourcePath : `${this.resourcePath}/${id}`;
+    const method = scopedUpdate ? "PATCH" : "PUT";
+    let current = null;
+    try {
+      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 = EMPTY_REASON_STAMPS[this.config.key]?.update;
+        checks.push({
+          name: "current-record-exists",
+          ok: false,
+          ...updateReason !== void 0 ? { note: updateReason.note } : {}
+        });
+        warnings.push(`current record ${id} not fetchable; no diff`);
+        return buildDryRunResult({
+          operation,
+          method,
+          path,
+          ids: [id],
+          checks,
+          impact: { affected: 1, scope: "single-record", reversible: true },
+          warnings,
+          data,
+          ...updateReason !== void 0 ? { emptyReason: updateReason } : {}
+        }, { redactPersonalData: this.http.redactPersonalData });
+      }
+      throw err;
     }
-    case "lastFullWeek":
-    case "lastFullFortnight": {
-      const daysSinceMonday = (weekday + 6) % 7;
-      const daysBack = kind === "lastFullWeek" ? 7 : 14;
-      from = dayStart(-(daysSinceMonday + daysBack));
-      to = dayStart(-daysSinceMonday) - 1;
-      break;
+    checks.push({ name: "current-record-exists", ok: true });
+    if (this.staleObjectCheck(current, opts, operation)) {
+      checks.push({ name: "stale-check", ok: true });
     }
-    case "lastFullMonth": {
-      const prev = new Date(Date.UTC(y, m - 2, 1));
-      from = localDayStartMs(prev.getUTCFullYear(), prev.getUTCMonth() + 1, 1, zone);
-      to = localDayStartMs(y, m, 1, zone) - 1;
-      break;
+    let envelopeData = data;
+    if (parentId === void 0 && this.config.collectionUpdate === true && opts.raw !== true) {
+      envelopeData = mergePartialBody(
+        current,
+        this.normalizeMutationBody(data)
+      );
     }
-    case "lastFullQuarter": {
-      const q = Math.floor((m - 1) / 3);
-      const prevQ = q - 1 < 0 ? 3 : q - 1;
-      const prevY = q - 1 < 0 ? y - 1 : y;
-      from = localDayStartMs(prevY, prevQ * 3 + 1, 1, zone);
-      to = localDayStartMs(y, q * 3 + 1, 1, zone) - 1;
-      break;
+    return buildDryRunResult({
+      operation,
+      method,
+      path,
+      ids: [id],
+      checks,
+      diff: computeFieldDiff(current, data),
+      impact: { affected: 1, scope: "single-record", reversible: true },
+      warnings,
+      data: envelopeData
+    }, { redactPersonalData: this.http.redactPersonalData });
+  }
+  /**
+   * `delete` dry-run: current-record verification + the stale-object check +
+   * the pinned envelope (no diff — a delete has no before/after fields). NO
+   * mutating request is issued.
+   */
+  async runDeleteDryRun(id, opts = {}, parentId) {
+    const operation = `${this.config.key}.delete`;
+    const checks = [];
+    const warnings = [];
+    const path = parentId === void 0 ? `${this.resourcePath}/${id}` : this.scopedItemPath(parentId, id);
+    let current = null;
+    try {
+      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) {
+        checks.push({ name: "current-record-exists", ok: false });
+        warnings.push(`record ${id} not fetchable; the vendor would reject the delete`);
+        return buildDryRunResult({
+          operation,
+          method: "DELETE",
+          path,
+          ids: [id],
+          checks,
+          impact: { affected: 1, scope: "single-record", reversible: false },
+          warnings
+        }, { redactPersonalData: this.http.redactPersonalData });
+      }
+      throw err;
+    }
+    checks.push({ name: "current-record-exists", ok: true });
+    if (this.staleObjectCheck(current, opts, operation)) {
+      checks.push({ name: "stale-check", ok: true });
     }
+    return buildDryRunResult({
+      operation,
+      method: "DELETE",
+      path,
+      ids: [id],
+      checks,
+      impact: { affected: 1, scope: "single-record", reversible: false },
+      warnings
+    }, { redactPersonalData: this.http.redactPersonalData });
   }
-  return { from: iso(from), to: iso(to) };
+};
+
+// src/resources/base/BaseResource.ts
+var BaseResource = class extends MutationBase {
+};
+
+// src/operations/compositeNames.ts
+var PICKLIST_VALUE_NOT_SERVED_NOTE = "The picklist is served to this API user, but this record's value is not in it (an inactive or unexposed value) \u2014 the label cannot be resolved and is null; refreshing the field catalog will not surface it. (A picklist the vendor does not expose at all is reported with the field-catalog honesty note instead.)";
+var DEFAULT_MAX_NAME_READS = 20;
+var TICKET_LABEL_FIELDS = ["status", "priority", "ticketType", "issueType", "subIssueType", "source", "queueID"];
+function isVendorId(value) {
+  if (typeof value === "number") return Number.isSafeInteger(value) && value >= 0;
+  if (typeof value === "string") return /^\d+$/.test(value);
+  return false;
 }
-function dateOnlyWindowBounds(kind, now, tz) {
-  if (tz === void 0 || kind === "last24h") return dateWindowBounds(kind, now, tz);
-  const zone = validateZone(tz);
-  const { from, to } = dateWindowBounds(kind, now, zone);
-  const f = wallParts(zone, Date.parse(from));
-  const t = wallParts(zone, Date.parse(to));
-  return { from: iso(Date.UTC(f.y, f.m - 1, f.d)), to: iso(Date.UTC(t.y, t.m - 1, t.d) + DAY_MS - 1) };
+function createNamePlan(labelFields = [], labelResource) {
+  const resourceIds = [];
+  const resSeen = /* @__PURE__ */ new Set();
+  const recordFks = [];
+  const fkSeen = /* @__PURE__ */ new Set();
+  let lineOfBusinessId;
+  let lineOfBusinessSource;
+  let lineOfBusinessContractId;
+  return {
+    plan: () => ({
+      resourceIds,
+      recordFks,
+      labelFields,
+      ...labelResource !== void 0 ? { labelResource } : {},
+      ...lineOfBusinessId !== void 0 ? { lineOfBusinessId } : {},
+      ...lineOfBusinessSource !== void 0 ? { lineOfBusinessSource } : {},
+      ...lineOfBusinessContractId !== void 0 ? { lineOfBusinessContractId } : {}
+    }),
+    addResource: (value) => {
+      if (!isVendorId(value)) return;
+      const k = String(value);
+      if (!resSeen.has(k)) {
+        resSeen.add(k);
+        resourceIds.push(value);
+      }
+    },
+    addFk: (table, value) => {
+      if (!isVendorId(value)) return;
+      const k = `${table}:${String(value)}`;
+      if (!fkSeen.has(k)) {
+        fkSeen.add(k);
+        recordFks.push({ table, id: value });
+      }
+    },
+    addLineOfBusinessFromContract: (value) => {
+      if (!isVendorId(value)) return;
+      lineOfBusinessContractId = value;
+    },
+    addLineOfBusiness: (value, origin) => {
+      if (!isVendorId(value)) return;
+      lineOfBusinessId = value;
+      if (origin !== void 0) {
+        lineOfBusinessSource = origin.source;
+        if (origin.contractId !== void 0) lineOfBusinessContractId = origin.contractId;
+      }
+    }
+  };
 }
-async function dateWindowQuery(http, path, field, kind, limit, operation, now, tz) {
-  const zone = tz === void 0 ? void 0 : validateZone(tz, operation);
-  const { from, to } = dateOnlyWindowBounds(kind, now, zone);
-  const filter = [
-    { field, op: "gte", value: from },
-    { field, op: "lte", value: to }
-  ];
-  const res = await http.request({
-    method: "POST",
-    idempotent: true,
-    path,
-    body: { MaxRecords: limit, filter },
-    operation
-  });
-  return unwrapItems(res).items;
+function addNameSibling(row, field, resolve) {
+  const value = row[field];
+  if (value === void 0) return;
+  row[`${field}Name`] = isVendorId(value) ? resolve(value) : null;
 }
-var isoUtc = (ms) => new Date(ms).toISOString().slice(0, 19) + "Z";
-function customRangeDay(value, label, zone, opName) {
-  const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value.trim());
-  if (!m) {
-    throw new AutotaskConfigError(
-      zone === void 0 ? `${opName}: ${label} must be a UTC 'YYYY-MM-DD' date (got ${JSON.stringify(value)})` : `${opName}: ${label} must be a 'YYYY-MM-DD' local calendar day in ${zone} (got ${JSON.stringify(value)})`,
-      { operation: opName }
-    );
-  }
-  const y = Number(m[1]);
-  const mo = Number(m[2]);
-  const d = Number(m[3]);
-  const probe = new Date(Date.UTC(y, mo - 1, d));
-  const real = probe.getUTCFullYear() === y && probe.getUTCMonth() === mo - 1 && probe.getUTCDate() === d;
-  const ms = !real ? NaN : zone === void 0 ? Date.UTC(y, mo - 1, d) : localDayStartMs(y, mo, d, zone);
-  if (!Number.isFinite(ms)) {
-    throw new AutotaskConfigError(
-      zone === void 0 ? `${opName}: ${label} is not a valid UTC date (${JSON.stringify(value)})` : `${opName}: ${label} is not a valid calendar day in ${zone} (${JSON.stringify(value)})`,
-      { operation: opName }
-    );
-  }
-  return { y, mo, d, ms };
+function addLabelSibling(row, field, names) {
+  const value = row[field];
+  if (value === void 0) return;
+  row[`${field}Label`] = names.labelFor(field, value);
 }
-async function customRangeQuery(http, path, field, from, to, limit, operation, zone) {
-  if (zone !== void 0) validateZone(zone, operation);
-  const fromB = customRangeDay(from, "from", void 0, operation);
-  const toB = customRangeDay(to, "to", void 0, operation);
-  if (fromB.ms > toB.ms) {
-    throw new AutotaskConfigError(
-      `${operation}: from (${isoUtc(fromB.ms)}) must not be after to (${isoUtc(toB.ms)})`,
-      { operation }
-    );
+var FK_TABLE_PATH = {
+  role: "/V1.0/Roles",
+  billingCode: "/V1.0/BillingCodes",
+  contract: "/V1.0/Contracts",
+  company: "/V1.0/Companies",
+  ticket: "/V1.0/Tickets"
+};
+var FK_NAME_FIELD = {
+  role: "name",
+  billingCode: "name",
+  contract: "contractName",
+  company: "companyName",
+  ticket: "ticketNumber"
+};
+function fkName(record, table) {
+  if (table === "ticket") {
+    const parts = [record["ticketNumber"], record["title"]].filter((v) => typeof v === "string" && v.trim() !== "").map((v) => v.trim());
+    return parts.length > 0 ? parts.join(" ") : null;
   }
-  const toEndMs = toB.ms + DAY_MS - 1;
-  const filter = [
-    { field, op: "gte", value: isoUtc(fromB.ms) },
-    { field, op: "lte", value: isoUtc(toEndMs) }
-  ];
-  const res = await http.request({
-    method: "POST",
-    idempotent: true,
-    path,
-    body: { MaxRecords: limit, filter },
-    operation
-  });
-  return unwrapItems(res).items;
-}
-
-// src/resources/special/billing_items.ts
-async function windowQuery(_resource, kind, http, opts) {
-  const now = opts?.now ?? /* @__PURE__ */ new Date();
-  const tz = opts?.tz === void 0 ? void 0 : validateZone(opts.tz, `billing_items.${kind}`);
-  return dateWindowQuery(
-    http,
-    "/V1.0/BillingItems/query",
-    "itemDate",
-    kind,
-    clampWindowLimit(opts?.limit),
-    `billing_items.${kind}`,
-    now,
-    tz
-  );
+  const value = record[FK_NAME_FIELD[table]];
+  return typeof value === "string" && value.trim() !== "" ? value : null;
 }
-async function customRange(_resource, from, to, http, opts) {
-  const zone = opts?.tz === void 0 ? void 0 : validateZone(opts.tz, "billing_items.customRange");
-  return customRangeQuery(
-    http,
-    "/V1.0/BillingItems/query",
-    "itemDate",
-    from,
-    to,
-    clampWindowLimit(opts?.limit),
-    "billing_items.customRange",
-    zone
-  );
+function faultRow(err) {
+  const e = err;
+  return e.httpStatus !== void 0 ? { code: e.code, message: e.message, httpStatus: e.httpStatus } : { code: e.code, message: e.message };
 }
-
-// src/resources/billing_items.ts
-var BillingItemsResource = class extends BaseResource {
-  constructor(http, pageSize) {
-    super(http, {
-      key: "billing_items",
-      resourcePath: "/V1.0/BillingItems",
-      deletable: false,
-      udfCapable: false,
-      collectionUpdate: true
-      // D1: the spec's item path is GET-only — confirmed updates PUT the collection (id in the body)
-    }, pageSize);
-  }
-  /** Query BillingItems records with the G3 filter surface (server-side JSON filter). */
-  query(params) {
-    return this.queryItems(params);
-  }
-  /** Get every BillingItems record (the MCP-preferred read; 1000-page guarded). */
-  async queryAll(params) {
-    return this.queryAllItems(params);
-  }
-  /** Count matching records (queryCount envelope unwrapped to a plain number). */
-  async count(params) {
-    return this.countGlobal(params);
-  }
-  /** 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, opts?.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
-   * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
-   * stale-object guard's read) then the collection PUT of the merged model — an explicit null in the
-   * caller body sends null; an omitted field keeps the current value. `raw: true` in the opts bag sends
-   * the body as-is (full model or intentional partial — the compatibility escape hatch; no merge read).
-   * `dryRun: true` returns the pinned envelope whose `data` is the merged body (the exact confirmed
-   * wire) with the best-effort diff, from that same single read; a caller-supplied lastModifiedDate that
-   * mismatches the vendor's current value throws STALE_OBJECT before the mutation. */
-  async update(id, data, opts = {}) {
-    if (opts.dryRun === true) return this.runUpdateDryRun(id, data, opts);
-    return this.updateGlobal(id, data, opts);
-  }
-  /** Resolve a BillingItems from a numeric id (or, where the vendor indexes a primary text field,
-   * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
-   * a bare value rejects with a config error (ids only);
-   * non-match returns null; ambiguity throws RESOLUTION_AMBIGUOUS (candidate ids) and a
-   * cap-tripped bounded client scan throws RESOLUTION_TRUNCATED (never a silent null).
-   * The compact shape is the structural alias of the full record; `expand: true` is the
-   * type-level escape hatch. */
-  async resolve(identifier, opts = {}) {
-    void opts;
-    return this.resolveBase(identifier);
-  }
-  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
-  customRange(from, to, opts) {
-    return customRange(this, from, to, this.http, opts);
-  }
-  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
-  last14(opts) {
-    return windowQuery(this, "last14", this.http, opts);
-  }
-  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
-  last24h(opts) {
-    return windowQuery(this, "last24h", this.http, opts);
-  }
-  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
-  last30(opts) {
-    return windowQuery(this, "last30", this.http, opts);
-  }
-  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
-  last7(opts) {
-    return windowQuery(this, "last7", this.http, opts);
-  }
-  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
-  last90(opts) {
-    return windowQuery(this, "last90", this.http, opts);
-  }
-  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
-  lastFullFortnight(opts) {
-    return windowQuery(this, "lastFullFortnight", this.http, opts);
-  }
-  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
-  lastFullMonth(opts) {
-    return windowQuery(this, "lastFullMonth", this.http, opts);
-  }
-  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
-  lastFullQuarter(opts) {
-    return windowQuery(this, "lastFullQuarter", this.http, opts);
-  }
-  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
-  lastFullWeek(opts) {
-    return windowQuery(this, "lastFullWeek", this.http, opts);
+function vendorId(value) {
+  if (typeof value === "number") return Number.isSafeInteger(value) && value >= 1 ? value : void 0;
+  if (typeof value === "string" && /^[0-9]+$/.test(value.trim())) {
+    const n = Number(value.trim());
+    return Number.isSafeInteger(n) && n >= 1 ? n : void 0;
   }
-  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
-  today(opts) {
-    return windowQuery(this, "today", this.http, opts);
+  return void 0;
+}
+async function resolveLineOfBusinessChain(http, associationId, options) {
+  const operation = options.operation ?? "compositeNames";
+  const degrade = options.onError === "degrade";
+  const get = (path) => {
+    const res = http.request({ method: "GET", path, operation }).then((body) => {
+      const b = body;
+      if (b === null || !("item" in b) || b.item === null || b.item === void 0) return null;
+      return b.item;
+    });
+    if (!degrade) {
+      return res.catch((e) => {
+        if (e instanceof NotFoundError) return null;
+        throw e;
+      });
+    }
+    return res.catch((e) => {
+      if (e instanceof NotFoundError || isAutotaskError(e) && e.code !== "ABORTED") return null;
+      throw e;
+    });
+  };
+  let remaining = options.budget;
+  if (remaining < 1) {
+    return {
+      lineOfBusiness: { association: null, organizationalLevel2: null, organizationalLevel1: null, markers: { association: "capped", organizationalLevel2: "capped", organizationalLevel1: "capped" } },
+      used: 0,
+      truncated: true
+    };
   }
-  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
-  yesterday(opts) {
-    return windowQuery(this, "yesterday", this.http, opts);
+  remaining -= 1;
+  const association = await get(`/V1.0/OrganizationalLevelAssociations/${associationId}`);
+  const associationMarker = association === null ? "unresolved" : "ok";
+  if (association === null) {
+    return {
+      lineOfBusiness: { association: null, organizationalLevel2: null, organizationalLevel1: null, markers: { association: associationMarker, organizationalLevel2: "missing", organizationalLevel1: "missing" } },
+      used: 1,
+      truncated: false
+    };
   }
-};
-
-// src/operations/expandResourceNames.ts
-var EXPAND_RESOURCE_NAMES_MAX_IDS = 500;
-function composeName(record) {
-  const parts = [];
-  for (const field of ["firstName", "middleName", "lastName"]) {
-    const value = record[field];
-    if (typeof value === "string" && value.trim() !== "") parts.push(value.trim());
+  const l2Id = vendorId(association.organizationalLevel2ID);
+  const l1Id = vendorId(association.organizationalLevel1ID);
+  let l2Marker = l2Id !== void 0 ? "unresolved" : "missing";
+  let l1Marker = l1Id !== void 0 ? "unresolved" : "missing";
+  const need = (l2Id !== void 0 ? 1 : 0) + (l1Id !== void 0 ? 1 : 0);
+  let l2 = null;
+  let l1 = null;
+  let used = 1;
+  let truncated = false;
+  if (need > 0 && remaining < need) {
+    truncated = true;
+    if (l2Id !== void 0) l2Marker = "capped";
+    if (l1Id !== void 0) l1Marker = "capped";
+  } else {
+    used += need;
+    const [r2, r1] = await Promise.all([
+      l2Id !== void 0 ? get(`/V1.0/OrganizationalLevel2s/${l2Id}`) : Promise.resolve(null),
+      l1Id !== void 0 ? get(`/V1.0/OrganizationalLevel1s/${l1Id}`) : Promise.resolve(null)
+    ]);
+    l2 = r2;
+    l1 = r1;
+    if (l2Id !== void 0) l2Marker = l2 === null ? "unresolved" : "ok";
+    if (l1Id !== void 0) l1Marker = l1 === null ? "unresolved" : "ok";
   }
-  return parts.length > 0 ? parts.join(" ") : null;
+  return {
+    lineOfBusiness: { association, organizationalLevel2: l2, organizationalLevel1: l1, markers: { association: associationMarker, organizationalLevel2: l2Marker, organizationalLevel1: l1Marker } },
+    used,
+    truncated
+  };
 }
-async function expandResourceNames(client, ids2, opts = {}) {
-  if (opts.maxIds !== void 0 && (!Number.isInteger(opts.maxIds) || opts.maxIds < 1)) {
-    throw new AutotaskConfigError(`expandResourceNames: maxIds must be an integer >= 1 (got ${String(opts.maxIds)})`);
+async function resolveCompositeNames(http, plan, opts = {}) {
+  if (opts.maxNameReads !== void 0 && (!Number.isInteger(opts.maxNameReads) || opts.maxNameReads < 1)) {
+    throw new AutotaskConfigError(`composite names: maxNameReads must be an integer >= 1 (got ${String(opts.maxNameReads)})`);
   }
-  const cap = Math.min(EXPAND_RESOURCE_NAMES_MAX_IDS, opts.maxIds ?? EXPAND_RESOURCE_NAMES_MAX_IDS);
-  if (!Array.isArray(ids2) || ids2.length === 0) {
-    throw new AutotaskConfigError(
-      "expandResourceNames: ids must be a non-empty array of vendor numeric resource ids (a zero-id call is a shape error, not a no-op)",
-      { suggestedAction: "Pass at least one vendor numeric resource id \u2014 safe integer, or the canonical integer string for ids above 2^53." }
-    );
+  const budget = Math.min(DEFAULT_MAX_NAME_READS, opts.maxNameReads ?? DEFAULT_MAX_NAME_READS);
+  const client = http.client;
+  if (client === void 0) {
+    throw new AutotaskConfigError("composite names: the transport is not wired to an AutotaskClient (the composite must run through the client)");
   }
-  if (ids2.length > cap) {
-    throw new AutotaskConfigError(
-      `expandResourceNames: ${ids2.length} ids over the ${cap}-id cap (EXPAND_RESOURCE_NAMES_MAX_IDS = ${EXPAND_RESOURCE_NAMES_MAX_IDS}; maxIds may lower, never raise) \u2014 zero ids were fetched (pre-request)`,
-      { suggestedAction: `Split the call into groups of <= ${cap} ids.` }
-    );
+  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;
+    coldResource.push(id);
   }
-  const problems = [];
-  const canonical = [];
-  for (let i = 0; i < ids2.length; i += 1) {
-    const at = `ids[${i}]`;
-    const raw = ids2[i];
-    try {
-      canonical[i] = parseIdentifier(raw, at);
-    } catch {
-      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") {
-        problems.push(`${at}: ${raw} is not a non-negative safe integer (a JS number this large is already corrupted \u2014 pass the canonical integer string form)`);
-      } else {
-        problems.push(`${at}: required \u2014 the vendor numeric resource id (safe integer, or the canonical integer string for ids above 2^53)`);
+  const withinBudget = coldResource.slice(0, remaining);
+  const overBudgetResource = coldResource.slice(remaining);
+  remaining -= withinBudget.length;
+  for (const id of overBudgetResource) {
+    section.rows[`resource:${id}`] = { name: null, blind: false, capped: true };
+    section.truncated = true;
+  }
+  const overSet = new Set(overBudgetResource.map((id) => String(id)));
+  const opIds = plan.resourceIds.filter((id) => !overSet.has(String(id)));
+  if (opIds.length > 0) {
+    let pass = opIds;
+    if (pass.length > 500) {
+      for (const id of pass.slice(500)) {
+        section.rows[`resource:${id}`] = { name: null, blind: false, capped: true };
+        section.truncated = true;
       }
+      pass = pass.slice(0, 500);
     }
-  }
-  if (problems.length > 0) {
-    throw new AutotaskConfigError(`expandResourceNames: ${problems.length} problem(s) found pre-request (zero wire was issued)
-- ` + problems.join("\n- "), {
-      suggestedAction: "Fix every id above and call again \u2014 the ids are vendor NUMERIC resource ids only (name-to-id resolution is operations.resolveAny territory)."
-    });
-  }
-  const unique = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const id of canonical) {
-    const k = String(id);
-    if (!seen.has(k)) {
-      seen.add(k);
-      unique.push(id);
+    const res = await expandResourceNames(client, pass);
+    for (const r of res.results) {
+      const row = { name: r.name, blind: r.blind, capped: false };
+      if (r.error !== void 0) row.error = faultRow(r.error);
+      section.rows[`resource:${r.id}`] = row;
     }
   }
-  const holder = client.resources;
-  const cache = client.http.resourceNameCache;
-  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 holders = {
+    role: client.roles,
+    billingCode: client.billingCodes,
+    contract: client.contracts,
+    company: client.companies,
+    ticket: client.tickets
+  };
+  for (const fk of plan.recordFks) {
+    const key = `${fk.table}:${fk.id}`;
+    const cold = readCache === void 0 || readCache.get(`${FK_TABLE_PATH[fk.table]}/${fk.id}`) === void 0;
+    if (cold) {
+      if (remaining < 1) {
+        section.rows[key] = { name: null, blind: false, capped: true };
+        section.truncated = true;
+        if (fk.table === "contract" && plan.lineOfBusinessContractId !== void 0 && String(fk.id) === String(plan.lineOfBusinessContractId)) {
+          contractLobUnread = "capped";
         }
-      }
-      const hit = cache.get(id);
-      if (hit !== void 0) {
-        byId.set(k, { name: hit.name, blind: hit.blind });
         continue;
       }
+      remaining -= 1;
     }
-    const epoch = cache?.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 };
+    try {
+      const record = await holders[fk.table].get(fk.id);
+      if (fk.table === "contract" && plan.lineOfBusinessId === void 0 && plan.lineOfBusinessContractId !== void 0 && String(fk.id) === String(plan.lineOfBusinessContractId)) {
+        contractLobPointer = vendorId(record["organizationalLevelAssociationID"]);
+      }
+      section.rows[key] = { name: fkName(record, fk.table), blind: false, capped: false };
+    } catch (err) {
+      if (err instanceof NotFoundError) {
+        section.rows[key] = { name: null, blind: true, capped: false };
+      } else if (isAutotaskError(err) && err.code !== "ABORTED") {
+        section.rows[key] = { name: null, blind: false, capped: false, error: faultRow(err) };
+        if (fk.table === "contract" && plan.lineOfBusinessContractId !== void 0 && String(fk.id) === String(plan.lineOfBusinessContractId)) {
+          contractLobUnread = "unresolved";
         }
+      } else {
         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) {
-    const out = byId.get(String(id));
-    results.push({ id, name: out.name, blind: out.blind, ...out.error !== void 0 ? { error: out.error } : {} });
+  const picklists = {};
+  if (plan.labelFields.length > 0) {
+    let usable = true;
+    try {
+      const labelResource = plan.labelResource ?? "tickets";
+      const catalog = await fieldCatalog(client, { resources: [labelResource], labels: true, fields: [...plan.labelFields] });
+      const row = catalog.rows.find((r) => r.resource === labelResource);
+      if (row === void 0 || row.error !== null || row.fields === void 0) {
+        usable = false;
+      } else {
+        for (const f of plan.labelFields) {
+          const frow = row.fields.find((x) => x.name === f);
+          picklists[f] = frow?.picklistValues;
+        }
+      }
+    } catch (err) {
+      if (isAutotaskError(err) && err.code !== "ABORTED") usable = false;
+      else throw err;
+    }
+    if (!usable) for (const f of plan.labelFields) section.reasons[f] = FIELD_CATALOG_HONESTY_NOTE;
   }
-  const resolved = results.filter((r) => r.name !== null).length;
-  const blind = results.filter((r) => r.blind === true).length;
-  const failed = results.filter((r) => r.error !== void 0).length;
-  return { results, resolved, blind, failed };
+  let lineOfBusiness2 = null;
+  const lobId = plan.lineOfBusinessId ?? contractLobPointer;
+  if (lobId !== void 0) {
+    const chain = await resolveLineOfBusinessChain(http, lobId, { budget: remaining, onError: "degrade" });
+    remaining -= chain.used;
+    if (chain.truncated) section.truncated = true;
+    const fromContract = plan.lineOfBusinessId === void 0;
+    lineOfBusiness2 = {
+      ...chain.lineOfBusiness,
+      ...fromContract ? { source: "contract", contractId: plan.lineOfBusinessContractId } : plan.lineOfBusinessSource !== void 0 ? { source: plan.lineOfBusinessSource } : {},
+      ...!fromContract && plan.lineOfBusinessContractId !== void 0 ? { contractId: plan.lineOfBusinessContractId } : {}
+    };
+  } else if (contractLobUnread !== void 0 && plan.lineOfBusinessContractId !== void 0) {
+    lineOfBusiness2 = {
+      source: "contract",
+      contractId: plan.lineOfBusinessContractId,
+      association: null,
+      organizationalLevel2: null,
+      organizationalLevel1: null,
+      markers: { association: contractLobUnread, organizationalLevel2: "missing", organizationalLevel1: "missing" }
+    };
+  }
+  return {
+    section,
+    lineOfBusiness: lineOfBusiness2,
+    resourceName: (id) => section.rows[`resource:${id}`]?.name ?? null,
+    recordName: (table, id) => section.rows[`${table}:${id}`]?.name ?? null,
+    labelFor: (field, value) => {
+      if (value === null || value === void 0) return null;
+      const values = picklists[field];
+      if (values === void 0) {
+        section.reasons[field] = FIELD_CATALOG_HONESTY_NOTE;
+        return null;
+      }
+      const hit = values.find((v) => String(v.value) === String(value));
+      if (hit === void 0) {
+        section.reasons[field] = PICKLIST_VALUE_NOT_SERVED_NOTE;
+        return null;
+      }
+      return typeof hit.label === "string" ? hit.label : null;
+    }
+  };
 }
-
-// src/operations/entityType.ts
-function buildEntityTypeMap() {
-  const exact = {};
-  for (const [resource, entry] of Object.entries(RELATIONSHIP_MAP)) {
-    const apiEntity = entry.apiEntity;
-    if (typeof apiEntity !== "string" || apiEntity === "") continue;
-    if (exact[apiEntity] === void 0) exact[apiEntity] = resource;
-  }
-  const aliases = {};
-  for (const [apiEntity, resource] of Object.entries(exact)) {
-    if (!apiEntity.endsWith("s") || apiEntity.endsWith("ss")) continue;
-    const singular = apiEntity.slice(0, -1);
-    if (exact[singular] !== void 0 || aliases[singular] !== void 0) continue;
-    aliases[singular] = resource;
+var ROW_FK_TABLES = {
+  companyID: "company",
+  contractID: "contract",
+  ticketID: "ticket",
+  roleID: "role",
+  billingCodeID: "billingCode"
+};
+var isResourceFkField = (field) => field === "resourceID" || field.endsWith("ResourceID");
+var LABEL_NAME_MAX_CHARS = 200;
+function untrustedName(name) {
+  if (name === null) return null;
+  const [[capped]] = truncateNoteChars([{ v: name }], LABEL_NAME_MAX_CHARS, ["v"]);
+  return wrapUntrusted(capped.v) ?? capped.v;
+}
+function readNamesOpt(value, where) {
+  if (value === void 0) return true;
+  if (typeof value !== "boolean") {
+    throw new AutotaskConfigError(`${where}: names must be a boolean (got ${typeof value}) \u2014 true (default) adds label siblings, false returns raw ids only`);
   }
-  return { ...exact, ...aliases };
-}
-var ENTITY_TYPE_TO_RESOURCE = buildEntityTypeMap();
-var ENUMERABLE_RESOURCES = new Set(
-  CAPABILITIES.filter((rec) => rec.resource !== "operations" && (rec.operation === "query" || rec.operation === "get")).map(
-    (rec) => rec.resource
-  )
-);
-function resourceForEntityType(entityType) {
-  if (typeof entityType !== "string" || entityType === "") return null;
-  return ENTITY_TYPE_TO_RESOURCE[entityType] ?? null;
-}
-function isEnumerableResource(resource) {
-  if (typeof resource !== "string" || resource === "") return false;
-  return ENUMERABLE_RESOURCES.has(resource);
+  return value;
 }
-
-// src/operations/types.ts
-var WORKFLOW_RESOURCES = [
-  "companies",
-  "tickets",
-  "contacts",
-  "configuration_items",
-  "projects"
-];
-
-// src/operations/fieldCatalog.ts
-var MAX_FIELD_CATALOG_WIRE = 60;
-var FIELD_CATALOG_HONESTY_NOTE = "Live field metadata reports the SHAPE of a field (existence, requiredness, type, maxLength, read-only, queryable, picklist-ness) as FLAGS and NAMES: picklist-ness as a flag (isPickList) and picklist field names (picklistFields). With the opt-in `labels: true`, picklist rows carry the vendor's exposed picklist VALUES (labels next to each value); without it the op serves no VALUES. It cannot resolve a picklist VALUE the vendor does not expose to this API user (the W-A4 wall \u2014 e.g. the attachments Type picklist): retrying the catalog will not surface a withheld value; that gap is vendor-side, not a client defect.";
-var FIELD_CATALOG_OPT_KEYS = ["resources", "include", "fresh", "fields", "labels"];
-function projectFieldRow(raw, labels = false, udf = false) {
-  const r = typeof raw === "object" && raw !== null ? raw : {};
-  const name = typeof r.name === "string" ? r.name : "";
-  const type = typeof r.dataType === "string" ? r.dataType : typeof r.type === "string" ? r.type : "";
-  const values = labels && r.isPickList === true && Array.isArray(r.picklistValues) && r.picklistValues.length > 0 ? r.picklistValues : void 0;
-  const referenceEntityType = typeof r.referenceEntityType === "string" ? r.referenceEntityType : "";
-  const targetResource = resourceForEntityType(referenceEntityType);
+async function labelRows(client, resourceKey, rows) {
+  const present = /* @__PURE__ */ new Set();
+  for (const row of rows) for (const [k, v] of Object.entries(row)) if (v !== null && v !== void 0) present.add(k);
+  if (present.size === 0) return { rows: [...rows] };
+  let picklistFields = [];
+  const modelFields = MODEL_FIELD_SETS[resourceKey] ?? [];
+  const candidates = [...present].filter((f) => f !== "id" && modelFields.includes(f) && ROW_FK_TABLES[f] === void 0 && !isResourceFkField(f));
+  if (candidates.length > 0) try {
+    const catalog = await fieldCatalog(client, { resources: [resourceKey], labels: true });
+    const fields = catalog.rows.find((r) => r.resource === resourceKey)?.fields ?? [];
+    picklistFields = fields.filter((f) => f.isPickList && candidates.includes(f.name)).map((f) => f.name);
+  } catch (err) {
+    if (!isAutotaskError(err) || err.code === "ABORTED") throw err;
+  }
+  const builder = createNamePlan(picklistFields, resourceKey);
+  for (const row of rows) {
+    for (const [field, value] of Object.entries(row)) {
+      if (value === 0 || value === "0") continue;
+      const table = ROW_FK_TABLES[field];
+      if (table !== void 0) builder.addFk(table, value);
+      else if (isResourceFkField(field)) builder.addResource(value);
+    }
+  }
+  const plan = builder.plan();
+  if (plan.resourceIds.length === 0 && plan.recordFks.length === 0 && picklistFields.length === 0) return { rows: [...rows] };
+  const names = await resolveCompositeNames(client.http, plan);
+  const out = rows.map((row) => {
+    const r = { ...row };
+    for (const [field, value] of Object.entries(row)) {
+      if (value === null || value === void 0 || value === 0 || value === "0") continue;
+      if (picklistFields.includes(field)) r[`${field}Label`] = names.labelFor(field, value);
+      const table = ROW_FK_TABLES[field];
+      if (table !== void 0 && isVendorId(value)) r[`${field}Name`] = untrustedName(names.recordName(table, value));
+      else if (isResourceFkField(field) && isVendorId(value)) r[`${field}Name`] = untrustedName(names.resourceName(value));
+    }
+    if (r["assignedResourceIDName"] !== void 0) r["assignedResourceName"] = r["assignedResourceIDName"];
+    return r;
+  });
+  const capped = Object.values(names.section.rows).filter((row) => row.capped).length;
+  const reasons = names.section.reasons;
+  if (capped === 0 && Object.keys(reasons).length === 0) return { rows: out };
+  const parts = [];
+  if (capped > 0) parts.push(`${capped} id(s) left unlabelled (their *Name is null): the per-call cap of ${DEFAULT_MAX_NAME_READS} uncached name reads was hit \u2014 names already read are cached, so repeating or narrowing the call labels more`);
+  if (Object.keys(reasons).length > 0) parts.push(`picklist label(s) unavailable for ${Object.keys(reasons).join(", ")} (see reasons)`);
   return {
-    name,
-    ...typeof r.label === "string" && r.label !== "" ? { label: r.label } : {},
-    type,
-    isRequired: r.isRequired === true,
-    isReadOnly: r.isReadOnly === true,
-    // Issue #219 N7: a UDF row never serves the vendor's isQueryable (it is
-    // true for UDFs while a plain filter on a UDF name is refused); it serves
-    // the marker the filter actually needs.
-    ...udf ? { filterable: "udf-marker" } : { isQueryable: r.isQueryable === true },
-    isPickList: r.isPickList === true,
-    ...isObjectOrArrayType(type) ? { writeShape: "replace-all" } : {},
-    maxLength: typeof r.length === "number" ? r.length : null,
-    referenceEntityType,
-    targetResource,
-    targetEnumerable: isEnumerableResource(targetResource),
-    ...values !== void 0 ? { picklistValues: values } : {}
+    rows: out,
+    names: { truncated: capped > 0, capped, note: parts.join("; "), ...Object.keys(reasons).length > 0 ? { reasons } : {} }
   };
 }
-function isObjectOrArrayType(type) {
-  const t = type.trim().toLowerCase();
-  return t === "object" || t === "array" || t === "collection" || t.endsWith("[]");
-}
-function exposesPicklistValues(raw) {
-  const r = typeof raw === "object" && raw !== null ? raw : {};
-  return Array.isArray(r.picklistValues) && r.picklistValues.length > 0;
+async function labelFetchResults(client, result) {
+  const byResource = /* @__PURE__ */ new Map();
+  result.results.forEach((r, i) => {
+    if (r.found && r.value !== null) byResource.set(r.resource, [...byResource.get(r.resource) ?? [], i]);
+  });
+  const results = [...result.results];
+  const summaries = [];
+  for (const [resource, indices] of byResource) {
+    const labelled = await labelRows(client, resource, indices.map((i) => results[i].value));
+    indices.forEach((idx, j) => {
+      results[idx] = { ...results[idx], value: labelled.rows[j] };
+    });
+    if (labelled.names !== void 0) summaries.push(labelled.names);
+  }
+  if (summaries.length === 0) return { ...result, results };
+  const reasons = Object.assign({}, ...summaries.map((s) => s.reasons ?? {}));
+  const names = {
+    truncated: summaries.some((s) => s.truncated),
+    capped: summaries.reduce((n, s) => n + s.capped, 0),
+    note: summaries.map((s) => s.note).join("; "),
+    ...Object.keys(reasons).length > 0 ? { reasons } : {}
+  };
+  return { ...result, results, names };
 }
-function applyFieldsFilter(projected, filter, row) {
-  const kept = filter === void 0 ? projected : projected.filter((f) => filter.includes(f.name));
-  if (filter !== void 0) {
-    const present = new Set(projected.map((f) => f.name));
-    row.unmatchedFields = filter.filter((n) => !present.has(n));
-    row.projected = true;
+
+// src/resources/billing_codes.ts
+var BillingCodesResource = class extends BaseResource {
+  constructor(http, pageSize) {
+    super(http, {
+      key: "billing_codes",
+      resourcePath: "/V1.0/BillingCodes",
+      deletable: false,
+      udfCapable: false,
+      searchFields: ["name"]
+    }, pageSize);
   }
-  row.fields = kept;
-  row.required = kept.filter((f) => f.isRequired).map((f) => f.name);
-  row.readOnly = kept.filter((f) => f.isReadOnly).map((f) => f.name);
-  row.queryable = kept.filter((f) => f.isQueryable).map((f) => f.name);
-  row.picklistFields = kept.filter((f) => f.isPickList).map((f) => f.name);
-}
-function capabilitySets() {
-  const fieldOps = /* @__PURE__ */ new Map();
-  const udfCapable = /* @__PURE__ */ new Set();
-  const resources = /* @__PURE__ */ new Set();
-  for (const rec of CAPABILITIES) {
-    if (rec.resource === "operations") continue;
-    resources.add(rec.resource);
-    if (rec.operation === "getFieldInfo") fieldOps.set(rec.resource, rec);
-    if (rec.udfCapable) udfCapable.add(rec.resource);
+  /** Query BillingCode records with the G3 filter surface (server-side JSON filter). */
+  query(params) {
+    return this.queryItems(params);
   }
-  return { fieldOps, udfCapable, resources };
-}
-var derivedIndex = null;
-function derivedFieldsFor(resource) {
-  if (derivedIndex === null) {
-    derivedIndex = /* @__PURE__ */ new Map();
-    for (const rec of CAPABILITIES) {
-      const declared = rec.metadata?.derivedFields;
-      if (!Array.isArray(declared) || derivedIndex.has(rec.resource)) continue;
-      const rows = [];
-      for (const row of declared) {
-        if (typeof row?.field !== "string" || typeof row.rule !== "string") continue;
-        rows.push({
-          field: row.field,
-          rule: row.rule,
-          ...typeof row.writableRoute === "string" ? { writableRoute: row.writableRoute } : {}
-        });
-      }
-      derivedIndex.set(rec.resource, rows);
-    }
+  /** Get every BillingCode record (the MCP-preferred read; 1000-page guarded). */
+  async queryAll(params) {
+    return this.queryAllItems(params);
   }
-  return derivedIndex.get(resource) ?? [];
-}
-function apiEntityFor(rec) {
-  const m = /^GET \/V1\.0\/([^/]+)\/entityInformation\/fields$/.exec(rec.endpoint ?? "");
-  if (m === null) {
-    throw new AutotaskConfigError(
-      `fieldCatalog: the plan's getFieldInfo endpoint for "${rec.resource}" has no /V1.0/<Entity>/entityInformation/fields shape (${rec.endpoint}) \u2014 plan defect`,
-      { operation: "operations.fieldCatalog" }
-    );
+  /** Count matching records (queryCount envelope unwrapped to a plain number). */
+  async count(params) {
+    return this.countGlobal(params);
   }
-  return m[1];
-}
-function validateCatalogOptsShape(opts) {
-  if (opts !== void 0 && (typeof opts !== "object" || opts === null || Array.isArray(opts))) {
-    throw new AutotaskConfigError(
-      "fieldCatalog: opts must be an object { resources?: string[], include?: (info|fields|udf)[], fresh?: boolean, fields?: string[], labels?: boolean }"
-    );
+  /** 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, opts?.fresh === true);
   }
-  for (const key of Object.keys(opts ?? {})) {
-    if (!FIELD_CATALOG_OPT_KEYS.includes(key)) {
-      throw new AutotaskConfigError(
-        `fieldCatalog: unknown opts key "${key}" \u2014 the bag is closed: ${FIELD_CATALOG_OPT_KEYS.join(", ")}`,
-        { suggestedAction: "Drop the unknown key (autotask_describe(operations.fieldCatalog) shows the exact bag)." }
-      );
-    }
+  /** 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
+   * non-match returns null; ambiguity throws RESOLUTION_AMBIGUOUS (candidate ids) and a
+   * cap-tripped bounded client scan throws RESOLUTION_TRUNCATED (never a silent null).
+   * The compact shape is the structural alias of the full record; `expand: true` is the
+   * type-level escape hatch. */
+  async resolve(identifier, opts = {}) {
+    void opts;
+    return this.resolveBase(identifier);
   }
-}
-function resolveInclude(opts) {
-  const includeRaw = opts?.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)");
+  /** 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: opts?.limit });
   }
-  const include = [];
-  for (const kind of includeRaw) {
-    if (typeof kind !== "string" || !FIELD_CACHE_KINDS.includes(kind)) {
-      throw new AutotaskConfigError(
-        `fieldCatalog: unknown include kind "${String(kind)}" \u2014 the valid kinds are: ${FIELD_CACHE_KINDS.join(", ")}`,
-        { suggestedAction: `Filter with one or more of: ${FIELD_CACHE_KINDS.join(", ")} (default ['fields']).` }
-      );
-    }
-    if (!include.includes(kind)) include.push(kind);
+};
+
+// src/resources/special/dateWindow.ts
+var DAY_MS = 864e5;
+var DEFAULT_LIMIT = 500;
+var MAX_LIMIT = 500;
+function clampWindowLimit(limit) {
+  const n = limit === void 0 ? DEFAULT_LIMIT : Math.trunc(limit);
+  if (!Number.isInteger(n) || n < 1) {
+    throw new AutotaskConfigError(`limit must be an integer >= 1 (got ${String(limit)})`);
   }
-  return include;
+  return Math.min(n, MAX_LIMIT);
 }
-function resolveTargets(opts, fieldOps, allResources) {
-  const resourcesRaw = opts?.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");
-  }
-  const targets = [];
-  for (const r of resourcesRaw) {
-    if (typeof r !== "string" || r.trim() === "") {
-      throw new AutotaskConfigError(
-        `fieldCatalog: opts.resources must contain non-empty plan resource key strings (got ${typeof r === "string" && r.trim() === "" ? "a blank string" : typeof r})`
-      );
-    }
-    const key = r.trim();
-    const fieldOp = fieldOps.get(key);
-    if (fieldOp === void 0) {
-      if (allResources.has(key)) {
-        throw new AutotaskConfigError(
-          `fieldCatalog: resource "${key}" has no field catalog \u2014 the vendor defines the entityInformation trio for the ${fieldOps.size} plan entity resources only`,
-          { suggestedAction: `Pass one of the ${fieldOps.size} field-capable plan keys (list them with autotask_catalog).` }
-        );
-      }
-      throw new AutotaskError(
-        `fieldCatalog: unknown resource "${key}" \u2014 the plan has ${fieldOps.size} field-capable resources`,
-        {
-          code: "RESOURCE_UNKNOWN",
-          category: "validation",
-          suggestedAction: "Pass the exact plan resource key (snake_case) from autotask_catalog (e.g. tickets, companies, configuration_items)."
-        }
-      );
+var iso = (ms) => new Date(ms).toISOString().slice(0, 19) + "Z";
+var WEEKDAYS = { Sun: 0, Mon: 1, Tue: 2, Wed: 3, Thu: 4, Fri: 5, Sat: 6 };
+function wallParts(tz, ms) {
+  const parts = new Intl.DateTimeFormat("en-US", {
+    timeZone: tz,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    hour12: false,
+    weekday: "short"
+  }).formatToParts(new Date(ms));
+  const w = {};
+  let weekday = -1;
+  for (const p of parts) {
+    switch (p.type) {
+      case "year":
+        w.y = Number(p.value);
+        break;
+      case "month":
+        w.m = Number(p.value);
+        break;
+      case "day":
+        w.d = Number(p.value);
+        break;
+      case "hour":
+        w.h = Number(p.value) % 24;
+        break;
+      case "minute":
+        w.mi = Number(p.value);
+        break;
+      case "second":
+        w.s = Number(p.value);
+        break;
+      case "weekday":
+        weekday = WEEKDAYS[p.value] ?? -1;
+        break;
     }
-    if (!targets.includes(key)) targets.push(key);
   }
-  return targets;
-}
-function resolveFieldsFilter(opts) {
-  const fieldsRaw = opts?.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");
+  if (weekday < 0 || [w.y, w.m, w.d, w.h, w.mi, w.s].some((v) => v === void 0 || Number.isNaN(v))) {
+    throw new AutotaskConfigError(`dateWindow: could not read the wall-clock parts for timezone "${tz}" (the Intl format returned an incomplete or unmapped part)`);
   }
-  const names = [];
-  for (const f of fieldsRaw) {
-    if (typeof f !== "string" || f.trim() === "") {
-      throw new AutotaskConfigError(
-        `fieldCatalog: opts.fields must contain non-empty vendor field name strings (got ${typeof f === "string" && f.trim() === "" ? "a blank string" : typeof f})`
-      );
-    }
-    const name = f.trim();
-    if (!names.includes(name)) names.push(name);
+  return { y: w.y, m: w.m, d: w.d, h: w.h, mi: w.mi, s: w.s, weekday };
+}
+function tzOffsetMs(tz, ms) {
+  const p = wallParts(tz, ms);
+  return Date.UTC(p.y, p.m - 1, p.d, p.h, p.mi, p.s) - ms;
+}
+function localDayStartMs(y, m, d, tz) {
+  if (tz === void 0) return Date.UTC(y, m - 1, d);
+  const candidate2 = Date.UTC(y, m - 1, d);
+  const offset = tzOffsetMs(tz, candidate2);
+  let start = candidate2 - offset;
+  if (tzOffsetMs(tz, start) !== offset) {
+    start = candidate2 - tzOffsetMs(tz, start);
   }
-  return names;
+  const p = wallParts(tz, start);
+  if (p.d !== d) start += 864e5 - ((p.h * 60 + p.mi) * 60 + p.s) * 1e3;
+  return start;
 }
-function resolveLabels(opts) {
-  if (opts !== void 0 && opts.labels !== void 0 && typeof opts.labels !== "boolean") {
+function localDayEndMs(y, m, d, tz) {
+  if (tz === void 0) return Date.UTC(y, m - 1, d) + DAY_MS - 1;
+  const next = new Date(Date.UTC(y, m - 1, d + 1));
+  return localDayStartMs(next.getUTCFullYear(), next.getUTCMonth() + 1, next.getUTCDate(), tz) - 1;
+}
+function validateZone(tz, opName = "dateWindow") {
+  if (typeof tz !== "string" || tz.length === 0) {
     throw new AutotaskConfigError(
-      `fieldCatalog: opts.labels must be a boolean (got ${typeof opts.labels})`
+      `${opName}: tz must be a non-empty IANA timezone string (got ${JSON.stringify(tz)}; e.g. 'Australia/Sydney' \u2014 omitted tz = UTC)`,
+      { operation: opName }
     );
   }
-  return opts?.labels === true;
-}
-function assertWithinWireCap(targetCount, kindCount) {
-  const cost = targetCount * kindCount;
-  if (cost > MAX_FIELD_CATALOG_WIRE) {
+  try {
+    new Intl.DateTimeFormat("en-US", { timeZone: tz });
+  } catch {
     throw new AutotaskConfigError(
-      `fieldCatalog: ${targetCount} resource(s) \xD7 ${kindCount} kind(s) = ${cost} metadata reads exceed the wire cap of ${MAX_FIELD_CATALOG_WIRE} \u2014 the call is refused above its cap (never truncated)`,
-      { suggestedAction: `Pass a smaller resources list or a narrower include set so the product stays \u2264 ${MAX_FIELD_CATALOG_WIRE}.` }
+      `${opName}: tz is not a valid IANA timezone (${JSON.stringify(tz)}; e.g. 'Australia/Sydney' \u2014 omitted tz = UTC)`,
+      { operation: opName }
     );
   }
+  return tz;
 }
-function kindFetches(holder, resource) {
-  return {
-    info: () => holder?.getEntityInfo?.() ?? Promise.reject(new AutotaskError(`fieldCatalog: the client exposes no getEntityInfo read for "${resource}"`, { code: "INVALID_RESPONSE", category: "server" })),
-    fields: () => holder?.getFieldInfo?.() ?? Promise.reject(new AutotaskError(`fieldCatalog: the client exposes no getFieldInfo read for "${resource}"`, { code: "INVALID_RESPONSE", category: "server" })),
-    udf: () => holder?.getUdfInfo?.() ?? Promise.reject(new AutotaskError(`fieldCatalog: the client exposes no getUdfInfo read for "${resource}"`, { code: "INVALID_RESPONSE", category: "server" }))
-  };
+var utcDayStart = (ms) => {
+  const d = new Date(ms);
+  return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate());
+};
+var utcDayEnd = (ms) => utcDayStart(ms) + DAY_MS - 1;
+function utcDateWindowBounds(kind, now) {
+  const t = now.getTime();
+  let from;
+  let to;
+  switch (kind) {
+    case "today":
+      from = utcDayStart(t);
+      to = utcDayEnd(t);
+      break;
+    case "yesterday":
+      from = utcDayStart(t - DAY_MS);
+      to = utcDayEnd(t - DAY_MS);
+      break;
+    case "last24h":
+      from = t - DAY_MS;
+      to = t;
+      break;
+    case "last7":
+    case "last14":
+    case "last30":
+    case "last90": {
+      const days = Number(kind.slice(4));
+      from = utcDayStart(t - days * DAY_MS);
+      to = utcDayEnd(t);
+      break;
+    }
+    case "lastFullWeek":
+    case "lastFullFortnight": {
+      const d = new Date(t);
+      const daysSinceMonday = (d.getUTCDay() + 6) % 7;
+      const thisMonday = utcDayStart(t) - daysSinceMonday * DAY_MS;
+      const daysBack = kind === "lastFullWeek" ? 7 : 14;
+      from = thisMonday - daysBack * DAY_MS;
+      to = thisMonday - 1;
+      break;
+    }
+    case "lastFullMonth": {
+      const d = new Date(t);
+      const y = d.getUTCFullYear();
+      const m = d.getUTCMonth() - 1;
+      from = Date.UTC(y, m, 1);
+      to = Date.UTC(y, m + 1, 1) - 1;
+      break;
+    }
+    case "lastFullQuarter": {
+      const d = new Date(t);
+      let q = Math.floor(d.getUTCMonth() / 3) - 1;
+      let y = d.getUTCFullYear();
+      if (q < 0) {
+        q = 3;
+        y -= 1;
+      }
+      const first = q * 3;
+      from = Date.UTC(y, first, 1);
+      to = Date.UTC(y, first + 3, 1) - 1;
+      break;
+    }
+  }
+  return { from: iso(from), to: iso(to) };
 }
-async function sweepResource(ctx, resource, tally) {
-  const { client, include, fieldsFilter, labels, fresh } = ctx;
-  const cache = client.http.fieldCache;
-  const fieldOp = ctx.fieldOps.get(resource);
-  if (fieldOp === void 0) return void 0;
-  const apiEntity = apiEntityFor(fieldOp);
-  const holder = client[camelKey(resource)];
-  const row = {
-    resource,
-    apiEntity,
-    udfCapable: ctx.udfCapable.has(resource),
-    // Issue #219 N7: the UDF surface is declared with the mechanism, not a boolean.
-    ...ctx.udfCapable.has(resource) ? { udfFilter: "udf-marker", udfWriteShape: "merge" } : {},
-    unmatchedFields: [],
-    required: [],
-    readOnly: [],
-    queryable: [],
-    picklistFields: [],
-    cache: { hit: false, age: null },
-    wire: 0,
-    error: null
+function dateWindowBounds(kind, now, tz) {
+  if (tz === void 0) return utcDateWindowBounds(kind, now);
+  const zone = validateZone(tz);
+  const t = now.getTime();
+  if (kind === "last24h") {
+    return { from: iso(t - DAY_MS), to: iso(t) };
+  }
+  const { y, m, d, weekday } = wallParts(zone, t);
+  const shifted = (dy) => new Date(Date.UTC(y, m - 1, d + dy));
+  const dayStart = (dy) => {
+    const dt = shifted(dy);
+    return localDayStartMs(dt.getUTCFullYear(), dt.getUTCMonth() + 1, dt.getUTCDate(), zone);
   };
-  const fetches = kindFetches(holder, resource);
-  if (fresh) cache?.invalidate(resource);
-  const projectList = (kind, list) => {
-    const projected = list.map((f) => projectFieldRow(f, labels, kind === "udf"));
-    if (kind === "fields") applyFieldsFilter(projected, fieldsFilter, row);
-    else row.udf = projected;
-    for (const f of list) if (exposesPicklistValues(f)) tally.anyPicklistValues = true;
+  const dayStartAt = (instant) => {
+    const p = wallParts(zone, instant);
+    return localDayStartMs(p.y, p.m, p.d, zone);
   };
-  let allCached = true;
-  const ages = [];
-  for (const kind of include) {
-    const peek = cache !== void 0 && !fresh ? cache.peek(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);
-      if (kind === "info") row.info = value2 ?? null;
-      else projectList(kind, Array.isArray(value2) ? value2 : []);
-      if (peek.age !== null) ages.push(peek.age);
-      continue;
-    }
-    let value;
-    try {
-      value = await fetches[kind]();
-    } catch (err) {
-      if (!isAutotaskError(err) || err.code === "ABORTED") throw err;
-      tally.wireUsed += 1;
-      row.wire += 1;
-      if (row.error === null) row.error = { code: err.code, message: err.message };
-      continue;
+  const dayEndAt = (instant) => {
+    const p = wallParts(zone, instant);
+    return localDayEndMs(p.y, p.m, p.d, zone);
+  };
+  let from;
+  let to;
+  switch (kind) {
+    case "today":
+      from = dayStartAt(t);
+      to = dayEndAt(t);
+      break;
+    case "yesterday":
+      from = dayStart(-1);
+      to = dayStart(0) - 1;
+      break;
+    case "last7":
+    case "last14":
+    case "last30":
+    case "last90": {
+      const days = Number(kind.slice(4));
+      from = dayStart(-days);
+      to = dayEndAt(t);
+      break;
     }
-    tally.wireUsed += 1;
-    row.wire += 1;
-    if (kind === "info") {
-      row.info = value ?? null;
-    } else {
-      if (!Array.isArray(value)) {
-        if (row.error === null) row.error = { code: "INVALID_RESPONSE", message: `fieldCatalog: the ${kind} response for ${resource} was not a list` };
-        continue;
-      }
-      projectList(kind, value);
+    case "lastFullWeek":
+    case "lastFullFortnight": {
+      const daysSinceMonday = (weekday + 6) % 7;
+      const daysBack = kind === "lastFullWeek" ? 7 : 14;
+      from = dayStart(-(daysSinceMonday + daysBack));
+      to = dayStart(-daysSinceMonday) - 1;
+      break;
     }
-  }
-  row.cache = allCached ? { hit: true, age: ages.length > 0 ? Math.max(...ages) : 0 } : { hit: false, age: null };
-  const declared = derivedFieldsFor(resource);
-  if (declared.length > 0) {
-    const byField = new Map(declared.map((d) => [d.field, d]));
-    row.derivedFields = declared;
-    for (const field of row.fields ?? []) {
-      const derivation = byField.get(field.name);
-      if (derivation === void 0) continue;
-      field.derived = {
-        rule: derivation.rule,
-        ...derivation.writableRoute !== void 0 ? { writableRoute: derivation.writableRoute } : {}
-      };
+    case "lastFullMonth": {
+      const prev = new Date(Date.UTC(y, m - 2, 1));
+      from = localDayStartMs(prev.getUTCFullYear(), prev.getUTCMonth() + 1, 1, zone);
+      to = localDayStartMs(y, m, 1, zone) - 1;
+      break;
     }
-  }
-  return row;
-}
-async function fieldCatalog(client, opts) {
-  validateCatalogOptsShape(opts);
-  const { fieldOps, udfCapable, resources: allResources } = capabilitySets();
-  const include = resolveInclude(opts);
-  const targets = resolveTargets(opts, fieldOps, allResources);
-  const fieldsFilter = resolveFieldsFilter(opts);
-  const labels = resolveLabels(opts);
-  assertWithinWireCap(targets.length, include.length);
-  const cache = client.http.fieldCache;
-  const zone = client.config.zone ?? "unknown";
-  const rows = [];
-  const tally = { wireUsed: 0, anyPicklistValues: false };
-  const ctx = { client, include, fieldsFilter, labels, fresh: opts?.fresh === true, fieldOps, udfCapable };
-  for (const resource of targets) {
-    const row = await sweepResource(ctx, resource, tally);
-    if (row !== void 0) rows.push(row);
-  }
-  return {
-    zone,
-    label: zone,
-    cached: cache !== void 0,
-    labels,
-    ttlMs: cache?.ttlMs ?? null,
-    fetchedAt: (/* @__PURE__ */ new Date()).toISOString(),
-    rows,
-    wireUsed: tally.wireUsed,
-    cap: MAX_FIELD_CATALOG_WIRE,
-    truncated: false,
-    counts: {
-      resources: targets.length,
-      fieldCapableResources: fieldOps.size,
-      udfCapableResources: udfCapable.size,
-      cached: rows.filter((r) => r.cache.hit === true).length
-    },
-    honesty: {
-      picklistValues: tally.anyPicklistValues ? "partial" : "unexposed",
-      note: FIELD_CATALOG_HONESTY_NOTE
+    case "lastFullQuarter": {
+      const q = Math.floor((m - 1) / 3);
+      const prevQ = q - 1 < 0 ? 3 : q - 1;
+      const prevY = q - 1 < 0 ? y - 1 : y;
+      from = localDayStartMs(prevY, prevQ * 3 + 1, 1, zone);
+      to = localDayStartMs(y, q * 3 + 1, 1, zone) - 1;
+      break;
     }
-  };
+  }
+  return { from: iso(from), to: iso(to) };
 }
-
-// src/operations/compositeNames.ts
-var PICKLIST_VALUE_NOT_SERVED_NOTE = "The picklist is served to this API user, but this record's value is not in it (an inactive or unexposed value) \u2014 the label cannot be resolved and is null; refreshing the field catalog will not surface it. (A picklist the vendor does not expose at all is reported with the field-catalog honesty note instead.)";
-var DEFAULT_MAX_NAME_READS = 20;
-var TICKET_LABEL_FIELDS = ["status", "priority", "ticketType", "issueType", "subIssueType", "source", "queueID"];
-function isVendorId(value) {
-  if (typeof value === "number") return Number.isSafeInteger(value) && value >= 0;
-  if (typeof value === "string") return /^\d+$/.test(value);
-  return false;
+function dateOnlyWindowBounds(kind, now, tz) {
+  if (tz === void 0 || kind === "last24h") return dateWindowBounds(kind, now, tz);
+  const zone = validateZone(tz);
+  const { from, to } = dateWindowBounds(kind, now, zone);
+  const f = wallParts(zone, Date.parse(from));
+  const t = wallParts(zone, Date.parse(to));
+  return { from: iso(Date.UTC(f.y, f.m - 1, f.d)), to: iso(Date.UTC(t.y, t.m - 1, t.d) + DAY_MS - 1) };
 }
-function createNamePlan(labelFields = []) {
-  const resourceIds = [];
-  const resSeen = /* @__PURE__ */ new Set();
-  const recordFks = [];
-  const fkSeen = /* @__PURE__ */ new Set();
-  let lineOfBusinessId;
-  let lineOfBusinessSource;
-  let lineOfBusinessContractId;
-  return {
-    plan: () => ({
-      resourceIds,
-      recordFks,
-      labelFields,
-      ...lineOfBusinessId !== void 0 ? { lineOfBusinessId } : {},
-      ...lineOfBusinessSource !== void 0 ? { lineOfBusinessSource } : {},
-      ...lineOfBusinessContractId !== void 0 ? { lineOfBusinessContractId } : {}
-    }),
-    addResource: (value) => {
-      if (!isVendorId(value)) return;
-      const k = String(value);
-      if (!resSeen.has(k)) {
-        resSeen.add(k);
-        resourceIds.push(value);
-      }
-    },
-    addFk: (table, value) => {
-      if (!isVendorId(value)) return;
-      const k = `${table}:${String(value)}`;
-      if (!fkSeen.has(k)) {
-        fkSeen.add(k);
-        recordFks.push({ table, id: value });
-      }
-    },
-    addLineOfBusinessFromContract: (value) => {
-      if (!isVendorId(value)) return;
-      lineOfBusinessContractId = value;
-    },
-    addLineOfBusiness: (value, origin) => {
-      if (!isVendorId(value)) return;
-      lineOfBusinessId = value;
-      if (origin !== void 0) {
-        lineOfBusinessSource = origin.source;
-        if (origin.contractId !== void 0) lineOfBusinessContractId = origin.contractId;
-      }
-    }
-  };
+async function dateWindowQuery(http, path, field, kind, limit, operation, now, tz) {
+  const zone = tz === void 0 ? void 0 : validateZone(tz, operation);
+  const { from, to } = dateOnlyWindowBounds(kind, now, zone);
+  const filter = [
+    { field, op: "gte", value: from },
+    { field, op: "lte", value: to }
+  ];
+  const res = await http.request({
+    method: "POST",
+    idempotent: true,
+    path,
+    body: { MaxRecords: limit, filter },
+    operation
+  });
+  return unwrapItems(res).items;
 }
-function addNameSibling(row, field, resolve) {
-  const value = row[field];
-  if (value === void 0) return;
-  row[`${field}Name`] = isVendorId(value) ? resolve(value) : null;
+var isoUtc = (ms) => new Date(ms).toISOString().slice(0, 19) + "Z";
+function customRangeDay(value, label, zone, opName) {
+  const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value.trim());
+  if (!m) {
+    throw new AutotaskConfigError(
+      zone === void 0 ? `${opName}: ${label} must be a UTC 'YYYY-MM-DD' date (got ${JSON.stringify(value)})` : `${opName}: ${label} must be a 'YYYY-MM-DD' local calendar day in ${zone} (got ${JSON.stringify(value)})`,
+      { operation: opName }
+    );
+  }
+  const y = Number(m[1]);
+  const mo = Number(m[2]);
+  const d = Number(m[3]);
+  const probe = new Date(Date.UTC(y, mo - 1, d));
+  const real = probe.getUTCFullYear() === y && probe.getUTCMonth() === mo - 1 && probe.getUTCDate() === d;
+  const ms = !real ? NaN : zone === void 0 ? Date.UTC(y, mo - 1, d) : localDayStartMs(y, mo, d, zone);
+  if (!Number.isFinite(ms)) {
+    throw new AutotaskConfigError(
+      zone === void 0 ? `${opName}: ${label} is not a valid UTC date (${JSON.stringify(value)})` : `${opName}: ${label} is not a valid calendar day in ${zone} (${JSON.stringify(value)})`,
+      { operation: opName }
+    );
+  }
+  return { y, mo, d, ms };
 }
-function addLabelSibling(row, field, names) {
-  const value = row[field];
-  if (value === void 0) return;
-  row[`${field}Label`] = names.labelFor(field, value);
+async function customRangeQuery(http, path, field, from, to, limit, operation, zone) {
+  if (zone !== void 0) validateZone(zone, operation);
+  const fromB = customRangeDay(from, "from", void 0, operation);
+  const toB = customRangeDay(to, "to", void 0, operation);
+  if (fromB.ms > toB.ms) {
+    throw new AutotaskConfigError(
+      `${operation}: from (${isoUtc(fromB.ms)}) must not be after to (${isoUtc(toB.ms)})`,
+      { operation }
+    );
+  }
+  const toEndMs = toB.ms + DAY_MS - 1;
+  const filter = [
+    { field, op: "gte", value: isoUtc(fromB.ms) },
+    { field, op: "lte", value: isoUtc(toEndMs) }
+  ];
+  const res = await http.request({
+    method: "POST",
+    idempotent: true,
+    path,
+    body: { MaxRecords: limit, filter },
+    operation
+  });
+  return unwrapItems(res).items;
 }
-var FK_TABLE_PATH = {
-  role: "/V1.0/Roles",
-  billingCode: "/V1.0/BillingCodes",
-  contract: "/V1.0/Contracts"
-};
-var FK_NAME_FIELD = {
-  role: "name",
-  billingCode: "name",
-  contract: "contractName"
-};
-function fkName(record, table) {
-  const value = record[FK_NAME_FIELD[table]];
-  return typeof value === "string" && value.trim() !== "" ? value : null;
+
+// src/resources/special/billing_items.ts
+async function windowQuery(_resource, kind, http, opts) {
+  const now = opts?.now ?? /* @__PURE__ */ new Date();
+  const tz = opts?.tz === void 0 ? void 0 : validateZone(opts.tz, `billing_items.${kind}`);
+  return dateWindowQuery(
+    http,
+    "/V1.0/BillingItems/query",
+    "itemDate",
+    kind,
+    clampWindowLimit(opts?.limit),
+    `billing_items.${kind}`,
+    now,
+    tz
+  );
 }
-function faultRow(err) {
-  const e = err;
-  return e.httpStatus !== void 0 ? { code: e.code, message: e.message, httpStatus: e.httpStatus } : { code: e.code, message: e.message };
+async function customRange(_resource, from, to, http, opts) {
+  const zone = opts?.tz === void 0 ? void 0 : validateZone(opts.tz, "billing_items.customRange");
+  return customRangeQuery(
+    http,
+    "/V1.0/BillingItems/query",
+    "itemDate",
+    from,
+    to,
+    clampWindowLimit(opts?.limit),
+    "billing_items.customRange",
+    zone
+  );
 }
-function vendorId(value) {
-  if (typeof value === "number") return Number.isSafeInteger(value) && value >= 1 ? value : void 0;
-  if (typeof value === "string" && /^[0-9]+$/.test(value.trim())) {
-    const n = Number(value.trim());
-    return Number.isSafeInteger(n) && n >= 1 ? n : void 0;
+
+// src/resources/billing_items.ts
+var BillingItemsResource = class extends BaseResource {
+  constructor(http, pageSize) {
+    super(http, {
+      key: "billing_items",
+      resourcePath: "/V1.0/BillingItems",
+      deletable: false,
+      udfCapable: false,
+      collectionUpdate: true
+      // D1: the spec's item path is GET-only — confirmed updates PUT the collection (id in the body)
+    }, pageSize);
   }
-  return void 0;
-}
-async function resolveLineOfBusinessChain(http, associationId, options) {
-  const operation = options.operation ?? "compositeNames";
-  const degrade = options.onError === "degrade";
-  const get = (path) => {
-    const res = http.request({ method: "GET", path, operation }).then((body) => {
-      const b = body;
-      if (b === null || !("item" in b) || b.item === null || b.item === void 0) return null;
-      return b.item;
-    });
-    if (!degrade) {
-      return res.catch((e) => {
-        if (e instanceof NotFoundError) return null;
-        throw e;
-      });
-    }
-    return res.catch((e) => {
-      if (e instanceof NotFoundError || isAutotaskError(e) && e.code !== "ABORTED") return null;
-      throw e;
-    });
-  };
-  let remaining = options.budget;
-  if (remaining < 1) {
-    return {
-      lineOfBusiness: { association: null, organizationalLevel2: null, organizationalLevel1: null, markers: { association: "capped", organizationalLevel2: "capped", organizationalLevel1: "capped" } },
-      used: 0,
-      truncated: true
-    };
+  /** Query BillingItems records with the G3 filter surface (server-side JSON filter). */
+  query(params) {
+    return this.queryItems(params);
   }
-  remaining -= 1;
-  const association = await get(`/V1.0/OrganizationalLevelAssociations/${associationId}`);
-  const associationMarker = association === null ? "unresolved" : "ok";
-  if (association === null) {
-    return {
-      lineOfBusiness: { association: null, organizationalLevel2: null, organizationalLevel1: null, markers: { association: associationMarker, organizationalLevel2: "missing", organizationalLevel1: "missing" } },
-      used: 1,
-      truncated: false
-    };
+  /** Get every BillingItems record (the MCP-preferred read; 1000-page guarded). */
+  async queryAll(params) {
+    return this.queryAllItems(params);
   }
-  const l2Id = vendorId(association.organizationalLevel2ID);
-  const l1Id = vendorId(association.organizationalLevel1ID);
-  let l2Marker = l2Id !== void 0 ? "unresolved" : "missing";
-  let l1Marker = l1Id !== void 0 ? "unresolved" : "missing";
-  const need = (l2Id !== void 0 ? 1 : 0) + (l1Id !== void 0 ? 1 : 0);
-  let l2 = null;
-  let l1 = null;
-  let used = 1;
-  let truncated = false;
-  if (need > 0 && remaining < need) {
-    truncated = true;
-    if (l2Id !== void 0) l2Marker = "capped";
-    if (l1Id !== void 0) l1Marker = "capped";
-  } else {
-    used += need;
-    const [r2, r1] = await Promise.all([
-      l2Id !== void 0 ? get(`/V1.0/OrganizationalLevel2s/${l2Id}`) : Promise.resolve(null),
-      l1Id !== void 0 ? get(`/V1.0/OrganizationalLevel1s/${l1Id}`) : Promise.resolve(null)
-    ]);
-    l2 = r2;
-    l1 = r1;
-    if (l2Id !== void 0) l2Marker = l2 === null ? "unresolved" : "ok";
-    if (l1Id !== void 0) l1Marker = l1 === null ? "unresolved" : "ok";
+  /** Count matching records (queryCount envelope unwrapped to a plain number). */
+  async count(params) {
+    return this.countGlobal(params);
   }
-  return {
-    lineOfBusiness: { association, organizationalLevel2: l2, organizationalLevel1: l1, markers: { association: associationMarker, organizationalLevel2: l2Marker, organizationalLevel1: l1Marker } },
-    used,
-    truncated
-  };
-}
-async function resolveCompositeNames(http, plan, opts = {}) {
-  if (opts.maxNameReads !== void 0 && (!Number.isInteger(opts.maxNameReads) || opts.maxNameReads < 1)) {
-    throw new AutotaskConfigError(`composite names: maxNameReads must be an integer >= 1 (got ${String(opts.maxNameReads)})`);
+  /** 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, opts?.fresh === true);
   }
-  const budget = Math.min(DEFAULT_MAX_NAME_READS, opts.maxNameReads ?? DEFAULT_MAX_NAME_READS);
-  const client = http.client;
-  if (client === void 0) {
-    throw new AutotaskConfigError("composite names: the transport is not wired to an AutotaskClient (the composite must run through the client)");
+  /** 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
+   * partial body is merged into the CURRENT record first: one fresh GET (which also serves the
+   * stale-object guard's read) then the collection PUT of the merged model — an explicit null in the
+   * caller body sends null; an omitted field keeps the current value. `raw: true` in the opts bag sends
+   * the body as-is (full model or intentional partial — the compatibility escape hatch; no merge read).
+   * `dryRun: true` returns the pinned envelope whose `data` is the merged body (the exact confirmed
+   * wire) with the best-effort diff, from that same single read; a caller-supplied lastModifiedDate that
+   * mismatches the vendor's current value throws STALE_OBJECT before the mutation. */
+  async update(id, data, opts = {}) {
+    if (opts.dryRun === true) return this.runUpdateDryRun(id, data, opts);
+    return this.updateGlobal(id, data, opts);
   }
-  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;
-    coldResource.push(id);
+  /** Resolve a BillingItems from a numeric id (or, where the vendor indexes a primary text field,
+   * from a numeric id — this resource has no primary text field). A numeric id miss throws NOT_FOUND;
+   * a bare value rejects with a config error (ids only);
+   * non-match returns null; ambiguity throws RESOLUTION_AMBIGUOUS (candidate ids) and a
+   * cap-tripped bounded client scan throws RESOLUTION_TRUNCATED (never a silent null).
+   * The compact shape is the structural alias of the full record; `expand: true` is the
+   * type-level escape hatch. */
+  async resolve(identifier, opts = {}) {
+    void opts;
+    return this.resolveBase(identifier);
   }
-  const withinBudget = coldResource.slice(0, remaining);
-  const overBudgetResource = coldResource.slice(remaining);
-  remaining -= withinBudget.length;
-  for (const id of overBudgetResource) {
-    section.rows[`resource:${id}`] = { name: null, blind: false, capped: true };
-    section.truncated = true;
+  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
+  customRange(from, to, opts) {
+    return customRange(this, from, to, this.http, opts);
   }
-  const overSet = new Set(overBudgetResource.map((id) => String(id)));
-  const opIds = plan.resourceIds.filter((id) => !overSet.has(String(id)));
-  if (opIds.length > 0) {
-    let pass = opIds;
-    if (pass.length > 500) {
-      for (const id of pass.slice(500)) {
-        section.rows[`resource:${id}`] = { name: null, blind: false, capped: true };
-        section.truncated = true;
-      }
-      pass = pass.slice(0, 500);
-    }
-    const res = await expandResourceNames(client, pass);
-    for (const r of res.results) {
-      const row = { name: r.name, blind: r.blind, capped: false };
-      if (r.error !== void 0) row.error = faultRow(r.error);
-      section.rows[`resource:${r.id}`] = row;
-    }
+  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
+  last14(opts) {
+    return windowQuery(this, "last14", this.http, opts);
   }
-  const holders = {
-    role: client.roles,
-    billingCode: client.billingCodes,
-    contract: client.contracts
-  };
-  for (const fk of plan.recordFks) {
-    const key = `${fk.table}:${fk.id}`;
-    const cold = readCache === void 0 || readCache.get(`${FK_TABLE_PATH[fk.table]}/${fk.id}`) === void 0;
-    if (cold) {
-      if (remaining < 1) {
-        section.rows[key] = { name: null, blind: false, capped: true };
-        section.truncated = true;
-        if (fk.table === "contract" && plan.lineOfBusinessContractId !== void 0 && String(fk.id) === String(plan.lineOfBusinessContractId)) {
-          contractLobUnread = "capped";
-        }
-        continue;
-      }
-      remaining -= 1;
-    }
-    try {
-      const record = await holders[fk.table].get(fk.id);
-      if (fk.table === "contract" && plan.lineOfBusinessId === void 0 && plan.lineOfBusinessContractId !== void 0 && String(fk.id) === String(plan.lineOfBusinessContractId)) {
-        contractLobPointer = vendorId(record["organizationalLevelAssociationID"]);
-      }
-      section.rows[key] = { name: fkName(record, fk.table), blind: false, capped: false };
-    } catch (err) {
-      if (err instanceof NotFoundError) {
-        section.rows[key] = { name: null, blind: true, capped: false };
-      } else if (isAutotaskError(err) && err.code !== "ABORTED") {
-        section.rows[key] = { name: null, blind: false, capped: false, error: faultRow(err) };
-        if (fk.table === "contract" && plan.lineOfBusinessContractId !== void 0 && String(fk.id) === String(plan.lineOfBusinessContractId)) {
-          contractLobUnread = "unresolved";
-        }
-      } else {
-        throw err;
-      }
-    }
+  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
+  last24h(opts) {
+    return windowQuery(this, "last24h", this.http, opts);
   }
-  const picklists = {};
-  if (plan.labelFields.length > 0) {
-    let usable = true;
-    try {
-      const catalog = await fieldCatalog(client, { resources: ["tickets"], labels: true, fields: [...plan.labelFields] });
-      const row = catalog.rows.find((r) => r.resource === "tickets");
-      if (row === void 0 || row.error !== null || row.fields === void 0) {
-        usable = false;
-      } else {
-        for (const f of plan.labelFields) {
-          const frow = row.fields.find((x) => x.name === f);
-          picklists[f] = frow?.picklistValues;
-        }
-      }
-    } catch (err) {
-      if (isAutotaskError(err) && err.code !== "ABORTED") usable = false;
-      else throw err;
-    }
-    if (!usable) for (const f of plan.labelFields) section.reasons[f] = FIELD_CATALOG_HONESTY_NOTE;
+  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
+  last30(opts) {
+    return windowQuery(this, "last30", this.http, opts);
   }
-  let lineOfBusiness2 = null;
-  const lobId = plan.lineOfBusinessId ?? contractLobPointer;
-  if (lobId !== void 0) {
-    const chain = await resolveLineOfBusinessChain(http, lobId, { budget: remaining, onError: "degrade" });
-    remaining -= chain.used;
-    if (chain.truncated) section.truncated = true;
-    const fromContract = plan.lineOfBusinessId === void 0;
-    lineOfBusiness2 = {
-      ...chain.lineOfBusiness,
-      ...fromContract ? { source: "contract", contractId: plan.lineOfBusinessContractId } : plan.lineOfBusinessSource !== void 0 ? { source: plan.lineOfBusinessSource } : {},
-      ...!fromContract && plan.lineOfBusinessContractId !== void 0 ? { contractId: plan.lineOfBusinessContractId } : {}
-    };
-  } else if (contractLobUnread !== void 0 && plan.lineOfBusinessContractId !== void 0) {
-    lineOfBusiness2 = {
-      source: "contract",
-      contractId: plan.lineOfBusinessContractId,
-      association: null,
-      organizationalLevel2: null,
-      organizationalLevel1: null,
-      markers: { association: contractLobUnread, organizationalLevel2: "missing", organizationalLevel1: "missing" }
-    };
+  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
+  last7(opts) {
+    return windowQuery(this, "last7", this.http, opts);
+  }
+  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
+  last90(opts) {
+    return windowQuery(this, "last90", this.http, opts);
+  }
+  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
+  lastFullFortnight(opts) {
+    return windowQuery(this, "lastFullFortnight", this.http, opts);
+  }
+  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
+  lastFullMonth(opts) {
+    return windowQuery(this, "lastFullMonth", this.http, opts);
+  }
+  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
+  lastFullQuarter(opts) {
+    return windowQuery(this, "lastFullQuarter", this.http, opts);
+  }
+  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
+  lastFullWeek(opts) {
+    return windowQuery(this, "lastFullWeek", this.http, opts);
+  }
+  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
+  today(opts) {
+    return windowQuery(this, "today", this.http, opts);
   }
-  return {
-    section,
-    lineOfBusiness: lineOfBusiness2,
-    resourceName: (id) => section.rows[`resource:${id}`]?.name ?? null,
-    recordName: (table, id) => section.rows[`${table}:${id}`]?.name ?? null,
-    labelFor: (field, value) => {
-      if (value === null || value === void 0) return null;
-      const values = picklists[field];
-      if (values === void 0) {
-        section.reasons[field] = FIELD_CATALOG_HONESTY_NOTE;
-        return null;
-      }
-      const hit = values.find((v) => String(v.value) === String(value));
-      if (hit === void 0) {
-        section.reasons[field] = PICKLIST_VALUE_NOT_SERVED_NOTE;
-        return null;
-      }
-      return typeof hit.label === "string" ? hit.label : null;
-    }
-  };
-}
+  /** Node-parity special op (hand-written in src/resources/special/billing_items.ts). */
+  yesterday(opts) {
+    return windowQuery(this, "yesterday", this.http, opts);
+  }
+};
 
 // src/resources/special/_shared/dates.ts
 var DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
@@ -20888,22 +21395,6 @@ function num(v) {
   return typeof v === "number" && Number.isFinite(v) ? v : 0;
 }
 
-// src/resources/special/_shared/bounded-part.ts
-async function boundedPart(http, path, conditions, limit, operation, includeFields) {
-  const body = { MaxRecords: limit, filter: conditions };
-  if (includeFields !== void 0) body.IncludeFields = includeFields;
-  const res = await http.request({
-    method: "POST",
-    idempotent: true,
-    path,
-    body,
-    operation
-  });
-  const { items, pageDetails } = unwrapItems(res, operation);
-  const capped = items.length >= limit;
-  return { items, capped, hasMore: capped && pageDetails.nextPageUrl != null };
-}
-
 // src/resources/special/companies/shared.ts
 var DEFAULT_LIMIT2 = 25;
 var MAX_LIMIT2 = 500;
@@ -21252,199 +21743,9 @@ async function upsertByName(resource, companyName, params, opts, http) {
   return createWithDiscovery(resource, body, owner, caveat, opts);
 }
 
-// src/field-sets.ts
-var MODEL_FIELD_SETS = {
-  "appointments": ["id", "createDateTime", "creatorResourceID", "description", "endDateTime", "resourceID", "startDateTime", "title", "updateDateTime"],
-  "billing_codes": ["id", "afterHoursWorkType", "billingCodeType", "department", "description", "externalNumber", "generalLedgerAccount", "isActive", "isExcludedFromNewContracts", "markupRate", "name", "taxCategoryID", "unitCost", "unitPrice", "useType"],
-  "billing_item_approval_levels": ["id", "approvalDateTime", "approvalLevel", "approvalResourceID", "timeEntryID"],
-  "billing_items": ["id", "accountManagerWhenApprovedID", "billingCodeID", "billingItemType", "companyID", "configurationItemID", "contractBlockID", "contractChargeID", "contractID", "contractServiceAdjustmentID", "contractServiceBundleAdjustmentID", "contractServiceBundleID", "contractServiceBundlePeriodID", "contractServiceID", "contractServicePeriodID", "description", "expenseItemID", "extendedPrice", "internalCurrencyExtendedPrice", "internalCurrencyRate", "internalCurrencyTaxDollars", "internalCurrencyTotalAmount", "invoiceID", "itemApproverID", "itemDate", "itemName", "lineItemFullDescription", "lineItemGroupDescription", "milestoneID", "nonBillable", "organizationalLevelAssociationID", "ourCost", "postedDate", "postedOnTime", "projectChargeID", "projectID", "purchaseOrderNumber", "quantity", "rate", "roleID", "serviceBundleID", "serviceID", "sortOrderID", "subType", "taskID", "taxDollars", "ticketChargeID", "ticketID", "timeEntryID", "totalAmount", "vendorID", "webServiceDate"],
-  "change_request_links": ["id", "changeRequestTicketID", "problemOrIncidentTicketID"],
-  "checklist_libraries": ["id", "description", "entityType", "isActive", "name"],
-  "checklist_library_checklist_items": ["id", "checklistLibraryID", "isImportant", "itemName", "knowledgebaseArticleID", "position", "soapParentPropertyId"],
-  "classification_icons": ["id", "description", "isActive", "isSystem", "name", "relativeUrl"],
-  "companies": ["id", "additionalAddressInformation", "address1", "address2", "alternatePhone1", "alternatePhone2", "apiVendorID", "assetValue", "billToCompanyLocationID", "billToAdditionalAddressInformation", "billingAddress1", "billingAddress2", "billToAddressToUse", "billToAttention", "billToCity", "billToCountryID", "billToState", "billToZipCode", "city", "classification", "companyCategoryID", "companyName", "companyNumber", "companyType", "competitorID", "countryID", "createDate", "createdByResourceID", "currencyID", "fax", "impersonatorCreatorResourceID", "invoiceEmailMessageID", "invoiceMethod", "invoiceNonContractItemsToParentCompany", "invoiceTemplateID", "isActive", "isClientPortalActive", "isEnabledForComanaged", "isSample", "isTaskFireActive", "isTaxExempt", "lastActivityDate", "lastTrackedModifiedDateTime", "marketSegmentID", "ownerResourceID", "parentCompanyID", "phone", "postalCode", "purchaseOrderTemplateID", "quoteEmailMessageID", "quoteTemplateID", "sicCode", "state", "stockMarket", "stockSymbol", "surveyCompanyRating", "taxID", "taxRegionID", "territoryID", "webAddress", "userDefinedFields"],
-  "company_alerts": ["id", "alertText", "alertTypeID", "companyID", "soapParentPropertyId"],
-  "company_locations": ["id", "address1", "address2", "alternatePhone1", "alternatePhone2", "city", "companyID", "countryID", "description", "fax", "isActive", "isPrimary", "isTaxExempt", "overrideCompanyTaxSettings", "name", "phone", "postalCode", "roundtripDistance", "state", "taxRegionID", "soapParentPropertyId"],
-  "company_notes": ["id", "actionType", "assignedResourceID", "companyID", "completedDateTime", "contactID", "createDateTime", "endDateTime", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "lastModifiedDate", "name", "note", "opportunityID", "startDateTime", "soapParentPropertyId"],
-  "company_site_configurations": ["id", "companyID", "locationName", "soapParentPropertyId", "userDefinedFields"],
-  "company_webhooks": ["id", "deactivationUrl", "isActive", "isReady", "isSubscribedToCreateEvents", "isSubscribedToDeleteEvents", "isSubscribedToUpdateEvents", "name", "notificationEmailAddress", "ownerResourceID", "secretKey", "sendThresholdExceededNotification", "webhookGUID", "webhookUrl"],
-  "configuration_item_billing_product_associations": ["id", "billingProductID", "configurationItemID", "effectiveDate", "expirationDate", "soapParentPropertyId"],
-  "configuration_item_categories": ["id", "displayColorRGB", "isActive", "isClientPortalDefault", "isGlobalDefault", "name", "nickname"],
-  "configuration_item_category_udf_associations": ["id", "configurationItemCategoryID", "isRequired", "userDefinedFieldDefinitionID", "soapParentPropertyId"],
-  "configuration_item_dns_records": ["id", "createDateTime", "data", "installedProductID", "timeToLiveSeconds", "dnsType", "soapParentPropertyId"],
-  "configuration_item_notes": ["id", "configurationItemID", "createDateTime", "creatorResourceID", "description", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "lastActivityDate", "noteType", "title", "soapParentPropertyId"],
-  "configuration_item_related_items": ["id", "configurationItemID", "relatedConfigurationItemID", "relationship", "soapParentPropertyId"],
-  "configuration_item_ssl_subject_alternative_names": ["id", "configurationItemID", "name", "soapParentPropertyId"],
-  "configuration_item_types": ["id", "isActive", "name"],
-  "configuration_item_webhooks": ["id", "deactivationUrl", "isActive", "isReady", "isSubscribedToCreateEvents", "isSubscribedToDeleteEvents", "isSubscribedToUpdateEvents", "name", "notificationEmailAddress", "ownerResourceID", "secretKey", "sendThresholdExceededNotification", "webhookGUID", "webhookUrl"],
-  "configuration_items": ["id", "apiVendorID", "configurationItemCategoryID", "companyID", "companyLocationID", "configurationItemType", "contactID", "contractID", "contractServiceBundleID", "contractServiceID", "createDate", "createdByPersonID", "dailyCost", "dattoAvailableKilobytes", "dattoDeviceMemoryMegabytes", "dattoDrivesErrors", "dattoHostname", "dattoInternalIP", "dattoKernelVersionID", "dattoLastCheckInDateTime", "dattoNICSpeedKilobitsPerSecond", "dattoNumberOfAgents", "dattoNumberOfDrives", "dattoNumberOfVolumes", "dattoOffsiteUsedBytes", "dattoOSVersionID", "dattoPercentageUsed", "dattoProtectedKilobytes", "dattoRemoteIP", "dattoSerialNumber", "dattoUptimeSeconds", "dattoUsedKilobytes", "dattoZFSVersionID", "deviceNetworkingID", "domain", "domainRegistrarID", "domainRegistrationDateTime", "domainLastUpdatedDateTime", "domainExpirationDateTime", "hourlyCost", "impersonatorCreatorResourceID", "installDate", "installedByContactID", "installedByID", "isActive", "lastActivityPersonID", "lastActivityPersonType", "lastModifiedTime", "location", "monthlyCost", "notes", "numberOfUsers", "parentConfigurationItemID", "perUseCost", "productID", "referenceNumber", "referenceTitle", "rmmDeviceAuditAntivirusStatusID", "rmmDeviceAuditArchitectureID", "rmmDeviceAuditBackupStatusID", "rmmDeviceAuditDescription", "rmmDeviceAuditDeviceTypeID", "rmmDeviceAuditDisplayAdaptorID", "rmmDeviceAuditDomainID", "rmmDeviceAuditExternalIPAddress", "rmmDeviceAuditHostname", "rmmDeviceAuditIPAddress", "rmmDeviceAuditLastUser", "rmmDeviceAuditMacAddress", "rmmDeviceAuditManufacturerID", "rmmDeviceAuditFirmwareID", "rmmDeviceAuditMemoryBytes", "rmmDeviceAuditMissingPatchCount", "rmmDeviceAuditMobileNetworkOperatorID", "rmmDeviceAuditMobileNumber", "rmmDeviceAuditModelID", "rmmDeviceAuditMotherboardID", "rmmDeviceAuditOperatingSystem", "rmmDeviceAuditPatchStatusID", "rmmDeviceAuditProcessorID", "rmmDeviceAuditServicePackID", "rmmDeviceAuditSNMPContact", "rmmDeviceAuditSNMPLocation", "rmmDeviceAuditSNMPName", "rmmDeviceAuditSoftwareStatusID", "rmmDeviceAuditStorageBytes", "rmmDeviceID", "rmmDeviceUID", "rmmVsaxDeviceID", "rmmOpenAlertCount", "serialNumber", "serviceBundleID", "serviceID", "serviceLevelAgreementID", "setupFee", "sourceChargeID", "sourceChargeType", "sslSource", "sslCommonName", "sslValidFromDateTime", "sslValidUntilDateTime", "sslIssuedBy", "sslOrganization", "sslOrganizationUnit", "sslLocation", "sslSerialNumber", "sslSignatureAlgorithm", "vendorID", "warrantyExpirationDate", "rmmIsInMaintenanceMode", "rmmIsMobileDeviceManagementEnrolled", "rmmDeviceUrl", "userDefinedFields"],
-  "contact_group_contacts": ["id", "contactId", "contactGroupId", "soapParentPropertyId"],
-  "contact_groups": ["id", "name", "isActive"],
-  "contact_webhooks": ["id", "deactivationUrl", "isActive", "isReady", "isSubscribedToCreateEvents", "isSubscribedToDeleteEvents", "isSubscribedToUpdateEvents", "name", "notificationEmailAddress", "ownerResourceID", "secretKey", "sendThresholdExceededNotification", "webhookGUID", "webhookUrl"],
-  "contacts": ["id", "additionalAddressInformation", "addressLine", "addressLine1", "alternatePhone", "apiVendorID", "bulkEmailOptOutTime", "city", "companyID", "companyLocationID", "countryID", "createDate", "emailAddress", "emailAddress2", "emailAddress3", "extension", "externalID", "facebookUrl", "faxNumber", "firstName", "impersonatorCreatorResourceID", "isActive", "isOptedOutFromBulkEmail", "lastActivityDate", "lastModifiedDate", "lastName", "linkedInUrl", "middleInitial", "mobilePhone", "namePrefix", "nameSuffix", "note", "receivesEmailNotifications", "phone", "primaryContact", "roomNumber", "solicitationOptOut", "solicitationOptOutTime", "state", "surveyOptOut", "title", "twitterUrl", "zipCode", "soapParentPropertyId", "userDefinedFields"],
-  "contract_billing_rules": ["id", "contractID", "createChargesAsBillable", "dailyProratedCost", "dailyProratedPrice", "determineUnits", "endDate", "executionMethod", "includeItemsInChargeDescription", "invoiceDescription", "isActive", "isDailyProrationEnabled", "maximumUnits", "minimumUnits", "productID", "startDate", "soapParentPropertyId"],
-  "contract_block_hour_factors": ["id", "blockHourMultiplier", "contractHourlyRate", "contractID", "internalCurrencyContractHourlyRate", "roleID", "soapParentPropertyId"],
-  "contract_blocks": ["id", "contractID", "datePurchased", "endDate", "hourlyRate", "hours", "hoursApproved", "invoiceNumber", "isPaid", "paymentNumber", "paymentType", "startDate", "status", "soapParentPropertyId"],
-  "contract_charges": ["id", "billableAmount", "billingCodeID", "chargeType", "contractID", "contractServiceBundleID", "contractServiceID", "createDate", "creatorResourceID", "datePurchased", "description", "extendedCost", "internalCurrencyBillableAmount", "internalCurrencyUnitPrice", "internalPurchaseOrderNumber", "isBillableToCompany", "isBilled", "name", "notes", "organizationalLevelAssociationID", "productID", "purchaseOrderNumber", "status", "statusLastModifiedBy", "statusLastModifiedDate", "unitCost", "unitPrice", "unitQuantity", "soapParentPropertyId"],
-  "contract_exclusion_billing_codes": ["id", "billingCodeID", "contractID", "soapParentPropertyId"],
-  "contract_exclusion_roles": ["id", "contractID", "roleID", "soapParentPropertyId"],
-  "contract_exclusion_set_excluded_roles": ["id", "contractExclusionSetID", "excludedRoleID", "soapParentPropertyId"],
-  "contract_exclusion_set_excluded_work_types": ["id", "contractExclusionSetID", "excludedWorkTypeID", "soapParentPropertyId"],
-  "contract_exclusion_sets": ["id", "description", "isActive", "name"],
-  "contract_milestones": ["id", "amount", "billingCodeID", "contractID", "createDate", "creatorResourceID", "dateDue", "description", "internalCurrencyAmount", "isInitialPayment", "organizationalLevelAssociationID", "status", "title", "soapParentPropertyId"],
-  "contract_notes": ["id", "contractID", "createDateTime", "creatorResourceID", "description", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "lastActivityDate", "title", "soapParentPropertyId"],
-  "contract_rates": ["id", "contractHourlyRate", "contractID", "internalCurrencyContractHourlyRate", "roleID", "soapParentPropertyId"],
-  "contract_retainers": ["id", "amount", "amountApproved", "contractID", "datePurchased", "endDate", "internalCurrencyAmount", "internalCurrencyAmountApproved", "invoiceNumber", "isPaid", "paymentID", "paymentNumber", "startDate", "status", "soapParentPropertyId"],
-  "contract_role_costs": ["id", "contractID", "rate", "resourceID", "roleID", "soapParentPropertyId"],
-  "contract_service_bundle_units": ["id", "approveAndPostDate", "contractID", "contractServiceBundleID", "cost", "endDate", "internalCurrencyPrice", "organizationalLevelAssociationID", "price", "serviceBundleID", "startDate", "units", "soapParentPropertyId"],
-  "contract_service_bundles": ["id", "adjustedPrice", "contractID", "internalCurrencyAdjustedPrice", "internalCurrencyUnitPrice", "internalDescription", "invoiceDescription", "quoteItemID", "serviceBundleID", "unitPrice", "soapParentPropertyId"],
-  "contract_service_units": ["id", "approveAndPostDate", "contractID", "contractServiceID", "cost", "endDate", "internalCurrencyPrice", "organizationalLevelAssociationID", "price", "serviceID", "startDate", "units", "vendorCompanyID", "soapParentPropertyId"],
-  "contract_services": ["id", "contractID", "internalCurrencyAdjustedPrice", "internalCurrencyUnitPrice", "internalDescription", "invoiceDescription", "quoteItemID", "serviceID", "unitCost", "unitPrice", "soapParentPropertyId"],
-  "contract_ticket_purchases": ["id", "contractID", "datePurchased", "endDate", "invoiceNumber", "isPaid", "paymentNumber", "paymentType", "perTicketRate", "startDate", "status", "ticketsPurchased", "ticketsUsed", "soapParentPropertyId"],
-  "contracts": ["id", "billingPreference", "billToCompanyContactID", "billToCompanyID", "companyID", "contactID", "contactName", "contractCategory", "contractExclusionSetID", "contractName", "contractNumber", "contractPeriodType", "contractType", "description", "endDate", "estimatedCost", "estimatedHours", "estimatedRevenue", "exclusionContractID", "internalCurrencyOverageBillingRate", "internalCurrencySetupFee", "isCompliant", "isDefaultContract", "lastModifiedDateTime", "opportunityID", "organizationalLevelAssociationID", "overageBillingRate", "purchaseOrderNumber", "renewedContractID", "serviceLevelAgreementID", "setupFee", "setupFeeBillingCodeID", "startDate", "status", "timeReportingRequiresStartAndStopTimes", "userDefinedFields"],
-  "countries": ["id", "addressFormatID", "countryCode", "displayName", "invoiceTemplateID", "isActive", "isDefaultCountry", "name", "purchaseOrderTemplateID", "quoteTemplateID"],
-  "currencies": ["id", "currencyNegativeFormat", "currencyPositiveFormat", "description", "displaySymbol", "exchangeRate", "isActive", "isInternalCurrency", "lastModifiedDateTime", "name", "updateResourceId"],
-  "departments": ["id", "description", "name", "number", "primaryLocationID"],
-  "domain_registrars": ["id", "name", "url"],
-  "expense_item_attachments": ["id", "attachDate", "attachedByContactID", "attachedByResourceID", "attachmentType", "contentType", "creatorType", "expenseItemID", "expenseReportID", "fileSize", "fullPath", "impersonatorCreatorResourceID", "opportunityID", "parentID", "publish", "title", "data", "parentType", "soapParentPropertyId", "isTaskAttachment"],
-  "expense_items": ["id", "companyID", "description", "destination", "entertainmentLocation", "expenseCategory", "expenseCurrencyExpenseAmount", "expenseCurrencyID", "expenseDate", "expenseReportID", "glCode", "haveReceipt", "internalCurrencyExpenseAmount", "internalCurrencyReimbursementAmount", "isBillableToCompany", "isReimbursable", "isRejected", "miles", "odometerEnd", "odometerStart", "origin", "paymentType", "projectID", "purchaseOrderNumber", "reimbursementCurrencyReimbursementAmount", "taskID", "ticketID", "workType", "soapParentPropertyId"],
-  "expense_reports": ["id", "amountDue", "approvedDate", "approverID", "departmentNumber", "internalCurrencyCashAdvanceAmount", "internalCurrencyExpenseTotal", "name", "organizationalLevelAssociationID", "quickBooksReferenceNumber", "reimbursementCurrencyAmountDue", "reimbursementCurrencyCashAdvanceAmount", "reimbursementCurrencyID", "rejectionReason", "status", "submit", "submitDate", "submitterID", "weekEnding"],
-  "holiday_sets": ["id", "holidaySetDescription", "holidaySetName"],
-  "holidays": ["id", "holidayDate", "holidayName", "holidaySetID", "soapParentPropertyId"],
-  "inventory_products": ["id", "availableUnits", "backOrderQuantity", "bin", "createDateTime", "createdByResourceID", "inventoryLocationID", "onHandUnits", "pickedUnits", "productID", "quantityMaximum", "quantityMinimum", "referenceNumber", "reservedUnits", "unitsOnOrder"],
-  "invoice_templates": ["id", "coveredByBlockRetainerContractLabel", "coveredByRecurringServiceFixedPricePerTicketContractLabel", "currencyNegativeFormat", "currencyPositiveFormat", "dateFormat", "displayFixedPriceContractLabor", "displayRecurringServiceContractLabor", "displaySeparateLineItemForEachTax", "displayTaxCategory", "displayTaxCategorySuperscripts", "displayZeroAmountRecurringServicesAndBundles", "groupBy", "itemizeItemsInEachGroup", "itemizeServicesAndBundles", "name", "nonBillableLaborLabel", "numberFormat", "pageLayout", "pageNumberFormat", "paymentTerms", "rateCostExpression", "showGridHeader", "showVerticalGridLines", "sortBy", "timeFormat"],
-  "invoices": ["id", "batchID", "comments", "companyID", "createDateTime", "creatorResourceID", "dueDate", "fromDate", "invoiceDateTime", "invoiceEditorTemplateID", "invoiceNumber", "invoiceTotal", "isVoided", "orderNumber", "paidDate", "paymentTerm", "taxGroup", "taxRegionName", "toDate", "totalTaxValue", "voidedByResourceID", "voidedDate", "webServiceDate"],
-  "notification_history": ["id", "companyID", "entityNumber", "entityTitle", "initiatingContactID", "initiatingResourceID", "isActive", "isDeleted", "isTemplateJob", "notificationHistoryTypeID", "notificationSentTime", "opportunityID", "projectID", "quoteID", "recipientDisplayName", "recipientEmailAddress", "taskID", "templateName", "ticketID", "timeEntryID"],
-  "opportunities": ["id", "advancedField1", "advancedField2", "advancedField3", "advancedField4", "advancedField5", "amount", "assessmentScore", "barriers", "closedDate", "companyID", "contactID", "cost", "createDate", "creatorResourceID", "description", "helpNeeded", "impersonatorCreatorResourceID", "lastActivity", "leadSource", "lossReason", "lossReasonDetail", "lostDate", "market", "monthlyCost", "monthlyRevenue", "nextStep", "onetimeCost", "onetimeRevenue", "opportunityCategoryID", "organizationalLevelAssociationID", "ownerResourceID", "primaryCompetitor", "probability", "productID", "projectedCloseDate", "promisedFulfillmentDate", "promotionName", "quarterlyCost", "quarterlyRevenue", "rating", "relationshipAssessmentScore", "revenueSpread", "revenueSpreadUnit", "salesOrderID", "salesProcessPercentComplete", "semiannualCost", "semiannualRevenue", "stage", "startDate", "status", "technicalAssessmentScore", "throughDate", "title", "totalAmountMonths", "useQuoteTotals", "winReason", "winReasonDetail", "yearlyCost", "yearlyRevenue", "userDefinedFields"],
-  "opportunity_attachments": ["id", "attachDate", "attachedByContactID", "attachedByResourceID", "attachmentType", "contentType", "creatorType", "fileSize", "fullPath", "impersonatorCreatorResourceID", "opportunityID", "parentAttachmentID", "parentID", "publish", "title", "data", "parentType", "soapParentPropertyId", "isTaskAttachment"],
-  "opportunity_categories": ["id", "displayColorRGB", "isActive", "isGlobalDefault", "name", "nickname"],
-  "organizational_level1s": ["id", "description", "isActive", "name"],
-  "organizational_level2s": ["id", "description", "isActive", "name"],
-  "organizational_level_associations": ["id", "isActive", "organizationalLevel1ID", "organizationalLevel2ID"],
-  "phases": ["id", "createDate", "creatorResourceID", "description", "dueDate", "estimatedHours", "externalID", "isScheduled", "lastActivityDateTime", "parentPhaseID", "phaseNumber", "projectID", "startDate", "title", "soapParentPropertyId"],
-  "product_vendors": ["id", "isActive", "isDefault", "productID", "vendorCost", "vendorID", "vendorPartNumber", "soapParentPropertyId"],
-  "products": ["id", "billingType", "chargeBillingCodeID", "createdByResourceID", "createdTime", "defaultVendorID", "description", "doesNotRequireProcurement", "externalProductID", "impersonatorCreatorResourceID", "internalProductID", "isActive", "isEligibleForRma", "isSerialized", "link", "manufacturerName", "manufacturerProductName", "markupRate", "msrp", "name", "periodType", "priceCostMethod", "productBillingCodeID", "productCategory", "sku", "unitCost", "unitPrice", "vendorProductNumber", "defaultInstalledProductCategoryID", "userDefinedFields"],
-  "project_charges": ["id", "billableAmount", "billingCodeID", "chargeType", "contractServiceBundleID", "contractServiceID", "createDate", "creatorResourceID", "datePurchased", "description", "estimatedCost", "extendedCost", "internalCurrencyBillableAmount", "internalCurrencyUnitPrice", "internalPurchaseOrderNumber", "isBillableToCompany", "isBilled", "name", "notes", "organizationalLevelAssociationID", "productID", "projectID", "purchaseOrderNumber", "status", "statusLastModifiedBy", "statusLastModifiedDate", "unitCost", "unitPrice", "unitQuantity", "soapParentPropertyId"],
-  "project_notes": ["id", "createDateTime", "createdByContactID", "creatorResourceID", "description", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "isAnnouncement", "lastActivityDate", "noteType", "projectID", "publish", "title", "soapParentPropertyId"],
-  "projects": ["id", "actualBilledHours", "actualHours", "changeOrdersBudget", "changeOrdersRevenue", "companyID", "companyOwnerResourceID", "completedDateTime", "completedPercentage", "contractID", "createDateTime", "creatorResourceID", "department", "description", "duration", "endDateTime", "estimatedSalesCost", "estimatedTime", "extProjectNumber", "extProjectType", "impersonatorCreatorResourceID", "laborEstimatedCosts", "laborEstimatedMarginPercentage", "laborEstimatedRevenue", "lastActivityDateTime", "lastActivityPersonType", "lastActivityResourceID", "opportunityID", "organizationalLevelAssociationID", "originalEstimatedRevenue", "projectCostEstimatedMarginPercentage", "projectCostsBudget", "projectCostsRevenue", "projectLeadResourceID", "projectName", "projectNumber", "projectType", "purchaseOrderNumber", "sgda", "startDateTime", "status", "statusDateTime", "statusDetail", "userDefinedFields"],
-  "purchase_approvals": ["id", "costType", "isApproved", "rejectNote"],
-  "purchase_order_item_receiving": ["id", "purchaseOrderItemID", "quantityBackOrdered", "quantityNowReceiving", "quantityPreviouslyReceived", "receiveDate", "receivedByResourceID", "serialNumber", "vendorInvoiceNumber", "soapParentPropertyId"],
-  "purchase_order_items": ["id", "chargeID", "contractID", "estimatedArrivalDate", "internalCurrencyUnitCost", "inventoryLocationID", "memo", "orderID", "productID", "projectID", "quantity", "salesOrderID", "ticketID", "unitCost", "soapParentPropertyId"],
-  "purchase_orders": ["id", "cancelDateTime", "createDateTime", "creatorResourceID", "externalPONumber", "fax", "freight", "generalMemo", "impersonatorCreatorResourceID", "internalCurrencyFreight", "latestEstimatedArrivalDate", "paymentTerm", "phone", "purchaseForCompanyID", "purchaseOrderNumber", "purchaseOrderTemplateID", "shippingDate", "shippingType", "shipToAddress1", "shipToAddress2", "shipToCity", "shipToName", "shipToPostalCode", "shipToState", "showEachTaxInGroup", "showTaxCategory", "status", "submitDateTime", "taxRegionID", "useItemDescriptionsFrom", "vendorID", "vendorInvoiceNumber", "additionalVendorInvoiceNumbers"],
-  "quote_items": ["id", "averageCost", "chargeID", "description", "expenseID", "highestCost", "internalCurrencyLineDiscount", "internalCurrencyUnitDiscount", "internalCurrencyUnitPrice", "isOptional", "isTaxable", "laborID", "lineDiscount", "markupRate", "name", "percentageDiscount", "periodType", "productID", "quantity", "quoteID", "quoteItemType", "serviceBundleID", "serviceID", "shippingID", "sortOrderID", "taxCategoryID", "totalEffectiveTax", "unitCost", "unitDiscount", "unitPrice", "soapParentPropertyId"],
-  "quote_locations": ["id", "address1", "address2", "city", "postalCode", "state"],
-  "quote_templates": ["id", "calculateTaxSeparately", "createDate", "createdBy", "currencyNegativeFormat", "currencyPositiveFormat", "dateFormat", "description", "displayTaxCategorySuperscripts", "isActive", "lastActivityBy", "lastActivityDate", "name", "numberFormat", "pageLayout", "pageNumberFormat", "showEachTaxInGroup", "showGridHeader", "showTaxCategory", "showVerticalGridLines"],
-  "quotes": ["id", "approvalStatus", "approvalStatusChangedByResourceID", "approvalStatusChangedDate", "billToLocationID", "calculateTaxSeparately", "comment", "companyID", "contactID", "createDate", "creatorResourceID", "description", "effectiveDate", "expirationDate", "extApprovalContactResponse", "extApprovalResponseDate", "extApprovalResponseSignature", "externalQuoteNumber", "groupByID", "impersonatorCreatorResourceID", "isActive", "lastActivityDate", "lastModifiedBy", "lastPublishedByResourceID", "lastPublishedDateTime", "name", "opportunityID", "paymentTerm", "paymentType", "primaryQuote", "proposalProjectID", "purchaseOrderNumber", "quoteNumber", "quoteTemplateID", "shippingType", "shipToLocationID", "showEachTaxInGroup", "showTaxCategory", "soldToLocationID", "taxRegionID"],
-  "resource_role_queues": ["id", "queueID", "resourceID", "soapParentPropertyId"],
-  "resource_roles": ["id", "departmentID", "isActive", "queueID", "resourceID", "roleID", "soapParentPropertyId"],
-  "resource_skills": ["id", "resourceID", "skillDescription", "skillID", "skillLevel", "soapParentPropertyId"],
-  "resource_time_off_approvers": ["id", "resourceID", "approverResourceID", "approvalLevel", "soapParentPropertyId"],
-  "resource_time_off_balances": ["id", "resourceID", "floatingHolidayAnnualAllowance", "floatingHolidayBalance", "floatingHolidayPlanned", "floatingHolidayUsed", "floatingHolidayWaitingApproval", "personalTimeAnnualAllowance", "personalTimeBalance", "personalTimePlanned", "personalTimeUsed", "personalTimeWaitingApproval", "sickTimeAnnualAllowance", "sickTimeBalance", "sickTimePlanned", "sickTimeUsed", "sickTimeWaitingApproval", "vacationTimeAnnualAllowance", "vacationTimeBalance", "vacationTimePlanned", "vacationTimeUsed", "vacationTimeWaitingApproval", "year", "soapParentPropertyId"],
-  "resources": ["id", "accountingReferenceID", "dateFormat", "defaultServiceDeskRoleID", "email", "email2", "email3", "emailTypeCode", "emailTypeCode2", "emailTypeCode3", "firstName", "gender", "greeting", "hireDate", "homePhone", "initials", "internalCost", "isActive", "lastName", "licenseType", "locationID", "middleName", "mobilePhone", "numberFormat", "officeExtension", "officePhone", "payrollIdentifier", "payrollType", "resourceType", "suffix", "surveyResourceRating", "timeFormat", "title", "travelAvailabilityPct", "userName", "userType"],
-  "roles": ["id", "description", "hourlyFactor", "hourlyRate", "isActive", "isExcludedFromNewContracts", "isSystemRole", "name", "quoteItemDefaultTaxCategoryId", "roleType"],
-  "sales_orders": ["id", "additionalBillToAddressInformation", "additionalShipToAddressInformation", "billingAddress1", "billingAddress2", "billToCity", "billToCountryID", "billToPostalCode", "billToState", "companyID", "contactID", "impersonatorCreatorResourceID", "opportunityID", "organizationalLevelAssociationID", "ownerResourceID", "promisedFulfillmentDate", "salesOrderDate", "shipToAddress1", "shipToAddress2", "shipToCity", "shipToCountryID", "shipToPostalCode", "shipToState", "status", "title", "soapParentPropertyId", "userDefinedFields"],
-  "service_call_task_resources": ["id", "resourceID", "serviceCallTaskID", "soapParentPropertyId"],
-  "service_call_tasks": ["id", "serviceCallID", "taskID", "soapParentPropertyId"],
-  "service_call_ticket_resources": ["id", "resourceID", "serviceCallTicketID", "soapParentPropertyId"],
-  "service_call_tickets": ["id", "serviceCallID", "ticketID", "soapParentPropertyId"],
-  "service_calls": ["id", "cancelationNoticeHours", "canceledByResourceID", "canceledDateTime", "companyID", "companyLocationID", "createDateTime", "creatorResourceID", "description", "duration", "endDateTime", "impersonatorCreatorResourceID", "isComplete", "lastModifiedDateTime", "startDateTime", "status"],
-  "service_level_agreement_results": ["id", "firstResponseElapsedHours", "firstResponseInitiatingResourceID", "firstResponseResourceID", "isFirstResponseMet", "isResolutionMet", "isResolutionPlanMet", "resolutionElapsedHours", "resolutionPlanElapsedHours", "resolutionPlanResourceID", "resolutionResourceID", "serviceLevelAgreementName", "ticketID", "soapParentPropertyId"],
-  "services": ["id", "billingCodeID", "createDate", "creatorResourceID", "description", "invoiceDescription", "isActive", "lastModifiedDate", "markupRate", "name", "periodType", "serviceLevelAgreementID", "unitCost", "unitPrice", "updateResourceID", "vendorCompanyID", "manufacturerServiceProvider", "manufacturerServiceProviderProductNumber", "catalogNumberPartNumber", "sku", "internalID", "externalID", "url", "userDefinedFields"],
-  "skills": ["id", "categoryID", "description", "isActive", "name"],
-  "subscription_periods": ["id", "periodCost", "periodDate", "periodPrice", "postedDate", "purchaseOrderNumber", "subscriptionID", "soapParentPropertyId"],
-  "subscriptions": ["id", "configurationItemID", "description", "effectiveDate", "expirationDate", "impersonatorCreatorResourceID", "materialCodeID", "organizationalLevelAssociationID", "periodCost", "periodPrice", "periodType", "purchaseOrderNumber", "status", "subscriptionName", "totalCost", "totalPrice", "vendorID", "userDefinedFields"],
-  "survey_results": ["id", "companyID", "companyRating", "completeDate", "contactID", "contactRating", "resourceRating", "sendDate", "surveyID", "surveyRating", "ticketID"],
-  "surveys": ["id", "description", "displayName", "name"],
-  "tag_aliases": ["id", "alias", "tagID", "soapParentPropertyId"],
-  "tag_groups": ["id", "displayColor", "isActive", "isSystem", "label"],
-  "tags": ["id", "createDateTime", "isActive", "isExcludedFromAutomaticTagging", "isSystem", "label", "lastModifiedDateTime", "tagGroupID"],
-  "task_secondary_resources": ["id", "resourceID", "roleID", "taskID", "soapParentPropertyId"],
-  "tasks": ["id", "assignedResourceID", "assignedResourceRoleID", "billingCodeID", "canClientPortalUserCompleteTask", "companyLocationID", "completedByResourceID", "completedByType", "completedDateTime", "createDateTime", "creatorResourceID", "creatorType", "departmentID", "description", "endDateTime", "estimatedHours", "externalID", "hoursToBeScheduled", "isTaskBillable", "isVisibleInClientPortal", "lastActivityDateTime", "lastActivityPersonType", "lastActivityResourceID", "phaseID", "priority", "priorityLabel", "projectID", "purchaseOrderNumber", "remainingHours", "startDateTime", "status", "taskCategoryID", "taskNumber", "taskType", "title", "soapParentPropertyId", "userDefinedFields"],
-  "tax_regions": ["id", "isActive", "name"],
-  "ticket_additional_configuration_items": ["id", "configurationItemID", "ticketID", "soapParentPropertyId"],
-  "ticket_additional_contacts": ["id", "contactID", "ticketID", "soapParentPropertyId"],
-  "ticket_attachments": ["id", "attachDate", "attachedByContactID", "attachedByResourceID", "attachmentType", "contentType", "creatorType", "fileSize", "fullPath", "impersonatorCreatorResourceID", "opportunityID", "parentAttachmentID", "parentID", "publish", "ticketID", "ticketNoteID", "timeEntryID", "title", "data", "parentType", "soapParentPropertyId", "isTaskAttachment"],
-  "ticket_categories": ["id", "displayColorRGB", "isActive", "isApiOnly", "isGlobalDefault", "name", "nickname"],
-  "ticket_category_field_defaults": ["id", "description", "estimatedHours", "issueTypeID", "organizationalLevelAssociationID", "priority", "purchaseOrderNumber", "queueID", "resolution", "serviceLevelAgreementID", "sourceID", "status", "subIssueTypeID", "ticketCategoryID", "ticketTypeID", "title", "workTypeID", "soapParentPropertyId"],
-  "ticket_change_request_approvals": ["id", "approveRejectDateTime", "approveRejectNote", "contactID", "isApproved", "resourceID", "ticketID", "soapParentPropertyId"],
-  "ticket_charges": ["id", "billableAmount", "billingCodeID", "chargeType", "contractServiceBundleID", "contractServiceID", "createDate", "creatorResourceID", "datePurchased", "description", "extendedCost", "internalCurrencyBillableAmount", "internalCurrencyUnitPrice", "internalPurchaseOrderNumber", "isBillableToCompany", "isBilled", "name", "notes", "organizationalLevelAssociationID", "productID", "purchaseOrderNumber", "status", "statusLastModifiedBy", "statusLastModifiedDate", "ticketID", "unitCost", "unitPrice", "unitQuantity", "soapParentPropertyId"],
-  "ticket_checklist_items": ["id", "completedByResourceID", "completedDateTime", "isCompleted", "isImportant", "itemName", "knowledgebaseArticleID", "position", "ticketID", "soapParentPropertyId"],
-  "ticket_history": ["id", "action", "date", "detail", "resourceID", "ticketID", "soapParentPropertyId"],
-  "ticket_note_attachments": ["id", "attachDate", "attachedByContactID", "attachedByResourceID", "attachmentType", "contentType", "creatorType", "fileSize", "fullPath", "impersonatorCreatorResourceID", "opportunityID", "parentID", "publish", "ticketID", "ticketNoteID", "title", "data", "parentType", "soapParentPropertyId", "isTaskAttachment"],
-  "ticket_note_webhooks": ["id", "deactivationUrl", "isActive", "isReady", "isSubscribedToCreateEvents", "isSubscribedToDeleteEvents", "isSubscribedToUpdateEvents", "name", "notificationEmailAddress", "ownerResourceID", "secretKey", "sendThresholdExceededNotification", "webhookGUID", "webhookUrl"],
-  "ticket_notes": ["id", "createDateTime", "createdByContactID", "creatorResourceID", "description", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "lastActivityDate", "noteType", "publish", "ticketID", "title", "soapParentPropertyId"],
-  "ticket_secondary_resources": ["id", "resourceID", "roleID", "ticketID", "soapParentPropertyId"],
-  "ticket_webhooks": ["id", "deactivationUrl", "isActive", "isReady", "isSubscribedToCreateEvents", "isSubscribedToDeleteEvents", "isSubscribedToUpdateEvents", "name", "notificationEmailAddress", "ownerResourceID", "secretKey", "sendThresholdExceededNotification", "webhookGUID", "webhookUrl"],
-  "tickets": ["id", "apiVendorID", "assignedResourceID", "assignedResourceRoleID", "billingCodeID", "changeApprovalBoard", "changeApprovalStatus", "changeApprovalType", "changeInfoField1", "changeInfoField2", "changeInfoField3", "changeInfoField4", "changeInfoField5", "companyID", "companyLocationID", "completedByResourceID", "completedDate", "configurationItemID", "contactID", "contractID", "contractServiceBundleID", "contractServiceID", "createDate", "createdByContactID", "creatorResourceID", "creatorType", "currentServiceThermometerRating", "description", "dueDateTime", "estimatedHours", "externalID", "firstResponseAssignedResourceID", "firstResponseDateTime", "firstResponseDueDateTime", "firstResponseInitiatingResourceID", "hoursToBeScheduled", "impersonatorCreatorResourceID", "isAssignedToComanaged", "issueType", "isVisibleToComanaged", "lastActivityDate", "lastActivityPersonType", "lastActivityResourceID", "lastCustomerNotificationDateTime", "lastCustomerVisibleActivityDateTime", "lastTrackedModificationDateTime", "monitorID", "monitorTypeID", "opportunityID", "organizationalLevelAssociationID", "previousServiceThermometerRating", "priority", "problemTicketId", "projectID", "purchaseOrderNumber", "queueID", "resolution", "resolutionPlanDateTime", "resolutionPlanDueDateTime", "resolvedDateTime", "resolvedDueDateTime", "rmaStatus", "rmaType", "rmmAlertID", "serviceLevelAgreementHasBeenMet", "serviceLevelAgreementID", "serviceLevelAgreementPausedNextEventHours", "serviceThermometerTemperature", "source", "status", "subIssueType", "ticketCategory", "ticketNumber", "ticketType", "title", "userDefinedFields"],
-  "time_entries": ["id", "billingApprovalDateTime", "billingApprovalLevelMostRecent", "billingApprovalResourceID", "billingCodeID", "contractID", "contractServiceBundleID", "contractServiceID", "createDateTime", "creatorUserID", "dateWorked", "endDateTime", "hoursToBill", "hoursWorked", "impersonatorCreatorResourceID", "impersonatorUpdaterResourceID", "internalBillingCodeID", "internalNotes", "isInternalNotesVisibleToComanaged", "isNonBillable", "lastModifiedDateTime", "lastModifiedUserID", "offsetHours", "resourceID", "roleID", "showOnInvoice", "startDateTime", "summaryNotes", "taskID", "ticketID", "timeEntryType"],
-  "time_entry_attachments": ["id", "attachDate", "attachedByContactID", "attachedByResourceID", "attachmentType", "contentType", "creatorType", "fileSize", "fullPath", "impersonatorCreatorResourceID", "opportunityID", "parentID", "publish", "taskID", "ticketID", "timeEntryID", "title", "data", "parentType", "soapParentPropertyId", "isTaskAttachment"],
-  "time_off_requests": ["id", "approvedDateTime", "approveRejectResourceID", "createdByResourceID", "createDateTime", "endTime", "hours", "impersonatorApproveRejectResourceID", "lastModifiedByResourceID", "lastModifiedDateTime", "lastApprovedLevel", "reason", "rejectReason", "requestDate", "resourceID", "startTime", "status", "timeOffRequestType", "soapParentPropertyId"]
-};
-var MODEL_DATE_FIELDS = {
-  "appointments": ["createDateTime", "endDateTime", "startDateTime", "updateDateTime"],
-  "billing_item_approval_levels": ["approvalDateTime"],
-  "billing_items": ["itemDate", "postedDate", "postedOnTime", "webServiceDate"],
-  "companies": ["createDate", "lastActivityDate", "lastTrackedModifiedDateTime"],
-  "company_notes": ["completedDateTime", "createDateTime", "endDateTime", "lastModifiedDate", "startDateTime"],
-  "configuration_item_billing_product_associations": ["effectiveDate", "expirationDate"],
-  "configuration_item_dns_records": ["createDateTime"],
-  "configuration_item_notes": ["createDateTime", "lastActivityDate"],
-  "configuration_items": ["createDate", "dattoLastCheckInDateTime", "domainRegistrationDateTime", "domainLastUpdatedDateTime", "domainExpirationDateTime", "installDate", "lastModifiedTime", "sslValidFromDateTime", "sslValidUntilDateTime", "warrantyExpirationDate"],
-  "contacts": ["bulkEmailOptOutTime", "createDate", "lastActivityDate", "lastModifiedDate", "solicitationOptOutTime"],
-  "contract_billing_rules": ["endDate", "startDate"],
-  "contract_blocks": ["datePurchased", "endDate", "startDate"],
-  "contract_charges": ["createDate", "datePurchased", "statusLastModifiedDate"],
-  "contract_milestones": ["createDate", "dateDue"],
-  "contract_notes": ["createDateTime", "lastActivityDate"],
-  "contract_retainers": ["datePurchased", "endDate", "startDate"],
-  "contract_service_bundle_units": ["approveAndPostDate", "endDate", "startDate"],
-  "contract_service_units": ["approveAndPostDate", "endDate", "startDate"],
-  "contract_ticket_purchases": ["datePurchased", "endDate", "startDate"],
-  "contracts": ["endDate", "lastModifiedDateTime", "startDate"],
-  "currencies": ["lastModifiedDateTime"],
-  "expense_item_attachments": ["attachDate"],
-  "expense_items": ["expenseDate"],
-  "expense_reports": ["approvedDate", "submitDate", "weekEnding"],
-  "holidays": ["holidayDate"],
-  "inventory_products": ["createDateTime"],
-  "invoices": ["createDateTime", "dueDate", "fromDate", "invoiceDateTime", "paidDate", "toDate", "voidedDate", "webServiceDate"],
-  "notification_history": ["notificationSentTime"],
-  "opportunities": ["closedDate", "createDate", "lastActivity", "lostDate", "projectedCloseDate", "promisedFulfillmentDate", "startDate", "throughDate"],
-  "opportunity_attachments": ["attachDate"],
-  "phases": ["createDate", "dueDate", "lastActivityDateTime", "startDate"],
-  "products": ["createdTime"],
-  "project_charges": ["createDate", "datePurchased", "statusLastModifiedDate"],
-  "project_notes": ["createDateTime", "lastActivityDate"],
-  "projects": ["completedDateTime", "createDateTime", "endDateTime", "lastActivityDateTime", "startDateTime", "statusDateTime"],
-  "purchase_order_item_receiving": ["receiveDate"],
-  "purchase_order_items": ["estimatedArrivalDate"],
-  "purchase_orders": ["cancelDateTime", "createDateTime", "latestEstimatedArrivalDate", "shippingDate", "submitDateTime"],
-  "quote_templates": ["createDate", "lastActivityDate"],
-  "quotes": ["approvalStatusChangedDate", "createDate", "effectiveDate", "expirationDate", "extApprovalResponseDate", "lastActivityDate", "lastPublishedDateTime"],
-  "resources": ["hireDate"],
-  "sales_orders": ["promisedFulfillmentDate", "salesOrderDate"],
-  "service_calls": ["canceledDateTime", "createDateTime", "endDateTime", "lastModifiedDateTime", "startDateTime"],
-  "services": ["createDate", "lastModifiedDate"],
-  "subscription_periods": ["periodDate", "postedDate"],
-  "subscriptions": ["effectiveDate", "expirationDate"],
-  "survey_results": ["completeDate", "sendDate"],
-  "tags": ["createDateTime", "lastModifiedDateTime"],
-  "tasks": ["completedDateTime", "createDateTime", "endDateTime", "lastActivityDateTime", "startDateTime"],
-  "ticket_attachments": ["attachDate"],
-  "ticket_change_request_approvals": ["approveRejectDateTime"],
-  "ticket_charges": ["createDate", "datePurchased", "statusLastModifiedDate"],
-  "ticket_checklist_items": ["completedDateTime"],
-  "ticket_history": ["date"],
-  "ticket_note_attachments": ["attachDate"],
-  "ticket_notes": ["createDateTime", "lastActivityDate"],
-  "tickets": ["completedDate", "createDate", "dueDateTime", "firstResponseDateTime", "firstResponseDueDateTime", "lastActivityDate", "lastCustomerNotificationDateTime", "lastCustomerVisibleActivityDateTime", "lastTrackedModificationDateTime", "resolutionPlanDateTime", "resolutionPlanDueDateTime", "resolvedDateTime", "resolvedDueDateTime"],
-  "time_entries": ["billingApprovalDateTime", "createDateTime", "dateWorked", "endDateTime", "lastModifiedDateTime", "startDateTime"],
-  "time_entry_attachments": ["attachDate"],
-  "time_off_requests": ["approvedDateTime", "createDateTime", "endTime", "lastModifiedDateTime", "requestDate", "startTime"]
-};
-
 // src/operations/invoke/fieldNames.ts
 async function liveFieldNames(holder) {
+  if (holder === void 0) return null;
   const reader = holder.getFieldInfo;
   if (typeof reader !== "function") return null;
   try {
@@ -21478,7 +21779,7 @@ function collectFilterFieldNames(conditions) {
         continue;
       }
       if (cond.udf === true) continue;
-      if (typeof cond.field === "string" && cond.field.length > 0) out.push(cond.field);
+      if (typeof cond.field === "string" && cond.field.length > 0 && !cond.field.includes(".")) out.push(cond.field);
     }
   };
   walk(conditions);
@@ -21556,16 +21857,19 @@ async function validateQueryFieldNames(record, holder, args) {
     filterNames = collectFilterFieldNames(conditions ?? []);
   }
   if (fieldCheck === false) return;
-  const hasInclude = includeNames !== void 0 && includeNames.length > 0;
-  const hasFilter = filterNames !== void 0 && filterNames.length > 0;
-  if (!hasInclude && !hasFilter) return;
+  const found = await findUnknownFieldNames(record, holder, { includeFields: includeNames ?? [], filter: filterNames ?? [] });
+  if (found === void 0) return;
+  const { known, authority, unknown } = found;
+  if (unknown["includeFields"].length === 0 && unknown["filter"].length === 0) return;
+  throw unknownNamesRefusal(record, authority, known, unknown["includeFields"], unknown["filter"]);
+}
+async function findUnknownFieldNames(record, holder, lists) {
+  if (Object.values(lists).every((names) => names.length === 0)) return void 0;
   const resolved = resolveAuthority(record, await liveFieldNames(holder));
-  if (resolved === void 0) return;
-  const { known, authority } = resolved;
-  const unknownInclude = hasInclude ? includeNames.filter((name) => !known.includes(name)) : [];
-  const unknownFilter = hasFilter ? [...new Set(filterNames.filter((name) => !known.includes(name)))] : [];
-  if (unknownInclude.length === 0 && unknownFilter.length === 0) return;
-  throw unknownNamesRefusal(record, authority, known, unknownInclude, unknownFilter);
+  if (resolved === void 0) return void 0;
+  const unknown = {};
+  for (const [key, names] of Object.entries(lists)) unknown[key] = [...new Set(names.filter((name) => !resolved.known.includes(name)))];
+  return { ...resolved, unknown };
 }
 
 // src/resources/special/_shared/ticketStatus.ts
@@ -21995,7 +22299,7 @@ async function prepareCrmWrite(resource, input, http) {
 
 // src/resources/special/companies/unbilledWorkTypes.ts
 var UNBILLED_WORK_NOTE_CHARS_DEFAULT = 400;
-var UNBILLED_WORK_JOIN_SET_CAP = 300;
+var UNBILLED_WORK_JOIN_SET_CAP = JOIN_SET_CAP;
 
 // src/resources/special/companies/unbilledWorkValidate.ts
 var UNBILLED_WORK_OPT_KEYS = [
@@ -22104,11 +22408,6 @@ function validateUnbilledWorkOptions(companyId, opts) {
 
 // src/resources/special/companies/unbilledWork.ts
 var OP3 = "companies.unbilledWork";
-function capJoinSet(ids2, cap) {
-  const sorted = [...new Set(ids2)].sort((a, b) => a - b);
-  if (sorted.length <= cap) return { ids: sorted, truncated: false };
-  return { ids: sorted.slice(0, cap), truncated: true };
-}
 function unbilledWorkPartStatus(key, conditions, items) {
   if (items.length !== 0) return { status: "ok" };
   const stamp = blindStampFor(BLIND_SURFACE_STAMPS[key]?.query, conditions);
@@ -22554,6 +22853,7 @@ async function fetchMany(client, items, opts = {}) {
   if (opts.liveFields !== void 0 && typeof opts.liveFields !== "boolean") {
     throw new AutotaskConfigError(`fetchMany: liveFields must be a boolean (got ${typeof opts.liveFields})`);
   }
+  const labels = readNamesOpt(opts.names, "fetchMany");
   const cap = Math.min(FETCH_MANY_MAX_ITEMS, opts.maxItems ?? FETCH_MANY_MAX_ITEMS);
   if (opts.liveFields === true) {
     validateFetchManyItems(items, cap, void 0, void 0, { fieldCheck: false });
@@ -22609,7 +22909,8 @@ async function fetchMany(client, items, opts = {}) {
     }
   }
   const ok = results.filter((r) => r.found).length;
-  return { results, ok, failed: results.length - ok };
+  const out = { results, ok, failed: results.length - ok };
+  return labels ? labelFetchResults(client, out) : out;
 }
 
 // src/operations/fetchByIds.ts
@@ -22637,6 +22938,7 @@ async function fetchByIds(client, items, opts = {}) {
       throw new AutotaskConfigError(`fetchByIds: maxItems must be an integer >= 1 (got ${String(opts.maxItems)})`);
     }
   }
+  const labels = readNamesOpt(opts.names, "fetchByIds");
   const cap = Math.min(FETCH_BY_IDS_MAX_ITEMS, opts.maxItems ?? FETCH_BY_IDS_MAX_ITEMS);
   validateFetchManyItems(items, cap, "fetchByIds", `FETCH_BY_IDS_MAX_ITEMS = ${FETCH_BY_IDS_MAX_ITEMS}`);
   const groups = /* @__PURE__ */ new Map();
@@ -22682,8 +22984,8 @@ async function fetchByIds(client, items, opts = {}) {
           maxRecords: FETCH_BY_IDS_CHUNK_SIZE,
           includeFields
         });
-        const res = await client.http.request({ ...req, operation: `${key}.fetchByIds` });
-        const { items: rows } = unwrapItems(res, `${key}.fetchByIds`);
+        const res2 = await client.http.request({ ...req, operation: `${key}.fetchByIds` });
+        const { items: rows } = unwrapItems(res2, `${key}.fetchByIds`);
         for (const row of rows) {
           const k = String(row.id);
           if (!chunkKeys.has(k)) continue;
@@ -22733,7 +23035,8 @@ async function fetchByIds(client, items, opts = {}) {
     );
   }
   const ok = results.filter((r) => r.found).length;
-  return { results, ok, failed: results.length - ok };
+  const res = { results, ok, failed: results.length - ok };
+  return labels ? labelFetchResults(client, res) : res;
 }
 
 // src/resources/special/contracts/lineOfBusiness.ts
@@ -26048,7 +26351,8 @@ var TimeEntriesResource = class extends BaseResource {
   postedWithin(from, to, opts) {
     return postedWithin(this, from, to, this.http, opts);
   }
-  /** Node-parity special op (hand-written in src/resources/special/time_entries.ts). */
+  /** Node-parity special op (hand-written in src/resources/special/time_entries.ts).
+   * @deprecated Since 0.38.0, removed in the next minor. Use operations.aggregate(client, 'time_entries.query', [{ field: 'resourceID', op: 'eq', value: R }, { field: 'dateWorked', op: 'gte', value: FROM }, { field: 'dateWorked', op: 'lte', value: TO }], { groupBy: ['ticketID'], sum: ['hoursWorked'] }) — group keys carry ticketIDName; add { field: 'ticket.companyID', op: 'eq', value: C } to scope by company. */
   recentTickets(from, to, opts) {
     return recentTickets(this, from, to, this.http, opts);
   }
@@ -26181,6 +26485,8 @@ export {
   validateFilter,
   buildFilter,
   normalizedConditions,
+  normalizeInValues,
+  assertNoRelationLeaf,
   buildUrl,
   cursorToPath,
   buildQueryBody,
@@ -26213,16 +26519,7 @@ export {
   FIELD_PRESETS,
   FIELD_PRESET_NAMES,
   resolveFieldsPreset,
-  BaseResource,
-  BillingCodesResource,
-  BillingItemsResource,
-  isDateYMD,
-  monthsInWindow,
-  dayAfter,
-  num,
-  MODEL_FIELD_SETS,
   MODEL_DATE_FIELDS,
-  validateQueryFieldNames,
   EXPAND_RESOURCE_NAMES_MAX_IDS,
   expandResourceNames,
   ENTITY_TYPE_TO_RESOURCE,
@@ -26240,6 +26537,18 @@ export {
   vendorId,
   resolveLineOfBusinessChain,
   resolveCompositeNames,
+  readNamesOpt,
+  labelRows,
+  BaseResource,
+  BillingCodesResource,
+  BillingItemsResource,
+  isDateYMD,
+  monthsInWindow,
+  dayAfter,
+  num,
+  collectFilterFieldNames,
+  validateQueryFieldNames,
+  findUnknownFieldNames,
   resolveTicketStatusSemantics,
   openStatusFilter,
   isClosedStatus,