node-autotask 0.43.0 → 0.45.0

package/MCP_TOOL_CATALOG.json

@@ -1,7 +1,7 @@
 {
   "generatedBy": "scripts/build-tool-catalog.mjs",
-  "generatedAt": "2026-10-31T20:17:42.030Z",
-  "planHash": "5c18b378722a038159564faccee795e7c278f048f30c77d77b5dc27e83ea2dee",
+  "generatedAt": "2026-11-01T10:43:53.138Z",
+  "planHash": "dc0c06eae0d75d77a9d41c50f8d9a4a7ce458f34e62aa1e7f9b5f35a487e4020",
   "metaTools": [
     {
       "name": "autotask_catalog",
@@ -51,7 +51,7 @@
     {
       "name": "autotask_read",
       "title": "Read One Registry Operation (read mode)",
-      "description": "Route an effect=read registry operation by its exact name (never fuzzy, never a tool name): the 384 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 267 today); the 635 readOnlyHint: true tools — including this one — are safe ungated; the 57 destructiveHint: true tools (56 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.",
+      "description": "Route an effect=read registry operation by its exact name (never fuzzy, never a tool name): the 384 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 246 today); the 599 readOnlyHint: true tools — including this one — are safe ungated; the 57 destructiveHint: true tools (56 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.",
       "input": {
         "operation": {
           "type": "string",
@@ -71,7 +71,7 @@
     {
       "name": "autotask_write",
       "title": "Write One Registry Operation (write mode)",
-      "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 3 approval-gated writes (configuration_items.moveConfigurationItem, contacts.moveToCompany, resources.transferOwnership) additionally require confirm === the operation key, in BOTH dry-run and apply mode. Harness approval policy: this tool is one of the 267 tools that require approval (readOnlyHint !== true); the 635 readOnlyHint: true tools are safe ungated, and the 57 destructiveHint: true tools (56 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.",
+      "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 246 tools that require approval (readOnlyHint !== true); the 599 readOnlyHint: true tools are safe ungated, and the 57 destructiveHint: true tools (56 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.",
       "input": {
         "operation": {
           "type": "string",
@@ -101,7 +101,7 @@
     {
       "name": "autotask_delete",
       "title": "Delete One Registry Operation (delete mode)",
-      "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 56), 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 57 destructiveHint: true tools that require approval + confirm; approve every tool with readOnlyHint !== true (exactly 267 today); the 635 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.",
+      "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 56), 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 57 destructiveHint: true tools that require approval + confirm; approve every tool with readOnlyHint !== true (exactly 246 today); the 599 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.",
       "input": {
         "operation": {
           "type": "string",
@@ -587,7 +587,7 @@
       "core": false,
       "tool": "autotask_billingItemApprovalLevel_create",
       "purpose": "Create a billing item approval level (the REST-only approval write for a time entry).",
-      "preferredWhen": "Prefer time_entries.approve: it performs this create AND the documented follow-up update, then verifies the read-back. Use this raw create only when the follow-up update must be controlled separately.",
+      "preferredWhen": "Use this raw create (plus the documented follow-up update of the two approval fields) when the follow-up must be controlled separately — the approval composite (time_entries.approve) was cut in #292.",
       "backingOperation": "billing_item_approval_levels.create",
       "effect": "write",
       "dryRunFirst": true,
@@ -606,7 +606,7 @@
       "core": false,
       "tool": "autotask_billingItemApprovalLevel_get",
       "purpose": "Get one billing item approval level by id.",
-      "preferredWhen": "Preferred when the numeric id is known (e.g. the id time_entries.approve returned); query by timeEntryID when it is not.",
+      "preferredWhen": "Preferred when the numeric id is known; query by timeEntryID when it is not.",
       "backingOperation": "billing_item_approval_levels.get",
       "effect": "read",
       "dryRunFirst": false,
@@ -654,28 +654,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "billing_items.customRange",
-      "core": false,
-      "tool": "autotask_billingItems_customRange",
-      "purpose": "Get billing items for an explicit itemDate range.",
-      "preferredWhen": null,
-      "backingOperation": "billing_items.customRange",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [
-        "from",
-        "to"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
     {
       "operation": "billing_items.get",
       "core": false,
@@ -746,177 +724,6 @@
       "reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
       "boundedAlternative": null
     },
-    {
-      "operation": "billing_items.last14",
-      "core": false,
-      "tool": "autotask_billingItems_last14",
-      "purpose": "Get billing items for the last 14 days (rolling, itemDate).",
-      "preferredWhen": null,
-      "backingOperation": "billing_items.last14",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
-    {
-      "operation": "billing_items.last24h",
-      "core": false,
-      "tool": "autotask_billingItems_last24h",
-      "purpose": "Get billing items for the last 24 hours (rolling, itemDate).",
-      "preferredWhen": null,
-      "backingOperation": "billing_items.last24h",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
-    {
-      "operation": "billing_items.last30",
-      "core": false,
-      "tool": "autotask_billingItems_last30",
-      "purpose": "Get billing items for the last 30 days (rolling, itemDate).",
-      "preferredWhen": null,
-      "backingOperation": "billing_items.last30",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
-    {
-      "operation": "billing_items.last7",
-      "core": false,
-      "tool": "autotask_billingItems_last7",
-      "purpose": "Get billing items for the last 7 days (rolling, itemDate).",
-      "preferredWhen": null,
-      "backingOperation": "billing_items.last7",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
-    {
-      "operation": "billing_items.last90",
-      "core": false,
-      "tool": "autotask_billingItems_last90",
-      "purpose": "Get billing items for the last 90 days (rolling, itemDate).",
-      "preferredWhen": null,
-      "backingOperation": "billing_items.last90",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
-    {
-      "operation": "billing_items.lastFullFortnight",
-      "core": false,
-      "tool": "autotask_billingItems_lastFullFortnight",
-      "purpose": "Get billing items for the last complete fortnight (itemDate).",
-      "preferredWhen": null,
-      "backingOperation": "billing_items.lastFullFortnight",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
-    {
-      "operation": "billing_items.lastFullMonth",
-      "core": false,
-      "tool": "autotask_billingItems_lastFullMonth",
-      "purpose": "Get billing items for the last complete calendar month (itemDate).",
-      "preferredWhen": null,
-      "backingOperation": "billing_items.lastFullMonth",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
-    {
-      "operation": "billing_items.lastFullQuarter",
-      "core": false,
-      "tool": "autotask_billingItems_lastFullQuarter",
-      "purpose": "Get billing items for the last complete calendar quarter (itemDate).",
-      "preferredWhen": null,
-      "backingOperation": "billing_items.lastFullQuarter",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
-    {
-      "operation": "billing_items.lastFullWeek",
-      "core": false,
-      "tool": "autotask_billingItems_lastFullWeek",
-      "purpose": "Get billing items for the last complete ISO week (itemDate).",
-      "preferredWhen": null,
-      "backingOperation": "billing_items.lastFullWeek",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
     {
       "operation": "billing_items.query",
       "core": false,
@@ -953,25 +760,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "billing_items.today",
-      "core": false,
-      "tool": "autotask_billingItems_today",
-      "purpose": "Get billing items for today (itemDate = now, server date).",
-      "preferredWhen": null,
-      "backingOperation": "billing_items.today",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
     {
       "operation": "billing_items.update",
       "core": false,
@@ -992,25 +780,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "billing_items.yesterday",
-      "core": false,
-      "tool": "autotask_billingItems_yesterday",
-      "purpose": "Get billing items for yesterday (itemDate = previous server day).",
-      "preferredWhen": null,
-      "backingOperation": "billing_items.yesterday",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
     {
       "operation": "change_request_links.count",
       "core": false,
@@ -1047,25 +816,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "change_request_links.createIfNotExists",
-      "core": false,
-      "tool": "autotask_changeRequestLinks_create_if_not_exists",
-      "purpose": "Create a ChangeRequestLink.",
-      "preferredWhen": null,
-      "backingOperation": "change_request_links.createIfNotExists",
-      "effect": "write",
-      "dryRunFirst": true,
-      "confirm": false,
-      "requiredArgs": [
-        "data"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
     {
       "operation": "change_request_links.delete",
       "core": false,
@@ -4077,26 +3827,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "expense_items.createIfNotExists",
-      "core": false,
-      "tool": "autotask_expenseItem_create_if_not_exists",
-      "purpose": "Create an ExpenseItem.",
-      "preferredWhen": null,
-      "backingOperation": "expense_items.createIfNotExists",
-      "effect": "write",
-      "dryRunFirst": true,
-      "confirm": false,
-      "requiredArgs": [
-        "parentId",
-        "data"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
     {
       "operation": "expense_items.get",
       "core": false,
@@ -4441,25 +4171,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "holiday_sets.createIfNotExists",
-      "core": false,
-      "tool": "autotask_holidaySet_create_if_not_exists",
-      "purpose": "Create a HolidaySet.",
-      "preferredWhen": null,
-      "backingOperation": "holiday_sets.createIfNotExists",
-      "effect": "write",
-      "dryRunFirst": true,
-      "confirm": false,
-      "requiredArgs": [
-        "data"
-      ],
-      "tier": "advanced",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
     {
       "operation": "holiday_sets.delete",
       "core": false,
@@ -4642,26 +4353,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "holidays.createIfNotExists",
-      "core": false,
-      "tool": "autotask_holiday_create_if_not_exists",
-      "purpose": "Create a Holiday.",
-      "preferredWhen": null,
-      "backingOperation": "holidays.createIfNotExists",
-      "effect": "write",
-      "dryRunFirst": true,
-      "confirm": false,
-      "requiredArgs": [
-        "parentId",
-        "data"
-      ],
-      "tier": "advanced",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
     {
       "operation": "holidays.delete",
       "core": false,
@@ -7928,38 +7619,18 @@
       "boundedAlternative": null
     },
     {
-      "operation": "resources.transferOwnership",
+      "operation": "resources.update",
       "core": false,
-      "tool": "autotask_resource_transfer_ownership",
-      "purpose": "Transfer ownership of named resources to another resource.",
-      "preferredWhen": null,
-      "backingOperation": "resources.transferOwnership",
+      "tool": "autotask_resource_update",
+      "purpose": "Update a resource.",
+      "preferredWhen": "Preferred over create or delete when the record exists and only some fields change.",
+      "backingOperation": "resources.update",
       "effect": "write",
       "dryRunFirst": true,
-      "confirm": true,
+      "confirm": false,
       "requiredArgs": [
-        "sourceResourceIds",
-        "destinationResourceId"
-      ],
-      "tier": "core",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
-    {
-      "operation": "resources.update",
-      "core": false,
-      "tool": "autotask_resource_update",
-      "purpose": "Update a resource.",
-      "preferredWhen": "Preferred over create or delete when the record exists and only some fields change.",
-      "backingOperation": "resources.update",
-      "effect": "write",
-      "dryRunFirst": true,
-      "confirm": false,
-      "requiredArgs": [
-        "id",
-        "data"
+        "id",
+        "data"
       ],
       "tier": "core",
       "reachable": true,
@@ -7984,6 +7655,25 @@
       "reachReason": null,
       "boundedAlternative": null
     },
+    {
+      "operation": "resources.workload",
+      "core": false,
+      "tool": "autotask_resource_workload",
+      "purpose": "Get a resource's workload in a single call: its open tickets (rows + the exact open totals), its task assignments and the tasks behind them, its time-off balances and requests.",
+      "preferredWhen": "The single read for \"what is this resource working on right now\" — replaces the get + the forResource rows + the forResource counts + the assignments + the task join + the balances + the time-off queries with one call.",
+      "backingOperation": "resources.workload",
+      "effect": "read",
+      "dryRunFirst": false,
+      "confirm": false,
+      "requiredArgs": [
+        "id"
+      ],
+      "tier": "extended",
+      "reachable": true,
+      "reach": "dedicated tool",
+      "reachReason": null,
+      "boundedAlternative": null
+    },
     {
       "operation": "roles.count",
       "core": false,
@@ -9000,6 +8690,25 @@
       "reachReason": null,
       "boundedAlternative": null
     },
+    {
+      "operation": "service_calls.fullProfile",
+      "core": false,
+      "tool": "autotask_service_call_full_profile",
+      "purpose": "Get a service call with its tickets, tasks and resource assignments in a single call — the assignment join runs through the call's task ids.",
+      "preferredWhen": "The single read for \"tell me everything about this service call\" — replaces the get + the two FK queries + the task-id join with one call.",
+      "backingOperation": "service_calls.fullProfile",
+      "effect": "read",
+      "dryRunFirst": false,
+      "confirm": false,
+      "requiredArgs": [
+        "id"
+      ],
+      "tier": "extended",
+      "reachable": true,
+      "reach": "dedicated tool",
+      "reachReason": null,
+      "boundedAlternative": null
+    },
     {
       "operation": "service_calls.get",
       "core": false,
@@ -11439,25 +11148,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "time_entries.approve",
-      "core": false,
-      "tool": "autotask_timeEntry_approve",
-      "purpose": "Approve a time entry (the REST-only approval path): create the BillingItemApprovalLevels record, apply the vendor-documented follow-up update of BillingApprovalDateTime + BillingApprovalResourceID, then read the entry back and report whether the vendor accepted it.",
-      "preferredWhen": "Approving (or adding the next approval level to) a time entry. This is the only approval channel the REST API exposes — there is no TimeEntries/Approve path. When the follow-up update throws, the approval level record HAS been created on the vendor (there is no rollback and no delete): reconcile by re-reading the entry's billingApprovalLevelMostRecent or querying billing_item_approval_levels by timeEntryID.",
-      "backingOperation": "time_entries.approve",
-      "effect": "write",
-      "dryRunFirst": true,
-      "confirm": false,
-      "requiredArgs": [
-        "id"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
     {
       "operation": "time_entries.count",
       "core": false,
@@ -11494,72 +11184,11 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "time_entries.createForResource",
-      "core": false,
-      "tool": "autotask_timeEntry_create_for_resource",
-      "purpose": "Create a time entry for a resource with the allocation-code dependency resolved by the node: it verifies the resource is active, honours the caller's linkage pin (else the default internal linkage), resolves an EXISTING active allocation code applicable to the resource (never creates one — the API user cannot), and posts the vendor-valid body.",
-      "preferredWhen": "Default for any agent-created time entry: it does the dependency heavy lifting the vendor enforces with 500s. time_entries.create is the low-level escape hatch (it posts exactly the given body and lets the vendor gates surface verbatim).",
-      "backingOperation": "time_entries.createForResource",
-      "effect": "write",
-      "dryRunFirst": true,
-      "confirm": false,
-      "requiredArgs": [
-        "resourceID",
-        "params"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
-    {
-      "operation": "time_entries.createIfNotExists",
-      "core": false,
-      "tool": "autotask_timeEntry_create_if_not_exists",
-      "purpose": "Create a TimeEntry.",
-      "preferredWhen": null,
-      "backingOperation": "time_entries.createIfNotExists",
-      "effect": "write",
-      "dryRunFirst": true,
-      "confirm": false,
-      "requiredArgs": [
-        "data"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
-    {
-      "operation": "time_entries.customRange",
-      "core": false,
-      "tool": "autotask_timeEntry_custom_range",
-      "purpose": "Get time entries for an explicit dateWorked range.",
-      "preferredWhen": null,
-      "backingOperation": "time_entries.customRange",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [
-        "from",
-        "to"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
     {
       "operation": "time_entries.dateWorkedWindow",
       "core": false,
       "tool": "autotask_timeEntry_date_worked_window",
-      "purpose": "The unambiguous-named alias for time_entries.postedWithin (issue #66): the dateWorked window read with the posted/unposted split derived from the billing_items.timeEntryID join — same wire, same result (incl. truncated). The window is ON dateWorked (entries worked within [from, to]); \"postedWithin\" keeps its historical name (its \"posted\" is the posted/unposted split, never a posted-date window or a postedDate read).",
+      "purpose": "The ONE posted-state read (issue #290): a bounded read over the inclusive dateWorked window [from, to] (UTC 'YYYY-MM-DD' days) with the posted/unposted split derived from the billing_items.timeEntryID join — never a postedDate read (W-D3: this zone's TimeEntry entity has no postedDate; postedDate exist|notExist 500s, live ww29 2026-10-27). Approval is NOT consulted (ww29 never populates billingApprovalDateTime yet bills those entries). The no-window form is gone: read with no dateWorked filter goes through time_entries.query.",
       "preferredWhen": null,
       "backingOperation": "time_entries.dateWorkedWindow",
       "effect": "read",
@@ -11649,23 +11278,6 @@
       "reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
       "boundedAlternative": null
     },
-    {
-      "operation": "time_entries.getPosted",
-      "core": false,
-      "tool": "autotask_timeEntry_get_posted",
-      "purpose": "Get posted time entries (an entry that a billing item references), optionally for one ticket and/or a dateWorked window — posted state derives from the billing_items.timeEntryID join, never a postedDate read or approval.",
-      "preferredWhen": null,
-      "backingOperation": "time_entries.getPosted",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
     {
       "operation": "time_entries.getUdfInfo",
       "core": false,
@@ -11683,194 +11295,6 @@
       "reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
       "boundedAlternative": null
     },
-    {
-      "operation": "time_entries.getUnposted",
-      "core": false,
-      "tool": "autotask_timeEntry_get_unposted",
-      "purpose": "Get unposted time entries (entries no billing item references), optionally for one ticket and/or a dateWorked window — posted state derives from the billing_items.timeEntryID join, never a postedDate read or approval.",
-      "preferredWhen": null,
-      "backingOperation": "time_entries.getUnposted",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
-    {
-      "operation": "time_entries.last14",
-      "core": false,
-      "tool": "autotask_timeEntry_last14",
-      "purpose": "Get time entries for the last 14 days (rolling, dateWorked).",
-      "preferredWhen": null,
-      "backingOperation": "time_entries.last14",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
-    {
-      "operation": "time_entries.last24h",
-      "core": false,
-      "tool": "autotask_timeEntry_last24h",
-      "purpose": "Get time entries for the last 24 hours (rolling, dateWorked).",
-      "preferredWhen": null,
-      "backingOperation": "time_entries.last24h",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
-    {
-      "operation": "time_entries.last30",
-      "core": false,
-      "tool": "autotask_timeEntry_last30",
-      "purpose": "Get time entries for the last 30 days (rolling, dateWorked).",
-      "preferredWhen": null,
-      "backingOperation": "time_entries.last30",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
-    {
-      "operation": "time_entries.last7",
-      "core": false,
-      "tool": "autotask_timeEntry_last7",
-      "purpose": "Get time entries for the last 7 days (rolling, dateWorked).",
-      "preferredWhen": null,
-      "backingOperation": "time_entries.last7",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
-    {
-      "operation": "time_entries.last90",
-      "core": false,
-      "tool": "autotask_timeEntry_last90",
-      "purpose": "Get time entries for the last 90 days (rolling, dateWorked).",
-      "preferredWhen": null,
-      "backingOperation": "time_entries.last90",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
-    {
-      "operation": "time_entries.lastFullFortnight",
-      "core": false,
-      "tool": "autotask_timeEntry_lastFullFortnight",
-      "purpose": "Get time entries for the last complete fortnight.",
-      "preferredWhen": null,
-      "backingOperation": "time_entries.lastFullFortnight",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
-    {
-      "operation": "time_entries.lastFullMonth",
-      "core": false,
-      "tool": "autotask_timeEntry_lastFullMonth",
-      "purpose": "Get time entries for the last complete calendar month.",
-      "preferredWhen": null,
-      "backingOperation": "time_entries.lastFullMonth",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
-    {
-      "operation": "time_entries.lastFullQuarter",
-      "core": false,
-      "tool": "autotask_timeEntry_lastFullQuarter",
-      "purpose": "Get time entries for the last complete calendar quarter.",
-      "preferredWhen": null,
-      "backingOperation": "time_entries.lastFullQuarter",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
-    {
-      "operation": "time_entries.lastFullWeek",
-      "core": false,
-      "tool": "autotask_timeEntry_lastFullWeek",
-      "purpose": "Get time entries for the last complete calendar week.",
-      "preferredWhen": null,
-      "backingOperation": "time_entries.lastFullWeek",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
     {
       "operation": "time_entries.moveToTicket",
       "core": false,
@@ -11891,26 +11315,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "time_entries.postedWithin",
-      "core": false,
-      "tool": "autotask_timeEntry_posted_within",
-      "purpose": "Get time entries WORKED within an inclusive dateWorked window with the posted/unposted split. The window is ON the dateWorked field — the name's \"posted\" is the posted/unposted SPLIT derived from the billing_items.timeEntryID join (an entry a billing item references is posted, approval is not consulted), never a posted-date window or a postedDate read. The counts cover the returned rows only; truncated flags a capped read. time_entries.dateWorkedWindow is the unambiguous name.",
-      "preferredWhen": null,
-      "backingOperation": "time_entries.postedWithin",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [
-        "from",
-        "to"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
     {
       "operation": "time_entries.query",
       "core": false,
@@ -11947,25 +11351,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "time_entries.today",
-      "core": false,
-      "tool": "autotask_timeEntry_today",
-      "purpose": "Get time entries for today (dateWorked = now, server date).",
-      "preferredWhen": null,
-      "backingOperation": "time_entries.today",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
     {
       "operation": "time_entries.update",
       "core": false,
@@ -11984,26 +11369,7 @@
       "reachable": true,
       "reach": "dedicated tool",
       "reachReason": null,
-      "boundedAlternative": null
-    },
-    {
-      "operation": "time_entries.yesterday",
-      "core": false,
-      "tool": "autotask_timeEntry_yesterday",
-      "purpose": "Get time entries for yesterday (dateWorked = yesterday, server date).",
-      "preferredWhen": null,
-      "backingOperation": "time_entries.yesterday",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
+      "boundedAlternative": null
     },
     {
       "operation": "time_entry_attachments.count",
@@ -12697,26 +12063,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "companies.upsertByName",
-      "core": false,
-      "tool": "autotask_company_upsert_by_name",
-      "purpose": "Make sure a company with the given name exists — find-or-create that carries the blind-surface boundary IN THE RESULT instead of pretending total visibility.",
-      "preferredWhen": "The one-call 'make sure this company exists' for agents. companies.create stays the low-level escape hatch.",
-      "backingOperation": "companies.upsertByName",
-      "effect": "write",
-      "dryRunFirst": true,
-      "confirm": false,
-      "requiredArgs": [
-        "companyName",
-        "params"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
     {
       "operation": "company_alerts.count",
       "core": false,
@@ -14713,25 +14059,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "configuration_items.createIfNotExists",
-      "core": false,
-      "tool": "autotask_configurationItems_create_if_not_exists",
-      "purpose": "Create a ConfigurationItem.",
-      "preferredWhen": null,
-      "backingOperation": "configuration_items.createIfNotExists",
-      "effect": "write",
-      "dryRunFirst": true,
-      "confirm": false,
-      "requiredArgs": [
-        "data"
-      ],
-      "tier": "core",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
     {
       "operation": "configuration_items.findBySerial",
       "core": false,
@@ -15230,6 +14557,25 @@
       "reachReason": null,
       "boundedAlternative": null
     },
+    {
+      "operation": "contacts.fullProfile",
+      "core": false,
+      "tool": "autotask_contact_full_profile",
+      "purpose": "Get a contact with its company and its open tickets in a single call: the contact (the parent-scoped root read, or the stage-1 row when the contact has no company FK), its company, and its open tickets — every part separately reported.",
+      "preferredWhen": "The single read for \"tell me everything about this contact\" — replaces the stage-1 query + the parent-scoped get + the company get + the status picklist + the open-tickets query with one call.",
+      "backingOperation": "contacts.fullProfile",
+      "effect": "read",
+      "dryRunFirst": false,
+      "confirm": false,
+      "requiredArgs": [
+        "id"
+      ],
+      "tier": "extended",
+      "reachable": true,
+      "reach": "dedicated tool",
+      "reachReason": null,
+      "boundedAlternative": null
+    },
     {
       "operation": "contacts.get",
       "core": false,
@@ -15416,26 +14762,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "contacts.upsertByEmail",
-      "core": false,
-      "tool": "autotask_contact_upsert_by_email",
-      "purpose": "Make sure a contact with the given email exists under the given company — find-or-create under the RIGHT parent, with the typed EXISTS/CREATED result (+ the record).",
-      "preferredWhen": "The one-call 'make sure this contact exists' for agents — the natural key is the email under a company. contacts.create stays the low-level escape hatch (it posts exactly the given body).",
-      "backingOperation": "contacts.upsertByEmail",
-      "effect": "write",
-      "dryRunFirst": true,
-      "confirm": false,
-      "requiredArgs": [
-        "companyID",
-        "email"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
     {
       "operation": "contract_billing_rules.count",
       "core": false,
@@ -15988,26 +15314,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "contract_charges.createIfNotExists",
-      "core": false,
-      "tool": "autotask_contractCharge_create_if_not_exists",
-      "purpose": "Create a ContractCharge.",
-      "preferredWhen": null,
-      "backingOperation": "contract_charges.createIfNotExists",
-      "effect": "write",
-      "dryRunFirst": true,
-      "confirm": false,
-      "requiredArgs": [
-        "parentId",
-        "data"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
     {
       "operation": "contract_charges.delete",
       "core": false,
@@ -17958,26 +17264,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "contract_services.createIfNotExists",
-      "core": false,
-      "tool": "autotask_contractService_create_if_not_exists",
-      "purpose": "Create a ContractService.",
-      "preferredWhen": null,
-      "backingOperation": "contract_services.createIfNotExists",
-      "effect": "write",
-      "dryRunFirst": true,
-      "confirm": false,
-      "requiredArgs": [
-        "parentId",
-        "data"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
     {
       "operation": "contract_services.get",
       "core": false,
@@ -18308,17 +17594,17 @@
       "boundedAlternative": null
     },
     {
-      "operation": "contracts.createIfNotExists",
+      "operation": "contracts.fullProfile",
       "core": false,
-      "tool": "autotask_contract_create_if_not_exists",
-      "purpose": "Create a Contract.",
-      "preferredWhen": null,
-      "backingOperation": "contracts.createIfNotExists",
-      "effect": "write",
-      "dryRunFirst": true,
+      "tool": "autotask_contract_full_profile",
+      "purpose": "Get a contract with its services, billing rules, recent charges and service units in a single call — the charges part is the N newest (the count-anchored `latest` 50).",
+      "preferredWhen": "The single read for \"tell me everything about this contract\" — replaces the get + the four FK queries with one call; the first read of a contract for the profitability workflow.",
+      "backingOperation": "contracts.fullProfile",
+      "effect": "read",
+      "dryRunFirst": false,
       "confirm": false,
       "requiredArgs": [
-        "data"
+        "id"
       ],
       "tier": "extended",
       "reachable": true,
@@ -18525,270 +17811,77 @@
       "reachable": true,
       "reach": "dedicated tool",
       "reachReason": null,
-      "boundedAlternative": null
-    },
-    {
-      "operation": "invoices.customRange",
-      "core": false,
-      "tool": "autotask_invoice_customRange",
-      "purpose": "Get invoices for an explicit invoiceDateTime range.",
-      "preferredWhen": null,
-      "backingOperation": "invoices.customRange",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [
-        "from",
-        "to"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
-    {
-      "operation": "invoices.get",
-      "core": false,
-      "tool": "autotask_invoice_get",
-      "purpose": "Get one Invoice by id.",
-      "preferredWhen": "Preferred when the numeric id is already known; invoices.resolve is for a field value.",
-      "backingOperation": "invoices.get",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [
-        "id"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
-    {
-      "operation": "invoices.getEntityInfo",
-      "core": false,
-      "tool": null,
-      "purpose": "Get the Invoice capability metadata (canCreate/canUpdate/hasUserDefinedFields/...).",
-      "preferredWhen": null,
-      "backingOperation": "invoices.getEntityInfo",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
-      "reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
-      "boundedAlternative": null
-    },
-    {
-      "operation": "invoices.getFieldInfo",
-      "core": false,
-      "tool": null,
-      "purpose": "Get the Invoice field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
-      "preferredWhen": null,
-      "backingOperation": "invoices.getFieldInfo",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
-      "reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
-      "boundedAlternative": null
-    },
-    {
-      "operation": "invoices.getUdfInfo",
-      "core": false,
-      "tool": null,
-      "purpose": "Get the Invoice user-defined-field catalog.",
-      "preferredWhen": null,
-      "backingOperation": "invoices.getUdfInfo",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
-      "reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
-      "boundedAlternative": null
-    },
-    {
-      "operation": "invoices.last14",
-      "core": false,
-      "tool": "autotask_invoice_last14",
-      "purpose": "Get invoices for the last 14 days (rolling, invoiceDateTime).",
-      "preferredWhen": null,
-      "backingOperation": "invoices.last14",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
-    {
-      "operation": "invoices.last24h",
-      "core": false,
-      "tool": "autotask_invoice_last24h",
-      "purpose": "Get invoices for the last 24 hours (rolling, invoiceDateTime).",
-      "preferredWhen": null,
-      "backingOperation": "invoices.last24h",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
-    {
-      "operation": "invoices.last30",
-      "core": false,
-      "tool": "autotask_invoice_last30",
-      "purpose": "Get invoices for the last 30 days (rolling, invoiceDateTime).",
-      "preferredWhen": null,
-      "backingOperation": "invoices.last30",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
-    {
-      "operation": "invoices.last7",
-      "core": false,
-      "tool": "autotask_invoice_last7",
-      "purpose": "Get invoices for the last 7 days (rolling, invoiceDateTime).",
-      "preferredWhen": null,
-      "backingOperation": "invoices.last7",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
-    {
-      "operation": "invoices.last90",
-      "core": false,
-      "tool": "autotask_invoice_last90",
-      "purpose": "Get invoices for the last 90 days (rolling, invoiceDateTime).",
-      "preferredWhen": null,
-      "backingOperation": "invoices.last90",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
+      "boundedAlternative": null
     },
     {
-      "operation": "invoices.lastFullFortnight",
+      "operation": "invoices.get",
       "core": false,
-      "tool": "autotask_invoice_lastFullFortnight",
-      "purpose": "Get invoices for the last complete fortnight (invoiceDateTime).",
-      "preferredWhen": null,
-      "backingOperation": "invoices.lastFullFortnight",
+      "tool": "autotask_invoice_get",
+      "purpose": "Get one Invoice by id.",
+      "preferredWhen": "Preferred when the numeric id is already known; invoices.resolve is for a field value.",
+      "backingOperation": "invoices.get",
       "effect": "read",
       "dryRunFirst": false,
       "confirm": false,
-      "requiredArgs": [],
+      "requiredArgs": [
+        "id"
+      ],
       "tier": "extended",
       "reachable": true,
       "reach": "dedicated tool",
       "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
+      "boundedAlternative": null
     },
     {
-      "operation": "invoices.lastFullMonth",
+      "operation": "invoices.getEntityInfo",
       "core": false,
-      "tool": "autotask_invoice_lastFullMonth",
-      "purpose": "Get invoices for the last complete calendar month (invoiceDateTime).",
+      "tool": null,
+      "purpose": "Get the Invoice capability metadata (canCreate/canUpdate/hasUserDefinedFields/...).",
       "preferredWhen": null,
-      "backingOperation": "invoices.lastFullMonth",
+      "backingOperation": "invoices.getEntityInfo",
       "effect": "read",
       "dryRunFirst": false,
       "confirm": false,
       "requiredArgs": [],
       "tier": "extended",
       "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
+      "reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
+      "reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
+      "boundedAlternative": null
     },
     {
-      "operation": "invoices.lastFullQuarter",
+      "operation": "invoices.getFieldInfo",
       "core": false,
-      "tool": "autotask_invoice_lastFullQuarter",
-      "purpose": "Get invoices for the last complete calendar quarter (invoiceDateTime).",
+      "tool": null,
+      "purpose": "Get the Invoice field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
       "preferredWhen": null,
-      "backingOperation": "invoices.lastFullQuarter",
+      "backingOperation": "invoices.getFieldInfo",
       "effect": "read",
       "dryRunFirst": false,
       "confirm": false,
       "requiredArgs": [],
       "tier": "extended",
       "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
+      "reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
+      "reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
+      "boundedAlternative": null
     },
     {
-      "operation": "invoices.lastFullWeek",
+      "operation": "invoices.getUdfInfo",
       "core": false,
-      "tool": "autotask_invoice_lastFullWeek",
-      "purpose": "Get invoices for the last complete ISO week (invoiceDateTime).",
+      "tool": null,
+      "purpose": "Get the Invoice user-defined-field catalog.",
       "preferredWhen": null,
-      "backingOperation": "invoices.lastFullWeek",
+      "backingOperation": "invoices.getUdfInfo",
       "effect": "read",
       "dryRunFirst": false,
       "confirm": false,
       "requiredArgs": [],
       "tier": "extended",
       "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
+      "reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
+      "reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
+      "boundedAlternative": null
     },
     {
       "operation": "invoices.markupHtml",
@@ -18883,25 +17976,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "invoices.today",
-      "core": false,
-      "tool": "autotask_invoice_today",
-      "purpose": "Get invoices for today (invoiceDateTime = now, server date).",
-      "preferredWhen": null,
-      "backingOperation": "invoices.today",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
     {
       "operation": "invoices.update",
       "core": false,
@@ -18922,25 +17996,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "invoices.yesterday",
-      "core": false,
-      "tool": "autotask_invoice_yesterday",
-      "purpose": "Get invoices for yesterday (invoiceDateTime = previous server day).",
-      "preferredWhen": null,
-      "backingOperation": "invoices.yesterday",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null,
-      "hidden": true,
-      "hiddenReason": "date-window helper (one date field, no company/contract scope): hidden from default results — prefer <resource>.query with a date filter or operations.aggregate; still callable by exact key"
-    },
     {
       "operation": "opportunities.count",
       "core": false,
@@ -18977,25 +18032,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "opportunities.createIfNotExists",
-      "core": false,
-      "tool": "autotask_opportunity_create_if_not_exists",
-      "purpose": "Create an Opportunity.",
-      "preferredWhen": null,
-      "backingOperation": "opportunities.createIfNotExists",
-      "effect": "write",
-      "dryRunFirst": true,
-      "confirm": false,
-      "requiredArgs": [
-        "data"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
     {
       "operation": "opportunities.get",
       "core": false,
@@ -19508,26 +18544,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "project_charges.createIfNotExists",
-      "core": false,
-      "tool": "autotask_projectCharge_create_if_not_exists",
-      "purpose": "Create a ProjectCharge.",
-      "preferredWhen": null,
-      "backingOperation": "project_charges.createIfNotExists",
-      "effect": "write",
-      "dryRunFirst": true,
-      "confirm": false,
-      "requiredArgs": [
-        "parentId",
-        "data"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
     {
       "operation": "project_charges.delete",
       "core": false,
@@ -20607,6 +19623,25 @@
       "reachReason": null,
       "boundedAlternative": null
     },
+    {
+      "operation": "quotes.withItems",
+      "core": false,
+      "tool": "autotask_quote_with_items",
+      "purpose": "Get a quote with its line items in a single call — the items part is the bounded quoteID-filtered query.",
+      "preferredWhen": "The single read for \"get me this quote with its items\" — replaces the get + the quoteID-filtered items query with one call (the invoice-export workflow's first read).",
+      "backingOperation": "quotes.withItems",
+      "effect": "read",
+      "dryRunFirst": false,
+      "confirm": false,
+      "requiredArgs": [
+        "id"
+      ],
+      "tier": "extended",
+      "reachable": true,
+      "reach": "dedicated tool",
+      "reachReason": null,
+      "boundedAlternative": null
+    },
     {
       "operation": "subscriptions.count",
       "core": false,
@@ -21173,26 +20208,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "ticket_additional_configuration_items.createIfNotExists",
-      "core": false,
-      "tool": "autotask_ticketAdditionalConfigurationItem_create_if_not_exists",
-      "purpose": "Create a TicketAdditionalConfigurationItem.",
-      "preferredWhen": null,
-      "backingOperation": "ticket_additional_configuration_items.createIfNotExists",
-      "effect": "write",
-      "dryRunFirst": true,
-      "confirm": false,
-      "requiredArgs": [
-        "parentId",
-        "data"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
     {
       "operation": "ticket_additional_configuration_items.delete",
       "core": false,
@@ -21357,26 +20372,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "ticket_additional_contacts.createIfNotExists",
-      "core": false,
-      "tool": "autotask_ticketAdditionalContact_create_if_not_exists",
-      "purpose": "Create a TicketAdditionalContact.",
-      "preferredWhen": null,
-      "backingOperation": "ticket_additional_contacts.createIfNotExists",
-      "effect": "write",
-      "dryRunFirst": true,
-      "confirm": false,
-      "requiredArgs": [
-        "parentId",
-        "data"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
     {
       "operation": "ticket_additional_contacts.delete",
       "core": false,
@@ -21889,26 +20884,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "ticket_charges.createIfNotExists",
-      "core": false,
-      "tool": "autotask_ticketCharge_create_if_not_exists",
-      "purpose": "Create a TicketCharge.",
-      "preferredWhen": null,
-      "backingOperation": "ticket_charges.createIfNotExists",
-      "effect": "write",
-      "dryRunFirst": true,
-      "confirm": false,
-      "requiredArgs": [
-        "parentId",
-        "data"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
     {
       "operation": "ticket_charges.delete",
       "core": false,
@@ -23141,25 +22116,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "tickets.openWithNoteAndAssign",
-      "core": false,
-      "tool": "autotask_ticket_open_with_note_and_assign",
-      "purpose": "Open a ticket with an optional first scoped note and an optional assignment in ONE op — the node absorbs the ww29-proven create contract and the note/assignment wire choreography (6 calls today → 1).",
-      "preferredWhen": "The one-call 'open a ticket' for agents: the raw tickets.create + ticket_notes.create + tickets.update choreography (describe×3 + create + note + update = 6 calls today) collapses to this (1 call; ≤5 wire). tickets.create stays the low-level escape hatch (it posts exactly the given body and lets the vendor gates surface verbatim).",
-      "backingOperation": "tickets.openWithNoteAndAssign",
-      "effect": "write",
-      "dryRunFirst": true,
-      "confirm": false,
-      "requiredArgs": [
-        "params"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
     {
       "operation": "tickets.query",
       "core": false,
@@ -23329,23 +22285,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "operations.blindSurfaces",
-      "core": false,
-      "tool": "autotask_blind_surfaces",
-      "purpose": "Answer 'can this tenant/see this table at all?' in one ZERO-wire call: the plan-pinned blind-surface inventory over the 116 query-able surfaces — which read ops are affected per resource, the blind class, the unfiltered row count the discovery sweep observed, the authority op, and the proof level — with the data-full set, the artifact counts, and the remedies.",
-      "preferredWhen": "Before planning any unfiltered read on a table that has returned 0 rows: check the inventory first (free) instead of re-discovering the blindness one empty result at a time. The 6 pinned surfaces keep their typed sentinel (byte-identical wording); this inventory is the WIDER discovery set. For a live re-check on this tenant use operations.probeReachability (caller-opted, capped).",
-      "backingOperation": "operations.blindSurfaces",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
     {
       "operation": "operations.createGuidance",
       "core": false,
@@ -23387,7 +22326,7 @@
       "core": false,
       "tool": "autotask_fetch_by_ids",
       "purpose": "Fetch up to 500 single records by id across mixed resources in one call (query-first chunked id-in reads with a per-id get fallback), with per-item typed results.",
-      "preferredWhen": "The default for 'fetch these N known ids in one shot' when N is 20..500 (mixed resources OK — fetchMany is the <=20 single-record GET batch). Wire cost: per resource ceil(uniqueIds/250) query calls + one get per query-missed id — a clean 500-id single-resource batch is 2 wire; a blind-surface worst case is 2 + up to 500 gets (fetchMany parity, never worse). For string identifiers (names, emails, serials) use operations.resolveAny; for a filtered set use the resource's bounded query op.",
+      "preferredWhen": "The default for 'fetch these N known ids in one shot' when N is 20..500 (mixed resources OK). Wire cost: per resource ceil(uniqueIds/250) query calls + one get per query-missed id — a clean 500-id single-resource batch is 2 wire; a blind-surface worst case is 2 + up to 500 gets. For string identifiers (names, emails, serials) use operations.resolveAny; for a filtered set use the resource's bounded query op.",
       "backingOperation": "operations.fetchByIds",
       "effect": "read",
       "dryRunFirst": false,
@@ -23401,25 +22340,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "operations.fetchMany",
-      "core": false,
-      "tool": "autotask_fetch_many",
-      "purpose": "Fetch up to 20 single records across mixed resources in one call (tickets + projects + companies in a single batch), with per-item typed results.",
-      "preferredWhen": "The default for 'fetch these N known ids in one shot' (mixed resources OK). For MORE than 20 records use operations.fetchByIds (up to 500 ids, mixed resources) or the resource's bounded query op (filtered sets). For string identifiers (names, emails, serials) use operations.resolveAny.",
-      "backingOperation": "operations.fetchMany",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [
-        "items"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
     {
       "operation": "operations.fieldCatalog",
       "core": false,
@@ -23437,42 +22357,6 @@
       "reachReason": null,
       "boundedAlternative": null
     },
-    {
-      "operation": "operations.probeReachability",
-      "core": false,
-      "tool": "autotask_probe_reachability",
-      "purpose": "Re-run the blind-surface discovery live, on this tenant, in one bounded caller-opted call: one read query per named surface, hard-capped, with per-surface failures recorded instead of aborting — the operator's once-per-tenant answer to 'which of these tables does this user actually see?'.",
-      "preferredWhen": "Once per tenant, after a batch of unfiltered reads returned surprising 0 rows: re-discover the visibility boundary live (the pinned inventory is the ww29 discovery artifact — a different tenant needs its own sweep). The op is deliberately expensive, so it is opt-in (confirmProbe) and hard-capped; never automatic, never on client construction.",
-      "backingOperation": "operations.probeReachability",
-      "effect": "read",
-      "dryRunFirst": false,
-      "confirm": false,
-      "requiredArgs": [],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
-    {
-      "operation": "operations.recovery",
-      "core": false,
-      "tool": "autotask_recovery",
-      "purpose": "Find (and, where the vendor allows, delete) the record a write just created, in one typed call — the bounded, marker-filtered recovery path for tenants where created scratch records would otherwise become permanent residue.",
-      "preferredWhen": "After any create on a resource the plan stamps with the delete boundary (metadata.deleteBoundary — the create dry run warns with it): the write succeeded but the vendor cannot undo it, and the id was lost or needs cleanup. Prefer finding by the marker the write itself stamped (deterministic) — never by guessing ids.",
-      "backingOperation": "operations.recovery",
-      "effect": "write",
-      "dryRunFirst": true,
-      "confirm": false,
-      "requiredArgs": [
-        "input"
-      ],
-      "tier": "extended",
-      "reachable": true,
-      "reach": "dedicated tool",
-      "reachReason": null,
-      "boundedAlternative": null
-    },
     {
       "operation": "operations.relationshipMap",
       "core": false,
@@ -23511,11 +22395,30 @@
       "reachReason": null,
       "boundedAlternative": null
     },
+    {
+      "operation": "operations.resolveStaff",
+      "core": false,
+      "tool": "autotask_resolve_staff",
+      "purpose": "Resolve staff with tenant-labelled API-user exclusions and honest metadata state.",
+      "preferredWhen": "Resolve an owner or technician by email, username or name; use numeric id for an exact Resource fetch regardless of active/licence status.",
+      "backingOperation": "operations.resolveStaff",
+      "effect": "read",
+      "dryRunFirst": false,
+      "confirm": false,
+      "requiredArgs": [
+        "identifier"
+      ],
+      "tier": "extended",
+      "reachable": true,
+      "reach": "dedicated tool",
+      "reachReason": null,
+      "boundedAlternative": null
+    },
     {
       "operation": "operations.revenueRollup",
       "core": false,
       "tool": "autotask_revenue_rollup",
-      "purpose": "Total revenue grouped by account vertical, contract type, category, company, contract, month, billing-item kind, line of business, technician or billing code over an invoice-date window, in one budgeted call with totals, excluded buckets, a reconciliation and optional non-chargeable work.",
+      "purpose": "Total revenue grouped by account vertical, contract type, company, contract, month or line of business over an invoice-date window, in one budgeted call with totals, excluded buckets, a reconciliation and optional non-chargeable work.",
       "preferredWhen": "For any revenue-by-dimension question over a period (by vertical, contract type, customer, month); instead of walking invoices and billing_items by hand or via operations.aggregate (which caps at 2,500 rows, drops groups past top and has no join)",
       "backingOperation": "operations.revenueRollup",
       "effect": "read",
@@ -23588,10 +22491,10 @@
     }
   ],
   "counts": {
-    "registryOperations": 1281,
+    "registryOperations": 1224,
     "coreOperations": 10,
-    "catalogRows": 1281,
-    "withTool": 897,
+    "catalogRows": 1224,
+    "withTool": 840,
     "readModeOnly": 384,
     "neverExposed": 0,
     "metaTools": 5