node-autotask 0.21.0 → 0.23.0

package/dist/operations/index.cjs

@@ -37,44 +37,63 @@
 
 
 
-var _chunkQWAWNQEZcjs = require('../chunk-QWAWNQEZ.cjs');
 
 
-var _chunkCBUY3MKBcjs = require('../chunk-CBUY3MKB.cjs');
+
+var _chunkD5TVBI4Ucjs = require('../chunk-D5TVBI4U.cjs');
+
+
+var _chunkJUO3URUIcjs = require('../chunk-JUO3URUI.cjs');
 
 // src/operations/searchAcrossResources.ts
 var DEFAULT_LIMIT = 25;
 function resourceFor(client, key) {
-  return client[_chunkQWAWNQEZcjs.camelKey.call(void 0, key)];
+  return client[_chunkD5TVBI4Ucjs.camelKey.call(void 0, key)];
 }
 async function searchAcrossResources(client, query, opts = {}) {
   const text = query.trim();
   if (text === "") {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)("searchAcrossResources: query must be a non-empty string");
+    throw new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)("searchAcrossResources: query must be a non-empty string");
   }
-  const keys = _nullishCoalesce(opts.resources, () => ( _chunkQWAWNQEZcjs.WORKFLOW_RESOURCES));
+  const keys = _nullishCoalesce(opts.resources, () => ( _chunkD5TVBI4Ucjs.WORKFLOW_RESOURCES));
   if (keys.length === 0) {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)("searchAcrossResources: no resources requested");
+    throw new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)("searchAcrossResources: no resources requested");
+  }
+  const limit = _chunkD5TVBI4Ucjs.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, _chunkD5TVBI4Ucjs.AutotaskConfigError)("searchAcrossResources: totalLimit must be a positive integer");
   }
-  const limit = _chunkQWAWNQEZcjs.clampPageSize.call(void 0, _nullishCoalesce(opts.limit, () => ( DEFAULT_LIMIT)));
   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;
     }
-    const matches = await holder.search(text, { limit });
+    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;
   }
-  return { query: text, results, skipped };
+  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[_chunkQWAWNQEZcjs.camelKey.call(void 0, key)];
+  return client[_chunkD5TVBI4Ucjs.camelKey.call(void 0, key)];
 }
 var FAULT_CATEGORIES = /* @__PURE__ */ new Set(["auth", "rate_limit", "server", "network", "timeout", "policy"]);
 function missCost(identifier) {
@@ -83,13 +102,13 @@ function missCost(identifier) {
 }
 async function resolveAny(client, identifier, opts = {}) {
   if (typeof identifier === "number") {
-    _chunkQWAWNQEZcjs.parseIdentifier.call(void 0, identifier, "identifier");
+    _chunkD5TVBI4Ucjs.parseIdentifier.call(void 0, identifier, "identifier");
   } else if (identifier.trim() === "") {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)("resolveAny: identifier must be non-empty");
+    throw new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)("resolveAny: identifier must be non-empty");
   }
-  const keys = _nullishCoalesce(opts.resources, () => ( _chunkQWAWNQEZcjs.WORKFLOW_RESOURCES));
+  const keys = _nullishCoalesce(opts.resources, () => ( _chunkD5TVBI4Ucjs.WORKFLOW_RESOURCES));
   if (keys.length === 0) {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)("resolveAny: no resources requested");
