@wilnertech/halopsa-mcp-server 1.4.0 → 1.5.0

package/dist/tools/ticket-reference-data.js

@@ -2,7 +2,7 @@
  * HaloPSA Ticket Reference Data tools.
  *
  * Mirrors the existing pattern in `src/tools/reference-data.ts` for asset
- * reference data. All five tools default to compact responses (token
+ * reference data. All six tools default to compact responses (token
  * optimization) and use 1-hour cache TTLs because reference data on a
  * Halo tenant changes infrequently — most reads should hit cache.
  *
@@ -10,6 +10,13 @@
  * standard `format_options` block so callers can choose their style:
  * `{ full: true }` is the path-of-least-surprise for ad-hoc lookups,
  * while `format_options` keeps parity with the rest of the MCP surface.
+ *
+ * v1.5.0 changes:
+ *   - Bug 3 (P0): Added list_halopsa_ticket_outcomes + getOutcomeByName helper.
+ *   - Bug 6 (P1): list_halopsa_ticket_priorities now exposes slaid and accepts
+ *     optional tickettype_id for default-SLA scoping.
+ *   - Bug 7 (P1): list_halopsa_ticket_categories replaced per-tickettype loop
+ *     with a single GET /Category call; no more hang.
  */
 import { z } from 'zod';
 import { formatResponse } from '../utils/formatter.js';
@@ -34,15 +41,30 @@ const ListTicketStatusesArgsSchema = z.object({
     format_options: FormatOptionsSchema,
 });
 const ListTicketPrioritiesArgsSchema = z.object({
+    tickettype_id: z.number().int().optional()
+        .describe('Optional. When supplied, fetches the ticket type and filters priorities to the default SLA ' +
+        'for that ticket type. Falls back to all 12 records if the ticket type has no default SLA. ' +
+        "Halo priorities are SLA-scoped — pass tickettype_id to narrow to the relevant SLA, or " +
+        'inspect slaid on each record yourself.'),
     full: z.boolean().optional()
         .describe('Return full records instead of compact (default false).'),
     format_options: FormatOptionsSchema,
 });
 const ListTicketCategoriesArgsSchema = z.object({
+    tickettype_id: z.number().int().optional()
+        .describe('Optional. When supplied, filters categories to those whose type_id matches this ticket type ID ' +
+        '(client-side filter — Halo returns all categories regardless of server-side params).'),
     full: z.boolean().optional()
         .describe('Return full records instead of compact (default false).'),
     format_options: FormatOptionsSchema,
 });
+const ListTicketOutcomesArgsSchema = z.object({
+    tickettype_id: z.number().int().optional()
+        .describe("Optional. When supplied, fetches the ticket type (with includedetails=true) and filters the " +
+        "global outcome list to the IDs listed in the tickettype's outcomes[] array. The Halo " +
+        '/Outcome endpoint does not support server-side tickettype filtering — scoping is client-side.'),
+    format_options: FormatOptionsSchema,
+});
 // =============================================================================
 // Helpers
 // =============================================================================
@@ -70,6 +92,7 @@ function resolveFormat(full, formatOptions) {
  *
  * We promote `priorityid` to `id` and expose the GUID as `sla_priority_id`
  * to prevent callers from accidentally passing the GUID as priority_id.
+ * `slaid` is preserved so callers can disambiguate same-name priorities.
  */
 function normalizePriority(p) {
     return {
@@ -96,6 +119,32 @@ function unwrapList(response, preferredKey) {
     const record_count = wrapped.record_count ?? items.length;
     return { items, record_count };
 }
+/**
+ * Compact an outcome record into the token-efficient shape.
+ *
+ * is_resolution heuristic: name contains "Resolved", "Closed", or "Completed"
+ * (case-insensitive), OR systemid is a non-zero value (closure outcomes in
+ * Halo carry a non-zero systemid).
+ *
+ * is_internal_note heuristic: respondtype === 2.
+ *
+ * NOTE: both flags are heuristics. Verify against your tenant's outcome
+ * configuration before relying on them for automation.
+ */
+function compactOutcome(o) {
+    const resolutionNames = /resolved|closed|completed/i;
+    const is_resolution = resolutionNames.test(o.outcome ?? '') || ((o.systemid ?? 0) > 0);
+    const is_internal_note = o.respondtype === 2;
+    return {
+        id: o.id,
+        name: o.outcome,
+        button: o.buttonname,
+        sequence: o.sequence,
+        hidden: o.hidden,
+        is_resolution,
+        is_internal_note,
+    };
+}
 // =============================================================================
 // Implementations
 // =============================================================================
@@ -130,25 +179,106 @@ export async function listTicketStatuses(client, args) {
 }
 export async function listTicketPriorities(client, args) {
     const formatOpts = resolveFormat(args.full, args.format_options);
+    // Fetch global priority list (12 records = 3 SLAs x 4 levels).
     const response = await client.getCached('/Priority', { count: 500 }, {
         enabled: true,
         ttl: TTL.TICKET_PRIORITIES,
         keyPrefix: 'ticketpriorities:all',
     });
-    const { items: rawItems, record_count } = unwrapList(response, 'priorities');
-    const items = rawItems.map(normalizePriority);
-    return formatResponse(items, formatOpts, { record_count });
+    const { items: rawItems } = unwrapList(response, 'priorities');
+    let normalized = rawItems.map(normalizePriority);
+    // Bug 6 fix: if tickettype_id supplied, scope to that type's default SLA.
+    if (args.tickettype_id !== undefined) {
+        const ttResponse = await client.getCached(`/TicketType/${args.tickettype_id}`, { includedetails: true }, {
+            enabled: true,
+            ttl: TTL.TICKET_TYPES,
+            keyPrefix: `tickettype:detail:${args.tickettype_id}`,
+        });
+        // Support both field names Halo uses across versions.
+        const defaultSla = ttResponse.default_sla ?? ttResponse.sla_id;
+        if (defaultSla !== undefined && defaultSla !== null) {
+            const filtered = normalized.filter((p) => p.slaid === defaultSla);
+            // Fall back to all records if the SLA filter yields nothing (e.g. tenant
+            // uses a different field name we have not mapped).
+            if (filtered.length > 0) {
+                normalized = filtered;
+            }
+        }
+        // If no default SLA on the tickettype, return all 12 (documented fallback).
+    }
+    return formatResponse(normalized, formatOpts, { record_count: normalized.length });
 }
 export async function listTicketCategories(client, args) {
     const formatOpts = resolveFormat(args.full, args.format_options);
-    const response = await client.getCached('/Category', { count: 500 }, {
+    // Bug 7 fix: single GET /Category — no loop, no per-tickettype fetching.
+    // The Halo endpoint ignores count/tickettype_id params and always returns
+    // the full list (~90 records). Caching prevents repeat hits.
+    const response = await client.getCached('/Category', {}, {
         enabled: true,
         ttl: TTL.TICKET_CATEGORIES,
         keyPrefix: 'ticketcategories:all',
     });
-    const { items, record_count } = unwrapList(response, 'categories');
+    let { items, record_count } = unwrapList(response, 'categories');
+    // Optional client-side filter by type_id (== tickettype_id in Halo's schema).
+    if (args.tickettype_id !== undefined) {
+        items = items.filter((c) => c.type_id === args.tickettype_id);
+        record_count = items.length;
+    }
     return formatResponse(items, formatOpts, { record_count });
 }
+/**
+ * List all ticket outcomes from GET /Outcome (cached 1h).
+ *
+ * If tickettype_id is supplied, fetches the ticket type with includedetails=true
+ * and filters to the outcome IDs in its `outcomes[]` array.
+ *
+ * NOTE: The /Outcome endpoint does not support server-side tickettype filtering.
+ * Scoping is always performed client-side.
+ */
+export async function listTicketOutcomes(client, args) {
+    const formatOpts = args.format_options ?? { format: 'compact' };
+    // Fetch global outcome list.
+    const response = await client.getCached('/Outcome', { count: 200 }, {
+        enabled: true,
+        ttl: TTL.TICKET_OUTCOMES,
+        keyPrefix: 'ticketoutcomes:all',
+    });
+    let { items } = unwrapList(response, 'outcomes');
+    // Optional client-side filter via tickettype's outcomes[] array.
+    if (args.tickettype_id !== undefined) {
+        const ttResponse = await client.getCached(`/TicketType/${args.tickettype_id}`, { includedetails: true }, {
+            enabled: true,
+            ttl: TTL.TICKET_TYPES,
+            keyPrefix: `tickettype:detail:${args.tickettype_id}`,
+        });
+        const allowedIds = ttResponse.outcomes;
+        if (Array.isArray(allowedIds) && allowedIds.length > 0) {
+            const idSet = new Set(allowedIds);
+            items = items.filter((o) => idSet.has(o.id));
+        }
+        // If the tickettype has no outcomes[] array, return the full global list.
+    }
+    const compacted = items.map(compactOutcome);
+    return formatResponse(compacted, formatOpts, { record_count: compacted.length });
+}
+/**
+ * Look up a single outcome by name (case-insensitive, first match).
+ *
+ * Returns null if no matching outcome is found. Used internally by ticket
+ * action tools that need to resolve an outcome name to its ID (e.g., SLA
+ * hold/release tools in ticket-actions.ts).
+ */
+export async function getOutcomeByName(client, name) {
+    const response = await client.getCached('/Outcome', { count: 200 }, {
+        enabled: true,
+        ttl: TTL.TICKET_OUTCOMES,
+        keyPrefix: 'ticketoutcomes:all',
+    });
+    const { items } = unwrapList(response, 'outcomes');
+    const lower = name.toLowerCase();
+    const match = items.find((o) => (o.outcome ?? '').toLowerCase() === lower);
+    return match ? compactOutcome(match) : null;
+}
 // =============================================================================
 // Tool Definitions
 // =============================================================================
@@ -172,14 +302,20 @@ export const listTicketStatusesTool = {
 };
 export const listTicketPrioritiesTool = {
     name: 'list_halopsa_ticket_priorities',
-    description: 'List HaloPSA ticket priorities. The `id` field is the integer priority value (1-4) that maps to `Faults.priority_id` on ticket creates — NOT the underlying GUID, which is per-SLA and exposed as `sla_priority_id`. Pass `id` to create/update_halopsa_ticket. Names duplicate across SLAs (3 Critical, 3 High, 3 Medium, 3 Low — one per SLA). Includes fix/response time hints. Cached 1h.',
+    description: "List HaloPSA ticket priorities. Halo's priorities are SLA-scoped — each SLA has its own priority levels with overlapping integer ids (1-4). Pass `tickettype_id` to filter to that ticket type's default SLA, OR inspect `slaid` on each record to disambiguate. The `id` field is the integer priority value (1-4) that maps to `Faults.priority_id` on ticket creates — NOT the underlying GUID (exposed as `sla_priority_id`). Returns all 12 records (3 SLAs x 4 levels) when no tickettype_id is supplied. Includes fix/response time hints. Cached 1h.",
     schema: ListTicketPrioritiesArgsSchema,
     handler: listTicketPriorities,
 };
 export const listTicketCategoriesTool = {
     name: 'list_halopsa_ticket_categories',
-    description: 'List all HaloPSA ticket categories (used for category_1..category_4 fields on tickets). Cached 1h.',
+    description: 'List all HaloPSA ticket categories (used for category_1..category_4 fields on tickets). Fetches GET /Category once and returns all categories (~90 records). Pass optional tickettype_id for client-side filtering by type_id. Cached 1h.',
     schema: ListTicketCategoriesArgsSchema,
     handler: listTicketCategories,
 };
+export const listTicketOutcomesTool = {
+    name: 'list_halopsa_ticket_outcomes',
+    description: "List HaloPSA ticket outcomes — the action outcomes selectable when adding a ticket action (e.g., Triage, Resolved, Closed, Escalated). Returns compact shape: {id, name, button, sequence, hidden, is_resolution, is_internal_note}. NOTE: is_resolution and is_internal_note are HEURISTICS (name-match + respondtype) — verify against your tenant's outcome configuration before automation. Pass optional tickettype_id to filter to outcomes allowed for that ticket type (client-side via the tickettype's outcomes[] array). GET /Outcome does not support server-side filtering. Cached 1h.",
+    schema: ListTicketOutcomesArgsSchema,
+    handler: listTicketOutcomes,
+};
 //# sourceMappingURL=ticket-reference-data.js.map

package/dist/tools/ticket-reference-data.js.map

@@ -1 +1 @@
-{"version":3,"file":"ticket-reference-data.js","sourceRoot":"","sources":["../../src/tools/ticket-reference-data.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ticket-reference-data.js","sourceRoot":"","sources":["../../src/tools/ticket-reference-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,OAAO,EAAE,cAAc,EAAsB,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SACzB,QAAQ,CAAC,yGAAyG,CAAC;IACtH,cAAc,EAAE,mBAAmB;CACpC,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;SAC5B,QAAQ,CAAC,wBAAwB,CAAC;IACrC,cAAc,EAAE,mBAAmB;CACpC,CAAC,CAAC;AAEH,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SACzB,QAAQ,CAAC,yDAAyD,CAAC;IACtE,cAAc,EAAE,mBAAmB;CACpC,CAAC,CAAC;AAEH,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;SACvC,QAAQ,CACP,6FAA6F;QAC7F,4FAA4F;QAC5F,wFAAwF;QACxF,wCAAwC,CACzC;IACH,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SACzB,QAAQ,CAAC,yDAAyD,CAAC;IACtE,cAAc,EAAE,mBAAmB;CACpC,CAAC,CAAC;AAEH,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;SACvC,QAAQ,CACP,iGAAiG;QACjG,sFAAsF,CACvF;IACH,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SACzB,QAAQ,CAAC,yDAAyD,CAAC;IACtE,cAAc,EAAE,mBAAmB;CACpC,CAAC,CAAC;AAEH,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;SACvC,QAAQ,CACP,8FAA8F;QAC9F,uFAAuF;QACvF,+FAA+F,CAChG;IACH,cAAc,EAAE,mBAAmB;CACpC,CAAC,CAAC;AAEH,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;;;GAIG;AACH,SAAS,aAAa,CACpB,IAAyB,EACzB,aAAwC;IAExC,MAAM,IAAI,GAAkB,EAAE,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,CAAC;IACzD,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;IAC3B,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,iBAAiB,CAAC,CAAwB;IACjD,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,UAAU;QAChB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,eAAe,EAAE,CAAC,CAAC,EAAE;QACrB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,aAAa,EAAE,CAAC,CAAC,aAAa;QAC9B,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,iBAAiB,EAAE,CAAC,CAAC,iBAAiB;QACtC,kBAAkB,EAAE,CAAC,CAAC,kBAAkB;KACzC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,SAAS,UAAU,CACjB,QAAsB,EACtB,YAAoB;IAEpB,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC5D,CAAC;IACD,MAAM,OAAO,GAAG,QAAmC,CAAC;IACpD,MAAM,KAAK,GAAI,OAAO,CAAC,YAAY,CAAqB,IAAI,EAAE,CAAC;IAC/D,MAAM,YAAY,GAAI,OAAO,CAAC,YAAmC,IAAI,KAAK,CAAC,MAAM,CAAC;IAClF,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,cAAc,CAAC,CAAuB;IAC7C,MAAM,eAAe,GAAG,4BAA4B,CAAC;IACrD,MAAM,aAAa,GACjB,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACnE,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC;IAE7C,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,OAAO;QACf,MAAM,EAAE,CAAC,CAAC,UAAU;QACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,aAAa;QACb,gBAAgB;KACjB,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAwB,EACxB,IAA+C;IAE/C,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IAEjE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CACrC,aAAa,EACb,EAAE,KAAK,EAAE,GAAG,EAAE,EACd;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,GAAG,CAAC,YAAY;QACrB,SAAS,EAAE,iBAAiB;KAC7B,CACF,CAAC;IAEF,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,UAAU,CAAoB,QAAQ,EAAE,aAAa,CAAC,CAAC;IACvF,OAAO,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAwB,EACxB,IAA6C;IAE7C,MAAM,UAAU,GAAkB,IAAI,CAAC,cAAc,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAEhF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CACrC,eAAe,IAAI,CAAC,aAAa,EAAE,EACnC,SAAS,EACT;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,GAAG,CAAC,YAAY;QACrB,SAAS,EAAE,cAAc,IAAI,CAAC,aAAa,EAAE;KAC9C,CACF,CAAC;IAEF,OAAO,cAAc,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAwB,EACxB,IAAkD;IAElD,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IAEjE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CACrC,SAAS,EACT,EAAE,KAAK,EAAE,GAAG,EAAE,EACd;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,GAAG,CAAC,eAAe;QACxB,SAAS,EAAE,oBAAoB;KAChC,CACF,CAAC;IAEF,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,UAAU,CAAsB,QAAQ,EAAE,UAAU,CAAC,CAAC;IACtF,OAAO,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAwB,EACxB,IAAoD;IAEpD,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IAEjE,+DAA+D;IAC/D,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CACrC,WAAW,EACX,EAAE,KAAK,EAAE,GAAG,EAAE,EACd;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,GAAG,CAAC,iBAAiB;QAC1B,SAAS,EAAE,sBAAsB;KAClC,CACF,CAAC;IAEF,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAwB,QAAQ,EAAE,YAAY,CAAC,CAAC;IACtF,IAAI,UAAU,GAAsC,QAAQ,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAEpF,0EAA0E;IAC1E,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,SAAS,CACvC,eAAe,IAAI,CAAC,aAAa,EAAE,EACnC,EAAE,cAAc,EAAE,IAAI,EAAE,EACxB;YACE,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,GAAG,CAAC,YAAY;YACrB,SAAS,EAAE,qBAAqB,IAAI,CAAC,aAAa,EAAE;SACrD,CACF,CAAC;QAEF,sDAAsD;QACtD,MAAM,UAAU,GAAG,UAAU,CAAC,WAAW,IAAI,UAAU,CAAC,MAAM,CAAC;QAC/D,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACpD,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC;YAClE,yEAAyE;YACzE,mDAAmD;YACnD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,UAAU,GAAG,QAAQ,CAAC;YACxB,CAAC;QACH,CAAC;QACD,4EAA4E;IAC9E,CAAC;IAED,OAAO,cAAc,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,YAAY,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAwB,EACxB,IAAoD;IAEpD,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IAEjE,yEAAyE;IACzE,0EAA0E;IAC1E,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CACrC,WAAW,EACX,EAAE,EACF;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,GAAG,CAAC,iBAAiB;QAC1B,SAAS,EAAE,sBAAsB;KAClC,CACF,CAAC;IAEF,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,UAAU,CAAwB,QAAQ,EAAE,YAAY,CAAC,CAAC;IAExF,8EAA8E;IAC9E,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACrC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,aAAa,CAAC,CAAC;QAC9D,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,OAAO,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAwB,EACxB,IAAkD;IAElD,MAAM,UAAU,GAAkB,IAAI,CAAC,cAAc,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAE/E,6BAA6B;IAC7B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CACrC,UAAU,EACV,EAAE,KAAK,EAAE,GAAG,EAAE,EACd;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,GAAG,CAAC,eAAe;QACxB,SAAS,EAAE,oBAAoB;KAChC,CACF,CAAC;IAEF,IAAI,EAAE,KAAK,EAAE,GAAG,UAAU,CAAuB,QAAQ,EAAE,UAAU,CAAC,CAAC;IAEvE,iEAAiE;IACjE,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,SAAS,CACvC,eAAe,IAAI,CAAC,aAAa,EAAE,EACnC,EAAE,cAAc,EAAE,IAAI,EAAE,EACxB;YACE,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,GAAG,CAAC,YAAY;YACrB,SAAS,EAAE,qBAAqB,IAAI,CAAC,aAAa,EAAE;SACrD,CACF,CAAC;QAEF,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC;QACvC,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;YAClC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,0EAA0E;IAC5E,CAAC;IAED,MAAM,SAAS,GAAkC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAE3E,OAAO,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE,YAAY,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;AACnF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAwB,EACxB,IAAY;IAEZ,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CACrC,UAAU,EACV,EAAE,KAAK,EAAE,GAAG,EAAE,EACd;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,GAAG,CAAC,eAAe;QACxB,SAAS,EAAE,oBAAoB;KAChC,CACF,CAAC;IAEF,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAuB,QAAQ,EAAE,UAAU,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,CAAC;IAC3E,OAAO,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC;AAED,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,MAAM,CAAC,MAAM,mBAAmB,GAAsB;IACpD,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE,6IAA6I;IAC1J,MAAM,EAAE,yBAAyB;IACjC,OAAO,EAAE,eAAe;CACzB,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,oDAAoD;IACjE,MAAM,EAAE,uBAAuB;IAC/B,OAAO,EAAE,aAAa;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAsB;IACvD,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE,2eAA2e;IACxf,MAAM,EAAE,4BAA4B;IACpC,OAAO,EAAE,kBAAkB;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAsB;IACzD,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,8hBAA8hB;IAC3iB,MAAM,EAAE,8BAA8B;IACtC,OAAO,EAAE,oBAAoB;CAC9B,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAsB;IACzD,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,2OAA2O;IACxP,MAAM,EAAE,8BAA8B;IACtC,OAAO,EAAE,oBAAoB;CAC9B,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAsB;IACvD,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE,qkBAAqkB;IACllB,MAAM,EAAE,4BAA4B;IACpC,OAAO,EAAE,kBAAkB;CAC5B,CAAC"}

package/dist/tools/tickets.d.ts

@@ -98,6 +98,8 @@ export declare const CreateTicketArgsSchema: z.ZodObject<{
     estimate: z.ZodOptional<z.ZodNumber>;
     estimatedays: z.ZodOptional<z.ZodNumber>;
     milestone_id: z.ZodOptional<z.ZodNumber>;
+    asset_id: z.ZodOptional<z.ZodNumber>;
+    asset_ids: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
     format_options: z.ZodOptional<z.ZodObject<{
         format: z.ZodOptional<z.ZodEnum<{
             compact: "compact";
@@ -132,6 +134,8 @@ export declare const UpdateTicketArgsSchema: z.ZodObject<{
     estimate: z.ZodOptional<z.ZodNumber>;
     estimatedays: z.ZodOptional<z.ZodNumber>;
     milestone_id: z.ZodOptional<z.ZodNumber>;
+    asset_id: z.ZodOptional<z.ZodNumber>;
+    asset_ids: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
     format_options: z.ZodOptional<z.ZodObject<{
         format: z.ZodOptional<z.ZodEnum<{
             compact: "compact";
@@ -151,6 +155,19 @@ export declare const DeleteTicketArgsSchema: z.ZodObject<{
     reason: z.ZodString;
     confirm_destructive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
+export declare const ValidateCreateTicketArgsSchema: z.ZodObject<{
+    tickettype_id: z.ZodNumber;
+    fields: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    format_options: z.ZodOptional<z.ZodObject<{
+        format: z.ZodOptional<z.ZodEnum<{
+            compact: "compact";
+            standard: "standard";
+            detailed: "detailed";
+        }>>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        omit_empty: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export declare function listTickets(client: HaloPSAAPIClient, args: z.infer<typeof ListTicketsArgsSchema>): Promise<string>;
 export declare function getTicket(client: HaloPSAAPIClient, args: z.infer<typeof GetTicketArgsSchema>): Promise<string>;
 export declare function searchTickets(client: HaloPSAAPIClient, args: z.infer<typeof SearchTicketsArgsSchema>): Promise<string>;
@@ -182,6 +199,21 @@ export declare function updateTicket(client: HaloPSAAPIClient, args: z.infer<typ
  */
 export declare function deleteTicket(client: HaloPSAAPIClient, args: z.infer<typeof DeleteTicketArgsSchema>): Promise<string>;
 export declare function closeTicket(client: HaloPSAAPIClient, args: z.infer<typeof CloseTicketArgsSchema>): Promise<string>;
+/**
+ * Pure-local validation of a proposed ticket payload against the cached
+ * tickettype schema. No write is performed — this is a dry-run helper.
+ *
+ * Required-field detection logic:
+ * Halo's TicketType details response includes a `fields[]` array where each
+ * entry has a `fieldinfo` sub-object. The `mandatory` flag on `fieldinfo`
+ * indicates a required field. Additionally, `technew` on `fieldinfo` where
+ * the value equals 3 indicates "required for tech/API create". When either
+ * condition is true, the field is counted as required.
+ *
+ * Standard ticket fields (summary, client_id, tickettype_id) are always
+ * required regardless of the tickettype schema.
+ */
+export declare function validateCreateTicket(client: HaloPSAAPIClient, args: z.infer<typeof ValidateCreateTicketArgsSchema>): Promise<string>;
 export declare const listTicketsTool: ZodToolDefinition;
 export declare const getTicketTool: ZodToolDefinition;
 export declare const searchTicketsTool: ZodToolDefinition;
@@ -189,4 +221,5 @@ export declare const createTicketTool: ZodToolDefinition;
 export declare const updateTicketTool: ZodToolDefinition;
 export declare const closeTicketTool: ZodToolDefinition;
 export declare const deleteTicketTool: ZodToolDefinition;
+export declare const validateCreateTicketTool: ZodToolDefinition;
 //# sourceMappingURL=tickets.d.ts.map

package/dist/tools/tickets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tickets.d.ts","sourceRoot":"","sources":["../../src/tools/tickets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAgCvD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwChC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;iBAI9B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;iBAUlC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwCjC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8BjC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;iBAKhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;iBAQjC,CAAC;AAoGH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,GAC1C,OAAO,CAAC,MAAM,CAAC,CAwCjB;AAED,wBAAsB,SAAS,CAC7B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,GACxC,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,GAC5C,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,GAC3C,OAAO,CAAC,MAAM,CAAC,CA2CjB;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,GAC3C,OAAO,CAAC,MAAM,CAAC,CAqGjB;AAgBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,GAC3C,OAAO,CAAC,MAAM,CAAC,CA8HjB;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,GAC1C,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAMD,eAAO,MAAM,eAAe,EAAE,iBAK7B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,iBAK3B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,iBAK/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,iBAK9B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,iBAK9B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,iBAK7B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,iBAK9B,CAAC"}
+{"version":3,"file":"tickets.d.ts","sourceRoot":"","sources":["../../src/tools/tickets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAgCvD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwChC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;iBAI9B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;iBAUlC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6CjC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmCjC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;iBAKhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;iBAQjC,CAAC;AAGH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;iBAMzC,CAAC;AA0HH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,GAC1C,OAAO,CAAC,MAAM,CAAC,CAwCjB;AAED,wBAAsB,SAAS,CAC7B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,GACxC,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,GAC5C,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,GAC3C,OAAO,CAAC,MAAM,CAAC,CAoDjB;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,GAC3C,OAAO,CAAC,MAAM,CAAC,CA6GjB;AAgBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,GAC3C,OAAO,CAAC,MAAM,CAAC,CA8HjB;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,GAC1C,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAiBD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,GACnD,OAAO,CAAC,MAAM,CAAC,CAiGjB;AAMD,eAAO,MAAM,eAAe,EAAE,iBAK7B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,iBAK3B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,iBAK/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,iBAK9B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,iBAK9B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,iBAK7B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,iBAK9B,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,iBAMtC,CAAC"}

package/dist/tools/tickets.js

@@ -131,6 +131,11 @@ export const CreateTicketArgsSchema = z.object({
         .describe('Estimated business days. Companion to estimate; pass either or neither — Halo auto-computes both from startdate/targetdate when both omitted.'),
     milestone_id: z.number().int().optional()
         .describe('Link this ticket to an existing milestone on its parent project ticket. milestone_id orchestrates: the MCP transparently translates this to a parent-project milestones[].tickets[] update. Single milestone per task — setting milestone_id automatically unlinks from any previous milestone. Pass 0 to unlink entirely. Find milestone ids via list_halopsa_ticket_milestones on the parent ticket.'),
+    // Bug 9: Asset linking fields.
+    asset_id: z.number().int().optional()
+        .describe('Single asset to link to this ticket. For multiple, use asset_ids.'),
+    asset_ids: z.array(z.number().int()).optional()
+        .describe('Multiple asset IDs to link to this ticket. Halo will populate the ticket.assets[] array. If both asset_id and asset_ids are set, they are combined.'),
     format_options: FormatOptionsSchema,
 });
 export const UpdateTicketArgsSchema = z.object({
@@ -162,6 +167,11 @@ export const UpdateTicketArgsSchema = z.object({
         .describe('Estimated business days. Companion to estimate; pass either or neither — Halo auto-computes both from startdate/targetdate when both omitted.'),
     milestone_id: z.number().int().optional()
         .describe('Link this ticket to an existing milestone on its parent project ticket. milestone_id orchestrates: the MCP transparently translates this to a parent-project milestones[].tickets[] update. Single milestone per task — setting milestone_id automatically unlinks from any previous milestone. Pass 0 to unlink entirely. Find milestone ids via list_halopsa_ticket_milestones on the parent ticket.'),
+    // Bug 9: Asset linking fields.
+    asset_id: z.number().int().optional()
+        .describe('Single asset to link to this ticket. For multiple, use asset_ids.'),
+    asset_ids: z.array(z.number().int()).optional()
+        .describe('Multiple asset IDs to link to this ticket. Halo will populate the ticket.assets[] array. If both asset_id and asset_ids are set, they are combined.'),
     format_options: FormatOptionsSchema,
 });
 export const CloseTicketArgsSchema = z.object({
@@ -175,6 +185,14 @@ export const DeleteTicketArgsSchema = z.object({
     reason: z.string().min(5).describe('REQUIRED audit-trail reason. To bypass safety blocks, the reason MUST include the substring "OVERRIDE" (case-sensitive) AND confirm_destructive must be true.'),
     confirm_destructive: z.boolean().optional().default(false).describe('When safety pre-flight checks would block the delete, set true AND include "OVERRIDE" in `reason` to proceed. Default false.'),
 });
+// Bug 8: Schema for validate_halopsa_create_ticket.
+export const ValidateCreateTicketArgsSchema = z.object({
+    tickettype_id: z.number().int()
+        .describe('Ticket type ID to validate against — see list_halopsa_tickettypes'),
+    fields: z.record(z.string(), z.unknown())
+        .describe('Proposed ticket payload as a key-value map. Keys should be field names (e.g. summary, client_id, customfields).'),
+    format_options: FormatOptionsSchema,
+});
 // =============================================================================
 // Helpers
 // =============================================================================
@@ -251,6 +269,24 @@ async function resolveClosedStatusId(client) {
         `(received ${items.length} statuses; "Closed" matches: ${exactClosed.length}, "Completed" matches: ${exactCompleted.length}) ` +
         'Pass status_id explicitly via update_halopsa_ticket.');
 }
+/**
+ * Build the Halo assets[] array payload from asset_id / asset_ids args.
+ * Halo Faults.assets[] accepts elements with at minimum { id: number }.
+ * Returns undefined when neither arg is set (no-op).
+ */
+function buildAssetsPayload(asset_id, asset_ids) {
+    if (asset_id === undefined && asset_ids === undefined) {
+        return undefined;
+    }
+    const idSet = [];
+    if (asset_ids !== undefined) {
+        idSet.push(...asset_ids);
+    }
+    if (asset_id !== undefined && !idSet.includes(asset_id)) {
+        idSet.push(asset_id);
+    }
+    return idSet.map((id) => ({ id }));
+}
 // =============================================================================
 // Implementations
 // =============================================================================
@@ -364,14 +400,22 @@ export async function createTicket(client, args) {
     // milestone_id is NOT sent to Halo as a direct field — writing it to the
     // child record is a no-op for Project Task tickets (tickettype_id=20).
     // Milestone membership is orchestrated via linkTicketToMilestone below.
+    // Bug 9: Asset linking. Build assets[] from asset_id / asset_ids args.
+    // Halo Faults.assets[] accepts elements with at minimum { id: number }.
+    const assetsPayload = buildAssetsPayload(args.asset_id, args.asset_ids);
+    if (assetsPayload !== undefined) {
+        payload.assets = assetsPayload;
+    }
     const created = unwrapWriteResponse(await client.post('/Tickets', [payload]));
     client.invalidateCache('tickets:*');
     // Bug 1: Orchestrate milestone linkage via parent project if requested.
     if (args.milestone_id !== undefined) {
         await linkTicketToMilestone(client, created.id, args.milestone_id, args.parent_id);
     }
-    const format = args.format_options?.format ?? 'compact';
-    return formatResponse(stripWriteResponse(created, format, 'ticket'), { format });
+    // Bug 5: Pass full format_options so fields/omit_empty flow through to formatResponse.
+    const formatOpts = args.format_options ?? { format: 'compact' };
+    const format = formatOpts.format ?? 'compact';
+    return formatResponse(stripWriteResponse(created, format, 'ticket'), formatOpts);
 }
 export async function updateTicket(client, args) {
     const partial = {};
@@ -412,6 +456,11 @@ export async function updateTicket(client, args) {
     // milestone_id is NOT sent to Halo as a direct field — writing it to the
     // child record is a no-op for Project Task tickets (tickettype_id=20).
     // Milestone membership is orchestrated via linkTicketToMilestone below.
+    // Bug 9: Asset linking. Build assets[] from asset_id / asset_ids args.
+    const assetsPayload = buildAssetsPayload(args.asset_id, args.asset_ids);
+    if (assetsPayload !== undefined) {
+        partial.assets = assetsPayload;
+    }
     // Determine which fields count for the "at least one" check. We include
     // milestone_id in the check so that a milestone-only update is valid.
     const fieldCount = Object.keys(partial).length + (args.milestone_id !== undefined ? 1 : 0);
@@ -462,8 +511,10 @@ export async function updateTicket(client, args) {
     if (args.milestone_id !== undefined) {
         await linkTicketToMilestone(client, args.ticket_id, args.milestone_id, args.parent_id);
     }
-    const format = args.format_options?.format ?? 'compact';
-    return formatResponse(stripWriteResponse(response, format, 'ticket'), { format });
+    // Bug 5: Pass full format_options so fields/omit_empty flow through to formatResponse.
+    const formatOpts = args.format_options ?? { format: 'compact' };
+    const format = formatOpts.format ?? 'compact';
+    return formatResponse(stripWriteResponse(response, format, 'ticket'), formatOpts);
 }
 /**
  * Permanently delete a HaloPSA ticket by ID after running four safety
@@ -601,6 +652,84 @@ export async function closeTicket(client, args) {
         status_id: closedStatusId,
     });
 }
+/**
+ * Pure-local validation of a proposed ticket payload against the cached
+ * tickettype schema. No write is performed — this is a dry-run helper.
+ *
+ * Required-field detection logic:
+ * Halo's TicketType details response includes a `fields[]` array where each
+ * entry has a `fieldinfo` sub-object. The `mandatory` flag on `fieldinfo`
+ * indicates a required field. Additionally, `technew` on `fieldinfo` where
+ * the value equals 3 indicates "required for tech/API create". When either
+ * condition is true, the field is counted as required.
+ *
+ * Standard ticket fields (summary, client_id, tickettype_id) are always
+ * required regardless of the tickettype schema.
+ */
+export async function validateCreateTicket(client, args) {
+    // Fetch the tickettype with full field details.
+    const tickettype = await client.getCached(`/TicketType/${args.tickettype_id}`, { includedetails: true }, {
+        enabled: true,
+        ttl: TTL.TICKET_TYPES,
+        keyPrefix: `tickettype:${args.tickettype_id}:details`,
+    });
+    // Standard fields always required on create.
+    const STANDARD_REQUIRED = ['summary', 'client_id', 'tickettype_id'];
+    // Build the list of required fields from the tickettype schema.
+    const schemaFields = Array.isArray(tickettype.fields)
+        ? tickettype.fields
+        : [];
+    const requiredFromSchema = [];
+    const allSchemaFieldNames = [];
+    for (const f of schemaFields) {
+        // Field name may be on fieldinfo or directly on the field entry.
+        const info = f.fieldinfo ?? f;
+        const name = info.name ?? '';
+        const label = info.label ?? name;
+        const isCustom = info.custom ?? false;
+        if (name) {
+            allSchemaFieldNames.push(name);
+        }
+        // A field is required if mandatory===true OR technew===3.
+        const isRequired = info.mandatory === true || info.technew === 3;
+        if (isRequired && name) {
+            requiredFromSchema.push({ name, label, custom: isCustom });
+        }
+    }
+    // Combine standard required fields with schema-derived required fields,
+    // deduplicating by name.
+    const allRequiredFields = [
+        ...STANDARD_REQUIRED.map((n) => ({ name: n, label: n, custom: false })),
+        ...requiredFromSchema.filter((f) => !STANDARD_REQUIRED.includes(f.name)),
+    ];
+    const providedKeys = new Set(Object.keys(args.fields));
+    // Missing: required fields not in the provided payload.
+    const missingRequired = allRequiredFields
+        .filter((f) => !providedKeys.has(f.name))
+        .map((f) => f.name);
+    // Unknown: provided fields not in the standard set and not in the schema.
+    const knownFieldNames = new Set([
+        ...STANDARD_REQUIRED,
+        ...allSchemaFieldNames,
+        // Common optional standard fields that are always valid.
+        'details_html', 'category_1', 'priority_id', 'status_id', 'source',
+        'agent_id', 'team_id', 'site_id', 'user_id', 'parent_id',
+        'dateoccurred', 'startdate', 'customfields', 'estimate', 'estimatedays',
+        'milestone_id', 'asset_id', 'asset_ids', 'assets',
+    ]);
+    const unknownFields = [...providedKeys].filter((k) => !knownFieldNames.has(k));
+    const valid = missingRequired.length === 0 && unknownFields.length === 0;
+    const result = {
+        valid,
+        missing_required: missingRequired,
+        unknown_fields: unknownFields,
+        required_fields: allRequiredFields,
+        tickettype_id: args.tickettype_id,
+        tickettype_name: tickettype.name ?? '',
+    };
+    const formatOpts = args.format_options ?? { format: 'standard' };
+    return formatResponse(result, formatOpts);
+}
 // =============================================================================
 // Tool Definitions
 // =============================================================================
@@ -624,13 +753,13 @@ export const searchTicketsTool = {
 };
 export const createTicketTool = {
     name: 'create_halopsa_ticket',
-    description: 'Create a new HaloPSA ticket. Required: summary, tickettype_id, client_id. Body is sent as POST /Tickets with array wrapper [{ ... }] (HaloPSA convention). Invalidates ticket cache. Estimate auto-computed from startdate->targetdate (5x8 business hrs) if omitted; pass `estimate` to override.',
+    description: 'Create a new HaloPSA ticket. Required: summary, tickettype_id, client_id. Body is sent as POST /Tickets with array wrapper [{ ... }] (HaloPSA convention). Invalidates ticket cache. Estimate auto-computed from startdate->targetdate (5x8 business hrs) if omitted; pass `estimate` to override. Pass asset_id/asset_ids to link assets on creation.',
     schema: CreateTicketArgsSchema,
     handler: createTicket,
 };
 export const updateTicketTool = {
     name: 'update_halopsa_ticket',
-    description: 'Update an existing HaloPSA ticket. Performs read-before-write merge (Halo POST is REPLACE not PATCH). Update by explicit id only — no force/dedup flags (tickets are append-only events). Invalidates ticket cache.',
+    description: 'Update an existing HaloPSA ticket. Performs read-before-write merge (Halo POST is REPLACE not PATCH). Update by explicit id only — no force/dedup flags (tickets are append-only events). Invalidates ticket cache. Pass asset_id/asset_ids to link assets on update.',
     schema: UpdateTicketArgsSchema,
     handler: updateTicket,
 };
@@ -646,4 +775,10 @@ export const deleteTicketTool = {
     schema: DeleteTicketArgsSchema,
     handler: deleteTicket,
 };
+export const validateCreateTicketTool = {
+    name: 'validate_halopsa_create_ticket',
+    description: 'Pure local dry-run validation of a proposed ticket payload against the cached tickettype schema. No Halo write is performed. Returns {valid, missing_required[], unknown_fields[], required_fields[]} so callers can catch missing mandatory fields before calling create_halopsa_ticket. Fetches tickettype via GET /TicketType/{id}?includedetails=true (cached 1h). Use list_halopsa_tickettypes to look up tickettype_id values.',
+    schema: ValidateCreateTicketArgsSchema,
+    handler: validateCreateTicket,
+};
 //# sourceMappingURL=tickets.js.map