node-autotask 0.8.3 → 0.10.0

package/dist/operations/index.cjs

@@ -19,35 +19,37 @@
 
 
 
-var _chunkV3XPLTIRcjs = require('../chunk-V3XPLTIR.cjs');
 
 
-var _chunkKNTUX3RRcjs = require('../chunk-KNTUX3RR.cjs');
 
-// src/operations/types.ts
-var WORKFLOW_RESOURCES = [
-  "companies",
-  "tickets",
-  "contacts",
-  "configuration_items",
-  "projects"
-];
+
+
+
+
+
+
+
+
+var _chunkWTVLHMZAcjs = require('../chunk-WTVLHMZA.cjs');
+
+
+var _chunkWTVD2JZNcjs = require('../chunk-WTVD2JZN.cjs');
 
 // src/operations/searchAcrossResources.ts
 var DEFAULT_LIMIT = 25;
 function resourceFor(client, key) {
-  return client[_chunkV3XPLTIRcjs.camelKey.call(void 0, key)];
+  return client[_chunkWTVLHMZAcjs.camelKey.call(void 0, key)];
 }
 async function searchAcrossResources(client, query, opts = {}) {
   const text = query.trim();
   if (text === "") {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)("searchAcrossResources: query must be a non-empty string");
+    throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)("searchAcrossResources: query must be a non-empty string");
   }
-  const keys = _nullishCoalesce(opts.resources, () => ( WORKFLOW_RESOURCES));
+  const keys = _nullishCoalesce(opts.resources, () => ( _chunkWTVLHMZAcjs.WORKFLOW_RESOURCES));
   if (keys.length === 0) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)("searchAcrossResources: no resources requested");
+    throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)("searchAcrossResources: no resources requested");
   }