+    throw new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)("resolveAny: no resources requested");
   }
   const results = [];
   for (const key of keys) {
@@ -119,9 +138,9 @@ async function resolveAny(client, identifier, opts = {}) {
     } catch (err) {
       let code;
       let candidates = [];
-      if (err instanceof _chunkQWAWNQEZcjs.AutotaskConfigError) {
+      if (err instanceof _chunkD5TVBI4Ucjs.AutotaskConfigError) {
         code = "CONFIG_ERROR";
-      } else if (_chunkQWAWNQEZcjs.isAutotaskError.call(void 0, err)) {
+      } else if (_chunkD5TVBI4Ucjs.isAutotaskError.call(void 0, err)) {
         if (FAULT_CATEGORIES.has(err.category)) throw err;
         code = err.code;
         if (code === "RESOLUTION_AMBIGUOUS" && err.resourceIds !== void 0) {
@@ -148,7 +167,7 @@ async function resolveAny(client, identifier, opts = {}) {
 // src/operations/aggregate.ts
 var AGGREGATE_TOP_MAX = 100;
 var AGGREGATE_DEFAULT_TOP = 25;
-var AGGREGATE_DEFAULT_LIMIT = _chunkQWAWNQEZcjs.BOUNDED_QUERY_MAX_LIMIT;
+var AGGREGATE_DEFAULT_LIMIT = _chunkD5TVBI4Ucjs.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})?$/;
@@ -205,7 +224,7 @@ function dateBucketLabel(value, bucket) {
 }
 var QUERY_RESOURCE_KEYS = (() => {
   const s = /* @__PURE__ */ new Set();
-  for (const rec of _chunkCBUY3MKBcjs.CAPABILITIES) if (rec.operation === "query") s.add(rec.resource);
+  for (const rec of _chunkJUO3URUIcjs.CAPABILITIES) if (rec.operation === "query") s.add(rec.resource);
   return s;
 })();
 var AGGREGATE_OPT_KEYS = ["groupBy", "sum", "top", "limit"];
@@ -213,41 +232,43 @@ var OP_RE = /^([a-z0-9_]+)\.query$/;
 function num(v) {
   return typeof v === "number" && Number.isFinite(v) ? v : 0;
 }
-function validateAggregate(operation, filter, opts) {
-  const problems = [];
-  let resourceKey;
+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`
     );
-  } else {
-    const key = OP_RE.exec(operation)[1];
-    resourceKey = key;
-    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 void 0;
   }
-  let conditions = [];
+  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) {
-    conditions = [];
-  } else {
-    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: [...] })");
-    } else if (conds.length === 0) {
-      conditions = [];
-    } else {
-      try {
-        conditions = _chunkQWAWNQEZcjs.buildFilter.call(void 0, conds).filter;
-      } catch (err) {
-        problems.push(err instanceof _chunkQWAWNQEZcjs.AutotaskConfigError ? err.message : `filter must be the query-bag filter (13 operators; caps 500 OR-conditions / 1 UDF / 8000 chars); ${String(err)}`);
-      }
-    }
+    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 _chunkD5TVBI4Ucjs.buildFilter.call(void 0, conds).filter;
+  } catch (err) {
+    problems.push(err instanceof _chunkD5TVBI4Ucjs.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, _chunkQWAWNQEZcjs.AutotaskConfigError)(
+    throw new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)(
       `aggregate: opts must be the options object (got ${Array.isArray(opts) ? "an array" : typeof opts})`,
       { operation: "operations.aggregate" }
     );
@@ -257,58 +278,63 @@ function validateAggregate(operation, filter, opts) {
       problems.push(`unknown opts key "${key}" \u2014 the bag is closed: ${AGGREGATE_OPT_KEYS.join(", ")}`);
     }
   }
-  const fieldSets = resourceKey !== void 0 ? _chunkQWAWNQEZcjs.MODEL_FIELD_SETS[resourceKey] : void 0;
-  const dateSets = resourceKey !== void 0 ? _chunkQWAWNQEZcjs.MODEL_DATE_FIELDS[resourceKey] : void 0;
-  const checkFields = (name, fields) => {
-    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 [];
+}
+function checkSumFields(name, fields, oracles, 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 [];
+  }
+  const out = [];
+  for (const f of fields) {
+    if (oracles.fieldSets === void 0 || !oracles.fieldSets.includes(f)) {
+      problems.push(`${name}: "${f}" is not a field of ${oracles.resourceKey} \u2014 a hallucinated field is a shape error, not a silent fold-miss (exact vendor field names via operations.fieldCatalog)`);
+    } else {
+      out.push(f);
     }
-    const out = [];
-    for (const f of fields) {
-      if (fieldSets === void 0 || !fieldSets.includes(f)) {
-        problems.push(`${name}: "${f}" 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)`);
-      } else {
-        out.push(f);
-      }
+  }
+  return out;
+}
+function parseGroupSpec(f, oracles, problems) {
+  const { resourceKey, fieldSets, dateSets } = oracles;
+  const at = f.indexOf("@");
+  if (at === -1) {
+    if (fieldSets === void 0 || !fieldSets.includes(f)) {
+      problems.push(`groupBy: "${f}" 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)`);
+      return void 0;
     }
-    return out;
-  };
+    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 (fieldSets === void 0 || !fieldSets.includes(base)) {
+    problems.push(`groupBy: "${f}": "${base}" 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)`);
+    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, problems) {
   const groupBy = [];
-  if (opts.groupBy !== void 0) {
-    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)");
-    } else {
-      for (const f of opts.groupBy) {
-        const at = f.indexOf("@");
-        if (at === -1) {
-          if (fieldSets === void 0 || !fieldSets.includes(f)) {
-            problems.push(`groupBy: "${f}" 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)`);
-          } else {
-            groupBy.push({ name: f, base: f });
-          }
-          continue;
-        }
-        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)`);
-          continue;
-        }
-        if (fieldSets === void 0 || !fieldSets.includes(base)) {
-          problems.push(`groupBy: "${f}": "${base}" 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)`);
-          continue;
-        }
-        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)`);
-          continue;
-        }
-        groupBy.push({ name: f, base, bucket: suffix });
-      }
-    }
+  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, problems);
+    if (spec !== void 0) groupBy.push(spec);
   }
-  const sum = checkFields("sum", opts.sum);
+  return groupBy;
+}
+function parseTopAndLimit(opts, problems) {
   let top = AGGREGATE_DEFAULT_TOP;
   if (opts.top !== void 0) {
     if (!Number.isInteger(opts.top)) {
@@ -322,11 +348,26 @@ function validateAggregate(operation, filter, opts) {
     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), _chunkQWAWNQEZcjs.BOUNDED_QUERY_MAX_LIMIT);
+      limit = Math.min(Math.max(opts.limit, 1), _chunkD5TVBI4Ucjs.BOUNDED_QUERY_MAX_LIMIT);
     }
   }
+  return { top, limit };
+}
+function validateAggregate(operation, filter, opts) {
+  const problems = [];
+  const resourceKey = parseOperationKey(operation, problems);
+  const conditions = parseFilterConditions(filter, problems);
+  checkOptsBag(opts, problems);
+  const oracles = {
+    resourceKey,
+    fieldSets: resourceKey !== void 0 ? _chunkD5TVBI4Ucjs.MODEL_FIELD_SETS[resourceKey] : void 0,
+    dateSets: resourceKey !== void 0 ? _chunkD5TVBI4Ucjs.MODEL_DATE_FIELDS[resourceKey] : void 0
+  };
+  const groupBy = parseGroupBy(opts, oracles, problems);
+  const sum = checkSumFields("sum", opts.sum, oracles, problems);
+  const { top, limit } = parseTopAndLimit(opts, problems);
   if (problems.length > 0) {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
+    throw new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)(
       `aggregate: ${problems.length} problem(s) found pre-request (zero wire was issued)
 - ` + problems.join("\n- "),
       { operation: "operations.aggregate" }
@@ -334,27 +375,9 @@ function validateAggregate(operation, filter, opts) {
   }
   return { resourceKey, conditions, groupBy, sum, top, limit };
 }
-async function aggregate(client, operation, filter, opts = {}) {
-  const v = validateAggregate(operation, filter, opts);
-  const holder = client[_chunkQWAWNQEZcjs.camelKey.call(void 0, v.resourceKey)];
-  if (holder === void 0) {
-    throw new (0, _chunkQWAWNQEZcjs.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 };
-    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 });
+function foldGroups(items, v) {
   const groups = /* @__PURE__ */ new Map();
-  for (const item of res.items) {
+  for (const item of items) {
     const key = {};
     const values = [];
     for (const spec of v.groupBy) {
@@ -374,7 +397,28 @@ async function aggregate(client, operation, filter, opts = {}) {
       for (const f of v.sum) g.sums[f] = (_nullishCoalesce(g.sums[f], () => ( 0))) + num(item[f]);
     }
   }
-  const sorted = [...groups.values()].sort((a, b) => b.count - a.count || (a.keyOrder < b.keyOrder ? -1 : a.keyOrder > b.keyOrder ? 1 : 0));
+  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 = validateAggregate(operation, filter, opts);
+  const holder = client[_chunkD5TVBI4Ucjs.camelKey.call(void 0, v.resourceKey)];
+  if (holder === void 0) {
+    throw new (0, _chunkD5TVBI4Ucjs.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 };
+    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 result = {
     mode: v.groupBy.length > 0 ? "group" : "sum",
@@ -393,20 +437,20 @@ async function aggregate(client, operation, filter, opts = {}) {
 async function relationshipMap(client, resourceKey) {
   void client;
   if (typeof resourceKey !== "string" || resourceKey.trim() === "") {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
+    throw new (0, _chunkD5TVBI4Ucjs.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 = _chunkQWAWNQEZcjs.RELATIONSHIP_MAP[key];
+  const entry = _chunkD5TVBI4Ucjs.RELATIONSHIP_MAP[key];
   if (entry === void 0) {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskError)(
-      `relationshipMap: unknown resource "${key}" \u2014 the plan has ${Object.keys(_chunkQWAWNQEZcjs.RELATIONSHIP_MAP).length} resources`,
+    throw new (0, _chunkD5TVBI4Ucjs.AutotaskError)(
+      `relationshipMap: unknown resource "${key}" \u2014 the plan has ${Object.keys(_chunkD5TVBI4Ucjs.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 ${_chunkQWAWNQEZcjs.RELATIONSHIP_ZONE.label} (${_chunkQWAWNQEZcjs.RELATIONSHIP_ZONE.zone})-verified.`
+        suggestedAction: `Pass the exact plan resource key (snake_case) from autotask_catalog (e.g. tickets, companies, configuration_items). Zone facts served are ${_chunkD5TVBI4Ucjs.RELATIONSHIP_ZONE.label} (${_chunkD5TVBI4Ucjs.RELATIONSHIP_ZONE.zone})-verified.`
       }
     );
   }
@@ -423,24 +467,24 @@ var BLIND_SURFACE_KINDS = [
 async function blindSurfaces(client, opts) {
   void client;
   if (opts !== void 0 && (typeof opts !== "object" || opts === null || Array.isArray(opts))) {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)("blindSurfaces: opts must be an object { resource?: string, kind?: BlindSurfaceKind }");
+    throw new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)("blindSurfaces: opts must be an object { resource?: string, kind?: BlindSurfaceKind }");
   }
-  const inv = _chunkQWAWNQEZcjs.BLIND_SURFACE_INVENTORY;
+  const inv = _chunkD5TVBI4Ucjs.BLIND_SURFACE_INVENTORY;
   if (inv === null) {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)("blindSurfaces: the reachability inventory is absent from the generated artifact \u2014 re-run the build");
+    throw new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)("blindSurfaces: the reachability inventory is absent from the generated artifact \u2014 re-run the build");
   }
   let surfaces = inv.surfaces;
   if (_optionalChain([opts, 'optionalAccess', _ => _.resource]) !== void 0) {
     const key = typeof opts.resource === "string" ? opts.resource.trim() : "";
     if (key === "") {
-      throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
+      throw new (0, _chunkD5TVBI4Ucjs.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, _chunkQWAWNQEZcjs.AutotaskError)(
-        `blindSurfaces: unknown resource "${key}" \u2014 the plan has ${Object.keys(_chunkQWAWNQEZcjs.RELATIONSHIP_MAP).length} resources`,
+      throw new (0, _chunkD5TVBI4Ucjs.AutotaskError)(
+        `blindSurfaces: unknown resource "${key}" \u2014 the plan has ${Object.keys(_chunkD5TVBI4Ucjs.RELATIONSHIP_MAP).length} resources`,
         {
           code: "RESOURCE_UNKNOWN",
           category: "validation",
@@ -452,7 +496,7 @@ async function blindSurfaces(client, opts) {
   }
   if (_optionalChain([opts, 'optionalAccess', _2 => _2.kind]) !== void 0) {
     if (!BLIND_SURFACE_KINDS.includes(opts.kind)) {
-      throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
+      throw new (0, _chunkD5TVBI4Ucjs.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).` }
       );
