node-autotask 0.69.0 → 0.70.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.
package/CHANGELOG.md CHANGED
@@ -7,6 +7,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [0.70.0] - 2026-11-17
11
+
12
+ ### Added
13
+
14
+ - Add `invokeReadPages` on the existing operations subpath for governed explicit bounded query walks (#459). Await page consumers for backpressure and return terminal completeness metadata without collecting all rows. Share invocation validation/scope admission and the bounded cursor engine with ordinary reads; preserve per-page labels, note handling, caps, continuation bodies, typed failures and cancellation through the final callback. No new MCP operation or query cache is introduced.
15
+
16
+ ### Changed
17
+
18
+ - Reuse bounded metadata projections within the exact cache entry for live field authority, catalog views, picklist labels and ticket-status semantics (#459). Preserve raw/projected subscriber sharing, independent values and cancellation, fresh/invalidation/epoch behavior, older cache/reader fallbacks and cache-off behavior. Derived variants do not extend metadata lifetime.
19
+ - Retain existing ordinary/reference/metadata TTLs and defer general query/report response caching (#459). Document the missing hit-rate/external-change evidence and required freshness, permission, key, completeness and budget contracts rather than silently extending staleness.
20
+
21
+ ## [0.69.1] - 2026-11-17
22
+
23
+ ### Changed
24
+
25
+ - Reuse bounded ordered reads for independent exact resolution, uncapped cross-resource search, field-catalog kinds/resources, bulk group queries and fallback GETs (#458). Preserve capped-search quotas, exact-to-contains barriers, count/chunk dependencies, input order, typed failures and draining.
26
+ - Overlap fully disjoint label groups, retaining serial traversal when any target is shared so warming budgets and fatal-error order stay intact. Reuse identical normalized relation-parent queries within one invocation and overlap flat OR branches; AND and nested short-circuit paths remain ordered (#458).
27
+ - Admit transport requests only when client and shared-object capacity are both available, so queued work holds neither slot. Index waiters and share cancellation notifications to avoid quadratic backlog scans. Keep the shared object ceiling, atomic hourly accounting and response-body leases, including live v1 semaphores from older SDK copies; existing legacy waiters retain priority (#458).
28
+ - Compile immutable vendored field-membership lookups once for validation, projections and labels. Live tenant metadata and current live-only exemptions remain authoritative; no query/report response cache is introduced (#458).
29
+
30
+ ### Fixed
31
+
32
+ - Share metadata GETs through the record cache's subscriber adapter: isolate cancellation, values and typed failures, prevent stale in-flight repopulation, preserve report failure observation and private-quota isolation, and retain only nonempty metadata. Ticket-status metadata uses the same channel and keeps its retry policy (#458).
33
+ - Reject non-model inherited property names as bulk resources before any vendor request (#458).
34
+
10
35
  ## [0.69.0] - 2026-11-17
11
36
 
12
37
  ### Breaking
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "generatedBy": "scripts/build-tool-catalog.mjs",
3
- "generatedAt": "2026-11-17T12:34:23.940Z",
3
+ "generatedAt": "2026-11-17T17:54:29.292Z",
4
4
  "planHash": "959981d335cfd184d8b4e58074d1ab6997b2db87a62683ed13e99c149f8cd4fa",
5
5
  "metaTools": [
6
6
  {
package/README.md CHANGED
@@ -227,6 +227,12 @@ consumes hourly admission and the applicable object-thread limit.
227
227
  The [vendor threshold reference](https://www.autotask.net/help/developerhelp/content/apis/REST/General_Topics/REST_Thresholds_Limits.htm)
228
228
  describes that database-wide limit.
229
229
 
230
+ For large governed query exports, [`invokeReadPages`](docs/API.md#74a-invokereadpages--governed-bounded-page-consumption)
231
+ awaits each page consumer and returns the bounded walk's terminal evidence without
232
+ collecting every row. Metadata-derived views reuse work within the existing cache
233
+ entry; [cache evaluation](docs/performance-caching.md) explains why ordinary TTLs and
234
+ query/report caching policy remain unchanged. Neither optimization raises API limits.
235
+
230
236
  ## Agent profile (conservative limits for LLM-driven servers)
231
237
 
232
238
  `profile: 'agent'` on the config switches the SDK to conservative limits for
package/capabilities.json CHANGED
@@ -1,9 +1,9 @@
1
1
  {
2
- "generatedAt": "2026-11-17T12:33:45.861Z",
2
+ "generatedAt": "2026-11-17T17:53:33.457Z",
3
3
  "groups": {
4
4
  "B": {
5
5
  "planHash": "959981d335cfd184d8b4e58074d1ab6997b2db87a62683ed13e99c149f8cd4fa",
6
- "builtAt": "2026-11-17T12:33:45.837Z",
6
+ "builtAt": "2026-11-17T17:53:33.435Z",
7
7
  "records": [
8
8
  {
9
9
  "id": "appointments.count",
@@ -42787,7 +42787,7 @@
42787
42787
  },
42788
42788
  "A": {
42789
42789
  "planHash": "959981d335cfd184d8b4e58074d1ab6997b2db87a62683ed13e99c149f8cd4fa",
42790
- "builtAt": "2026-11-17T12:33:45.837Z",
42790
+ "builtAt": "2026-11-17T17:53:33.435Z",
42791
42791
  "records": [
42792
42792
  {
42793
42793
  "id": "companies.count",
@@ -82295,7 +82295,7 @@
82295
82295
  },
82296
82296
  "operations": {
82297
82297
  "planHash": "959981d335cfd184d8b4e58074d1ab6997b2db87a62683ed13e99c149f8cd4fa",
82298
- "builtAt": "2026-11-17T12:33:45.837Z",
82298
+ "builtAt": "2026-11-17T17:53:33.435Z",
82299
82299
  "records": [
82300
82300
  {
82301
82301
  "id": "operations.aggregate",
@@ -349,7 +349,7 @@ const CAPABILITY_DATA = {
349
349
  "groups": {
350
350
  "B": {
351
351
  "planHash": "959981d335cfd184d8b4e58074d1ab6997b2db87a62683ed13e99c149f8cd4fa",
352
- "builtAt": "2026-11-17T12:33:45.837Z",
352
+ "builtAt": "2026-11-17T17:53:33.435Z",
353
353
  "records": [
354
354
  {
355
355
  "id": "appointments.count",
@@ -43133,7 +43133,7 @@ const CAPABILITY_DATA = {
43133
43133
  },
43134
43134
  "A": {
43135
43135
  "planHash": "959981d335cfd184d8b4e58074d1ab6997b2db87a62683ed13e99c149f8cd4fa",
43136
- "builtAt": "2026-11-17T12:33:45.837Z",
43136
+ "builtAt": "2026-11-17T17:53:33.435Z",
43137
43137
  "records": [
43138
43138
  {
43139
43139
  "id": "companies.count",
@@ -82641,7 +82641,7 @@ const CAPABILITY_DATA = {
82641
82641
  },
82642
82642
  "operations": {
82643
82643
  "planHash": "959981d335cfd184d8b4e58074d1ab6997b2db87a62683ed13e99c149f8cd4fa",
82644
- "builtAt": "2026-11-17T12:33:45.837Z",
82644
+ "builtAt": "2026-11-17T17:53:33.435Z",
82645
82645
  "records": [
82646
82646
  {
82647
82647
  "id": "operations.aggregate",