node-autotask 0.92.1 → 0.93.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 +5 -0
- package/MCP_TOOL_CATALOG.json +255 -9
- package/README.md +1 -1
- package/capabilities.json +1042 -222
- package/dist/capabilities-data.js +1296 -476
- package/dist/capabilities.cjs +4 -4
- package/dist/capabilities.js +1 -1
- package/dist/{chunk-QC45KFQQ.cjs → chunk-2FM7MRK2.cjs} +32 -30
- package/dist/{chunk-C7KZ7PB3.js → chunk-3SURRIOQ.js} +4 -2
- package/dist/{chunk-2MC3LDZU.js → chunk-DCISF6AG.js} +3 -3
- package/dist/{chunk-QVDXIXY4.js → chunk-FCQPZAIK.js} +2 -2
- package/dist/{chunk-4BICEQ4S.js → chunk-HJKI5VVJ.js} +188 -13
- package/dist/{chunk-QXJQIZCT.cjs → chunk-SBHQIPCJ.cjs} +3 -3
- package/dist/{chunk-JY6BQUPO.cjs → chunk-X7FGWEZ2.cjs} +202 -202
- package/dist/{chunk-LYAHXYZR.cjs → chunk-ZIBH42H3.cjs} +193 -18
- package/dist/{index-B0p5O-2e.d.cts → index-Cbos4Wgx.d.cts} +71 -1
- package/dist/{index-B0p5O-2e.d.ts → index-Cbos4Wgx.d.ts} +71 -1
- package/dist/{index-opnSlg90.d.cts → index-CnNxnu7M.d.cts} +9 -2
- package/dist/{index-it9IqLsM.d.ts → index-coyFHSSF.d.ts} +9 -2
- package/dist/index.cjs +86 -86
- package/dist/index.d.cts +4 -4
- package/dist/index.d.ts +4 -4
- package/dist/index.js +5 -5
- package/dist/operations/index.cjs +51 -51
- package/dist/operations/index.d.cts +4 -4
- package/dist/operations/index.d.ts +4 -4
- 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 -2
- package/examples/mcp-server-http.ts +6 -3
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [0.93.0] - 2026-11-22
|
|
11
|
+
|
|
12
|
+
- Add OrganizationalResources and ResourceDailyAvailabilities global reads, metadata, and native parent-scoped collection pages. Native pages validate int32 parent references and preserve the documented int64 route and row IDs. Availability weekly goals can be null when the vendor feature is inactive (#465).
|
|
13
|
+
- Let the HTTP MCP example bind an OS-assigned loopback port with `PORT=0`, avoiding gateway verification port races (#469).
|
|
14
|
+
|
|
10
15
|
## [0.92.1] - 2026-11-21
|
|
11
16
|
|
|
12
17
|
- Add optional InventoryItems preconditions so preview and apply compare the same approved item and reference facts. Observed drift refuses before mutation (#511, #509, #468).
|
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-22T07:17:30.591Z",
|
|
4
|
+
"planHash": "51888554f455b96e13c50591342fa516b095065762430b783201ac7a995a0901",
|
|
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 458 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 293 today); the 689 readOnlyHint: true tools — including this one — are safe ungated; the 72 destructiveHint: true tools (71 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 293 tools that require approval (readOnlyHint !== true); 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 293 tools that require approval (readOnlyHint !== true); the 689 readOnlyHint: true tools are safe ungated, and the 72 destructiveHint: true tools (71 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 71), 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 72 destructiveHint: true tools that require approval + confirm; approve every tool with readOnlyHint !== true (exactly 293 today); the
|
|
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 71), 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 72 destructiveHint: true tools that require approval + confirm; approve every tool with readOnlyHint !== true (exactly 293 today); the 689 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",
|
|
@@ -6468,6 +6468,129 @@
|
|
|
6468
6468
|
"reachReason": null,
|
|
6469
6469
|
"boundedAlternative": null
|
|
6470
6470
|
},
|
|
6471
|
+
{
|
|
6472
|
+
"operation": "organizational_resources.count",
|
|
6473
|
+
"core": false,
|
|
6474
|
+
"tool": "autotask_organizationalResource_count",
|
|
6475
|
+
"purpose": "Count OrganizationalResource membership records matching a JSON filter.",
|
|
6476
|
+
"preferredWhen": null,
|
|
6477
|
+
"backingOperation": "organizational_resources.count",
|
|
6478
|
+
"effect": "read",
|
|
6479
|
+
"dryRunFirst": false,
|
|
6480
|
+
"confirm": false,
|
|
6481
|
+
"requiredArgs": [],
|
|
6482
|
+
"tier": "advanced",
|
|
6483
|
+
"reachable": true,
|
|
6484
|
+
"reach": "dedicated tool",
|
|
6485
|
+
"reachReason": null,
|
|
6486
|
+
"boundedAlternative": null
|
|
6487
|
+
},
|
|
6488
|
+
{
|
|
6489
|
+
"operation": "organizational_resources.get",
|
|
6490
|
+
"core": false,
|
|
6491
|
+
"tool": "autotask_organizationalResource_get",
|
|
6492
|
+
"purpose": "Get one OrganizationalResource by id.",
|
|
6493
|
+
"preferredWhen": "Use the OrganizationalResources record id for the global item read; bound discovery queries by organizationalLevelAssociationID. operations.fetchByIds currently refuses this parent-associated resource; use the registered global get or a filtered query.",
|
|
6494
|
+
"backingOperation": "organizational_resources.get",
|
|
6495
|
+
"effect": "read",
|
|
6496
|
+
"dryRunFirst": false,
|
|
6497
|
+
"confirm": false,
|
|
6498
|
+
"requiredArgs": [
|
|
6499
|
+
"id"
|
|
6500
|
+
],
|
|
6501
|
+
"tier": "advanced",
|
|
6502
|
+
"reachable": true,
|
|
6503
|
+
"reach": "dedicated tool",
|
|
6504
|
+
"reachReason": null,
|
|
6505
|
+
"boundedAlternative": null
|
|
6506
|
+
},
|
|
6507
|
+
{
|
|
6508
|
+
"operation": "organizational_resources.getEntityInfo",
|
|
6509
|
+
"core": false,
|
|
6510
|
+
"tool": null,
|
|
6511
|
+
"purpose": "Get the OrganizationalResource capability metadata (canCreate/canUpdate/hasUserDefinedFields/...).",
|
|
6512
|
+
"preferredWhen": null,
|
|
6513
|
+
"backingOperation": "organizational_resources.getEntityInfo",
|
|
6514
|
+
"effect": "read",
|
|
6515
|
+
"dryRunFirst": false,
|
|
6516
|
+
"confirm": false,
|
|
6517
|
+
"requiredArgs": [],
|
|
6518
|
+
"tier": "advanced",
|
|
6519
|
+
"reachable": true,
|
|
6520
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
6521
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
6522
|
+
"boundedAlternative": null
|
|
6523
|
+
},
|
|
6524
|
+
{
|
|
6525
|
+
"operation": "organizational_resources.getFieldInfo",
|
|
6526
|
+
"core": false,
|
|
6527
|
+
"tool": null,
|
|
6528
|
+
"purpose": "Get the OrganizationalResource field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
|
|
6529
|
+
"preferredWhen": "Use when full raw field details are needed. Organizational Structure activation and API-user/module permissions determine availability. The organization association and member resource do not establish company ownership. An empty result is inconclusive about tenant-wide absence. This resource is read-only.",
|
|
6530
|
+
"backingOperation": "organizational_resources.getFieldInfo",
|
|
6531
|
+
"effect": "read",
|
|
6532
|
+
"dryRunFirst": false,
|
|
6533
|
+
"confirm": false,
|
|
6534
|
+
"requiredArgs": [],
|
|
6535
|
+
"tier": "advanced",
|
|
6536
|
+
"reachable": true,
|
|
6537
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
6538
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
6539
|
+
"boundedAlternative": null
|
|
6540
|
+
},
|
|
6541
|
+
{
|
|
6542
|
+
"operation": "organizational_resources.getUdfInfo",
|
|
6543
|
+
"core": false,
|
|
6544
|
+
"tool": null,
|
|
6545
|
+
"purpose": "Get the OrganizationalResource user-defined-field catalog.",
|
|
6546
|
+
"preferredWhen": null,
|
|
6547
|
+
"backingOperation": "organizational_resources.getUdfInfo",
|
|
6548
|
+
"effect": "read",
|
|
6549
|
+
"dryRunFirst": false,
|
|
6550
|
+
"confirm": false,
|
|
6551
|
+
"requiredArgs": [],
|
|
6552
|
+
"tier": "advanced",
|
|
6553
|
+
"reachable": true,
|
|
6554
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
6555
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
6556
|
+
"boundedAlternative": null
|
|
6557
|
+
},
|
|
6558
|
+
{
|
|
6559
|
+
"operation": "organizational_resources.listByParent",
|
|
6560
|
+
"core": false,
|
|
6561
|
+
"tool": null,
|
|
6562
|
+
"purpose": "Read one native parent-scoped staff-association page.",
|
|
6563
|
+
"preferredWhen": "Use when the documented native parent collection is required; global get remains single-record-id only.",
|
|
6564
|
+
"backingOperation": "organizational_resources.listByParent",
|
|
6565
|
+
"effect": "read",
|
|
6566
|
+
"dryRunFirst": false,
|
|
6567
|
+
"confirm": false,
|
|
6568
|
+
"requiredArgs": [
|
|
6569
|
+
"parentId"
|
|
6570
|
+
],
|
|
6571
|
+
"tier": "advanced",
|
|
6572
|
+
"reachable": true,
|
|
6573
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
6574
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
6575
|
+
"boundedAlternative": null
|
|
6576
|
+
},
|
|
6577
|
+
{
|
|
6578
|
+
"operation": "organizational_resources.query",
|
|
6579
|
+
"core": false,
|
|
6580
|
+
"tool": "autotask_organizationalResource_query",
|
|
6581
|
+
"purpose": "Query OrganizationalResource records with a JSON filter.",
|
|
6582
|
+
"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).",
|
|
6583
|
+
"backingOperation": "organizational_resources.query",
|
|
6584
|
+
"effect": "read",
|
|
6585
|
+
"dryRunFirst": false,
|
|
6586
|
+
"confirm": false,
|
|
6587
|
+
"requiredArgs": [],
|
|
6588
|
+
"tier": "advanced",
|
|
6589
|
+
"reachable": true,
|
|
6590
|
+
"reach": "dedicated tool",
|
|
6591
|
+
"reachReason": null,
|
|
6592
|
+
"boundedAlternative": null
|
|
6593
|
+
},
|
|
6471
6594
|
{
|
|
6472
6595
|
"operation": "product_vendors.count",
|
|
6473
6596
|
"core": false,
|
|
@@ -7698,6 +7821,129 @@
|
|
|
7698
7821
|
"reachReason": null,
|
|
7699
7822
|
"boundedAlternative": null
|
|
7700
7823
|
},
|
|
7824
|
+
{
|
|
7825
|
+
"operation": "resource_daily_availabilities.count",
|
|
7826
|
+
"core": false,
|
|
7827
|
+
"tool": "autotask_resourceDailyAvailability_count",
|
|
7828
|
+
"purpose": "Count resource daily availability records matching a JSON filter.",
|
|
7829
|
+
"preferredWhen": null,
|
|
7830
|
+
"backingOperation": "resource_daily_availabilities.count",
|
|
7831
|
+
"effect": "read",
|
|
7832
|
+
"dryRunFirst": false,
|
|
7833
|
+
"confirm": false,
|
|
7834
|
+
"requiredArgs": [],
|
|
7835
|
+
"tier": "advanced",
|
|
7836
|
+
"reachable": true,
|
|
7837
|
+
"reach": "dedicated tool",
|
|
7838
|
+
"reachReason": null,
|
|
7839
|
+
"boundedAlternative": null
|
|
7840
|
+
},
|
|
7841
|
+
{
|
|
7842
|
+
"operation": "resource_daily_availabilities.get",
|
|
7843
|
+
"core": false,
|
|
7844
|
+
"tool": "autotask_resourceDailyAvailability_get",
|
|
7845
|
+
"purpose": "Get one ResourceDailyAvailability by id.",
|
|
7846
|
+
"preferredWhen": "Use the global item read when the availability row ID is known. Discover rows for a staff member with resource_daily_availabilities.query filtered by resourceID, or use resource_daily_availabilities.listByParent for one native page. operations.fetchByIds currently refuses this parent-associated resource.",
|
|
7847
|
+
"backingOperation": "resource_daily_availabilities.get",
|
|
7848
|
+
"effect": "read",
|
|
7849
|
+
"dryRunFirst": false,
|
|
7850
|
+
"confirm": false,
|
|
7851
|
+
"requiredArgs": [
|
|
7852
|
+
"id"
|
|
7853
|
+
],
|
|
7854
|
+
"tier": "advanced",
|
|
7855
|
+
"reachable": true,
|
|
7856
|
+
"reach": "dedicated tool",
|
|
7857
|
+
"reachReason": null,
|
|
7858
|
+
"boundedAlternative": null
|
|
7859
|
+
},
|
|
7860
|
+
{
|
|
7861
|
+
"operation": "resource_daily_availabilities.getEntityInfo",
|
|
7862
|
+
"core": false,
|
|
7863
|
+
"tool": null,
|
|
7864
|
+
"purpose": "Get the ResourceDailyAvailability capability metadata (canCreate/canUpdate/hasUserDefinedFields/...).",
|
|
7865
|
+
"preferredWhen": null,
|
|
7866
|
+
"backingOperation": "resource_daily_availabilities.getEntityInfo",
|
|
7867
|
+
"effect": "read",
|
|
7868
|
+
"dryRunFirst": false,
|
|
7869
|
+
"confirm": false,
|
|
7870
|
+
"requiredArgs": [],
|
|
7871
|
+
"tier": "advanced",
|
|
7872
|
+
"reachable": true,
|
|
7873
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
7874
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
7875
|
+
"boundedAlternative": null
|
|
7876
|
+
},
|
|
7877
|
+
{
|
|
7878
|
+
"operation": "resource_daily_availabilities.getFieldInfo",
|
|
7879
|
+
"core": false,
|
|
7880
|
+
"tool": null,
|
|
7881
|
+
"purpose": "Get the ResourceDailyAvailability field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
|
|
7882
|
+
"preferredWhen": "Availability depends on API-user permissions and feature activation; an empty query is inconclusive about inventory. Weekly Billable Hours Goal activation controls weeklyBillableHoursGoal query/filter/update support; inactive features can return null and forbid filtering or updates. Use weeklyBillableHoursGoal and travelAvailability from exposed field metadata, not the misspellings weeklyBillableGoalHours/travelAvailablity in official prose. Resource administration is account-wide; resourceID is a staff parent, not company ownership. This SDK slice exposes reads only; availability updates remain tracked separately.",
|
|
7883
|
+
"backingOperation": "resource_daily_availabilities.getFieldInfo",
|
|
7884
|
+
"effect": "read",
|
|
7885
|
+
"dryRunFirst": false,
|
|
7886
|
+
"confirm": false,
|
|
7887
|
+
"requiredArgs": [],
|
|
7888
|
+
"tier": "advanced",
|
|
7889
|
+
"reachable": true,
|
|
7890
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
7891
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
7892
|
+
"boundedAlternative": null
|
|
7893
|
+
},
|
|
7894
|
+
{
|
|
7895
|
+
"operation": "resource_daily_availabilities.getUdfInfo",
|
|
7896
|
+
"core": false,
|
|
7897
|
+
"tool": null,
|
|
7898
|
+
"purpose": "Get the ResourceDailyAvailability user-defined-field catalog.",
|
|
7899
|
+
"preferredWhen": null,
|
|
7900
|
+
"backingOperation": "resource_daily_availabilities.getUdfInfo",
|
|
7901
|
+
"effect": "read",
|
|
7902
|
+
"dryRunFirst": false,
|
|
7903
|
+
"confirm": false,
|
|
7904
|
+
"requiredArgs": [],
|
|
7905
|
+
"tier": "advanced",
|
|
7906
|
+
"reachable": true,
|
|
7907
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
7908
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
7909
|
+
"boundedAlternative": null
|
|
7910
|
+
},
|
|
7911
|
+
{
|
|
7912
|
+
"operation": "resource_daily_availabilities.listByParent",
|
|
7913
|
+
"core": false,
|
|
7914
|
+
"tool": null,
|
|
7915
|
+
"purpose": "Read one native parent-scoped staff-association page.",
|
|
7916
|
+
"preferredWhen": "Use when the documented native parent collection is required; global get remains single-record-id only.",
|
|
7917
|
+
"backingOperation": "resource_daily_availabilities.listByParent",
|
|
7918
|
+
"effect": "read",
|
|
7919
|
+
"dryRunFirst": false,
|
|
7920
|
+
"confirm": false,
|
|
7921
|
+
"requiredArgs": [
|
|
7922
|
+
"parentId"
|
|
7923
|
+
],
|
|
7924
|
+
"tier": "advanced",
|
|
7925
|
+
"reachable": true,
|
|
7926
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
7927
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
7928
|
+
"boundedAlternative": null
|
|
7929
|
+
},
|
|
7930
|
+
{
|
|
7931
|
+
"operation": "resource_daily_availabilities.query",
|
|
7932
|
+
"core": false,
|
|
7933
|
+
"tool": "autotask_resourceDailyAvailability_query",
|
|
7934
|
+
"purpose": "Query ResourceDailyAvailability records with a JSON filter.",
|
|
7935
|
+
"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).",
|
|
7936
|
+
"backingOperation": "resource_daily_availabilities.query",
|
|
7937
|
+
"effect": "read",
|
|
7938
|
+
"dryRunFirst": false,
|
|
7939
|
+
"confirm": false,
|
|
7940
|
+
"requiredArgs": [],
|
|
7941
|
+
"tier": "advanced",
|
|
7942
|
+
"reachable": true,
|
|
7943
|
+
"reach": "dedicated tool",
|
|
7944
|
+
"reachReason": null,
|
|
7945
|
+
"boundedAlternative": null
|
|
7946
|
+
},
|
|
7701
7947
|
{
|
|
7702
7948
|
"operation": "resource_role_queues.count",
|
|
7703
7949
|
"core": false,
|
|
@@ -26084,11 +26330,11 @@
|
|
|
26084
26330
|
}
|
|
26085
26331
|
],
|
|
26086
26332
|
"counts": {
|
|
26087
|
-
"registryOperations":
|
|
26333
|
+
"registryOperations": 1435,
|
|
26088
26334
|
"coreOperations": 10,
|
|
26089
|
-
"catalogRows":
|
|
26090
|
-
"withTool":
|
|
26091
|
-
"readModeOnly":
|
|
26335
|
+
"catalogRows": 1435,
|
|
26336
|
+
"withTool": 977,
|
|
26337
|
+
"readModeOnly": 458,
|
|
26092
26338
|
"neverExposed": 0,
|
|
26093
26339
|
"metaTools": 5
|
|
26094
26340
|
}
|
package/README.md
CHANGED
|
@@ -388,7 +388,7 @@ The SDK ships the mechanical substrate, not a server (no MCP imports, no zod):
|
|
|
388
388
|
governor place: `src/operations/invoke.ts`).
|
|
389
389
|
|
|
390
390
|
<!-- BEGIN GENERATED:approval-policy -->
|
|
391
|
-
**Harness approval policy (recommended).** Require approval on every tool whose MCP annotation is `readOnlyHint !== true` — today exactly **293 tools**: the 291 dedicated write/delete tools (220 `effect=write` + 71 `effect=destructive`, every one of them has a dedicated tool) + `autotask_write` + `autotask_delete`. The remaining **
|
|
391
|
+
**Harness approval policy (recommended).** Require approval on every tool whose MCP annotation is `readOnlyHint !== true` — today exactly **293 tools**: the 291 dedicated write/delete tools (220 `effect=write` + 71 `effect=destructive`, every one of them has a dedicated tool) + `autotask_write` + `autotask_delete`. The remaining **689 tools** (the 676 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 **72 tools with `destructiveHint: true`** (71 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
392
|
<!-- END GENERATED:approval-policy -->
|
|
393
393
|
**Provider tool-search interop.** Hosts with provider-native tool search
|
|
394
394
|
(OpenAI `type: "tool_search"` / `defer_loading`; Anthropic's tool search
|