node-autotask 0.78.0 → 0.80.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 (39) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/MCP_TOOL_CATALOG.json +265 -9
  3. package/README.md +1 -1
  4. package/capabilities.json +959 -7
  5. package/dist/capabilities-data.js +958 -6
  6. package/dist/capabilities.cjs +4 -4
  7. package/dist/capabilities.js +1 -1
  8. package/dist/{chunk-S7JH6K2Z.cjs → chunk-3VW75XKV.cjs} +310 -11
  9. package/dist/{chunk-3SYNF5QD.js → chunk-GRJE3IUU.js} +2 -2
  10. package/dist/{chunk-XBT332X7.js → chunk-JITS5NKE.js} +305 -6
  11. package/dist/{chunk-U7LVWEO4.cjs → chunk-OVP7IH6K.cjs} +199 -199
  12. package/dist/{chunk-YH5UCY2X.js → chunk-R4MKUN4N.js} +3 -3
  13. package/dist/{chunk-S7BJNQ2X.js → chunk-R6N7S6LC.js} +4 -2
  14. package/dist/{chunk-MVKI2AZX.cjs → chunk-TMJX6NTZ.cjs} +3 -3
  15. package/dist/{chunk-YONRIG6F.cjs → chunk-Z5QCH7JA.cjs} +32 -30
  16. package/dist/{index-BHqdOo_5.d.cts → index-BBc96jwe.d.cts} +91 -1
  17. package/dist/{index-BHqdOo_5.d.ts → index-BBc96jwe.d.ts} +91 -1
  18. package/dist/{index-DfcdtQO0.d.cts → index-CZaFISYn.d.cts} +4 -2
  19. package/dist/{index-ci3TSJrT.d.ts → index-mFUX-x9D.d.ts} +4 -2
  20. package/dist/index.cjs +84 -84
  21. package/dist/index.d.cts +3 -3
  22. package/dist/index.d.ts +3 -3
  23. package/dist/index.js +5 -5
  24. package/dist/operations/index.cjs +51 -51
  25. package/dist/operations/index.d.cts +4 -4
  26. package/dist/operations/index.d.ts +4 -4
  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 +4 -2
  39. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [0.80.0] - 2026-11-19
