node-autotask 0.72.0 → 0.74.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 +24 -0
- package/MCP_TOOL_CATALOG.json +216 -9
- package/README.md +1 -1
- package/capabilities.json +664 -7
- package/dist/capabilities-data.js +663 -6
- package/dist/capabilities.cjs +4 -4
- package/dist/capabilities.js +1 -1
- package/dist/{chunk-KVC5DZAP.cjs → chunk-AMB54GOO.cjs} +324 -94
- package/dist/{chunk-SPME362B.cjs → chunk-ASL3BIW2.cjs} +3 -3
- package/dist/{chunk-HJVTA7SI.cjs → chunk-DSQJTGXK.cjs} +31 -30
- package/dist/{chunk-EGG2RGL5.js → chunk-HJKY7LUL.js} +318 -90
- package/dist/{chunk-F2TYZKJS.js → chunk-IFE5FWS7.js} +128 -2
- package/dist/{chunk-K33DPJFK.js → chunk-IWTTCBCS.js} +3 -3
- package/dist/{chunk-A4IRIYZ5.js → chunk-PGSDJS52.js} +3 -2
- package/dist/{chunk-V5UGW6KZ.cjs → chunk-QZY5LAOG.cjs} +303 -177
- package/dist/{index-BXnhBnhN.d.cts → index-CH65Ftmy.d.cts} +39 -21
- package/dist/{index-BXnhBnhN.d.ts → index-CH65Ftmy.d.ts} +39 -21
- package/dist/{index-CqsY5YHt.d.cts → index-CkBDlaSS.d.cts} +166 -4
- package/dist/{index-DxfspQR1.d.ts → index-ColCzIyw.d.ts} +166 -4
- package/dist/index.cjs +84 -84
- package/dist/index.d.cts +3 -5
- package/dist/index.d.ts +3 -5
- package/dist/index.js +5 -5
- package/dist/operations/index.cjs +51 -51
- package/dist/operations/index.d.cts +5 -6
- package/dist/operations/index.d.ts +5 -6
- package/dist/operations/index.js +2 -2
- package/dist/pool.cjs +12 -12
- package/dist/pool.d.cts +1 -1
- package/dist/pool.d.ts +1 -1
- package/dist/pool.js +4 -4
- package/dist/resources/index.cjs +27 -27
- package/dist/resources/index.d.cts +2 -2
- package/dist/resources/index.d.ts +2 -2
- package/dist/resources/index.js +3 -3
- package/dist/types/index.d.cts +1 -1
- package/dist/types/index.d.ts +1 -1
- package/docs/API.md +4 -3
- package/docs/N8N-ADAPTER.md +1 -1
- package/package.json +1 -1
- package/dist/base-CHMATPq0.d.cts +0 -145
- package/dist/base-CHMATPq0.d.ts +0 -145
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [0.74.0] - 2026-11-19
|
|
11
|
+
|
|
12
|
+
### Added
|
|
13
|
+
|
|
14
|
+
- Add TaskPredecessors global query/count/metadata and successor-task-scoped get/create/lagDays-only PATCH/delete. Validate numeric create references, fresh same-project task identities and scoped relationship binding; retain baseline, phase and permission limitations (#465, #464).
|
|
15
|
+
|
|
16
|
+
### Fixed
|
|
17
|
+
|
|
18
|
+
- Preserve validated task-predecessor inputs and the requested dry-run mode across asynchronous checks in task-predecessor and time-off writes (#465).
|
|
19
|
+
|
|
20
|
+
## [0.73.0] - 2026-11-19
|
|
21
|
+
|
|
22
|
+
### Added
|
|
23
|
+
|
|
24
|
+
- 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).
|
|
25
|
+
|
|
26
|
+
### Changed
|
|
27
|
+
|
|
28
|
+
- The exported `TimeOffRequestCreate` and `TimeOffRequestUpdate` input types now describe the restricted submission and cancellation fields (#465).
|
|
29
|
+
|
|
30
|
+
### Fixed
|
|
31
|
+
|
|
32
|
+
- Mark creation as irreversible when the resource declares no DELETE and include the canonical warning when `createIfNotExists` would create a record (#480).
|
|
33
|
+
|
|
10
34
|
## [0.72.0] - 2026-11-19
|
|
11
35
|
|
|
12
36
|
### Added
|
package/MCP_TOOL_CATALOG.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"generatedBy": "scripts/build-tool-catalog.mjs",
|
|
3
|
-
"generatedAt": "2026-11-
|
|
4
|
-
"planHash": "
|
|
3
|
+
"generatedAt": "2026-11-19T01:02:15.945Z",
|
|
4
|
+
"planHash": "cff16b0b9d022a81a1926ffacb0d01cf5a1e924805447744b62865a3cf9d3779",
|
|
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
|
|
54
|
+
"description": "Route an effect=read registry operation by its exact name (never fuzzy, never a tool name): the 403 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 263 today); the 626 readOnlyHint: true tools — including this one — are safe ungated; the 60 destructiveHint: true tools (59 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
|
|
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 263 tools that require approval (readOnlyHint !== true); the 626 readOnlyHint: true tools are safe ungated, and the 60 destructiveHint: true tools (59 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
|
|
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 59), 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 60 destructiveHint: true tools that require approval + confirm; approve every tool with readOnlyHint !== true (exactly 263 today); the 626 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,
|
|
@@ -20683,6 +20724,172 @@
|
|
|
20683
20724
|
"reachReason": null,
|
|
20684
20725
|
"boundedAlternative": null
|
|
20685
20726
|
},
|
|
20727
|
+
{
|
|
20728
|
+
"operation": "task_predecessors.count",
|
|
20729
|
+
"core": false,
|
|
20730
|
+
"tool": "autotask_taskPredecessor_count",
|
|
20731
|
+
"purpose": "Count task predecessor relationships matching a JSON filter.",
|
|
20732
|
+
"preferredWhen": null,
|
|
20733
|
+
"backingOperation": "task_predecessors.count",
|
|
20734
|
+
"effect": "read",
|
|
20735
|
+
"dryRunFirst": false,
|
|
20736
|
+
"confirm": false,
|
|
20737
|
+
"requiredArgs": [],
|
|
20738
|
+
"tier": "extended",
|
|
20739
|
+
"reachable": true,
|
|
20740
|
+
"reach": "dedicated tool",
|
|
20741
|
+
"reachReason": null,
|
|
20742
|
+
"boundedAlternative": null
|
|
20743
|
+
},
|
|
20744
|
+
{
|
|
20745
|
+
"operation": "task_predecessors.create",
|
|
20746
|
+
"core": false,
|
|
20747
|
+
"tool": "autotask_taskPredecessor_create",
|
|
20748
|
+
"purpose": "create task predecessor relationships.",
|
|
20749
|
+
"preferredWhen": null,
|
|
20750
|
+
"backingOperation": "task_predecessors.create",
|
|
20751
|
+
"effect": "write",
|
|
20752
|
+
"dryRunFirst": true,
|
|
20753
|
+
"confirm": false,
|
|
20754
|
+
"requiredArgs": [
|
|
20755
|
+
"parentId",
|
|
20756
|
+
"data"
|
|
20757
|
+
],
|
|
20758
|
+
"tier": "extended",
|
|
20759
|
+
"reachable": true,
|
|
20760
|
+
"reach": "dedicated tool",
|
|
20761
|
+
"reachReason": null,
|
|
20762
|
+
"boundedAlternative": null
|
|
20763
|
+
},
|
|
20764
|
+
{
|
|
20765
|
+
"operation": "task_predecessors.delete",
|
|
20766
|
+
"core": false,
|
|
20767
|
+
"tool": "autotask_taskPredecessor_delete",
|
|
20768
|
+
"purpose": "Delete one task predecessor relationship.",
|
|
20769
|
+
"preferredWhen": null,
|
|
20770
|
+
"backingOperation": "task_predecessors.delete",
|
|
20771
|
+
"effect": "destructive",
|
|
20772
|
+
"dryRunFirst": true,
|
|
20773
|
+
"confirm": true,
|
|
20774
|
+
"requiredArgs": [
|
|
20775
|
+
"parentId",
|
|
20776
|
+
"id"
|
|
20777
|
+
],
|
|
20778
|
+
"tier": "extended",
|
|
20779
|
+
"reachable": true,
|
|
20780
|
+
"reach": "dedicated tool",
|
|
20781
|
+
"reachReason": null,
|
|
20782
|
+
"boundedAlternative": null
|
|
20783
|
+
},
|
|
20784
|
+
{
|
|
20785
|
+
"operation": "task_predecessors.get",
|
|
20786
|
+
"core": false,
|
|
20787
|
+
"tool": "autotask_taskPredecessor_get",
|
|
20788
|
+
"purpose": "Get one task predecessor relationship by successor task ID and relationship ID.",
|
|
20789
|
+
"preferredWhen": "Preferred when the successor task ID and relationship ID are known; use a bounded successorTaskID-filtered query to discover relationships.",
|
|
20790
|
+
"backingOperation": "task_predecessors.get",
|
|
20791
|
+
"effect": "read",
|
|
20792
|
+
"dryRunFirst": false,
|
|
20793
|
+
"confirm": false,
|
|
20794
|
+
"requiredArgs": [
|
|
20795
|
+
"parentId",
|
|
20796
|
+
"id"
|
|
20797
|
+
],
|
|
20798
|
+
"tier": "extended",
|
|
20799
|
+
"reachable": true,
|
|
20800
|
+
"reach": "dedicated tool",
|
|
20801
|
+
"reachReason": null,
|
|
20802
|
+
"boundedAlternative": null
|
|
20803
|
+
},
|
|
20804
|
+
{
|
|
20805
|
+
"operation": "task_predecessors.getEntityInfo",
|
|
20806
|
+
"core": false,
|
|
20807
|
+
"tool": null,
|
|
20808
|
+
"purpose": "Get the TaskPredecessor capability metadata (canCreate/canUpdate/hasUserDefinedFields/...).",
|
|
20809
|
+
"preferredWhen": null,
|
|
20810
|
+
"backingOperation": "task_predecessors.getEntityInfo",
|
|
20811
|
+
"effect": "read",
|
|
20812
|
+
"dryRunFirst": false,
|
|
20813
|
+
"confirm": false,
|
|
20814
|
+
"requiredArgs": [],
|
|
20815
|
+
"tier": "extended",
|
|
20816
|
+
"reachable": true,
|
|
20817
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
20818
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
20819
|
+
"boundedAlternative": null
|
|
20820
|
+
},
|
|
20821
|
+
{
|
|
20822
|
+
"operation": "task_predecessors.getFieldInfo",
|
|
20823
|
+
"core": false,
|
|
20824
|
+
"tool": null,
|
|
20825
|
+
"purpose": "Get the TaskPredecessor field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
|
|
20826
|
+
"preferredWhen": null,
|
|
20827
|
+
"backingOperation": "task_predecessors.getFieldInfo",
|
|
20828
|
+
"effect": "read",
|
|
20829
|
+
"dryRunFirst": false,
|
|
20830
|
+
"confirm": false,
|
|
20831
|
+
"requiredArgs": [],
|
|
20832
|
+
"tier": "extended",
|
|
20833
|
+
"reachable": true,
|
|
20834
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
20835
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
20836
|
+
"boundedAlternative": null
|
|
20837
|
+
},
|
|
20838
|
+
{
|
|
20839
|
+
"operation": "task_predecessors.getUdfInfo",
|
|
20840
|
+
"core": false,
|
|
20841
|
+
"tool": null,
|
|
20842
|
+
"purpose": "Get the TaskPredecessor user-defined-field catalog.",
|
|
20843
|
+
"preferredWhen": null,
|
|
20844
|
+
"backingOperation": "task_predecessors.getUdfInfo",
|
|
20845
|
+
"effect": "read",
|
|
20846
|
+
"dryRunFirst": false,
|
|
20847
|
+
"confirm": false,
|
|
20848
|
+
"requiredArgs": [],
|
|
20849
|
+
"tier": "extended",
|
|
20850
|
+
"reachable": true,
|
|
20851
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
20852
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
20853
|
+
"boundedAlternative": null
|
|
20854
|
+
},
|
|
20855
|
+
{
|
|
20856
|
+
"operation": "task_predecessors.query",
|
|
20857
|
+
"core": false,
|
|
20858
|
+
"tool": "autotask_taskPredecessor_query",
|
|
20859
|
+
"purpose": "Query TaskPredecessor records with a JSON filter.",
|
|
20860
|
+
"preferredWhen": "Default for filtered reads (the bounded query op). queryAll is the unbounded raw walk — only when you need the ENTIRE set and accept a large payload; default to the bounded query op. Prefer an includeFields subset over the full model (field names via operations.fieldCatalog). latest: N is the latest-N rows (id-descending) when the newest rows are the goal (the vendor has no sort — count-anchored, docs/API.md §4). Prefer a hand-listed includeFields for common narrow reads (removed the closed fieldsPreset presets — the v1 billing_join field list for billing_items.query, if you need it, is: companyID, ticketID, projectID, timeEntryID, contractServiceID, contractID, billingCodeID, expenseItemID, itemDate, quantity, rate, extendedPrice, totalAmount, nonBillable); noteChars: N caps the untrusted-class free-text fields of the resource (notes/descriptions/UDF prose) to N chars each with the explicit … [+N chars truncated] marker (opt-in; the raw result when absent).",
|
|
20861
|
+
"backingOperation": "task_predecessors.query",
|
|
20862
|
+
"effect": "read",
|
|
20863
|
+
"dryRunFirst": false,
|
|
20864
|
+
"confirm": false,
|
|
20865
|
+
"requiredArgs": [],
|
|
20866
|
+
"tier": "extended",
|
|
20867
|
+
"reachable": true,
|
|
20868
|
+
"reach": "dedicated tool",
|
|
20869
|
+
"reachReason": null,
|
|
20870
|
+
"boundedAlternative": null
|
|
20871
|
+
},
|
|
20872
|
+
{
|
|
20873
|
+
"operation": "task_predecessors.update",
|
|
20874
|
+
"core": false,
|
|
20875
|
+
"tool": "autotask_taskPredecessor_update",
|
|
20876
|
+
"purpose": "update task predecessor relationships.",
|
|
20877
|
+
"preferredWhen": null,
|
|
20878
|
+
"backingOperation": "task_predecessors.update",
|
|
20879
|
+
"effect": "write",
|
|
20880
|
+
"dryRunFirst": true,
|
|
20881
|
+
"confirm": false,
|
|
20882
|
+
"requiredArgs": [
|
|
20883
|
+
"parentId",
|
|
20884
|
+
"id",
|
|
20885
|
+
"data"
|
|
20886
|
+
],
|
|
20887
|
+
"tier": "extended",
|
|
20888
|
+
"reachable": true,
|
|
20889
|
+
"reach": "dedicated tool",
|
|
20890
|
+
"reachReason": null,
|
|
20891
|
+
"boundedAlternative": null
|
|
20892
|
+
},
|
|
20686
20893
|
{
|
|
20687
20894
|
"operation": "task_secondary_resources.count",
|
|
20688
20895
|
"core": false,
|
|
@@ -23464,11 +23671,11 @@
|
|
|
23464
23671
|
}
|
|
23465
23672
|
],
|
|
23466
23673
|
"counts": {
|
|
23467
|
-
"registryOperations":
|
|
23674
|
+
"registryOperations": 1287,
|
|
23468
23675
|
"coreOperations": 10,
|
|
23469
|
-
"catalogRows":
|
|
23470
|
-
"withTool":
|
|
23471
|
-
"readModeOnly":
|
|
23676
|
+
"catalogRows": 1287,
|
|
23677
|
+
"withTool": 884,
|
|
23678
|
+
"readModeOnly": 403,
|
|
23472
23679
|
"neverExposed": 0,
|
|
23473
23680
|
"metaTools": 5
|
|
23474
23681
|
}
|
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 **
|
|
392
|
+
**Harness approval policy (recommended).** Require approval on every tool whose MCP annotation is `readOnlyHint !== true` — today exactly **263 tools**: the 261 dedicated write/delete tools (202 `effect=write` + 59 `effect=destructive`, every one of them has a dedicated tool) + `autotask_write` + `autotask_delete`. The remaining **626 tools** (the 613 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 **60 tools with `destructiveHint: true`** (59 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
|