@@ -465,51 +509,51 @@ async function blindSurfaces(client, opts) {
 // src/operations/probeReachability.ts
 async function probeReachability(client, opts) {
   if (opts !== void 0 && (typeof opts !== "object" || opts === null || Array.isArray(opts))) {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)("probeReachability: opts must be an object { resources?: string[], limit?: 1|2, maxWireCalls?: number, confirmProbe?: true }");
+    throw new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)("probeReachability: opts must be an object { resources?: string[], limit?: 1|2, maxWireCalls?: number, confirmProbe?: true }");
   }
-  const defs = _chunkQWAWNQEZcjs.REACHABILITY_PROBE_DEFAULTS;
+  const defs = _chunkD5TVBI4Ucjs.REACHABILITY_PROBE_DEFAULTS;
   if (_optionalChain([opts, 'optionalAccess', _3 => _3.confirmProbe]) !== true) {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
+    throw new (0, _chunkD5TVBI4Ucjs.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', _4 => _4.limit]), () => ( defs.limitDefault));
   if (!Number.isInteger(limit) || limit < 1 || limit > defs.limitMax) {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
+    throw new (0, _chunkD5TVBI4Ucjs.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', _5 => _5.maxWireCalls]), () => ( defs.defaultCap));
   if (!Number.isInteger(cap) || cap < 1) {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(`probeReachability: maxWireCalls must be a positive integer (got ${String(cap)})`);
+    throw new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)(`probeReachability: maxWireCalls must be a positive integer (got ${String(cap)})`);
   }
   if (cap > defs.hardCap) {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
+    throw new (0, _chunkD5TVBI4Ucjs.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 = _chunkQWAWNQEZcjs.BLIND_SURFACE_INVENTORY;
+  const inv = _chunkD5TVBI4Ucjs.BLIND_SURFACE_INVENTORY;
   if (inv === null) {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)("probeReachability: the reachability inventory is absent from the generated artifact \u2014 re-run the build");
+    throw new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)("probeReachability: the reachability inventory is absent from the generated artifact \u2014 re-run the build");
   }
   let targets;
   if (_optionalChain([opts, 'optionalAccess', _6 => _6.resources]) === void 0) {
     targets = [...defs.defaultTargets];
   } else {
     if (!Array.isArray(opts.resources) || opts.resources.length === 0) {
-      throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)("probeReachability: opts.resources must be a non-empty string[] of plan resource keys (or omit it for the default non-data-full set)");
+      throw new (0, _chunkD5TVBI4Ucjs.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, _chunkQWAWNQEZcjs.AutotaskConfigError)(`probeReachability: opts.resources must contain non-empty plan resource key strings (got ${typeof r === "string" && r.trim() === "" ? "a blank string" : typeof r})`);
+        throw new (0, _chunkD5TVBI4Ucjs.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, _chunkQWAWNQEZcjs.AutotaskError)(
+        throw new (0, _chunkD5TVBI4Ucjs.AutotaskError)(
           `probeReachability: unknown resource "${key}" \u2014 the inventory has ${surfaceCount} surfaces`,
           {
             code: "RESOURCE_UNKNOWN",
@@ -523,7 +567,7 @@ async function probeReachability(client, opts) {
     targets = [...seen];
   }
   if (targets.length > cap) {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
+    throw new (0, _chunkD5TVBI4Ucjs.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.` }
     );
@@ -533,7 +577,7 @@ async function probeReachability(client, opts) {
   for (const resource of targets.sort()) {
     const row = byResource.get(resource);
     if (row === void 0) continue;
-    const holder = client[_chunkQWAWNQEZcjs.camelKey.call(void 0, resource)];
+    const holder = client[_chunkD5TVBI4Ucjs.camelKey.call(void 0, resource)];
     const probeFn = _optionalChain([holder, 'optionalAccess', _7 => _7.queryBounded]);
     if (typeof probeFn !== "function") {
       results.push({
@@ -552,7 +596,7 @@ async function probeReachability(client, opts) {
         probe: { ok: true, wire: 1, error: null }
       });
     } catch (err) {
-      const code = _chunkQWAWNQEZcjs.isAutotaskError.call(void 0, err) ? err.code : "NETWORK_ERROR";
+      const code = _chunkD5TVBI4Ucjs.isAutotaskError.call(void 0, err) ? err.code : "NETWORK_ERROR";
       const message = err instanceof Error ? err.message : String(err);
       results.push({
         ...row,
@@ -580,24 +624,24 @@ var CREATE_BLOCKER_KINDS = [
 async function createGuidance(client, opts) {
   void client;
   if (opts !== void 0 && (typeof opts !== "object" || opts === null || Array.isArray(opts))) {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
+    throw new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)(
       "createGuidance: opts must be an object { resources?: string[], kind?: CreateBlockerKind }"
     );
   }
-  let rows = _chunkQWAWNQEZcjs.CREATE_GUIDANCE.rows;
+  let rows = _chunkD5TVBI4Ucjs.CREATE_GUIDANCE.rows;
   if (_optionalChain([opts, 'optionalAccess', _9 => _9.resources]) !== void 0) {
     if (!Array.isArray(opts.resources) || opts.resources.length === 0) {
-      throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)("createGuidance: opts.resources must be a non-empty string[] of plan resource keys");
+      throw new (0, _chunkD5TVBI4Ucjs.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, _chunkQWAWNQEZcjs.AutotaskConfigError)("createGuidance: opts.resources must contain non-empty plan resource key strings");
+        throw new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)("createGuidance: opts.resources must contain non-empty plan resource key strings");
       }
       const key = r.trim();
-      if (!_chunkQWAWNQEZcjs.CREATE_GUIDANCE.rows.some((row) => row.resource === key)) {
-        throw new (0, _chunkQWAWNQEZcjs.AutotaskError)(
-          `createGuidance: unknown resource "${key}" \u2014 the catalog has ${_chunkQWAWNQEZcjs.CREATE_GUIDANCE.rows.length} create entities`,
+      if (!_chunkD5TVBI4Ucjs.CREATE_GUIDANCE.rows.some((row) => row.resource === key)) {
+        throw new (0, _chunkD5TVBI4Ucjs.AutotaskError)(
+          `createGuidance: unknown resource "${key}" \u2014 the catalog has ${_chunkD5TVBI4Ucjs.CREATE_GUIDANCE.rows.length} create entities`,
           {
             code: "RESOURCE_UNKNOWN",
             category: "validation",
@@ -611,18 +655,18 @@ async function createGuidance(client, opts) {
   }
   if (_optionalChain([opts, 'optionalAccess', _10 => _10.kind]) !== void 0) {
     if (!CREATE_BLOCKER_KINDS.includes(opts.kind)) {
-      throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
+      throw new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)(
         `createGuidance: unknown kind "${String(opts.kind)}" \u2014 the valid kinds are: ${CREATE_BLOCKER_KINDS.join(", ")}`
       );
     }
     rows = rows.filter((row) => _optionalChain([row, 'access', _11 => _11.blocker, 'optionalAccess', _12 => _12.kind]) === opts.kind);
   }
   return {
-    zone: _chunkQWAWNQEZcjs.CREATE_GUIDANCE.zone,
-    label: _chunkQWAWNQEZcjs.CREATE_GUIDANCE.label,
-    verifiedAt: _chunkQWAWNQEZcjs.CREATE_GUIDANCE.verifiedAt,
+    zone: _chunkD5TVBI4Ucjs.CREATE_GUIDANCE.zone,
+    label: _chunkD5TVBI4Ucjs.CREATE_GUIDANCE.label,
+    verifiedAt: _chunkD5TVBI4Ucjs.CREATE_GUIDANCE.verifiedAt,
     rows,
-    counts: _chunkQWAWNQEZcjs.CREATE_GUIDANCE.counts
+    counts: _chunkD5TVBI4Ucjs.CREATE_GUIDANCE.counts
   };
 }
 
@@ -631,7 +675,7 @@ var RECOVERY_CONFIRM = "operations.recovery";
 var RECOVERY_DEFAULT_LIMIT = 25;
 var RECOVERY_MAX_LIMIT = 100;
 function configError(message, operation, suggestedAction) {
-  throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(message, { operation, suggestedAction });
+  throw new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)(message, { operation, suggestedAction });
 }
 function parseMatchId(record) {
   const raw = record.id;
@@ -646,9 +690,8 @@ function parseMatchId(record) {
   }
   return { id: null, unsafe: true };
 }
-async function recovery(client, input, opts = {}) {
-  const operation = RECOVERY_CONFIRM;
-  if (!_chunkQWAWNQEZcjs.isRecord.call(void 0, input)) {
+function validateRecoveryInput(input, operation) {
+  if (!_chunkD5TVBI4Ucjs.isRecord.call(void 0, input)) {
     configError(
       `recovery: input must be an object { resource, marker, ... } (got ${typeof input})`,
       operation,
@@ -679,10 +722,13 @@ async function recovery(client, input, opts = {}) {
       "Pass action: 'delete' for the destructive path (dry-run-first; the apply requires the confirm string)."
     );
   }
-  const entry = _chunkQWAWNQEZcjs.RELATIONSHIP_MAP[resource];
+  return { resource, marker, action };
+}
+function resolveRecoveryTarget(client, resource, operation) {
+  const entry = _chunkD5TVBI4Ucjs.RELATIONSHIP_MAP[resource];
   if (entry === void 0) {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskError)(
-      `recovery: unknown resource "${resource}" \u2014 the plan has ${Object.keys(_chunkQWAWNQEZcjs.RELATIONSHIP_MAP).length} resources`,
+    throw new (0, _chunkD5TVBI4Ucjs.AutotaskError)(
+      `recovery: unknown resource "${resource}" \u2014 the plan has ${Object.keys(_chunkD5TVBI4Ucjs.RELATIONSHIP_MAP).length} resources`,
       {
         code: "RESOURCE_UNKNOWN",
         category: "validation",
@@ -691,7 +737,7 @@ async function recovery(client, input, opts = {}) {
       }
     );
   }
-  const holder = client[_chunkQWAWNQEZcjs.camelKey.call(void 0, resource)];
+  const holder = client[_chunkD5TVBI4Ucjs.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`,
@@ -699,7 +745,10 @@ async function recovery(client, input, opts = {}) {
       "Use a resource with a query surface, or address the record by id directly (get/fetchMany)."
     );
   }
-  const field = input.field !== void 0 ? String(input.field) : _chunkQWAWNQEZcjs.MARKER_FIELDS[resource];
+  return { entry, holder };
+}
+function resolveMarkerField(input, resource, operation) {
+  const field = input.field !== void 0 ? String(input.field) : _chunkD5TVBI4Ucjs.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`,
@@ -707,56 +756,127 @@ async function recovery(client, input, opts = {}) {
       "Pass input.field \u2014 a name-like vendor field the marker was stamped into (see the resource model in autotask_describe / autotask_catalog)."
     );
   }
-  let parentId;
-  if (input.parentId !== 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)."
-      );
-    }
-    parentId = input.parentId;
-    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 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) {
-    if (!Array.isArray(input.filter)) {
+  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 (!_chunkD5TVBI4Ucjs.isRecord.call(void 0, c) || typeof c.op !== "string" || c.op === "and" || c.op === "or") {
       configError(
-        `recovery: input.filter must be an array of leaf filter conditions (got ${typeof input.filter})`,
+        "recovery: input.filter accepts only plain leaf conditions ({ field, op, value }) \u2014 no grouping",
         operation,
-        "Pass e.g. [{ field: 'status', op: 'eq', value: 'open' }] \u2014 leaf conditions only."
+        "Pass flat leaf conditions; grouping operators are not supported here."
       );
     }
-    for (const c of input.filter) {
-      if (!_chunkQWAWNQEZcjs.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);
-    }
+    extra.push(c);
   }
-  let limit = RECOVERY_DEFAULT_LIMIT;
-  if (input.limit !== void 0) {
-    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)})`,
+  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, _chunkD5TVBI4Ucjs.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,
-        `Raise the marker precision instead of the cap, or pass limit up to ${RECOVERY_MAX_LIMIT}.`
-      );
+        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 _chunkD5TVBI4Ucjs.NotFoundError) verify = "not-found";
+        else {
+          verify = "error";
+          code = _chunkD5TVBI4Ucjs.isAutotaskError.call(void 0, err) ? err.code : "SERVER_ERROR";
+        }
+      }
+    } catch (err) {
+      code = _chunkD5TVBI4Ucjs.isAutotaskError.call(void 0, err) ? err.code : "SERVER_ERROR";
     }
-    limit = input.limit;
+    deleted.push({ id, verified: verify === "not-found", code });
   }
-  const boundaryNote = _chunkQWAWNQEZcjs.DELETE_BOUNDARY_NOTES[resource];
+  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 = _chunkD5TVBI4Ucjs.DELETE_BOUNDARY_NOTES[resource];
   const boundary = {
     available: boundaryNote === void 0,
     reason: _nullishCoalesce(boundaryNote, () => ( null)),
@@ -768,7 +888,7 @@ async function recovery(client, input, opts = {}) {
   };
   const isDelete = action === "delete";
   if (isDelete && boundaryNote !== void 0) {
-    throw new (0, _chunkQWAWNQEZcjs.DeleteBoundaryError)(
+    throw new (0, _chunkD5TVBI4Ucjs.DeleteBoundaryError)(
       `recovery: the vendor defines no DELETE for ${resource} \u2014 the delete cannot be issued through the API (zero wire was issued)`,
       {
         operation,
@@ -780,7 +900,7 @@ async function recovery(client, input, opts = {}) {
   const dryRun = _optionalChain([opts, 'optionalAccess', _13 => _13.dryRun]) !== false;
   const confirm = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _14 => _14.confirm]), () => ( input.confirm));
   if (isDelete && !dryRun && confirm !== RECOVERY_CONFIRM) {
-    throw new (0, _chunkQWAWNQEZcjs.ConfirmationRequiredError)(
+    throw new (0, _chunkD5TVBI4Ucjs.ConfirmationRequiredError)(
       `recovery: action 'delete' apply is destructive and requires its confirmation flag: pass confirm: "${RECOVERY_CONFIRM}"`,
       {
         operation: RECOVERY_CONFIRM,
@@ -796,7 +916,7 @@ async function recovery(client, input, opts = {}) {
   const query = await holder.queryBounded({ filter: conditions, limit });
   if (query.hasMore) {
     const wire = isDelete ? "DELETE wire" : "mutating wire";
-    throw new (0, _chunkQWAWNQEZcjs.RecoveryTruncatedError)(
+    throw new (0, _chunkD5TVBI4Ucjs.RecoveryTruncatedError)(
       `recovery: the marker search on ${resource} TRIPPED its match cap (${limit}) \u2014 more matches exist than were returned (zero ${wire} was issued)`,
       {
         operation,
@@ -805,17 +925,7 @@ async function recovery(client, input, opts = {}) {
       }
     );
   }
-  const matches = [];
-  const unsafeIds = [];
-  query.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
-    });
-  });
+  const { matches, unsafeIds } = collectMatches(query.items, field);
   const unsafeId = unsafeIds.length > 0;
   const base = {
     resource,
@@ -835,7 +945,7 @@ async function recovery(client, input, opts = {}) {
     return { ...base, simulated: true, dryRun: true };
   }
   if (unsafeId) {
-    throw new (0, _chunkQWAWNQEZcjs.MarkerUnsafeIdError)(
+    throw new (0, _chunkD5TVBI4Ucjs.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,
@@ -844,59 +954,16 @@ async function recovery(client, input, opts = {}) {
       }
     );
   }
-  const deleteMethod = holder.delete;
-  if (deleteMethod === void 0) {
-    throw new (0, _chunkQWAWNQEZcjs.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 _chunkQWAWNQEZcjs.NotFoundError) verify = "not-found";
-        else {
-          verify = "error";
-          code = _chunkQWAWNQEZcjs.isAutotaskError.call(void 0, err) ? err.code : "SERVER_ERROR";
-        }
-      }
-    } catch (err) {
-      code = _chunkQWAWNQEZcjs.isAutotaskError.call(void 0, err) ? err.code : "SERVER_ERROR";
-    }
-    deleted.push({ id, verified: verify === "not-found", code });
-  }
+  const deleted = await applyRecoveryDeletes(holder, matches, parentId, resource, operation);
   return { ...base, deleted, dryRun: false };
 }
 
-// src/operations/invoke.ts
-var RECORDS = _chunkCBUY3MKBcjs.CAPABILITIES;
-var byId = new Map(RECORDS.map((r) => [r.id, r]));
+// 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, _chunkQWAWNQEZcjs.ConfirmationRequiredError)(message, { operation, suggestedAction });
+  throw new (0, _chunkD5TVBI4Ucjs.ConfirmationRequiredError)(message, { operation, suggestedAction });
 }
 var MODE_BY_EFFECT = {
   read: "read",
@@ -924,6 +991,8 @@ function crossModeRefusal(operation, effect, mode) {
   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;
 }
@@ -940,7 +1009,7 @@ function looseTypeOk(type, value) {
     case "string[]":
       return Array.isArray(value) && value.every((v) => typeof v === "string");
     case "object":
-      return _chunkQWAWNQEZcjs.isRecord.call(void 0, value);
+      return _chunkD5TVBI4Ucjs.isRecord.call(void 0, value);
     default:
       return true;
   }
@@ -957,8 +1026,11 @@ function validateDispatchArgs(record, argsIn) {
   const schema = _nullishCoalesce(record.inputSchema, () => ( {}));
   const names = Object.keys(schema);
   if (args.length > names.length) {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
-      `invoke: "${operation}" declares ${names.length} positional arg(s) (${declaredArgList(record)}) but ${args.length} were passed \u2014 extra args are refused, not dropped (v0.2.0 silently dropped them)`,
+    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, _chunkD5TVBI4Ucjs.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.`
@@ -967,7 +1039,7 @@ function validateDispatchArgs(record, argsIn) {
   }
   const required = names.filter((n) => schema[n].required);
   if (args.length < required.length) {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
+    throw new (0, _chunkD5TVBI4Ucjs.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 }
     );
@@ -978,13 +1050,15 @@ function validateDispatchArgs(record, argsIn) {
     const name = names[i];
     const spec = schema[name];
     if (!looseTypeOk(spec.type, value)) {
-      throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
+      throw new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)(
         `invoke: "${operation}" arg ${i + 1} is declared ${name}: ${spec.type} \u2014 the value has the wrong type (pass a ${spec.type} value)`,
         { operation }
       );
     }
   }
 }
+
+// src/operations/invoke/inputSets.ts
 var PARAMS_BAG_KEYS = {
   query: ["filter", "limit", "includeFields", "via", "latest", "noteChars", "fieldsPreset", "fieldCheck"],
   // No registry row DECLARES `queryAll` today (a plan decision: the raw walk is
@@ -1038,11 +1112,11 @@ function validateParamsBag(record, args) {
   const valid = PARAMS_BAG_KEYS[record.operation];
   if (valid === void 0) return;
   const bag = _optionalChain([args, 'optionalAccess', _15 => _15[0]]);
-  if (bag === void 0 || bag === null || !_chunkQWAWNQEZcjs.isRecord.call(void 0, bag)) return;
+  if (bag === void 0 || bag === null || !_chunkD5TVBI4Ucjs.isRecord.call(void 0, bag)) return;
   const unknown = Object.keys(bag).filter((k) => !valid.includes(k));
   if (unknown.length === 0) return;
   const suggestions = unknown.map((k) => [k, suggestForKey(k, valid)]).filter((pair) => pair[1] !== null).map(([k, s]) => `"${k}" \u2192 "${s}"`);
-  throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
+  throw new (0, _chunkD5TVBI4Ucjs.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,
@@ -1050,123 +1124,13 @@ function validateParamsBag(record, args) {
     }
   );
 }
-async function liveFieldNames(holder) {
-  const reader = holder.getFieldInfo;
-  if (typeof reader !== "function") return null;
-  try {
-    const rows = await reader.call(holder);
-    if (!Array.isArray(rows)) return null;
-    const names = [];
-    for (const row of rows) {
-      if (typeof row.name === "string") names.push(row.name);
-    }
-    return names.length > 0 ? names : null;
-  } catch (err) {
-    if (!_chunkQWAWNQEZcjs.isAutotaskError.call(void 0, err) || err.code === "ABORTED") throw err;
-    return null;
-  }
-}
-var UNKNOWN_NAME_LIST_CAP = 20;
-var UNKNOWN_NAME_DISPLAY_CHARS = 80;
-function formatUnknownNameList(names) {
-  const listed = names.slice(0, UNKNOWN_NAME_LIST_CAP).map((n) => `"${n.length > UNKNOWN_NAME_DISPLAY_CHARS ? `${n.slice(0, UNKNOWN_NAME_DISPLAY_CHARS)}\u2026` : n}"`).join(", ");
-  const more = names.length > UNKNOWN_NAME_LIST_CAP ? ` (and ${names.length - UNKNOWN_NAME_LIST_CAP} more)` : "";
-  return `${listed}${more}`;
-}
-function collectFilterFieldNames(conditions) {
-  const out = [];
-  const walk = (conds) => {
-    for (const cond of conds) {
-      if (!_chunkQWAWNQEZcjs.isRecord.call(void 0, cond)) continue;
-      if (cond.op === "and" || cond.op === "or") {
-        if (Array.isArray(cond.items)) walk(cond.items);
-        continue;
-      }
-      if (cond.udf === true) continue;
-      if (typeof cond.field === "string" && cond.field.length > 0) out.push(cond.field);
-    }
-  };
-  walk(conditions);
-  return out;
-}
-async function validateQueryFieldNames(record, holder, args) {
-  const bag = args[0];
-  if (!_chunkQWAWNQEZcjs.isRecord.call(void 0, bag)) return;
-  const fieldCheck = bag["fieldCheck"];
-  if (fieldCheck !== void 0 && typeof fieldCheck !== "boolean") {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
-      `invoke: "${record.id}" params bag fieldCheck must be a boolean (got ${typeof fieldCheck}) \u2014 the request was not issued`,
-      { operation: record.id, suggestedAction: "Pass fieldCheck: true (default) or fieldCheck: false (disable the field-name checks \u2014 includeFields AND filter condition names)." }
-    );
-  }
-  const includeFields = bag["includeFields"];
-  let includeNames;
-  if (includeFields !== void 0) {
-    let shapeOk = Array.isArray(includeFields);
-    const names = [];
-    if (shapeOk) {
-      for (const entry of includeFields) {
-        if (typeof entry !== "string" || entry.length === 0) {
-          shapeOk = false;
-          break;
-        }
-        names.push(entry);
-      }
-    }
-    if (!shapeOk) {
-      throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
-        `invoke: "${record.id}" params bag includeFields must be an array of non-empty field-name strings \u2014 the request was not issued`,
-        {
-          operation: record.id,
-          suggestedAction: 'Pass includeFields as an array of exact vendor field names, e.g. ["id", "title"]; the live set is in operations.fieldCatalog.'
-        }
-      );
-    }
-    includeNames = names;
-  }
-  let filterNames;
-  if (bag["filter"] !== void 0) {
-    const conditions = _chunkQWAWNQEZcjs.normalizedConditions.call(void 0, bag["filter"]);
-    filterNames = collectFilterFieldNames(_nullishCoalesce(conditions, () => ( [])));
-  }
-  if (fieldCheck === false) return;
-  const hasInclude = includeNames !== void 0 && includeNames.length > 0;
-  const hasFilter = filterNames !== void 0 && filterNames.length > 0;
-  if (!hasInclude && !hasFilter) return;
-  const live = await liveFieldNames(holder);
-  let known;
-  let liveOnlyExempt = [];
-  if (live !== null) {
-    known = live;
-  } else {
-    const vendored = _chunkQWAWNQEZcjs.MODEL_FIELD_SETS[record.resource];
-    liveOnlyExempt = Array.isArray(_optionalChain([record, 'access', _16 => _16.metadata, 'optionalAccess', _17 => _17.liveOnlyFields])) ? record.metadata.liveOnlyFields : [];
-    known = vendored === void 0 ? void 0 : [...vendored, ...liveOnlyExempt];
-  }
-  if (known === void 0) return;
-  const authority = live !== null ? "the tenant's live entity field metadata" : liveOnlyExempt.length > 0 ? "the vendored spec (src/field-sets.ts) + the plan-pinned live-only fields (exempt from the vendored refusal)" : "the vendored spec (src/field-sets.ts)";
-  const unknownInclude = hasInclude ? includeNames.filter((name) => !known.includes(name)) : [];
-  const unknownFilter = hasFilter ? [...new Set(filterNames.filter((name) => !known.includes(name)))] : [];
-  if (unknownInclude.length === 0 && unknownFilter.length === 0) return;
-  const parts = [];
-  if (unknownInclude.length > 0) parts.push(`includeFields has unknown field name(s) ${formatUnknownNameList(unknownInclude)}`);
-  if (unknownFilter.length > 0) parts.push(`filter condition(s) carry unknown field name(s) ${formatUnknownNameList(unknownFilter)}`);
-  const wireClause = record.operation === "count" ? "the count request was not issued" : "the query POST was not issued";
-  throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
-    `invoke: "${record.id}" ${parts.join("; ")} against ${authority} \u2014 ${wireClause}`,
-    {
-      operation: record.id,
-      suggestedAction: `Use exact vendor field names (operations.fieldCatalog lists the live set for the entity); pass fieldCheck: false to disable this name check. The authority here was ${authority}.`
-    }
-  );
-}
 var INVOKE_OPTION_KEYS = ["dryRun", "confirm", "lastModifiedDate", "maxRetries", "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 = unknown.map((k) => [k, suggestForKey(k, ["dryRun", "confirm", "lastModifiedDate", "maxRetries"])]).filter((pair) => pair[1] !== null).map(([k, s]) => `"${k}" \u2192 "${s}"`);
-  throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
+  throw new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)(
     `invoke: "${operation}" has unknown option key(s) ${unknown.map((k) => `"${k}"`).join(", ")} \u2014 the options set is closed (valid: dryRun, confirm, lastModifiedDate, maxRetries; "mode" is internal to the mode wrappers)`,
     {
       operation,
@@ -1179,7 +1143,7 @@ function unknownKeysRefusal(raw, validKeys, subject, operation) {
   const unknown = Object.keys(raw).filter((k) => !validKeys.includes(k));
   if (unknown.length === 0) return null;
   const suggestions = unknown.map((k) => [k, suggestForKey(k, [...validKeys])]).filter((pair) => pair[1] !== null).map(([k, s]) => `"${k}" \u2192 "${s}"`);
-  return new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
+  return new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)(
     `unknown ${subject} ${unknown.map((k) => `"${k}"`).join(", ")} \u2014 the ${subject} set is closed (valid keys: ${validKeys.join(", ")})`,
     {
       ...operation !== void 0 ? { operation } : {},
@@ -1187,29 +1151,48 @@ function unknownKeysRefusal(raw, validKeys, subject, operation) {
     }
   );
 }
-async function invokeMode(client, operation, argsIn = [], opts = {}) {
-  const args = _nullishCoalesce(argsIn, () => ( []));
+
+// src/operations/invoke/registry.ts
+var RECORDS = _chunkJUO3URUIcjs.CAPABILITIES;
+var byId = new Map(RECORDS.map((r) => [r.id, r]));
+
+// 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 = byId.get(operation);
   if (record === void 0) {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
+    throw new (0, _chunkD5TVBI4Ucjs.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, _chunkQWAWNQEZcjs.AutotaskConfigError)(crossModeRefusal(operation, record.effect, mode), { operation });
+    throw new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)(crossModeRefusal(operation, record.effect, mode), { operation });
   }
   if (opts.dryRun !== void 0 && typeof opts.dryRun !== "boolean") {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
+    throw new (0, _chunkD5TVBI4Ucjs.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." }
     );
   }
-  const isWrite = record.effect !== "read";
-  if (!isWrite && opts.dryRun === true) {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
+  if (record.effect === "read" && opts.dryRun === true) {
+    throw new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)(
       `invoke: "${operation}" is a read \u2014 dryRun is not applicable (reads issue their request as-is)`,
       { operation }
     );
@@ -1221,69 +1204,71 @@ async function invokeMode(client, operation, argsIn = [], opts = {}) {
       "Pass confirm equal to the operation key to acknowledge the deliberate act."
     );
   }
-  validateDispatchArgs(record, args);
-  validateParamsBag(record, args);
-  const boundedQuery = record.kind === "primitive" && record.operation === "query";
-  const countedQuery = record.kind === "primitive" && record.operation === "count";
-  let holder = client[_chunkQWAWNQEZcjs.camelKey.call(void 0, record.resource)];
+}
+function operationsHolder(client) {
+  return {
+    resolveAny: (identifier, opts) => resolveAny(client, identifier, opts),
+    searchAcrossResources: (query, opts) => searchAcrossResources(client, query, opts),
+    fetchMany: (items, opts) => _chunkD5TVBI4Ucjs.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 #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) => _chunkD5TVBI4Ucjs.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 name cache (default-on).
+    expandResourceNames: (ids, opts) => _chunkD5TVBI4Ucjs.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) => _chunkD5TVBI4Ucjs.uiLink.call(void 0, client, input),
+    // 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) => _chunkD5TVBI4Ucjs.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[_chunkD5TVBI4Ucjs.camelKey.call(void 0, record.resource)];
   if (typeof holder === "function") {
-    holder = _nullishCoalesce(client[`${_chunkQWAWNQEZcjs.camelKey.call(void 0, record.resource)}Resource`], () => ( holder));
+    holder = _nullishCoalesce(clientBag[`${_chunkD5TVBI4Ucjs.camelKey.call(void 0, record.resource)}Resource`], () => ( holder));
   }
   if (holder === void 0 && record.resource === "operations") {
-    holder = {
-      resolveAny: (identifier, opts2) => resolveAny(client, identifier, opts2),
-      searchAcrossResources: (query, opts2) => searchAcrossResources(client, query, opts2),
-      fetchMany: (items, opts2) => _chunkQWAWNQEZcjs.fetchMany.call(void 0, client, items, opts2),
-      // 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: (operation2, filter, opts2) => aggregate(client, operation2, filter, opts2),
-      // 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, opts2) => _chunkQWAWNQEZcjs.fetchByIds.call(void 0, client, items, opts2),
-      // 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 name cache (default-on).
-      expandResourceNames: (ids, opts2) => _chunkQWAWNQEZcjs.expandResourceNames.call(void 0, client, ids, opts2),
-      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: (opts2) => blindSurfaces(client, opts2),
-      probeReachability: (opts2) => probeReachability(client, opts2),
-      // Issue #12: the served zone-fact create-guidance catalog (zero wire).
-      createGuidance: (opts2) => createGuidance(client, opts2),
-      // 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: (opts2) => _chunkQWAWNQEZcjs.fieldCatalog.call(void 0, client, opts2),
-      // 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, opts2) => recovery(client, input, opts2)
-    };
+    holder = operationsHolder(client);
   }
   if (holder === void 0) {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
+    throw new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)(
       `invoke: the client exposes no accessor for resource "${record.resource}"`,
       { operation }
     );
   }
-  if (boundedQuery || countedQuery) await validateQueryFieldNames(record, holder, args);
-  const methodName = boundedQuery ? "queryBounded" : record.operation;
-  const method = holder[methodName];
-  if (typeof method !== "function") {
-    throw new (0, _chunkQWAWNQEZcjs.AutotaskConfigError)(
-      `invoke: "${record.resource}.${methodName}" is not a callable method on the client`,
-      { 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) {
@@ -1295,10 +1280,9 @@ async function invokeMode(client, operation, argsIn = [], opts = {}) {
   if (isWrite && opts.confirm !== void 0) {
     mutationOpts.confirm = opts.confirm;
   }
-  const BAG_RIDING_ARGS = {
-    createIfNotExists: ["dedupFields"],
-    moveConfigurationItem: ["destinationCompanyId"]
-  };
+  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;
@@ -1315,21 +1299,34 @@ async function invokeMode(client, operation, argsIn = [], opts = {}) {
     while (callArgs.length < declaredPositional.length) callArgs.push(void 0);
     callArgs.push(mutationOpts);
   }
-  const result = await method.apply(holder, callArgs);
-  return Buffer.isBuffer(result) ? bufferResult(result) : result;
+  return callArgs;
 }
-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") };
+async function invokeMode(client, operation, argsIn = [], opts = {}) {
+  const args = _nullishCoalesce(argsIn, () => ( []));
+  const record = resolveRecord(operation);
+  governPreRequest(record, operation, opts);
+  validateDispatchArgs(record, args);
+  validateParamsBag(record, args);
+  const boundedQuery = record.kind === "primitive" && record.operation === "query";
+  const countedQuery = record.kind === "primitive" && record.operation === "count";
+  const holder = resolveHolder(client, record, operation);
+  if (boundedQuery || countedQuery) await _chunkD5TVBI4Ucjs.validateQueryFieldNames.call(void 0, record, holder, args);
+  const methodName = boundedQuery ? "queryBounded" : record.operation;
+  const method = holder[methodName];
+  if (typeof method !== "function") {
+    throw new (0, _chunkD5TVBI4Ucjs.AutotaskConfigError)(
+      `invoke: "${record.resource}.${methodName}" is not a callable method on the client`,
+      { operation }
+    );
   }
-  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.`
-  };
+  const isWrite = record.effect !== "read";
+  const mutationOpts = buildMutationOpts(opts, isWrite);
+  const callArgs = buildCallArgs(record, args, mutationOpts, isWrite);
+  const result = await method.apply(holder, callArgs);
+  return Buffer.isBuffer(result) ? bufferResult(result) : result;
 }
+
+// src/operations/invoke/wrappers.ts
 async function invoke(client, operation, args = [], opts = {}) {
   return invokeMode(client, operation, args, { ...opts, mode: void 0 });
 }
@@ -1386,4 +1383,7 @@ 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 = _chunkQWAWNQEZcjs.EXPAND_RESOURCE_NAMES_MAX_IDS; exports.FETCH_BY_IDS_CHUNK_SIZE = _chunkQWAWNQEZcjs.FETCH_BY_IDS_CHUNK_SIZE; exports.FETCH_BY_IDS_MAX_ITEMS = _chunkQWAWNQEZcjs.FETCH_BY_IDS_MAX_ITEMS; exports.FETCH_MANY_MAX_ITEMS = _chunkQWAWNQEZcjs.FETCH_MANY_MAX_ITEMS; exports.FIELD_CACHE_KINDS = _chunkQWAWNQEZcjs.FIELD_CACHE_KINDS; exports.FIELD_CATALOG_HONESTY_NOTE = _chunkQWAWNQEZcjs.FIELD_CATALOG_HONESTY_NOTE; exports.INVOKE_OPTION_KEYS = INVOKE_OPTION_KEYS; exports.MAX_FIELD_CATALOG_WIRE = _chunkQWAWNQEZcjs.MAX_FIELD_CATALOG_WIRE; exports.PARAMS_BAG_KEYS = PARAMS_BAG_KEYS; exports.PICKLIST_VALUE_NOT_SERVED_NOTE = _chunkQWAWNQEZcjs.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.WORKFLOW_RESOURCES = _chunkQWAWNQEZcjs.WORKFLOW_RESOURCES; exports.aggregate = aggregate; exports.blindSurfaces = blindSurfaces; exports.createGuidance = createGuidance; exports.dateBucketLabel = dateBucketLabel; exports.expandResourceNames = _chunkQWAWNQEZcjs.expandResourceNames; exports.fetchByIds = _chunkQWAWNQEZcjs.fetchByIds; exports.fetchMany = _chunkQWAWNQEZcjs.fetchMany; exports.fieldCatalog = _chunkQWAWNQEZcjs.fieldCatalog; 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.searchAcrossResources = searchAcrossResources; exports.unknownKeysRefusal = unknownKeysRefusal; exports.validateDispatchArgs = validateDispatchArgs; exports.validateFetchManyItems = _chunkQWAWNQEZcjs.validateFetchManyItems; exports.validateInvokeOptions = validateInvokeOptions; exports.validateParamsBag = validateParamsBag;
+
+
+
+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 = _chunkD5TVBI4Ucjs.EXPAND_RESOURCE_NAMES_MAX_IDS; exports.FETCH_BY_IDS_CHUNK_SIZE = _chunkD5TVBI4Ucjs.FETCH_BY_IDS_CHUNK_SIZE; exports.FETCH_BY_IDS_MAX_ITEMS = _chunkD5TVBI4Ucjs.FETCH_BY_IDS_MAX_ITEMS; exports.FETCH_MANY_MAX_ITEMS = _chunkD5TVBI4Ucjs.FETCH_MANY_MAX_ITEMS; exports.FIELD_CACHE_KINDS = _chunkD5TVBI4Ucjs.FIELD_CACHE_KINDS; exports.FIELD_CATALOG_HONESTY_NOTE = _chunkD5TVBI4Ucjs.FIELD_CATALOG_HONESTY_NOTE; exports.INVOKE_OPTION_KEYS = INVOKE_OPTION_KEYS; exports.MAX_FIELD_CATALOG_WIRE = _chunkD5TVBI4Ucjs.MAX_FIELD_CATALOG_WIRE; exports.PARAMS_BAG_KEYS = PARAMS_BAG_KEYS; exports.PICKLIST_VALUE_NOT_SERVED_NOTE = _chunkD5TVBI4Ucjs.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 = _chunkD5TVBI4Ucjs.UI_LINK_ENTITIES; exports.WORKFLOW_RESOURCES = _chunkD5TVBI4Ucjs.WORKFLOW_RESOURCES; exports.aggregate = aggregate; exports.blindSurfaces = blindSurfaces; exports.buildUiLink = _chunkD5TVBI4Ucjs.buildUiLink; exports.createGuidance = createGuidance; exports.dateBucketLabel = dateBucketLabel; exports.expandResourceNames = _chunkD5TVBI4Ucjs.expandResourceNames; exports.fetchByIds = _chunkD5TVBI4Ucjs.fetchByIds; exports.fetchMany = _chunkD5TVBI4Ucjs.fetchMany; exports.fieldCatalog = _chunkD5TVBI4Ucjs.fieldCatalog; 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.searchAcrossResources = searchAcrossResources; exports.uiLink = _chunkD5TVBI4Ucjs.uiLink; exports.unknownKeysRefusal = unknownKeysRefusal; exports.validateDispatchArgs = validateDispatchArgs; exports.validateFetchManyItems = _chunkD5TVBI4Ucjs.validateFetchManyItems; exports.validateInvokeOptions = validateInvokeOptions; exports.validateParamsBag = validateParamsBag;