node-autotask 0.72.0 → 0.73.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 (42) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/MCP_TOOL_CATALOG.json +49 -8
  3. package/README.md +1 -1
  4. package/capabilities.json +139 -7
  5. package/dist/capabilities-data.js +138 -6
  6. package/dist/capabilities.cjs +4 -4
  7. package/dist/capabilities.js +1 -1
  8. package/dist/{chunk-HJVTA7SI.cjs → chunk-CKIKNZEB.cjs} +30 -30
  9. package/dist/{chunk-KVC5DZAP.cjs → chunk-CWSXFVF2.cjs} +88 -16
  10. package/dist/{chunk-A4IRIYZ5.js → chunk-L4J5EDCU.js} +2 -2
  11. package/dist/{chunk-K33DPJFK.js → chunk-PNMEXWYR.js} +3 -3
  12. package/dist/{chunk-F2TYZKJS.js → chunk-RFH4VBMX.js} +126 -2
  13. package/dist/{chunk-V5UGW6KZ.cjs → chunk-STUQU7AX.cjs} +301 -177
  14. package/dist/{chunk-EGG2RGL5.js → chunk-VHN5B7OQ.js} +82 -12
  15. package/dist/{chunk-SPME362B.cjs → chunk-VHNWLON6.cjs} +3 -3
  16. package/dist/{index-BXnhBnhN.d.cts → index-CGp16Cdm.d.cts} +9 -20
  17. package/dist/{index-BXnhBnhN.d.ts → index-CGp16Cdm.d.ts} +9 -20
  18. package/dist/{index-DxfspQR1.d.ts → index-Dv8d9p_J.d.ts} +164 -4
  19. package/dist/{index-CqsY5YHt.d.cts → index-MUM-uBX1.d.cts} +164 -4
  20. package/dist/index.cjs +84 -84
  21. package/dist/index.d.cts +3 -5
  22. package/dist/index.d.ts +3 -5
  23. package/dist/index.js +5 -5
  24. package/dist/operations/index.cjs +51 -51
  25. package/dist/operations/index.d.cts +5 -6
  26. package/dist/operations/index.d.ts +5 -6
  27. package/dist/operations/index.js +2 -2
  28. package/dist/pool.cjs +12 -12
  29. package/dist/pool.d.cts +1 -1
  30. package/dist/pool.d.ts +1 -1
  31. package/dist/pool.js +4 -4
  32. package/dist/resources/index.cjs +27 -27
  33. package/dist/resources/index.d.cts +2 -2
  34. package/dist/resources/index.d.ts +2 -2
  35. package/dist/resources/index.js +3 -3
  36. package/dist/types/index.d.cts +1 -1
  37. package/dist/types/index.d.ts +1 -1
  38. package/docs/API.md +2 -2
  39. package/docs/N8N-ADAPTER.md +1 -1
  40. package/package.json +1 -1
  41. package/dist/base-CHMATPq0.d.cts +0 -145
  42. package/dist/base-CHMATPq0.d.ts +0 -145
