@wilnertech/halopsa-mcp-server 1.2.0 → 1.4.0

package/dist/tools/milestones.js

@@ -0,0 +1,281 @@
+/**
+ * HaloPSA milestone management tools.
+ *
+ * Milestones are stored as a nested `milestones[]` array on the ticket
+ * itself — there is no top-level /Milestone endpoint (GET /Milestone
+ * returns 404). All reads use GET /Tickets/{id}?includedetails=true
+ * and all writes use POST /Tickets with a read-before-write merge,
+ * replacing the milestones array in its entirety (same pattern as
+ * customfields).
+ *
+ * Discovery note (2026-05-11): confirmed `milestones: []` (empty array)
+ * on ticket 22541; Swagger declares `MileStone` schema with 24 props.
+ */
+import { z } from 'zod';
+import { formatResponse, stripWriteResponse } from '../utils/formatter.js';
+import { TTL } from '../cache/memory-cache.js';
+import { FormatOptionsSchema } from '../schemas/common.js';
+// =============================================================================
+// Schemas
+// =============================================================================
+/**
+ * Single milestone input — reused by set (array element) and add (single).
+ */
+const MilestoneInputSchema = z.object({
+    name: z.string().min(1)
+        .describe('Milestone name (required)'),
+    target_date: z.string()
+        .describe('Target completion date — ISO 8601 (required)'),
+    start_date: z.string().optional()
+        .describe('Start date — ISO 8601'),
+    sequence: z.number().int().optional()
+        .describe('Ordering sequence number'),
+    billing_amount: z.number().optional()
+        .describe('Billing amount associated with this milestone'),
+    status_id: z.number().int().optional()
+        .describe('Milestone status ID'),
+    state: z.number().int().optional()
+        .describe('Milestone state. Halo enum: 0=upcoming (default), 2=complete. State=1 may be in-progress (unverified; probe via UI if needed).'),
+});
+export const ListTicketMilestonesArgsSchema = z.object({
+    ticket_id: z.number().int()
+        .describe('HaloPSA project ticket ID to read milestones from'),
+    format_options: FormatOptionsSchema,
+});
+export const SetTicketMilestonesArgsSchema = z.object({
+    ticket_id: z.number().int()
+        .describe('HaloPSA project ticket ID'),
+    milestones: z.array(MilestoneInputSchema).min(1)
+        .describe('Full replacement array of milestones. This REPLACES all existing milestones on the ticket.'),
+    format_options: FormatOptionsSchema,
+});
+export const AddTicketMilestoneArgsSchema = z.object({
+    ticket_id: z.number().int()
+        .describe('HaloPSA project ticket ID'),
+    milestone: MilestoneInputSchema
+        .describe('Milestone to append to the existing list'),
+    format_options: FormatOptionsSchema,
+});
+export const RemoveTicketMilestoneArgsSchema = z.object({
+    ticket_id: z.number().int()
+        .describe('HaloPSA project ticket ID'),
+    milestone_id: z.number().int()
+        .describe('ID of the milestone to remove'),
+    format_options: FormatOptionsSchema,
+});
+export const GetCurrentMilestoneArgsSchema = z.object({
+    parent_ticket_id: z.number().int()
+        .describe('HaloPSA project ticket ID whose milestones[] will be inspected'),
+    format_options: FormatOptionsSchema,
+});
+// =============================================================================
+// Helpers
+// =============================================================================
+/**
+ * Halo write endpoints sometimes return `[{...}]` and sometimes `{...}`.
+ * Normalize to a single object so handlers don't have to branch.
+ */
+function unwrapWriteResponse(response) {
+    return Array.isArray(response) ? response[0] : response;
+}
+/**
+ * Fetch ticket with includedetails=true, bypassing cache so we always
+ * have a fresh baseline before a write.
+ */
+async function fetchTicketFresh(client, ticketId) {
+    return client.get(`/Tickets/${ticketId}`, { includedetails: true });
+}
+/**
+ * POST the merged ticket payload to Halo and return the stripped, formatted
+ * milestones array from the response.
+ */
+async function writeMilestones(client, ticketId, existing, newMilestones, format) {
+    const payload = { ...existing, id: ticketId, milestones: newMilestones };
+    const response = unwrapWriteResponse(await client.post('/Tickets', [payload]));
+    client.invalidateCache(`ticket-milestones:${ticketId}*`);
+    client.invalidateCache(`ticket:${ticketId}*`);
+    client.invalidateCache('tickets:*');
+    // Return the milestones array from the written ticket.
+    const strippedTicket = stripWriteResponse(response, format, 'ticket');
+    const milestones = strippedTicket['milestones'] ?? [];
+    const resolvedFormat = format ?? 'compact';
+    return formatResponse(milestones, { format: resolvedFormat }, {
+        ticket_id: ticketId,
+        milestone_count: milestones.length,
+    });
+}
+// =============================================================================
+// linkTicketToMilestone — exported orchestration helper (Bug 1)
+// =============================================================================
+/**
+ * Link (or unlink) a child ticket to a milestone on its parent project ticket.
+ *
+ * Halo's Project Task tickettype (id=20) has NO milestone field on the child
+ * side — writing milestone_id to the child's own record is a no-op (silently
+ * dropped). Milestone membership is stored exclusively in the parent's
+ * milestones[].tickets[] array. This helper:
+ *
+ *  1. Optionally fetches the child to discover its parent_id.
+ *  2. Fetches the parent (fresh, includedetails=true).
+ *  3. Walks every milestone, removing childTicketId from both tickets[] and
+ *     the runtime-only tickets_list[] (int array sometimes returned by Halo
+ *     but not declared in the swagger schema — handled defensively).
+ *  4. Appends the child to the target milestone's arrays (unless
+ *     milestoneId === 0 or null — "unlink" mode, step 3 only).
+ *  5. POSTs the parent back with the mutated milestones[] (read-before-write
+ *     merge preserving all other parent fields).
+ *  6. Invalidates relevant caches.
+ *
+ * Throws a descriptive Error for common mis-configurations so the caller
+ * surface (createTicket / updateTicket) can surface a clear message.
+ */
+export async function linkTicketToMilestone(client, childTicketId, milestoneId, parentTicketId) {
+    void parentTicketId;
+    // Halo's write-side milestone field on a child ticket is `update_milestone_id`
+    // (not `milestone_id` — that's read-only on the child). Posting
+    // `update_milestone_id` causes Halo to set `milestone_id` on the child AND
+    // auto-create the FaultsMileStone link on the parent. Empirically confirmed
+    // 2026-05-11 against the live tenant: `milestone_id` write is a no-op;
+    // `update_milestone_id` write persists. Value 0 unlinks.
+    const writeValue = milestoneId === null ? 0 : milestoneId;
+    await client.post('/Tickets', [
+        { id: childTicketId, update_milestone_id: writeValue },
+    ]);
+    client.invalidateCache(`ticket:${childTicketId}*`);
+    client.invalidateCache('tickets:*');
+    client.invalidateCache('ticket-milestones:*');
+}
+// =============================================================================
+// Implementations
+// =============================================================================
+export async function listTicketMilestones(client, args) {
+    const response = await client.getCached(`/Tickets/${args.ticket_id}`, { includedetails: true }, {
+        enabled: true,
+        ttl: TTL.TICKET_LIST,
+        keyPrefix: `ticket-milestones:${args.ticket_id}`,
+    });
+    const milestones = response.milestones ?? [];
+    // Compact-by-default projection that preserves the fields callers actually
+    // need from a milestone listing — including the `state` enum (0=upcoming,
+    // 2=complete, 1=possible-in-progress) which formatter.ts's generic compact
+    // projection would otherwise strip.
+    const compactProjection = (m) => ({
+        id: m.id,
+        name: m.name,
+        sequence: m.sequence,
+        start_date: m.start_date,
+        target_date: m.target_date,
+        state: m.state,
+        ticket_count: Array.isArray(m.tickets) ? m.tickets.length : 0,
+    });
+    const formatOpts = args.format_options ?? { format: 'compact' };
+    const fmt = formatOpts.format ?? 'compact';
+    const projected = (fmt === 'detailed') ? milestones : milestones.map(compactProjection);
+    // Pass explicit fields so formatResponse's compact projection doesn't strip
+    // our preserved `state` field (Bug 5). If the caller already supplied
+    // `fields`, respect that.
+    const finalOpts = (formatOpts.fields && formatOpts.fields.length > 0) ? formatOpts : {
+        ...formatOpts,
+        fields: ['id', 'name', 'sequence', 'start_date', 'target_date', 'state', 'ticket_count'],
+    };
+    return formatResponse(projected, finalOpts, {
+        ticket_id: args.ticket_id,
+        milestone_count: milestones.length,
+    });
+}
+export async function setTicketMilestones(client, args) {
+    const existing = await fetchTicketFresh(client, args.ticket_id);
+    const format = args.format_options?.format;
+    return writeMilestones(client, args.ticket_id, existing, args.milestones, format);
+}
+export async function addTicketMilestone(client, args) {
+    const existing = await fetchTicketFresh(client, args.ticket_id);
+    const format = args.format_options?.format;
+    const currentMilestones = existing.milestones ?? [];
+    const merged = [...currentMilestones, args.milestone];
+    return writeMilestones(client, args.ticket_id, existing, merged, format);
+}
+export async function removeTicketMilestone(client, args) {
+    const existing = await fetchTicketFresh(client, args.ticket_id);
+    const format = args.format_options?.format;
+    const currentMilestones = existing.milestones ?? [];
+    const filtered = currentMilestones.filter((m) => m.id !== args.milestone_id);
+    if (filtered.length === currentMilestones.length) {
+        return JSON.stringify({
+            removed: false,
+            ticket_id: args.ticket_id,
+            milestone_id: args.milestone_id,
+            message: `Milestone id=${args.milestone_id} not found on ticket ${args.ticket_id}.`,
+        }, null, 2);
+    }
+    return writeMilestones(client, args.ticket_id, existing, filtered, format);
+}
+export async function getCurrentMilestone(client, args) {
+    const response = await client.getCached(`/Tickets/${args.parent_ticket_id}`, { includedetails: true }, {
+        enabled: true,
+        ttl: TTL.TICKET_LIST,
+        keyPrefix: `ticket-milestones:${args.parent_ticket_id}`,
+    });
+    const milestones = response.milestones ?? [];
+    const formatOpts = args.format_options ?? { format: 'standard' };
+    // Selection logic:
+    // 1. First milestone with state === 1 (in-progress), if any.
+    // 2. Else: lowest-sequence milestone with state === 0 (upcoming).
+    // 3. Else: null (all complete or no milestones).
+    const inProgress = milestones.find((m) => m.state === 1) ?? null;
+    if (inProgress !== null) {
+        return formatResponse(inProgress, formatOpts, {
+            parent_ticket_id: args.parent_ticket_id,
+            selection: 'in-progress (state=1)',
+        });
+    }
+    const upcoming = milestones
+        .filter((m) => m.state === 0 || m.state === undefined)
+        .sort((a, b) => (a.sequence ?? 0) - (b.sequence ?? 0));
+    if (upcoming.length > 0) {
+        return formatResponse(upcoming[0], formatOpts, {
+            parent_ticket_id: args.parent_ticket_id,
+            selection: 'lowest-sequence upcoming (state=0)',
+        });
+    }
+    return JSON.stringify({
+        current_milestone: null,
+        parent_ticket_id: args.parent_ticket_id,
+        message: 'No in-progress or upcoming milestones found. All milestones may be complete.',
+        milestone_count: milestones.length,
+    }, null, 2);
+}
+// =============================================================================
+// Tool Definitions
+// =============================================================================
+export const listTicketMilestonesTool = {
+    name: 'list_halopsa_ticket_milestones',
+    description: 'Read the milestones[] array from a HaloPSA project ticket. Milestones are nested on the ticket — GET /Ticket/{id}?includedetails=true. Returns [] if none defined. Cached 1 min.',
+    schema: ListTicketMilestonesArgsSchema,
+    handler: listTicketMilestones,
+};
+export const setTicketMilestonesTool = {
+    name: 'set_halopsa_ticket_milestones',
+    description: 'Replace ALL milestones on a HaloPSA project ticket with the provided array. Uses read-before-write merge via POST /Tickets (REPLACE semantics). Returns updated milestones[].',
+    schema: SetTicketMilestonesArgsSchema,
+    handler: setTicketMilestones,
+};
+export const addTicketMilestoneTool = {
+    name: 'add_halopsa_ticket_milestone',
+    description: 'Append a single milestone to a HaloPSA project ticket. Reads existing milestones, appends the new one, then writes the full array via POST /Tickets. Returns updated milestones[].',
+    schema: AddTicketMilestoneArgsSchema,
+    handler: addTicketMilestone,
+};
+export const removeTicketMilestoneTool = {
+    name: 'remove_halopsa_ticket_milestone',
+    description: 'Remove a single milestone (by ID) from a HaloPSA project ticket. Reads existing milestones, filters out the target, then writes the remaining array via POST /Tickets. Returns updated milestones[] or a not-found message.',
+    schema: RemoveTicketMilestoneArgsSchema,
+    handler: removeTicketMilestone,
+};
+export const getCurrentMilestoneTool = {
+    name: 'get_halopsa_current_milestone',
+    description: 'Returns the "current" milestone for a HaloPSA project ticket. Selection: (1) first milestone with state=1 (in-progress); else (2) lowest-sequence milestone with state=0 (upcoming); else null. Useful for dashboards and progress queries. Cached 1 min.',
+    schema: GetCurrentMilestoneArgsSchema,
+    handler: getCurrentMilestone,
+};
+//# sourceMappingURL=milestones.js.map

