node-autotask 0.66.0 → 0.68.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (34) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/MCP_TOOL_CATALOG.json +28 -9
  3. package/README.md +1 -1
  4. package/capabilities.json +107 -8
  5. package/dist/capabilities-data.js +106 -7
  6. package/dist/capabilities.cjs +4 -4
  7. package/dist/capabilities.js +1 -1
  8. package/dist/{chunk-4HJVHVPE.js → chunk-BF22HBNT.js} +2 -2
  9. package/dist/{chunk-XAJ7SBPE.cjs → chunk-CG6OPTFG.cjs} +31 -31
  10. package/dist/{chunk-KO36QZXN.js → chunk-DPJLN5BB.js} +2599 -2306
  11. package/dist/{chunk-QG3O5G4L.cjs → chunk-HFWOHUVF.cjs} +173 -173
  12. package/dist/{chunk-L5K2D2MZ.js → chunk-JCMXQUIC.js} +3 -3
  13. package/dist/{chunk-T5TI22K5.js → chunk-OUVUQQXH.js} +2 -2
  14. package/dist/{chunk-FLVMENXG.cjs → chunk-SGH7F2CH.cjs} +3 -3
  15. package/dist/{chunk-TIFJFCCN.cjs → chunk-V2GE763R.cjs} +2603 -2309
  16. package/dist/{index-BZ11hF8H.d.ts → index-DQ08uOH0.d.ts} +45 -5
  17. package/dist/{index-DnisYPlj.d.cts → index-mIsdpO5d.d.cts} +45 -5
  18. package/dist/index.cjs +84 -84
  19. package/dist/index.d.cts +2 -2
  20. package/dist/index.d.ts +2 -2
  21. package/dist/index.js +5 -5
  22. package/dist/operations/index.cjs +50 -50
  23. package/dist/operations/index.d.cts +2 -2
  24. package/dist/operations/index.d.ts +2 -2
  25. package/dist/operations/index.js +2 -2
  26. package/dist/pool.cjs +29 -11
  27. package/dist/pool.js +25 -7
  28. package/dist/resources/index.cjs +27 -27
  29. package/dist/resources/index.d.cts +1 -1
  30. package/dist/resources/index.d.ts +1 -1
  31. package/dist/resources/index.js +3 -3
  32. package/docs/API.md +3 -3
  33. package/docs/VENDOR-QUIRKS.md +32 -0
  34. package/package.json +1 -1
@@ -948,6 +948,38 @@ expires on the READ entity's TTL, and a not-found marker on its path's TTL.
948
948
  The per-resource override map (`cache.perResourceTtlMs`) and the generated
949
949
  per-resource table were removed in 0.40.0.
950
950
 
951
+ **Company fuzzy-name index (#453).** This is a named exception to the ordinary
952
+ no-list-cache policy, stored separately from the clone-on-read record cache.
953
+ `companies.searchFuzzy(query, { limit?, includeFamily?, includeInactive? })` always
954
+ issues an uncached OR fragment query (one page, at most 500 rows). On the first
955
+ call it also starts a background slim walk of caller-visible company IDs, names,
956
+ active flags and parent IDs, preserving the projection across continuation pages.
957
+ The first response reports `index.state: building`; warm responses union live rows
958
+ with indexed candidates so a recently created company can still appear. No
959
+ unscoped-walk acknowledgement is required for this internal slim index.
960
+
961
+ The index refresh interval is `cache.companyIndexTtlMs` (default 30 minutes).
962
+ Company mutations clear it immediately and debounce rebuilding until one second
963
+ after the last company write; unrelated writes leave it intact.
964
+ `cache: false` disables it (the MCP server passes this for `AUTOTASK_CACHE=off`). Background failures never publish
965
+ a partial index: they drop the snapshot and retry on the next fuzzy search.
966
+ Pool removal suspends refreshes. Tenant and impersonation identities stay isolated.
967
+ The index reflects this API user's visibility, never the whole tenant by promise.
968
+
969
+ Queries are bounded to 1000 characters and 16 distinct meaningful terms.
970
+ Names use NFKD accent folding, lowercase and ampersand-to-`and` conversion.
971
+ Stopwords and legal suffixes do not contribute to scoring. Candidates use n-gram
972
+ Dice ordering and bounded Damerau distance (an adjacent swap costs one), ranked by
973
+ query words covered, distance and active status. Active companies are returned by
974
+ default. Even one candidate requires confirmation rather than an exact identity
975
+ assumption. Live fragments have bounded recall, particularly for short words or
976
+ swaps across fragment boundaries; a cold/live-only miss does not establish absence.
977
+ The result's `tier`, `pieces`, `truncated` and `index` state describe those limits.
978
+
979
+ Owner probe evidence (sandbox, 2026-11-17, #453): company-name `contains` ignored
980
+ case, did not ignore accents, and accepted OR groups. No live probe is required to
981
+ use the mocked regression suite.
982
+
951
983
  ### 11.16 The opt-in PUT item-path fallback for a 404'd update route (issue #34)
952
984
 
953
985
  A zone can stop registering the update route the spec pinned (WYRE-AI hit
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "node-autotask",
3
- "version": "0.66.0",
3
+ "version": "0.68.0",
4
4
  "description": "Fully-typed TypeScript SDK for the Autotask (Datto) PSA REST API. Zero runtime dependencies. Built for building MCP servers and integrations.",
5
5
  "type": "module",
6
6
  "sideEffects": false,