11
+
12
+ ### Added
13
+
14
+ - Project note file attachments: scoped get/create/delete, global query/count and metadata, documented contact-author input, preview and destructive confirmation, and response-only project/nesting associations. Nested creation, updates and ambiguous deduplication are refused; vendor permissions, contact eligibility and upload limits remain conditional (#467, #464).
15
+
16
+ ## [0.79.0] - 2026-11-19
17
+
18
+ ### Added
19
+
20
+ - Project attachment query/count, metadata, scoped reads, file creates and governed deletes, with project identity and supported-input validation (#467, #464). Project queries may include project-note attachments; exact-parent deduplication, nesting, updates and downloads remain unsupported.
21
+
10
22
  ## [0.78.0] - 2026-11-19
11
23
 
12
24
  ### Added
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "generatedBy": "scripts/build-tool-catalog.mjs",
3
- "generatedAt": "2026-11-19T06:42:18.795Z",
4
- "planHash": "a84c111cf8c415f470fc48dff7ad406f0f67ee9c2a8d75f963e4812e5a2577b2",
3
+ "generatedAt": "2026-11-19T08:49:33.851Z",
4
+ "planHash": "e5a0e5a83df11dd5843b8eb04625b990324834be6bfa47dadb3dc6a0b4d6acbf",
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 411 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 271 today); the 638 readOnlyHint: true tools — including this one — are safe ungated; the 64 destructiveHint: true tools (63 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 415 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 275 today); the 644 readOnlyHint: true tools — including this one — are safe ungated; the 66 destructiveHint: true tools (65 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 271 tools that require approval (readOnlyHint !== true); the 638 readOnlyHint: true tools are safe ungated, and the 64 destructiveHint: true tools (63 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 275 tools that require approval (readOnlyHint !== true); the 644 readOnlyHint: true tools are safe ungated, and the 66 destructiveHint: true tools (65 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 63), 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 64 destructiveHint: true tools that require approval + confirm; approve every tool with readOnlyHint !== true (exactly 271 today); the 638 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 65), 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 66 destructiveHint: true tools that require approval + confirm; approve every tool with readOnlyHint !== true (exactly 275 today); the 644 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",
@@ -19518,6 +19518,134 @@
19518
19518
  "reachReason": null,
19519
19519
  "boundedAlternative": null
19520
19520
  },
19521
+ {
19522
+ "operation": "project_attachments.count",
19523
+ "core": false,
19524
+ "tool": "autotask_projectAttachment_count",
19525
+ "purpose": "Count project attachment records matching a JSON filter. Use projectID for project scope.",
19526
+ "preferredWhen": null,
19527
+ "backingOperation": "project_attachments.count",
19528
+ "effect": "read",
19529
+ "dryRunFirst": false,
19530
+ "confirm": false,
19531
+ "requiredArgs": [],
19532
+ "tier": "extended",
19533
+ "reachable": true,
19534
+ "reach": "dedicated tool",
19535
+ "reachReason": null,
19536
+ "boundedAlternative": null
19537
+ },
19538
+ {
19539
+ "operation": "project_attachments.create",
19540
+ "core": false,
19541
+ "tool": "autotask_projectAttachment_create",
19542
+ "purpose": "Create a file attachment under a project.",
19543
+ "preferredWhen": "Add a new attachment; existing attachments cannot be updated. Replace through separately governed delete and create actions.",
19544
+ "backingOperation": "project_attachments.create",
19545
+ "effect": "write",
19546
+ "dryRunFirst": true,
19547
+ "confirm": false,
19548
+ "requiredArgs": [
19549
+ "parentId",
19550
+ "data"
19551
+ ],
19552
+ "tier": "extended",
19553
+ "reachable": true,
19554
+ "reach": "dedicated tool",
19555
+ "reachReason": null,
19556
+ "boundedAlternative": null
19557
+ },
19558
+ {
19559
+ "operation": "project_attachments.delete",
19560
+ "core": false,
19561
+ "tool": "autotask_projectAttachment_delete",
19562
+ "purpose": "Delete an attachment under a project.",
19563
+ "preferredWhen": null,
19564
+ "backingOperation": "project_attachments.delete",
19565
+ "effect": "destructive",
19566
+ "dryRunFirst": true,
19567
+ "confirm": true,
19568
+ "requiredArgs": [
19569
+ "parentId",
19570
+ "id"
19571
+ ],
19572
+ "tier": "extended",
19573
+ "reachable": true,
19574
+ "reach": "dedicated tool",
19575
+ "reachReason": null,
19576
+ "boundedAlternative": null
19577
+ },
19578
+ {
19579
+ "operation": "project_attachments.get",
19580
+ "core": false,
19581
+ "tool": "autotask_projectAttachment_get",
19582
+ "purpose": "Get one ProjectAttachment by id.",
19583
+ "preferredWhen": "Use a known project id and attachment id; discover records with a global projectID-filtered query, which can include child-note attachments.",
19584
+ "backingOperation": "project_attachments.get",
19585
+ "effect": "read",
19586
+ "dryRunFirst": false,
19587
+ "confirm": false,
19588
+ "requiredArgs": [
19589
+ "parentId",
19590
+ "id"
19591
+ ],
19592
+ "tier": "extended",
19593
+ "reachable": true,
19594
+ "reach": "dedicated tool",
19595
+ "reachReason": null,
19596
+ "boundedAlternative": null
19597
+ },
19598
+ {
19599
+ "operation": "project_attachments.getEntityInfo",
19600
+ "core": false,
19601
+ "tool": null,
19602
+ "purpose": "Get the ProjectAttachment capability metadata (canCreate/canUpdate/hasUserDefinedFields/...).",
19603
+ "preferredWhen": null,
19604
+ "backingOperation": "project_attachments.getEntityInfo",
19605
+ "effect": "read",
19606
+ "dryRunFirst": false,
19607
+ "confirm": false,
19608
+ "requiredArgs": [],
19609
+ "tier": "extended",
19610
+ "reachable": true,
19611
+ "reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
19612
+ "reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
19613
+ "boundedAlternative": null
19614
+ },
19615
+ {
19616
+ "operation": "project_attachments.getFieldInfo",
19617
+ "core": false,
19618
+ "tool": null,
19619
+ "purpose": "Get the ProjectAttachment field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
19620
+ "preferredWhen": null,
19621
+ "backingOperation": "project_attachments.getFieldInfo",
19622
+ "effect": "read",
19623
+ "dryRunFirst": false,
19624
+ "confirm": false,
19625
+ "requiredArgs": [],
19626
+ "tier": "extended",
19627
+ "reachable": true,
19628
+ "reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
19629
+ "reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
19630
+ "boundedAlternative": null
19631
+ },
19632
+ {
19633
+ "operation": "project_attachments.query",
19634
+ "core": false,
19635
+ "tool": "autotask_projectAttachment_query",
19636
+ "purpose": "Query ProjectAttachment records with a JSON filter.",
19637
+ "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).",
19638
+ "backingOperation": "project_attachments.query",
19639
+ "effect": "read",
19640
+ "dryRunFirst": false,
19641
+ "confirm": false,
19642
+ "requiredArgs": [],
19643
+ "tier": "extended",
19644
+ "reachable": true,
19645
+ "reach": "dedicated tool",
19646
+ "reachReason": null,
19647
+ "boundedAlternative": null
19648
+ },
19521
19649
  {
19522
19650
  "operation": "project_charges.count",
19523
19651
  "core": false,
@@ -19722,6 +19850,134 @@
19722
19850
  "reachReason": null,
19723
19851
  "boundedAlternative": null
19724
19852
  },
19853
+ {
19854
+ "operation": "project_note_attachments.count",
19855
+ "core": false,
19856
+ "tool": "autotask_projectNoteAttachment_count",
19857
+ "purpose": "Count project note attachment records matching a JSON filter. Use projectNoteID for note scope.",
19858
+ "preferredWhen": null,
19859
+ "backingOperation": "project_note_attachments.count",
19860
+ "effect": "read",
19861
+ "dryRunFirst": false,
19862
+ "confirm": false,
19863
+ "requiredArgs": [],
19864
+ "tier": "extended",
19865
+ "reachable": true,
19866
+ "reach": "dedicated tool",
19867
+ "reachReason": null,
19868
+ "boundedAlternative": null
19869
+ },
19870
+ {
19871
+ "operation": "project_note_attachments.create",
19872
+ "core": false,
19873
+ "tool": "autotask_projectNoteAttachment_create",
19874
+ "purpose": "Create a file attachment under a project note.",
19875
+ "preferredWhen": "Add a new attachment; existing attachments cannot be updated. Replace through separately governed delete and create actions.",
19876
+ "backingOperation": "project_note_attachments.create",
19877
+ "effect": "write",
19878
+ "dryRunFirst": true,
19879
+ "confirm": false,
19880
+ "requiredArgs": [
19881
+ "parentId",
19882
+ "data"
19883
+ ],
19884
+ "tier": "extended",
19885
+ "reachable": true,
19886
+ "reach": "dedicated tool",
19887
+ "reachReason": null,
19888
+ "boundedAlternative": null
19889
+ },
19890
+ {
19891
+ "operation": "project_note_attachments.delete",
19892
+ "core": false,
19893
+ "tool": "autotask_projectNoteAttachment_delete",
19894
+ "purpose": "Delete an attachment under a project note.",
19895
+ "preferredWhen": null,
19896
+ "backingOperation": "project_note_attachments.delete",
19897
+ "effect": "destructive",
19898
+ "dryRunFirst": true,
19899
+ "confirm": true,
19900
+ "requiredArgs": [
19901
+ "parentId",
19902
+ "id"
19903
+ ],
19904
+ "tier": "extended",
19905
+ "reachable": true,
19906
+ "reach": "dedicated tool",
19907
+ "reachReason": null,
19908
+ "boundedAlternative": null
19909
+ },
19910
+ {
19911
+ "operation": "project_note_attachments.get",
19912
+ "core": false,
19913
+ "tool": "autotask_projectNoteAttachment_get",
19914
+ "purpose": "Get one ProjectNoteAttachment by id.",
19915
+ "preferredWhen": "Use a known attachment id; query the scoped collection to discover ids.",
19916
+ "backingOperation": "project_note_attachments.get",
19917
+ "effect": "read",
19918
+ "dryRunFirst": false,
19919
+ "confirm": false,
19920
+ "requiredArgs": [
19921
+ "parentId",
19922
+ "id"
19923
+ ],
19924
+ "tier": "extended",
19925
+ "reachable": true,
19926
+ "reach": "dedicated tool",
19927
+ "reachReason": null,
19928
+ "boundedAlternative": null
19929
+ },
19930
+ {
19931
+ "operation": "project_note_attachments.getEntityInfo",
19932
+ "core": false,
19933
+ "tool": null,
19934
+ "purpose": "Get the ProjectNoteAttachment capability metadata (canCreate/canUpdate/hasUserDefinedFields/...).",
19935
+ "preferredWhen": null,
19936
+ "backingOperation": "project_note_attachments.getEntityInfo",
19937
+ "effect": "read",
19938
+ "dryRunFirst": false,
19939
+ "confirm": false,
19940
+ "requiredArgs": [],
19941
+ "tier": "extended",
19942
+ "reachable": true,
19943
+ "reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
19944
+ "reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
19945
+ "boundedAlternative": null
19946
+ },
19947
+ {
19948
+ "operation": "project_note_attachments.getFieldInfo",
19949
+ "core": false,
19950
+ "tool": null,
19951
+ "purpose": "Get the ProjectNoteAttachment field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
19952
+ "preferredWhen": null,
19953
+ "backingOperation": "project_note_attachments.getFieldInfo",
19954
+ "effect": "read",
19955
+ "dryRunFirst": false,
19956
+ "confirm": false,
19957
+ "requiredArgs": [],
19958
+ "tier": "extended",
19959
+ "reachable": true,
19960
+ "reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
19961
+ "reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
19962
+ "boundedAlternative": null
19963
+ },
19964
+ {
19965
+ "operation": "project_note_attachments.query",
19966
+ "core": false,
19967
+ "tool": "autotask_projectNoteAttachment_query",
19968
+ "purpose": "Query ProjectNoteAttachment records with a JSON filter.",
19969
+ "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).",
19970
+ "backingOperation": "project_note_attachments.query",
19971
+ "effect": "read",
19972
+ "dryRunFirst": false,
19973
+ "confirm": false,
19974
+ "requiredArgs": [],
19975
+ "tier": "extended",
19976
+ "reachable": true,
19977
+ "reach": "dedicated tool",
19978
+ "reachReason": null,
19979
+ "boundedAlternative": null
19980
+ },
19725
19981
  {
19726
19982
  "operation": "project_notes.count",
19727
19983
  "core": false,
@@ -24183,11 +24439,11 @@
24183
24439
  }
24184
24440
  ],
24185
24441
  "counts": {
24186
- "registryOperations": 1315,
24442
+ "registryOperations": 1329,
24187
24443
  "coreOperations": 10,
24188
- "catalogRows": 1315,
24189
- "withTool": 904,
24190
- "readModeOnly": 411,
24444
+ "catalogRows": 1329,
24445
+ "withTool": 914,
24446
+ "readModeOnly": 415,
24191
24447
  "neverExposed": 0,
24192
24448
  "metaTools": 5
24193
24449
  }
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 **271 tools**: the 269 dedicated write/delete tools (206 `effect=write` + 63 `effect=destructive`, every one of them has a dedicated tool) + `autotask_write` + `autotask_delete`. The remaining **638 tools** (the 625 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 **64 tools with `destructiveHint: true`** (63 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 **275 tools**: the 273 dedicated write/delete tools (208 `effect=write` + 65 `effect=destructive`, every one of them has a dedicated tool) + `autotask_write` + `autotask_delete`. The remaining **644 tools** (the 631 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 **66 tools with `destructiveHint: true`** (65 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