node-autotask 0.32.0 → 0.34.0

package/dist/{chunk-FVHPN7ZR.js → chunk-6ADFCU3I.js}

@@ -25,6 +25,7 @@ import {
   createNamePlan,
   cursorToPath,
   decodeFileData,
+  effectiveRequiredFields,
   formatUnknownNameList,
   formatVendorDetail,
   isAutotaskError,
@@ -40,10 +41,10 @@ import {
   unwrapItems,
   unwrapOperation,
   vendorId
-} from "./chunk-R6HLJCI2.js";
+} from "./chunk-EZKM4HQ6.js";
 import {
   CAPABILITIES
-} from "./chunk-M2EGFPGF.js";
+} from "./chunk-4MUBUSTL.js";
 
 // src/resources/appointments.ts
 var AppointmentsResource = class extends BaseResource {
@@ -69,9 +70,9 @@ var AppointmentsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -153,9 +154,9 @@ var BillingCodesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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
@@ -196,9 +197,9 @@ var BillingItemApprovalLevelsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -273,11 +274,11 @@ function tzOffsetMs(tz, ms) {
 }
 function localDayStartMs(y, m, d, tz) {
   if (tz === void 0) return Date.UTC(y, m - 1, d);
-  const candidate = Date.UTC(y, m - 1, d);
-  const offset = tzOffsetMs(tz, candidate);
-  let start = candidate - offset;
+  const candidate2 = Date.UTC(y, m - 1, d);
+  const offset = tzOffsetMs(tz, candidate2);
+  let start = candidate2 - offset;
   if (tzOffsetMs(tz, start) !== offset) {
-    start = candidate - tzOffsetMs(tz, start);
+    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;
@@ -561,9 +562,9 @@ var BillingItemsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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
@@ -661,9 +662,9 @@ var ChangeRequestLinksResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -718,9 +719,9 @@ var ChecklistLibrariesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -793,8 +794,8 @@ var ChecklistLibraryChecklistItemsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ChecklistLibraries/{parentId}/ChecklistItems/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -856,9 +857,9 @@ var ClassificationIconsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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 ClassificationIcon 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
@@ -1327,8 +1328,14 @@ async function readFields(http, fresh) {
   cache?.set(key, "fields", fields);
   return fields;
 }
-function assumed(excludeStatusIds) {
-  const closedIds = excludeStatusIds === void 0 ? [ASSUMED_CLOSED_STATUS_ID] : [...excludeStatusIds];
+function assumed(allowAssumed, operation) {
+  if (!allowAssumed) {
+    throw new AutotaskError(
+      `${operation}: the tenant Tickets status picklist could not be resolved to a closed set and allowAssumed is false, so the assumed id ${ASSUMED_CLOSED_STATUS_ID} is refused (fix: expose the Tickets field catalog to this API user, or pass excludeStatusIds)`,
+      { code: "STATUS_SEMANTICS_UNRESOLVED", category: "validation", operation }
+    );
+  }
+  const closedIds = [ASSUMED_CLOSED_STATUS_ID];
   return {
     picklist: [],
     closedIds,
@@ -1337,7 +1344,11 @@ function assumed(excludeStatusIds) {
     note: `closed = status ${closedIds.join(", ")} \u2014 ASSUMED, not read from the tenant: the Tickets status picklist could not be resolved, so the historical id ${ASSUMED_CLOSED_STATUS_ID} stands in (fix: expose the Tickets field catalog to this API user, or pass excludeStatusIds)`
   };
 }
-async function resolveTicketStatusSemantics(http, opts = {}) {
+async function resolveTicketStatusSemantics(http, opts = {}, operation = OP) {
+  if (opts.allowAssumed !== void 0 && typeof opts.allowAssumed !== "boolean") {
+    throw new AutotaskConfigError(`${operation}: allowAssumed must be a boolean (got ${JSON.stringify(opts.allowAssumed)})`, { operation });
+  }
+  const allowAssumed = opts.allowAssumed !== false;
   if (opts.excludeStatusIds !== void 0) {
     const closedIds2 = [...new Set(opts.excludeStatusIds.map((id) => Number(id)))];
     if (closedIds2.length === 0 || closedIds2.some((id) => !Number.isSafeInteger(id) || id < 1)) {
@@ -1350,11 +1361,11 @@ async function resolveTicketStatusSemantics(http, opts = {}) {
     fields = await readFields(http, opts.fresh === true);
   } catch (e) {
     if (e instanceof AutotaskError && e.code === "ABORTED") throw e;
-    return assumed();
+    return assumed(allowAssumed, operation);
   }
   const picklist = picklistOf(fields);
   const closedIds = picklist.filter((v) => CLOSED_STATUS_LABELS.includes(v.label.trim().toLowerCase())).map((v) => v.id);
-  if (closedIds.length === 0) return assumed();
+  if (closedIds.length === 0) return assumed(allowAssumed, operation);
   const labels = picklist.filter((v) => closedIds.includes(v.id)).map((v) => `${v.id} ${v.label}`).join(", ");
   return {
     picklist,
@@ -1439,8 +1450,8 @@ async function scopedCompanyQuery(http, path, companyID, limit, includeFields) {
   });
   return project(unwrapItems(res).items, includeFields);
 }
-async function readOpenTickets(http, companyID, ticketLimit, includeFields) {
-  const semantics = await resolveTicketStatusSemantics(http);
+async function readOpenTickets(http, companyID, ticketLimit, includeFields, status = {}) {
+  const semantics = await resolveTicketStatusSemantics(http, status, "companies.fullProfile");
   const openLeaf = openStatusFilter(semantics.closedIds);
   const openRows = await (async () => {
     const res = await http.request({
@@ -1540,7 +1551,10 @@ async function fullProfile(resource, id, opts = {}, http) {
   const contacts = await scopedCompanyQuery(http, "/V1.0/Contacts/query", companyID, contactLimit, proj.contacts);
   const notes = await scopedCompanyQuery(http, "/V1.0/CompanyNotes/query", companyID, noteLimit, proj.notes);
   const projects = await scopedCompanyQuery(http, "/V1.0/Projects/query", companyID, projectLimit, proj.projects);
-  const openTickets = await readOpenTickets(http, companyID, ticketLimit, proj.openTickets);
+  const openTickets = await readOpenTickets(http, companyID, ticketLimit, proj.openTickets, {
+    ...opts.excludeStatusIds === void 0 ? {} : { excludeStatusIds: opts.excludeStatusIds },
+    ...opts.allowAssumed === void 0 ? {} : { allowAssumed: opts.allowAssumed }
+  });
   const result = {
     company,
     locations: { items: locations, capped: locations.length >= locLimit },
@@ -1561,6 +1575,151 @@ async function fullProfile(resource, id, opts = {}, http) {
   return result;
 }
 
+// src/resources/special/companies/prepareCrmWrite.ts
+var FREEMAIL = /* @__PURE__ */ new Set(["gmail.com", "googlemail.com", "outlook.com", "hotmail.com", "live.com", "yahoo.com", "yahoo.com.au", "icloud.com", "bigpond.com", "optusnet.com.au", "me.com", "proton.me", "protonmail.com"]);
+var LIMIT = 10;
+var OP2 = "companies.prepareCrmWrite";
+async function readRows(http, path, filter) {
+  const res = await http.request({ method: "POST", idempotent: true, path, body: { MaxRecords: LIMIT * 5, filter }, operation: OP2 });
+  return unwrapItems(res).items;
+}
+var str = (v) => typeof v === "string" && v !== "" ? v : null;
+var bool = (v) => typeof v === "boolean" ? v : null;
+var norm = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, " ").replace(/\b(pty|ltd|limited|inc|llc)\b/g, "").replace(/\s+/g, " ").trim();
+function domainOf(input) {
+  if (!input) return null;
+  const host = input.trim().toLowerCase().replace(/^[a-z]+:\/\//, "").replace(/^.*@/, "").replace(/^www\./, "").split(/[/?#:]/)[0] ?? "";
+  return host.includes(".") && !FREEMAIL.has(host) ? host : null;
+}
+function candidate(r) {
+  return { id: r.id, companyName: str(r.companyName), webAddress: str(r.webAddress), phone: str(r.phone), isActive: bool(r.isActive) };
+}
+function has(v) {
+  return v !== void 0 && v !== null && v !== "";
+}
+async function prepareCrmWrite(resource, input, http) {
+  const intents = ["create_company", "add_contact", "update_contact", "update_company"];
+  if (!input || !intents.includes(input.intent)) throw new AutotaskConfigError(`prepareCrmWrite: intent must be one of ${intents.join(", ")}`);
+  const co = input.company ?? {};
+  const ct = input.contact ?? {};
+  const caveats = [
+    "Companies, resources and countries are blind surfaces on some tenants: a miss is not proof a record is absent, and owner / country candidates are lookups, not lists.",
+    "Company name matching is `contains` (exact names ranked first); there is no semantic search in the SDK."
+  ];
+  const needsInput = [];
+  let candidates = [];
+  let matchedBy = null;
+  let searched = false;
+  if (has(co.id)) {
+    searched = true;
+    const rows = await readRows(http, "/V1.0/Companies/query", [{ field: "id", op: "eq", value: co.id }]);
+    candidates = rows.map(candidate);
+    matchedBy = candidates.length ? "id" : null;
+  }
+  const domain = domainOf(co.domain) ?? domainOf(co.website) ?? domainOf(ct.emailAddress);
+  if (candidates.length === 0 && domain) {
+    searched = true;
+    candidates = (await resource.searchByDomain(domain, { limit: LIMIT })).map((c) => candidate(c));
+    matchedBy = candidates.length ? "domain" : null;
+  }
+  if (candidates.length === 0 && has(co.companyName)) {
+    searched = true;
+    const rows = (await resource.searchByIdentity({ companyName: co.companyName }, { limit: LIMIT })).map((c) => candidate(c));
+    const want = norm(co.companyName);
+    const exact = rows.filter((r) => r.companyName !== null && norm(r.companyName) === want);
+    candidates = exact.length ? exact : rows;
+    matchedBy = candidates.length ? exact.length ? "name_exact" : "name_contains" : null;
+  }
+  const status = !searched ? "not_searched" : candidates.length === 0 ? "none" : candidates.length === 1 ? "matched" : "ambiguous";
+  const companyID = status === "matched" ? candidates[0].id : null;
+  const company = { status, matchedBy, candidates };
+  if (status === "ambiguous") {
+    needsInput.push({ field: "company", why: `${candidates.length} companies match; choose one`, source: "policy", lookup: { candidates: candidates.map((c) => ({ id: c.id, companyName: c.companyName })) }, research: "ask" });
+  }
+  if (status === "none" && input.intent !== "create_company") {
+    needsInput.push({ field: "company", why: "no company matched; give a company id, name or domain, or use intent create_company (a miss is not proof of absence)", source: "policy", research: "ask" });
+  }
+  if (status === "not_searched" && input.intent !== "create_company") {
+    needsInput.push({ field: "company", why: "give a company id, name, domain/website or a contact email to search by", source: "policy", research: "ask" });
+  }
+  let locations = null;
+  if (companyID !== null) {
+    const rows = await readRows(http, "/V1.0/CompanyLocations/query", [{ field: "companyID", op: "eq", value: companyID }]);
+    const items = rows.map((r) => ({ id: r.id, name: str(r.name), isPrimary: bool(r.isPrimary), isActive: bool(r.isActive), city: str(r.city), state: str(r.state), postalCode: str(r.postalCode) }));
+    const active = items.filter((l) => l.isActive !== false);
+    const m = active.filter((l) => has(ct.city) && l.city?.toLowerCase() === String(ct.city).toLowerCase() || has(ct.postalCode) && l.postalCode === String(ct.postalCode));
+    const pick = has(ct.companyLocationID) ? { rule: "matched", locationID: ct.companyLocationID } : active.length === 1 ? { rule: "single", locationID: active[0].id } : active.length > 1 && m.length === 1 ? { rule: "matched", locationID: m[0].id } : active.length > 1 ? { rule: "ask", locationID: null } : { rule: "none", locationID: null };
+    locations = { items, pick };
+    if (input.intent === "add_contact" && pick.locationID === null) {
+      needsInput.push({
+        field: "companyLocationID",
+        why: active.length > 1 ? "the company has several active locations; do not guess" : "the company has no active location; create or reactivate one first",
+        source: "policy",
+        lookup: { candidates: active.map((l) => ({ id: l.id, name: l.name, isPrimary: l.isPrimary })) },
+        research: "ask"
+      });
+    }
+  }
+  let contacts = null;
+  if (input.intent !== "create_company" && (has(ct.emailAddress) || has(ct.firstName) && has(ct.lastName) || has(ct.id))) {
+    const pickFields = (r) => ({ id: r.id, firstName: r.firstName, lastName: r.lastName, emailAddress: r.emailAddress, companyID: r.companyID, companyLocationID: r.companyLocationID, isActive: r.isActive });
+    let rows = [];
+    let by = null;
+    if (has(ct.id)) rows = await readRows(http, "/V1.0/Contacts/query", [{ field: "id", op: "eq", value: ct.id }]);
+    else if (has(ct.emailAddress)) {
+      rows = await readRows(http, "/V1.0/Contacts/query", [{ field: "emailAddress", op: "eq", value: ct.emailAddress }]);
+      by = rows.length ? "email" : null;
+    }
+    if (rows.length === 0 && has(ct.firstName) && has(ct.lastName)) {
+      const f = [{ field: "firstName", op: "eq", value: ct.firstName }, { field: "lastName", op: "eq", value: ct.lastName }];
+      if (companyID !== null) f.push({ field: "companyID", op: "eq", value: companyID });
+      rows = await readRows(http, "/V1.0/Contacts/query", f);
+      by = rows.length ? "name" : null;
+    }
+    contacts = { duplicates: rows.slice(0, LIMIT).map(pickFields), matchedBy: by };
+    if (input.intent === "update_contact" && rows.length === 0) {
+      needsInput.push({ field: "contact", why: "no contact matched; give a contact id or email", source: "policy", research: "ask" });
+    }
+  }
+  if (input.intent === "create_company" && status !== "matched") {
+    const eff = effectiveRequiredFields(null, RELATIONSHIP_MAP.companies?.zoneFacts);
+    const research = (f) => ["companyType", "ownerResourceID", "countryID"].includes(f) ? "lookup" : "web_if_available_else_ask";
+    const lookups = {
+      companyType: { via: "operations.fieldCatalog", resource: "companies", field: "companyType", labels: true, note: "map the user wording to one returned label; never hardcode ids" },
+      ownerResourceID: { via: "resources.get / the staff resolver", note: "owners cannot be enumerated on a blind surface: take a known resource id and confirm it with resources.get" },
+      countryID: { via: "countries.query", note: "resolve the country name to an id; never guess" }
+    };
+    const wanted = [
+      ...eff.fields.filter((f) => f !== "isActive").map((f) => [f, "live-proven"]),
+      ...["address1", "city", "state", "postalCode", "countryID"].map((f) => [f, "policy"])
+    ];
+    for (const [f, source] of wanted) {
+      if (has(co[f]) || needsInput.some((n) => n.field === f)) continue;
+      needsInput.push({ field: f, why: source === "policy" ? `CRM policy: a new company needs ${f} (the vendor auto-creates a "Primary Address" location from it)` : `the vendor requires ${f} to create a company`, source, ...lookups[f] ? { lookup: lookups[f] } : {}, research: research(f) });
+    }
+  }
+  if (input.intent === "add_contact") {
+    for (const f of ["firstName", "lastName"]) if (!has(ct[f])) needsInput.push({ field: f, why: `the vendor requires contact ${f}`, source: "live-proven", research: "ask" });
+    if (!has(ct.emailAddress) && !has(ct.phone) && !has(ct.mobilePhone)) needsInput.push({ field: "emailAddress", why: "CRM policy: a contact needs an email or a phone number", source: "policy", research: "ask" });
+  }
+  let next = null;
+  const isInactive = (d) => d.isActive === false || d.isActive === 0;
+  const dups = contacts?.duplicates ?? [];
+  const sameCompany = companyID === null ? dups : dups.filter((d) => d.companyID === companyID);
+  const elsewhere = companyID === null ? [] : dups.filter((d) => d.companyID !== companyID && !isInactive(d));
+  if (input.intent === "add_contact" && sameCompany.length === 0 && elsewhere.length > 0) {
+    needsInput.push({ field: "contact", why: `a contact with this ${contacts?.matchedBy ?? "identity"} is active at another company: update it, move it with contacts.moveToCompany, or confirm a second record`, source: "policy", lookup: { duplicates: elsewhere }, research: "ask" });
+  }
+  if (needsInput.length === 0) {
+    const dup = sameCompany[0];
+    if (input.intent === "create_company") next = status === "matched" ? { operation: "companies.update", note: "the company already exists: update it instead of creating" } : { operation: "companies.create", note: 'then re-run with intent add_contact: the vendor auto-creates a "Primary Address" location (rename it with company_locations.update; locations cannot be deleted via the API)' };
+    else if (input.intent === "add_contact") next = dup ? { operation: "contacts.update", note: `a contact already matches by ${contacts?.matchedBy ?? "id"} (id ${String(dup.id)}): update it, or move it with contacts.moveToCompany if it belongs to another company` } : { operation: "contacts.create", note: `set companyID ${String(companyID)} and companyLocationID ${String(locations?.pick.locationID)}` };
+    else if (input.intent === "update_contact") next = { operation: "contacts.update", note: "send only the changed fields" };
+    else next = { operation: "companies.update", note: "send only the changed fields" };
+  }
+  return { intent: input.intent, company, locations, contacts, needsInput, next, caveats };
+}
+
 // src/resources/special/companies/unbilledWorkTypes.ts
 var UNBILLED_WORK_NOTE_CHARS_DEFAULT = 400;
 var UNBILLED_WORK_JOIN_SET_CAP = 300;
@@ -1671,7 +1830,7 @@ function validateUnbilledWorkOptions(companyId, opts) {
 }
 
 // src/resources/special/companies/unbilledWork.ts
-var OP2 = "companies.unbilledWork";
+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 };
@@ -1708,14 +1867,14 @@ async function readCompanyAndParent(resource, id, includeParent) {
 }
 async function readJoinSets(http, companyIds, v) {
   const ticketsCond = [{ field: "companyID", op: "in", value: companyIds }];
-  const ticketsRaw = await boundedPart(http, "/V1.0/Tickets/query", ticketsCond, v.limit, OP2);
+  const ticketsRaw = await boundedPart(http, "/V1.0/Tickets/query", ticketsCond, v.limit, OP3);
   const projectsCond = [{ field: "companyID", op: "in", value: companyIds }];
-  const projectsRaw = await boundedPart(http, "/V1.0/Projects/query", projectsCond, v.limit, OP2);
+  const projectsRaw = await boundedPart(http, "/V1.0/Projects/query", projectsCond, v.limit, OP3);
   const projectIds = projectsRaw.items.map((p) => num(p.id)).filter((n) => n > 0);
   let taskIds = [];
   let tasksHasMore = false;
   if (projectIds.length > 0) {
-    const tasksRaw = await boundedPart(http, "/V1.0/Tasks/query", [{ field: "projectID", op: "in", value: projectIds }], v.limit, OP2);
+    const tasksRaw = await boundedPart(http, "/V1.0/Tasks/query", [{ field: "projectID", op: "in", value: projectIds }], v.limit, OP3);
     taskIds = tasksRaw.items.map((t) => num(t.id)).filter((n) => n > 0);
     tasksHasMore = tasksRaw.hasMore;
   }
@@ -1739,7 +1898,7 @@ async function readBillingPart(http, v, companyIds) {
   }
   const billingFields = resolveFieldsPreset("billing_join", "billing_items");
   const billingIncludeFields = [...billingFields, "id", ...v.includeNotes ? ["description"] : []];
-  const billingRaw = await boundedPart(http, "/V1.0/BillingItems/query", billingConditions, v.limit, OP2, billingIncludeFields);
+  const billingRaw = await boundedPart(http, "/V1.0/BillingItems/query", billingConditions, v.limit, OP3, billingIncludeFields);
   let billingItems = billingRaw.items;
   let billingNoteCharsTruncated = 0;
   if (v.includeNotes) {
@@ -1783,7 +1942,7 @@ async function readTimePart(http, v, join) {
     if (v.dateFrom !== void 0) timeConditions.push({ field: "dateWorked", op: "gte", value: v.dateFrom });
     if (v.dateTo !== void 0) timeConditions.push({ field: "dateWorked", op: "lte", value: v.dateTo });
     const timeFields = ["taskID", "ticketID", "hoursWorked", "dateWorked", "id", ...v.includeNotes ? ["summaryNotes"] : []];
-    const raw = await boundedPart(http, "/V1.0/TimeEntries/query", timeConditions, v.limit, OP2, timeFields);
+    const raw = await boundedPart(http, "/V1.0/TimeEntries/query", timeConditions, v.limit, OP3, timeFields);
     entries = raw.items;
     let cappedItems = entries;
     let noteCharsTruncated = 0;
@@ -1927,9 +2086,9 @@ var CompaniesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -2007,6 +2166,10 @@ var CompaniesResource = class extends BaseResource {
   unbilledWork(id, opts) {
     return unbilledWork(this, id, opts, this.http);
   }
+  /** Node-parity special op (hand-written in src/resources/special/companies.ts). */
+  prepareCrmWrite(input) {
+    return prepareCrmWrite(this, input, this.http);
+  }
 };
 
 // src/resources/company_alerts.ts
@@ -2035,8 +2198,8 @@ var CompanyAlertsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Companies/{parentId}/Alerts/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -2102,8 +2265,8 @@ var CompanyLocationsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Companies/{parentId}/Locations/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -2174,8 +2337,8 @@ var CompanyNotesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Companies/{parentId}/Notes/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -2237,8 +2400,8 @@ var CompanySiteConfigurationsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Companies/{parentId}/SiteConfigurations/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Update a record under the parent (PATCH on the collection — swagger documents put+patch there;
    * the vendor keys the record by the id in the body; OperationResultModel → { id}). `dryRun: true` returns
@@ -2289,9 +2452,9 @@ var CompanyWebhooksResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -2364,8 +2527,8 @@ var ConfigurationItemBillingProductAssociationsResource = class extends BaseReso
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ConfigurationItems/{parentId}/BillingProductAssociations/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -2429,9 +2592,9 @@ var ConfigurationItemCategoriesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -2497,8 +2660,8 @@ var ConfigurationItemCategoryUdfAssociationsResource = class extends BaseResourc
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ConfigurationItemCategories/{parentId}/UdfAssociations/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -2563,8 +2726,8 @@ var ConfigurationItemDnsRecordsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ConfigurationItems/{parentId}/DnsRecords/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Delete a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the pinned
    * envelope and never issues the delete. */
@@ -2612,8 +2775,8 @@ var ConfigurationItemNotesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ConfigurationItems/{parentId}/Notes/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -2671,8 +2834,8 @@ var ConfigurationItemRelatedItemsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ConfigurationItems/{parentId}/RelatedItems/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -2890,9 +3053,9 @@ var ConfigurationItemsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -2981,8 +3144,8 @@ var ConfigurationItemSslSubjectAlternativeNamesResource = class extends BaseReso
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ConfigurationItems/{parentId}/SslSubjectAlternativeNames/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Update a record under the parent (PATCH on the collection — swagger documents put+patch there;
    * the vendor keys the record by the id in the body; OperationResultModel → { id}). `dryRun: true` returns
@@ -3042,9 +3205,9 @@ var ConfigurationItemTypesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -3118,9 +3281,9 @@ var ConfigurationItemWebhooksResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -3189,9 +3352,9 @@ var ContactGroupContactsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -3246,9 +3409,9 @@ var ContactGroupsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -3571,8 +3734,8 @@ var ContactsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Companies/{parentId}/Contacts/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -3662,9 +3825,9 @@ var ContactWebhooksResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -3737,8 +3900,8 @@ var ContractBillingRulesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/BillingRules/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -3803,8 +3966,8 @@ var ContractBlockHourFactorsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/BlockHourFactors/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -3862,8 +4025,8 @@ var ContractBlocksResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Blocks/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -3922,8 +4085,8 @@ var ContractChargesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Charges/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -3992,8 +4155,8 @@ var ContractExclusionBillingCodesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/ExclusionBillingCodes/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4049,8 +4212,8 @@ var ContractExclusionRolesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/ExclusionRoles/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4106,8 +4269,8 @@ var ContractExclusionSetExcludedRolesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ContractExclusionSets/{parentId}/ExcludedRoles/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4163,8 +4326,8 @@ var ContractExclusionSetExcludedWorkTypesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ContractExclusionSets/{parentId}/ExcludedWorkTypes/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4219,9 +4382,9 @@ var ContractExclusionSetsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4294,8 +4457,8 @@ var ContractMilestonesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Milestones/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4353,8 +4516,8 @@ var ContractNotesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Notes/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4412,8 +4575,8 @@ var ContractRatesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Rates/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4471,8 +4634,8 @@ var ContractRetainersResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Retainers/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4530,8 +4693,8 @@ var ContractRoleCostsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/RoleCosts/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4657,8 +4820,8 @@ var ContractServiceBundlesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/ServiceBundles/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4716,8 +4879,8 @@ var ContractServiceBundleUnitsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/ServiceBundleUnits/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Resolve a ContractServiceBundleUnit 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;
@@ -4758,8 +4921,8 @@ var ContractServicesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/Services/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -4817,8 +4980,8 @@ var ContractServiceUnitsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/ServiceUnits/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Resolve a ContractServiceUnit 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;
@@ -4834,11 +4997,11 @@ var ContractServiceUnitsResource = class extends BaseResource {
 };
 
 // src/resources/special/contracts/lineOfBusiness.ts
-var OP3 = "contracts.lineOfBusiness";
+var OP4 = "contracts.lineOfBusiness";
 function positiveId(value, name) {
   const n = typeof value === "string" && /^[0-9]+$/.test(value.trim()) ? Number(value) : value;
   if (typeof n !== "number" || !Number.isSafeInteger(n) || n < 1) {
-    throw new AutotaskConfigError(OP3 + ": " + name + " must be a positive integer id (got " + String(value) + ")", { operation: OP3 });
+    throw new AutotaskConfigError(OP4 + ": " + name + " must be a positive integer id (got " + String(value) + ")", { operation: OP4 });
   }
   return n;
 }
@@ -4864,7 +5027,7 @@ async function lineOfBusiness(resource, contractIdIn, http, associationIdIn) {
       markers: { association: "missing", organizationalLevel2: "missing", organizationalLevel1: "missing" }
     };
   }
-  const chain = await resolveLineOfBusinessChain(http, associationId, { budget: 3, operation: OP3, onError: "propagate" });
+  const chain = await resolveLineOfBusinessChain(http, associationId, { budget: 3, operation: OP4, onError: "propagate" });
   const { association, organizationalLevel2, organizationalLevel1, markers } = chain.lineOfBusiness;
   return { contractId, associationSource, association, organizationalLevel2, organizationalLevel1, markers };
 }
@@ -5338,7 +5501,7 @@ function appendWiresNote(wires, note) {
   wires.note = (wires.note ? wires.note + " | " : "") + note;
 }
 function makeFetchCtx(rawHttp, v, contractId, budget) {
-  const OP11 = PROFITABILITY_OP;
+  const OP12 = PROFITABILITY_OP;
   const id = parseIdentifier(contractId, "contractId");
   const idNum = typeof id === "number" ? id : Number(id);
   const wires = { issued: 0, requests: 0, budget };
@@ -5350,19 +5513,19 @@ function makeFetchCtx(rawHttp, v, contractId, budget) {
   } };
   const readPart = (path, conditions, fields) => {
     wires.issued += 1;
-    return degradable(() => boundedPart(http, path, conditions, v.limit, OP11, fields));
+    return degradable(() => boundedPart(http, path, conditions, v.limit, OP12, fields));
   };
   const truncatedMonths = {};
   const windowedPart = async (name, key, path, cond, fields, dateField) => {
     const first = await readPart(path, cond, fields);
     if (first.absent !== void 0 || !first.hasMore) return { part: stampPart(key, first, cond), rows: first.items };
-    const wp = await degradable(() => expandByMonth(http, path, cond, v.limit, OP11, fields, dateField, v.dateFrom, v.dateTo, wires));
+    const wp = await degradable(() => expandByMonth(http, path, cond, v.limit, OP12, fields, dateField, v.dateFrom, v.dateTo, wires));
     if (!("truncatedMonths" in wp)) return { part: stampPart(key, wp, cond), rows: [] };
     const { truncatedMonths: tm, ...part } = wp;
     truncatedMonths[name] = tm;
     return { part, rows: wp.items };
   };
-  return { v, OP: OP11, id, idNum, rawHttp, http, wires, windowOn, readPart, windowedPart, truncatedMonths };
+  return { v, OP: OP12, id, idNum, rawHttp, http, wires, windowOn, readPart, windowedPart, truncatedMonths };
 }
 
 // src/resources/special/contracts/profitability.stages.ts
@@ -6324,9 +6487,9 @@ var ContractsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -6400,8 +6563,8 @@ var ContractTicketPurchasesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Contracts/{parentId}/TicketPurchases/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -6458,9 +6621,9 @@ var CountriesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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
@@ -6515,9 +6678,9 @@ var CurrenciesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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 Currency 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
@@ -6561,9 +6724,9 @@ var DepartmentsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -6628,9 +6791,9 @@ var DomainRegistrarsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -6713,8 +6876,8 @@ var ExpenseItemAttachmentsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ExpenseItems/{parentId}/Attachments/{id} — vendor answers the model directly). */
-  async get(parentId, id) {
-    return this.getScopedModel(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedModel(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -6773,9 +6936,9 @@ var ExpenseItemsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -6832,9 +6995,9 @@ var ExpenseReportsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -6898,9 +7061,9 @@ var HolidaySetsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -6969,8 +7132,8 @@ var HolidaysResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/HolidaySets/{parentId}/Holidays/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -7063,9 +7226,9 @@ var InventoryProductsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -7199,9 +7362,9 @@ var InvoicesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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
@@ -7311,9 +7474,9 @@ var InvoiceTemplatesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
 };
 
@@ -7355,9 +7518,9 @@ var NotificationHistoryResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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 NotificationHistory 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;
@@ -7396,9 +7559,9 @@ var OpportunitiesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -7461,8 +7624,8 @@ var OpportunityAttachmentsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Opportunities/{parentId}/Attachments/{id} — vendor answers the model directly). */
-  async get(parentId, id) {
-    return this.getScopedModel(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedModel(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -7521,9 +7684,9 @@ var OpportunityCategoriesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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
@@ -7579,9 +7742,9 @@ var OrganizationalLevel1sResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -7630,9 +7793,9 @@ var OrganizationalLevel2sResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -7681,9 +7844,9 @@ var OrganizationalLevelAssociationsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -7734,8 +7897,8 @@ var PhasesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Projects/{parentId}/Phases/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -7792,9 +7955,9 @@ var ProductsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -7860,8 +8023,8 @@ var ProductVendorsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Products/{parentId}/Vendors/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -7920,8 +8083,8 @@ var ProjectChargesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Projects/{parentId}/Charges/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -7990,8 +8153,8 @@ var ProjectNotesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Projects/{parentId}/Notes/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -8048,9 +8211,9 @@ var ProjectsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -8139,9 +8302,9 @@ var PurchaseApprovalsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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
@@ -8195,8 +8358,8 @@ var PurchaseOrderItemReceivingResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/PurchaseOrderItems/{parentId}/Receiving/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -8245,8 +8408,8 @@ var PurchaseOrderItemsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/PurchaseOrders/{parentId}/Items/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -8302,9 +8465,9 @@ var PurchaseOrdersResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -8367,8 +8530,8 @@ var QuoteItemsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Quotes/{parentId}/Items/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -8438,9 +8601,9 @@ var QuoteLocationsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -8501,9 +8664,9 @@ var QuotesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -8566,9 +8729,9 @@ var QuoteTemplatesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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 QuoteTemplate 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
@@ -8613,8 +8776,8 @@ var ResourceRoleQueuesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Resources/{parentId}/RoleQueues/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -8672,8 +8835,8 @@ var ResourceRolesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Resources/{parentId}/Roles/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Resolve a ResourceRole 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;
@@ -8714,8 +8877,8 @@ var ResourceSkillsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Resources/{parentId}/Skills/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Update a record under the parent (PATCH on the collection — swagger documents put+patch there;
    * the vendor keys the record by the id in the body; OperationResultModel → { id}). `dryRun: true` returns
@@ -8873,12 +9036,9 @@ var ResourcesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError).
-   * `fresh: true` in the opts bag bypasses AND refreshes the ReadCache entry for this id
-   * (the per-id authority read of operations.expandResourceNames with fresh: true — issue #77);
-   * a plain get is the bit-for-bit cached read. */
+  /** 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);
+    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
@@ -9002,8 +9162,8 @@ var ResourceTimeOffApproversResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Resources/{parentId}/TimeOffApprovers/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Resolve a ResourceTimeOffApprover 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;
@@ -9055,8 +9215,8 @@ var ResourceTimeOffBalancesResource = class extends BaseResource {
     }, pageSize);
   }
   /** Get one record by parent + id (/V1.0/Resources/{parentId}/TimeOffBalances/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Resolve a ResourceTimeOffBalance 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;
@@ -9104,9 +9264,9 @@ var RolesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -9170,9 +9330,9 @@ var SalesOrdersResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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
@@ -9213,9 +9373,9 @@ var ServiceCallsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -9284,8 +9444,8 @@ var ServiceCallTaskResourcesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ServiceCallTasks/{parentId}/Resources/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -9341,8 +9501,8 @@ var ServiceCallTasksResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ServiceCalls/{parentId}/Tasks/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -9398,8 +9558,8 @@ var ServiceCallTicketResourcesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ServiceCallTickets/{parentId}/Resources/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -9455,8 +9615,8 @@ var ServiceCallTicketsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/ServiceCalls/{parentId}/Tickets/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -9508,9 +9668,9 @@ var ServiceLevelAgreementResultsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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 ServiceLevelAgreementResults 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;
@@ -9551,9 +9711,9 @@ var ServicesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -9616,9 +9776,9 @@ var SkillsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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 Skill 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
@@ -9659,9 +9819,9 @@ var SubscriptionPeriodsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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 SubscriptionPeriod 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;
@@ -9700,9 +9860,9 @@ var SubscriptionsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -9767,9 +9927,9 @@ var SurveyResultsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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 SurveyResults 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;
@@ -9807,9 +9967,9 @@ var SurveysResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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 Survey 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
@@ -9854,8 +10014,8 @@ var TagAliasesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Tags/{parentId}/Aliases/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -9909,9 +10069,9 @@ var TagGroupsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -9978,9 +10138,9 @@ var TagsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -10049,8 +10209,8 @@ var TaskSecondaryResourcesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Tasks/{parentId}/SecondaryResources/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -10107,8 +10267,8 @@ var TasksResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Projects/{parentId}/Tasks/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -10168,9 +10328,9 @@ var TaxRegionsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -10245,8 +10405,8 @@ var TicketAdditionalConfigurationItemsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Tickets/{parentId}/AdditionalConfigurationItems/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -10302,8 +10462,8 @@ var TicketAdditionalContactsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Tickets/{parentId}/AdditionalContacts/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -10360,8 +10520,8 @@ var TicketAttachmentsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Tickets/{parentId}/Attachments/{id} — vendor answers the model directly). */
-  async get(parentId, id) {
-    return this.getScopedModel(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedModel(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -10420,9 +10580,9 @@ var TicketCategoriesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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
@@ -10480,8 +10640,8 @@ var TicketCategoryFieldDefaultsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/TicketCategories/{parentId}/FieldDefaults/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Resolve a TicketCategoryFieldDefault 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;
@@ -10522,8 +10682,8 @@ var TicketChangeRequestApprovalsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Tickets/{parentId}/ChangeRequestApprovals/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -10734,22 +10894,22 @@ function uiLinkFor(http, entity, id) {
 }
 
 // src/resources/special/ticket_charges.ts
-var OP4 = "ticket_charges.moveToTicket";
+var OP5 = "ticket_charges.moveToTicket";
 var COPY = ["name", "description", "chargeType", "billingCodeID", "productID", "unitQuantity", "unitCost", "unitPrice", "datePurchased", "isBillableToCompany", "notes", "purchaseOrderNumber", "internalPurchaseOrderNumber"];
 var CONTRACT_SCOPED = ["contractServiceID", "contractServiceBundleID"];
 async function readCharge(http, id, retries) {
-  const rows = await queryRows(http, "TicketCharges", [{ field: "id", op: "eq", value: id }], OP4, retries);
+  const rows = await queryRows(http, "TicketCharges", [{ field: "id", op: "eq", value: id }], OP5, retries);
   return rows[0] ?? null;
 }
 async function checkSource({ http, source, sourceId, sourceTicketId, toTicketId }) {
   if (source.isBilled === true) {
-    throw refuse("MOVE_BLOCKED_BILLED", `${OP4}: ticket charge ${sourceId} is billed \u2014 move it in the Autotask UI`, { sourceId, toTicketId }, OP4, {
+    throw refuse("MOVE_BLOCKED_BILLED", `${OP5}: ticket charge ${sourceId} is billed \u2014 move it in the Autotask UI`, { sourceId, toTicketId }, OP5, {
       manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "tickets", sourceTicketId), reason: "billed charges are not moved by the API (the ticket link opens its charges)" }
     });
   }
 }
 var SPEC = {
-  operation: OP4,
+  operation: OP5,
   entity: "ticket_charge",
   readSource: readCharge,
   sourceTicketId: (s) => typeof s.ticketID === "number" ? s.ticketID : null,
@@ -10811,8 +10971,8 @@ var TicketChargesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Tickets/{parentId}/Charges/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -10885,8 +11045,8 @@ var TicketChecklistItemsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Tickets/{parentId}/ChecklistItems/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -11007,9 +11167,9 @@ var TicketHistoryResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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 TicketHistory 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;
@@ -11051,8 +11211,8 @@ var TicketNoteAttachmentsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/TicketNotes/{parentId}/Attachments/{id} — vendor answers the model directly). */
-  async get(parentId, id) {
-    return this.getScopedModel(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedModel(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -11112,8 +11272,8 @@ var TicketNotesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Tickets/{parentId}/Notes/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -11172,9 +11332,9 @@ var TicketNoteWebhooksResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -11247,8 +11407,8 @@ var TicketSecondaryResourcesResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/Tickets/{parentId}/SecondaryResources/{id} — vendor item envelope; item: null → NotFoundError). */
-  async get(parentId, id) {
-    return this.getScopedRaw(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedRaw(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -11418,12 +11578,12 @@ async function slaHealthCheck(_resource, id, opts = {}, http) {
     "tickets.slaHealthCheck"
   );
   const slas = rows.map((row) => {
-    const bool = (v) => typeof v === "boolean" ? v : null;
+    const bool2 = (v) => typeof v === "boolean" ? v : null;
     const num2 = (v) => typeof v === "number" ? v : null;
     const milestones = [
-      { name: "firstResponse", met: bool(row.isFirstResponseMet), elapsedHours: num2(row.firstResponseElapsedHours) },
-      { name: "resolution", met: bool(row.isResolutionMet), elapsedHours: num2(row.resolutionElapsedHours) },
-      { name: "resolutionPlan", met: bool(row.isResolutionPlanMet), elapsedHours: num2(row.resolutionPlanElapsedHours) }
+      { name: "firstResponse", met: bool2(row.isFirstResponseMet), elapsedHours: num2(row.firstResponseElapsedHours) },
+      { name: "resolution", met: bool2(row.isResolutionMet), elapsedHours: num2(row.resolutionElapsedHours) },
+      { name: "resolutionPlan", met: bool2(row.isResolutionPlanMet), elapsedHours: num2(row.resolutionPlanElapsedHours) }
     ];
     return { id: Number(row.id), name: row.serviceLevelAgreementName ?? null, milestones };
   });
@@ -11441,11 +11601,11 @@ async function summary(_resource, id, opts = {}, http) {
   const now = opts.now ?? /* @__PURE__ */ new Date();
   const ageDays = typeof ticket.createDate === "string" && ticket.createDate !== "" ? Math.max(0, Math.floor((now.getTime() - Date.parse(ticket.createDate)) / MS)) : null;
   const pick = (v) => typeof v === "number" ? v : null;
-  const str = (v) => typeof v === "string" && v !== "" ? v : null;
+  const str2 = (v) => typeof v === "string" && v !== "" ? v : null;
   return {
     ticketId,
-    ticketNumber: str(ticket.ticketNumber),
-    title: str(ticket.title),
+    ticketNumber: str2(ticket.ticketNumber),
+    title: str2(ticket.title),
     description: desc.value,
     descriptionLength: desc.length,
     descriptionTruncated: desc.truncated,
@@ -11455,8 +11615,8 @@ async function summary(_resource, id, opts = {}, http) {
     contactID: pick(ticket.contactID),
     assignedResourceID: pick(ticket.assignedResourceID),
     projectID: pick(ticket.projectID),
-    createDate: str(ticket.createDate),
-    dueDateTime: str(ticket.dueDateTime),
+    createDate: str2(ticket.createDate),
+    dueDateTime: str2(ticket.dueDateTime),
     ageDays
   };
 }
@@ -12203,16 +12363,17 @@ async function fullContext(resource, id, opts = {}, http) {
 }
 
 // src/resources/special/tickets/forResource.ts
-var OP5 = "tickets.forResource";
+var OP6 = "tickets.forResource";
 var TICKET_CHUNK = 100;
 var LIMIT_DEFAULT = 100;
 var LIMIT_MAX = 500;
 var LINK_READ_CAP = 500;
+var COUNT_LINK_PAGES = 20;
 var TICKET_FIELDS2 = ["id", "ticketNumber", "title", "status", "assignedResourceID", "companyID"];
 function positiveId2(value, name) {
   const n = typeof value === "string" && /^\d+$/.test(value.trim()) ? Number(value) : value;
   if (typeof n !== "number" || !Number.isSafeInteger(n) || n < 1) {
-    throw new AutotaskConfigError(`${OP5}: ${name} must be a positive integer id (got ${String(value)})`, { operation: OP5 });
+    throw new AutotaskConfigError(`${OP6}: ${name} must be a positive integer id (got ${String(value)})`, { operation: OP6 });
   }
   return n;
 }
@@ -12222,53 +12383,93 @@ async function ticketPage(http, filter, maxRecords, fields) {
     idempotent: true,
     path: "/V1.0/Tickets/query",
     body: { MaxRecords: maxRecords, filter, IncludeFields: fields },
-    operation: OP5
+    operation: OP6
   });
-  const page = unwrapItems(res, OP5);
+  const page = unwrapItems(res, OP6);
   return { rows: page.items, more: page.pageDetails.nextPageUrl !== null };
 }
+async function readLinkIds(http, resourceID, maxPages = 1) {
+  const ids2 = /* @__PURE__ */ new Set();
+  let cursor = null;
+  for (let pages = 0; pages < maxPages; pages++) {
+    const res = await http.request({
+      method: "POST",
+      idempotent: true,
+      path: cursor === null ? "/V1.0/TicketSecondaryResources/query" : cursorToPath(http.baseUrl, cursor),
+      body: { MaxRecords: LINK_READ_CAP, filter: [{ field: "resourceID", op: "eq", value: resourceID }], IncludeFields: ["ticketID"] },
+      operation: OP6
+    });
+    const page = unwrapItems(res, OP6);
+    for (const row of page.items) if (typeof row.ticketID === "number") ids2.add(row.ticketID);
+    cursor = page.pageDetails.nextPageUrl;
+    if (cursor === null || page.items.length === 0) return { ids: [...ids2], capped: false };
+  }
+  return { ids: [...ids2], capped: true };
+}
 async function forResource(_resource, resourceIDIn, http, opts = {}) {
-  if (opts === null || typeof opts !== "object") throw new AutotaskConfigError(`${OP5}: opts must be an object`, { operation: OP5 });
+  if (opts === null || typeof opts !== "object") throw new AutotaskConfigError(`${OP6}: opts must be an object`, { operation: OP6 });
   const resourceID = positiveId2(resourceIDIn, "resourceID");
   const scope = opts.scope ?? "both";
   if (scope !== "primary" && scope !== "secondary" && scope !== "both") {
-    throw new AutotaskConfigError(`${OP5}: scope must be 'primary', 'secondary' or 'both' (got ${JSON.stringify(opts.scope)})`, { operation: OP5 });
+    throw new AutotaskConfigError(`${OP6}: scope must be 'primary', 'secondary' or 'both' (got ${JSON.stringify(opts.scope)})`, { operation: OP6 });
   }
   if (opts.openOnly !== void 0 && typeof opts.openOnly !== "boolean") {
-    throw new AutotaskConfigError(`${OP5}: openOnly must be a boolean`, { operation: OP5 });
+    throw new AutotaskConfigError(`${OP6}: openOnly must be a boolean`, { operation: OP6 });
   }
   const limit = opts.limit === void 0 ? LIMIT_DEFAULT : opts.limit;
-  if (!Number.isInteger(limit) || limit < 1 || limit > LIMIT_MAX) {
-    throw new AutotaskConfigError(`${OP5}: limit must be an integer 1-${LIMIT_MAX} (got ${String(opts.limit)})`, { operation: OP5 });
+  if (opts.countOnly !== true && (!Number.isInteger(limit) || limit < 1 || limit > LIMIT_MAX)) {
+    throw new AutotaskConfigError(`${OP6}: limit must be an integer 1-${LIMIT_MAX} (got ${String(opts.limit)})`, { operation: OP6 });
   }
   const includeFields = opts.includeFields ?? [];
   if (!Array.isArray(includeFields) || includeFields.some((f) => typeof f !== "string" || f.length === 0)) {
-    throw new AutotaskConfigError(`${OP5}: includeFields must be a list of field names`, { operation: OP5 });
+    throw new AutotaskConfigError(`${OP6}: includeFields must be a list of field names`, { operation: OP6 });
   }
   const openOnly = opts.openOnly === true;
   const fields = [.../* @__PURE__ */ new Set([...TICKET_FIELDS2, ...includeFields])];
-  const closed = await resolveTicketStatusSemantics(http, opts.excludeStatusIds === void 0 ? {} : { excludeStatusIds: opts.excludeStatusIds });
+  if (opts.countOnly !== void 0 && typeof opts.countOnly !== "boolean") {
+    throw new AutotaskConfigError(`${OP6}: countOnly must be a boolean`, { operation: OP6 });
+  }
+  const closed = await resolveTicketStatusSemantics(
+    http,
+    { ...opts.excludeStatusIds === void 0 ? {} : { excludeStatusIds: opts.excludeStatusIds }, ...opts.allowAssumed === void 0 ? {} : { allowAssumed: opts.allowAssumed } },
+    OP6
+  );
   const closedStatus = { closedIds: closed.closedIds, source: closed.source, note: closed.note };
-  const openLeaf = openOnly ? [openStatusFilter(closed.closedIds)] : [];
+  const openLeaf = openOnly || opts.countOnly === true ? [openStatusFilter(closed.closedIds)] : [];
+  if (opts.countOnly === true) {
+    const primaryCount = scope === "secondary" ? 0 : await _resource.count({ filter: [{ field: "assignedResourceID", op: "eq", value: resourceID }, ...openLeaf] });
+    let secondaryCount = 0;
+    let bothCount = 0;
+    let linkCapped = false;
+    if (scope !== "primary") {
+      const links = await readLinkIds(http, resourceID, COUNT_LINK_PAGES);
+      linkCapped = links.capped;
+      for (let c = 0; c < links.ids.length; c += TICKET_CHUNK) {
+        const chunk = links.ids.slice(c, c + TICKET_CHUNK);
+        const page = await ticketPage(http, [{ field: "id", op: "in", value: chunk }, ...openLeaf], chunk.length, ["id", "status", "assignedResourceID"]);
+        const seen = /* @__PURE__ */ new Set();
+        for (const t of page.rows) {
+          if (typeof t.id !== "number" || seen.has(t.id) || isClosedStatus(t.status, closed.closedIds)) continue;
+          seen.add(t.id);
+          if (scope === "both" && t.assignedResourceID === resourceID) bothCount++;
+        }
+        secondaryCount += seen.size;
+      }
+    }
+    return { resourceID, scope, primary: primaryCount, secondary: secondaryCount, both: bothCount, open: primaryCount + secondaryCount - bothCount, capped: linkCapped, closedStatus };
+  }
   const linkIds = [];
   let capped = false;
   if (scope !== "primary") {
-    const res = await http.request({
-      method: "POST",
-      idempotent: true,
-      path: "/V1.0/TicketSecondaryResources/query",
-      body: { MaxRecords: LINK_READ_CAP, filter: [{ field: "resourceID", op: "eq", value: resourceID }], IncludeFields: ["ticketID"] },
-      operation: OP5
-    });
-    const page = unwrapItems(res, OP5);
-    for (const row of page.items) if (typeof row.ticketID === "number" && !linkIds.includes(row.ticketID)) linkIds.push(row.ticketID);
-    if (page.items.length >= LINK_READ_CAP || page.pageDetails.nextPageUrl !== null) capped = true;
+    const links = await readLinkIds(http, resourceID);
+    linkIds.push(...links.ids);
+    capped = links.capped;
   }
   const primary = /* @__PURE__ */ new Map();
   if (scope !== "secondary") {
-    const page = await ticketPage(http, [{ field: "assignedResourceID", op: "eq", value: resourceID }, ...openLeaf], limit, fields);
-    if (page.more || page.rows.length >= limit) capped = true;
-    for (const t of page.rows) if (typeof t.id === "number") primary.set(t.id, t);
+    const page = await ticketPage(http, [{ field: "assignedResourceID", op: "eq", value: resourceID }, ...openLeaf], Math.min(limit + 1, LIMIT_MAX), fields);
+    if (page.more || page.rows.length > limit) capped = true;
+    for (const t of page.rows.slice(0, limit)) if (typeof t.id === "number") primary.set(t.id, t);
   }
   const secondary = /* @__PURE__ */ new Map();
   const unresolvedIds = [];
@@ -12281,7 +12482,14 @@ async function forResource(_resource, resourceIDIn, http, opts = {}) {
       secondary.set(t.id, t);
       seen.add(t.id);
     }
-    for (const id of chunk) if (!seen.has(id)) unresolvedIds.push(id);
+    const missing = chunk.filter((id) => !seen.has(id));
+    if (missing.length > 0 && openOnly) {
+      const found = await ticketPage(http, [{ field: "id", op: "in", value: missing }], missing.length, ["id"]);
+      const closedHere = new Set(found.rows.map((t) => t.id));
+      for (const id of missing) if (!closedHere.has(id)) unresolvedIds.push(id);
+    } else {
+      unresolvedIds.push(...missing);
+    }
   }
   const merged = /* @__PURE__ */ new Map();
   for (const [id, t] of primary) merged.set(id, t);
@@ -12313,11 +12521,11 @@ async function forResource(_resource, resourceIDIn, http, opts = {}) {
 }
 
 // src/resources/special/tickets/lineOfBusiness.ts
-var OP6 = "tickets.lineOfBusiness";
+var OP7 = "tickets.lineOfBusiness";
 function positiveId3(value, name) {
   const n = typeof value === "string" && /^[0-9]+$/.test(value.trim()) ? Number(value) : value;
   if (typeof n !== "number" || !Number.isSafeInteger(n) || n < 1) {
-    throw new AutotaskConfigError(OP6 + ": " + name + " must be a positive integer id (got " + String(value) + ")", { operation: OP6 });
+    throw new AutotaskConfigError(OP7 + ": " + name + " must be a positive integer id (got " + String(value) + ")", { operation: OP7 });
   }
   return n;
 }
@@ -12340,7 +12548,7 @@ async function lineOfBusiness2(resource, ticketIdIn, http, associationIdIn) {
       if (contractRef !== void 0) {
         const client = http.client;
         if (client === void 0) {
-          throw new AutotaskConfigError(OP6 + ": the transport is not wired to an AutotaskClient (the composite must run through the client)", { operation: OP6 });
+          throw new AutotaskConfigError(OP7 + ": the transport is not wired to an AutotaskClient (the composite must run through the client)", { operation: OP7 });
         }
         try {
           const contract = await client.contracts.get(contractRef);
@@ -12371,7 +12579,7 @@ async function lineOfBusiness2(resource, ticketIdIn, http, associationIdIn) {
       markers: { association: contractUnread ? "unresolved" : "missing", organizationalLevel2: "missing", organizationalLevel1: "missing" }
     };
   }
-  const chain = await resolveLineOfBusinessChain(http, associationId, { budget: 3, operation: OP6, onError: "propagate" });
+  const chain = await resolveLineOfBusinessChain(http, associationId, { budget: 3, operation: OP7, onError: "propagate" });
   const { association, organizationalLevel2, organizationalLevel1, markers } = chain.lineOfBusiness;
   return { ticketId, associationSource, contractId, association, organizationalLevel2, organizationalLevel1, markers };
 }
@@ -12406,9 +12614,9 @@ var TicketsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -12490,7 +12698,6 @@ var TicketsResource = class extends BaseResource {
   statusSemantics(opts) {
     return statusSemantics(this, opts, this.http);
   }
-  /** Node-parity special op (hand-written in src/resources/special/tickets.ts). */
   forResource(resourceID, opts) {
     return forResource(this, resourceID, this.http, opts);
   }
@@ -12527,9 +12734,9 @@ var TicketWebhooksResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -12662,12 +12869,12 @@ async function postedStateQuery(_resource, mode, http, opts) {
   return { items, hasMore: read.hasMore || incomplete, window, approvedCount, unapprovedCount: items.length - approvedCount };
 }
 async function postedWithin(_resource, from, to, http, opts, opLabel = "time_entries.postedWithin") {
-  const OP11 = opLabel;
-  if (opts?.tz !== void 0) validateZone(opts.tz, OP11);
-  const fromB = customRangeDay(from, "from", void 0, OP11);
-  const toB = customRangeDay(to, "to", void 0, OP11);
+  const OP12 = opLabel;
+  if (opts?.tz !== void 0) validateZone(opts.tz, OP12);
+  const fromB = customRangeDay(from, "from", void 0, OP12);
+  const toB = customRangeDay(to, "to", void 0, OP12);
   if (fromB.ms > toB.ms) {
-    throw new AutotaskConfigError(`${OP11}: from (${iso2(fromB.ms)}) must not be after to (${iso2(toB.ms)})`, { operation: OP11 });
+    throw new AutotaskConfigError(`${OP12}: from (${iso2(fromB.ms)}) must not be after to (${iso2(toB.ms)})`, { operation: OP12 });
   }
   const windowToMs = toB.ms + DAY_MS2 - 1;
   const filter = [
@@ -12676,8 +12883,8 @@ async function postedWithin(_resource, from, to, http, opts, opLabel = "time_ent
   ];
   if (opts?.ticketID !== void 0) filter.push({ field: "ticketID", op: "eq", value: opts.ticketID });
   if (opts?.resourceID !== void 0) filter.push({ field: "resourceID", op: "eq", value: opts.resourceID });
-  const { items, hasMore } = await queryTimeEntries(_resource, filter, clampWindowLimit(opts?.limit), OP11, http);
-  const { states, incomplete } = await postedStateOf(http, items, OP11);
+  const { items, hasMore } = await queryTimeEntries(_resource, filter, clampWindowLimit(opts?.limit), OP12, http);
+  const { states, incomplete } = await postedStateOf(http, items, OP12);
   let postedCount = 0;
   let unpostedCount = 0;
   for (const state of states.values()) {
@@ -12887,7 +13094,7 @@ async function resolveCode(http, family, familyLabel2, pinnedId, departments, op
 }
 
 // src/resources/special/time_entries/createForResource.ts
-var OP7 = "time_entries.createForResource";
+var OP8 = "time_entries.createForResource";
 var PARAM_KEYS = /* @__PURE__ */ new Set([
   "internallAllocationCodeID",
   "ticketID",
@@ -12923,30 +13130,30 @@ function validateCreateParams(params) {
   if (pinCount > 1) {
     throw new AutotaskConfigError(
       "createForResource: exactly one linkage pin is honoured (internallAllocationCodeID | ticketID | taskID) \u2014 the vendor gate requires exactly one; pass one pin (or none for the default internal linkage)",
-      { operation: OP7 }
+      { operation: OP8 }
     );
   }
   if (pins.role !== void 0 && pins.code !== void 0) {
     throw new AutotaskConfigError(
       "createForResource: a pinned roleID is only meaningful with the task/ticket linkage (internallAllocationCodeID pins the internal linkage and owns the code) \u2014 drop one",
-      { operation: OP7 }
+      { operation: OP8 }
     );
   }
   if (params.hoursWorked !== void 0 && (typeof params.hoursWorked !== "number" || !Number.isFinite(params.hoursWorked) || params.hoursWorked <= 0)) {
     throw new AutotaskConfigError(
       `createForResource: hoursWorked must be a positive finite number (got ${String(params.hoursWorked)})`,
-      { operation: OP7 }
+      { operation: OP8 }
     );
   }
   return pins;
 }
 async function assertResourceActive(http, rid) {
-  const rec = await fetchItem2(http, `/V1.0/Resources/${rid}`, OP7);
+  const rec = await fetchItem2(http, `/V1.0/Resources/${rid}`, OP8);
   if (rec === null) {
     throw new ResourceInvalidError(`Resource ${rid} was not found \u2014 a time entry cannot attach to a missing resource`, {
       resourceIds: [rid],
       details: { idRefs: [{ entity: "resource", id: rid }] },
-      operation: OP7,
+      operation: OP8,
       category: "not_found",
       suggestedAction: "Resolve the resource id (resources.get / resources.search) and retry."
     });
@@ -12955,7 +13162,7 @@ async function assertResourceActive(http, rid) {
     throw new ResourceInvalidError(`Resource ${rid} is not active (isActive !== true) \u2014 the vendor would reject a time entry for an inactive resource`, {
       resourceIds: [rid],
       details: { idRefs: [{ entity: "resource", id: rid }] },
-      operation: OP7,
+      operation: OP8,
       suggestedAction: "Activate the resource or pick an active one."
     });
   }
@@ -12965,11 +13172,11 @@ async function resolveAllocationCode(http, rid, linkage, pins, departments) {
   const pinnedForCode = pins.code !== void 0 ? pins.code : pins.role;
   let code = null;
   const familiesTried = [];
-  code = await resolveCode(http, familyOf(linkage), familyLabel(familyOf(linkage)), pinnedForCode, departments, OP7);
+  code = await resolveCode(http, familyOf(linkage), familyLabel(familyOf(linkage)), pinnedForCode, departments, OP8);
   familiesTried.push({ family: familyOf(linkage), label: familyLabel(familyOf(linkage)), filters: [{ field: "useType", op: "eq", value: familyOf(linkage) }, { field: "isActive", op: "eq", value: true }] });
   if (code === null && linkage === "task" && pins.role === void 0) {
     usedLinkage = "internal";
-    code = await resolveCode(http, USE_TYPE_INTERNAL, familyLabel(USE_TYPE_INTERNAL), void 0, departments, OP7);
+    code = await resolveCode(http, USE_TYPE_INTERNAL, familyLabel(USE_TYPE_INTERNAL), void 0, departments, OP8);
     familiesTried.push({ family: USE_TYPE_INTERNAL, label: familyLabel(USE_TYPE_INTERNAL), filters: [{ field: "useType", op: "eq", value: USE_TYPE_INTERNAL }, { field: "isActive", op: "eq", value: true }] });
   }
   if (code === null) {
@@ -12979,7 +13186,7 @@ async function resolveAllocationCode(http, rid, linkage, pins, departments) {
         families: familiesTried,
         resourceDepartments: [...departments].sort((a, b) => a - b)
       },
-      { operation: OP7 }
+      { operation: OP8 }
     );
   }
   const resolvedCode = codeInfo(code);
@@ -13018,7 +13225,7 @@ function createDryRun2(http, rid, body, linkage, usedLinkage, resolvedCode) {
   }
   return buildDryRunResult(
     {
-      operation: OP7,
+      operation: OP8,
       method: "POST",
       path: "/V1.0/TimeEntries",
       ids: [rid],
@@ -13060,7 +13267,7 @@ async function createWithAttempts(resource, http, opts, body, defaults, pins, us
       const gate3 = ROLE_REJECTION_PATTERN.test(text);
       if (usedLinkage !== "internal" && gate3) {
         if (!taskRoleFetched && usedLinkage === "task" && pins.task !== void 0) {
-          const task = await fetchItem2(http, `/V1.0/Tasks/${pins.task}`, OP7);
+          const task = await fetchItem2(http, `/V1.0/Tasks/${pins.task}`, OP8);
           taskRoleFetched = true;
           if (task !== null) pushLadder(task.assignedResourceRoleID);
         }
@@ -13086,7 +13293,7 @@ async function createForResource(resource, resourceID, params, opts = {}, http)
   const pins = validateCreateParams(params);
   await assertResourceActive(http, rid);
   const linkage = pins.code !== void 0 ? "internal" : pins.ticket !== void 0 ? "ticket" : pins.task !== void 0 ? "task" : "internal";
-  const roleRows = await resourceRoleRows(http, rid, OP7);
+  const roleRows = await resourceRoleRows(http, rid, OP8);
   const departments = roleRows.departments;
   const { usedLinkage, resolvedCode } = await resolveAllocationCode(http, rid, linkage, pins, departments);
   const defaults = windowDefaults(params);
@@ -13109,12 +13316,12 @@ function discoveryField(err, body, defaults) {
 }
 
 // src/resources/special/time_entries/move.ts
-var OP8 = "time_entries.moveToTicket";
+var OP9 = "time_entries.moveToTicket";
 var COPY2 = ["resourceID", "roleID", "billingCodeID", "dateWorked", "startDateTime", "endDateTime", "hoursWorked", "offsetHours", "summaryNotes", "internalNotes", "isNonBillable", "showOnInvoice"];
 var CONTRACT_SCOPED2 = ["contractID", "contractServiceID", "contractServiceBundleID"];
 async function readTimeEntry(http, id, retries) {
   try {
-    const res = await http.request({ method: "GET", path: `/V1.0/TimeEntries/${id}`, operation: OP8, maxRetries: retries });
+    const res = await http.request({ method: "GET", path: `/V1.0/TimeEntries/${id}`, operation: OP9, maxRetries: retries });
     return res?.item ?? null;
   } catch (e) {
     if (isAutotaskError(e) && (e.httpStatus === 404 || e.code === "NOT_FOUND")) return null;
@@ -13124,27 +13331,27 @@ async function readTimeEntry(http, id, retries) {
 async function checkSource2({ http, source, sourceId, toTicketId, retries }) {
   const ids2 = { sourceId, toTicketId };
   if (source.taskID !== null && source.taskID !== void 0) {
-    throw refuse("MOVE_SOURCE_UNSUPPORTED", `${OP8}: time entry ${sourceId} is on a task \u2014 only ticket time entries are moved`, ids2, OP8);
+    throw refuse("MOVE_SOURCE_UNSUPPORTED", `${OP9}: time entry ${sourceId} is on a task \u2014 only ticket time entries are moved`, ids2, OP9);
   }
   if (source.billingApprovalDateTime || source.billingApprovalResourceID || source.billingApprovalLevelMostRecent) {
-    throw refuse("MOVE_BLOCKED_APPROVED", `${OP8}: time entry ${sourceId} has billing approval set \u2014 move it in the Autotask UI`, ids2, OP8, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "approved entries are not moved by the API" } });
+    throw refuse("MOVE_BLOCKED_APPROVED", `${OP9}: time entry ${sourceId} has billing approval set \u2014 move it in the Autotask UI`, ids2, OP9, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "approved entries are not moved by the API" } });
   }
   let billing;
   try {
-    billing = await queryRows(http, "BillingItems", [{ field: "timeEntryID", op: "eq", value: sourceId }], OP8, retries);
+    billing = await queryRows(http, "BillingItems", [{ field: "timeEntryID", op: "eq", value: sourceId }], OP9, retries);
   } catch {
-    throw refuse("MOVE_BLOCKED_BILLED", `${OP8}: the billing items of time entry ${sourceId} could not be read \u2014 refused (fails closed)`, ids2, OP8, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "billing state unreadable" } });
+    throw refuse("MOVE_BLOCKED_BILLED", `${OP9}: the billing items of time entry ${sourceId} could not be read \u2014 refused (fails closed)`, ids2, OP9, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "billing state unreadable" } });
   }
   if (billing.some((b) => b.invoiceID || b.postedDate)) {
-    throw refuse("MOVE_BLOCKED_BILLED", `${OP8}: time entry ${sourceId} is billed or posted \u2014 move it in the Autotask UI`, ids2, OP8, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "billed entries are not moved by the API" } });
+    throw refuse("MOVE_BLOCKED_BILLED", `${OP9}: time entry ${sourceId} is billed or posted \u2014 move it in the Autotask UI`, ids2, OP9, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "billed entries are not moved by the API" } });
   }
-  const attachments = await queryRows(http, "TimeEntryAttachments", [{ field: "timeEntryID", op: "eq", value: sourceId }], OP8, retries);
+  const attachments = await queryRows(http, "TimeEntryAttachments", [{ field: "timeEntryID", op: "eq", value: sourceId }], OP9, retries);
   if (attachments.length > 0) {
-    throw refuse("MOVE_BLOCKED_ATTACHMENTS", `${OP8}: time entry ${sourceId} has attachments, which a delete would destroy \u2014 move it in the Autotask UI`, ids2, OP8, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "entries with attachments are not moved by the API" } });
+    throw refuse("MOVE_BLOCKED_ATTACHMENTS", `${OP9}: time entry ${sourceId} has attachments, which a delete would destroy \u2014 move it in the Autotask UI`, ids2, OP9, { manualAction: { action: "delete_source", uiLink: uiLinkFor(http, "time_entries", sourceId), reason: "entries with attachments are not moved by the API" } });
   }
 }
 var SPEC2 = {
-  operation: OP8,
+  operation: OP9,
   entity: "time_entry",
   readSource: readTimeEntry,
   sourceTicketId: (s) => typeof s.ticketID === "number" ? s.ticketID : null,
@@ -13179,7 +13386,7 @@ function moveToTicket2(_resource, sourceId, toTicketId, opts, http) {
 }
 
 // src/resources/special/time_entries/approve.ts
-var OP9 = "time_entries.approve";
+var OP10 = "time_entries.approve";
 var APPROVAL_LEVELS_PATH = "/V1.0/BillingItemApprovalLevels";
 function toIso(value) {
   if (value instanceof Date) {
@@ -13217,7 +13424,7 @@ async function approve(resource, id, opts = {}, http) {
   if (opts.dryRun === true) {
     return buildDryRunResult(
       {
-        operation: OP9,
+        operation: OP10,
         method: "POST",
         path: APPROVAL_LEVELS_PATH,
         ids: [numericId],
@@ -13240,10 +13447,10 @@ async function approve(resource, id, opts = {}, http) {
     method: "POST",
     path: APPROVAL_LEVELS_PATH,
     body,
-    operation: OP9,
+    operation: OP10,
     maxRetries: opts.maxRetries
   });
-  const levelId = toNumber(parseIdentifier(unwrapOperation(created, OP9).id, "billingItemApprovalLevelID"));
+  const levelId = toNumber(parseIdentifier(unwrapOperation(created, OP10).id, "billingItemApprovalLevelID"));
   await resource.update(
     numericId,
     { billingApprovalDateTime: approvalDateTime, billingApprovalResourceID: approvalResourceID },
@@ -13266,28 +13473,28 @@ async function approve(resource, id, opts = {}, http) {
 }
 
 // src/resources/special/time_entries/recentTickets.ts
-var OP10 = "time_entries.recentTickets";
+var OP11 = "time_entries.recentTickets";
 var DAY_MS3 = 864e5;
 var TICKET_CHUNK2 = 100;
 var TICKET_FIELDS3 = ["id", "ticketNumber", "title", "status", "assignedResourceID", "companyID"];
 function positiveId4(value, name) {
   const n = typeof value === "string" && /^\d+$/.test(value.trim()) ? Number(value) : value;
   if (typeof n !== "number" || !Number.isSafeInteger(n) || n < 1) {
-    throw new AutotaskConfigError(`${OP10}: ${name} must be a positive integer id (got ${String(value)})`, { operation: OP10 });
+    throw new AutotaskConfigError(`${OP11}: ${name} must be a positive integer id (got ${String(value)})`, { operation: OP11 });
   }
   return n;
 }
 async function recentTickets(_resource, from, to, http, opts) {
   if (opts === void 0 || opts === null || typeof opts !== "object") {
-    throw new AutotaskConfigError(`${OP10}: opts { resourceID, companyID?, tz?, limit? } is required`, { operation: OP10 });
+    throw new AutotaskConfigError(`${OP11}: opts { resourceID, companyID?, tz?, limit? } is required`, { operation: OP11 });
   }
   const resourceID = positiveId4(opts.resourceID, "resourceID");
   const companyID = opts.companyID === void 0 ? void 0 : positiveId4(opts.companyID, "companyID");
-  if (opts.tz !== void 0) validateZone(opts.tz, OP10);
-  const fromB = customRangeDay(from, "from", void 0, OP10);
-  const toB = customRangeDay(to, "to", void 0, OP10);
+  if (opts.tz !== void 0) validateZone(opts.tz, OP11);
+  const fromB = customRangeDay(from, "from", void 0, OP11);
+  const toB = customRangeDay(to, "to", void 0, OP11);
   if (fromB.ms > toB.ms) {
-    throw new AutotaskConfigError(`${OP10}: from (${isoUtc(fromB.ms)}) must not be after to (${isoUtc(toB.ms)})`, { operation: OP10 });
+    throw new AutotaskConfigError(`${OP11}: from (${isoUtc(fromB.ms)}) must not be after to (${isoUtc(toB.ms)})`, { operation: OP11 });
   }
   const windowToMs = toB.ms + DAY_MS3 - 1;
   const { items: entries, hasMore } = await queryTimeEntries(
@@ -13298,7 +13505,7 @@ async function recentTickets(_resource, from, to, http, opts) {
       { field: "resourceID", op: "eq", value: resourceID }
     ],
     clampWindowLimit(opts.limit),
-    OP10,
+    OP11,
     http
   );
   const groups = /* @__PURE__ */ new Map();
@@ -13324,9 +13531,9 @@ async function recentTickets(_resource, from, to, http, opts) {
       idempotent: true,
       path: "/V1.0/Tickets/query",
       body: { MaxRecords: TICKET_CHUNK2, filter, IncludeFields: TICKET_FIELDS3 },
-      operation: OP10
+      operation: OP11
     });
-    for (const t of unwrapItems(res, OP10).items) if (typeof t.id === "number") tickets.set(t.id, t);
+    for (const t of unwrapItems(res, OP11).items) if (typeof t.id === "number") tickets.set(t.id, t);
   }
   const items = [];
   const unresolvedTicketIDs = [];
@@ -13386,9 +13593,9 @@ var TimeEntriesResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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);
   }
   /** Create a record (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -13538,8 +13745,8 @@ var TimeEntryAttachmentsResource = class extends BaseResource {
     return this.countGlobal(params);
   }
   /** Get one record by parent + id (/V1.0/TimeEntries/{parentId}/Attachments/{id} — vendor answers the model directly). */
-  async get(parentId, id) {
-    return this.getScopedModel(parentId, id);
+  async get(parentId, id, opts = {}) {
+    return this.getScopedModel(parentId, id, opts?.fresh === true);
   }
   /** Create a record under the parent (OperationResultModel → { id}). `dryRun: true` returns the
    * pinned envelope (section 19.3) and never issues the create. A 2xx that is not the
@@ -13645,9 +13852,9 @@ var TimeOffRequestsResource = class extends BaseResource {
   async count(params) {
     return this.countGlobal(params);
   }
-  /** Get one record by id (item envelope; item: null → NotFoundError). */
-  async get(id) {
-    return this.getGlobal(id);
+  /** 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 TimeOffRequest 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;