node-autotask 0.43.0 → 0.45.0

package/docs/LIVE-TESTING.md

@@ -137,18 +137,16 @@ DRY-RUN-ONLY verdict (the only no-credentials path, exit 0).
 Full-sweep budget (worst case, every table non-empty — the machine-readable
 number is the report's `budget` block): PLAN-HONEST 1016 bounded op calls
 (every read/helper row = at most ONE bounded call — reads use
-`queryBounded` limit 2, a TOTAL cap; the served-artifact rows —
-operations.blindSurfaces (issue #11), operations.createGuidance (issue
-#12) — plan the op call at ZERO wire, but still count as one op call in
+`queryBounded` limit 2, a TOTAL cap; the served-artifact row —
+operations.createGuidance (issue #12) — plans the op call at ZERO wire,
+but still counts as one op call in
 this number: the budget counts ROW calls, not raw wire, so the 1016 is the
 conservative row-based figure)
 + <=82 best-effort update diff GETs
 + <=129 cached limit-1 id reads (one per resource; the parent chain shares
 the cache) = <= 1227. WIRE-HONEST: the dry-run verification reads ride on
 top — 54 delete current-record GETs + 63 scoped-create parent-verify GETs
-+ 20 getContext part GETs + <=18 special-op reads (incl. the issue #9
-`operations.recovery` dry-run find — ONE bounded query, zero mutating
-wire) = <=155 — so the worst case is <= 1382 raw wire requests. The 1600
++ 20 getContext part GETs + <=18 special-op reads = <=155 — so the worst case is <= 1382 raw wire requests. The 1600
 --max-calls cap bounds the row-based plan (actualCalls <= 1227); the wire
 count cannot exceed plan + the stated verification set (and 1382 is far
 under the API's 10k req/hour). ZERO mutating requests: every mutation travels

package/docs/N8N-ADAPTER.md

@@ -36,12 +36,12 @@ Two sources in, markdown table out: the node repo (the ops column is re-derived
 |----------|-----------|---------------|---------------------------|------------------|----------------------------------|
 | `appointments` | Appointment | no | create, delete, get, getMany, update, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
 | `billingCodes` | BillingCode | no | get, getMany, count | — | count, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search |
-| `billingItems` | BillingItems | no | update, get, getMany, count | — | count, customRange, get, getEntityInfo, getFieldInfo, getUdfInfo, last14, last24h, last30, last7, last90, lastFullFortnight, lastFullMonth, lastFullQuarter, lastFullWeek, query, resolve, today, update, yesterday |
-| `changeRequestLinks` | ChangeRequestLink | no | create, createIfNotExists, delete, get, getMany, count | createIfNotExists → `change_request_links.createIfNotExists` | count, create, createIfNotExists, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
+| `billingItems` | BillingItems | no | update, get, getMany, count | — | count, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
+| `changeRequestLinks` | ChangeRequestLink | no | create, createIfNotExists, delete, get, getMany, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
 | `checklistLibraries` | ChecklistLibrary | no | create, update, delete, get, getMany, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
 | `checklistLibraryChecklistItems` | ChecklistLibraryChecklistItem | yes | create, update, delete, get, getMany, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
 | `classificationIcons` | ClassificationIcon | no | get, getMany, count | — | count, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search |
-| `companies` | Company | no | create, update, get, getMany, count, searchByIdentity, searchByDomain | searchByDomain → `companies.searchByDomain`; searchByIdentity → `companies.searchByIdentity` | count, create, fullProfile, get, getContext, getEntityInfo, getFieldInfo, getUdfInfo, prepareCrmWrite, query, resolve, search, searchByDomain, searchByIdentity, unbilledWork, update, upsertByName |
+| `companies` | Company | no | create, update, get, getMany, count, searchByIdentity, searchByDomain | searchByDomain → `companies.searchByDomain`; searchByIdentity → `companies.searchByIdentity` | count, create, fullProfile, get, getContext, getEntityInfo, getFieldInfo, getUdfInfo, prepareCrmWrite, query, resolve, search, searchByDomain, searchByIdentity, unbilledWork, update |
 | `companyAlerts` | CompanyAlert | yes | create, update, delete, get, getMany, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
 | `companyLocations` | CompanyLocation | yes | create, get, getMany, update, delete, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
 | `companyNotes` | CompanyNote | yes | create, update, get, getMany, count | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
@@ -56,15 +56,15 @@ Two sources in, markdown table out: the node repo (the ops column is re-derived
 | `configurationItemSslSubjectAlternativeNames` | ConfigurationItemSslSubjectAlternativeName | yes | update, get, getMany, delete, count | — | count, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
 | `configurationItemTypes` | ConfigurationItemType | no | create, update, get, getMany, delete, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
 | `configurationItemWebhooks` | ConfigurationItemWebhook | yes | get, getMany, delete | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
-| `configurationItems` | ConfigurationItem | no | create, update, get, getMany, count, moveConfigurationItem, createIfNotExists | createIfNotExists → `configuration_items.createIfNotExists`; moveConfigurationItem → `configuration_items.moveConfigurationItem` | count, create, createIfNotExists, findBySerial, get, getContext, getEntityInfo, getFieldInfo, getUdfInfo, moveConfigurationItem, profile, query, resolve, search, update |
+| `configurationItems` | ConfigurationItem | no | create, update, get, getMany, count, moveConfigurationItem, createIfNotExists | moveConfigurationItem → `configuration_items.moveConfigurationItem` | count, create, findBySerial, get, getContext, getEntityInfo, getFieldInfo, getUdfInfo, moveConfigurationItem, profile, query, resolve, search, update |
 | `contactGroupContacts` | ContactGroupContacts | no | create, get, getMany, delete, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
 | `contactGroups` | ContactGroups | no | create, update, get, getMany, delete, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
 | `contactWebhooks` | ContactWebhook | yes | get, getMany, delete | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
-| `contacts` | Contact | yes | create, get, getMany, update, count, delete, moveToCompany | moveToCompany → `contacts.moveToCompany` | count, create, delete, findByEmail, get, getContext, getEntityInfo, getFieldInfo, getUdfInfo, moveToCompany, query, resolve, search, update, upsertByEmail |
+| `contacts` | Contact | yes | create, get, getMany, update, count, delete, moveToCompany | moveToCompany → `contacts.moveToCompany` | count, create, delete, findByEmail, fullProfile, get, getContext, getEntityInfo, getFieldInfo, getUdfInfo, moveToCompany, query, resolve, search, update |
 | `contractBillingRules` | ContractBillingRule | yes | create, update, get, getMany, count, delete | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
 | `contractBlockHourFactors` | ContractBlockHourFactor | yes | create, update, get, getMany, count | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
 | `contractBlocks` | ContractBlock | yes | create, update, get, getMany, count | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
-| `contractCharges` | ContractCharge | yes | create, createIfNotExists, update, delete, get, getMany, count | createIfNotExists → `contract_charges.createIfNotExists` | count, create, createIfNotExists, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
+| `contractCharges` | ContractCharge | yes | create, createIfNotExists, update, delete, get, getMany, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
 | `contractExclusionBillingCodes` | ContractExclusionBillingCode | yes | create, get, getMany, count, delete | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
 | `contractExclusionRoles` | ContractExclusionRoles | yes | create, get, getMany, count, delete | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
 | `contractExclusionSetExcludedRoles` | ContractExclusionSetExcludedRoles | yes | create, get, getMany, count, delete | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
@@ -80,25 +80,25 @@ Two sources in, markdown table out: the node repo (the ops column is re-derived
 | `contractServiceBundleUnits` | ContractServiceBundleUnit | yes | get, getMany, count | — | count, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
 | `contractServiceBundles` | ContractServiceBundle | yes | create, update, get, getMany, count | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
 | `contractServiceUnits` | ContractServiceUnit | yes | get, getMany, count | — | count, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
-| `contractServices` | ContractService | yes | create, update, get, getMany, count, createIfNotExists | createIfNotExists → `contract_services.createIfNotExists` | count, create, createIfNotExists, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
+| `contractServices` | ContractService | yes | create, update, get, getMany, count, createIfNotExists | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
 | `contractTicketPurchases` | ContractTicketPurchases | yes | create, update, get, getMany, count | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
-| `contracts` | Contract | no | create, update, get, getMany, count, createIfNotExists | createIfNotExists → `contracts.createIfNotExists` | count, create, createIfNotExists, get, getEntityInfo, getFieldInfo, getUdfInfo, lineOfBusiness, profitability, query, resolve, search, update |
+| `contracts` | Contract | no | create, update, get, getMany, count, createIfNotExists | — | count, create, fullProfile, get, getEntityInfo, getFieldInfo, getUdfInfo, lineOfBusiness, profitability, query, resolve, search, update |
 | `countries` | Country | no | get, getMany, update, count | — | count, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
 | `departments` | Department | no | count, create, get, getMany, update | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
 | `domainRegistrar` | DomainRegistrar | no | create, update, get, getMany, count | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
 | `expenseItemAttachments` | ExpenseItemAttachment | yes | create, getMany, count, download, delete | download → `expense_item_attachments.download` | count, create, delete, download, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
-| `expenseItems` | ExpenseItem | yes | create, update, get, getMany, count, createIfNotExists | createIfNotExists → `expense_items.createIfNotExists` | count, create, createIfNotExists, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
+| `expenseItems` | ExpenseItem | yes | create, update, get, getMany, count, createIfNotExists | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
 | `expenseReports` | ExpenseReport | no | create, update, get, getMany, count | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
-| `holidaySets` | HolidaySet | no | create, update, get, getMany, delete, count, createIfNotExists | createIfNotExists → `holiday_sets.createIfNotExists` | count, create, createIfNotExists, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
-| `holidays` | Holiday | yes | create, update, get, getMany, count, delete, createIfNotExists | createIfNotExists → `holidays.createIfNotExists` | count, create, createIfNotExists, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
-| `invoices` | Invoice | no | update, get, getMany, count, pdf, markupHtml, markupXml | markupHtml → `invoices.markupHtml`; markupXml → `invoices.markupXml`; pdf → `invoices.pdf` | count, customRange, get, getEntityInfo, getFieldInfo, getUdfInfo, last14, last24h, last30, last7, last90, lastFullFortnight, lastFullMonth, lastFullQuarter, lastFullWeek, markupHtml, markupXml, pdf, query, resolve, today, update, yesterday |
+| `holidaySets` | HolidaySet | no | create, update, get, getMany, delete, count, createIfNotExists | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
+| `holidays` | Holiday | yes | create, update, get, getMany, count, delete, createIfNotExists | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
+| `invoices` | Invoice | no | update, get, getMany, count, pdf, markupHtml, markupXml | markupHtml → `invoices.markupHtml`; markupXml → `invoices.markupXml`; pdf → `invoices.pdf` | count, get, getEntityInfo, getFieldInfo, getUdfInfo, markupHtml, markupXml, pdf, query, resolve, update |
 | `notificationHistory` | NotificationHistory | no | get, getMany, count | — | count, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
-| `opportunities` | Opportunity | no | create, createIfNotExists, update, get, getMany, count | createIfNotExists → `opportunities.createIfNotExists` | count, create, createIfNotExists, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
+| `opportunities` | Opportunity | no | create, createIfNotExists, update, get, getMany, count | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
 | `opportunityAttachments` | OpportunityAttachment | yes | create, getMany, count, download, delete | download → `opportunity_attachments.download` | count, create, delete, download, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
 | `opportunityCategories` | OpportunityCategory | no | get, getMany, count, update | — | count, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
 | `productVendors` | ProductVendors | yes | create, update, get, getMany, count | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
 | `products` | Product | no | create, update, get, getMany, count | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
-| `projectCharges` | ProjectCharge | yes | create, update, delete, get, getMany, count, createIfNotExists | createIfNotExists → `project_charges.createIfNotExists` | count, create, createIfNotExists, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
+| `projectCharges` | ProjectCharge | yes | create, update, delete, get, getMany, count, createIfNotExists | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
 | `projectNotes` | ProjectNote | yes | create, update, get, getMany, count | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
 | `projectPhases` | Phase | yes | create, update, get, getMany, count | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
 | `projectTasks` | Task | yes | create, update, get, getMany, count | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
@@ -110,20 +110,20 @@ Two sources in, markdown table out: the node repo (the ops column is re-derived
 | `quoteItems` | QuoteItem | yes | create, update, get, getMany, count, delete | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
 | `quoteLocations` | QuoteLocation | yes | create, update, get, getMany, count | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
 | `quoteTemplates` | QuoteTemplate | no | get, getMany, count | — | count, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search |
-| `quotes` | Quote | no | create, update, get, getMany, count | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
+| `quotes` | Quote | no | create, update, get, getMany, count | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update, withItems |
 | `resourceRoleQueues` | ResourceRoleQueue | yes | create, update, get, getMany, count | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
 | `resourceRoles` | ResourceRole | yes | get, getMany, count | — | count, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
 | `resourceSkills` | ResourceSkill | yes | get, getMany, count, update | — | count, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
 | `resourceTimeOffAdditional` | ResourceTimeOffAdditional | yes | get, update | getByResource → `resource_time_off_additional.getByResource`; get → `resource_time_off_additional.getByResource` | getByResource, getEntityInfo, getFieldInfo, getUdfInfo, resolve, update |
 | `resourceTimeOffApprovers` | ResourceTimeOffApprover | yes | get, getMany, count | — | count, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
 | `resourceTimeOffBalances` | ResourceTimeOffBalance | yes | get, getByYear | getByResource → `resource_time_off_balances.getByResource`; getByYear → `resource_time_off_balances.getByYear` | get, getByResource, getByYear, getEntityInfo, getFieldInfo, getUdfInfo, resolve |
-| `resources` | Resource | no | get, getMany, whoAmI, transferOwnership, update, count | transferOwnership → `resources.transferOwnership`; whoAmI → `resources.whoAmI` | count, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, transferOwnership, update, whoAmI |
+| `resources` | Resource | no | get, getMany, whoAmI, transferOwnership, update, count | whoAmI → `resources.whoAmI` | count, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update, whoAmI, workload |
 | `roles` | Role | no | create, get, getMany, update | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
 | `serviceCallTaskResources` | ServiceCallTaskResource | yes | create, get, getMany, delete, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
 | `serviceCallTasks` | ServiceCallTask | yes | create, get, getMany, delete, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
 | `serviceCallTicketResources` | ServiceCallTicketResource | yes | create, get, getMany, delete, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
 | `serviceCallTickets` | ServiceCallTicket | yes | create, get, getMany, delete, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
-| `serviceCalls` | ServiceCall | no | create, update, get, getMany, delete, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
+| `serviceCalls` | ServiceCall | no | create, update, get, getMany, delete, count | — | count, create, delete, fullProfile, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
 | `serviceLevelAgreementResults` | ServiceLevelAgreementResults | no | get, getMany, count | — | count, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
 | `services` | Service | no | create, update, get, getMany, count | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
 | `skills` | Skill | no | get, getMany, count | — | count, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search |
@@ -135,13 +135,13 @@ Two sources in, markdown table out: the node repo (the ops column is re-derived
 | `tagGroups` | TagGroup | no | create, update, delete, get, getMany, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
 | `tags` | Tag | no | create, update, delete, get, getMany, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
 | `taskSecondaryResources` | TaskSecondaryResource | yes | create, delete, get, getMany, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
-| `ticketAdditionalConfigurationItems` | TicketAdditionalConfigurationItem | yes | create, createIfNotExists, delete, get, getMany, count | createIfNotExists → `ticket_additional_configuration_items.createIfNotExists` | count, create, createIfNotExists, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
-| `ticketAdditionalContacts` | TicketAdditionalContact | yes | create, createIfNotExists, delete, get, getMany, count | createIfNotExists → `ticket_additional_contacts.createIfNotExists` | count, create, createIfNotExists, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
+| `ticketAdditionalConfigurationItems` | TicketAdditionalConfigurationItem | yes | create, createIfNotExists, delete, get, getMany, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
+| `ticketAdditionalContacts` | TicketAdditionalContact | yes | create, createIfNotExists, delete, get, getMany, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
 | `ticketAttachments` | TicketAttachment | yes | create, getMany, count, download, delete | download → `ticket_attachments.download` | count, create, delete, download, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
 | `ticketCategories` | TicketCategory | no | get, getMany, update, count | — | count, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
 | `ticketCategoryFieldDefaults` | TicketCategoryFieldDefault | yes | get, getMany, count | — | count, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
 | `ticketChangeRequestApprovals` | TicketChangeRequestApproval | yes | create, delete, get, getMany, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
-| `ticketCharges` | TicketCharge | yes | create, createIfNotExists, update, delete, get, getMany, count | createIfNotExists → `ticket_charges.createIfNotExists` | count, create, createIfNotExists, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, moveToTicket, query, resolve, search, update |
+| `ticketCharges` | TicketCharge | yes | create, createIfNotExists, update, delete, get, getMany, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, moveToTicket, query, resolve, search, update |
 | `ticketChecklistItems` | TicketChecklistItem | yes | create, update, delete, get, getMany, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
 | `ticketChecklistLibraries` | TicketChecklistLibrary | yes | create | — | attachToDocument, create, getEntityInfo, getFieldInfo, getUdfInfo, resolve |
 | `ticketHistories` | TicketHistory | no | get, getMany, count | — | count, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
@@ -150,8 +150,8 @@ Two sources in, markdown table out: the node repo (the ops column is re-derived
 | `ticketNotes` | TicketNote | yes | create, update, get, getMany, count | — | count, create, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, update |
 | `ticketSecondaryResources` | TicketSecondaryResource | yes | create, delete, get, getMany, count | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
 | `ticketWebhooks` | TicketWebhook | yes | get, getMany, delete | — | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, search, update |
-| `tickets` | Ticket | no | create, get, getMany, slaHealthCheck, summary, timeline, update, count | slaHealthCheck → `tickets.slaHealthCheck`; summary → `tickets.summary`; timeline → `tickets.timeline` | changeStatus, count, create, findByTicketNumber, forResource, fullContext, get, getContext, getEntityInfo, getFieldInfo, getUdfInfo, lineOfBusiness, openWithNoteAndAssign, query, resolve, search, slaHealthCheck, statusSemantics, summary, timeline, update |
-| `timeEntries` | TimeEntry | no | create, update, get, getMany, getPosted, getUnposted, delete, count, createIfNotExists | createIfNotExists → `time_entries.createIfNotExists`; customRange → `time_entries.customRange`; getPosted → `time_entries.getPosted`; getUnposted → `time_entries.getUnposted`; last14 → `time_entries.last14`; last24h → `time_entries.last24h`; last30 → `time_entries.last30`; last7 → `time_entries.last7`; last90 → `time_entries.last90`; lastFullFortnight → `time_entries.lastFullFortnight`; lastFullMonth → `time_entries.lastFullMonth`; lastFullQuarter → `time_entries.lastFullQuarter`; lastFullWeek → `time_entries.lastFullWeek`; today → `time_entries.today`; yesterday → `time_entries.yesterday` | approve, count, create, createForResource, createIfNotExists, customRange, dateWorkedWindow, delete, get, getEntityInfo, getFieldInfo, getPosted, getUdfInfo, getUnposted, last14, last24h, last30, last7, last90, lastFullFortnight, lastFullMonth, lastFullQuarter, lastFullWeek, moveToTicket, postedWithin, query, resolve, today, update, yesterday |
+| `tickets` | Ticket | no | create, get, getMany, slaHealthCheck, summary, timeline, update, count | slaHealthCheck → `tickets.slaHealthCheck`; summary → `tickets.summary`; timeline → `tickets.timeline` | changeStatus, count, create, findByTicketNumber, forResource, fullContext, get, getContext, getEntityInfo, getFieldInfo, getUdfInfo, lineOfBusiness, query, resolve, search, slaHealthCheck, statusSemantics, summary, timeline, update |
+| `timeEntries` | TimeEntry | no | create, update, get, getMany, getPosted, getUnposted, delete, count, createIfNotExists | dateWorkedWindow → `time_entries.dateWorkedWindow`; moveToTicket → `time_entries.moveToTicket` | count, create, dateWorkedWindow, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, moveToTicket, query, resolve, update |
 | `timeEntryAttachments` | TimeEntryAttachment | yes | create, getMany, count, download, delete | download → `time_entry_attachments.download` | count, create, delete, download, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve |
 | `timeOffRequests` | TimeOffRequest | no | get, getMany, count, approve, reject | approve → `time_off_requests.approve`; reject → `time_off_requests.reject` | approve, count, get, getEntityInfo, getFieldInfo, getUdfInfo, query, reject, resolve |
 | `(none — NOT IMPLEMENTED in node)` | InventoryProduct (StockedItemsAdd/Remove/Transfer pseudo-entities) | yes |  | stockedItemsAdd → `inventory_products.stockedItemsAdd`; stockedItemsRemove → `inventory_products.stockedItemsRemove`; stockedItemsTransfer → `inventory_products.stockedItemsTransfer` | count, create, delete, get, getEntityInfo, getFieldInfo, getUdfInfo, query, resolve, stockedItemsAdd, stockedItemsRemove, stockedItemsTransfer, update |
@@ -352,10 +352,10 @@ taste**: extend or shrink it only via a recorded change to
 `code`, `category`, `retryable`, `operation`, `httpStatus`, `suggestedAction`
 (the nextAction directive — follow it), `correlationId`, the deep-redacted
 `vendorError` body (the vendor's own field-level failure text — absent when
-the error carries no body), and — when the SDK attached extras (issue #9/#14:
-the typed `emptyReason` / `pointerNote` on a plan-pinned op's failure, the
-recovery refusal `candidateIds`) — `details` (passed through verbatim;
-absent on unpinned surfaces). A string `vendorError` / `details.bodySnippet`
+the error carries no body), and — when the SDK attached extras (issue
+#13/#14: the typed `emptyReason` / `pointerNote` on a plan-pinned op's
+failure, the #13 shape-drift `candidateIds` refusal) — `details` (passed
+through verbatim; absent on unpinned surfaces). A string `vendorError` / `details.bodySnippet`
 body is host-sourced free text: when the untrusted-content projection is on
 it is served wrapped in `<untrusted_content>` (the wrapper marks DATA, never
 instructions); a parsed (non-string) `vendorError` body is the redacted copy

package/examples/mcp/schemas.ts

@@ -160,6 +160,8 @@ export function hitsOutput(): z.ZodType {
 /** `resolveAny`: one outcome per requested resource; misses do not throw. */
 export function resolveAnyOutput(): z.ZodType {
   return z.object({
+    matched: z.enum(['exact', 'contains']),
+    contains: hitsOutput().optional(),
     identifier: z.union([z.string(), z.number()]),
     results: z.array(
       crossDataField('Per-resource outcome: value (compact or null), resolutionCost, scanned, candidates/error on a miss.'),

package/examples/mcp/tools-read.ts

@@ -84,7 +84,7 @@ export function registerReadTools({ server, client, dry, untrustedWrap }: ToolCo
   // R3 — find a record it cannot name.
   registerCoreRead(
     coreSpec('autotask_resolve_any')!,
-    z.object({ identifier: IDENTIFIER, resources: RESOURCES }),
+    z.object({ identifier: IDENTIFIER, resources: RESOURCES, match: z.enum(['exact', 'auto']).optional(), limit: z.number().int().min(1).max(500).optional() }),
     resolveAnyOutput,
     (v) => `${(v as { matches: string[] }).matches.length} resource(s) matched the identifier.`,
   );
@@ -163,6 +163,7 @@ export function projectUntrustedResult(opId: string, value: unknown, fields: rea
     case 'operations.resolveAny':
       return {
         ...v,
+        ...(v.contains === undefined ? {} : { contains: projectUntrustedResult('operations.searchAcrossResources', v.contains, fields) }),
         results: (Array.isArray(v.results) ? v.results : []).map((row) =>
           row !== null && typeof row === 'object' && !Array.isArray(row) && 'value' in row
             ? { ...(row as Record<string, unknown>), value: deepMarkUntrusted((row as Record<string, unknown>).value, fields) }
@@ -212,7 +213,7 @@ export async function coreReadCall(client: AutotaskClient, opId: string, args: R
     case 'threshold_information.get':
       return { model: await client.thresholdInformation.get() };
     case 'operations.resolveAny':
-      return resolveAny(client, args.identifier as number | string, { resources: args.resources as string[] | undefined });
+      return resolveAny(client, args.identifier as number | string, { resources: args.resources as string[] | undefined, match: args.match as 'exact' | 'auto' | undefined, limit: args.limit as number | undefined });
     case 'operations.searchAcrossResources':
       return searchAcrossResources(client, args.query as string, {
         resources: args.resources as string[] | undefined,

package/n8n-mcp.curation.json

@@ -45,15 +45,15 @@
       "entity": "resource",
       "apiEntity": "resources",
       "included": true,
-      "reason": "The staff side: the resource the credentials act as (whoAmI) and staff lookup (get/query/count/resolve/search), plus resource update and the approval-gated ownership transfer.",
+      "reason": "The staff side: the resource the credentials act as (whoAmI) and staff lookup (get/query/count/resolve/search), plus resource update.",
       "excludeDestructive": true,
-      "notes": "resources.transferOwnership is approval-gated (requiresApproval) \u2014 it stays in the write tool with its confirm rule; no destructive operations for resources."
+      "notes": "No approval-gated operations for resources remain (the transferOwnership ownership transfer was cut in #292); no destructive operations for resources."
     },
     {
       "entity": "timeEntry",
       "apiEntity": "time_entries",
       "included": true,
-      "reason": "The effort side: time entries logged against tickets \u2014 create/update (incl. createIfNotExists) and the bounded window reads (today/last7/last30/last90/last24h/customRange, posted/unposted).",
+      "reason": "The effort side: time entries logged against tickets \u2014 create/update and the posted-state window read (dateWorkedWindow: the inclusive dateWorked window with the posted/unposted split from the billing-item join).",
       "excludeDestructive": true,
       "notes": "time_entries.delete (destructive, confirm-gated) is excluded from the consumer surface by default; listed available-via-SDK-server."
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-autotask",
-  "version": "0.43.0",
+  "version": "0.45.0",
   "description": "Fully-typed TypeScript SDK for the Autotask (Datto) PSA REST API. Zero runtime dependencies. Built for building MCP servers and integrations.",
   "type": "module",
   "sideEffects": false,
@@ -161,18 +161,19 @@
   },
   "homepage": "https://github.com/msoukhomlinov/node-autotask#readme",
   "devDependencies": {
-    "@eslint/js": "^9.17.0",
+    "@eslint/js": "^10.0.1",
     "@modelcontextprotocol/server": "^2.2.0",
-    "@types/node": "^22.10.0",
-    "@vitest/coverage-v8": "^4.1.12",
-    "eslint": "^9.17.0",
-    "globals": "^15.14.0",
+    "@types/node": "^26.6.6",
+    "@vitest/coverage-v8": "^5.0.5",
+    "eslint": "^10.13.0",
+    "globals": "^17.13.0",
     "rimraf": "^6.0.1",
-    "tsup": "^8.3.0",
+    "tsup": "^9.0.0",
     "tsx": "^4.23.15",
-    "typescript": "^5.7.0",
+    "typescript": "^6.0.3",
     "typescript-eslint": "^8.18.0",
-    "vitest": "^4.1.12",
+    "vite": "^8.3.5",
+    "vitest": "^5.0.5",
     "zod": "^4.4.3"
   },
   "overrides": {