node-autotask 0.43.0 → 0.45.0

package/dist/operations/index.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
 
@@ -41,6 +41,9 @@
 
 
 
+var _chunkYMBVKVK4cjs = require('../chunk-YMBVKVK4.cjs');
+require('../chunk-VXVYFJH3.cjs');
+require('../chunk-SN4BMQ2N.cjs');
 
 
 
@@ -70,2200 +73,12 @@
 
 
 
-var _chunkVFLAMMIJcjs = require('../chunk-VFLAMMIJ.cjs');
 
 
-var _chunk5BDUMDAQcjs = require('../chunk-5BDUMDAQ.cjs');
 
 
-var _chunkMJTKK3QGcjs = require('../chunk-MJTKK3QG.cjs');
 
-// src/operations/searchAcrossResources.ts
-var DEFAULT_LIMIT = 25;
-function resourceFor(client, key) {
-  return client[_chunkVFLAMMIJcjs.camelKey.call(void 0, key)];
-}
-async function searchAcrossResources(client, query, opts = {}) {
-  const text = query.trim();
-  if (text === "") {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)("searchAcrossResources: query must be a non-empty string");
-  }
-  const keys = _nullishCoalesce(opts.resources, () => ( _chunkVFLAMMIJcjs.WORKFLOW_RESOURCES));
-  if (keys.length === 0) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)("searchAcrossResources: no resources requested");
-  }
-  const limit = _chunkVFLAMMIJcjs.clampPageSize.call(void 0, _nullishCoalesce(opts.limit, () => ( DEFAULT_LIMIT)));
-  const totalLimit = opts.totalLimit;
-  if (totalLimit !== void 0 && !(Number.isInteger(totalLimit) && totalLimit >= 1)) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)("searchAcrossResources: totalLimit must be a positive integer");
-  }
-  const results = [];
-  const skipped = [];
-  const notSearched = [];
-  let remaining = _nullishCoalesce(totalLimit, () => ( Infinity));
-  let hitQuota = false;
-  for (const key of keys) {
-    const holder = resourceFor(client, key);
-    if (holder === void 0 || typeof holder.search !== "function") {
-      skipped.push(key);
-      continue;
-    }
-    if (remaining <= 0) {
-      notSearched.push(key);
-      continue;
-    }
-    const ask = Math.min(limit, remaining);
-    const matches = await holder.search(text, { limit: ask });
-    const rows = Array.isArray(matches) ? matches.filter((m) => typeof m === "object" && m !== null).map((m) => m) : [];
-    if (totalLimit !== void 0) rows.length = Math.min(rows.length, ask);
-    results.push({ resource: key, matches: rows });
-    remaining -= rows.length;
-    if (rows.length === ask) hitQuota = true;
-  }
-  if (totalLimit === void 0) return { query: text, results, skipped };
-  return { query: text, results, skipped, notSearched, truncated: notSearched.length > 0 || hitQuota };
-}
 