-  const limit = _chunkV3XPLTIRcjs.clampPageSize.call(void 0, _nullishCoalesce(opts.limit, () => ( DEFAULT_LIMIT)));
+  const limit = _chunkWTVLHMZAcjs.clampPageSize.call(void 0, _nullishCoalesce(opts.limit, () => ( DEFAULT_LIMIT)));
   const results = [];
   const skipped = [];
   for (const key of keys) {
@@ -65,7 +67,7 @@ async function searchAcrossResources(client, query, opts = {}) {
 
 // src/operations/resolveAny.ts
 function resourceFor2(client, key) {
-  return client[_chunkV3XPLTIRcjs.camelKey.call(void 0, key)];
+  return client[_chunkWTVLHMZAcjs.camelKey.call(void 0, key)];
 }
 var FAULT_CATEGORIES = /* @__PURE__ */ new Set(["auth", "rate_limit", "server", "network", "timeout", "policy"]);
 function missCost(identifier) {
@@ -74,13 +76,13 @@ function missCost(identifier) {
 }
 async function resolveAny(client, identifier, opts = {}) {
   if (typeof identifier === "number") {
-    _chunkV3XPLTIRcjs.parseIdentifier.call(void 0, identifier, "identifier");
+    _chunkWTVLHMZAcjs.parseIdentifier.call(void 0, identifier, "identifier");
   } else if (identifier.trim() === "") {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)("resolveAny: identifier must be non-empty");
+    throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)("resolveAny: identifier must be non-empty");
   }
-  const keys = _nullishCoalesce(opts.resources, () => ( WORKFLOW_RESOURCES));
+  const keys = _nullishCoalesce(opts.resources, () => ( _chunkWTVLHMZAcjs.WORKFLOW_RESOURCES));
   if (keys.length === 0) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)("resolveAny: no resources requested");
+    throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)("resolveAny: no resources requested");
   }
   const results = [];
   for (const key of keys) {
@@ -110,9 +112,9 @@ async function resolveAny(client, identifier, opts = {}) {
     } catch (err) {
       let code;
       let candidates = [];
-      if (err instanceof _chunkV3XPLTIRcjs.AutotaskConfigError) {
+      if (err instanceof _chunkWTVLHMZAcjs.AutotaskConfigError) {
         code = "CONFIG_ERROR";
-      } else if (_chunkV3XPLTIRcjs.isAutotaskError.call(void 0, err)) {
+      } else if (_chunkWTVLHMZAcjs.isAutotaskError.call(void 0, err)) {
         if (FAULT_CATEGORIES.has(err.category)) throw err;
         code = err.code;
         if (code === "RESOLUTION_AMBIGUOUS" && err.resourceIds !== void 0) {
@@ -259,23 +261,23 @@ var MODEL_FIELD_SETS = {
 
 // src/operations/fetchMany.ts
 var FETCH_MANY_MAX_ITEMS = 20;
-function validateFetchManyItems(items, cap) {
+function validateFetchManyItems(items, cap, opName = "fetchMany", capRef = `FETCH_MANY_MAX_ITEMS = ${FETCH_MANY_MAX_ITEMS}`, validation) {
   if (!Array.isArray(items)) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
-      `fetchMany: items must be the items ARRAY \u2014 one positional arg, [{ resource: string, id: number, fields?: string[] }] (got ${Array.isArray(items) ? "an array" : typeof items})`,
+    throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(
+      `${opName}: items must be the items ARRAY \u2014 one positional arg, [{ resource: string, id: number, fields?: string[] }] (got ${Array.isArray(items) ? "an array" : typeof items})`,
       {
         suggestedAction: 'Pass args = [[{ resource: "tickets", id: 123 }, { resource: "projects", id: 456 }]] \u2014 the items array is the single positional argument.'
       }
     );
   }
   if (items.length === 0) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)("fetchMany: items must not be empty (a zero-item batch is a shape error, not a no-op)", {
+    throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(`${opName}: items must not be empty (a zero-item batch is a shape error, not a no-op)`, {
       suggestedAction: "Pass at least one { resource, id } item \u2014 or use the resource's query op for a filtered read."
     });
   }
   if (items.length > cap) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
-      `fetchMany: ${items.length} items over the ${cap}-item cap (FETCH_MANY_MAX_ITEMS = ${FETCH_MANY_MAX_ITEMS}) \u2014 zero items were fetched (pre-request)`,
+    throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(
+      `${opName}: ${items.length} items over the ${cap}-item cap (${capRef}) \u2014 zero items were fetched (pre-request)`,
       {
         suggestedAction: `Split the batch into groups of <= ${cap} items \u2014 or, for more than ${cap} records / a filtered set, use the resource's bounded query op (<resource>.query).`
       }
@@ -302,15 +304,15 @@ function validateFetchManyItems(items, cap) {
       );
       continue;
     }
-    const rel = _chunkV3XPLTIRcjs.RELATIONSHIP_MAP[resourceKey];
+    const rel = _chunkWTVLHMZAcjs.RELATIONSHIP_MAP[resourceKey];
     if (rel !== void 0 && rel.parentScoped) {
       problems.push(
-        `${at}.resource: "${resourceKey}" is a parent-scoped child \u2014 its get needs (parentId, id); fetchMany takes single numeric ids of TOP-LEVEL records (scoped reads: client.${_chunkV3XPLTIRcjs.camelKey.call(void 0, resourceKey)}.get(parentId, id))`
+        `${at}.resource: "${resourceKey}" is a parent-scoped child \u2014 its get needs (parentId, id); fetchMany takes single numeric ids of TOP-LEVEL records (scoped reads: client.${_chunkWTVLHMZAcjs.camelKey.call(void 0, resourceKey)}.get(parentId, id))`
       );
       continue;
     }
     try {
-      _chunkV3XPLTIRcjs.parseIdentifier.call(void 0, item.id, `${at}.id`);
+      _chunkWTVLHMZAcjs.parseIdentifier.call(void 0, item.id, `${at}.id`);
     } catch (e2) {
       if (typeof item.id === "string") {
         problems.push(
@@ -327,21 +329,24 @@ function validateFetchManyItems(items, cap) {
     }
     if (item.fields !== void 0) {
       if (!Array.isArray(item.fields) || item.fields.some((f) => typeof f !== "string")) {
-        problems.push(`${at}.fields: must be an array of exact vendor field names (discover them via ${resourceKey}.getFieldInfo)`);
+        problems.push(`${at}.fields: must be an array of exact vendor field names (discover them via operations.fieldCatalog)`);
         continue;
       }
-      for (const f of item.fields) {
-        if (!fields.includes(f)) {
-          problems.push(
-            `${at}.fields: "${f}" is not a field of ${resourceKey} \u2014 a hallucinated field is a shape error, not a silent projection-miss (exact vendor field names via ${resourceKey}.getFieldInfo)`
-          );
+      if (_optionalChain([validation, 'optionalAccess', _ => _.fieldCheck]) !== false) {
+        const authoritative = _nullishCoalesce(_optionalChain([validation, 'optionalAccess', _2 => _2.fieldSetsByResource, 'optionalAccess', _3 => _3.get, 'call', _4 => _4(resourceKey)]), () => ( fields));
+        for (const f of item.fields) {
+          if (!authoritative.includes(f)) {
+            problems.push(
+              `${at}.fields: "${f}" is not a field of ${resourceKey} \u2014 a hallucinated field is a shape error, not a silent projection-miss (exact vendor field names via operations.fieldCatalog)`
+            );
+          }
         }
       }
     }
   }
   if (problems.length > 0) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
-      `fetchMany: ${problems.length} problem(s) found pre-request (zero wire was issued)
+    throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(
+      `${opName}: ${problems.length} problem(s) found pre-request (zero wire was issued)
 - ` + problems.join("\n- "),
       { suggestedAction: "Fix every item above and call again \u2014 validation covers the whole batch up-front (one round, zero wire)." }
     );
@@ -357,18 +362,48 @@ function project(value, fields) {
 async function fetchMany(client, items, opts = {}) {
   if (opts.maxItems !== void 0) {
     if (!Number.isInteger(opts.maxItems) || opts.maxItems < 1) {
-      throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(`fetchMany: maxItems must be an integer >= 1 (got ${String(opts.maxItems)})`);
+      throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(`fetchMany: maxItems must be an integer >= 1 (got ${String(opts.maxItems)})`);
     }
   }
+  if (opts.liveFields !== void 0 && typeof opts.liveFields !== "boolean") {
+    throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(`fetchMany: liveFields must be a boolean (got ${typeof opts.liveFields})`);
+  }
   const cap = Math.min(FETCH_MANY_MAX_ITEMS, _nullishCoalesce(opts.maxItems, () => ( FETCH_MANY_MAX_ITEMS)));
-  validateFetchManyItems(items, cap);
+  if (opts.liveFields === true) {
+    validateFetchManyItems(items, cap, void 0, void 0, { fieldCheck: false });
+    const liveFieldSets = /* @__PURE__ */ new Map();
+    for (const item of items) {
+      const key = item.resource;
+      if (liveFieldSets.has(key)) continue;
+      const holder = client[_chunkWTVLHMZAcjs.camelKey.call(void 0, key)];
+      if (holder === void 0) {
+        throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(`fetchMany: the client exposes no accessor for resource "${key}"`, {
+          suggestedAction: "Rebuild the client from the SDK build that ships this registry (the resource set is pinned by the plan)."
+        });
+      }
+      try {
+        const rows = await holder.getFieldInfo();
+        const names = [];
+        for (const row of rows) {
+          if (typeof row.name === "string") names.push(row.name);
+        }
+        liveFieldSets.set(key, names.length > 0 ? names : null);
+      } catch (err) {
+        if (!_chunkWTVLHMZAcjs.isAutotaskError.call(void 0, err) || err.code === "ABORTED") throw err;
+        liveFieldSets.set(key, null);
+      }
+    }
+    validateFetchManyItems(items, cap, void 0, void 0, { fieldSetsByResource: liveFieldSets });
+  } else {
+    validateFetchManyItems(items, cap);
+  }
   const results = [];
   for (const item of items) {
     const key = item.resource;
-    const id = _chunkV3XPLTIRcjs.parseIdentifier.call(void 0, item.id, `items[${results.length}].id`);
-    const holder = client[_chunkV3XPLTIRcjs.camelKey.call(void 0, key)];
+    const id = _chunkWTVLHMZAcjs.parseIdentifier.call(void 0, item.id, `items[${results.length}].id`);
+    const holder = client[_chunkWTVLHMZAcjs.camelKey.call(void 0, key)];
     if (holder === void 0) {
-      throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(`fetchMany: the client exposes no accessor for resource "${key}"`, {
+      throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(`fetchMany: the client exposes no accessor for resource "${key}"`, {
         suggestedAction: "Rebuild the client from the SDK build that ships this registry (the resource set is pinned by the plan)."
       });
     }
@@ -376,9 +411,9 @@ async function fetchMany(client, items, opts = {}) {
       const value = await holder.get(id);
       results.push({ resource: key, id, found: true, value: item.fields !== void 0 ? project(value, item.fields) : value });
     } catch (err) {
-      if (err instanceof _chunkV3XPLTIRcjs.NotFoundError) {
+      if (err instanceof _chunkWTVLHMZAcjs.NotFoundError) {
         results.push({ resource: key, id, found: false, value: null, error: { code: "NOT_FOUND", message: err.message } });
-      } else if (_chunkV3XPLTIRcjs.isAutotaskError.call(void 0, err) && err.code !== "ABORTED") {
+      } else if (_chunkWTVLHMZAcjs.isAutotaskError.call(void 0, err) && err.code !== "ABORTED") {
         const e = { code: err.code, message: err.message };
         if (err.httpStatus !== void 0) e.httpStatus = err.httpStatus;
         results.push({ resource: key, id, found: false, value: null, error: e });
@@ -391,24 +426,304 @@ async function fetchMany(client, items, opts = {}) {
   return { results, ok, failed: results.length - ok };
 }
 
+// src/operations/aggregate.ts
+var AGGREGATE_TOP_MAX = 100;
+var AGGREGATE_DEFAULT_TOP = 25;
+var AGGREGATE_DEFAULT_LIMIT = _chunkWTVLHMZAcjs.BOUNDED_QUERY_MAX_LIMIT;
+var QUERY_RESOURCE_KEYS = (() => {
+  const s = /* @__PURE__ */ new Set();
+  for (const rec of _chunkWTVD2JZNcjs.CAPABILITIES) if (rec.operation === "query") s.add(rec.resource);
+  return s;
+})();
+var AGGREGATE_OPT_KEYS = ["groupBy", "sum", "top", "limit"];
+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;
+  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`
+      );
+    }
+  }
+  let conditions = [];
+  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 = _chunkWTVLHMZAcjs.buildFilter.call(void 0, conds).filter;
+      } catch (err) {
+        problems.push(err instanceof _chunkWTVLHMZAcjs.AutotaskConfigError ? err.message : `filter must be the query-bag filter (13 operators; caps 500 OR-conditions / 1 UDF / 8000 chars); ${String(err)}`);
+      }
+    }
+  }
+  if (opts !== void 0 && (typeof opts !== "object" || opts === null || Array.isArray(opts))) {
+    throw new (0, _chunkWTVLHMZAcjs.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(", ")}`);
+    }
+  }
+  const fieldSets = resourceKey !== void 0 ? MODEL_FIELD_SETS[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 [];
+    }
+    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;
+  };
+  const groupBy = checkFields("groupBy", opts.groupBy);
+  const sum = checkFields("sum", opts.sum);
+  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), _chunkWTVLHMZAcjs.BOUNDED_QUERY_MAX_LIMIT);
+    }
+  }
+  if (problems.length > 0) {
+    throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(
+      `aggregate: ${problems.length} problem(s) found pre-request (zero wire was issued)
+- ` + problems.join("\n- "),
+      { operation: "operations.aggregate" }
+    );
+  }
+  return { resourceKey, conditions, groupBy, sum, top, limit };
+}
+async function aggregate(client, operation, filter, opts = {}) {
+  const v = validateAggregate(operation, filter, opts);
+  const holder = client[_chunkWTVLHMZAcjs.camelKey.call(void 0, v.resourceKey)];
+  if (holder === void 0) {
+    throw new (0, _chunkWTVLHMZAcjs.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 groups = /* @__PURE__ */ new Map();
+  for (const item of res.items) {
+    const key = {};
+    const values = [];
+    for (const f of v.groupBy) {
+      const value = item[f] === void 0 ? null : item[f];
+      key[f] = 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))) + 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));
+  const top = sorted.slice(0, v.top);
+  const result = {
+    mode: v.groupBy.length > 0 ? "group" : "sum",
+    groups: top.map((g) => ({ key: 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
+  };
+  if (res.blindSurface !== void 0) result.blindSurface = res.blindSurface;
+  if (res.emptyReason !== void 0) result.emptyReason = res.emptyReason;
+  return result;
+}
+
+// src/operations/fetchByIds.ts
+var FETCH_BY_IDS_MAX_ITEMS = 500;
+var FETCH_BY_IDS_CHUNK_SIZE = 250;
+function project2(value, fields) {
+  const out = {};
+  for (const f of fields) {
+    if (f in value) out[f] = value[f];
+  }
+  return out;
+}
+function resourcePathOf(key, holder) {
+  const path = _optionalChain([holder, 'optionalAccess', _5 => _5.resourcePath]);
+  if (typeof path !== "string" || path === "") {
+    throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(`fetchByIds: the client exposes no ${key} resource path (registry drift)`, {
+      suggestedAction: "Rebuild the client from the SDK build that ships this registry (the resource set is pinned by the plan)."
+    });
+  }
+  return path;
+}
+async function fetchByIds(client, items, opts = {}) {
+  if (opts.maxItems !== void 0) {
+    if (!Number.isInteger(opts.maxItems) || opts.maxItems < 1) {
+      throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(`fetchByIds: maxItems must be an integer >= 1 (got ${String(opts.maxItems)})`);
+    }
+  }
+  const cap = Math.min(FETCH_BY_IDS_MAX_ITEMS, _nullishCoalesce(opts.maxItems, () => ( FETCH_BY_IDS_MAX_ITEMS)));
+  validateFetchManyItems(items, cap, "fetchByIds", `FETCH_BY_IDS_MAX_ITEMS = ${FETCH_BY_IDS_MAX_ITEMS}`);
+  const groups = /* @__PURE__ */ new Map();
+  const canonical = [];
+  for (let i = 0; i < items.length; i += 1) {
+    const item = items[i];
+    const id = _chunkWTVLHMZAcjs.parseIdentifier.call(void 0, item.id, `items[${i}].id`);
+    canonical[i] = id;
+    const g = _nullishCoalesce(groups.get(item.resource), () => ( { indices: [], fields: /* @__PURE__ */ new Set(), anyFields: false }));
+    g.indices.push(i);
+    if (item.fields !== void 0) {
+      g.anyFields = true;
+      for (const f of item.fields) g.fields.add(f);
+    }
+    groups.set(item.resource, g);
+  }
+  const byKey = /* @__PURE__ */ new Map();
+  for (const [key, group] of groups) {
+    const holder = client[_chunkWTVLHMZAcjs.camelKey.call(void 0, key)];
+    if (holder === void 0) {
+      throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(`fetchByIds: the client exposes no accessor for resource "${key}"`, {
+        suggestedAction: "Rebuild the client from the SDK build that ships this registry (the resource set is pinned by the plan)."
+      });
+    }
+    const resourcePath = resourcePathOf(key, holder);
+    const unique = [];
+    const seen = /* @__PURE__ */ new Set();
+    for (const i of group.indices) {
+      const k = String(canonical[i]);
+      if (!seen.has(k)) {
+        seen.add(k);
+        unique.push(canonical[i]);
+      }
+    }
+    const includeFields = group.anyFields && group.indices.every((i) => items[i].fields !== void 0) ? [...group.fields] : void 0;
+    const kOf = (id) => `${key}:${String(id)}`;
+    for (let c = 0; c < unique.length; c += FETCH_BY_IDS_CHUNK_SIZE) {
+      const chunk = unique.slice(c, c + FETCH_BY_IDS_CHUNK_SIZE);
+      const chunkKeys = new Set(chunk.map((id) => String(id)));
+      try {
+        const req = _chunkWTVLHMZAcjs.buildQueryRequest.call(void 0, client.http.baseUrl, resourcePath, {
+          filter: [{ field: "id", op: "in", value: chunk }],
+          maxRecords: FETCH_BY_IDS_CHUNK_SIZE,
+          includeFields
+        });
+        const res = await client.http.request({ ...req, operation: `${key}.fetchByIds` });
+        const { items: rows } = _chunkWTVLHMZAcjs.unwrapItems.call(void 0, res, `${key}.fetchByIds`);
+        for (const row of rows) {
+          const k = String(row.id);
+          if (!chunkKeys.has(k)) continue;
+          const q = kOf(k);
+          if (!byKey.has(q)) byKey.set(q, { found: true, value: row });
+        }
+      } catch (err) {
+        if (_chunkWTVLHMZAcjs.isAutotaskError.call(void 0, err) && err.code !== "ABORTED") {
+          const e = { code: err.code, message: err.message };
+          if (err.httpStatus !== void 0) e.httpStatus = err.httpStatus;
+          for (const u of chunk) {
+            const q = kOf(u);
+            if (!byKey.has(q)) byKey.set(q, { found: false, value: null, error: e });
+          }
+          continue;
+        }
+        throw err;
+      }
+    }
+    for (const id of unique) {
+      const k = kOf(id);
+      if (byKey.has(k)) continue;
+      try {
+        const value = await holder.get(id);
+        byKey.set(k, { found: true, value });
+      } catch (err) {
+        if (err instanceof _chunkWTVLHMZAcjs.NotFoundError) {
+          byKey.set(k, { found: false, value: null, error: { code: "NOT_FOUND", message: err.message } });
+        } else if (_chunkWTVLHMZAcjs.isAutotaskError.call(void 0, err) && err.code !== "ABORTED") {
+          const e = { code: err.code, message: err.message };
+          if (err.httpStatus !== void 0) e.httpStatus = err.httpStatus;
+          byKey.set(k, { found: false, value: null, error: e });
+        } else {
+          throw err;
+        }
+      }
+    }
+  }
+  const results = [];
+  for (let i = 0; i < items.length; i += 1) {
+    const item = items[i];
+    const id = canonical[i];
+    const out = byKey.get(`${item.resource}:${String(id)}`);
+    const value = out.found ? item.fields !== void 0 ? project2(out.value, item.fields) : out.value : null;
+    results.push(
+      out.found ? { resource: item.resource, id, found: true, value } : { resource: item.resource, id, found: false, value: null, error: out.error }
+    );
+  }
+  const ok = results.filter((r) => r.found).length;
+  return { results, ok, failed: results.length - ok };
+}
+
 // src/operations/relationshipMap.ts
 async function relationshipMap(client, resourceKey) {
   void client;
   if (typeof resourceKey !== "string" || resourceKey.trim() === "") {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
+    throw new (0, _chunkWTVLHMZAcjs.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 = _chunkV3XPLTIRcjs.RELATIONSHIP_MAP[key];
+  const entry = _chunkWTVLHMZAcjs.RELATIONSHIP_MAP[key];
   if (entry === void 0) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskError)(
-      `relationshipMap: unknown resource "${key}" \u2014 the plan has ${Object.keys(_chunkV3XPLTIRcjs.RELATIONSHIP_MAP).length} resources`,
+    throw new (0, _chunkWTVLHMZAcjs.AutotaskError)(
+      `relationshipMap: unknown resource "${key}" \u2014 the plan has ${Object.keys(_chunkWTVLHMZAcjs.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 ${_chunkV3XPLTIRcjs.RELATIONSHIP_ZONE.label} (${_chunkV3XPLTIRcjs.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 ${_chunkWTVLHMZAcjs.RELATIONSHIP_ZONE.label} (${_chunkWTVLHMZAcjs.RELATIONSHIP_ZONE.zone})-verified.`
       }
     );
   }
@@ -425,24 +740,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, _chunkV3XPLTIRcjs.AutotaskConfigError)("blindSurfaces: opts must be an object { resource?: string, kind?: BlindSurfaceKind }");
+    throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)("blindSurfaces: opts must be an object { resource?: string, kind?: BlindSurfaceKind }");
   }
-  const inv = _chunkV3XPLTIRcjs.BLIND_SURFACE_INVENTORY;
+  const inv = _chunkWTVLHMZAcjs.BLIND_SURFACE_INVENTORY;
   if (inv === null) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)("blindSurfaces: the reachability inventory is absent from the generated artifact \u2014 re-run the build");
+    throw new (0, _chunkWTVLHMZAcjs.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) {
+  if (_optionalChain([opts, 'optionalAccess', _6 => _6.resource]) !== void 0) {
     const key = typeof opts.resource === "string" ? opts.resource.trim() : "";
     if (key === "") {
-      throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
+      throw new (0, _chunkWTVLHMZAcjs.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, _chunkV3XPLTIRcjs.AutotaskError)(
-        `blindSurfaces: unknown resource "${key}" \u2014 the plan has ${Object.keys(_chunkV3XPLTIRcjs.RELATIONSHIP_MAP).length} resources`,
+      throw new (0, _chunkWTVLHMZAcjs.AutotaskError)(
+        `blindSurfaces: unknown resource "${key}" \u2014 the plan has ${Object.keys(_chunkWTVLHMZAcjs.RELATIONSHIP_MAP).length} resources`,
         {
           code: "RESOURCE_UNKNOWN",
           category: "validation",
@@ -452,9 +767,9 @@ async function blindSurfaces(client, opts) {
     }
     surfaces = surfaces.filter((row) => row.resource === key);
   }
-  if (_optionalChain([opts, 'optionalAccess', _2 => _2.kind]) !== void 0) {
+  if (_optionalChain([opts, 'optionalAccess', _7 => _7.kind]) !== void 0) {
     if (!BLIND_SURFACE_KINDS.includes(opts.kind)) {
-      throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
+      throw new (0, _chunkWTVLHMZAcjs.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).` }
       );
@@ -467,51 +782,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, _chunkV3XPLTIRcjs.AutotaskConfigError)("probeReachability: opts must be an object { resources?: string[], limit?: 1|2, maxWireCalls?: number, confirmProbe?: true }");
+    throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)("probeReachability: opts must be an object { resources?: string[], limit?: 1|2, maxWireCalls?: number, confirmProbe?: true }");
   }
-  const defs = _chunkV3XPLTIRcjs.REACHABILITY_PROBE_DEFAULTS;
-  if (_optionalChain([opts, 'optionalAccess', _3 => _3.confirmProbe]) !== true) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
+  const defs = _chunkWTVLHMZAcjs.REACHABILITY_PROBE_DEFAULTS;
+  if (_optionalChain([opts, 'optionalAccess', _8 => _8.confirmProbe]) !== true) {
+    throw new (0, _chunkWTVLHMZAcjs.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));
+  const limit = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _9 => _9.limit]), () => ( defs.limitDefault));
   if (!Number.isInteger(limit) || limit < 1 || limit > defs.limitMax) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
+    throw new (0, _chunkWTVLHMZAcjs.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));
+  const cap = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _10 => _10.maxWireCalls]), () => ( defs.defaultCap));
   if (!Number.isInteger(cap) || cap < 1) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(`probeReachability: maxWireCalls must be a positive integer (got ${String(cap)})`);
