node-autotask 0.10.0 → 0.12.0

package/docs/API.md

@@ -847,7 +847,7 @@ be cross-mode-refused.
 whose MCP annotation is `readOnlyHint !== true` — today exactly **254
 tools**: the 252 dedicated write/delete tools (198 `effect=write` + 54
 `effect=destructive`, every one of them has a dedicated tool) +
-`autotask_write` + `autotask_delete`. The remaining **600 tools** (the 587
+`autotask_write` + `autotask_delete`. The remaining **601 tools** (the 588
 dedicated read tools + the 10 core read tools + `autotask_read` +
 `autotask_catalog` + `autotask_describe`) all carry `readOnlyHint: true`
 and are safe ungated: every op they can route is `effect=read` (zero
@@ -1145,7 +1145,7 @@ Standard methods (every resource, `BaseResource`): `query` (stream, 1000-page gu
 | `contract_service_units` | ContractServiceUnit | entity | extended | yes (contracts) | query, count, get, resolve | getEntityInfo, getFieldInfo, getUdfInfo | autotask_contractServiceUnit_get |
 | `contract_services` | ContractService | entity | extended | yes (contracts) | query, count, get, create, update, resolve | createIfNotExists, getEntityInfo, getFieldInfo, getUdfInfo | autotask_contractService_get |
 | `contract_ticket_purchases` | ContractTicketPurchases | entity | extended | yes (contracts) | query, count, get, create, update, resolve | getEntityInfo, getFieldInfo, getUdfInfo | autotask_contractTicketPurchase_get |
-| `contracts` | Contract | entity | extended | no | query, count, get, create, update, resolve, search | createIfNotExists, getEntityInfo, getFieldInfo, getUdfInfo | autotask_contract_get |
+| `contracts` | Contract | entity | extended | no | query, count, get, create, update, resolve, search | createIfNotExists, getEntityInfo, getFieldInfo, getUdfInfo, profitability | autotask_contract_get |
 | `countries` | Country | entity | advanced | no | query, count, get, update, resolve, search | getEntityInfo, getFieldInfo, getUdfInfo | autotask_country_get |
 | `departments` | Department | entity | extended | no | query, count, get, create, update, resolve, search | getEntityInfo, getFieldInfo, getUdfInfo | autotask_department_get |
 | `domain_registrars` | DomainRegistrar | entity | extended | no | query, count, get, create, update, resolve, search | getEntityInfo, getFieldInfo, getUdfInfo | autotask_DomainRegistrar_get |
@@ -2601,6 +2601,196 @@ resource's query surface is pinned blind), and `next` (concrete next steps; the
 remedy names the authority op). Hit paths carry no `miss` key. Thrown outcomes
 (`NOT_FOUND` by numeric id, `RESOLUTION_AMBIGUOUS`, `RESOLUTION_TRUNCATED`) are unchanged.
 
+### 11.26 The contract P&L composite — `contracts.profitability` (issue #100)
+
+Issue #100 adds the contract profit-and-loss composite op (an additive read;
+the plan change — a new registry op — is a minor at publish). One call
+returns the contract's reconciled P&L over a date window:
+
+- **`contracts.profitability(contractId, opts)` — the closed opts bag.**
+  `dateFrom`/`dateTo` are required (`YYYY-MM-DD`, `dateTo >= dateFrom`) and
+  the window is capped at 36 calendar months (the per-month windowing budget
+  stays bounded; OQ1). `labourCostMethod` (default
+  `billing_item_our_cost`; the closed 4-set
+  `billing_item_our_cost` / `contract_role_cost` / `resource_internal_cost` /
+  `provided`) selects the START rung of the cost-rate ladder;
+  `labourRatePerHour` (finite `>= 0`) is the `provided` catch-all rung and is
+  REQUIRED when `labourCostMethod` is `provided`. `includeRecurringCosts` /
+  `includeUnbilledRevenue` (default true) gate the charges/units folds and
+  the expected-revenue basis; `externalMonthlyCosts` (finite `>= 0`, indexed
+  by month from `dateFrom`, at most one entry per window month) is the
+  caller-supplied non-vendor tooling cost, surfaced in
+  `tooling_cost.caller_supplied` (stamped non-vendor — never folded into the
+  vendor figure); `groupByActivity` (default true) gates the
+  `ticketCategory` activity fold; `staleAfterDays` (default 30, integer `>=
+  1`) is the open-stale horizon; `maxTicketsForJoin` (default 500, integer
+  1..500) caps the ticket join set fed to the expenses + miscoding probe
+  (sorted, first N, the `N of M` note); `limit` (default 50, clamped 500) is
+  every part's `MaxRecords` + the capped lists. Validation collects the
+  COMPLETE problem list and throws ONE typed `CONFIG_ERROR` pre-request —
+  zero wire on any malformed bag (the refusal table is house style: every
+  message names the key + the valid values).
+- **Wire plan: ≤18 bounded reads, zero mutating, all pre-existing ops.**
+  Issue order: contract `get` → customer `GET /V1.0/Companies/{companyID}` →
+  `ContractServices` / `ContractServiceUnits` / `ContractCharges` /
+  `ContractRoleCosts` / `ContractRates` / `BillingItems` queries → invoices
+  (fetch-by-ids on the distinct billed `invoiceID`s; skipped on none) →
+  `TimeEntries` query → in-window `Tickets` query (the activity population) →
+  the tickets `entityInformation/fields` metadata read (the open-status
+  picklist) → open `Tickets` query (`status in` the open set) → resources
+  (fetch-by-ids on the distinct time-row `resourceID`s; skipped on none) →
+  `ExpenseItems` query + the ONE extra bounded miscoding probe
+  (`TimeEntries` with `ticketID in join` + `or[contractID noteq, contractID
+  notExist]`; skipped on an empty ticket set) → `ConfigurationItems` query
+  (default-on) → `Subscriptions` query (CI join; skipped on no CIs). The
+  `time_entries.getPosted` / `getUnposted` endpoints are NEVER called (the
+  pinned vendor 500 on AU03); posted/unposted derives from the
+  `billingItems.timeEntryID` join (unposted = no billing item exists yet).
+  The structural exclusions (`/Services/`, `/ExpenseReports/`,
+  `/BillingCodes/` list reads, getPosted/getUnposted) are pinned by the
+  recorded-request test. Baseline = 12 (a resolvable contract); the
+  typical busy contract = 17; the full fixture = 18. `wires: { issued,
+  budget: 18, note? }` rides the result as the honesty stamp (actual vs
+  budget).
+- **Per-month windowing (parts `billingItems` + `timeEntries`).** One
+  full-window page (`MaxRecords: limit`); when it comes back FULL with a
+  live next cursor, the part re-queries PER CALENDAR MONTH intersecting the
+  window (one page per month, the date field bounded to that month, in
+  month order; rows deduped by `id`). A still-full month stamps
+  `hasMore`/`capped` + the truncation note (`month YYYY-MM hit the limit of
+  N — figures cover the returned rows only; widen with a narrower window or
+  higher limit`) — NO cursor walk (the house single-page rule; the composite
+  owns its own windowing so per-month figures stay correct by construction).
+  Every expansion read counts toward `wires.issued` (the note says why);
+  the 36-month cap bounds the worst case.
+- **The cost-rate ladder (per time entry, zero extra wire).** Rung 1
+  `billing_item.ourCost`: a LINE cost, not a rate — Σ the finite `>= 0`
+  `ourCost` over the entry's billed lines (partial billing across months
+  sums naturally; an entry whose billed lines carry NO finite `ourCost`
+  falls THROUGH — the rung is unusable, not zero). Rung 2
+  `contract_role_costs.rate`: the `resourceID:roleID` row is preferred over
+  the role-only row (`matched: 'resource+role' | 'role'`); `rate × hours`.
+  Rung 3 `resource.internalCost`: the fetch-by-ids GET-fallback rows only
+  (a `NOT_FOUND` miss makes the rung unavailable for that resource — the
+  ww29 resources list-scoping is seen through by get-by-id, live-verified
+  2026-10-15; the quirk is cited in the part note when the chunk queries
+  0-rowed and the gets resolved). Rung 4 `provided`: `labourRatePerHour ×
+  hours` (in the ladder only when the rate is finite). `hours(entry)` =
+  `hoursWorked` when finite and `> 0`, else 0. A row resolving to
+  `missing` contributes 0 to `labour_cost.total` but is audited:
+  `costRateResolution.sources` (per-rung `entries`/`hours`/`cost`, ALWAYS
+  including `missing`), `unresolvedHours` (= the `missing` hours — the
+  lower-bound honesty number; `total_cost` is a LOWER BOUND exactly when it
+  is `> 0`), and the pinned note lines (the `N hours unresolved (missing
+  rate) — total_cost is a lower bound` line; the per-resource NOT_FOUND
+  line; the no-billing-item line). NEVER a silent zero. `contract_rates`
+  is NOT a ladder rung (the customer billing rate — the wrong side of the
+  P&L).
+- **Monthly P&L (one row per calendar month in the window).**
+  `revenue_invoiced` (Σ `extendedPrice` of the month's items on
+  non-voided invoices) · `revenue_voided_excluded` (Σ on voided invoices) ·
+  `revenue_expected` (Σ `service.unitPrice × units` of the units effective
+  in the month; `null` when the services/units basis is absent) ·
+  `revenue_expected_unbilled = max(0, expected − billed)` · `labour_hours`
+  (Σ raw `hoursWorked`) · `labour_cost { total, unresolvedHours,
+  rateSources }` (the per-month mirror of the ladder audit) ·
+  `tooling_cost { vendor, caller_supplied }` (vendor = Σ subscription
+  `periodCost` per active month in the window; `null` when the
+  subscriptions part is skipped; caller-supplied = the bag value, `0` when
+  absent) · `recurring_cost` (charges `billableAmount` + units `cost`,
+  when included) · `expense_cost` (Σ local-currency expense amounts) ·
+  `total_cost` · `profit = revenue_invoiced − total_cost` ·
+  `margin = profit / revenue_invoiced` when `> 0`, else `null` (the
+  division is refused, not zeroed) · `break_even_hours`
+  (`(total_cost − labour) / (Σcost / Σhours over resolved rows)`, `0` when
+  fixed `<= 0`, `null` with no resolved hours — including an empty month).
+  All amounts are the tenant's LOCAL currency fields
+  (`extendedPrice`, `expenseCurrencyExpenseAmount`).
+- **The 11 data-quality checks (always present, order-stable, `count: 0` =
+  a passed check).** Typed `{ code, count, sample_ids }` warnings
+  (`count` = the full in-memory/fetched-set count, never capped;
+  `sample_ids` = first `limit`, deduped + sorted): `miscoded_time_out` (the
+  ONE extra bounded probe — time worked on THIS contract's tickets coded to
+  another contract or to none) · `cross_contract_ticket_time` (a fetched
+  ticket says it belongs elsewhere) · `duplicate_entries` (exact
+  `resourceID+dateWorked+ticketID+hoursWorked` tuple; `count` = all copies,
+  samples = copies beyond the lowest `id`) · `zero_negative_hours` ·
+  `time_outside_ticket_period` (`dateWorked < ticket.createDate` or after
+  the earlier of `resolvedDateTime`/`completedDate` — a fetched ticket's
+  whole post-resolution life, not just the first late entry) ·
+  `missing_cost_rate` (the ladder's `missing` rows; the resource NOT_FOUND
+  misses ride the note) · `recurring_cost_drift` (month-over-month beyond
+  the 0.005 float dust; samples the charge/unit ids whose monthly
+  contribution changed) · `expected_unbilled_revenue` (expected >
+  billed + 0.005; the pure "expected with nothing billed" case carries the
+  EMPTY sample — that is the assertion) · `cross_contract_tickets` (the
+  ticket-side drift + the entry-side unresolvable set) ·
+  `open_stale_tickets` (`now − lastActivityDate > staleAfterDays`, `now` =
+  the run's wall clock stamped `period.asOf`; absent `lastActivityDate` is
+  unknown, not zero) · `estimate_vs_actual` (both estimates prorated to the
+  window — `estimate × overlapDays / termDays` over the contract term — and
+  flagged at `> 10%` deviation; samples `[contractId]`). 10 of 11 are pure
+  in-memory folds (zero extra wire).
+- **The response-side folds.** `activity_categories` (by `ticketCategory`:
+  hours, cost = labour + that category's expenses, ticketCount, entryCount,
+  sample ticket numbers) · `highest_cost_tickets` (cost desc, capped at
+  `limit`; a missing-rate ticket prices 0 and is flagged via the audit —
+  never silently dropped) · `possible_miscoding` (the probe rows + the
+  confirmed cross-contract entries, closed reason set
+  `no_contract_on_entry` / `ticket_of_other_contract` /
+  `ticket_not_in_fetched_set`) · `open_renewal_items` (open tickets with
+  the stale-days detail, subscription expirations, the contract end, the
+  per-month `included_hours_burn` row). The probe rows are EXCLUDED from
+  the P&L folds (diagnostic — time not coded to this contract).
+- **Degradation (per part typed `ok` / `blind` / `skipped`; the op NEVER
+  fails the call on a degraded part).** Every tickets call is
+  `contractID`-filtered, so the pinned `unfiltered-blind` tickets class
+  never stamps a filtered empty (a filtered 0 is a TRUE zero with the
+  honest note); the 0-row parts carry the pinned
+  `tenant-empty-for-user` `emptyReason` stamp where attached. A dangling
+  customer FK (`companies.get` 404) degrades to `customer: null` +
+  `parts.customer: 'skipped'` — NOT an error (the CIs read still fires on
+  the contract row's `companyID`). A field-catalog fault degrades the open
+  pass to a typed skip (the fault read still counts in `wires.issued`).
+  fetch-by-ids per-item faults (invoices/resources) are typed partial
+  misses named in the part note — a miss never aborts the rest. An empty
+  tenant (the ww29 shape) degrades EVERY part — 13 wires, all-zero monthly
+  rows with the divisions refused (`margin: null`, `break_even_hours:
+  null`, `tooling_cost.vendor: null`, `revenue_expected: null`), all 11
+  warnings at `count: 0`, zero tool failure.
+- **Registration surface.** The plan row (`capabilities.plan.json` →
+  re-derived hash) carries `kind: 'helper'`, `helperBasis: 'composite'`,
+  `effect: 'read'`, `dryRun: false`, the closed-bag `inputSchema` (the
+  signature-audited arg map in `scripts/lib/args-derive.mjs`); the emitted
+  method delegates to the hand-written special module
+  (`src/resources/special/contracts.ts`). The MCP projection serves
+  `autotask_contract_profitability` (catalog + manifest); the N8N
+  manifests legitimately EXCLUDE the op — `contracts` is not an n8n
+  curated entity (the curation rule is evidence-based: the daily support
+  subset is ticket/contact/company/resource/time_entry only).
+- **Test pins.** `test/resources/contracts.profitability.test.ts`: the
+  hand-computed 2-month synthetic fixture (every figure derived from the
+  fixture rows; `wires.issued = 18` with the exact queue; every wire pinned
+  in issue order; the structural exclusions + zero-mutating recorded paths;
+  the ladder audit incl. the per-month `rateSources`; the 11 checks with
+  exact counts/samples; the activity/highest-cost/miscoding/renewal folds;
+  the per-month windowing (exact extra month queries, id-dedup, the
+  still-full month note; `wires.issued` counts the expansion); the
+  join-set/`limit` caps; the malformed-bag refusal table (one complete
+  problem list, zero wire); the contract NOT_FOUND).
+  `test/resources/profitability-degradation.test.ts`: the empty-tenant
+  13-wire suite (every part degrades, zero tool failure), the dangling
+  customer FK, the resources blind-list get-fallback (rung 3 from the
+  gets, the quirk note), the per-item invoice fault (retries off — the
+  fault semantics are the pin, not the transport's 5xx budget), the
+  fieldCatalog-fault open-pass skip, the status-helper sentinel
+  portability (the `unfiltered-blind` predicate stamps the unfiltered call
+  only), and the §6.4 rate-ladder branch table over synthetic entry sets
+  (rung-1 line-cost sum, rung-1 fall-through, resource+role preference,
+  role-only, rung-3 get-fallback, the resource miss, the provided
+  catch-all/start, the provided-without-rate and fully-missing `missing`
+  — never a silent zero — and `internalCost: 0` as a RESOLVED zero).
+
 ## 12. Untrusted-content projection (issue #1)
 
 The agent/MCP projection marks EXTERNALLY-SOURCED free text as untrusted,

package/docs/N8N-ADAPTER.md

@@ -82,7 +82,7 @@ Two sources in, markdown table out: the node repo (the ops column is re-derived
 | `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 |
 | `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, query, resolve, search, update |
+| `contracts` | Contract | no | create, update, get, getMany, count, createIfNotExists | createIfNotExists → `contracts.createIfNotExists` | count, create, createIfNotExists, get, getEntityInfo, getFieldInfo, getUdfInfo, 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 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-autotask",
-  "version": "0.10.0",
+  "version": "0.12.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,

package/dist/{index-cQ6CRexR.d.cts → index-BXtKN1M5.d.cts}

@@ -3306,6 +3306,207 @@ type ContractServiceUnitUpdate = ContractServiceUnitCreate;
  */
 type ContractServiceUnitSummary = ContractServiceUnit;
 
+/**
+ * Invoice — API model types (G4 batch A).
+ * GENERATED by scripts/generate-batch.mjs from api-docs.json (InvoiceModel). Do not hand-edit.
+ * Field names keep the exact API casing; returned fields are optional (the vendor
+ * answers partial records) except the always-present id. Cross-model refs degrade to unknown.
+ */
+/** Invoice record as returned by the API (swagger InvoiceModel). */
+interface Invoice {
+    id: number;
+    batchID?: number;
+    comments?: string;
+    companyID?: number;
+    createDateTime?: string;
+    creatorResourceID?: number;
+    dueDate?: string;
+    fromDate?: string;
+    invoiceDateTime?: string;
+    invoiceEditorTemplateID?: number;
+    invoiceNumber?: string;
+    invoiceTotal?: number;
+    isVoided?: boolean;
+    orderNumber?: string;
+    paidDate?: string;
+    paymentTerm?: number;
+    taxGroup?: number;
+    taxRegionName?: string;
+    toDate?: string;
+    totalTaxValue?: number;
+    voidedByResourceID?: number;
+    voidedDate?: string;
+    webServiceDate?: string;
+}
+/** Create input for Invoice (writable fields; accepts id or itemId). */
+interface InvoiceCreate {
+    id?: number;
+    batchID?: number;
+    comments?: string;
+    companyID?: number;
+    createDateTime?: string;
+    creatorResourceID?: number;
+    dueDate?: string;
+    fromDate?: string;
+    invoiceDateTime?: string;
+    invoiceEditorTemplateID?: number;
+    invoiceNumber?: string;
+    invoiceTotal?: number;
+    isVoided?: boolean;
+    orderNumber?: string;
+    paidDate?: string;
+    paymentTerm?: number;
+    taxGroup?: number;
+    taxRegionName?: string;
+    toDate?: string;
+    totalTaxValue?: number;
+    voidedByResourceID?: number;
+    voidedDate?: string;
+    webServiceDate?: string;
+}
+/** Update input (same writable surface; id identifies the record in the path). */
+type InvoiceUpdate = InvoiceCreate;
+/** Compact helper shape for Invoice (resolve/search/getContext): structural alias of the
+ * full record — the registry outputSchema names the fields the MCP projection keeps.
+ */
+type InvoiceSummary = Invoice;
+
+/**
+ * ExpenseItem — API model types (G5 batch B).
+ * GENERATED by scripts/generate-batch.mjs from api-docs.json (ExpenseItemModel). Do not hand-edit.
+ * Field names keep the exact API casing; returned fields are optional (the vendor
+ * answers partial records) except the always-present id. Cross-model refs degrade to unknown.
+ */
+
+/** ExpenseItem record as returned by the API (swagger ExpenseItemModel). */
+interface ExpenseItem {
+    id: number;
+    companyID?: number;
+    description?: string;
+    destination?: string;
+    entertainmentLocation?: string;
+    expenseCategory?: number;
+    expenseCurrencyExpenseAmount?: number;
+    expenseCurrencyID?: number;
+    expenseDate?: string;
+    expenseReportID?: number;
+    glCode?: string;
+    haveReceipt?: boolean;
+    internalCurrencyExpenseAmount?: number;
+    internalCurrencyReimbursementAmount?: number;
+    isBillableToCompany?: boolean;
+    isReimbursable?: boolean;
+    isRejected?: boolean;
+    miles?: number;
+    odometerEnd?: number;
+    odometerStart?: number;
+    origin?: string;
+    paymentType?: number;
+    projectID?: number;
+    purchaseOrderNumber?: string;
+    reimbursementCurrencyReimbursementAmount?: number;
+    taskID?: number;
+    ticketID?: number;
+    workType?: number;
+    soapParentPropertyId?: unknown;
+}
+/** Create input for ExpenseItem (writable fields; accepts id or itemId). */
+interface ExpenseItemCreate {
+    id?: number;
+    companyID?: number;
+    description?: string;
+    destination?: string;
+    entertainmentLocation?: string;
+    expenseCategory?: number;
+    expenseCurrencyExpenseAmount?: number;
+    expenseCurrencyID?: number;
+    expenseDate?: string;
+    expenseReportID?: number;
+    glCode?: string;
+    haveReceipt?: boolean;
+    internalCurrencyExpenseAmount?: number;
+    internalCurrencyReimbursementAmount?: number;
+    isBillableToCompany?: boolean;
+    isReimbursable?: boolean;
+    isRejected?: boolean;
+    miles?: number;
+    odometerEnd?: number;
+    odometerStart?: number;
+    origin?: string;
+    paymentType?: number;
+    projectID?: number;
+    purchaseOrderNumber?: string;
+    reimbursementCurrencyReimbursementAmount?: number;
+    taskID?: number;
+    ticketID?: number;
+    workType?: number;
+    /** UDF map (name → value) or UdfField[] — normalised to the vendor array on the wire. */
+    userDefinedFields?: UdfField[];
+}
+/** Update input (same writable surface; id identifies the record in the path). */
+type ExpenseItemUpdate = ExpenseItemCreate;
+/** Compact helper shape for ExpenseItem (resolve/search/getContext): structural alias of the
+ * full record — the registry outputSchema names the fields the MCP projection keeps.
+ */
+type ExpenseItemSummary = ExpenseItem;
+
+/**
+ * Subscription — API model types (G4 batch A).
+ * GENERATED by scripts/generate-batch.mjs from api-docs.json (SubscriptionModel). Do not hand-edit.
+ * Field names keep the exact API casing; returned fields are optional (the vendor
+ * answers partial records) except the always-present id. Cross-model refs degrade to unknown.
+ */
+
+/** Subscription record as returned by the API (swagger SubscriptionModel). */
+interface Subscription {
+    id: number;
+    configurationItemID?: number;
+    description?: string;
+    effectiveDate?: string;
+    expirationDate?: string;
+    impersonatorCreatorResourceID?: number;
+    materialCodeID?: number;
+    organizationalLevelAssociationID?: number;
+    periodCost?: number;
+    periodPrice?: number;
+    periodType?: number;
+    purchaseOrderNumber?: string;
+    status?: number;
+    subscriptionName?: string;
+    totalCost?: number;
+    totalPrice?: number;
+    vendorID?: number;
+    userDefinedFields?: UdfField[];
+}
+/** Create input for Subscription (writable fields; accepts id or itemId). */
+interface SubscriptionCreate {
+    id?: number;
+    configurationItemID?: number;
+    description?: string;
+    effectiveDate?: string;
+    expirationDate?: string;
+    impersonatorCreatorResourceID?: number;
+    materialCodeID?: number;
+    organizationalLevelAssociationID?: number;
+    periodCost?: number;
+    periodPrice?: number;
+    periodType?: number;
+    purchaseOrderNumber?: string;
+    status?: number;
+    subscriptionName?: string;
+    totalCost?: number;
+    totalPrice?: number;
+    vendorID?: number;
+    /** UDF map (name → value) or UdfField[] — normalised to the vendor array on the wire. */
+    userDefinedFields?: UdfField[];
+}
+/** Update input (same writable surface; id identifies the record in the path). */
+type SubscriptionUpdate = SubscriptionCreate;
+/** Compact helper shape for Subscription (resolve/search/getContext): structural alias of the
+ * full record — the registry outputSchema names the fields the MCP projection keeps.
+ */
+type SubscriptionSummary = Subscription;
+
 /**
  * ContractTicketPurchases — API model types (G4 batch A).
  * GENERATED by scripts/generate-batch.mjs from api-docs.json (ContractTicketPurchaseModel). Do not hand-edit.
@@ -3517,85 +3718,6 @@ type ExpenseItemAttachmentUpdate = ExpenseItemAttachmentCreate;
  */
 type ExpenseItemAttachmentSummary = ExpenseItemAttachment;
 
-/**
- * ExpenseItem — API model types (G5 batch B).
- * GENERATED by scripts/generate-batch.mjs from api-docs.json (ExpenseItemModel). Do not hand-edit.
- * Field names keep the exact API casing; returned fields are optional (the vendor
- * answers partial records) except the always-present id. Cross-model refs degrade to unknown.
- */
-
-/** ExpenseItem record as returned by the API (swagger ExpenseItemModel). */
-interface ExpenseItem {
-    id: number;
-    companyID?: number;
-    description?: string;
-    destination?: string;
-    entertainmentLocation?: string;
-    expenseCategory?: number;
-    expenseCurrencyExpenseAmount?: number;
-    expenseCurrencyID?: number;
-    expenseDate?: string;
-    expenseReportID?: number;
-    glCode?: string;
-    haveReceipt?: boolean;
-    internalCurrencyExpenseAmount?: number;
-    internalCurrencyReimbursementAmount?: number;
-    isBillableToCompany?: boolean;
-    isReimbursable?: boolean;
-    isRejected?: boolean;
-    miles?: number;
-    odometerEnd?: number;
-    odometerStart?: number;
-    origin?: string;
-    paymentType?: number;
-    projectID?: number;
-    purchaseOrderNumber?: string;
-    reimbursementCurrencyReimbursementAmount?: number;
-    taskID?: number;
-    ticketID?: number;
-    workType?: number;
-    soapParentPropertyId?: unknown;
-}
-/** Create input for ExpenseItem (writable fields; accepts id or itemId). */
-interface ExpenseItemCreate {
-    id?: number;
-    companyID?: number;
-    description?: string;
-    destination?: string;
-    entertainmentLocation?: string;
-    expenseCategory?: number;
-    expenseCurrencyExpenseAmount?: number;
-    expenseCurrencyID?: number;
-    expenseDate?: string;
-    expenseReportID?: number;
-    glCode?: string;
-    haveReceipt?: boolean;
-    internalCurrencyExpenseAmount?: number;
-    internalCurrencyReimbursementAmount?: number;
-    isBillableToCompany?: boolean;
-    isReimbursable?: boolean;
-    isRejected?: boolean;
-    miles?: number;
-    odometerEnd?: number;
-    odometerStart?: number;
-    origin?: string;
-    paymentType?: number;
-    projectID?: number;
-    purchaseOrderNumber?: string;
-    reimbursementCurrencyReimbursementAmount?: number;
-    taskID?: number;
-    ticketID?: number;
-    workType?: number;
-    /** UDF map (name → value) or UdfField[] — normalised to the vendor array on the wire. */
-    userDefinedFields?: UdfField[];
-}
-/** Update input (same writable surface; id identifies the record in the path). */
-type ExpenseItemUpdate = ExpenseItemCreate;
-/** Compact helper shape for ExpenseItem (resolve/search/getContext): structural alias of the
- * full record — the registry outputSchema names the fields the MCP projection keeps.
- */
-type ExpenseItemSummary = ExpenseItem;
-
 /**
  * ExpenseReport — API model types (G5 batch B).
  * GENERATED by scripts/generate-batch.mjs from api-docs.json (ExpenseReportModel). Do not hand-edit.
@@ -3794,71 +3916,6 @@ interface InventoryStockedItemTransfer {
     soapParentPropertyId?: unknown;
 }
 
-/**
- * Invoice — API model types (G4 batch A).
- * GENERATED by scripts/generate-batch.mjs from api-docs.json (InvoiceModel). Do not hand-edit.
- * Field names keep the exact API casing; returned fields are optional (the vendor
- * answers partial records) except the always-present id. Cross-model refs degrade to unknown.
- */
-/** Invoice record as returned by the API (swagger InvoiceModel). */
-interface Invoice {
-    id: number;
-    batchID?: number;
-    comments?: string;
-    companyID?: number;
-    createDateTime?: string;
-    creatorResourceID?: number;
-    dueDate?: string;
-    fromDate?: string;
-    invoiceDateTime?: string;
-    invoiceEditorTemplateID?: number;
-    invoiceNumber?: string;
-    invoiceTotal?: number;
-    isVoided?: boolean;
-    orderNumber?: string;
-    paidDate?: string;
-    paymentTerm?: number;
-    taxGroup?: number;
-    taxRegionName?: string;
-    toDate?: string;
-    totalTaxValue?: number;
-    voidedByResourceID?: number;
-    voidedDate?: string;
-    webServiceDate?: string;
-}
-/** Create input for Invoice (writable fields; accepts id or itemId). */
-interface InvoiceCreate {
-    id?: number;
-    batchID?: number;
-    comments?: string;
-    companyID?: number;
-    createDateTime?: string;
-    creatorResourceID?: number;
-    dueDate?: string;
-    fromDate?: string;
-    invoiceDateTime?: string;
-    invoiceEditorTemplateID?: number;
-    invoiceNumber?: string;
-    invoiceTotal?: number;
-    isVoided?: boolean;
-    orderNumber?: string;
-    paidDate?: string;
-    paymentTerm?: number;
-    taxGroup?: number;
-    taxRegionName?: string;
-    toDate?: string;
-    totalTaxValue?: number;
-    voidedByResourceID?: number;
-    voidedDate?: string;
-    webServiceDate?: string;
-}
-/** Update input (same writable surface; id identifies the record in the path). */
-type InvoiceUpdate = InvoiceCreate;
-/** Compact helper shape for Invoice (resolve/search/getContext): structural alias of the
- * full record — the registry outputSchema names the fields the MCP projection keeps.
- */
-type InvoiceSummary = Invoice;
-
 /**
  * modules integration endpoint — raw vendor model types (G5 batch B, plan key 'modules').
  * Hand-written thin integration surface (plan kind=integration): the model is
@@ -5387,63 +5444,6 @@ type SubscriptionPeriodUpdate = SubscriptionPeriodCreate;
  */
 type SubscriptionPeriodSummary = SubscriptionPeriod;
 
-/**
- * Subscription — API model types (G4 batch A).
- * GENERATED by scripts/generate-batch.mjs from api-docs.json (SubscriptionModel). Do not hand-edit.
- * Field names keep the exact API casing; returned fields are optional (the vendor
- * answers partial records) except the always-present id. Cross-model refs degrade to unknown.
- */
-
-/** Subscription record as returned by the API (swagger SubscriptionModel). */
-interface Subscription {
-    id: number;
-    configurationItemID?: number;
-    description?: string;
-    effectiveDate?: string;
-    expirationDate?: string;
-    impersonatorCreatorResourceID?: number;
-    materialCodeID?: number;
-    organizationalLevelAssociationID?: number;
-    periodCost?: number;
-    periodPrice?: number;
-    periodType?: number;
-    purchaseOrderNumber?: string;
-    status?: number;
-    subscriptionName?: string;
-    totalCost?: number;
-    totalPrice?: number;
-    vendorID?: number;
-    userDefinedFields?: UdfField[];
-}
-/** Create input for Subscription (writable fields; accepts id or itemId). */
-interface SubscriptionCreate {
-    id?: number;
-    configurationItemID?: number;
-    description?: string;
-    effectiveDate?: string;
-    expirationDate?: string;
-    impersonatorCreatorResourceID?: number;
-    materialCodeID?: number;
-    organizationalLevelAssociationID?: number;
-    periodCost?: number;
-    periodPrice?: number;
-    periodType?: number;
-    purchaseOrderNumber?: string;
-    status?: number;
-    subscriptionName?: string;
-    totalCost?: number;
-    totalPrice?: number;
-    vendorID?: number;
-    /** UDF map (name → value) or UdfField[] — normalised to the vendor array on the wire. */
-    userDefinedFields?: UdfField[];
-}
-/** Update input (same writable surface; id identifies the record in the path). */
-type SubscriptionUpdate = SubscriptionCreate;
-/** Compact helper shape for Subscription (resolve/search/getContext): structural alias of the
- * full record — the registry outputSchema names the fields the MCP projection keeps.
- */
-type SubscriptionSummary = Subscription;
-
 /**
  * SurveyResults — API model types (G5 batch B).
  * GENERATED by scripts/generate-batch.mjs from api-docs.json (SurveyResultsModel). Do not hand-edit.