-// src/operations/resolveAny.ts
-function resourceFor2(client, key) {
-  return client[_chunkVFLAMMIJcjs.camelKey.call(void 0, key)];
-}
-var FAULT_CATEGORIES = /* @__PURE__ */ new Set(["auth", "rate_limit", "server", "network", "timeout", "policy"]);
-function missCost(identifier) {
-  if (typeof identifier === "number") return "direct";
-  return /^\d+$/.test(identifier.trim()) ? "direct" : "server-filter";
-}
-async function resolveAny(client, identifier, opts = {}) {
-  if (typeof identifier === "number") {
-    _chunkVFLAMMIJcjs.parseIdentifier.call(void 0, identifier, "identifier");
-  } else if (identifier.trim() === "") {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)("resolveAny: identifier must be non-empty");
-  }
-  const keys = _nullishCoalesce(opts.resources, () => ( _chunkVFLAMMIJcjs.WORKFLOW_RESOURCES));
-  if (keys.length === 0) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)("resolveAny: no resources requested");
-  }
-  const match = _nullishCoalesce(opts.match, () => ( "exact"));
-  if (match !== "exact" && match !== "auto") {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(`resolveAny: match must be 'exact' or 'auto' (got ${JSON.stringify(match)})`);
-  }
-  const results = [];
-  for (const key of keys) {
-    const holder = resourceFor2(client, key);
-    if (holder === void 0 || typeof holder.resolveDetailed !== "function") {
-      results.push({
-        resource: key,
-        value: null,
-        resolutionCost: missCost(identifier),
-        scanned: 0,
-        scanTruncated: false,
-        candidates: [],
-        error: "NO_RESOLVE"
-      });
-      continue;
-    }
-    try {
-      const r = await holder.resolveDetailed(identifier);
-      let outcome = {
-        resource: key,
-        value: _nullishCoalesce(r.value, () => ( null)),
-        resolutionCost: r.resolutionCost,
-        scanned: r.scanned,
-        scanTruncated: r.scanTruncated,
-        candidates: (_nullishCoalesce(r.candidates, () => ( []))).map((c) => c.id)
-      };
-      if (match === "auto" && outcome.value === null && typeof identifier === "string") {
-        const hits = await holder.resolveContainsMatches(identifier);
-        if (hits.length === 1) {
-          outcome = { resource: key, value: hits[0], resolutionCost: "server-filter", scanned: 0, scanTruncated: false, candidates: [] };
-        } else if (hits.length > 1) {
-          outcome = {
-            resource: key,
-            value: null,
-            resolutionCost: "server-filter",
-            scanned: 0,
-            scanTruncated: false,
-            candidates: hits.map((h) => h.id).filter((id) => typeof id === "number"),
-            error: "RESOLUTION_AMBIGUOUS"
-          };
-        }
-      }
-      results.push(outcome);
-    } catch (err) {
-      let code;
-      let candidates = [];
-      if (err instanceof _chunkVFLAMMIJcjs.AutotaskConfigError) {
-        code = "CONFIG_ERROR";
-      } else if (_chunkVFLAMMIJcjs.isAutotaskError.call(void 0, err)) {
-        if (FAULT_CATEGORIES.has(err.category)) throw err;
-        code = err.code;
-        if (code === "RESOLUTION_AMBIGUOUS" && err.resourceIds !== void 0) {
-          candidates = err.resourceIds;
-        }
-      } else {
-        throw err;
-      }
-      results.push({
-        resource: key,
-        value: null,
-        resolutionCost: missCost(identifier),
-        scanned: 0,
-        scanTruncated: code === "RESOLUTION_TRUNCATED",
-        candidates,
-        error: code
-      });
-    }
-  }
-  const matches = results.filter((r) => r.value !== null).map((r) => r.resource);
-  return { identifier, results, matches };
-}
-
-// src/operations/aggregate.ts
-var AGGREGATE_TOP_MAX = 100;
-var AGGREGATE_DEFAULT_TOP = 25;
-var AGGREGATE_DEFAULT_LIMIT = _chunkVFLAMMIJcjs.BOUNDED_QUERY_MAX_LIMIT;
-var AGGREGATE_DATE_BUCKETS = ["month", "week", "year"];
-var DATE_ONLY_RE = /^(\d{4})-(\d{2})-(\d{2})$/;
-var DATETIME_RE = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(\.\d{1,9})?(Z|[+-]\d{2}:?\d{2})?$/;
-function parseDateInstant(v) {
-  if (typeof v !== "string") return null;
-  let m = v.match(DATE_ONLY_RE);
-  if (m) {
-    return _nullishCoalesce(validUtc(Number(m[1]), Number(m[2]), Number(m[3])), () => ( null));
-  }
-  m = v.match(DATETIME_RE);
-  if (m) {
-    const t = validUtc(Number(m[1]), Number(m[2]), Number(m[3]), Number(m[4]), Number(m[5]), Number(m[6]));
-    if (t === null) return null;
-    const zone = m[8];
-    if (zone === void 0 || zone === "Z") return t;
-    const sign = zone[0] === "-" ? -1 : 1;
-    const hh = Number(zone.slice(1, 3));
-    const mm = Number(zone.slice(zone.length - 2));
-    return t - sign * (hh * 60 + mm) * 6e4;
-  }
-  return null;
-}
-function validUtc(y, mo, d, h = 0, mi = 0, s = 0) {
-  const dt = new Date(Date.UTC(y, mo - 1, d, h, mi, s));
-  if (y >= 0 && y < 100) dt.setUTCFullYear(y);
-  if (dt.getUTCFullYear() !== y || dt.getUTCMonth() !== mo - 1 || dt.getUTCDate() !== d || dt.getUTCHours() !== h || dt.getUTCMinutes() !== mi || dt.getUTCSeconds() !== s) {
-    return null;
-  }
-  return dt.getTime();
-}
-var pad2 = (n) => String(n).padStart(2, "0");
-function isoWeekLabel(ms) {
-  const d = new Date(ms);
-  const dow = d.getUTCDay() || 7;
-  const S = d.getUTCFullYear() < 200 ? 100 : 0;
-  const thu = new Date(Date.UTC(d.getUTCFullYear() + S, d.getUTCMonth(), d.getUTCDate() + (4 - dow)));
-  const isoYear = thu.getUTCFullYear() - S;
-  const week = Math.ceil(((thu.getTime() - Date.UTC(thu.getUTCFullYear(), 0, 1)) / 864e5 + 1) / 7);
-  return `${isoYear}-W${pad2(week)}`;
-}
-function dateBucketLabel(value, bucket) {
-  if (value === null || value === void 0) return null;
-  const t = parseDateInstant(value);
-  if (t === null) return value;
-  const d = new Date(t);
-  switch (bucket) {
-    case "month":
-      return `${d.getUTCFullYear()}-${pad2(d.getUTCMonth() + 1)}`;
-    case "year":
-      return `${d.getUTCFullYear()}`;
-    case "week":
-      return isoWeekLabel(t);
-  }
-}
-var QUERY_RESOURCE_KEYS = (() => {
-  const s = /* @__PURE__ */ new Set();
-  for (const rec of _chunk5BDUMDAQcjs.CAPABILITIES) if (rec.operation === "query") s.add(rec.resource);
-  return s;
-})();
-var AGGREGATE_OPT_KEYS = ["groupBy", "sum", "top", "limit", "names", "acknowledgeUnscoped"];
-var OP_RE = /^([a-z0-9_]+)\.query$/;
-function num2(v) {
-  return typeof v === "number" && Number.isFinite(v) ? v : 0;
-}
-function parseOperationKey(operation, problems) {
-  if (typeof operation !== "string" || !OP_RE.test(operation)) {
-    problems.push(
-      `operation must be exactly "<planResourceKey>.query" (the resource's bounded query op \u2014 e.g. "billing_items.query"); a special op, a ".count" row, or any other verb is not an aggregate surface \u2014 see autotask_catalog for the exact plan keys`
-    );
-    return void 0;
-  }
-  const key = OP_RE.exec(operation)[1];
-  if (!QUERY_RESOURCE_KEYS.has(key)) {
-    problems.push(
-      `operation "${operation}": "${key}" has no query row in the capability registry (116 query surfaces) \u2014 see autotask_catalog for the exact plan keys`
-    );
-  }
-  return key;
-}
-function parseFilterConditions(filter, problems) {
-  if (filter === void 0 || filter === null) {
-    return [];
-  }
-  const conds = Array.isArray(filter) ? filter : filter.filter;
-  if (!Array.isArray(conds)) {
-    problems.push("filter must be the query-bag filter (a conditions array, or { filter: [...] })");
-    return [];
-  }
-  if (conds.length === 0) {
-    return [];
-  }
-  try {
-    return _chunkVFLAMMIJcjs.buildFilter.call(void 0, conds).filter;
-  } catch (err) {
-    problems.push(err instanceof _chunkVFLAMMIJcjs.AutotaskConfigError ? err.message : `filter must be the query-bag filter (13 operators; caps 500 OR-conditions / 1 UDF / 8000 chars); ${String(err)}`);
-    return [];
-  }
-}
-function checkOptsBag(opts, problems) {
-  if (opts !== void 0 && (typeof opts !== "object" || opts === null || Array.isArray(opts))) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-      `aggregate: opts must be the options object (got ${Array.isArray(opts) ? "an array" : typeof opts})`,
-      { operation: "operations.aggregate" }
-    );
-  }
-  for (const key of Object.keys(_nullishCoalesce(opts, () => ( {})))) {
-    if (!AGGREGATE_OPT_KEYS.includes(key)) {
-      problems.push(`unknown opts key "${key}" \u2014 the bag is closed: ${AGGREGATE_OPT_KEYS.join(", ")}`);
-    }
-  }
-  if (_optionalChain([opts, 'optionalAccess', _2 => _2.names]) !== void 0 && typeof opts.names !== "boolean") problems.push(`names must be a boolean (got ${typeof opts.names})`);
-  if (_optionalChain([opts, 'optionalAccess', _3 => _3.acknowledgeUnscoped]) !== void 0 && typeof opts.acknowledgeUnscoped !== "boolean") {
-    problems.push(`acknowledgeUnscoped must be a boolean (got ${typeof opts.acknowledgeUnscoped})`);
-  }
-}
-function checkSumFields(name, fields, problems) {
-  if (fields === void 0) return [];
-  if (!Array.isArray(fields) || fields.length === 0 || fields.some((f) => typeof f !== "string" || f.trim() === "")) {
-    problems.push(`${name} must be a non-empty array of exact vendor field names (discover them via operations.fieldCatalog)`);
-    return [];
-  }
-  return fields;
-}
-function parseGroupSpec(f, oracles, known, problems) {
-  const { resourceKey, dateSets } = oracles;
-  const at = f.indexOf("@");
-  if (at === -1) return { name: f, base: f };
-  const base = f.slice(0, at);
-  const suffix = f.slice(at + 1);
-  if (!AGGREGATE_DATE_BUCKETS.includes(suffix)) {
-    problems.push(`groupBy: "${f}": unknown bucket suffix "${suffix}" \u2014 the closed set is month | week | year (the suffix applies to date-typed fields only)`);
-    return void 0;
-  }
-  if (known !== void 0 && !known.includes(base)) return void 0;
-  if (dateSets === void 0 || !dateSets.includes(base)) {
-    problems.push(`groupBy: "${f}": "${base}" is not a date field of ${resourceKey} (the @month/@week/@year bucket suffix applies to date-typed fields of the resource's vendored model \u2014 exact vendor field names via operations.fieldCatalog)`);
-    return void 0;
-  }
-  return { name: f, base, bucket: suffix };
-}
-function parseGroupBy(opts, oracles, known, problems) {
-  const groupBy = [];
-  if (opts.groupBy === void 0) return groupBy;
-  if (!Array.isArray(opts.groupBy) || opts.groupBy.length === 0 || opts.groupBy.some((f) => typeof f !== "string" || f.trim() === "")) {
-    problems.push("groupBy must be a non-empty array of exact vendor field names (a date-typed field may carry the closed bucket suffix @month | @week | @year \u2014 discover them via operations.fieldCatalog)");
-    return groupBy;
-  }
-  for (const f of opts.groupBy) {
-    const spec = parseGroupSpec(f, oracles, known, problems);
-    if (spec !== void 0) groupBy.push(spec);
-  }
-  return groupBy;
-}
-function parseTopAndLimit(opts, problems) {
-  let top = AGGREGATE_DEFAULT_TOP;
-  if (opts.top !== void 0) {
-    if (!Number.isInteger(opts.top)) {
-      problems.push(`top must be an integer (got ${String(opts.top)})`);
-    } else {
-      top = Math.min(Math.max(opts.top, 1), AGGREGATE_TOP_MAX);
-    }
-  }
-  let limit = AGGREGATE_DEFAULT_LIMIT;
-  if (opts.limit !== void 0) {
-    if (!Number.isInteger(opts.limit)) {
-      problems.push(`limit must be an integer (got ${String(opts.limit)})`);
-    } else {
-      limit = Math.min(Math.max(opts.limit, 1), _chunkVFLAMMIJcjs.BOUNDED_QUERY_MAX_LIMIT);
-    }
-  }
-  return { top, limit };
-}
-async function checkFieldNames(resourceKey, conditions, opts, problems) {
-  const record = resourceKey === void 0 ? void 0 : _chunk5BDUMDAQcjs.CAPABILITIES.find((r) => r.resource === resourceKey && r.operation === "query");
-  if (record === void 0) return void 0;
-  const strings = (v) => Array.isArray(v) ? v.filter((f) => typeof f === "string" && f.trim() !== "") : [];
-  const groupBy = strings(opts.groupBy);
-  const found = await _chunkVFLAMMIJcjs.findUnknownFieldNames.call(void 0, record, void 0, {
-    filter: _chunkVFLAMMIJcjs.collectFilterFieldNames.call(void 0, conditions, resourceKey),
-    groupBy: groupBy.map((f) => f.split("@")[0]),
-    sum: strings(opts.sum)
-  });
-  if (found === void 0) return void 0;
-  const refuse2 = (key, entry, base) => {
-    const named = entry === base ? `"${base}"` : `"${entry}": "${base}"`;
-    problems.push(`${key}: ${named} is not a field of ${resourceKey} \u2014 a hallucinated field is a shape error, not a silent fold-miss (exact vendor field names via operations.fieldCatalog; checked against ${found.authority})`);
-  };
-  for (const f of found.unknown["filter"]) refuse2("filter", f, f);
-  for (const f of groupBy) {
-    const base = f.split("@")[0];
-    if (found.unknown["groupBy"].includes(base)) refuse2("groupBy", f, base);
-  }
-  for (const f of found.unknown["sum"]) refuse2("sum", f, f);
-  return found.known;
-}
-async function validateAggregate(operation, filter, opts) {
-  const problems = [];
-  const resourceKey = parseOperationKey(operation, problems);
-  const conditions = parseFilterConditions(filter, problems);
-  checkOptsBag(opts, problems);
-  const oracles = {
-    resourceKey,
-    dateSets: resourceKey !== void 0 ? _chunkVFLAMMIJcjs.MODEL_DATE_FIELDS[resourceKey] : void 0
-  };
-  const known = await checkFieldNames(resourceKey, conditions, opts, problems);
-  const groupBy = parseGroupBy(opts, oracles, known, problems);
-  const sum = checkSumFields("sum", opts.sum, problems);
-  const { top, limit } = parseTopAndLimit(opts, problems);
-  if (problems.length > 0) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-      `aggregate: ${problems.length} problem(s) found pre-request (zero wire was issued)
-- ` + problems.join("\n- "),
-      { operation: "operations.aggregate" }
-    );
-  }
-  if ((groupBy.length > 0 || sum.length > 0) && conditions.length === 0 && opts.acknowledgeUnscoped !== true) {
-    throw new (0, _chunkVFLAMMIJcjs.ScopeRequiredError)(operation, { threshold: _chunkVFLAMMIJcjs.UNSCOPED_WALK_THRESHOLD }, "empty-filter");
-  }
-  return { resourceKey, conditions, groupBy, sum, top, limit };
-}
-function foldGroups(items, v) {
-  const groups = /* @__PURE__ */ new Map();
-  for (const item of items) {
-    const key = {};
-    const values = [];
-    for (const spec of v.groupBy) {
-      const raw = item[spec.base] === void 0 ? null : item[spec.base];
-      const value = spec.bucket === void 0 ? raw : dateBucketLabel(raw, spec.bucket);
-      key[spec.name] = value;
-      values.push(value);
-    }
-    const keyOrder = JSON.stringify(values);
-    let g = groups.get(keyOrder);
-    if (g === void 0) {
-      g = { key, keyOrder, count: 0, ...v.sum.length > 0 ? { sums: {} } : {} };
-      groups.set(keyOrder, g);
-    }
-    g.count += 1;
-    if (g.sums !== void 0) {
-      for (const f of v.sum) g.sums[f] = (_nullishCoalesce(g.sums[f], () => ( 0))) + num2(item[f]);
-    }
-  }
-  return [...groups.values()].sort((a, b) => b.count - a.count || (a.keyOrder < b.keyOrder ? -1 : a.keyOrder > b.keyOrder ? 1 : 0));
-}
-async function aggregate(client, operation, filter, opts = {}) {
-  const v = await validateAggregate(operation, filter, opts);
-  const holder = client[_chunkVFLAMMIJcjs.camelKey.call(void 0, v.resourceKey)];
-  if (holder === void 0) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(`aggregate: the client exposes no accessor for resource "${v.resourceKey}"`, {
-      operation: "operations.aggregate",
-      suggestedAction: "Rebuild the client from the SDK build that ships this registry (the resource set is pinned by the plan)."
-    });
-  }
-  const wireFilter = v.conditions.length === 0 ? void 0 : v.conditions;
-  if (v.groupBy.length === 0 && v.sum.length === 0) {
-    const raw = await holder.count({ filter: wireFilter });
-    const sentinel = typeof raw === "object" && raw !== null && "count" in raw ? raw : { count: raw };
-    const result2 = { mode: "count", count: sentinel.count, blind: sentinel.blindSurface !== void 0, truncated: false };
-    if (sentinel.blindSurface !== void 0) result2.blindSurface = sentinel.blindSurface;
-    if (sentinel.emptyReason !== void 0) result2.emptyReason = sentinel.emptyReason;
-    return result2;
-  }
-  const res = await holder.queryBounded({ filter: wireFilter, limit: v.limit });
-  const sorted = foldGroups(res.items, v);
-  const top = sorted.slice(0, v.top);
-  const label = _chunkVFLAMMIJcjs.readNamesOpt.call(void 0, client, opts.names, "aggregate");
-  const labelled = !label || v.groupBy.length === 0 ? void 0 : await _chunkVFLAMMIJcjs.labelRows.call(void 0, client, v.resourceKey, top.map((g) => g.key));
-  const result = {
-    mode: v.groupBy.length > 0 ? "group" : "sum",
-    groups: top.map((g, i) => ({ key: _nullishCoalesce(_optionalChain([labelled, 'optionalAccess', _4 => _4.rows, 'access', _5 => _5[i]]), () => ( g.key)), count: g.count, ...g.sums !== void 0 ? { sums: g.sums } : {} })),
-    totalGroups: sorted.length,
-    groupsTruncated: sorted.length > top.length,
-    totalScanned: res.fetched,
-    hasMore: res.hasMore,
-    truncated: res.hasMore
-    // issue #287 (D6): the walk hit its limit — groups may be incomplete
-  };
-  if (res.blindSurface !== void 0) result.blindSurface = res.blindSurface;
-  if (res.emptyReason !== void 0) result.emptyReason = res.emptyReason;
-  if (res.relationNote !== void 0) result.relationNote = res.relationNote;
-  if (_optionalChain([labelled, 'optionalAccess', _6 => _6.names]) !== void 0) result.names = labelled.names;
-  return result;
-}
-
-// src/operations/revenueRollup.ts
-var OP = "operations.revenueRollup";
-var PAGE = 500;
-var CONCURRENCY = 3;
-var DEFAULT_BUDGET = 90;
-var DEFAULT_BUDGET_NON_CHARGEABLE = 150;
-var BUDGET_CAP = 200;
-var TOP_MAX = 100;
-var SCOPE_IDS_MAX = 100;
-var TENANT_HOURLY_LIMIT = 1e4;
-var DEFAULT_GROUP_BY = ["vertical", "contractType"];
-var DEFAULT_CONTRACT_TYPE_RE = /^\s*(recurring|fixed)\b/i;
-var CONTRACTS_PATH = "/V1.0/Contracts";
-var COMPANIES_PATH = "/V1.0/Companies";
-var BILLING_ITEMS_PATH = "/V1.0/BillingItems";
-var LINE_TYPE_FIELDS = ["billingItemType", "timeEntryID", "expenseItemID", ..._chunkVFLAMMIJcjs.CHARGE_LINE_FKS, ..._chunkVFLAMMIJcjs.SERVICE_LINE_FKS];
-var isLabour = (line) => _chunkVFLAMMIJcjs.billingLineType.call(void 0, line) === "labour";
-function picklistKey(c, dim, path, field, raw, missing) {
-  const id = _chunkVFLAMMIJcjs.num.call(void 0, raw);
-  if (id === 0) return { id: null, label: missing };
-  const label = _optionalChain([c, 'access', _7 => _7.labels, 'access', _8 => _8[path], 'optionalAccess', _9 => _9.get, 'call', _10 => _10(field), 'optionalAccess', _11 => _11.get, 'call', _12 => _12(id)]);
-  if (label === void 0) {
-    c.unlabelled.add(`${dim}: ${field} value ${id} has no label on the live ${path} picklist (id-only)`);
-    return { id };
-  }
-  return { id, label };
-}
-var DIMENSIONS = {
-  vertical: {
-    joins: { companies: ["marketSegmentID"] },
-    picklist: COMPANIES_PATH,
-    key: (c) => picklistKey(c, "vertical", COMPANIES_PATH, "marketSegmentID", _optionalChain([c, 'access', _13 => _13.company, 'optionalAccess', _14 => _14["marketSegmentID"]]), "unassigned")
-  },
-  contractType: {
-    key: (c) => picklistKey(c, "contractType", CONTRACTS_PATH, "contractType", c.contract["contractType"], "none")
-  },
-  contractCategory: {
-    key: (c) => picklistKey(c, "contractCategory", CONTRACTS_PATH, "contractCategory", c.contract["contractCategory"], "uncategorised")
-  },
-  company: {
-    joins: { companies: ["companyName"] },
-    key: (c) => ({ id: _chunkVFLAMMIJcjs.num.call(void 0, c.line["companyID"]), name: String(_nullishCoalesce(_optionalChain([c, 'access', _15 => _15.company, 'optionalAccess', _16 => _16["companyName"]]), () => ( ""))) })
-  },
-  month: {
-    key: (c) => ({ id: c.invoice.month })
-  },
-  billingItemKind: {
-    lineFields: LINE_TYPE_FIELDS,
-    picklist: BILLING_ITEMS_PATH,
-    key: (c) => _chunkVFLAMMIJcjs.num.call(void 0, c.line["billingItemType"]) === 0 ? { id: _chunkVFLAMMIJcjs.billingLineType.call(void 0, c.line), label: _chunkVFLAMMIJcjs.billingLineType.call(void 0, c.line) } : picklistKey(c, "billingItemKind", BILLING_ITEMS_PATH, "billingItemType", c.line["billingItemType"], "other")
-  },
-  contract: {
-    joins: { contracts: ["contractName"] },
-    key: (c) => ({ id: _chunkVFLAMMIJcjs.num.call(void 0, c.line["contractID"]), name: String(_nullishCoalesce(c.contract["contractName"], () => ( ""))) })
-  },
-  // Per line (no contract-pointer fallback): association → level2 (the Line of Business, `name`) + level1 (the division).
-  lineOfBusiness: {
-    lineFields: ["organizationalLevelAssociationID"],
-    joins: { organizationalLevelAssociations: [], organizationalLevel1s: [], organizationalLevel2s: [] },
-    unresolved: "unresolvedAssociations",
-    key: (c) => {
-      const id = _chunkVFLAMMIJcjs.num.call(void 0, c.line["organizationalLevelAssociationID"]);
-      if (id === 0) return { id: null, label: "no LOB assigned" };
-      const a = c.joined.organizationalLevelAssociations.get(id);
-      const l1 = c.joined.organizationalLevel1s.get(_chunkVFLAMMIJcjs.num.call(void 0, _optionalChain([a, 'optionalAccess', _17 => _17["organizationalLevel1ID"]])));
-      const l2 = c.joined.organizationalLevel2s.get(_chunkVFLAMMIJcjs.num.call(void 0, _optionalChain([a, 'optionalAccess', _18 => _18["organizationalLevel2ID"]])));
-      if (l1 === void 0 || l2 === void 0) return "unresolvedAssociations";
-      return { id, name: String(_nullishCoalesce(l2["name"], () => ( ""))), division: String(_nullishCoalesce(l1["name"], () => ( ""))) };
-    }
-  },
-  // Labour lines only; a non-labour line (or a labour line with no time entry, e.g. an adjustment) is "n/a".
-  resource: {
-    lineFields: LINE_TYPE_FIELDS,
-    joins: { timeEntries: [], resources: [] },
-    unresolved: "unresolvedTimeEntries",
-    key: (c) => {
-      const te = _chunkVFLAMMIJcjs.num.call(void 0, c.line["timeEntryID"]);
-      if (!isLabour(c.line) || te === 0) return { id: null, label: "n/a" };
-      const id = _chunkVFLAMMIJcjs.num.call(void 0, _optionalChain([c, 'access', _19 => _19.joined, 'access', _20 => _20.timeEntries, 'access', _21 => _21.get, 'call', _22 => _22(te), 'optionalAccess', _23 => _23["resourceID"]]));
-      const r = c.joined.resources.get(id);
-      if (r === void 0) return "unresolvedTimeEntries";
-      return { id, name: `${String(_nullishCoalesce(r["firstName"], () => ( "")))} ${String(_nullishCoalesce(r["lastName"], () => ( "")))}`.trim() };
-    }
-  },
-  billingCode: {
-    lineFields: ["billingCodeID"],
-    joins: { billingCodes: [] },
-    unresolved: "unresolvedBillingCodes",
-    key: (c) => {
-      const id = _chunkVFLAMMIJcjs.num.call(void 0, c.line["billingCodeID"]);
-      if (id === 0) return { id: null, label: "none" };
-      const b = c.joined.billingCodes.get(id);
-      return b === void 0 ? "unresolvedBillingCodes" : { id, name: String(_nullishCoalesce(b["name"], () => ( ""))) };
-    }
-  }
-};
-var fk = (rows, field) => [...rows].map((r) => _chunkVFLAMMIJcjs.num.call(void 0, r[field]));
-var ONE_CHUNK = (idChunks) => Math.min(1, idChunks);
-var JOINS = {
-  contracts: {
-    make: (http) => new (0, _chunkVFLAMMIJcjs.ContractsResource)(http, PAGE),
-    fields: ["id", "contractType", "contractCategory"],
-    ids: (lines) => fk(lines, "contractID")
-  },
-  companies: {
-    make: (http) => new (0, _chunkVFLAMMIJcjs.CompaniesResource)(http, PAGE),
-    fields: ["id"],
-    ids: (lines) => fk(lines, "companyID")
-  },
-  organizationalLevelAssociations: {
-    make: (http) => new (0, _chunkVFLAMMIJcjs.OrganizationalLevelAssociationsResource)(http, PAGE),
-    fields: ["id", "organizationalLevel1ID", "organizationalLevel2ID"],
-    ids: (lines) => fk(lines, "organizationalLevelAssociationID")
-  },
-  organizationalLevel1s: {
-    make: (http) => new (0, _chunkVFLAMMIJcjs.OrganizationalLevel1sResource)(http, PAGE),
-    fields: ["id", "name"],
-    ids: (_, j) => fk(j["organizationalLevelAssociations"].values(), "organizationalLevel1ID"),
-    chunks: ONE_CHUNK
-  },
-  organizationalLevel2s: {
-    make: (http) => new (0, _chunkVFLAMMIJcjs.OrganizationalLevel2sResource)(http, PAGE),
-    fields: ["id", "name"],
-    ids: (_, j) => fk(j["organizationalLevelAssociations"].values(), "organizationalLevel2ID"),
-    chunks: ONE_CHUNK
-  },
-  timeEntries: {
-    make: (http) => new (0, _chunkVFLAMMIJcjs.TimeEntriesResource)(http, PAGE),
-    fields: ["id", "resourceID"],
-    ids: (lines) => fk(lines.filter(isLabour), "timeEntryID"),
-    // One time entry per labour line: the line count is the upper bound (labour share unknown pre-walk).
-    chunks: (_, lines) => pages(lines)
-  },
-  resources: {
-    make: (http, client) => new (0, _chunkVFLAMMIJcjs.ResourcesResource)(http, client.config, PAGE),
-    fields: ["id", "firstName", "lastName"],
-    ids: (_, j) => fk(j["timeEntries"].values(), "resourceID"),
-    chunks: ONE_CHUNK
-  },
-  billingCodes: {
-    make: (http) => new (0, _chunkVFLAMMIJcjs.BillingCodesResource)(http, PAGE),
-    fields: ["id", "name"],
-    ids: (lines) => fk(lines, "billingCodeID")
-  }
-};
-var LINE_FIELDS = ["id", "invoiceID", "companyID", "contractID", "totalAmount", "internalCurrencyTotalAmount", "extendedPrice", "internalCurrencyExtendedPrice"];
-var OPT_KEYS = ["companyIDs", "ownerResourceID", "contractIDs", "tenantWide", "dateFrom", "dateTo", "contractTypes", "contractCategories", "groupBy", "top", "maxVendorCalls", "includeNonChargeable"];
-var NC_LINE_FIELDS = ["nonBillable", "quantity", ...LINE_TYPE_FIELDS];
-var SCOPE_KEYS = ["companyIDs", "ownerResourceID", "contractIDs", "tenantWide"];
-var isPosInt = (v) => Number.isSafeInteger(v) && v > 0;
-function checkIdList(name, v, problems) {
-  if (!Array.isArray(v) || v.length === 0 || v.length > SCOPE_IDS_MAX || !v.every(isPosInt)) {
-    problems.push(`${name} must be a non-empty array of at most ${SCOPE_IDS_MAX} positive integer ids`);
-    return void 0;
-  }
-  return [...new Set(v)].sort((a, b) => a - b);
-}
-function checkSelector(name, v, problems) {
-  if (v === void 0) return void 0;
-  if (!Array.isArray(v) || v.length === 0 || !v.every((x) => isPosInt(x) || typeof x === "string" && x.trim() !== "")) {
-    problems.push(`${name} must be a non-empty array of picklist ids or labels`);
-    return void 0;
-  }
-  return v;
-}
-function checkInt(name, v, def, max, problems) {
-  if (v === void 0) return def;
-  if (!Number.isInteger(v) || v < 1 || v > max) {
-    problems.push(`${name} must be an integer 1..${max} (got ${String(v)})`);
-    return def;
-  }
-  return v;
-}
-function validate(opts) {
-  if (typeof opts !== "object" || opts === null || Array.isArray(opts)) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)("revenueRollup: opts must be the options object { <scope>, dateFrom, dateTo, ... } (zero wire was issued)", { operation: OP });
-  }
-  const o = opts;
-  const problems = [];
-  for (const k of Object.keys(o)) if (!OPT_KEYS.includes(k)) problems.push(`unknown opts key "${k}" \u2014 the bag is closed: ${OPT_KEYS.join(", ")}`);
-  const given = SCOPE_KEYS.filter((k) => o[k] !== void 0);
-  if (given.length !== 1) {
-    problems.push(given.length === 0 ? "a scope is required: exactly one of companyIDs, ownerResourceID, contractIDs, or tenantWide: true" : `exactly one scope key is allowed (got ${given.join(", ")})`);
-  }
-  const scopeKind = _nullishCoalesce(given[0], () => ( "tenantWide"));
-  let scopeIds;
-  if (given.length === 1) {
-    if (scopeKind === "companyIDs" || scopeKind === "contractIDs") scopeIds = checkIdList(scopeKind, o[scopeKind], problems);
-    if (scopeKind === "ownerResourceID" && !isPosInt(o.ownerResourceID)) problems.push("ownerResourceID must be a positive integer resource id");
-    if (scopeKind === "tenantWide" && o.tenantWide !== true) problems.push("tenantWide must be exactly true");
-  }
-  const { dateFrom, dateTo } = o;
-  if (!_chunkVFLAMMIJcjs.isDateYMD.call(void 0, dateFrom) || !_chunkVFLAMMIJcjs.isDateYMD.call(void 0, dateTo)) {
-    problems.push("dateFrom and dateTo are both required as YYYY-MM-DD (the window is inclusive, whole UTC days)");
-  } else if (dateFrom > dateTo) {
-    problems.push(`dateFrom ${dateFrom} is after dateTo ${dateTo}`);
-  } else if (_chunkVFLAMMIJcjs.monthsInWindow.call(void 0, dateFrom, dateTo) > _chunkVFLAMMIJcjs.PROFITABILITY_MAX_WINDOW_MONTHS) {
-    problems.push(`the window spans ${_chunkVFLAMMIJcjs.monthsInWindow.call(void 0, dateFrom, dateTo)} months; the cap is ${_chunkVFLAMMIJcjs.PROFITABILITY_MAX_WINDOW_MONTHS}`);
-  }
-  let groupBy = [...DEFAULT_GROUP_BY];
-  if (o.groupBy !== void 0) {
-    const g = o.groupBy;
-    if (!Array.isArray(g) || g.length === 0 || new Set(g).size !== g.length) {
-      problems.push(`groupBy must be a non-empty array of distinct dimensions: ${Object.keys(DIMENSIONS).join(", ")}`);
-    } else {
-      for (const d of g) if (!Object.hasOwn(DIMENSIONS, d)) problems.push(`unknown groupBy dimension "${String(d)}" \u2014 the dimensions are: ${Object.keys(DIMENSIONS).join(", ")}`);
-      groupBy = g;
-    }
-  }
-  const v = {
-    dateFrom,
-    dateTo,
-    scopeKind,
-    scopeIds,
-    ownerResourceID: scopeKind === "ownerResourceID" ? o.ownerResourceID : void 0,
-    contractTypes: checkSelector("contractTypes", o.contractTypes, problems),
-    contractCategories: checkSelector("contractCategories", o.contractCategories, problems),
-    groupBy,
-    top: checkInt("top", o.top, TOP_MAX, TOP_MAX, problems),
-    budget: checkInt("maxVendorCalls", o.maxVendorCalls, o.includeNonChargeable === true ? DEFAULT_BUDGET_NON_CHARGEABLE : DEFAULT_BUDGET, BUDGET_CAP, problems),
-    nonChargeable: o.includeNonChargeable === true
-  };
-  if (o.includeNonChargeable !== void 0 && typeof o.includeNonChargeable !== "boolean") problems.push("includeNonChargeable must be a boolean");
-  if (problems.length > 0) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(`revenueRollup: ${problems.length} problem(s) found pre-request (zero wire was issued)
-- ${problems.join("\n- ")}`, { operation: OP });
-  }
-  return v;
-}
-function resolveSelector(name, sel, values) {
-  const out = /* @__PURE__ */ new Map();
-  const misses = [];
-  for (const s of sel) {
-    const hits = typeof s === "number" ? values.has(s) ? [s] : [] : [...values].filter(([, l]) => l.trim().toLowerCase() === s.trim().toLowerCase()).map(([id]) => id);
-    if (hits.length === 0) misses.push(JSON.stringify(s));
-    for (const h of hits) out.set(h, values.get(h));
-  }
-  if (misses.length > 0) throw unmatched(name, `${misses.join(", ")} matched no live value`, values);
-  return out;
-}
-function unmatched(name, what, values) {
-  const live = [...values].map(([id, l]) => `${id} ${l}`).join("; ") || "(the picklist serves no values)";
-  return new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(`revenueRollup: ${name}: ${what}. Live values (id label): ${live}`, {
-    operation: OP,
-    suggestedAction: `Pass ${name} as ids or exact labels from the live list.`
-  });
-}
-var sortedRecord = (m) => Object.fromEntries([...m].sort((a, b) => a[0] - b[0]).map(([id, l]) => [String(id), l]));
-var chunk = (a) => {
-  const out = [];
-  for (let i = 0; i < a.length; i += PAGE) out.push(a.slice(i, i + PAGE));
-  return out;
-};
-var byId = (rows) => [...new Map(rows.map((r) => [_chunkVFLAMMIJcjs.num.call(void 0, r["id"]), r])).values()];
-var cents = (v) => Math.round(_chunkVFLAMMIJcjs.num.call(void 0, v) * 100);
-var revC = (line) => cents(_chunkVFLAMMIJcjs.internalAmount.call(void 0, line, "internalCurrencyTotalAmount", "totalAmount"));
-var extC = (line) => cents(_chunkVFLAMMIJcjs.internalAmount.call(void 0, line, "internalCurrencyExtendedPrice", "extendedPrice"));
-var INTERNAL_FIELDS = ["internalCurrencyTotalAmount", "internalCurrencyExtendedPrice"];
-var lacksInternal = (line) => INTERNAL_FIELDS.some((k) => !Number.isFinite(line[k]));
-var money = (c) => c / 100;
-var pages = (n) => Math.ceil(n / PAGE);
-async function collect(res, filter, includeFields) {
-  const out = [];
-  for await (const r of res.query({ filter, includeFields, maxRecords: PAGE, names: false })) out.push(r);
-  return out;
-}
-function blindCount() {
-  return new (0, _chunkVFLAMMIJcjs.AutotaskError)("revenueRollup: a gate count came back blind (unknown, not zero); the roll-up cannot be sized", {
-    code: "INVALID_RESPONSE",
-    category: "server",
-    operation: OP,
-    details: { reason: "blind_count" },
-    suggestedAction: "Check the API user can see invoices and billing items (operations.blindSurfaces), then retry."
-  });
-}
-function countMismatch(what, streamed, counted, rows) {
-  const rowNote = rows !== void 0 && rows !== streamed ? ` (${rows} rows)` : "";
-  return new (0, _chunkVFLAMMIJcjs.AutotaskError)(`revenueRollup: the ${what} stream returned ${streamed} distinct ids${rowNote} but the gate count was ${counted} (the data changed mid-walk or a page dropped rows); the fold was discarded`, {
-    code: "INVALID_RESPONSE",
-    category: "server",
-    operation: OP,
-    details: { reason: "count_mismatch", stream: what, streamed, counted },
-    suggestedAction: "Retry the call."
-  });
-}
-function budgetError(message, details, suggestedAction) {
-  return new (0, _chunkVFLAMMIJcjs.AutotaskError)(message, { code: "BUDGET_EXCEEDED", category: "policy", operation: OP, details, suggestedAction });
-}
-function lastMonthsFrom(dateTo, months) {
-  return new Date(Date.UTC(Number(dateTo.slice(0, 4)), Number(dateTo.slice(5, 7)) - months, 1)).toISOString().slice(0, 10);
-}
-async function revenueRollup(client, opts) {
-  const v = validate(opts);
-  const raw = client.http;
-  let calls = 0;
-  let estimate = 0;
-  const sizingMin = [.../* @__PURE__ */ new Set([CONTRACTS_PATH, ...v.groupBy.flatMap((d) => DIMENSIONS[d].picklist ? [DIMENSIONS[d].picklist] : [])])].length + (v.scopeKind === "ownerResourceID" ? 1 : 0) + 2 + (v.nonChargeable ? 1 : 0);
-  const http = Object.create(raw);
-  http.request = (o) => {
-    if (calls >= v.budget && estimate === 0) {
-      throw budgetError(
-        `revenueRollup: the vendor-call budget of ${v.budget} is below the sizing overhead (labels, scope and count calls: at least ${sizingMin} for this call); the roll-up could not be sized and no stream was read. Retry with a higher maxVendorCalls (cap ${BUDGET_CAP}); the refusal then names the full estimate.`,
-        { phase: "estimate", estimate: sizingMin, budget: v.budget, vendorCalls: calls, suggestions: [{ maxVendorCalls: sizingMin }] },
-        `Pass maxVendorCalls >= ${sizingMin} (cap ${BUDGET_CAP}).`
-      );
-    }
-    if (calls >= v.budget) {
-      throw budgetError(
-        `revenueRollup: the vendor-call budget of ${v.budget} was exhausted mid-walk (pre-walk estimate ${estimate}); the partial fold was discarded. Retry with a higher maxVendorCalls (cap ${BUDGET_CAP}) or a shorter window / a scope.`,
-        { phase: "walk", budget: v.budget, vendorCalls: calls, estimate },
-        `Pass maxVendorCalls > ${v.budget} (cap ${BUDGET_CAP}), a later dateFrom, or a scope.`
-      );
-    }
-    calls += 1;
-    return raw.request(o);
-  };
-  const groupDims = v.groupBy.map((d) => DIMENSIONS[d]);
-  const paths = [.../* @__PURE__ */ new Set([CONTRACTS_PATH, ...groupDims.flatMap((d) => d.picklist ? [d.picklist] : [])])];
-  const labels = {};
-  for (const p of paths) labels[p] = await _chunkVFLAMMIJcjs.readPicklists.call(void 0, http, p, OP);
-  const contractLabels = labels[CONTRACTS_PATH];
-  const typeValues = _nullishCoalesce(contractLabels.get("contractType"), () => ( /* @__PURE__ */ new Map()));
-  const inTypes = v.contractTypes ? resolveSelector("contractTypes", v.contractTypes, typeValues) : new Map([...typeValues].filter(([, l]) => DEFAULT_CONTRACT_TYPE_RE.test(l)));
-  if (inTypes.size === 0) throw unmatched("contractTypes", "no live contract type label starts with 'Recurring' or 'Fixed' (the default)", typeValues);
-  const inCategories = v.contractCategories ? resolveSelector("contractCategories", v.contractCategories, _nullishCoalesce(contractLabels.get("contractCategory"), () => ( /* @__PURE__ */ new Map()))) : void 0;
-  let scopeIds = v.scopeIds;
-  if (v.scopeKind === "ownerResourceID") {
-    const owned = /* @__PURE__ */ new Set();
-    for await (const c of new (0, _chunkVFLAMMIJcjs.CompaniesResource)(http, PAGE).query({ filter: [{ field: "ownerResourceID", op: "eq", value: v.ownerResourceID }], includeFields: ["id"], maxRecords: PAGE, names: false })) {
-      const id = _chunkVFLAMMIJcjs.num.call(void 0, c.id);
-      if (id > 0) owned.add(id);
-      if (owned.size > SCOPE_IDS_MAX) break;
-    }
-    scopeIds = [...owned].sort((a, b) => a - b);
-    if (scopeIds.length === 0 || scopeIds.length > SCOPE_IDS_MAX) {
-      throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-        `revenueRollup: ownerResourceID ${v.ownerResourceID} resolves to ${scopeIds.length > SCOPE_IDS_MAX ? `more than ${SCOPE_IDS_MAX}` : 0} companies (companies.query; 1..${SCOPE_IDS_MAX} supported)`,
-        { operation: OP, suggestedAction: "Pass companyIDs explicitly, or tenantWide: true." }
-      );
-    }
-  }
-  const scopeCond = scopeIds === void 0 ? [] : [{ field: v.scopeKind === "contractIDs" ? "contractID" : "companyID", op: "in", value: scopeIds }];
-  const invoices = new (0, _chunkVFLAMMIJcjs.InvoicesResource)(http, PAGE);
-  const billingItems = new (0, _chunkVFLAMMIJcjs.BillingItemsResource)(http, PAGE);
-  const windowOn = (field) => [{ field, op: "gte", value: v.dateFrom }, { field, op: "lt", value: _chunkVFLAMMIJcjs.dayAfter.call(void 0, v.dateTo) }];
-  const invoiceFilter = (voided2) => [...windowOn("invoiceDateTime"), { field: "isVoided", op: "eq", value: voided2 }];
-  const withVoided = v.scopeKind !== "contractIDs";
-  const voidedFilter = [...invoiceFilter(true), ...scopeIds !== void 0 && withVoided ? [{ field: "companyID", op: "in", value: scopeIds }] : []];
-  const nInvoices = await invoices.count({ filter: invoiceFilter(false) });
-  const nLines = await billingItems.count({ filter: [...windowOn("itemDate"), { field: "invoiceID", op: "exist" }, ...scopeCond] });
-  const uninvoicedFilter = [{ field: "invoiceID", op: "notExist" }, ...windowOn("itemDate"), ...scopeCond];
-  const nUninvoiced = v.nonChargeable ? await billingItems.count({ filter: uninvoicedFilter }) : 0;
-  if (typeof nInvoices !== "number" || typeof nLines !== "number" || typeof nUninvoiced !== "number") throw blindCount();
-  const joinsNeeded = Object.keys(JOINS).filter((j) => j === "contracts" || groupDims.some((d) => _optionalChain([d, 'access', _24 => _24.joins, 'optionalAccess', _25 => _25[j]])));
-  const chunks = pages(nInvoices);
-  const linePages = chunks + Math.max(0, pages(nLines) - 1) + chunks;
-  const uninvoicedPages = v.nonChargeable ? Math.max(1, pages(nUninvoiced)) : 0;
-  const idChunks = pages(Math.min(nLines + nUninvoiced, nInvoices));
-  const joinChunks = joinsNeeded.reduce((s, j) => {
-    const spec = JOINS[j];
-    return s + ("chunks" in spec ? spec.chunks(idChunks, nLines + nUninvoiced) : idChunks);
-  }, 0);
-  const fixed = calls + (withVoided ? 1 : 0);
-  estimate = fixed + Math.max(1, chunks) + linePages + uninvoicedPages + joinChunks;
-  if (estimate > v.budget) throw refusal(v, estimate, fixed, scopeIds, joinsNeeded.length);
-  const invoiceRows = await collect(invoices, invoiceFilter(false), ["id", "invoiceTotal", "invoiceDateTime", "companyID"]);
-  const invoiceById = /* @__PURE__ */ new Map();
-  for (const r of invoiceRows) {
-    invoiceById.set(_chunkVFLAMMIJcjs.num.call(void 0, r["id"]), { total: cents(r["invoiceTotal"]), month: String(_nullishCoalesce(r["invoiceDateTime"], () => ( ""))).slice(0, 7), companyID: _chunkVFLAMMIJcjs.num.call(void 0, r["companyID"]) });
-  }
-  if (invoiceById.size !== nInvoices) throw countMismatch("invoice", invoiceById.size, nInvoices, invoiceRows.length);
-  const voided = withVoided ? byId(await collect(invoices, voidedFilter, ["id", "invoiceTotal"])) : void 0;
-  const lineFields = [.../* @__PURE__ */ new Set([...LINE_FIELDS, ...groupDims.flatMap((d) => _nullishCoalesce(d.lineFields, () => ( []))), ...v.nonChargeable ? NC_LINE_FIELDS : []])];
-  const ids = [...invoiceById.keys()].sort((a, b) => a - b);
-  const lines = (await client.batch(async (c) => {
-    const filter = [{ field: "invoiceID", op: "in", value: c }, ...scopeCond];
-    const n = await billingItems.count({ filter });
-    if (typeof n !== "number") throw blindCount();
-    const rows = byId(await collect(billingItems, filter, lineFields));
-    if (rows.length !== n) throw countMismatch("line", rows.length, n);
-    return rows;
-  }, chunk(ids), { concurrency: CONCURRENCY })).flat();
-  const orphan = lines.find((l) => !invoiceById.has(_chunkVFLAMMIJcjs.num.call(void 0, l["invoiceID"])));
-  if (orphan !== void 0) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskError)(`revenueRollup: billing line ${_chunkVFLAMMIJcjs.num.call(void 0, orphan["id"])} belongs to invoice ${_chunkVFLAMMIJcjs.num.call(void 0, orphan["invoiceID"])}, which is not among the ${invoiceById.size} streamed invoices; the fold was discarded`, {
-      code: "INVALID_RESPONSE",
-      category: "server",
-      operation: OP,
-      details: { reason: "orphan_line", lineID: _chunkVFLAMMIJcjs.num.call(void 0, orphan["id"]), invoiceID: _chunkVFLAMMIJcjs.num.call(void 0, orphan["invoiceID"]) },
-      suggestedAction: "Retry the call."
-    });
-  }
-  const uninvoiced = v.nonChargeable ? byId(await collect(billingItems, uninvoicedFilter, [...lineFields, "itemDate"])) : [];
-  if (v.nonChargeable && uninvoiced.length !== nUninvoiced) throw countMismatch("uninvoiced line", uninvoiced.length, nUninvoiced);
-  const all = uninvoiced.length > 0 ? [...lines, ...uninvoiced] : lines;
-  const joined = Object.fromEntries(Object.keys(JOINS).map((j) => [j, /* @__PURE__ */ new Map()]));
-  for (const j of joinsNeeded) {
-    const spec = JOINS[j];
-    const res = spec.make(http, client);
-    const fields = [.../* @__PURE__ */ new Set([...spec.fields, ...groupDims.flatMap((d) => _nullishCoalesce(_optionalChain([d, 'access', _26 => _26.joins, 'optionalAccess', _27 => _27[j]]), () => ( [])))])];
-    const want = [...new Set(spec.ids(all, joined))].filter((id) => id > 0).sort((a, b) => a - b);
-    const rows = await client.batch((c) => collect(res, [{ field: "id", op: "in", value: c }], fields), chunk(want), { concurrency: CONCURRENCY });
-    for (const r of rows.flat()) joined[j].set(_chunkVFLAMMIJcjs.num.call(void 0, r["id"]), r);
-  }
-  return fold(v, { invoiceById, voided, lines, uninvoiced, joined, labels, inTypes, inCategories, scopeIds, calls, estimate });
-}
-function refusal(v, estimate, fixed, scopeIds, joinCount) {
-  const months = _chunkVFLAMMIJcjs.monthsInWindow.call(void 0, v.dateFrom, v.dateTo);
-  const variable = estimate - fixed;
-  const fitMonths = Math.floor((v.budget - fixed) * months / variable);
-  const suggestions = [];
-  const text = [];
-  let unestimated = false;
-  const suggest = (s, t, estimated = false) => {
-    suggestions.push(s);
-    text.push(t);
-    if (!estimated) unestimated = true;
-  };
-  if (estimate <= BUDGET_CAP) suggest({ maxVendorCalls: estimate }, `maxVendorCalls: ${estimate} (cap ${BUDGET_CAP})`, true);
-  if (fitMonths >= 1 && fitMonths < months) {
-    const dateFrom = lastMonthsFrom(v.dateTo, fitMonths);
-    const est = fixed + Math.ceil(variable * fitMonths / months);
-    suggest({ dateFrom, estimate: est }, `dateFrom: '${dateFrom}' (est. ${est})`, true);
-  }
-  if (v.scopeKind === "tenantWide") suggest({ companyIDs: "[...]" }, "companyIDs: [...] (or ownerResourceID)");
-  if (estimate > BUDGET_CAP) {
-    if (v.nonChargeable) suggest({ includeNonChargeable: false }, "includeNonChargeable: false");
-    if (joinCount > 1) suggest({ groupBy: ["contractType"] }, "groupBy: ['contractType'] (fewer dimensions, fewer id-fetch calls)");
-    if (v.scopeKind === "companyIDs" || v.scopeKind === "ownerResourceID") suggest({ contractIDs: "[...]" }, "contractIDs: [...] (one call per group of contracts)");
-    const n = (_nullishCoalesce(scopeIds, () => ( []))).length;
-    if (v.scopeKind === "companyIDs" && n > 1) suggest({ companyIDs: "[...]" }, "a shorter companyIDs list (one call per part)");
-    if (v.scopeKind === "ownerResourceID" && n > 1) suggest({ companyIDs: "[...]" }, "companyIDs: a subset of the owner's companies (one call per part)");
-    if (v.scopeKind === "contractIDs" && n > 1) suggest({ contractIDs: "[...]" }, "a shorter contractIDs list (one call per part)");
-  }
-  if (suggestions.length === 0) suggest({ maxVendorCalls: BUDGET_CAP }, `maxVendorCalls: ${BUDGET_CAP} (the cap; the estimate ${estimate} is above it, so this call will be refused at this estimate even at the cap; no narrower shape exists for this scope and window)`, true);
-  const caveat = unestimated ? ". Narrowings without an estimate may still be refused: the invoice stream is tenant-wide in every scope, and the line stream costs at least one page and one count per chunk of 500 of those invoices, so a narrower scope or shape does not reduce that part" : "";
-  const scope = v.scopeKind === "tenantWide" ? "tenantWide" : `${v.scopeKind} ${(_nullishCoalesce(scopeIds, () => ( []))).length} id(s)`;
-  return budgetError(
-    `revenueRollup: estimated ${estimate} vendor calls exceeds maxVendorCalls ${v.budget} (window ${v.dateFrom}..${v.dateTo}, ${scope}). Narrow with one of: ${text.join("; ")}${caveat}`,
-    { phase: "estimate", estimate, budget: v.budget, suggestions },
-    `Narrow with one of: ${text.join("; ")}${caveat}`
-  );
-}
-var amt = () => ({ amount: 0, lines: 0 });
-var nc = () => ({ contractCovered: { value: 0, hours: 0, lines: 0 }, nonBillable: { value: 0, hours: 0, lines: 0 } });
-var add = (a, c) => {
-  a.amount += c;
-  a.lines += 1;
-};
-var outAmt = (a) => ({ amount: money(a.amount), lines: a.lines });
-var outNc = (n) => {
-  const o = (k) => ({ value: money(n[k].value), hours: n[k].hours / 100, lines: n[k].lines });
-  return { contractCovered: o("contractCovered"), nonBillable: o("nonBillable") };
-};
-var outRecord = (r) => Object.fromEntries([...r].sort((a, b) => a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0).map(([k, a]) => [k, outAmt(a)]));
-function ncClass(line) {
-  if (line["nonBillable"] === true || line["nonBillable"] === 1) return "nonBillable";
-  return extC(line) > 0 && revC(line) === 0 ? "contractCovered" : void 0;
-}
-function ncAdd(n, k, line) {
-  n[k].value += extC(line);
-  if (isLabour(line)) n[k].hours += cents(line["quantity"]);
-  n[k].lines += 1;
-}
-function compareIds(a, b) {
-  for (let i = 0; i < a.length; i++) {
-    const x = _nullishCoalesce(a[i], () => ( null));
-    const y = _nullishCoalesce(b[i], () => ( null));
-    if (x === y) continue;
-    if (x === null) return -1;
-    if (y === null) return 1;
-    if (typeof x === "number" && typeof y === "number") return x - y;
-    return String(x) < String(y) ? -1 : 1;
-  }
-  return 0;
-}
-function fold(v, f) {
-  const contractLabels = f.labels[CONTRACTS_PATH];
-  const bucketLabel = (field, fallback) => (t) => {
-    const values = contractLabels.get(field);
-    const l = _optionalChain([values, 'optionalAccess', _28 => _28.get, 'call', _29 => _29(t)]);
-    if (l === void 0) return `${fallback} ${t}`;
-    return [...values.values()].filter((x) => x === l).length > 1 ? `${l} (${t})` : l;
-  };
-  const typeLabel = bucketLabel("contractType", "type");
-  const catLabel = bucketLabel("contractCategory", "category");
-  const needCompany = v.groupBy.some((d) => _optionalChain([DIMENSIONS, 'access', _30 => _30[d], 'access', _31 => _31.joins, 'optionalAccess', _32 => _32.companies]));
-  const byLob = v.groupBy.includes("lineOfBusiness");
-  const unlabelled = /* @__PURE__ */ new Set();
-  const uncontracted = amt();
-  const unresolvedContracts = amt();
-  const unresolvedCompanies = amt();
-  const unresolvedJoins = new Map(v.groupBy.flatMap((d) => DIMENSIONS[d].unresolved ? [[DIMENSIONS[d].unresolved, amt()]] : []));
-  const unresolvedNc = amt();
-  const noPointer = amt();
-  const otherTypes = /* @__PURE__ */ new Map();
-  const otherCats = /* @__PURE__ */ new Map();
-  const cells = /* @__PURE__ */ new Map();
-  const allContracts = /* @__PURE__ */ new Set();
-  const lineTotals = /* @__PURE__ */ new Map();
-  const zeroTotal = amt();
-  const zeroIds = /* @__PURE__ */ new Set();
-  const locate = (line, invoice) => {
-    const contractID = _chunkVFLAMMIJcjs.num.call(void 0, line["contractID"]);
-    if (contractID === 0) return { bucket: uncontracted, unresolved: false };
-    const contract = f.joined.contracts.get(contractID);
-    if (contract === void 0) return { bucket: unresolvedContracts, unresolved: true };
-    const type = _chunkVFLAMMIJcjs.num.call(void 0, contract["contractType"]);
-    if (!f.inTypes.has(type)) return { bucket: slot(otherTypes, typeLabel(type)), unresolved: false };
-    const cat = _chunkVFLAMMIJcjs.num.call(void 0, contract["contractCategory"]);
-    if (f.inCategories !== void 0 && !f.inCategories.has(cat)) return { bucket: slot(otherCats, cat === 0 ? "uncategorised" : catLabel(cat)), unresolved: false };
-    const company = f.joined.companies.get(_chunkVFLAMMIJcjs.num.call(void 0, line["companyID"]));
-    if (needCompany && company === void 0) return { bucket: unresolvedCompanies, unresolved: true };
-    const ctx = { line, invoice, contract, company, joined: f.joined, labels: f.labels, unlabelled };
-    const keys = {};
-    const ids = [];
-    for (const d of v.groupBy) {
-      const k = DIMENSIONS[d].key(ctx);
-      if (typeof k === "string") return { bucket: unresolvedJoins.get(k), unresolved: true };
-      keys[d] = k;
-      ids.push(k.id);
-    }
-    const id = JSON.stringify(ids);
-    let cell = cells.get(id);
-    if (cell === void 0) {
-      cell = { keys, ids, revenue: 0, credits: 0, creditLines: 0, included: 0, contracts: /* @__PURE__ */ new Set(), items: 0, nc: nc() };
-      cells.set(id, cell);
-    }
-    return { cell };
-  };
-  for (const line of f.lines) {
-    const invoiceID = _chunkVFLAMMIJcjs.num.call(void 0, line["invoiceID"]);
-    const invoice = f.invoiceById.get(invoiceID);
-    lineTotals.set(invoiceID, (_nullishCoalesce(lineTotals.get(invoiceID), () => ( 0))) + cents(line["totalAmount"]));
-    const c = revC(line);
-    if (invoice.total === 0) {
-      add(zeroTotal, c);
-      zeroIds.add(invoiceID);
-    }
-    const at = locate(line, invoice);
-    if (!("cell" in at)) {
-      add(at.bucket, c);
-      if (at.unresolved && v.nonChargeable && ncClass(line)) add(unresolvedNc, extC(line));
-      continue;
-    }
-    const cell = at.cell;
-    cell.revenue += c;
-    if (c < 0) {
-      cell.credits += c;
-      cell.creditLines += 1;
-    }
-    cell.included += extC(line) - c;
-    cell.contracts.add(_chunkVFLAMMIJcjs.num.call(void 0, line["contractID"]));
-    cell.items += 1;
-    allContracts.add(_chunkVFLAMMIJcjs.num.call(void 0, line["contractID"]));
-    if (byLob && cell.keys.lineOfBusiness.id === null) add(noPointer, c);
-    const k = v.nonChargeable ? ncClass(line) : void 0;
-    if (k) ncAdd(cell.nc, k, line);
-  }
-  for (const line of f.uninvoiced) {
-    const k = ncClass(line);
-    if (!k) continue;
-    const at = locate(line, { total: 0, month: String(_nullishCoalesce(line["itemDate"], () => ( ""))).slice(0, 7), companyID: _chunkVFLAMMIJcjs.num.call(void 0, line["companyID"]) });
-    if ("cell" in at) ncAdd(at.cell.nc, k, line);
-    else if (at.unresolved) add(unresolvedNc, extC(line));
-  }
-  const sorted = [...cells.values()].sort((a, b) => b.revenue - a.revenue || compareIds(a.ids, b.ids));
-  const kept = sorted.slice(0, v.top);
-  const cut = sorted.slice(v.top);
-  const sum = (k) => sorted.reduce((s, x) => s + x[k], 0);
-  const ncTotal = nc();
-  for (const x of sorted) for (const k of ["contractCovered", "nonBillable"]) for (const m of ["value", "hours", "lines"]) ncTotal[k][m] += x.nc[k][m];
-  const reconciled = v.scopeKind === "contractIDs" ? [] : [...f.invoiceById].filter(([, inv]) => v.scopeKind === "tenantWide" || f.scopeIds.includes(inv.companyID));
-  let headerTotal = 0;
-  let lineTotal = 0;
-  let mismatched = 0;
-  for (const [id, inv] of reconciled) {
-    const lt = _nullishCoalesce(lineTotals.get(id), () => ( 0));
-    headerTotal += inv.total;
-    lineTotal += lt;
-    if (lt !== inv.total) mismatched += 1;
-  }
-  const blindSurfaces2 = [...unlabelled].sort();
-  const noInternal = [...f.lines, ...f.uninvoiced].filter(lacksInternal).length;
-  if (noInternal > 0) blindSurfaces2.push(`billing_items: ${noInternal} line(s) without internalCurrencyTotalAmount / internalCurrencyExtendedPrice; their local-currency totalAmount / extendedPrice was used instead`);
-  if (unresolvedCompanies.lines > 0) blindSurfaces2.push("companies.query: some line companies were not returned by the id-in fetch (the companies list surface can be blind to companies the API user does not own); their lines are in coverage.excluded.unresolvedCompanies");
-  if (v.scopeKind === "ownerResourceID") blindSurfaces2.push("companies.query: ownerResourceID was resolved through the companies list surface, which can be blind to companies the API user does not own; a company it hides is missing from the scope and its revenue is not counted (scope.ids lists the companies that were resolved)");
-  const notes = [
-    "basis: invoice date (invoiceDateTime) as whole UTC days; voided invoices excluded; revenue = internalCurrencyTotalAmount (ex-tax, internal currency); includedValue is informational and never in revenue",
-    "prepaid block-hour / retainer contracts: revenue is the billed purchase"
-  ];
-  notes.push("coverage.zeroTotalInvoices is informational: its lines are also folded into rows / the excluded buckets, so it is not part of coverage.excluded (revenue + the excluded line buckets reconcile to the whole)");
-  if (v.scopeKind === "contractIDs") {
-    notes.push("reconciliation is not run for a contractIDs scope (only the scoped contracts' lines are fetched)");
-    notes.push("coverage.excluded.voidedInvoices is omitted for a contractIDs scope: an invoice header cannot be attributed to a contract (zeroTotalInvoices counts the zero-total invoices carrying a scoped line)");
-  } else if (v.scopeKind !== "tenantWide") {
-    notes.push("scope applies to the line's companyID; reconciliation, voidedInvoices and the zero-total count cover the invoices whose header company is in scope (zero-total also counts an invoice carrying an in-scope line; a mismatch can mean a line billed to another company)");
-  }
-  if (v.nonChargeable) {
-    notes.push("nonChargeable is never added to revenue: contractCovered = billable lines with internalCurrencyExtendedPrice > 0 and internalCurrencyTotalAmount = 0, nonBillable = nonBillable lines; value = \u03A3 internalCurrencyExtendedPrice, hours = \u03A3 quantity on labour lines (Labor and Labor Adjustment). Invoiced lines are keyed on the invoice date; uninvoiced lines (invoiceID notExist) have no invoice date, so they are windowed and month-keyed on itemDate (whole UTC days). Uninvoiced lines outside the contract-type/category scope or uncontracted are not counted.");
-  }
-  for (const [id, inv] of f.invoiceById) {
-    if (inv.total === 0 && (v.scopeKind === "tenantWide" || v.scopeKind !== "contractIDs" && f.scopeIds.includes(inv.companyID))) zeroIds.add(id);
-  }
-  const result = {
-    window: { dateFrom: v.dateFrom, dateTo: v.dateTo, basis: "invoiceDate" },
-    scope: {
-      kind: v.scopeKind,
-      ...v.ownerResourceID !== void 0 ? { ownerResourceID: v.ownerResourceID } : {},
-      ...f.scopeIds !== void 0 ? { ids: f.scopeIds } : {}
-    },
-    groupBy: v.groupBy,
-    top: v.top,
-    rows: kept.map((x) => ({
-      keys: x.keys,
-      revenue: money(x.revenue),
-      credits: { amount: money(x.credits), lines: x.creditLines },
-      includedValue: money(x.included),
-      contracts: x.contracts.size,
-      items: x.items,
-      ...v.nonChargeable ? { nonChargeable: outNc(x.nc) } : {}
-    })),
-    ...cut.length > 0 ? { rowsTruncated: { rows: cut.length, revenue: money(cut.reduce((s, x) => s + x.revenue, 0)) } } : {},
-    totals: {
-      revenue: money(sum("revenue")),
-      credits: money(sum("credits")),
-      includedValue: money(sum("included")),
-      contracts: allContracts.size,
-      items: sum("items"),
-      ...v.nonChargeable ? { nonChargeable: outNc(ncTotal) } : {}
-    },
-    coverage: {
-      vendorCalls: f.calls,
-      budget: v.budget,
-      estimate: f.estimate,
-      tenantHourlyShare: `${(f.calls / TENANT_HOURLY_LIMIT * 100).toFixed(2)}% of ${TENANT_HOURLY_LIMIT.toLocaleString("en-US")}/h`,
-      contractTypeMap: sortedRecord(f.inTypes),
-      ...f.inCategories !== void 0 ? { contractCategoryMap: sortedRecord(f.inCategories) } : {},
-      reconciliation: { headerTotal: money(headerTotal), lineTotal: money(lineTotal), delta: money(lineTotal - headerTotal), invoicesChecked: reconciled.length, invoicesMismatched: mismatched },
-      zeroTotalInvoices: { count: zeroIds.size, ...outAmt(zeroTotal) },
-      excluded: {
-        ...f.voided !== void 0 ? { voidedInvoices: { count: f.voided.length, headerAmount: money(f.voided.reduce((s, r) => s + cents(r["invoiceTotal"]), 0)) } } : {},
-        uncontracted: outAmt(uncontracted),
-        otherContractTypes: outRecord(otherTypes),
-        otherContractCategories: outRecord(otherCats),
-        unresolvedContracts: outAmt(unresolvedContracts),
-        unresolvedCompanies: outAmt(unresolvedCompanies),
-        ...Object.fromEntries([...unresolvedJoins].map(([k, a]) => [k, outAmt(a)])),
-        ...v.nonChargeable ? { unresolvedNonChargeable: outAmt(unresolvedNc) } : {}
-      },
-      ...byLob ? {
-        lineOfBusiness: {
-          noPointer: outAmt(noPointer),
-          note: `LOB figures are floors: lines without a pointer are shown separately (the "no LOB assigned" row, id null). LOB is per billing line (no contract fallback), so a row's contracts = contracts with at least one line in that LOB, and per-LOB contract counts can sum to more than totals.contracts.`
-        }
-      } : {},
-      blindSurfaces: blindSurfaces2,
-      notes
-    }
-  };
-  return result;
-}
-function slot(m, k) {
-  const a = _nullishCoalesce(m.get(k), () => ( amt()));
-  m.set(k, a);
-  return a;
-}
-
-// src/operations/relationshipMap.ts
-async function relationshipMap(client, resourceKey) {
-  void client;
-  if (typeof resourceKey !== "string" || resourceKey.trim() === "") {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-      `relationshipMap: resourceKey must be a non-empty plan resource key string (e.g. 'tickets'; got ${typeof resourceKey === "string" ? "a blank string" : typeof resourceKey})`,
-      { suggestedAction: "Pass the exact plan resource key (snake_case) from autotask_catalog \u2014 e.g. tickets, companies, configuration_items, ticket_notes." }
-    );
-  }
-  const key = resourceKey.trim();
-  const entry = _chunkVFLAMMIJcjs.RELATIONSHIP_MAP[key];
-  if (entry === void 0) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskError)(
-      `relationshipMap: unknown resource "${key}" \u2014 the plan has ${Object.keys(_chunkVFLAMMIJcjs.RELATIONSHIP_MAP).length} resources`,
-      {
-        code: "RESOURCE_UNKNOWN",
-        category: "validation",
-        suggestedAction: `Pass the exact plan resource key (snake_case) from autotask_catalog (e.g. tickets, companies, configuration_items). Zone facts served are ${_chunkVFLAMMIJcjs.RELATIONSHIP_ZONE.label} (${_chunkVFLAMMIJcjs.RELATIONSHIP_ZONE.zone})-verified.`
-      }
-    );
-  }
-  return entry;
-}
-
-// src/operations/blindSurfaces.ts
-var BLIND_SURFACE_KINDS = [
-  "unowned-blind",
-  "fully-blind",
-  "unfiltered-blind",
-  "unknown"
-];
-async function blindSurfaces(client, opts) {
-  void client;
-  if (opts !== void 0 && (typeof opts !== "object" || opts === null || Array.isArray(opts))) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)("blindSurfaces: opts must be an object { resource?: string, kind?: BlindSurfaceKind }");
-  }
-  const inv = _chunkVFLAMMIJcjs.BLIND_SURFACE_INVENTORY;
-  if (inv === null) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)("blindSurfaces: the reachability inventory is absent from the generated artifact \u2014 re-run the build");
-  }
-  let surfaces = inv.surfaces;
-  if (_optionalChain([opts, 'optionalAccess', _33 => _33.resource]) !== void 0) {
-    const key = typeof opts.resource === "string" ? opts.resource.trim() : "";
-    if (key === "") {
-      throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-        "blindSurfaces: opts.resource must be a non-empty plan resource key string (e.g. 'tickets')",
-        { suggestedAction: "Pass the exact plan resource key (snake_case) from autotask_catalog \u2014 e.g. tickets, companies, configuration_items." }
-      );
-    }
-    if (!inv.surfaces.some((row) => row.resource === key)) {
-      throw new (0, _chunkVFLAMMIJcjs.AutotaskError)(
-        `blindSurfaces: unknown resource "${key}" \u2014 the plan has ${Object.keys(_chunkVFLAMMIJcjs.RELATIONSHIP_MAP).length} resources`,
-        {
-          code: "RESOURCE_UNKNOWN",
-          category: "validation",
-          suggestedAction: `Pass the exact plan resource key (snake_case) from autotask_catalog (e.g. tickets, companies, configuration_items). Zone facts served are ${inv.label} (${inv.zone})-verified.`
-        }
-      );
-    }
-    surfaces = surfaces.filter((row) => row.resource === key);
-  }
-  if (_optionalChain([opts, 'optionalAccess', _34 => _34.kind]) !== void 0) {
-    if (!BLIND_SURFACE_KINDS.includes(opts.kind)) {
-      throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-        `blindSurfaces: unknown kind "${String(opts.kind)}" \u2014 the valid classes are: ${BLIND_SURFACE_KINDS.join(", ")}`,
-        { suggestedAction: `Filter with one of: ${BLIND_SURFACE_KINDS.join(", ")} (or omit kind for the full 116-surface inventory).` }
-      );
-    }
-    surfaces = surfaces.filter((row) => row.kind === opts.kind);
-  }
-  return { ...inv, surfaces };
-}
-
-// src/operations/probeReachability.ts
-async function probeReachability(client, opts) {
-  if (opts !== void 0 && (typeof opts !== "object" || opts === null || Array.isArray(opts))) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)("probeReachability: opts must be an object { resources?: string[], limit?: 1|2, maxWireCalls?: number, confirmProbe?: true }");
-  }
-  const defs = _chunkVFLAMMIJcjs.REACHABILITY_PROBE_DEFAULTS;
-  if (_optionalChain([opts, 'optionalAccess', _35 => _35.confirmProbe]) !== true) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-      "probeReachability: confirmProbe: true is required \u2014 the op deliberately fans out read wire across the tenant (one bounded query per surface); pass confirmProbe: true to run it",
-      { suggestedAction: `Re-call with { confirmProbe: true } (plus resources/limit/maxWireCalls as needed). For the ZERO-wire pinned inventory use operations.blindSurfaces.` }
-    );
-  }
-  const limit = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _36 => _36.limit]), () => ( defs.limitDefault));
-  if (!Number.isInteger(limit) || limit < 1 || limit > defs.limitMax) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-      `probeReachability: limit must be an integer 1..${defs.limitMax} (got ${String(limit)}) \u2014 the rows-per-surface bound for the discovery read`
-    );
-  }
-  const cap = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _37 => _37.maxWireCalls]), () => ( defs.defaultCap));
-  if (!Number.isInteger(cap) || cap < 1) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(`probeReachability: maxWireCalls must be a positive integer (got ${String(cap)})`);
-  }
-  if (cap > defs.hardCap) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-      `probeReachability: maxWireCalls ${cap} exceeds the hard wire cap of ${defs.hardCap} \u2014 the sweep is refused above it (never capped silently)`,
-      { suggestedAction: `Pass maxWireCalls \u2264 ${defs.hardCap} and a resources set no larger than the cap (the refused set is never truncated).` }
-    );
-  }
-  const inv = _chunkVFLAMMIJcjs.BLIND_SURFACE_INVENTORY;
-  if (inv === null) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)("probeReachability: the reachability inventory is absent from the generated artifact \u2014 re-run the build");
-  }
-  let targets;
-  if (_optionalChain([opts, 'optionalAccess', _38 => _38.resources]) === void 0) {
-    targets = [...defs.defaultTargets];
-  } else {
-    if (!Array.isArray(opts.resources) || opts.resources.length === 0) {
-      throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)("probeReachability: opts.resources must be a non-empty string[] of plan resource keys (or omit it for the default non-data-full set)");
-    }
-    const seen = /* @__PURE__ */ new Set();
-    for (const r of opts.resources) {
-      if (typeof r !== "string" || r.trim() === "") {
-        throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(`probeReachability: opts.resources must contain non-empty plan resource key strings (got ${typeof r === "string" && r.trim() === "" ? "a blank string" : typeof r})`);
-      }
-      const key = r.trim();
-      if (!inv.surfaces.some((row) => row.resource === key)) {
-        const surfaceCount = new Set(inv.surfaces.map((s) => s.resource)).size;
-        throw new (0, _chunkVFLAMMIJcjs.AutotaskError)(
-          `probeReachability: unknown resource "${key}" \u2014 the inventory has ${surfaceCount} surfaces`,
-          {
-            code: "RESOURCE_UNKNOWN",
-            category: "validation",
-            suggestedAction: "Pass the exact plan resource key (snake_case) from autotask_catalog (e.g. tickets, companies, configuration_items)."
-          }
-        );
-      }
-      seen.add(key);
-    }
-    targets = [...seen];
-  }
-  if (targets.length > cap) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-      `probeReachability: ${targets.length} requested surface(s) exceed the wire cap of ${cap} \u2014 the sweep is refused above its cap (never truncated)`,
-      { suggestedAction: `Raise maxWireCalls (\u2264 ${defs.hardCap}) to cover the set, or pass a smaller resources list.` }
-    );
-  }
-  const byResource = new Map(inv.surfaces.map((row) => [row.resource, row]));
-  const results = [];
-  for (const resource of targets.sort()) {
-    const row = byResource.get(resource);
-    if (row === void 0) continue;
-    const holder = client[_chunkVFLAMMIJcjs.camelKey.call(void 0, resource)];
-    const probeFn = _optionalChain([holder, 'optionalAccess', _39 => _39.queryBounded]);
-    if (typeof probeFn !== "function") {
-      results.push({
-        ...row,
-        unfilteredRows: null,
-        probe: { ok: false, wire: 0, error: { code: "RESOURCE_NO_QUERY_OP", message: `no queryBounded read exists on the client accessor for "${resource}" \u2014 nothing was probed` } }
-      });
-      continue;
-    }
-    try {
-      const res = await probeFn.call(holder, { limit });
-      const items = Array.isArray(_optionalChain([res, 'optionalAccess', _40 => _40.items])) ? res.items : [];
-      results.push({
-        ...row,
-        unfilteredRows: items.length,
-        probe: { ok: true, wire: 1, error: null }
-      });
-    } catch (err) {
-      const code = _chunkVFLAMMIJcjs.isAutotaskError.call(void 0, err) ? err.code : "NETWORK_ERROR";
-      const message = err instanceof Error ? err.message : String(err);
-      results.push({
-        ...row,
-        unfilteredRows: null,
-        probe: { ok: false, wire: 1, error: { code, message } }
-      });
-    }
-  }
-  const wireUsed = results.reduce((n, r) => n + r.probe.wire, 0);
-  return { results, wireUsed, cap, truncated: false };
-}
-
-// src/operations/createGuidance.ts
-var CREATE_BLOCKER_KINDS = [
-  "ok",
-  "blind-reference",
-  "blind-parent",
-  "picklist-unexposed",
-  "undocumented-ladder",
-  "resource-role-pair",
-  "delete-absent",
-  "non-mutable",
-  "unknown"
-];
-async function createGuidance(client, opts) {
-  void client;
-  if (opts !== void 0 && (typeof opts !== "object" || opts === null || Array.isArray(opts))) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-      "createGuidance: opts must be an object { resources?: string[], kind?: CreateBlockerKind }"
-    );
-  }
-  let servedRows = _chunkVFLAMMIJcjs.CREATE_GUIDANCE.rows.map((row) => ({
-    ...row,
-    // Issue #219 N4: one precedence rule, stated on every row (live-proven >
-    // zone > spec). The spec set is not available here (it is a LIVE read) —
-    // the helper is handed the plan's two shapes and names the source.
-    requiredFields: _chunkVFLAMMIJcjs.effectiveRequiredFields.call(void 0, void 0, _nullishCoalesce(_optionalChain([_chunkVFLAMMIJcjs.RELATIONSHIP_MAP, 'access', _41 => _41[row.resource], 'optionalAccess', _42 => _42.zoneFacts]), () => ( null)))
-  }));
-  if (_optionalChain([opts, 'optionalAccess', _43 => _43.resources]) !== void 0) {
-    if (!Array.isArray(opts.resources) || opts.resources.length === 0) {
-      throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)("createGuidance: opts.resources must be a non-empty string[] of plan resource keys");
-    }
-    const wanted = /* @__PURE__ */ new Set();
-    for (const r of opts.resources) {
-      if (typeof r !== "string" || r.trim() === "") {
-        throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)("createGuidance: opts.resources must contain non-empty plan resource key strings");
-      }
-      const key = r.trim();
-      if (!_chunkVFLAMMIJcjs.CREATE_GUIDANCE.rows.some((row) => row.resource === key)) {
-        throw new (0, _chunkVFLAMMIJcjs.AutotaskError)(
-          `createGuidance: unknown resource "${key}" \u2014 the catalog has ${_chunkVFLAMMIJcjs.CREATE_GUIDANCE.rows.length} create entities`,
-          {
-            code: "RESOURCE_UNKNOWN",
-            category: "validation",
-            suggestedAction: "Pass the exact plan resource key (snake_case) from autotask_catalog (e.g. tickets, projects, opportunities)."
-          }
-        );
-      }
-      wanted.add(key);
-    }
-    servedRows = servedRows.filter((row) => wanted.has(row.resource));
-  }
-  if (_optionalChain([opts, 'optionalAccess', _44 => _44.kind]) !== void 0) {
-    if (!CREATE_BLOCKER_KINDS.includes(opts.kind)) {
-      throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-        `createGuidance: unknown kind "${String(opts.kind)}" \u2014 the valid kinds are: ${CREATE_BLOCKER_KINDS.join(", ")}`
-      );
-    }
-    servedRows = servedRows.filter((row) => _optionalChain([row, 'access', _45 => _45.blocker, 'optionalAccess', _46 => _46.kind]) === opts.kind);
-  }
-  return {
-    zone: _chunkVFLAMMIJcjs.CREATE_GUIDANCE.zone,
-    label: _chunkVFLAMMIJcjs.CREATE_GUIDANCE.label,
-    verifiedAt: _chunkVFLAMMIJcjs.CREATE_GUIDANCE.verifiedAt,
-    rows: servedRows,
-    counts: _chunkVFLAMMIJcjs.CREATE_GUIDANCE.counts
-  };
-}
-
-// src/operations/registryIndex.ts
-var OPERATION_BY_ID = new Map(_chunk5BDUMDAQcjs.CAPABILITIES.map((r) => [r.id, r]));
-
-// src/operations/sanitiseResult.ts
-async function sanitiseResult(client, result, operation) {
-  void client;
-  if (typeof operation !== "string" || operation === "") {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-      'sanitiseResult: operation must be a non-empty registry operation key (e.g. "tickets.query")',
-      { suggestedAction: "Pass the operation key the result came from \u2014 the registry id, not the resource key." }
-    );
-  }
-  const record = OPERATION_BY_ID.get(operation);
-  if (record === void 0) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-      `sanitiseResult: unknown operation "${operation.slice(0, 60)}" \u2014 it is not in the capability registry`,
-      { operation, suggestedAction: "List the registry (the ./capabilities subpath) for the exact operation key." }
-    );
-  }
-  const fields = _optionalChain([record, 'access', _47 => _47.metadata, 'optionalAccess', _48 => _48.untrustedFields]);
-  if (!Array.isArray(fields) || fields.length === 0) return result;
-  return _chunkMJTKK3QGcjs.deepMarkUntrusted.call(void 0, result, fields);
-}
-
-// src/operations/recovery.ts
-var RECOVERY_CONFIRM = "operations.recovery";
-var RECOVERY_DEFAULT_LIMIT = 25;
-var RECOVERY_MAX_LIMIT = 100;
-function configError(message, operation, suggestedAction) {
-  throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(message, { operation, suggestedAction });
-}
-function parseMatchId(record) {
-  const raw = record.id;
-  if (typeof raw === "number") {
-    if (Number.isInteger(raw) && raw >= 0 && raw <= Number.MAX_SAFE_INTEGER) return { id: raw, unsafe: false };
-    return { id: null, unsafe: true };
-  }
-  if (typeof raw === "string" && /^\d+$/.test(raw.trim())) {
-    const n = Number(raw.trim());
-    if (Number.isSafeInteger(n)) return { id: n, unsafe: false };
-    return { id: null, unsafe: true };
-  }
-  return { id: null, unsafe: true };
-}
-function validateRecoveryInput(input, operation) {
-  if (!_chunkVFLAMMIJcjs.isRecord.call(void 0, input)) {
-    configError(
-      `recovery: input must be an object { resource, marker, ... } (got ${typeof input})`,
-      operation,
-      "Pass { resource: '<plan key>', marker: '<the marker the write stamped>' } \u2014 e.g. { resource: 'companies', marker: 'FULL100W-1791110339' }."
-    );
-  }
-  const resource = typeof input.resource === "string" ? input.resource.trim() : "";
-  if (resource === "") {
-    configError(
-      `recovery: input.resource must be a non-empty plan resource key string (e.g. 'companies')`,
-      operation,
-      "Pass the exact plan resource key (snake_case) from autotask_catalog \u2014 e.g. companies, tickets, configuration_items."
-    );
-  }
-  const marker = typeof input.marker === "string" ? input.marker : "";
-  if (marker.trim() === "") {
-    configError(
-      "recovery: input.marker must be a non-empty string \u2014 the marker the write stamped into a name-like field",
-      operation,
-      "Stamp a deterministic marker into the record at create time (e.g. `FULL100W-${Date.now()}`) and pass it here; a guess is not a marker."
-    );
-  }
-  const action = _nullishCoalesce(input.action, () => ( "find"));
-  if (action !== "find" && action !== "delete") {
-    configError(
-      `recovery: input.action must be 'find' (default) or 'delete' (got ${JSON.stringify(String(input.action))})`,
-      operation,
-      "Pass action: 'delete' for the destructive path (dry-run-first; the apply requires the confirm string)."
-    );
-  }
-  return { resource, marker, action };
-}
-function resolveRecoveryTarget(client, resource, operation) {
-  const entry = _chunkVFLAMMIJcjs.RELATIONSHIP_MAP[resource];
-  if (entry === void 0) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskError)(
-      `recovery: unknown resource "${resource}" \u2014 the plan has ${Object.keys(_chunkVFLAMMIJcjs.RELATIONSHIP_MAP).length} resources`,
-      {
-        code: "RESOURCE_UNKNOWN",
-        category: "validation",
-        operation,
-        suggestedAction: "Pass the exact plan resource key (snake_case) from autotask_catalog (e.g. tickets, companies, configuration_items)."
-      }
-    );
-  }
-  const holder = client[_chunkVFLAMMIJcjs.camelKey.call(void 0, resource)];
-  if (!holder || typeof holder.queryBounded !== "function") {
-    configError(
-      `recovery: ${resource} exposes no bounded query surface \u2014 the marker search cannot run`,
-      operation,
-      "Use a resource with a query surface, or address the record by id directly (get/fetchMany)."
-    );
-  }
-  return { entry, holder };
-}
-function resolveMarkerField(input, resource, operation) {
-  const field = input.field !== void 0 ? String(input.field) : _chunkVFLAMMIJcjs.MARKER_FIELDS[resource];
-  if (typeof field !== "string" || field.trim() === "") {
-    configError(
-      `recovery: ${resource} has no plan markerField and no input.field was passed \u2014 the marker search needs a name-like field to filter on`,
-      operation,
-      "Pass input.field \u2014 a name-like vendor field the marker was stamped into (see the resource model in autotask_describe / autotask_catalog)."
-    );
-  }
-  return field;
-}
-function resolveParentId(input, entry, resource, operation) {
-  if (input.parentId === void 0) return void 0;
-  if (!Number.isInteger(input.parentId) || input.parentId < 0) {
-    configError(
-      `recovery: input.parentId must be a non-negative integer (got ${String(input.parentId)})`,
-      operation,
-      "Pass the parent record id (e.g. the ticket id for a ticket note)."
-    );
-  }
-  if (entry.parent === null || entry.parent.field === null) {
-    configError(
-      `recovery: ${resource} is not a parent-scoped child resource \u2014 input.parentId does not apply`,
-      operation,
-      `Drop input.parentId (the search runs unscoped), or pass the child resource that IS scoped under ${resource}.`
-    );
-  }
-  return input.parentId;
-}
-function resolveExtraFilter(input, operation) {
-  const extra = [];
-  if (input.filter === void 0) return extra;
-  if (!Array.isArray(input.filter)) {
-    configError(
-      `recovery: input.filter must be an array of leaf filter conditions (got ${typeof input.filter})`,
-      operation,
-      "Pass e.g. [{ field: 'status', op: 'eq', value: 'open' }] \u2014 leaf conditions only."
-    );
-  }
-  for (const c of input.filter) {
-    if (!_chunkVFLAMMIJcjs.isRecord.call(void 0, c) || typeof c.op !== "string" || c.op === "and" || c.op === "or") {
-      configError(
-        "recovery: input.filter accepts only plain leaf conditions ({ field, op, value }) \u2014 no grouping",
-        operation,
-        "Pass flat leaf conditions; grouping operators are not supported here."
-      );
-    }
-    extra.push(c);
-  }
-  return extra;
-}
-function resolveLimit(input, operation) {
-  if (input.limit === void 0) return RECOVERY_DEFAULT_LIMIT;
-  if (!Number.isInteger(input.limit) || input.limit < 1 || input.limit > RECOVERY_MAX_LIMIT) {
-    configError(
-      `recovery: input.limit must be an integer 1..${RECOVERY_MAX_LIMIT} (got ${String(input.limit)})`,
-      operation,
-      `Raise the marker precision instead of the cap, or pass limit up to ${RECOVERY_MAX_LIMIT}.`
-    );
-  }
-  return input.limit;
-}
-async function applyRecoveryDeletes(holder, matches, parentId, resource, operation) {
-  const deleteMethod = holder.delete;
-  if (deleteMethod === void 0) {
-    throw new (0, _chunkVFLAMMIJcjs.DeleteBoundaryError)(
-      `recovery: ${resource} has no delete method on the client \u2014 the boundary is marked available in the plan but the typed delete surface is missing`,
-      {
-        operation,
-        suggestedAction: "Report the registry drift (plan says deletable, client exposes no delete) \u2014 or clean up via the Autotask UI.",
-        details: { resource }
-      }
-    );
-  }
-  const deleted = [];
-  for (const match of matches) {
-    const id = match.id;
-    let verify = "error";
-    let code;
-    try {
-      if (parentId !== void 0) {
-        await deleteMethod.call(holder, parentId, id, { dryRun: false });
-      } else {
-        await deleteMethod.call(holder, id, { dryRun: false });
-      }
-      try {
-        if (parentId !== void 0) {
-          await holder.get.call(holder, parentId, id);
-          verify = "still-present";
-        } else {
-          await holder.get.call(holder, id);
-          verify = "still-present";
-        }
-      } catch (err) {
-        if (err instanceof _chunkVFLAMMIJcjs.NotFoundError) verify = "not-found";
-        else {
-          verify = "error";
-          code = _chunkVFLAMMIJcjs.isAutotaskError.call(void 0, err) ? err.code : "SERVER_ERROR";
-        }
-      }
-    } catch (err) {
-      code = _chunkVFLAMMIJcjs.isAutotaskError.call(void 0, err) ? err.code : "SERVER_ERROR";
-    }
-    deleted.push({ id, verified: verify === "not-found", code });
-  }
-  return deleted;
-}
-function collectMatches(items, field) {
-  const matches = [];
-  const unsafeIds = [];
-  items.forEach((record, idx) => {
-    const parsed = parseMatchId(record);
-    if (parsed.unsafe) unsafeIds.push(idx);
-    const value = record[field];
-    matches.push({
-      id: parsed.id,
-      value: typeof value === "string" || typeof value === "number" || typeof value === "boolean" ? value : null
-    });
-  });
-  return { matches, unsafeIds };
-}
-async function recovery(client, input, opts = {}) {
-  const operation = RECOVERY_CONFIRM;
-  const { resource, marker, action } = validateRecoveryInput(input, operation);
-  const { entry, holder } = resolveRecoveryTarget(client, resource, operation);
-  const field = resolveMarkerField(input, resource, operation);
-  const parentId = resolveParentId(input, entry, resource, operation);
-  const extra = resolveExtraFilter(input, operation);
-  const limit = resolveLimit(input, operation);
-  const boundaryNote = _chunkVFLAMMIJcjs.DELETE_BOUNDARY_NOTES[resource];
-  const boundary = {
-    available: boundaryNote === void 0,
-    reason: _nullishCoalesce(boundaryNote, () => ( null)),
-    authority: null
-  };
-  const cleanup = boundaryNote === void 0 ? null : {
-    manual: true,
-    note: `the vendor defines no DELETE for ${resource} \u2014 remove the record(s) in the Autotask UI (UI-only cleanup; the API 405s the method). ${boundaryNote}`
-  };
-  const isDelete = action === "delete";
-  if (isDelete && boundaryNote !== void 0) {
-    throw new (0, _chunkVFLAMMIJcjs.DeleteBoundaryError)(
-      `recovery: the vendor defines no DELETE for ${resource} \u2014 the delete cannot be issued through the API (zero wire was issued)`,
-      {
-        operation,
-        suggestedAction: cleanup.note,
-        details: { resource, note: boundaryNote }
-      }
-    );
-  }
-  const dryRun = _optionalChain([opts, 'optionalAccess', _49 => _49.dryRun]) !== false;
-  const confirm = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _50 => _50.confirm]), () => ( input.confirm));
-  if (isDelete && !dryRun && confirm !== RECOVERY_CONFIRM) {
-    throw new (0, _chunkVFLAMMIJcjs.ConfirmationRequiredError)(
-      `recovery: action 'delete' apply is destructive and requires its confirmation flag: pass confirm: "${RECOVERY_CONFIRM}"`,
-      {
-        operation: RECOVERY_CONFIRM,
-        suggestedAction: "Pass confirm equal to the operation key to acknowledge the deliberate act \u2014 or keep the dry run (omit dryRun: false) and read the match set first."
-      }
-    );
-  }
-  const conditions = [
-    { field, op: "contains", value: marker },
-    ...parentId !== void 0 && entry.parent !== null && entry.parent.field !== null ? [{ field: entry.parent.field, op: "eq", value: parentId }] : [],
-    ...extra
-  ];
-  const query = await holder.queryBounded({ filter: conditions, limit });
-  if (query.hasMore) {
-    const wire = isDelete ? "DELETE wire" : "mutating wire";
-    throw new (0, _chunkVFLAMMIJcjs.RecoveryTruncatedError)(
-      `recovery: the marker search on ${resource} TRIPPED its match cap (${limit}) \u2014 more matches exist than were returned (zero ${wire} was issued)`,
-      {
-        operation,
-        suggestedAction: `Narrow the search (a more precise marker, an input.filter condition, input.parentId) or pass a higher limit (max ${RECOVERY_MAX_LIMIT}).`,
-        details: { resource, scanned: query.fetched, limit }
-      }
-    );
-  }
-  const { matches, unsafeIds } = collectMatches(query.items, field);
-  const unsafeId = unsafeIds.length > 0;
-  const base = {
-    resource,
-    marker,
-    field,
-    action,
-    matches,
-    scanned: query.fetched,
-    truncated: false,
-    delete: boundary,
-    unsafeId,
-    cleanup,
-    dryRun: void 0
-  };
-  if (!isDelete) return base;
-  if (dryRun) {
-    return { ...base, simulated: true, dryRun: true };
-  }
-  if (unsafeId) {
-    throw new (0, _chunkVFLAMMIJcjs.MarkerUnsafeIdError)(
-      `recovery: ${unsafeIds.length} of ${matches.length} match(es) on ${resource} have ids beyond Number.MAX_SAFE_INTEGER \u2014 they CANNOT be addressed through the SDK's typed delete surface (zero DELETE wire was issued)`,
-      {
-        operation,
-        suggestedAction: cleanup ? cleanup.note : "Remove the unaddressable record(s) in the Autotask UI, then re-run the recovery (the safe matches are addressed one by one).",
-        details: { resource, unsafeMatches: unsafeIds.length, totalMatches: matches.length }
-      }
-    );
-  }
-  const deleted = await applyRecoveryDeletes(holder, matches, parentId, resource, operation);
-  return { ...base, deleted, dryRun: false };
-}
-
-// src/operations/invoke/modes.ts
-function needsConfirmation(record) {
-  return record.effect === "destructive" || (_nullishCoalesce(record.flags, () => ( []))).includes("requiresApproval");
-}
-function refuse(message, operation, suggestedAction) {
-  throw new (0, _chunkVFLAMMIJcjs.ConfirmationRequiredError)(message, { operation, suggestedAction });
-}
-var MODE_BY_EFFECT = {
-  read: "read",
-  write: "write",
-  destructive: "delete"
-};
-var MODE_TOOL = {
-  read: "autotask_read",
-  write: "autotask_write",
-  delete: "autotask_delete"
-};
-var MODE_SDK = {
-  read: "invokeRead",
-  write: "invokeWrite",
-  delete: "invokeDelete"
-};
-var MODE_EFFECT = {
-  read: "read",
-  write: "write",
-  delete: "destructive"
-};
-function crossModeRefusal(operation, effect, mode) {
-  const actual = MODE_BY_EFFECT[effect];
-  const subject = effect === "write" ? "a write" : effect === "destructive" ? "destructive" : "a read";
-  const target = actual === "read" ? `Route it through the read mode (${MODE_SDK[actual]} / ${MODE_TOOL[actual]}).` : actual === "write" ? `Route it through the write mode (${MODE_SDK[actual]} / ${MODE_TOOL[actual]} \u2014 dry-run first).` : `Deletes have their own tool (${MODE_TOOL[actual]}) and require confirm: "${operation}".`;
-  return `invoke: "${operation}" is ${subject} (effect=${effect}) \u2014 refused on the ${mode} path (${MODE_TOOL[mode]} routes effect=${MODE_EFFECT[mode]} operations only). ${target}`;
-}
-
-// src/operations/invoke/validate.ts
-function isSafeNonNegativeInteger(value) {
-  return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
-}
-function looseTypeOk(type, value) {
-  switch (type) {
-    case "number":
-      return isSafeNonNegativeInteger(value) || typeof value === "string" && /^\d+$/.test(value);
-    case "string":
-      return typeof value === "string";
-    case "string | number":
-      return typeof value === "string" || isSafeNonNegativeInteger(value);
-    case "number[]":
-      return Array.isArray(value);
-    case "string[]":
-      return Array.isArray(value) && value.every((v) => typeof v === "string");
-    case "object":
-      return _chunkVFLAMMIJcjs.isRecord.call(void 0, value);
-    default:
-      return true;
-  }
-}
-function declaredArgList(record) {
-  const schema = _nullishCoalesce(record.inputSchema, () => ( {}));
-  const names = Object.keys(schema);
-  if (names.length === 0) return "no positional args";
-  return names.map((n) => `${n}: ${schema[n].type}`).join(", ");
-}
-function resolveDispatchArgs(record, argsIn) {
-  const operation = record.id;
-  const bad = (message) => {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(`invoke: "${operation}" ${message}`, { operation });
-  };
-  if (argsIn === void 0 || argsIn === null) return [];
-  if (Array.isArray(argsIn)) return argsIn;
-  const byName = argsIn;
-  if (!_chunkVFLAMMIJcjs.isRecord.call(void 0, byName) || ![Object.prototype, null].includes(Object.getPrototypeOf(byName))) {
-    return bad(`args must be a positional array or a plain object of named inputs (declared: ${declaredArgList(record)})`);
-  }
-  const schema = _nullishCoalesce(record.inputSchema, () => ( {}));
-  const names = Object.keys(schema);
-  const unknown = Object.keys(byName).filter((k) => !names.includes(k));
-  if (unknown.length > 0) bad(`has no input named ${unknown.slice(0, 10).map((k) => `"${k}"`).join(", ")}${unknown.length > 10 ? ` (and ${unknown.length - 10} more)` : ""} (declared: ${declaredArgList(record)})`);
-  const missing = names.filter((n) => schema[n].required && byName[n] === void 0);
-  if (missing.length > 0) bad(`requires named input ${missing.map((k) => `"${k}"`).join(", ")} (declared: ${declaredArgList(record)})`);
-  const last = names.reduce((at, n, i) => byName[n] === void 0 ? at : i, -1);
-  return names.slice(0, last + 1).map((n) => byName[n]);
-}
-function validateDispatchArgs(record, argsIn) {
-  const args = _nullishCoalesce(argsIn, () => ( []));
-  const operation = record.id;
-  const schema = _nullishCoalesce(record.inputSchema, () => ( {}));
-  const names = Object.keys(schema);
-  if (args.length > names.length) {
-    const bagName = names.find((n) => schema[n].properties);
-    const surplus = args[names.length];
-    const bagHint = bagName && surplus !== null && typeof surplus === "object" && !Array.isArray(surplus) ? ` \u2014 options go inside the single ${bagName} object` : "";
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-      `invoke: "${operation}" declares ${names.length} positional arg(s) (${declaredArgList(record)}) but ${args.length} were passed \u2014 extra args are refused${bagHint}`,
-      {
-        operation,
-        suggestedAction: `Pass exactly the declared args in order (${declaredArgList(record)}); dryRun/confirm/lastModifiedDate travel through the invoke options, never the args.`
-      }
-    );
-  }
-  const required = names.filter((n) => schema[n].required);
-  if (args.length < required.length) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-      `invoke: "${operation}" requires ${required.length} positional arg(s) (${required.map((n) => `${n}: ${schema[n].type}`).join(", ")}) but only ${args.length} were passed \u2014 declared args: ${declaredArgList(record)}`,
-      { operation }
-    );
-  }
-  for (let i = 0; i < args.length; i += 1) {
-    const value = args[i];
-    if (value === void 0) continue;
-    const name = names[i];
-    const spec = schema[name];
-    if (!looseTypeOk(spec.type, value)) {
-      throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-        `invoke: "${operation}" arg ${i + 1} is declared ${name}: ${spec.type} \u2014 the value has the wrong type (pass a ${spec.type} value)`,
-        { operation }
-      );
-    }
-  }
-}
-function foldFlattenedOpts(record, toolArgs) {
-  if (!_chunkVFLAMMIJcjs.isRecord.call(void 0, toolArgs)) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(`invoke: "${record.id}" tool args must be a plain object of named inputs`, { operation: record.id });
-  }
-  const bagKeys = (_nullishCoalesce(_optionalChain([record, 'access', _51 => _51.inputSchema, 'optionalAccess', _52 => _52.opts, 'optionalAccess', _53 => _53.properties]), () => ( []))).map((p) => p.name);
-  const flat = Object.keys(toolArgs).filter((k) => bagKeys.includes(k) && toolArgs[k] !== void 0 && toolArgs[k] !== null);
-  const folded = { ...toolArgs };
-  for (const k of bagKeys) delete folded[k];
-  if (folded.opts === null) delete folded.opts;
-  if (flat.length === 0) return folded;
-  if (folded.opts !== void 0) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-      `invoke: "${record.id}" was given both opts and flattened option(s) ${flat.map((k) => `"${k}"`).join(", ")} \u2014 pass one form`,
-      { operation: record.id }
-    );
-  }
-  return { ...folded, opts: Object.fromEntries(flat.map((k) => [k, toolArgs[k]])) };
-}
-
-// src/operations/invoke/inputSets.ts
-var PARAMS_BAG_KEYS = {
-  query: ["filter", "limit", "includeFields", "via", "latest", "noteChars", "fieldCheck", "names", "acknowledgeUnscoped", "walk"],
-  // No registry row DECLARES `queryAll` today (a plan decision: the raw walk is
-  // called directly), so this entry never fires. It is KEPT so that a future
-  // `queryAll` row — which `invoke` WOULD dispatch via holder[operation] —
-  // cannot silently open the bag (the keys are the vendor `QueryParams` set
-  // the raw method accepts).
-  queryAll: ["filter", "maxRecords", "includeFields", "maxTotalRecords", "via"],
-  // issue #145: the count bag carries the fieldCheck opt-out — the #140
-  // refusal's advised remedy (before, the closed bag refused the very key it
-  // advised, and the remedy looped into a second CONFIG_ERROR).
-  count: ["filter", "fieldCheck"]
-};
-var BAG_KEY_SYNONYMS = {
-  filters: "filter",
-  last: "latest",
-  // issue #59: the expected typo class (honoured only on `query`)
-  lmit: "limit",
-  page: "limit",
-  pageSize: "limit",
-  cursor: "limit",
-  maxrecords: "maxRecords",
-  fieldsPreset: "includeFields"
-  // issue #287: the preset was removed — the refusal points at the explicit includeFields
-};
-function levenshtein(a, b) {
-  if (a === b) return 0;
-  const prev = new Array(b.length + 1);
-  const cur = new Array(b.length + 1);
-  for (let j = 0; j <= b.length; j += 1) prev[j] = j;
-  for (let i = 1; i <= a.length; i += 1) {
-    cur[0] = i;
-    for (let j = 1; j <= b.length; j += 1) {
-      cur[j] = Math.min((_nullishCoalesce(prev[j], () => ( 0))) + 1, (_nullishCoalesce(cur[j - 1], () => ( 0))) + 1, prev[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
-    }
-    for (let j = 0; j <= b.length; j += 1) prev[j] = cur[j];
-  }
-  return _nullishCoalesce(prev[b.length], () => ( 0));
-}
-function suggestForKey(key, valid) {
-  const synonym = BAG_KEY_SYNONYMS[key.toLowerCase()];
-  if (synonym !== void 0 && valid.includes(synonym)) return synonym;
-  let best = null;
-  for (const v of valid) {
-    const dist = levenshtein(key.toLowerCase(), v.toLowerCase());
-    if (best === null || dist < best.dist) best = { key: v, dist };
-  }
-  if (best !== null && best.dist <= 3) return best.key;
-  return null;
-}
-function keySuggestions(unknown, valid) {
-  return unknown.map((k) => [k, suggestForKey(k, valid)]).filter((pair) => pair[1] !== null).map(([k, s]) => `"${k}" \u2192 "${s}"`);
-}
-function validateParamsBag(record, args) {
-  if (record.inputSchemaStrict !== true) return;
-  const valid = PARAMS_BAG_KEYS[record.operation];
-  if (valid === void 0) return;
-  const bag = _optionalChain([args, 'optionalAccess', _54 => _54[0]]);
-  if (bag === void 0 || bag === null || !_chunkVFLAMMIJcjs.isRecord.call(void 0, bag)) return;
-  const unknown = Object.keys(bag).filter((k) => !valid.includes(k));
-  if (unknown.length === 0) return;
-  const suggestions = keySuggestions(unknown, valid);
-  throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-    `invoke: "${record.id}" params bag has unknown key(s) ${unknown.map((k) => `"${k}"`).join(", ")} \u2014 the bag is closed (valid keys: ${valid.join(", ")})`,
-    {
-      operation: record.id,
-      suggestedAction: suggestions.length > 0 ? `Fix the key name (${suggestions.join(", ")}); the full bag contract is in the operation's inputSchema (autotask_describe).` : `Pass only the valid keys (${valid.join(", ")}); the full bag contract is in the operation's inputSchema (autotask_describe).`
-    }
-  );
-}
-var INVOKE_OPTION_KEYS = ["dryRun", "confirm", "lastModifiedDate", "maxRetries", "fresh", "mode"];
-function validateInvokeOptions(opts, operation) {
-  if (opts === void 0 || opts === null) return;
-  const unknown = Object.keys(opts).filter((k) => !INVOKE_OPTION_KEYS.includes(k));
-  if (unknown.length === 0) return;
-  const suggestions = keySuggestions(unknown, ["dryRun", "confirm", "lastModifiedDate", "maxRetries", "fresh"]);
-  throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-    `invoke: "${operation}" has unknown option key(s) ${unknown.map((k) => `"${k}"`).join(", ")} \u2014 the options set is closed (valid: dryRun, confirm, lastModifiedDate, maxRetries, fresh; "mode" is internal to the mode wrappers)`,
-    {
-      operation,
-      suggestedAction: suggestions.length > 0 ? `Fix the option name (${suggestions.join(", ")}).` : `Pass only dryRun / confirm / lastModifiedDate / maxRetries / fresh.`
-    }
-  );
-}
-function unknownKeysRefusal(raw, validKeys, subject, operation) {
-  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) return null;
-  const unknown = Object.keys(raw).filter((k) => !validKeys.includes(k));
-  if (unknown.length === 0) return null;
-  const suggestions = keySuggestions(unknown, [...validKeys]);
-  return new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-    `unknown ${subject} ${unknown.map((k) => `"${k}"`).join(", ")} \u2014 the ${subject} set is closed (valid keys: ${validKeys.join(", ")})`,
-    {
-      ...operation !== void 0 ? { operation } : {},
-      suggestedAction: suggestions.length > 0 ? operation === void 0 ? `Fix the ${subject} name (${suggestions.join(", ")}); the tool's full contract is in the tool's inputSchema, served by the MCP client's list_tools.` : `Fix the ${subject} name (${suggestions.join(", ")}); the full contract is in the tool's inputSchema (autotask_describe).` : `Pass only the valid keys (${validKeys.join(", ")}).`
-    }
-  );
-}
-
-// src/operations/scopeGuard.ts
-var PROPAGATE_CODES = /* @__PURE__ */ new Set([
-  "ABORTED",
-  "UNAUTHORIZED",
-  "FORBIDDEN",
-  "HOST_POLICY_DENIED",
-  "RATE_LIMITED",
-  "RATE_LIMITED_COOLDOWN"
-]);
-function hasIdScope(filter) {
-  if (Array.isArray(filter)) return filter.some(hasIdScope);
-  if (filter === null || typeof filter !== "object") return false;
-  const n = filter;
-  const op = typeof n.op === "string" ? n.op.toLowerCase() : "";
-  if (Array.isArray(n.items)) return op === "and" && n.items.some(hasIdScope);
-  if (Array.isArray(n.filter)) return hasIdScope(n.filter);
-  if (typeof n.field !== "string" || !(n.field === "id" || /ID$/.test(n.field))) return false;
-  const real = (v) => v !== void 0 && v !== null && v !== "";
-  const list = Array.isArray(n.value) ? n.value : typeof n.value === "string" ? n.value.split(",").map((t) => t.trim()) : [];
-  return op === "eq" && real(n.value) || op === "in" && list.some(real);
-}
-async function guardUnscopedQueryWalk(holder, operation, bag) {
-  const filter = _optionalChain([bag, 'optionalAccess', _55 => _55["filter"]]);
-  const limit = _optionalChain([bag, 'optionalAccess', _56 => _56["limit"]]);
-  const latest = _optionalChain([bag, 'optionalAccess', _57 => _57["latest"]]);
-  const walk = typeof _optionalChain([bag, 'optionalAccess', _58 => _58["walk"]]) === "object" && _optionalChain([bag, 'optionalAccess', _59 => _59["walk"]]) !== null ? _optionalChain([bag, 'optionalAccess', _60 => _60["walk"]]) : void 0;
-  const maxRows = typeof _optionalChain([walk, 'optionalAccess', _61 => _61.maxRows]) === "number" ? walk.maxRows : void 0;
-  const effectiveLimit = typeof limit === "number" ? limit : _chunkVFLAMMIJcjs.BOUNDED_QUERY_DEFAULT_LIMIT;
-  let walked = typeof latest === "number" ? Math.max(effectiveLimit, latest) : effectiveLimit;
-  if (maxRows !== void 0) walked = Math.min(walked, maxRows);
-  if (walked <= _chunkVFLAMMIJcjs.UNSCOPED_WALK_THRESHOLD || hasIdScope(filter)) return {};
-  let conditions;
-  try {
-    conditions = _chunkVFLAMMIJcjs.normalizedConditions.call(void 0, filter);
-  } catch (e) {
-    return {};
-  }
-  let counted;
-  try {
-    counted = await holder.count({ filter: conditions === void 0 ? void 0 : conditions });
-  } catch (err) {
-    const code = _optionalChain([err, 'optionalAccess', _62 => _62.code]);
-    if (typeof code === "string" && PROPAGATE_CODES.has(code)) throw err;
-    const label = typeof code === "string" && /^[A-Z][A-Z_]{2,40}$/.test(code) ? ` (${code})` : "";
-    return { note: `scope check skipped: the pre-flight count failed${label}; this unscoped walk was not guarded.` };
-  }
-  const sentinel = typeof counted === "object" && counted !== null && "count" in counted ? counted : { count: counted };
-  if (sentinel.blindSurface !== void 0) {
-    return { note: "scope check skipped: the count surface is blind (a 0 is not a true zero); this unscoped walk was not guarded." };
-  }
-  const count = typeof sentinel.count === "number" && Number.isFinite(sentinel.count) && sentinel.count >= 0 ? sentinel.count : void 0;
-  if (count === void 0) {
-    return { note: "scope check skipped: the pre-flight count was unreadable; this unscoped walk was not guarded." };
-  }
-  if (count > _chunkVFLAMMIJcjs.UNSCOPED_WALK_THRESHOLD) throw new (0, _chunkVFLAMMIJcjs.ScopeRequiredError)(operation, { threshold: _chunkVFLAMMIJcjs.UNSCOPED_WALK_THRESHOLD, count });
-  return {};
-}
-
-// src/operations/invoke/dispatch.ts
-var INVOKE_MAX_INLINE_BYTES = 1024 * 1024;
-function bufferResult(buf) {
-  if (buf.byteLength <= INVOKE_MAX_INLINE_BYTES) {
-    return { encoding: "base64", byteLength: buf.byteLength, truncated: false, data: buf.toString("base64") };
-  }
-  return {
-    encoding: "base64",
-    byteLength: buf.byteLength,
-    truncated: true,
-    note: `Body exceeds the ${INVOKE_MAX_INLINE_BYTES}-byte inline limit and was not returned; call the resource's download method directly.`
-  };
-}
-function resolveRecord(operation) {
-  const record = OPERATION_BY_ID.get(operation);
-  if (record === void 0) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-      `invoke: unknown operation "${operation}" \u2014 it is not in the capability registry`,
-      { operation, suggestedAction: "List the registry (the ./capabilities subpath) for the exact operation key." }
-    );
-  }
-  return record;
-}
-function governPreRequest(record, operation, opts) {
-  validateInvokeOptions(opts, operation);
-  const mode = opts.mode;
-  if (mode !== void 0 && MODE_BY_EFFECT[record.effect] !== mode) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(crossModeRefusal(operation, record.effect, mode), { operation });
-  }
-  if (opts.dryRun !== void 0 && typeof opts.dryRun !== "boolean") {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-      `invoke: dryRun must be a boolean (got ${typeof opts.dryRun}) \u2014 "${operation}" was not issued`,
-      { operation, suggestedAction: "Pass dryRun: true (simulate) or dryRun: false (apply) as a real boolean." }
-    );
-  }
-  if (opts.fresh !== void 0) {
-    if (typeof opts.fresh !== "boolean") {
-      throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-        `invoke: fresh must be a boolean (got ${typeof opts.fresh}) \u2014 "${operation}" was not issued`,
-        { operation, suggestedAction: "Pass fresh: true (bypass the read cache) or omit it." }
-      );
-    }
-    if (record.effect !== "read" || record.kind !== "primitive" || record.operation !== "get" || !("opts" in (_nullishCoalesce(record.inputSchema, () => ( {}))))) {
-      throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-        `invoke: fresh applies only to a single-record "<resource>.get" read \u2014 "${operation}" was not issued`,
-        { operation, suggestedAction: "Drop the fresh option (only <resource>.get consults the read cache per call)." }
-      );
-    }
-  }
-  if (record.effect === "read" && opts.dryRun === true) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-      `invoke: "${operation}" is a read \u2014 dryRun is not applicable (reads issue their request as-is)`,
-      { operation }
-    );
-  }
-  if (needsConfirmation(record) && opts.confirm !== operation) {
-    refuse(
-      `invoke: "${operation}" is ${record.effect}${(_nullishCoalesce(record.flags, () => ( []))).includes("requiresApproval") ? " approval-gated" : ""} and requires its confirmation flag: pass confirm: "${operation}"`,
-      operation,
-      "Pass confirm equal to the operation key to acknowledge the deliberate act."
-    );
-  }
-}
-function operationsHolder(client) {
-  return {
-    resolveAny: (identifier, opts) => resolveAny(client, identifier, opts),
-    searchAcrossResources: (query, opts) => searchAcrossResources(client, query, opts),
-    fetchMany: (items, opts) => _chunkVFLAMMIJcjs.fetchMany.call(void 0, client, items, opts),
-    // Issue #62: the generic aggregate + the cheap count — the
-    // groupBy/sum-absent mode is ONE vendor /query/count (the S12-C blind
-    // sentinel rides through); the group/sum modes walk the named
-    // <resource>.query op via the house bounded walk and fold client-side
-    // (truncation honesty: hasMore/totalScanned — no silent partial sums).
-    aggregate: (operation, filter, opts) => aggregate(client, operation, filter, opts),
-    // Issue #234: revenue by dimension in one budgeted call (refuses over budget, never partial).
-    revenueRollup: (opts) => revenueRollup(client, opts),
-    // Issue #59 PR-B: the bulk fetch by ids — query-first chunked `id in`
-    // reads + the per-id `get` fallback (blind-surface-safe; per-item
-    // typed outcomes reuse the fetchMany shapes).
-    fetchByIds: (items, opts) => _chunkVFLAMMIJcjs.fetchByIds.call(void 0, client, items, opts),
-    // Issue #65: opt-in resource name expansion — per-id resources.get
-    // reads ONLY (never an id-in query — the resources table can be blind
-    // to count/query while per-id reads work); blind-marked rows for ids
-    // the API user cannot resolve; the read cache (default-on).
-    expandResourceNames: (ids, opts) => _chunkVFLAMMIJcjs.expandResourceNames.call(void 0, client, ids, opts),
-    relationshipMap: (resourceKey) => relationshipMap(client, resourceKey),
-    // Issue #11: the served blind-surface inventory (zero wire) + the
-    // bounded caller-opted reachability sweep (read-only, confirmProbe-
-    // required — the op's own pre-request gates keep it deliberate).
-    blindSurfaces: (opts) => blindSurfaces(client, opts),
-    probeReachability: (opts) => probeReachability(client, opts),
-    // Issue #12: the served zone-fact create-guidance catalog (zero wire).
-    createGuidance: (opts) => createGuidance(client, opts),
-    // Issue #202: ExecuteCommand deep links — pure, zero wire.
-    uiLink: (input) => _chunkVFLAMMIJcjs.uiLink.call(void 0, client, input),
-    // Issue #287 (D8): the projection-layer untrusted-content helper — pure,
-    // zero wire (the registry record's metadata.untrustedFields + the deep
-    // walker from src/untrusted.ts; an unknown operation refuses).
-    sanitiseResult: (result, operation) => sanitiseResult(client, result, operation),
-    // Issue #31: the opt-in live field-metadata channel — N bounded
-    // entityInformation GETs (the op's own cap refuses over-cap fan-outs
-    // pre-request; per-resource failures are recorded on the row and
-    // never abort the call).
-    fieldCatalog: (opts) => _chunkVFLAMMIJcjs.fieldCatalog.call(void 0, client, opts),
-    // Issue #9: the one-call recovery/cleanup op — effect write in the
-    // registry (the governor's dry-run-first applies to it); the op's own
-    // confirm gate makes the destructive action deliberate (the governor
-    // forwards the caller's confirm through the trailing bag below).
-    recovery: (input, opts) => recovery(client, input, opts)
-  };
-}
-function resolveHolder(client, record, operation) {
-  const clientBag = client;
-  let holder = clientBag[_chunkVFLAMMIJcjs.camelKey.call(void 0, record.resource)];
-  if (typeof holder === "function") {
-    holder = _nullishCoalesce(clientBag[`${_chunkVFLAMMIJcjs.camelKey.call(void 0, record.resource)}Resource`], () => ( holder));
-  }
-  if (holder === void 0 && record.resource === "operations") {
-    holder = operationsHolder(client);
-  }
-  if (holder === void 0) {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-      `invoke: the client exposes no accessor for resource "${record.resource}"`,
-      { operation }
-    );
-  }
-  return holder;
-}
-var BAG_RIDING_ARGS = {
-  createIfNotExists: ["dedupFields"],
-  moveConfigurationItem: ["destinationCompanyId"]
-};
-function buildMutationOpts(opts, isWrite) {
-  const dryRun = isWrite ? opts.dryRun !== false : false;
-  const mutationOpts = { dryRun };
-  if (isWrite && opts.lastModifiedDate !== void 0) {
-    mutationOpts.lastModifiedDate = opts.lastModifiedDate;
-  }
-  if (isWrite && opts.maxRetries !== void 0) {
-    mutationOpts.maxRetries = opts.maxRetries;
-  }
-  if (isWrite && opts.confirm !== void 0) {
-    mutationOpts.confirm = opts.confirm;
-  }
-  return mutationOpts;
-}
-function buildCallArgs(record, args, mutationOpts, isWrite) {
-  const declaredNames = Object.keys(_nullishCoalesce(record.inputSchema, () => ( {})));
-  const bagRiding = new Set(_nullishCoalesce(BAG_RIDING_ARGS[record.operation], () => ( [])));
-  let positional = args;
-  for (const argName of _nullishCoalesce(BAG_RIDING_ARGS[record.operation], () => ( []))) {
-    const at = declaredNames.indexOf(argName);
-    if (at >= 0 && args.length > at) {
-      mutationOpts[argName] = args[at];
-      positional = positional.slice(0, at);
-    }
-  }
-  const callArgs = [...positional];
-  if (isWrite) {
-    const declaredPositional = declaredNames.filter((n) => !bagRiding.has(n));
-    while (callArgs.length < declaredPositional.length) callArgs.push(void 0);
-    callArgs.push(mutationOpts);
-  }
-  return callArgs;
-}
-function appendFresh(record, callArgs) {
-  const at = Object.keys(_nullishCoalesce(record.inputSchema, () => ( {}))).indexOf("opts");
-  while (callArgs.length < at) callArgs.push(void 0);
-  callArgs[at] = { fresh: true };
-  return callArgs;
-}
-function validateFreshSpelling(record, args) {
-  if (record.kind !== "primitive" || record.operation !== "get") return;
-  const at = Object.keys(_nullishCoalesce(record.inputSchema, () => ( {}))).indexOf("opts");
-  const bag = at < 0 ? void 0 : args[at];
-  if (bag === void 0 || bag === null) return;
-  throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-    `invoke: "${record.id}" takes no positional options bag \u2014 the fresh spelling is the fresh invoke option (pass { fresh: true } in the invoke options, not as a method argument)`,
-    {
-      operation: record.id,
-      suggestedAction: 'Pass fresh: true as an invoke option: invoke(client, "<resource>.get", [id], { fresh: true }). The typed client.<resource>.get(id, { fresh: true }) method keeps its own bag.'
-    }
-  );
-}
-var PRE_REQUEST_VALIDATORS = [
-  (c) => governPreRequest(c.record, c.operation, c.opts),
-  (c) => validateDispatchArgs(c.record, c.args),
-  (c) => validateParamsBag(c.record, c.args),
-  (c) => validateFreshSpelling(c.record, c.args),
-  (c) => c.boundedQuery || c.countedQuery ? _chunkVFLAMMIJcjs.validateQueryFieldNames.call(void 0, c.record, c.holder, c.args) : Promise.resolve(void 0)
-];
-async function runPreRequestPass(ctx) {
-  for (const step of PRE_REQUEST_VALIDATORS) await step(ctx);
-}
-async function invokeMode(client, operation, argsIn = [], opts = {}) {
-  const record = resolveRecord(operation);
-  const args = resolveDispatchArgs(record, argsIn);
-  const boundedQuery = record.kind === "primitive" && record.operation === "query";
-  const countedQuery = record.kind === "primitive" && record.operation === "count";
-  const holder = resolveHolder(client, record, operation);
-  await runPreRequestPass({ record, operation, args, opts, client, holder, boundedQuery, countedQuery });
-  const labelQuery = boundedQuery && _chunkVFLAMMIJcjs.readNamesOpt.call(void 0, client, _optionalChain([args, 'access', _63 => _63[0], 'optionalAccess', _64 => _64["names"]]), `invoke: "${record.id}" params bag`);
-  const methodName = boundedQuery ? "queryBounded" : record.operation;
-  const method = holder[methodName];
-  if (typeof method !== "function") {
-    throw new (0, _chunkVFLAMMIJcjs.AutotaskConfigError)(
-      `invoke: "${record.resource}.${methodName}" is not a callable method on the client`,
-      { operation }
-    );
-  }
-  const isWrite = record.effect !== "read";
-  const mutationOpts = buildMutationOpts(opts, isWrite);
-  const callArgs = buildCallArgs(record, args, mutationOpts, isWrite);
-  if (opts.fresh === true) appendFresh(record, callArgs);
-  if (boundedQuery) _chunkVFLAMMIJcjs.validateWalkBag.call(void 0, _optionalChain([args, 'access', _65 => _65[0], 'optionalAccess', _66 => _66["walk"]]), `invoke: "${record.id}"`, { operation: record.id });
-  let scopeNote;
-  if (boundedQuery && _optionalChain([args, 'access', _67 => _67[0], 'optionalAccess', _68 => _68["acknowledgeUnscoped"]]) !== true) {
-    scopeNote = (await guardUnscopedQueryWalk(holder, record.id, args[0])).note;
-  }
-  const result = await method.apply(holder, callArgs);
-  if (labelQuery && Array.isArray(_optionalChain([result, 'optionalAccess', _69 => _69.items]))) {
-    const bounded = result;
-    const labelled = await _chunkVFLAMMIJcjs.labelRows.call(void 0, client, record.resource, bounded.items);
-    return { ...bounded, items: labelled.rows, ...labelled.names !== void 0 ? { names: labelled.names } : {}, ...scopeNote !== void 0 ? { scopeNote } : {} };
-  }
-  const finished = Buffer.isBuffer(result) ? bufferResult(result) : result;
-  return scopeNote !== void 0 && finished !== null && typeof finished === "object" ? { ...finished, scopeNote } : finished;
-}
-async function invoke(client, operation, args = [], opts = {}) {
-  return invokeMode(client, operation, args, { ...opts, mode: void 0 });
-}
-async function invokeRead(client, operation, args = [], opts = {}) {
-  return invokeMode(client, operation, args, { ...opts, mode: "read" });
-}
-async function invokeWrite(client, operation, args = [], opts = {}) {
-  return invokeMode(client, operation, args, { ...opts, mode: "write" });
-}
-async function invokeDelete(client, operation, args = [], opts = {}) {
-  return invokeMode(client, operation, args, { ...opts, mode: "delete" });
-}
 
 
 