package/CHANGELOG.md CHANGED
@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [0.73.0] - 2026-11-19
11
+
12
+ ### Added
13
+
14
+ - Submit and cancel resource-scoped time-off requests with metadata-backed status validation and typed write inputs. Existing approval, rejection and read workflows remain available (#465).
15
+
16
+ ### Changed
17
+
18
+ - The exported `TimeOffRequestCreate` and `TimeOffRequestUpdate` input types now describe the restricted submission and cancellation fields (#465).
19
+
20
+ ### Fixed
21
+
22
+ - Mark creation as irreversible when the resource declares no DELETE and include the canonical warning when `createIfNotExists` would create a record (#480).
23
+
10
24
  ## [0.72.0] - 2026-11-19
11
25
 
12
26
  ### Added
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "generatedBy": "scripts/build-tool-catalog.mjs",
3
- "generatedAt": "2026-11-18T13:26:15.447Z",
4
- "planHash": "79f3968f072705fbc7b479dba6863a27bde47deee7b85885eda8d019302f9c25",
3
+ "generatedAt": "2026-11-18T23:44:46.969Z",
4
+ "planHash": "3dfaa99bd81e843635bafd242e5229270f259de68c6a32d483a6640402f3b187",
5
5
  "metaTools": [
6
6
  {
7
7
  "name": "autotask_catalog",
@@ -51,7 +51,7 @@
51
51
  {
52
52
  "name": "autotask_read",
53
53
  "title": "Read One Registry Operation (read mode)",
54
- "description": "Route an effect=read registry operation by its exact name (never fuzzy, never a tool name): the 400 field/entity/UDF-info reads (getEntityInfo/getFieldInfo/getUdfInfo) have no dedicated tool and ride this one, and any read op is routable. For field discovery use operations.fieldCatalog (compact) instead of per-resource getFieldInfo (full dump). Read-only by construction — every op it can route is effect=read (zero mutating requests), and a write or delete op is refused BEFORE any request (cross-mode refusal; the message names the correct tool). Reads have no dry run (a read with dry_run: true is refused). Harness approval policy: approve every tool with readOnlyHint !== true (exactly 258 today); the 623 readOnlyHint: true tools — including this one — are safe ungated; the 59 destructiveHint: true tools (58 dedicated delete tools + autotask_delete) require confirm === the operation key. Migration: autotask_invoke is REPLACED by autotask_read/autotask_write/autotask_delete — update harness config. For query/count ops args[0] is a params object (filter/limit); call autotask_describe first for the exact arg shape and filter grammar. The argument set is CLOSED at the top level: an unknown argument is refused before any request, with a typed error naming the key and the valid keys.",
54
+ "description": "Route an effect=read registry operation by its exact name (never fuzzy, never a tool name): the 400 field/entity/UDF-info reads (getEntityInfo/getFieldInfo/getUdfInfo) have no dedicated tool and ride this one, and any read op is routable. For field discovery use operations.fieldCatalog (compact) instead of per-resource getFieldInfo (full dump). Read-only by construction — every op it can route is effect=read (zero mutating requests), and a write or delete op is refused BEFORE any request (cross-mode refusal; the message names the correct tool). Reads have no dry run (a read with dry_run: true is refused). Harness approval policy: approve every tool with readOnlyHint !== true (exactly 260 today); the 623 readOnlyHint: true tools — including this one — are safe ungated; the 59 destructiveHint: true tools (58 dedicated delete tools + autotask_delete) require confirm === the operation key. Migration: autotask_invoke is REPLACED by autotask_read/autotask_write/autotask_delete — update harness config. For query/count ops args[0] is a params object (filter/limit); call autotask_describe first for the exact arg shape and filter grammar. The argument set is CLOSED at the top level: an unknown argument is refused before any request, with a typed error naming the key and the valid keys.",
55
55
  "input": {
56
56
  "operation": {
57
57
  "type": "string",
@@ -71,7 +71,7 @@
71
71
  {
72
72
  "name": "autotask_write",
73
73
  "title": "Write One Registry Operation (write mode)",
74
- "description": "Route an effect=write registry operation by its exact name (never fuzzy, never a tool name), dry-run-first: the first call always travels dry_run: true (the pinned DryRunResult envelope, simulated: true — the mutating request is never issued); pass dry_run: false to apply. A read or delete op is refused BEFORE any request (cross-mode refusal; the message names the correct tool). The 2 approval-gated writes (configuration_items.moveConfigurationItem, contacts.moveToCompany) additionally require confirm === the operation key, in BOTH dry-run and apply mode. Harness approval policy: this tool is one of the 258 tools that require approval (readOnlyHint !== true); the 623 readOnlyHint: true tools are safe ungated, and the 59 destructiveHint: true tools (58 dedicated delete tools + autotask_delete) require confirm === the operation key. Migration: autotask_invoke is REPLACED by autotask_read/autotask_write/autotask_delete — update harness config. For query/count ops args[0] is a params object (filter/limit); call autotask_describe first for the exact arg shape and filter grammar. The argument set is CLOSED at the top level: an unknown argument is refused before any request, with a typed error naming the key and the valid keys.",
74
+ "description": "Route an effect=write registry operation by its exact name (never fuzzy, never a tool name), dry-run-first: the first call always travels dry_run: true (the pinned DryRunResult envelope, simulated: true — the mutating request is never issued); pass dry_run: false to apply. A read or delete op is refused BEFORE any request (cross-mode refusal; the message names the correct tool). The 2 approval-gated writes (configuration_items.moveConfigurationItem, contacts.moveToCompany) additionally require confirm === the operation key, in BOTH dry-run and apply mode. Harness approval policy: this tool is one of the 260 tools that require approval (readOnlyHint !== true); the 623 readOnlyHint: true tools are safe ungated, and the 59 destructiveHint: true tools (58 dedicated delete tools + autotask_delete) require confirm === the operation key. Migration: autotask_invoke is REPLACED by autotask_read/autotask_write/autotask_delete — update harness config. For query/count ops args[0] is a params object (filter/limit); call autotask_describe first for the exact arg shape and filter grammar. The argument set is CLOSED at the top level: an unknown argument is refused before any request, with a typed error naming the key and the valid keys.",
75
75
  "input": {
76
76
  "operation": {
77
77
  "type": "string",
@@ -101,7 +101,7 @@
101
101
  {
102
102
  "name": "autotask_delete",
103
103
  "title": "Delete One Registry Operation (delete mode)",
104
- "description": "Route an effect=destructive (delete) registry operation by its exact name (never fuzzy, never a tool name), dry-run-first: the first call always travels dry_run: true (the pinned DryRunResult envelope, simulated: true); pass dry_run: false to apply. confirm === the operation key is REQUIRED for every delete (all 58), in BOTH dry-run and apply mode — the deliberate act is the call, not the delete. A read or write op is refused BEFORE any request (cross-mode refusal; the message names the correct tool). Harness approval policy: this tool is one of the 59 destructiveHint: true tools that require approval + confirm; approve every tool with readOnlyHint !== true (exactly 258 today); the 623 readOnlyHint: true tools are safe ungated. Migration: autotask_invoke is REPLACED by autotask_read/autotask_write/autotask_delete — update harness config. The argument set is CLOSED at the top level: an unknown argument is refused before any request, with a typed error naming the key and the valid keys.",
104
+ "description": "Route an effect=destructive (delete) registry operation by its exact name (never fuzzy, never a tool name), dry-run-first: the first call always travels dry_run: true (the pinned DryRunResult envelope, simulated: true); pass dry_run: false to apply. confirm === the operation key is REQUIRED for every delete (all 58), in BOTH dry-run and apply mode — the deliberate act is the call, not the delete. A read or write op is refused BEFORE any request (cross-mode refusal; the message names the correct tool). Harness approval policy: this tool is one of the 59 destructiveHint: true tools that require approval + confirm; approve every tool with readOnlyHint !== true (exactly 260 today); the 623 readOnlyHint: true tools are safe ungated. Migration: autotask_invoke is REPLACED by autotask_read/autotask_write/autotask_delete — update harness config. The argument set is CLOSED at the top level: an unknown argument is refused before any request, with a typed error naming the key and the valid keys.",
105
105
  "input": {
106
106
  "operation": {
107
107
  "type": "string",
@@ -11631,6 +11631,26 @@
11631
11631
  "reachReason": null,
11632
11632
  "boundedAlternative": null
11633
11633
  },
11634
+ {
11635
+ "operation": "time_off_requests.create",
11636
+ "core": false,
11637
+ "tool": "autotask_timeOffRequest_create",
11638
+ "purpose": "Submit a resource time-off request.",
11639
+ "preferredWhen": "Submit a new leave request.",
11640
+ "backingOperation": "time_off_requests.create",
11641
+ "effect": "write",
11642
+ "dryRunFirst": true,
11643
+ "confirm": false,
11644
+ "requiredArgs": [
11645
+ "parentId",
11646
+ "data"
11647
+ ],
11648
+ "tier": "extended",
11649
+ "reachable": true,
11650
+ "reach": "dedicated tool",
11651
+ "reachReason": null,
11652
+ "boundedAlternative": null
11653
+ },
11634
11654
  {
11635
11655
  "operation": "time_off_requests.get",
11636
11656
  "core": false,
@@ -11757,6 +11777,27 @@
11757
11777
  "reachReason": null,
11758
11778
  "boundedAlternative": null
11759
11779
  },
11780
+ {
11781
+ "operation": "time_off_requests.update",
11782
+ "core": false,
11783
+ "tool": "autotask_timeOffRequest_update",
11784
+ "purpose": "Cancel a resource time-off request.",
11785
+ "preferredWhen": "Cancel an existing leave request; use approve/reject for leave approval.",
11786
+ "backingOperation": "time_off_requests.update",
11787
+ "effect": "write",
11788
+ "dryRunFirst": true,
11789
+ "confirm": false,
11790
+ "requiredArgs": [
11791
+ "parentId",
11792
+ "id",
11793
+ "data"
11794
+ ],
11795
+ "tier": "extended",
11796
+ "reachable": true,
11797
+ "reach": "dedicated tool",
11798
+ "reachReason": null,
11799
+ "boundedAlternative": null
11800
+ },
11760
11801
  {
11761
11802
  "operation": "user_defined_field_definitions.count",
11762
11803
  "core": false,
@@ -23464,10 +23505,10 @@
23464
23505
  }
23465
23506
  ],
23466
23507
  "counts": {
23467
- "registryOperations": 1276,
23508
+ "registryOperations": 1278,
23468
23509
  "coreOperations": 10,
23469
- "catalogRows": 1276,
23470
- "withTool": 876,
23510
+ "catalogRows": 1278,
23511
+ "withTool": 878,
23471
23512
  "readModeOnly": 400,
23472
23513
  "neverExposed": 0,
23473
23514
  "metaTools": 5
package/README.md CHANGED
@@ -389,7 +389,7 @@ The SDK ships the mechanical substrate, not a server (no MCP imports, no zod):
389
389
  governor place: `src/operations/invoke.ts`).
390
390
 
391
391
  <!-- BEGIN GENERATED:approval-policy -->
392
- **Harness approval policy (recommended).** Require approval on every tool whose MCP annotation is `readOnlyHint !== true` — today exactly **258 tools**: the 256 dedicated write/delete tools (198 `effect=write` + 58 `effect=destructive`, every one of them has a dedicated tool) + `autotask_write` + `autotask_delete`. The remaining **623 tools** (the 610 dedicated read tools + the 10 core read tools + `autotask_read` + `autotask_catalog` + `autotask_describe`) all carry `readOnlyHint: true` and are safe ungated: every op they can route is `effect=read` (zero mutating requests). Refined class for the highest-risk ops: the **59 tools with `destructiveHint: true`** (58 dedicated delete tools + `autotask_delete`) additionally require `confirm === <operation key>` even inside `autotask_delete`. The approval-gated writes (`configuration_items.moveConfigurationItem`, `contacts.moveToCompany`) require the same confirm inside `autotask_write`. Migration: `autotask_invoke` is REPLACED by `autotask_read`/`autotask_write`/`autotask_delete` — update harness config and remove any `autotask_invoke` entry. The rule is derivable from the registry `effect` column and the mode tools’ fixed annotations; it never needs a hand-maintained name list.
392
+ **Harness approval policy (recommended).** Require approval on every tool whose MCP annotation is `readOnlyHint !== true` — today exactly **260 tools**: the 258 dedicated write/delete tools (200 `effect=write` + 58 `effect=destructive`, every one of them has a dedicated tool) + `autotask_write` + `autotask_delete`. The remaining **623 tools** (the 610 dedicated read tools + the 10 core read tools + `autotask_read` + `autotask_catalog` + `autotask_describe`) all carry `readOnlyHint: true` and are safe ungated: every op they can route is `effect=read` (zero mutating requests). Refined class for the highest-risk ops: the **59 tools with `destructiveHint: true`** (58 dedicated delete tools + `autotask_delete`) additionally require `confirm === <operation key>` even inside `autotask_delete`. The approval-gated writes (`configuration_items.moveConfigurationItem`, `contacts.moveToCompany`) require the same confirm inside `autotask_write`. Migration: `autotask_invoke` is REPLACED by `autotask_read`/`autotask_write`/`autotask_delete` — update harness config and remove any `autotask_invoke` entry. The rule is derivable from the registry `effect` column and the mode tools’ fixed annotations; it never needs a hand-maintained name list.
393
393
  <!-- END GENERATED:approval-policy -->
394
394
  **Provider tool-search interop.** Hosts with provider-native tool search
395
395
  (OpenAI `type: "tool_search"` / `defer_loading`; Anthropic's tool search
package/capabilities.json CHANGED
@@ -1,9 +1,9 @@
1
1
  {
2
- "generatedAt": "2026-11-18T13:26:09.242Z",
2
+ "generatedAt": "2026-11-18T23:44:46.548Z",
3
3
  "groups": {
4
4
  "B": {
5
- "planHash": "79f3968f072705fbc7b479dba6863a27bde47deee7b85885eda8d019302f9c25",
6
- "builtAt": "2026-11-18T13:26:09.223Z",
5
+ "planHash": "3dfaa99bd81e843635bafd242e5229270f259de68c6a32d483a6640402f3b187",
6
+ "builtAt": "2026-11-18T23:44:46.527Z",
7
7
  "records": [
8
8
  {
9
9
  "id": "appointments.count",
@@ -41177,6 +41177,71 @@
41177
41177
  "compact": null,
41178
41178
  "status": "tested"
41179
41179
  },
41180
+ {
41181
+ "id": "time_off_requests.create",
41182
+ "resource": "time_off_requests",
41183
+ "udfCapable": false,
41184
+ "operation": "create",
41185
+ "kind": "primitive",
41186
+ "endpoint": "POST /V1.0/Resources/{parentId}/TimeOffRequests",
41187
+ "effect": "write",
41188
+ "flags": [],
41189
+ "dryRun": true,
41190
+ "envelope": "OperationResultModel",
41191
+ "inputSchema": {
41192
+ "parentId": {
41193
+ "type": "string | number",
41194
+ "required": true,
41195
+ "description": "The parent record id (parent-scoped collection; number, or a canonical integer string)."
41196
+ },
41197
+ "data": {
41198
+ "type": "object",
41199
+ "required": true,
41200
+ "description": "The record payload (vendor model fields)."
41201
+ }
41202
+ },
41203
+ "inputSchemaStrict": true,
41204
+ "outputSchema": {
41205
+ "type": "OperationResultModel",
41206
+ "drops": []
41207
+ },
41208
+ "examples": [
41209
+ "const fields = await client.timeOffRequests.getFieldInfo();\nconst activeValue = (name, label) => {\n const rows = fields.filter(field => field.name === name && field.isPickList === true);\n if (rows.length !== 1 || !Array.isArray(rows[0].picklistValues)) throw new Error(`Unavailable ${name} picklist metadata`);\n const values = rows[0].picklistValues;\n const valid = value => typeof value.value === 'string' && /^-?\\d+$/.test(value.value) && Number.isSafeInteger(Number(value.value));\n const choices = label ? values.filter(value => value.label?.trim().toLowerCase() === label.toLowerCase()) : values.filter(value => valid(value) && value.isActive === true);\n const choice = choices[0];\n if (!choice || (label && choices.length !== 1) || !valid(choice) || choice.isActive !== true || values.filter(value => valid(value) && Number(value.value) === Number(choice.value)).length !== 1) throw new Error(`No unambiguous active ${label ?? name} choice is available`);\n return Number(choice.value);\n};\nconst status = activeValue('status', 'Submitted');\nconst timeOffRequestType = activeValue('timeOffRequestType');\nawait client.timeOffRequests.create(7, { requestDate: '2026-01-01', hours: 1.25, status, timeOffRequestType }, { dryRun: true });"
41210
+ ],
41211
+ "permissions": "unknown",
41212
+ "pagination": {
41213
+ "mode": "none"
41214
+ },
41215
+ "resolution": null,
41216
+ "retry": {
41217
+ "preset": "retry-c5657094"
41218
+ },
41219
+ "errors": {
41220
+ "set": 1
41221
+ },
41222
+ "metadata": {
41223
+ "purpose": "Submit a resource time-off request.",
41224
+ "usage": "Parent-scoped: parentId is the resource id; the SDK fills numeric resourceID and rejects a mismatched supplied value. Create requires hours (-24 to 24 decimal), requestDate for a single day, timeOffRequestType and status. Fresh SDK metadata must uniquely expose active Submitted for status and the selected request type; withheld, inactive or ambiguous metadata refuses before mutation, even after a warm metadata read. Request types depend on the UI Display Code for > Time Off Requests setting. Approval/audit/attribution fields, reason, start/end times and UDF writes are not create inputs; start/end times are ignored by the vendor. Resource ownership does not establish company scope. API-user/proxy-time-entry settings govern visibility and permissions. A parent beyond the safe numeric resourceID body representation is refused as an SDK create-body limit, not a vendor record-id maximum.",
41225
+ "preferredWhen": "Submit a new leave request.",
41226
+ "related": [
41227
+ "time_off_requests.get",
41228
+ "time_off_requests.getFieldInfo",
41229
+ "time_off_requests.approve",
41230
+ "time_off_requests.reject"
41231
+ ],
41232
+ "deleteBoundary": {
41233
+ "resource": "time_off_requests",
41234
+ "note": "The vendor defines no DELETE for time-off requests; cancel through time_off_requests.update using the Canceled status from exposed field metadata. Cancellation is leave management, not timesheet unposting.",
41235
+ "proof": "spec-derived"
41236
+ },
41237
+ "untrustedFields": [
41238
+ "reason",
41239
+ "rejectReason"
41240
+ ]
41241
+ },
41242
+ "compact": null,
41243
+ "status": "tested"
41244
+ },
41180
41245
  {
41181
41246
  "id": "time_off_requests.get",
41182
41247
  "resource": "time_off_requests",
@@ -41620,6 +41685,73 @@
41620
41685
  "compact": "TimeOffRequestSummary",
41621
41686
  "status": "tested"
41622
41687
  },
41688
+ {
41689
+ "id": "time_off_requests.update",
41690
+ "resource": "time_off_requests",
41691
+ "udfCapable": false,
41692
+ "operation": "update",
41693
+ "kind": "primitive",
41694
+ "endpoint": "PATCH /V1.0/Resources/{parentId}/TimeOffRequests",
41695
+ "effect": "write",
41696
+ "flags": [
41697
+ "idempotent"
41698
+ ],
41699
+ "dryRun": true,
41700
+ "envelope": "OperationResultModel",
41701
+ "inputSchema": {
41702
+ "parentId": {
41703
+ "type": "string | number",
41704
+ "required": true,
41705
+ "description": "The parent record id (parent-scoped collection; number, or a canonical integer string)."
41706
+ },
41707
+ "id": {
41708
+ "type": "string | number",
41709
+ "required": true,
41710
+ "description": "The record id (number, or a canonical integer string — ids beyond 2^53 are supported via the string form)."
41711
+ },
41712
+ "data": {
41713
+ "type": "object",
41714
+ "required": true,
41715
+ "description": "The record payload (vendor model fields)."
41716
+ }
41717
+ },
41718
+ "inputSchemaStrict": true,
41719
+ "outputSchema": {
41720
+ "type": "OperationResultModel",
41721
+ "drops": []
41722
+ },
41723
+ "examples": [
41724
+ "const fields = await client.timeOffRequests.getFieldInfo();\nconst activeValue = (name, label) => {\n const rows = fields.filter(field => field.name === name && field.isPickList === true);\n if (rows.length !== 1 || !Array.isArray(rows[0].picklistValues)) throw new Error(`Unavailable ${name} picklist metadata`);\n const values = rows[0].picklistValues;\n const valid = value => typeof value.value === 'string' && /^-?\\d+$/.test(value.value) && Number.isSafeInteger(Number(value.value));\n const choices = label ? values.filter(value => value.label?.trim().toLowerCase() === label.toLowerCase()) : values.filter(value => valid(value) && value.isActive === true);\n const choice = choices[0];\n if (!choice || (label && choices.length !== 1) || !valid(choice) || choice.isActive !== true || values.filter(value => valid(value) && Number(value.value) === Number(choice.value)).length !== 1) throw new Error(`No unambiguous active ${label ?? name} choice is available`);\n return Number(choice.value);\n};\nconst status = activeValue('status', 'Canceled');\nawait client.timeOffRequests.update(7, 3, { status }, { dryRun: true });"
41725
+ ],
41726
+ "permissions": "unknown",
41727
+ "pagination": {
41728
+ "mode": "none"
41729
+ },
41730
+ "resolution": null,
41731
+ "retry": {
41732
+ "preset": "retry-c5657094"
41733
+ },
41734
+ "errors": {
41735
+ "set": 1
41736
+ },
41737
+ "metadata": {
41738
+ "purpose": "Cancel a resource time-off request.",
41739
+ "usage": "Parent-scoped: parentId is the resource id, followed by request id and data containing status only. Fresh SDK metadata must uniquely expose the supplied numeric status as active Canceled, including after a warmed field cache. No other fields or transitions are admitted in preview or apply. Collection PATCH sends status and the path request id only, with no replacing PUT fallback. Optional lastModifiedDate checks fresh lastModifiedDateTime. Resource ownership does not establish company scope; visibility depends on API-user and proxy-time-entry settings. Cancellation is leave management, not timesheet lifecycle or unposting.",
41740
+ "preferredWhen": "Cancel an existing leave request; use approve/reject for leave approval.",
41741
+ "related": [
41742
+ "time_off_requests.get",
41743
+ "time_off_requests.getFieldInfo",
41744
+ "time_off_requests.approve",
41745
+ "time_off_requests.reject"
41746
+ ],
41747
+ "untrustedFields": [
41748
+ "reason",
41749
+ "rejectReason"
41750
+ ]
41751
+ },
41752
+ "compact": null,
41753
+ "status": "tested"
41754
+ },
41623
41755
  {
41624
41756
  "id": "user_defined_field_definitions.count",
41625
41757
  "resource": "user_defined_field_definitions",
@@ -42786,8 +42918,8 @@
42786
42918
  ]
42787
42919
  },
42788
42920
  "A": {
42789
- "planHash": "79f3968f072705fbc7b479dba6863a27bde47deee7b85885eda8d019302f9c25",
42790
- "builtAt": "2026-11-18T13:26:09.224Z",
42921
+ "planHash": "3dfaa99bd81e843635bafd242e5229270f259de68c6a32d483a6640402f3b187",
42922
+ "builtAt": "2026-11-18T23:44:46.527Z",
42791
42923
  "records": [
42792
42924
  {
42793
42925
  "id": "attachment_info.count",
@@ -84109,8 +84241,8 @@
84109
84241
  ]
84110
84242
  },
84111
84243
  "operations": {
84112
- "planHash": "79f3968f072705fbc7b479dba6863a27bde47deee7b85885eda8d019302f9c25",
84113
- "builtAt": "2026-11-18T13:26:09.224Z",
84244
+ "planHash": "3dfaa99bd81e843635bafd242e5229270f259de68c6a32d483a6640402f3b187",
84245
+ "builtAt": "2026-11-18T23:44:46.527Z",
84114
84246
  "records": [
84115
84247
  {
84116
84248
  "id": "operations.aggregate",
@@ -348,8 +348,8 @@ const CAPABILITY_DATA = {
348
348
  ],
349
349
  "groups": {
350
350
  "B": {
351
- "planHash": "79f3968f072705fbc7b479dba6863a27bde47deee7b85885eda8d019302f9c25",
352
- "builtAt": "2026-11-18T13:26:09.223Z",
351
+ "planHash": "3dfaa99bd81e843635bafd242e5229270f259de68c6a32d483a6640402f3b187",
352
+ "builtAt": "2026-11-18T23:44:46.527Z",
353
353
  "records": [
354
354
  {
355
355
  "id": "appointments.count",
@@ -41523,6 +41523,71 @@ const CAPABILITY_DATA = {
41523
41523
  "compact": null,
41524
41524
  "status": "tested"
41525
41525
  },
41526
+ {
41527
+ "id": "time_off_requests.create",
41528
+ "resource": "time_off_requests",
41529
+ "udfCapable": false,
41530
+ "operation": "create",
41531
+ "kind": "primitive",
41532
+ "endpoint": "POST /V1.0/Resources/{parentId}/TimeOffRequests",
41533
+ "effect": "write",
41534
+ "flags": [],
41535
+ "dryRun": true,
41536
+ "envelope": "OperationResultModel",
41537
+ "inputSchema": {
41538
+ "parentId": {
41539
+ "type": "string | number",
41540
+ "required": true,
41541
+ "description": "The parent record id (parent-scoped collection; number, or a canonical integer string)."
41542
+ },
41543
+ "data": {
41544
+ "type": "object",
41545
+ "required": true,
41546
+ "description": "The record payload (vendor model fields)."
41547
+ }
41548
+ },
41549
+ "inputSchemaStrict": true,
41550
+ "outputSchema": {
41551
+ "type": "OperationResultModel",
41552
+ "drops": []
41553
+ },
41554
+ "examples": [
41555
+ "const fields = await client.timeOffRequests.getFieldInfo();\nconst activeValue = (name, label) => {\n const rows = fields.filter(field => field.name === name && field.isPickList === true);\n if (rows.length !== 1 || !Array.isArray(rows[0].picklistValues)) throw new Error(`Unavailable ${name} picklist metadata`);\n const values = rows[0].picklistValues;\n const valid = value => typeof value.value === 'string' && /^-?\\d+$/.test(value.value) && Number.isSafeInteger(Number(value.value));\n const choices = label ? values.filter(value => value.label?.trim().toLowerCase() === label.toLowerCase()) : values.filter(value => valid(value) && value.isActive === true);\n const choice = choices[0];\n if (!choice || (label && choices.length !== 1) || !valid(choice) || choice.isActive !== true || values.filter(value => valid(value) && Number(value.value) === Number(choice.value)).length !== 1) throw new Error(`No unambiguous active ${label ?? name} choice is available`);\n return Number(choice.value);\n};\nconst status = activeValue('status', 'Submitted');\nconst timeOffRequestType = activeValue('timeOffRequestType');\nawait client.timeOffRequests.create(7, { requestDate: '2026-01-01', hours: 1.25, status, timeOffRequestType }, { dryRun: true });"
41556
+ ],
41557
+ "permissions": "unknown",
41558
+ "pagination": {
41559
+ "mode": "none"
41560
+ },
41561
+ "resolution": null,
41562
+ "retry": {
41563
+ "preset": "retry-c5657094"
41564
+ },
41565
+ "errors": {
41566
+ "set": 1
41567
+ },
41568
+ "metadata": {
41569
+ "purpose": "Submit a resource time-off request.",
41570
+ "usage": "Parent-scoped: parentId is the resource id; the SDK fills numeric resourceID and rejects a mismatched supplied value. Create requires hours (-24 to 24 decimal), requestDate for a single day, timeOffRequestType and status. Fresh SDK metadata must uniquely expose active Submitted for status and the selected request type; withheld, inactive or ambiguous metadata refuses before mutation, even after a warm metadata read. Request types depend on the UI Display Code for > Time Off Requests setting. Approval/audit/attribution fields, reason, start/end times and UDF writes are not create inputs; start/end times are ignored by the vendor. Resource ownership does not establish company scope. API-user/proxy-time-entry settings govern visibility and permissions. A parent beyond the safe numeric resourceID body representation is refused as an SDK create-body limit, not a vendor record-id maximum.",
41571
+ "preferredWhen": "Submit a new leave request.",
41572
+ "related": [
41573
+ "time_off_requests.get",
41574
+ "time_off_requests.getFieldInfo",
41575
+ "time_off_requests.approve",
41576
+ "time_off_requests.reject"
41577
+ ],
41578
+ "deleteBoundary": {
41579
+ "resource": "time_off_requests",
41580
+ "note": "The vendor defines no DELETE for time-off requests; cancel through time_off_requests.update using the Canceled status from exposed field metadata. Cancellation is leave management, not timesheet unposting.",
41581
+ "proof": "spec-derived"
41582
+ },
41583
+ "untrustedFields": [
41584
+ "reason",
41585
+ "rejectReason"
41586
+ ]
41587
+ },
41588
+ "compact": null,
41589
+ "status": "tested"
41590
+ },
41526
41591
  {
41527
41592
  "id": "time_off_requests.get",
41528
41593
  "resource": "time_off_requests",
@@ -41966,6 +42031,73 @@ const CAPABILITY_DATA = {
41966
42031
  "compact": "TimeOffRequestSummary",
41967
42032
  "status": "tested"
41968
42033
  },
42034
+ {
42035
+ "id": "time_off_requests.update",
42036
+ "resource": "time_off_requests",
42037
+ "udfCapable": false,
42038
+ "operation": "update",
42039
+ "kind": "primitive",
42040
+ "endpoint": "PATCH /V1.0/Resources/{parentId}/TimeOffRequests",
42041
+ "effect": "write",
42042
+ "flags": [
42043
+ "idempotent"
42044
+ ],
42045
+ "dryRun": true,
42046
+ "envelope": "OperationResultModel",
42047
+ "inputSchema": {
42048
+ "parentId": {
42049
+ "type": "string | number",
42050
+ "required": true,
42051
+ "description": "The parent record id (parent-scoped collection; number, or a canonical integer string)."
42052
+ },
42053
+ "id": {
42054
+ "type": "string | number",
42055
+ "required": true,
42056
+ "description": "The record id (number, or a canonical integer string — ids beyond 2^53 are supported via the string form)."
42057
+ },
42058
+ "data": {
42059
+ "type": "object",
42060
+ "required": true,
42061
+ "description": "The record payload (vendor model fields)."
42062
+ }
42063
+ },
42064
+ "inputSchemaStrict": true,
42065
+ "outputSchema": {
42066
+ "type": "OperationResultModel",
42067
+ "drops": []
42068
+ },
42069
+ "examples": [
42070
+ "const fields = await client.timeOffRequests.getFieldInfo();\nconst activeValue = (name, label) => {\n const rows = fields.filter(field => field.name === name && field.isPickList === true);\n if (rows.length !== 1 || !Array.isArray(rows[0].picklistValues)) throw new Error(`Unavailable ${name} picklist metadata`);\n const values = rows[0].picklistValues;\n const valid = value => typeof value.value === 'string' && /^-?\\d+$/.test(value.value) && Number.isSafeInteger(Number(value.value));\n const choices = label ? values.filter(value => value.label?.trim().toLowerCase() === label.toLowerCase()) : values.filter(value => valid(value) && value.isActive === true);\n const choice = choices[0];\n if (!choice || (label && choices.length !== 1) || !valid(choice) || choice.isActive !== true || values.filter(value => valid(value) && Number(value.value) === Number(choice.value)).length !== 1) throw new Error(`No unambiguous active ${label ?? name} choice is available`);\n return Number(choice.value);\n};\nconst status = activeValue('status', 'Canceled');\nawait client.timeOffRequests.update(7, 3, { status }, { dryRun: true });"
42071
+ ],
42072
+ "permissions": "unknown",
42073
+ "pagination": {
42074
+ "mode": "none"
42075
+ },
42076
+ "resolution": null,
42077
+ "retry": {
42078
+ "preset": "retry-c5657094"
42079
+ },
42080
+ "errors": {
42081
+ "set": 1
42082
+ },
42083
+ "metadata": {
42084
+ "purpose": "Cancel a resource time-off request.",
42085
+ "usage": "Parent-scoped: parentId is the resource id, followed by request id and data containing status only. Fresh SDK metadata must uniquely expose the supplied numeric status as active Canceled, including after a warmed field cache. No other fields or transitions are admitted in preview or apply. Collection PATCH sends status and the path request id only, with no replacing PUT fallback. Optional lastModifiedDate checks fresh lastModifiedDateTime. Resource ownership does not establish company scope; visibility depends on API-user and proxy-time-entry settings. Cancellation is leave management, not timesheet lifecycle or unposting.",
42086
+ "preferredWhen": "Cancel an existing leave request; use approve/reject for leave approval.",
42087
+ "related": [
42088
+ "time_off_requests.get",
42089
+ "time_off_requests.getFieldInfo",
42090
+ "time_off_requests.approve",
42091
+ "time_off_requests.reject"
42092
+ ],
42093
+ "untrustedFields": [
42094
+ "reason",
42095
+ "rejectReason"
42096
+ ]
42097
+ },
42098
+ "compact": null,
42099
+ "status": "tested"
42100
+ },
41969
42101
  {
41970
42102
  "id": "user_defined_field_definitions.count",
41971
42103
  "resource": "user_defined_field_definitions",
@@ -43132,8 +43264,8 @@ const CAPABILITY_DATA = {
43132
43264
  ]
43133
43265
  },
43134
43266
  "A": {
43135
- "planHash": "79f3968f072705fbc7b479dba6863a27bde47deee7b85885eda8d019302f9c25",
43136
- "builtAt": "2026-11-18T13:26:09.224Z",
43267
+ "planHash": "3dfaa99bd81e843635bafd242e5229270f259de68c6a32d483a6640402f3b187",
43268
+ "builtAt": "2026-11-18T23:44:46.527Z",
43137
43269
  "records": [
43138
43270
  {
43139
43271
  "id": "attachment_info.count",
@@ -84455,8 +84587,8 @@ const CAPABILITY_DATA = {
84455
84587
  ]
84456
84588
  },
84457
84589
  "operations": {
84458
- "planHash": "79f3968f072705fbc7b479dba6863a27bde47deee7b85885eda8d019302f9c25",
84459
- "builtAt": "2026-11-18T13:26:09.224Z",
84590
+ "planHash": "3dfaa99bd81e843635bafd242e5229270f259de68c6a32d483a6640402f3b187",
84591
+ "builtAt": "2026-11-18T23:44:46.527Z",
84460
84592
  "records": [
84461
84593
  {
84462
84594
  "id": "operations.aggregate",
@@ -1,18 +1,18 @@
1
1
  'use strict';
2
2
 
3
- var chunkSPME362B_cjs = require('./chunk-SPME362B.cjs');
3
+ var chunkVHNWLON6_cjs = require('./chunk-VHNWLON6.cjs');
4
4
 
5
5
 
6
6
 
7
7
  Object.defineProperty(exports, "CAPABILITY_PLAN_HASHES", {
8
8
  enumerable: true,
9
- get: function () { return chunkSPME362B_cjs.CAPABILITY_PLAN_HASHES; }
9
+ get: function () { return chunkVHNWLON6_cjs.CAPABILITY_PLAN_HASHES; }
10
10
  });
11
11
  Object.defineProperty(exports, "loadCapabilities", {
12
12
  enumerable: true,
13
- get: function () { return chunkSPME362B_cjs.loadCapabilities; }
13
+ get: function () { return chunkVHNWLON6_cjs.loadCapabilities; }
14
14
  });
15
15
  Object.defineProperty(exports, "loadCapabilityRecords", {
16
16
  enumerable: true,
17
- get: function () { return chunkSPME362B_cjs.loadCapabilityRecords; }
17
+ get: function () { return chunkVHNWLON6_cjs.loadCapabilityRecords; }
18
18
  });
@@ -1 +1 @@
1
- export { CAPABILITY_PLAN_HASHES, loadCapabilities, loadCapabilityRecords } from './chunk-K33DPJFK.js';
1
+ export { CAPABILITY_PLAN_HASHES, loadCapabilities, loadCapabilityRecords } from './chunk-PNMEXWYR.js';
@@ -1,7 +1,7 @@
1
1
  'use strict';
2
2
 
3
- var chunkV5UGW6KZ_cjs = require('./chunk-V5UGW6KZ.cjs');
4
- var chunkKVC5DZAP_cjs = require('./chunk-KVC5DZAP.cjs');
3
+ var chunkSTUQU7AX_cjs = require('./chunk-STUQU7AX.cjs');
4
+ var chunkCWSXFVF2_cjs = require('./chunk-CWSXFVF2.cjs');
5
5
 
6
6
  // src/client.ts
7
7
  var AutotaskClient = class {
@@ -158,34 +158,34 @@ var AutotaskClient = class {
158
158
  * anything is wired. Construction issues NO request.
159
159
  */
160
160
  constructor(options) {
161
- this.config = chunkKVC5DZAP_cjs.resolveConfig(options);
162
- this.http = new chunkKVC5DZAP_cjs.HttpClient(this.config);
161
+ this.config = chunkCWSXFVF2_cjs.resolveConfig(options);
162
+ this.http = new chunkCWSXFVF2_cjs.HttpClient(this.config);
163
163
  this.http.client = this;
164
- for (const entry of chunkKVC5DZAP_cjs.SIMPLE_RESOURCES) {
165
- this[entry.accessor] = new chunkKVC5DZAP_cjs.GenericResource(this.http, entry, this.config.pageSize);
164
+ for (const entry of chunkCWSXFVF2_cjs.SIMPLE_RESOURCES) {
165
+ this[entry.accessor] = new chunkCWSXFVF2_cjs.GenericResource(this.http, entry, this.config.pageSize);
166
166
  }
167
- this.companies = new chunkKVC5DZAP_cjs.CompaniesResource(this.http, this.config.pageSize);
168
- this.configurationItems = new chunkV5UGW6KZ_cjs.ConfigurationItemsResource(this.http, this.config.pageSize);
169
- this.contacts = new chunkV5UGW6KZ_cjs.ContactsResource(this.http, this.config.pageSize);
170
- this.contracts = new chunkKVC5DZAP_cjs.ContractsResource(this.http, this.config.pageSize);
171
- this.inventoryProducts = new chunkV5UGW6KZ_cjs.InventoryProductsResource(this.http, this.config.pageSize);
172
- this.invoices = new chunkKVC5DZAP_cjs.InvoicesResource(this.http, this.config.pageSize);
173
- this.quotes = new chunkV5UGW6KZ_cjs.QuotesResource(this.http, this.config.pageSize);
174
- this.resourceTimeOffAdditional = new chunkV5UGW6KZ_cjs.ResourceTimeOffAdditionalResource(this.http, this.config.pageSize);
175
- this.resourceTimeOffBalances = new chunkV5UGW6KZ_cjs.ResourceTimeOffBalancesResource(this.http, this.config.pageSize);
176
- this.resources = new chunkV5UGW6KZ_cjs.ResourcesResource(this.http, this.config, this.config.pageSize);
177
- this.serviceCalls = new chunkV5UGW6KZ_cjs.ServiceCallsResource(this.http, this.config.pageSize);
178
- this.ticketCharges = new chunkV5UGW6KZ_cjs.TicketChargesResource(this.http, this.config.pageSize);
179
- this.tickets = new chunkV5UGW6KZ_cjs.TicketsResource(this.http, this.config.pageSize);
180
- this.timeEntries = new chunkKVC5DZAP_cjs.TimeEntriesResource(this.http, this.config.pageSize);
181
- this.timeOffRequests = new chunkV5UGW6KZ_cjs.TimeOffRequestsResource(this.http, this.config.pageSize);
182
- this.authenticateResource = new chunkV5UGW6KZ_cjs.AuthenticateResource(this.http);
183
- this.entityInformation = new chunkV5UGW6KZ_cjs.EntityInformationResource(this.http);
184
- this.modules = new chunkV5UGW6KZ_cjs.ModulesResource(this.http);
185
- this.thresholdInformation = new chunkV5UGW6KZ_cjs.ThresholdInformationResource(this.http);
186
- this.version = new chunkV5UGW6KZ_cjs.VersionResource(this.http);
187
- this.versionInformation = new chunkV5UGW6KZ_cjs.VersionInformationResource(this.http);
188
- this.zoneInformation = new chunkV5UGW6KZ_cjs.ZoneInformationResource(this.http);
167
+ this.companies = new chunkCWSXFVF2_cjs.CompaniesResource(this.http, this.config.pageSize);
168
+ this.configurationItems = new chunkSTUQU7AX_cjs.ConfigurationItemsResource(this.http, this.config.pageSize);
169
+ this.contacts = new chunkSTUQU7AX_cjs.ContactsResource(this.http, this.config.pageSize);
170
+ this.contracts = new chunkCWSXFVF2_cjs.ContractsResource(this.http, this.config.pageSize);
171
+ this.inventoryProducts = new chunkSTUQU7AX_cjs.InventoryProductsResource(this.http, this.config.pageSize);
172
+ this.invoices = new chunkCWSXFVF2_cjs.InvoicesResource(this.http, this.config.pageSize);
173
+ this.quotes = new chunkSTUQU7AX_cjs.QuotesResource(this.http, this.config.pageSize);
174
+ this.resourceTimeOffAdditional = new chunkSTUQU7AX_cjs.ResourceTimeOffAdditionalResource(this.http, this.config.pageSize);
175
+ this.resourceTimeOffBalances = new chunkSTUQU7AX_cjs.ResourceTimeOffBalancesResource(this.http, this.config.pageSize);
176
+ this.resources = new chunkSTUQU7AX_cjs.ResourcesResource(this.http, this.config, this.config.pageSize);
177
+ this.serviceCalls = new chunkSTUQU7AX_cjs.ServiceCallsResource(this.http, this.config.pageSize);
178
+ this.ticketCharges = new chunkSTUQU7AX_cjs.TicketChargesResource(this.http, this.config.pageSize);
179
+ this.tickets = new chunkSTUQU7AX_cjs.TicketsResource(this.http, this.config.pageSize);
180
+ this.timeEntries = new chunkCWSXFVF2_cjs.TimeEntriesResource(this.http, this.config.pageSize);
181
+ this.timeOffRequests = new chunkSTUQU7AX_cjs.TimeOffRequestsResource(this.http, this.config.pageSize);
182
+ this.authenticateResource = new chunkSTUQU7AX_cjs.AuthenticateResource(this.http);
183
+ this.entityInformation = new chunkSTUQU7AX_cjs.EntityInformationResource(this.http);
184
+ this.modules = new chunkSTUQU7AX_cjs.ModulesResource(this.http);
185
+ this.thresholdInformation = new chunkSTUQU7AX_cjs.ThresholdInformationResource(this.http);
186
+ this.version = new chunkSTUQU7AX_cjs.VersionResource(this.http);
187
+ this.versionInformation = new chunkSTUQU7AX_cjs.VersionInformationResource(this.http);
188
+ this.zoneInformation = new chunkSTUQU7AX_cjs.ZoneInformationResource(this.http);
189
189
  }
190
190
  /**
191
191
  * `GET /V1.0/Authenticate` → `AuthTokenResultModel` (as-is). The SDK does
@@ -219,10 +219,10 @@ var AutotaskClient = class {
219
219
  * parameter on each: `await client.withSignal(signal, () => invoke(client, ...))`.
220
220
  */
221
221
  withSignal(signal, fn) {
222
- return chunkKVC5DZAP_cjs.runWithSignal(signal, fn);
222
+ return chunkCWSXFVF2_cjs.runWithSignal(signal, fn);
223
223
  }
224
224
  async batch(fn, items, opts = {}) {
225
- return chunkKVC5DZAP_cjs.runBounded(fn, items, { ...opts, concurrency: opts.concurrency ?? this.config.maxConcurrent });
225
+ return chunkCWSXFVF2_cjs.runBounded(fn, items, { ...opts, concurrency: opts.concurrency ?? this.config.maxConcurrent });
226
226
  }
227
227
  };
228
228