package/dist/tools/milestones.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"milestones.js","sourceRoot":"","sources":["../../src/tools/milestones.ts"],"names":[],"mappings":"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"}

package/dist/tools/registrations.d.ts

@@ -2,11 +2,15 @@
  * Central tool registration — imports all ZodToolDefinition exports
  * and registers them with a ToolRegistry instance.
  *
- * Tool inventory (49 total):
+ * Tool inventory (67 total):
  *   Assets (11), Users (7), Sites (4), Clients (3),
  *   Reference data (4), Ticket reference data (5),
  *   Tickets (7), Ticket actions (2), Ticket custom fields (2),
- *   Batch operations (4 — assets, users, sites, tickets)
+ *   Batch operations (5 — assets, users, sites, tickets, bulk-update),
+ *   Ticket links (1 — read-side only),
+ *   Workflows (6 — list/get/list-steps/create/update/delete),
+ *   Ticket milestones (5 — list/set/add/remove + get-current),
+ *   Budgets (5 — list/create/delete BudgetType, get/set per-ticket)
  */
 import type { ToolRegistry } from './registry.js';
 export declare function registerAllTools(registry: ToolRegistry): void;

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

@@ -1 +1 @@
-{"version":3,"file":"registrations.d.ts","sourceRoot":"","sources":["../../src/tools/registrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAyJlD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAI7D"}
+{"version":3,"file":"registrations.d.ts","sourceRoot":"","sources":["../../src/tools/registrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAiNlD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAI7D"}

package/dist/tools/registrations.js

@@ -2,11 +2,15 @@
  * Central tool registration — imports all ZodToolDefinition exports
  * and registers them with a ToolRegistry instance.
  *
- * Tool inventory (49 total):
+ * Tool inventory (67 total):
  *   Assets (11), Users (7), Sites (4), Clients (3),
  *   Reference data (4), Ticket reference data (5),
  *   Tickets (7), Ticket actions (2), Ticket custom fields (2),
- *   Batch operations (4 — assets, users, sites, tickets)
+ *   Batch operations (5 — assets, users, sites, tickets, bulk-update),
+ *   Ticket links (1 — read-side only),
+ *   Workflows (6 — list/get/list-steps/create/update/delete),
+ *   Ticket milestones (5 — list/set/add/remove + get-current),
+ *   Budgets (5 — list/create/delete BudgetType, get/set per-ticket)
  */
 // Asset tools (11)
 import { listAssetsTool, getAssetTool, searchAssetsBySerialTool, searchAssetsByHostnameTool, createAssetTool, updateAssetTool, deleteAssetTool, listAssetCustomFieldsTool, getAssetFieldSchemaTool, findAssetMatchTool, scanAssetDuplicatesTool, } from './assets.js';
@@ -26,8 +30,16 @@ import { listTicketsTool, getTicketTool, searchTicketsTool, createTicketTool, up
 import { addTicketActionTool, listTicketActionsTool, } from './ticket-actions.js';
 // Ticket custom field tools (2)
 import { listTicketCustomFieldsTool, getTicketFieldSchemaTool, } from './ticket-custom-fields.js';
-// Batch operations tools (4)
-import { getAssetsBatchTool, getUsersBatchTool, getSitesBatchTool, getTicketsBatchTool, } from './batch-operations.js';
+// Batch operations tools (5)
+import { getAssetsBatchTool, getUsersBatchTool, getSitesBatchTool, getTicketsBatchTool, bulkUpdateTicketsTool, } from './batch-operations.js';
+// Ticket links tools (1)
+import { listLinkedTicketsTool, } from './ticket-links.js';
+// Workflow tools (6)
+import { listWorkflowsTool, getWorkflowTool, listWorkflowStepsTool, createWorkflowTool, updateWorkflowTool, deleteWorkflowTool, } from './workflows.js';
+// Ticket milestone tools (5)
+import { listTicketMilestonesTool, setTicketMilestonesTool, addTicketMilestoneTool, removeTicketMilestoneTool, getCurrentMilestoneTool, } from './milestones.js';
+// Budget tools (5)
+import { listBudgetTypesTool, createBudgetTypeTool, deleteBudgetTypeTool, getTicketBudgetTool, setTicketBudgetTool, } from './budgets.js';
 const allTools = [
     // Assets (11)
     listAssetsTool,
@@ -83,11 +95,33 @@ const allTools = [
     // Ticket custom fields (2)
     listTicketCustomFieldsTool,
     getTicketFieldSchemaTool,
-    // Batch operations (4)
+    // Batch operations (5)
     getAssetsBatchTool,
     getUsersBatchTool,
     getSitesBatchTool,
     getTicketsBatchTool,
+    bulkUpdateTicketsTool,
+    // Ticket links (1)
+    listLinkedTicketsTool,
+    // Workflows (6)
+    listWorkflowsTool,
+    getWorkflowTool,
+    listWorkflowStepsTool,
+    createWorkflowTool,
+    updateWorkflowTool,
+    deleteWorkflowTool,
+    // Ticket milestones (5)
+    listTicketMilestonesTool,
+    setTicketMilestonesTool,
+    addTicketMilestoneTool,
+    removeTicketMilestoneTool,
+    getCurrentMilestoneTool,
+    // Budgets (5)
+    listBudgetTypesTool,
+    createBudgetTypeTool,
+    deleteBudgetTypeTool,
+    getTicketBudgetTool,
+    setTicketBudgetTool,
 ];
 export function registerAllTools(registry) {
     for (const tool of allTools) {

package/dist/tools/registrations.js.map

@@ -1 +1 @@
-{"version":3,"file":"registrations.js","sourceRoot":"","sources":["../../src/tools/registrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,mBAAmB;AACnB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,wBAAwB,EACxB,0BAA0B,EAC1B,eAAe,EACf,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,iBAAiB;AACjB,OAAO,EACL,aAAa,EACb,WAAW,EACX,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,iBAAiB;AACjB,OAAO,EACL,aAAa,EACb,WAAW,EACX,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,aAAa,EACb,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,2BAA2B;AAC3B,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,kCAAkC;AAClC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AAEpC,yFAAyF;AACzF,OAAO,EACL,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,0BAA0B;AAC1B,OAAO,EACL,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,gCAAgC;AAChC,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAEnC,6BAA6B;AAC7B,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,QAAQ,GAAG;IACf,cAAc;IACd,cAAc;IACd,YAAY;IACZ,wBAAwB;IACxB,0BAA0B;IAC1B,eAAe;IACf,eAAe;IACf,eAAe;IACf,yBAAyB;IACzB,uBAAuB;IACvB,kBAAkB;IAClB,uBAAuB;IACvB,YAAY;IACZ,aAAa;IACb,WAAW;IACX,sBAAsB;IACtB,cAAc;IACd,cAAc;IACd,iBAAiB;IACjB,sBAAsB;IACtB,YAAY;IACZ,aAAa;IACb,WAAW;IACX,cAAc;IACd,iBAAiB;IACjB,cAAc;IACd,eAAe;IACf,aAAa;IACb,iBAAiB;IACjB,qBAAqB;IACrB,kBAAkB;IAClB,qBAAqB;IACrB,oBAAoB;IACpB,cAAc;IACd,4BAA4B;IAC5B,mBAAmB;IACnB,iBAAiB;IACjB,sBAAsB;IACtB,wBAAwB;IACxB,wBAAwB;IACxB,cAAc;IACd,eAAe;IACf,aAAa;IACb,iBAAiB;IACjB,gBAAgB;IAChB,gBAAgB;IAChB,eAAe;IACf,gBAAgB;IAChB,qBAAqB;IACrB,mBAAmB;IACnB,qBAAqB;IACrB,2BAA2B;IAC3B,0BAA0B;IAC1B,wBAAwB;IACxB,uBAAuB;IACvB,kBAAkB;IAClB,iBAAiB;IACjB,iBAAiB;IACjB,mBAAmB;CACpB,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,QAAsB;IACrD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC"}
+{"version":3,"file":"registrations.js","sourceRoot":"","sources":["../../src/tools/registrations.ts"],"names":[],"mappings":"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"}

package/dist/tools/ticket-links.d.ts

@@ -0,0 +1,41 @@
+/**
+ * HaloPSA Ticket Links tools (read-side only).
+ *
+ * The dedicated /IntegrationData/Get/HaloLink endpoint returned HTTP 400 on
+ * empirical testing against the live tenant (2026-05-11) with naive params —
+ * the correct invocation parameters have not yet been isolated. Deferred to
+ * v1.4. This file ships the read-side only via the ticket's nested
+ * `linked_tickets` array returned by GET /Tickets/{id}?includedetails=true.
+ *
+ * TODO(v1.4): probe /IntegrationData/Get/HaloLink with corrected params and
+ * implement create_halopsa_ticket_link / delete_halopsa_ticket_link.
+ */
+import { z } from 'zod';
+import type { HaloPSAAPIClient } from '../api/client.js';
+import type { ZodToolDefinition } from './registry.js';
+export declare const ListLinkedTicketsArgsSchema: z.ZodObject<{
+    ticket_id: z.ZodNumber;
+    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>;
+/**
+ * Retrieve linked tickets for a given ticket ID.
+ *
+ * Fetches GET /Tickets/{id}?includedetails=true and surfaces:
+ *   - linked_tickets[] (or [] if absent) — compact shape: {linked_ticket_id, link_type?, summary?}
+ *   - parent_id (canonical "depends on / blocks" link)
+ *   - child_count
+ *   - linked_halo_ticket_count
+ *
+ * Cache key: 'ticket-links:{id}', TTL 1 min (same cadence as TICKET_LIST).
+ */
+export declare function listLinkedTickets(client: HaloPSAAPIClient, args: z.infer<typeof ListLinkedTicketsArgsSchema>): Promise<string>;
+export declare const listLinkedTicketsTool: ZodToolDefinition;
+//# sourceMappingURL=ticket-links.d.ts.map

package/dist/tools/ticket-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket-links.d.ts","sourceRoot":"","sources":["../../src/tools/ticket-links.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;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;AAiDvD,eAAO,MAAM,2BAA2B;;;;;;;;;;;iBAItC,CAAC;AAMH;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,GAChD,OAAO,CAAC,MAAM,CAAC,CAuCjB;AAMD,eAAO,MAAM,qBAAqB,EAAE,iBAUnC,CAAC"}

package/dist/tools/ticket-links.js

@@ -0,0 +1,84 @@
+/**
+ * HaloPSA Ticket Links tools (read-side only).
+ *
+ * The dedicated /IntegrationData/Get/HaloLink endpoint returned HTTP 400 on
+ * empirical testing against the live tenant (2026-05-11) with naive params —
+ * the correct invocation parameters have not yet been isolated. Deferred to
+ * v1.4. This file ships the read-side only via the ticket's nested
+ * `linked_tickets` array returned by GET /Tickets/{id}?includedetails=true.
+ *
+ * TODO(v1.4): probe /IntegrationData/Get/HaloLink with corrected params and
+ * implement create_halopsa_ticket_link / delete_halopsa_ticket_link.
+ */
+import { z } from 'zod';
+import { formatResponse } from '../utils/formatter.js';
+import { TTL } from '../cache/memory-cache.js';
+import { FormatOptionsSchema } from '../schemas/common.js';
+// =============================================================================
+// Schema
+// =============================================================================
+export const ListLinkedTicketsArgsSchema = z.object({
+    ticket_id: z.number().int()
+        .describe('HaloPSA ticket ID whose linked tickets to retrieve'),
+    format_options: FormatOptionsSchema,
+});
+// =============================================================================
+// Implementation
+// =============================================================================
+/**
+ * Retrieve linked tickets for a given ticket ID.
+ *
+ * Fetches GET /Tickets/{id}?includedetails=true and surfaces:
+ *   - linked_tickets[] (or [] if absent) — compact shape: {linked_ticket_id, link_type?, summary?}
+ *   - parent_id (canonical "depends on / blocks" link)
+ *   - child_count
+ *   - linked_halo_ticket_count
+ *
+ * Cache key: 'ticket-links:{id}', TTL 1 min (same cadence as TICKET_LIST).
+ */
+export async function listLinkedTickets(client, args) {
+    const formatOptions = args.format_options || {};
+    const ticket = await client.getCached(`/Tickets/${args.ticket_id}`, { includedetails: true }, {
+        enabled: true,
+        ttl: TTL.TICKET_LIST,
+        keyPrefix: `ticket-links:${args.ticket_id}`,
+    });
+    // Surface the link-context fields from the ticket.
+    const rawLinks = ticket.linked_tickets ?? [];
+    // Compact shape: strip to {linked_ticket_id, link_type?, summary?} per entry.
+    const compactLinks = rawLinks.map((entry) => {
+        const slim = {
+            linked_ticket_id: entry.linked_ticket_id,
+        };
+        if (entry.link_type !== undefined)
+            slim.link_type = entry.link_type;
+        if (entry.summary !== undefined)
+            slim.summary = entry.summary;
+        return slim;
+    });
+    const context = {
+        ticket_id: args.ticket_id,
+        ...(ticket.parent_id !== undefined && { parent_id: ticket.parent_id }),
+        ...(ticket.child_count !== undefined && { child_count: ticket.child_count }),
+        ...(ticket.linked_halo_ticket_count !== undefined && {
+            linked_halo_ticket_count: ticket.linked_halo_ticket_count,
+        }),
+        linked_tickets: compactLinks,
+    };
+    const meta = { total_linked: compactLinks.length };
+    return formatResponse(context, formatOptions, meta);
+}
+// =============================================================================
+// Tool Definition
+// =============================================================================
+export const listLinkedTicketsTool = {
+    name: 'list_halopsa_linked_tickets',
+    description: 'Return the linked_tickets[] array for a HaloPSA ticket (read-side only). ' +
+        'Fetches GET /Tickets/{id}?includedetails=true and surfaces linked_tickets[], ' +
+        'parent_id, child_count, and linked_halo_ticket_count. ' +
+        'Compact response shape per entry: {linked_ticket_id, link_type?, summary?}. ' +
+        'Cache key ticket-links:{id}, TTL 1 min.',
+    schema: ListLinkedTicketsArgsSchema,
+    handler: listLinkedTickets,
+};
+//# sourceMappingURL=ticket-links.js.map

package/dist/tools/ticket-links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket-links.js","sourceRoot":"","sources":["../../src/tools/ticket-links.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAsB,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AA0C3D,gFAAgF;AAChF,SAAS;AACT,gFAAgF;AAEhF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;SACxB,QAAQ,CAAC,oDAAoD,CAAC;IACjE,cAAc,EAAE,mBAAmB;CACpC,CAAC,CAAC;AAEH,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAwB,EACxB,IAAiD;IAEjD,MAAM,aAAa,GAAkB,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC;IAE/D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CACnC,YAAY,IAAI,CAAC,SAAS,EAAE,EAC5B,EAAE,cAAc,EAAE,IAAI,EAAE,EACxB;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,GAAG,CAAC,WAAW;QACpB,SAAS,EAAE,gBAAgB,IAAI,CAAC,SAAS,EAAE;KAC5C,CACF,CAAC;IAEF,mDAAmD;IACnD,MAAM,QAAQ,GAA0B,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC;IAEpE,8EAA8E;IAC9E,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1C,MAAM,IAAI,GAA4B;YACpC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;SACzC,CAAC;QACF,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACpE,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAyB;QACpC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,GAAG,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QACtE,GAAG,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;QAC5E,GAAG,CAAC,MAAM,CAAC,wBAAwB,KAAK,SAAS,IAAI;YACnD,wBAAwB,EAAE,MAAM,CAAC,wBAAwB;SAC1D,CAAC;QACF,cAAc,EAAE,YAAY;KAC7B,CAAC;IAEF,MAAM,IAAI,GAAG,EAAE,YAAY,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC;IAEnD,OAAO,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACtD,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,2EAA2E;QAC3E,+EAA+E;QAC/E,wDAAwD;QACxD,8EAA8E;QAC9E,yCAAyC;IAC3C,MAAM,EAAE,2BAA2B;IACnC,OAAO,EAAE,iBAAiB;CAC3B,CAAC"}

package/dist/tools/tickets.d.ts

@@ -97,6 +97,7 @@ export declare const CreateTicketArgsSchema: z.ZodObject<{
     }, z.core.$strip>>>;
     estimate: z.ZodOptional<z.ZodNumber>;
     estimatedays: z.ZodOptional<z.ZodNumber>;
+    milestone_id: z.ZodOptional<z.ZodNumber>;
     format_options: z.ZodOptional<z.ZodObject<{
         format: z.ZodOptional<z.ZodEnum<{
             compact: "compact";
@@ -130,6 +131,7 @@ export declare const UpdateTicketArgsSchema: z.ZodObject<{
     }, z.core.$strip>>>;
     estimate: z.ZodOptional<z.ZodNumber>;
     estimatedays: z.ZodOptional<z.ZodNumber>;
+    milestone_id: z.ZodOptional<z.ZodNumber>;
     format_options: z.ZodOptional<z.ZodObject<{
         format: z.ZodOptional<z.ZodEnum<{
             compact: "compact";

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;AA+BvD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwChC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;iBAI9B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;iBAUlC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsCjC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4BjC,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,CA8BjB;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,GAC3C,OAAO,CAAC,MAAM,CAAC,CA8CjB;AAgBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,GAC3C,OAAO,CAAC,MAAM,CAAC,CA0HjB;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}