+    throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(`probeReachability: maxWireCalls must be a positive integer (got ${String(cap)})`);
   }
   if (cap > defs.hardCap) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
+    throw new (0, _chunkWTVLHMZAcjs.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 = _chunkV3XPLTIRcjs.BLIND_SURFACE_INVENTORY;
+  const inv = _chunkWTVLHMZAcjs.BLIND_SURFACE_INVENTORY;
   if (inv === null) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)("probeReachability: the reachability inventory is absent from the generated artifact \u2014 re-run the build");
+    throw new (0, _chunkWTVLHMZAcjs.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) {
+  if (_optionalChain([opts, 'optionalAccess', _11 => _11.resources]) === void 0) {
     targets = [...defs.defaultTargets];
   } else {
     if (!Array.isArray(opts.resources) || opts.resources.length === 0) {
-      throw new (0, _chunkV3XPLTIRcjs.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, _chunkWTVLHMZAcjs.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, _chunkV3XPLTIRcjs.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, _chunkWTVLHMZAcjs.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, _chunkV3XPLTIRcjs.AutotaskError)(
+        throw new (0, _chunkWTVLHMZAcjs.AutotaskError)(
           `probeReachability: unknown resource "${key}" \u2014 the inventory has ${surfaceCount} surfaces`,
           {
             code: "RESOURCE_UNKNOWN",
@@ -525,7 +840,7 @@ async function probeReachability(client, opts) {
     targets = [...seen];
   }
   if (targets.length > cap) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
+    throw new (0, _chunkWTVLHMZAcjs.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.` }
     );
@@ -535,8 +850,8 @@ async function probeReachability(client, opts) {
   for (const resource of targets.sort()) {
     const row = byResource.get(resource);
     if (row === void 0) continue;
-    const holder = client[_chunkV3XPLTIRcjs.camelKey.call(void 0, resource)];
-    const probeFn = _optionalChain([holder, 'optionalAccess', _7 => _7.queryBounded]);
+    const holder = client[_chunkWTVLHMZAcjs.camelKey.call(void 0, resource)];
+    const probeFn = _optionalChain([holder, 'optionalAccess', _12 => _12.queryBounded]);
     if (typeof probeFn !== "function") {
       results.push({
         ...row,
@@ -547,14 +862,14 @@ async function probeReachability(client, opts) {
     }
     try {
       const res = await probeFn.call(holder, { limit });
-      const items = Array.isArray(_optionalChain([res, 'optionalAccess', _8 => _8.items])) ? res.items : [];
+      const items = Array.isArray(_optionalChain([res, 'optionalAccess', _13 => _13.items])) ? res.items : [];
       results.push({
         ...row,
         unfilteredRows: items.length,
         probe: { ok: true, wire: 1, error: null }
       });
     } catch (err) {
-      const code = _chunkV3XPLTIRcjs.isAutotaskError.call(void 0, err) ? err.code : "NETWORK_ERROR";
+      const code = _chunkWTVLHMZAcjs.isAutotaskError.call(void 0, err) ? err.code : "NETWORK_ERROR";
       const message = err instanceof Error ? err.message : String(err);
       results.push({
         ...row,
@@ -582,24 +897,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, _chunkV3XPLTIRcjs.AutotaskConfigError)(
+    throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(
       "createGuidance: opts must be an object { resources?: string[], kind?: CreateBlockerKind }"
     );
   }
-  let rows = _chunkV3XPLTIRcjs.CREATE_GUIDANCE.rows;
-  if (_optionalChain([opts, 'optionalAccess', _9 => _9.resources]) !== void 0) {
+  let rows = _chunkWTVLHMZAcjs.CREATE_GUIDANCE.rows;
+  if (_optionalChain([opts, 'optionalAccess', _14 => _14.resources]) !== void 0) {
     if (!Array.isArray(opts.resources) || opts.resources.length === 0) {
-      throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)("createGuidance: opts.resources must be a non-empty string[] of plan resource keys");
+      throw new (0, _chunkWTVLHMZAcjs.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, _chunkV3XPLTIRcjs.AutotaskConfigError)("createGuidance: opts.resources must contain non-empty plan resource key strings");
+        throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)("createGuidance: opts.resources must contain non-empty plan resource key strings");
       }
       const key = r.trim();
-      if (!_chunkV3XPLTIRcjs.CREATE_GUIDANCE.rows.some((row) => row.resource === key)) {
-        throw new (0, _chunkV3XPLTIRcjs.AutotaskError)(
-          `createGuidance: unknown resource "${key}" \u2014 the catalog has ${_chunkV3XPLTIRcjs.CREATE_GUIDANCE.rows.length} create entities`,
+      if (!_chunkWTVLHMZAcjs.CREATE_GUIDANCE.rows.some((row) => row.resource === key)) {
+        throw new (0, _chunkWTVLHMZAcjs.AutotaskError)(
+          `createGuidance: unknown resource "${key}" \u2014 the catalog has ${_chunkWTVLHMZAcjs.CREATE_GUIDANCE.rows.length} create entities`,
           {
             code: "RESOURCE_UNKNOWN",
             category: "validation",
@@ -611,243 +926,20 @@ async function createGuidance(client, opts) {
     }
     rows = rows.filter((row) => wanted.has(row.resource));
   }
-  if (_optionalChain([opts, 'optionalAccess', _10 => _10.kind]) !== void 0) {
+  if (_optionalChain([opts, 'optionalAccess', _15 => _15.kind]) !== void 0) {
     if (!CREATE_BLOCKER_KINDS.includes(opts.kind)) {
-      throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
+      throw new (0, _chunkWTVLHMZAcjs.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);
+    rows = rows.filter((row) => _optionalChain([row, 'access', _16 => _16.blocker, 'optionalAccess', _17 => _17.kind]) === opts.kind);
   }
   return {
-    zone: _chunkV3XPLTIRcjs.CREATE_GUIDANCE.zone,
-    label: _chunkV3XPLTIRcjs.CREATE_GUIDANCE.label,
-    verifiedAt: _chunkV3XPLTIRcjs.CREATE_GUIDANCE.verifiedAt,
+    zone: _chunkWTVLHMZAcjs.CREATE_GUIDANCE.zone,
+    label: _chunkWTVLHMZAcjs.CREATE_GUIDANCE.label,
+    verifiedAt: _chunkWTVLHMZAcjs.CREATE_GUIDANCE.verifiedAt,
     rows,
-    counts: _chunkV3XPLTIRcjs.CREATE_GUIDANCE.counts
-  };
-}
-
-// src/operations/fieldCatalog.ts
-var MAX_FIELD_CATALOG_WIRE = 60;
-var FIELD_CATALOG_HONESTY_NOTE = "Live field metadata reports the SHAPE of a field (existence, requiredness, type, maxLength, read-only, queryable, picklist-ness) and serves picklist VALUES where the vendor exposes them. It cannot resolve a picklist VALUE the vendor does not expose to this API user (the W-A4 wall \u2014 e.g. the attachments Type picklist): retrying the catalog will not surface a withheld value; that gap is vendor-side, not a client defect.";
-var FIELD_CATALOG_OPT_KEYS = ["resources", "include", "fresh"];
-function projectFieldRow(raw) {
-  const r = typeof raw === "object" && raw !== null ? raw : {};
-  const name = typeof r.name === "string" ? r.name : "";
-  const type = typeof r.dataType === "string" ? r.dataType : typeof r.type === "string" ? r.type : "";
-  return {
-    name,
-    ...typeof r.label === "string" && r.label !== "" ? { label: r.label } : {},
-    type,
-    isRequired: r.isRequired === true,
-    isReadOnly: r.isReadOnly === true,
-    isQueryable: r.isQueryable === true,
-    isPickList: r.isPickList === true,
-    maxLength: typeof r.length === "number" ? r.length : null,
-    referenceEntityType: typeof r.referenceEntityType === "string" ? r.referenceEntityType : ""
-  };
-}
-function exposesPicklistValues(raw) {
-  const r = typeof raw === "object" && raw !== null ? raw : {};
-  return Array.isArray(r.picklistValues) && r.picklistValues.length > 0;
-}
-function capabilitySets() {
-  const fieldOps = /* @__PURE__ */ new Map();
-  const udfOps = /* @__PURE__ */ new Map();
-  const resources = /* @__PURE__ */ new Set();
-  for (const rec of _chunkKNTUX3RRcjs.CAPABILITIES) {
-    if (rec.resource === "operations") continue;
-    resources.add(rec.resource);
-    if (rec.operation === "getFieldInfo") fieldOps.set(rec.resource, rec);
-    if (rec.operation === "getUdfInfo") udfOps.set(rec.resource, rec);
-  }
-  return { fieldOps, udfOps, resources };
-}
-function apiEntityFor(rec) {
-  const m = /^GET \/V1\.0\/([^/]+)\/entityInformation\/fields$/.exec(_nullishCoalesce(rec.endpoint, () => ( "")));
-  if (m === null) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
-      `fieldCatalog: the plan's getFieldInfo endpoint for "${rec.resource}" has no /V1.0/<Entity>/entityInformation/fields shape (${rec.endpoint}) \u2014 plan defect`,
-      { operation: "operations.fieldCatalog" }
-    );
-  }
-  return m[1];
-}
-async function fieldCatalog(client, opts) {
-  if (opts !== void 0 && (typeof opts !== "object" || opts === null || Array.isArray(opts))) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
-      "fieldCatalog: opts must be an object { resources?: string[], include?: (info|fields|udf)[], fresh?: boolean }"
-    );
-  }
-  for (const key of Object.keys(_nullishCoalesce(opts, () => ( {})))) {
-    if (!FIELD_CATALOG_OPT_KEYS.includes(key)) {
-      throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
-        `fieldCatalog: unknown opts key "${key}" \u2014 the bag is closed: ${FIELD_CATALOG_OPT_KEYS.join(", ")}`,
-        { suggestedAction: "Drop the unknown key (autotask_describe(operations.fieldCatalog) shows the exact bag)." }
-      );
-    }
-  }
-  const { fieldOps, udfOps, resources: allResources } = capabilitySets();
-  const includeRaw = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _13 => _13.include]), () => ( ["fields"]));
-  if (!Array.isArray(includeRaw) || includeRaw.length === 0) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)("fieldCatalog: opts.include must be a non-empty array of (info|fields|udf)");
-  }
-  const include = [];
-  for (const kind of includeRaw) {
-    if (typeof kind !== "string" || !_chunkV3XPLTIRcjs.FIELD_CACHE_KINDS.includes(kind)) {
-      throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
-        `fieldCatalog: unknown include kind "${String(kind)}" \u2014 the valid kinds are: ${_chunkV3XPLTIRcjs.FIELD_CACHE_KINDS.join(", ")}`,
-        { suggestedAction: `Filter with one or more of: ${_chunkV3XPLTIRcjs.FIELD_CACHE_KINDS.join(", ")} (default ['fields']).` }
-      );
-    }
-    if (!include.includes(kind)) include.push(kind);
-  }
-  const resourcesRaw = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _14 => _14.resources]), () => ( WORKFLOW_RESOURCES));
-  if (!Array.isArray(resourcesRaw) || resourcesRaw.length === 0) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)("fieldCatalog: opts.resources must be a non-empty array of plan resource keys");
-  }
-  const targets = [];
-  for (const r of resourcesRaw) {
-    if (typeof r !== "string" || r.trim() === "") {
-      throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
-        `fieldCatalog: opts.resources must contain non-empty plan resource key strings (got ${typeof r === "string" && r.trim() === "" ? "a blank string" : typeof r})`
-      );
-    }
-    const key = r.trim();
-    const fieldOp = fieldOps.get(key);
-    if (fieldOp === void 0) {
-      if (allResources.has(key)) {
-        throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
-          `fieldCatalog: resource "${key}" has no field catalog \u2014 the vendor defines the entityInformation trio for the ${fieldOps.size} plan entity resources only`,
-          { suggestedAction: `Pass one of the ${fieldOps.size} field-capable plan keys (list them with autotask_catalog).` }
-        );
-      }
-      throw new (0, _chunkV3XPLTIRcjs.AutotaskError)(
-        `fieldCatalog: unknown resource "${key}" \u2014 the plan has ${fieldOps.size} field-capable resources`,
-        {
-          code: "RESOURCE_UNKNOWN",
-          category: "validation",
-          suggestedAction: "Pass the exact plan resource key (snake_case) from autotask_catalog (e.g. tickets, companies, configuration_items)."
-        }
-      );
-    }
-    if (!targets.includes(key)) targets.push(key);
-  }
-  const cost = targets.length * include.length;
-  if (cost > MAX_FIELD_CATALOG_WIRE) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
-      `fieldCatalog: ${targets.length} resource(s) \xD7 ${include.length} kind(s) = ${cost} metadata reads exceed the wire cap of ${MAX_FIELD_CATALOG_WIRE} \u2014 the call is refused above its cap (never truncated)`,
-      { suggestedAction: `Pass a smaller resources list or a narrower include set so the product stays \u2264 ${MAX_FIELD_CATALOG_WIRE}.` }
-    );
-  }
-  const cache = client.http.fieldCache;
-  const fresh = _optionalChain([opts, 'optionalAccess', _15 => _15.fresh]) === true;
-  const zone = _nullishCoalesce(client.config.zone, () => ( "unknown"));
-  const rows = [];
-  let wireUsed = 0;
-  let anyPicklistValues = false;
-  for (const resource of targets) {
-    const fieldOp = fieldOps.get(resource);
-    if (fieldOp === void 0) continue;
-    const apiEntity = apiEntityFor(fieldOp);
-    const holder = client[_chunkV3XPLTIRcjs.camelKey.call(void 0, resource)];
-    const row = {
-      resource,
-      apiEntity,
-      udfCapable: udfOps.has(resource),
-      required: [],
-      readOnly: [],
-      queryable: [],
-      picklistFields: [],
-      cache: { hit: false, age: null },
-      wire: 0,
-      error: null
-    };
-    const fetches = {
-      info: () => _nullishCoalesce(_optionalChain([holder, 'optionalAccess', _16 => _16.getEntityInfo, 'optionalCall', _17 => _17()]), () => ( Promise.reject(new (0, _chunkV3XPLTIRcjs.AutotaskError)(`fieldCatalog: the client exposes no getEntityInfo read for "${resource}"`, { code: "INVALID_RESPONSE", category: "server" })))),
-      fields: () => _nullishCoalesce(_optionalChain([holder, 'optionalAccess', _18 => _18.getFieldInfo, 'optionalCall', _19 => _19()]), () => ( Promise.reject(new (0, _chunkV3XPLTIRcjs.AutotaskError)(`fieldCatalog: the client exposes no getFieldInfo read for "${resource}"`, { code: "INVALID_RESPONSE", category: "server" })))),
-      udf: () => _nullishCoalesce(_optionalChain([holder, 'optionalAccess', _20 => _20.getUdfInfo, 'optionalCall', _21 => _21()]), () => ( Promise.reject(new (0, _chunkV3XPLTIRcjs.AutotaskError)(`fieldCatalog: the client exposes no getUdfInfo read for "${resource}"`, { code: "INVALID_RESPONSE", category: "server" }))))
-    };
-    if (fresh) _optionalChain([cache, 'optionalAccess', _22 => _22.invalidate, 'call', _23 => _23(resource)]);
-    let allCached = true;
-    const ages = [];
-    for (const kind of include) {
-      const peek = cache !== void 0 && !fresh ? cache.peek(resource, kind) : { hit: false, age: null };
-      if (peek.hit !== true) allCached = false;
-      if (peek.hit === true && cache !== void 0) {
-        const value2 = cache.get(resource, kind);
-        if (kind === "info") row.info = _nullishCoalesce(value2, () => ( null));
-        else {
-          const list = Array.isArray(value2) ? value2 : [];
-          const projected = list.map((f) => projectFieldRow(f));
-          if (kind === "fields") row.fields = projected;
-          else row.udf = projected;
-          for (const f of list) if (exposesPicklistValues(f)) anyPicklistValues = true;
-          if (kind === "fields") {
-            row.required = projected.filter((f) => f.isRequired).map((f) => f.name);
-            row.readOnly = projected.filter((f) => f.isReadOnly).map((f) => f.name);
-            row.queryable = projected.filter((f) => f.isQueryable).map((f) => f.name);
-            row.picklistFields = projected.filter((f) => f.isPickList).map((f) => f.name);
-          }
-        }
-        if (peek.age !== null) ages.push(peek.age);
-        continue;
-      }
-      let value;
-      try {
-        value = await fetches[kind]();
-      } catch (err) {
-        wireUsed += 1;
-        row.wire += 1;
-        if (row.error === null) {
-          const code = _chunkV3XPLTIRcjs.isAutotaskError.call(void 0, err) ? err.code : "NETWORK_ERROR";
-          const message = err instanceof Error ? err.message : String(err);
-          row.error = { code, message };
-        }
-        continue;
-      }
-      wireUsed += 1;
-      row.wire += 1;
-      if (kind === "info") {
-        row.info = _nullishCoalesce(value, () => ( null));
-      } else {
-        const list = Array.isArray(value) ? value : [];
-        const projected = list.map((f) => projectFieldRow(f));
-        if (kind === "fields") row.fields = projected;
-        else row.udf = projected;
-        for (const f of list) if (exposesPicklistValues(f)) anyPicklistValues = true;
-        if (kind === "fields") {
-          row.required = projected.filter((f) => f.isRequired).map((f) => f.name);
-          row.readOnly = projected.filter((f) => f.isReadOnly).map((f) => f.name);
-          row.queryable = projected.filter((f) => f.isQueryable).map((f) => f.name);
-          row.picklistFields = projected.filter((f) => f.isPickList).map((f) => f.name);
-        }
-      }
-    }
-    row.cache = allCached ? { hit: true, age: ages.length > 0 ? Math.max(...ages) : 0 } : { hit: false, age: null };
-    rows.push(row);
-  }
-  return {
-    zone,
-    label: zone,
-    cached: cache !== void 0,
-    ttlMs: _nullishCoalesce(_optionalChain([cache, 'optionalAccess', _24 => _24.ttlMs]), () => ( null)),
-    fetchedAt: (/* @__PURE__ */ new Date()).toISOString(),
-    rows,
-    wireUsed,
-    cap: MAX_FIELD_CATALOG_WIRE,
-    truncated: false,
-    counts: {
-      resources: targets.length,
-      fieldCapableResources: fieldOps.size,
-      udfCapableResources: udfOps.size,
-      cached: rows.filter((r) => r.cache.hit === true).length
-    },
-    honesty: {
-      picklistValues: anyPicklistValues ? "partial" : "unexposed",
-      note: FIELD_CATALOG_HONESTY_NOTE
-    }
+    counts: _chunkWTVLHMZAcjs.CREATE_GUIDANCE.counts
   };
 }
 