@@ -2272,48 +87,4 @@ async function invokeDelete(client, operation, args = [], opts = {}) {
 
 
 
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-exports.AGGREGATE_DATE_BUCKETS = AGGREGATE_DATE_BUCKETS; exports.AGGREGATE_DEFAULT_LIMIT = AGGREGATE_DEFAULT_LIMIT; exports.AGGREGATE_DEFAULT_TOP = AGGREGATE_DEFAULT_TOP; exports.AGGREGATE_TOP_MAX = AGGREGATE_TOP_MAX; exports.BLIND_SURFACE_KINDS = BLIND_SURFACE_KINDS; exports.CREATE_BLOCKER_KINDS = CREATE_BLOCKER_KINDS; exports.EXPAND_RESOURCE_NAMES_MAX_IDS = _chunkVFLAMMIJcjs.EXPAND_RESOURCE_NAMES_MAX_IDS; exports.FETCH_BY_IDS_CHUNK_SIZE = _chunkVFLAMMIJcjs.FETCH_BY_IDS_CHUNK_SIZE; exports.FETCH_BY_IDS_MAX_ITEMS = _chunkVFLAMMIJcjs.FETCH_BY_IDS_MAX_ITEMS; exports.FETCH_MANY_MAX_ITEMS = _chunkVFLAMMIJcjs.FETCH_MANY_MAX_ITEMS; exports.FIELD_CACHE_KINDS = _chunkVFLAMMIJcjs.FIELD_CACHE_KINDS; exports.FIELD_CATALOG_HONESTY_NOTE = _chunkVFLAMMIJcjs.FIELD_CATALOG_HONESTY_NOTE; exports.INVOKE_OPTION_KEYS = INVOKE_OPTION_KEYS; exports.MAX_FIELD_CATALOG_WIRE = _chunkVFLAMMIJcjs.MAX_FIELD_CATALOG_WIRE; exports.MIN_FIELD_CATALOG_MAX_BYTES = _chunkVFLAMMIJcjs.MIN_FIELD_CATALOG_MAX_BYTES; exports.PARAMS_BAG_KEYS = PARAMS_BAG_KEYS; exports.PICKLIST_VALUE_NOT_SERVED_NOTE = _chunkVFLAMMIJcjs.PICKLIST_VALUE_NOT_SERVED_NOTE; exports.RECOVERY_CONFIRM = RECOVERY_CONFIRM; exports.RECOVERY_DEFAULT_LIMIT = RECOVERY_DEFAULT_LIMIT; exports.RECOVERY_MAX_LIMIT = RECOVERY_MAX_LIMIT; exports.UI_LINK_ENTITIES = _chunkVFLAMMIJcjs.UI_LINK_ENTITIES; exports.WORKFLOW_RESOURCES = _chunkVFLAMMIJcjs.WORKFLOW_RESOURCES; exports.aggregate = aggregate; exports.blindSurfaces = blindSurfaces; exports.buildUiLink = _chunkVFLAMMIJcjs.buildUiLink; exports.createGuidance = createGuidance; exports.dateBucketLabel = dateBucketLabel; exports.effectiveRequiredFields = _chunkVFLAMMIJcjs.effectiveRequiredFields; exports.expandResourceNames = _chunkVFLAMMIJcjs.expandResourceNames; exports.fetchByIds = _chunkVFLAMMIJcjs.fetchByIds; exports.fetchMany = _chunkVFLAMMIJcjs.fetchMany; exports.fieldCatalog = _chunkVFLAMMIJcjs.fieldCatalog; exports.foldFlattenedOpts = foldFlattenedOpts; exports.invoke = invoke; exports.invokeDelete = invokeDelete; exports.invokeRead = invokeRead; exports.invokeWrite = invokeWrite; exports.needsConfirmation = needsConfirmation; exports.probeReachability = probeReachability; exports.recovery = recovery; exports.relationshipMap = relationshipMap; exports.resolveAny = resolveAny; exports.revenueRollup = revenueRollup; exports.sanitiseResult = sanitiseResult; exports.searchAcrossResources = searchAcrossResources; exports.uiLink = _chunkVFLAMMIJcjs.uiLink; exports.unknownKeysRefusal = unknownKeysRefusal; exports.validateDispatchArgs = validateDispatchArgs; exports.validateFetchManyItems = _chunkVFLAMMIJcjs.validateFetchManyItems; exports.validateInvokeOptions = validateInvokeOptions; exports.validateParamsBag = validateParamsBag;
+exports.AGGREGATE_DATE_BUCKETS = _chunkYMBVKVK4cjs.AGGREGATE_DATE_BUCKETS; exports.AGGREGATE_DEFAULT_LIMIT = _chunkYMBVKVK4cjs.AGGREGATE_DEFAULT_LIMIT; exports.AGGREGATE_DEFAULT_TOP = _chunkYMBVKVK4cjs.AGGREGATE_DEFAULT_TOP; exports.AGGREGATE_TOP_MAX = _chunkYMBVKVK4cjs.AGGREGATE_TOP_MAX; exports.CREATE_BLOCKER_KINDS = _chunkYMBVKVK4cjs.CREATE_BLOCKER_KINDS; exports.EXPAND_RESOURCE_NAMES_MAX_IDS = _chunkYMBVKVK4cjs.EXPAND_RESOURCE_NAMES_MAX_IDS; exports.FETCH_BY_IDS_CHUNK_SIZE = _chunkYMBVKVK4cjs.FETCH_BY_IDS_CHUNK_SIZE; exports.FETCH_BY_IDS_MAX_ITEMS = _chunkYMBVKVK4cjs.FETCH_BY_IDS_MAX_ITEMS; exports.FIELD_CACHE_KINDS = _chunkYMBVKVK4cjs.FIELD_CACHE_KINDS; exports.FIELD_CATALOG_HONESTY_NOTE = _chunkYMBVKVK4cjs.FIELD_CATALOG_HONESTY_NOTE; exports.INVOKE_OPTION_KEYS = _chunkYMBVKVK4cjs.INVOKE_OPTION_KEYS; exports.MAX_FIELD_CATALOG_WIRE = _chunkYMBVKVK4cjs.MAX_FIELD_CATALOG_WIRE; exports.MIN_FIELD_CATALOG_MAX_BYTES = _chunkYMBVKVK4cjs.MIN_FIELD_CATALOG_MAX_BYTES; exports.PARAMS_BAG_KEYS = _chunkYMBVKVK4cjs.PARAMS_BAG_KEYS; exports.PICKLIST_VALUE_NOT_SERVED_NOTE = _chunkYMBVKVK4cjs.PICKLIST_VALUE_NOT_SERVED_NOTE; exports.UI_LINK_ENTITIES = _chunkYMBVKVK4cjs.UI_LINK_ENTITIES; exports.WORKFLOW_RESOURCES = _chunkYMBVKVK4cjs.WORKFLOW_RESOURCES; exports.aggregate = _chunkYMBVKVK4cjs.aggregate; exports.buildUiLink = _chunkYMBVKVK4cjs.buildUiLink; exports.createGuidance = _chunkYMBVKVK4cjs.createGuidance; exports.dateBucketLabel = _chunkYMBVKVK4cjs.dateBucketLabel; exports.effectiveRequiredFields = _chunkYMBVKVK4cjs.effectiveRequiredFields; exports.expandResourceNames = _chunkYMBVKVK4cjs.expandResourceNames; exports.fetchByIds = _chunkYMBVKVK4cjs.fetchByIds; exports.fieldCatalog = _chunkYMBVKVK4cjs.fieldCatalog; exports.foldFlattenedOpts = _chunkYMBVKVK4cjs.foldFlattenedOpts; exports.invoke = _chunkYMBVKVK4cjs.invoke; exports.invokeDelete = _chunkYMBVKVK4cjs.invokeDelete; exports.invokeRead = _chunkYMBVKVK4cjs.invokeRead; exports.invokeWrite = _chunkYMBVKVK4cjs.invokeWrite; exports.needsConfirmation = _chunkYMBVKVK4cjs.needsConfirmation; exports.relationshipMap = _chunkYMBVKVK4cjs.relationshipMap; exports.resolveAny = _chunkYMBVKVK4cjs.resolveAny; exports.resolveStaff = _chunkYMBVKVK4cjs.resolveStaff; exports.revenueRollup = _chunkYMBVKVK4cjs.revenueRollup; exports.sanitiseResult = _chunkYMBVKVK4cjs.sanitiseResult; exports.searchAcrossResources = _chunkYMBVKVK4cjs.searchAcrossResources; exports.uiLink = _chunkYMBVKVK4cjs.uiLink; exports.unknownKeysRefusal = _chunkYMBVKVK4cjs.unknownKeysRefusal; exports.validateDispatchArgs = _chunkYMBVKVK4cjs.validateDispatchArgs; exports.validateInvokeOptions = _chunkYMBVKVK4cjs.validateInvokeOptions; exports.validateParamsBag = _chunkYMBVKVK4cjs.validateParamsBag;