@@ -856,7 +948,7 @@ var RECOVERY_CONFIRM = "operations.recovery";
 var RECOVERY_DEFAULT_LIMIT = 25;
 var RECOVERY_MAX_LIMIT = 100;
 function configError(message, operation, suggestedAction) {
-  throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(message, { operation, suggestedAction });
+  throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(message, { operation, suggestedAction });
 }
 function parseMatchId(record) {
   const raw = record.id;
@@ -873,7 +965,7 @@ function parseMatchId(record) {
 }
 async function recovery(client, input, opts = {}) {
   const operation = RECOVERY_CONFIRM;
-  if (!_chunkV3XPLTIRcjs.isRecord.call(void 0, input)) {
+  if (!_chunkWTVLHMZAcjs.isRecord.call(void 0, input)) {
     configError(
       `recovery: input must be an object { resource, marker, ... } (got ${typeof input})`,
       operation,
@@ -904,10 +996,10 @@ async function recovery(client, input, opts = {}) {
       "Pass action: 'delete' for the destructive path (dry-run-first; the apply requires the confirm string)."
     );
   }
-  const entry = _chunkV3XPLTIRcjs.RELATIONSHIP_MAP[resource];
+  const entry = _chunkWTVLHMZAcjs.RELATIONSHIP_MAP[resource];
   if (entry === void 0) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskError)(
-      `recovery: unknown resource "${resource}" \u2014 the plan has ${Object.keys(_chunkV3XPLTIRcjs.RELATIONSHIP_MAP).length} resources`,
+    throw new (0, _chunkWTVLHMZAcjs.AutotaskError)(
+      `recovery: unknown resource "${resource}" \u2014 the plan has ${Object.keys(_chunkWTVLHMZAcjs.RELATIONSHIP_MAP).length} resources`,
       {
         code: "RESOURCE_UNKNOWN",
         category: "validation",
@@ -916,7 +1008,7 @@ async function recovery(client, input, opts = {}) {
       }
     );
   }
-  const holder = client[_chunkV3XPLTIRcjs.camelKey.call(void 0, resource)];
+  const holder = client[_chunkWTVLHMZAcjs.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`,
@@ -924,7 +1016,7 @@ 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) : _chunkV3XPLTIRcjs.MARKER_FIELDS[resource];
+  const field = input.field !== void 0 ? String(input.field) : _chunkWTVLHMZAcjs.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`,
@@ -960,7 +1052,7 @@ async function recovery(client, input, opts = {}) {
       );
     }
     for (const c of input.filter) {
-      if (!_chunkV3XPLTIRcjs.isRecord.call(void 0, c) || typeof c.op !== "string" || c.op === "and" || c.op === "or") {
+      if (!_chunkWTVLHMZAcjs.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,
@@ -981,7 +1073,7 @@ async function recovery(client, input, opts = {}) {
     }
     limit = input.limit;
   }
-  const boundaryNote = _chunkV3XPLTIRcjs.DELETE_BOUNDARY_NOTES[resource];
+  const boundaryNote = _chunkWTVLHMZAcjs.DELETE_BOUNDARY_NOTES[resource];
   const boundary = {
     available: boundaryNote === void 0,
     reason: _nullishCoalesce(boundaryNote, () => ( null)),
@@ -993,7 +1085,7 @@ async function recovery(client, input, opts = {}) {
   };
   const isDelete = action === "delete";
   if (isDelete && boundaryNote !== void 0) {
-    throw new (0, _chunkV3XPLTIRcjs.DeleteBoundaryError)(
+    throw new (0, _chunkWTVLHMZAcjs.DeleteBoundaryError)(
       `recovery: the vendor defines no DELETE for ${resource} \u2014 the delete cannot be issued through the API (zero wire was issued)`,
       {
         operation,
@@ -1002,10 +1094,10 @@ async function recovery(client, input, opts = {}) {
       }
     );
   }
-  const dryRun = _optionalChain([opts, 'optionalAccess', _25 => _25.dryRun]) !== false;
-  const confirm = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _26 => _26.confirm]), () => ( input.confirm));
+  const dryRun = _optionalChain([opts, 'optionalAccess', _18 => _18.dryRun]) !== false;
+  const confirm = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _19 => _19.confirm]), () => ( input.confirm));
   if (isDelete && !dryRun && confirm !== RECOVERY_CONFIRM) {
-    throw new (0, _chunkV3XPLTIRcjs.ConfirmationRequiredError)(
+    throw new (0, _chunkWTVLHMZAcjs.ConfirmationRequiredError)(
       `recovery: action 'delete' apply is destructive and requires its confirmation flag: pass confirm: "${RECOVERY_CONFIRM}"`,
       {
         operation: RECOVERY_CONFIRM,
@@ -1021,7 +1113,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, _chunkV3XPLTIRcjs.RecoveryTruncatedError)(
+    throw new (0, _chunkWTVLHMZAcjs.RecoveryTruncatedError)(
       `recovery: the marker search on ${resource} TRIPPED its match cap (${limit}) \u2014 more matches exist than were returned (zero ${wire} was issued)`,
       {
         operation,
@@ -1060,7 +1152,7 @@ async function recovery(client, input, opts = {}) {
     return { ...base, simulated: true, dryRun: true };
   }
   if (unsafeId) {
-    throw new (0, _chunkV3XPLTIRcjs.MarkerUnsafeIdError)(
+    throw new (0, _chunkWTVLHMZAcjs.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,
@@ -1071,7 +1163,7 @@ async function recovery(client, input, opts = {}) {
   }
   const deleteMethod = holder.delete;
   if (deleteMethod === void 0) {
-    throw new (0, _chunkV3XPLTIRcjs.DeleteBoundaryError)(
+    throw new (0, _chunkWTVLHMZAcjs.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,
@@ -1100,14 +1192,14 @@ async function recovery(client, input, opts = {}) {
           verify = "still-present";
         }
       } catch (err) {
-        if (err instanceof _chunkV3XPLTIRcjs.NotFoundError) verify = "not-found";
+        if (err instanceof _chunkWTVLHMZAcjs.NotFoundError) verify = "not-found";
         else {
           verify = "error";
-          code = _chunkV3XPLTIRcjs.isAutotaskError.call(void 0, err) ? err.code : "SERVER_ERROR";
+          code = _chunkWTVLHMZAcjs.isAutotaskError.call(void 0, err) ? err.code : "SERVER_ERROR";
         }
       }
     } catch (err) {
-      code = _chunkV3XPLTIRcjs.isAutotaskError.call(void 0, err) ? err.code : "SERVER_ERROR";
+      code = _chunkWTVLHMZAcjs.isAutotaskError.call(void 0, err) ? err.code : "SERVER_ERROR";
     }
     deleted.push({ id, verified: verify === "not-found", code });
   }
@@ -1115,13 +1207,13 @@ async function recovery(client, input, opts = {}) {
 }
 
 // src/operations/invoke.ts
-var RECORDS = _chunkKNTUX3RRcjs.CAPABILITIES;
+var RECORDS = _chunkWTVD2JZNcjs.CAPABILITIES;
 var byId = new Map(RECORDS.map((r) => [r.id, r]));
 function needsConfirmation(record) {
   return record.effect === "destructive" || (_nullishCoalesce(record.flags, () => ( []))).includes("requiresApproval");
 }
 function refuse(message, operation, suggestedAction) {
-  throw new (0, _chunkV3XPLTIRcjs.ConfirmationRequiredError)(message, { operation, suggestedAction });
+  throw new (0, _chunkWTVLHMZAcjs.ConfirmationRequiredError)(message, { operation, suggestedAction });
 }
 var MODE_BY_EFFECT = {
   read: "read",
@@ -1165,7 +1257,7 @@ function looseTypeOk(type, value) {
     case "string[]":
       return Array.isArray(value) && value.every((v) => typeof v === "string");
     case "object":
-      return _chunkV3XPLTIRcjs.isRecord.call(void 0, value);
+      return _chunkWTVLHMZAcjs.isRecord.call(void 0, value);
     default:
       return true;
   }
@@ -1182,7 +1274,7 @@ function validateDispatchArgs(record, argsIn) {
   const schema = _nullishCoalesce(record.inputSchema, () => ( {}));
   const names = Object.keys(schema);
   if (args.length > names.length) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
+    throw new (0, _chunkWTVLHMZAcjs.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)`,
       {
         operation,
@@ -1192,7 +1284,7 @@ function validateDispatchArgs(record, argsIn) {
   }
   const required = names.filter((n) => schema[n].required);
   if (args.length < required.length) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
+    throw new (0, _chunkWTVLHMZAcjs.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 }
     );
@@ -1203,7 +1295,7 @@ function validateDispatchArgs(record, argsIn) {
     const name = names[i];
     const spec = schema[name];
     if (!looseTypeOk(spec.type, value)) {
-      throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
+      throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(
         `invoke: "${operation}" arg ${i + 1} is declared ${name}: ${spec.type} \u2014 the value has the wrong type (pass a ${spec.type} value)`,
         { operation }
       );
@@ -1211,12 +1303,14 @@ function validateDispatchArgs(record, argsIn) {
   }
 }
 var PARAMS_BAG_KEYS = {
-  query: ["filter", "limit", "includeFields", "via"],
+  query: ["filter", "limit", "includeFields", "via", "latest", "noteChars", "fieldsPreset"],
   queryAll: ["filter", "maxRecords", "includeFields", "maxTotalRecords", "via"],
   count: ["filter"]
 };
 var BAG_KEY_SYNONYMS = {
   filters: "filter",
+  last: "latest",
+  // issue #59: the expected typo class (honoured only on `query`)
   lmit: "limit",
   page: "limit",
   pageSize: "limit",
@@ -1252,12 +1346,12 @@ 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', _27 => _27[0]]);
-  if (bag === void 0 || bag === null || !_chunkV3XPLTIRcjs.isRecord.call(void 0, bag)) return;
+  const bag = _optionalChain([args, 'optionalAccess', _20 => _20[0]]);
+  if (bag === void 0 || bag === null || !_chunkWTVLHMZAcjs.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, _chunkV3XPLTIRcjs.AutotaskConfigError)(
+  throw new (0, _chunkWTVLHMZAcjs.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,
@@ -1271,7 +1365,7 @@ function validateInvokeOptions(opts, operation) {
   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"])]).filter((pair) => pair[1] !== null).map(([k, s]) => `"${k}" \u2192 "${s}"`);
-  throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
+  throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(
     `invoke: "${operation}" has unknown option key(s) ${unknown.map((k) => `"${k}"`).join(", ")} \u2014 the options set is closed (valid: dryRun, confirm, lastModifiedDate)`,
     {
       operation,
@@ -1284,7 +1378,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, _chunkV3XPLTIRcjs.AutotaskConfigError)(
+  return new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(
     `unknown ${subject} ${unknown.map((k) => `"${k}"`).join(", ")} \u2014 the ${subject} set is closed (valid keys: ${validKeys.join(", ")})`,
     {
       ...operation !== void 0 ? { operation } : {},
@@ -1296,7 +1390,7 @@ async function invokeMode(client, operation, argsIn = [], opts = {}) {
   const args = _nullishCoalesce(argsIn, () => ( []));
   const record = byId.get(operation);
   if (record === void 0) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
+    throw new (0, _chunkWTVLHMZAcjs.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." }
     );
@@ -1304,17 +1398,17 @@ async function invokeMode(client, operation, argsIn = [], opts = {}) {
   validateInvokeOptions(opts, operation);
   const mode = opts.mode;
   if (mode !== void 0 && MODE_BY_EFFECT[record.effect] !== mode) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(crossModeRefusal(operation, record.effect, mode), { operation });
+    throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(crossModeRefusal(operation, record.effect, mode), { operation });
   }
   if (opts.dryRun !== void 0 && typeof opts.dryRun !== "boolean") {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
+    throw new (0, _chunkWTVLHMZAcjs.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, _chunkV3XPLTIRcjs.AutotaskConfigError)(
+    throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(
       `invoke: "${operation}" is a read \u2014 dryRun is not applicable (reads issue their request as-is)`,
       { operation }
     );
@@ -1329,12 +1423,30 @@ async function invokeMode(client, operation, argsIn = [], opts = {}) {
   validateDispatchArgs(record, args);
   validateParamsBag(record, args);
   const boundedQuery = record.kind === "primitive" && record.operation === "query";
-  let holder = client[_chunkV3XPLTIRcjs.camelKey.call(void 0, record.resource)];
+  let holder = client[_chunkWTVLHMZAcjs.camelKey.call(void 0, record.resource)];
+  if (typeof holder === "function") {
+    holder = _nullishCoalesce(client[`${_chunkWTVLHMZAcjs.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) => fetchMany(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) => fetchByIds(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) => _chunkWTVLHMZAcjs.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-
@@ -1347,7 +1459,7 @@ async function invokeMode(client, operation, argsIn = [], opts = {}) {
       // 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) => fieldCatalog(client, opts2),
+      fieldCatalog: (opts2) => _chunkWTVLHMZAcjs.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
@@ -1356,7 +1468,7 @@ async function invokeMode(client, operation, argsIn = [], opts = {}) {
     };
   }
   if (holder === void 0) {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
+    throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(
       `invoke: the client exposes no accessor for resource "${record.resource}"`,
       { operation }
     );
@@ -1364,7 +1476,7 @@ async function invokeMode(client, operation, argsIn = [], opts = {}) {
   const methodName = boundedQuery ? "queryBounded" : record.operation;
   const method = holder[methodName];
   if (typeof method !== "function") {
-    throw new (0, _chunkV3XPLTIRcjs.AutotaskConfigError)(
+    throw new (0, _chunkWTVLHMZAcjs.AutotaskConfigError)(
       `invoke: "${record.resource}.${methodName}" is not a callable method on the client`,
       { operation }
     );
@@ -1456,5 +1568,14 @@ async function invokeDelete(client, operation, args = [], opts = {}) {
 
 
 
-exports.BLIND_SURFACE_KINDS = BLIND_SURFACE_KINDS; exports.CREATE_BLOCKER_KINDS = CREATE_BLOCKER_KINDS; exports.FETCH_MANY_MAX_ITEMS = FETCH_MANY_MAX_ITEMS; exports.FIELD_CACHE_KINDS = _chunkV3XPLTIRcjs.FIELD_CACHE_KINDS; exports.FIELD_CATALOG_HONESTY_NOTE = FIELD_CATALOG_HONESTY_NOTE; exports.INVOKE_OPTION_KEYS = INVOKE_OPTION_KEYS; exports.MAX_FIELD_CATALOG_WIRE = MAX_FIELD_CATALOG_WIRE; exports.PARAMS_BAG_KEYS = PARAMS_BAG_KEYS; exports.RECOVERY_CONFIRM = RECOVERY_CONFIRM; exports.RECOVERY_DEFAULT_LIMIT = RECOVERY_DEFAULT_LIMIT; exports.RECOVERY_MAX_LIMIT = RECOVERY_MAX_LIMIT; exports.WORKFLOW_RESOURCES = WORKFLOW_RESOURCES; exports.blindSurfaces = blindSurfaces; exports.createGuidance = createGuidance; exports.fetchMany = fetchMany; exports.fieldCatalog = 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 = validateFetchManyItems; exports.validateInvokeOptions = validateInvokeOptions; exports.validateParamsBag = validateParamsBag;
-//# sourceMappingURL=index.cjs.map
+
+
+
+
+
+
+
+
+
+
+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 = _chunkWTVLHMZAcjs.EXPAND_RESOURCE_NAMES_MAX_IDS; exports.FETCH_BY_IDS_CHUNK_SIZE = FETCH_BY_IDS_CHUNK_SIZE; exports.FETCH_BY_IDS_MAX_ITEMS = FETCH_BY_IDS_MAX_ITEMS; exports.FETCH_MANY_MAX_ITEMS = FETCH_MANY_MAX_ITEMS; exports.FIELD_CACHE_KINDS = _chunkWTVLHMZAcjs.FIELD_CACHE_KINDS; exports.FIELD_CATALOG_HONESTY_NOTE = _chunkWTVLHMZAcjs.FIELD_CATALOG_HONESTY_NOTE; exports.INVOKE_OPTION_KEYS = INVOKE_OPTION_KEYS; exports.MAX_FIELD_CATALOG_WIRE = _chunkWTVLHMZAcjs.MAX_FIELD_CATALOG_WIRE; exports.PARAMS_BAG_KEYS = PARAMS_BAG_KEYS; exports.PICKLIST_VALUE_NOT_SERVED_NOTE = _chunkWTVLHMZAcjs.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 = _chunkWTVLHMZAcjs.WORKFLOW_RESOURCES; exports.aggregate = aggregate; exports.blindSurfaces = blindSurfaces; exports.createGuidance = createGuidance; exports.expandResourceNames = _chunkWTVLHMZAcjs.expandResourceNames; exports.fetchByIds = fetchByIds; exports.fetchMany = fetchMany; exports.fieldCatalog = _chunkWTVLHMZAcjs.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 = validateFetchManyItems; exports.validateInvokeOptions = validateInvokeOptions; exports.validateParamsBag = validateParamsBag;