@wilnertech/halopsa-mcp-server 1.2.0 → 1.3.0

package/dist/tools/budgets.js

@@ -0,0 +1,277 @@
+/**
+ * HaloPSA Budget Management tools.
+ *
+ * Covers two domains:
+ *  1. BudgetType — top-level reference CRUD (/BudgetType).
+ *  2. Per-ticket budgets — nested ticket.budgets[] array, managed via
+ *     read-before-write POST /Tickets (Halo REPLACE, not PATCH semantics).
+ *
+ * Safety:
+ *  - delete_halopsa_budget_type applies a two-factor OVERRIDE gate (same
+ *    pattern as delete_halopsa_ticket): reason >= 5 chars required;
+ *    confirm_destructive + "OVERRIDE" substring to bypass a soft refusal.
+ *  - set_halopsa_ticket_budget REPLACES all budgets on the ticket; callers
+ *    should fetch current budgets first if they need a partial update.
+ */
+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
+// =============================================================================
+export const ListBudgetTypesArgsSchema = z.object({
+    format_options: FormatOptionsSchema,
+});
+export const CreateBudgetTypeArgsSchema = z.object({
+    name: z.string().min(1)
+        .describe('Budget type name (required)'),
+    defaultrate: z.number().optional()
+        .describe('Default hourly rate for this budget type'),
+    chargerate: z.number().optional()
+        .describe('Charge rate override for this budget type'),
+    format_options: FormatOptionsSchema,
+});
+export const DeleteBudgetTypeArgsSchema = z.object({
+    budget_type_id: z.number().int()
+        .describe('HaloPSA BudgetType ID to delete'),
+    reason: z.string().min(5).describe('REQUIRED audit-trail reason (min 5 chars). To bypass the soft safety refusal, ' +
+        'the reason MUST include the substring "OVERRIDE" (case-sensitive) AND ' +
+        'confirm_destructive must be true.'),
+    confirm_destructive: z.boolean().optional().default(false).describe('Set true AND include "OVERRIDE" in reason to bypass the soft safety refusal. Default false.'),
+    format_options: FormatOptionsSchema,
+});
+export const GetTicketBudgetArgsSchema = z.object({
+    ticket_id: z.number().int()
+        .describe('HaloPSA ticket ID'),
+    format_options: FormatOptionsSchema,
+});
+/** Input shape for a single budget entry in set_halopsa_ticket_budget. */
+const BudgetEntryInputSchema = z.object({
+    budgettype_id: z.number().int()
+        .describe('Budget type ID — see list_halopsa_budget_types'),
+    hours: z.number().optional()
+        .describe('Budgeted hours for this type'),
+    days: z.number().optional()
+        .describe('Budgeted days for this type'),
+    rate: z.number().optional()
+        .describe('Rate override for this budget entry'),
+});
+export const SetTicketBudgetArgsSchema = z.object({
+    ticket_id: z.number().int()
+        .describe('HaloPSA ticket ID'),
+    budgets: z.array(BudgetEntryInputSchema).min(1)
+        .describe('Full replacement budget array. REPLACES all existing budgets on the ticket. ' +
+        'Each entry requires budgettype_id; hours/days/rate are optional.'),
+    format_options: FormatOptionsSchema,
+});
+// =============================================================================
+// Helpers
+// =============================================================================
+/** Compact fields for budget type list responses. */
+const BUDGET_TYPE_COMPACT_FIELDS = ['id', 'name', 'defaultrate'];
+function resolveBudgetTypeListFormat(input) {
+    const opts = { ...(input || {}) };
+    if (!opts.format) {
+        opts.format = 'standard';
+        opts.fields = opts.fields ?? BUDGET_TYPE_COMPACT_FIELDS;
+    }
+    return opts;
+}
+/**
+ * Unwrap a BudgetType write response — Halo POST returns either a single
+ * object or a single-element array depending on tenant config.
+ */
+function unwrapBudgetTypeWrite(response) {
+    return Array.isArray(response) ? response[0] : response;
+}
+// =============================================================================
+// Implementations
+// =============================================================================
+/**
+ * List all budget types (reference data).
+ * Cached 1 hour. Compact response returns {id, name, defaultrate}.
+ */
+export async function listBudgetTypes(client, args) {
+    const formatOpts = resolveBudgetTypeListFormat(args.format_options);
+    const response = await client.getCached('/BudgetType', { count: 100 }, {
+        enabled: true,
+        ttl: TTL.BUDGET_TYPES,
+        keyPrefix: 'budget-types:all',
+    });
+    let budgetTypes;
+    let recordCount;
+    if (Array.isArray(response)) {
+        budgetTypes = response;
+        recordCount = response.length;
+    }
+    else {
+        budgetTypes = response.budget_types ?? [];
+        recordCount = response.record_count ?? budgetTypes.length;
+    }
+    return formatResponse(budgetTypes, formatOpts, { record_count: recordCount });
+}
+/**
+ * Create a new budget type.
+ * POST /BudgetType with array-wrapped body (Halo convention).
+ * Invalidates budget-types cache.
+ */
+export async function createBudgetType(client, args) {
+    const payload = {
+        name: args.name,
+    };
+    if (args.defaultrate !== undefined)
+        payload.defaultrate = args.defaultrate;
+    if (args.chargerate !== undefined)
+        payload.chargerate = args.chargerate;
+    const created = unwrapBudgetTypeWrite(await client.post('/BudgetType', [payload]));
+    client.invalidateCache('budget-types:*');
+    const format = args.format_options?.format ?? 'compact';
+    // Budget types have no heavy nested objects — passthrough (no entity-specific strip needed).
+    return formatResponse(created, { format });
+}
+/**
+ * Delete a budget type by ID.
+ *
+ * Safety gate (adapted from deleteTicket):
+ *  - Reason is always required (min 5 chars; validated by Zod).
+ *  - A soft refusal is issued by default with a warning that dependent tickets
+ *    cannot be automatically checked (Halo does not support budgettype_id
+ *    filtering on /Tickets). The caller is instructed to verify manually.
+ *  - To bypass: confirm_destructive: true AND reason includes "OVERRIDE".
+ *  - 404 on GET is idempotent (already_absent: true).
+ */
+export async function deleteBudgetType(client, args) {
+    // Step 1: Verify existence. 404 is idempotent.
+    let existing;
+    try {
+        existing = await client.get(`/BudgetType/${args.budget_type_id}`);
+    }
+    catch (error) {
+        const status = error?.response?.status;
+        if (status === 404) {
+            return JSON.stringify({ already_absent: true, deleted_id: args.budget_type_id }, null, 2);
+        }
+        throw error;
+    }
+    // Step 2: Accumulate violations. Halo does not expose a query filter for
+    // budgettype_id on /Tickets, so we cannot automatically probe for open-ticket
+    // references. Issue a standing warning instead.
+    const violations = [];
+    violations.push('dependency-check-unavailable: Halo /Tickets does not support budgettype_id filtering. ' +
+        `Caller must verify that no open tickets reference budgettype_id=${args.budget_type_id} ` +
+        `(name: "${existing.name}") before deletion.`);
+    // Step 3: Decision matrix.
+    const overrideProvided = args.confirm_destructive === true && args.reason.includes('OVERRIDE');
+    if (!overrideProvided) {
+        return JSON.stringify({
+            deleted: false,
+            refused: true,
+            budget_type_id: args.budget_type_id,
+            budget_type_name: existing.name,
+            violations,
+            remediation: "Pass confirm_destructive: true AND include 'OVERRIDE' (case-sensitive) in the reason to proceed. " +
+                'Manually confirm no open tickets reference this budget type before overriding.',
+        }, null, 2);
+    }
+    // Step 4: Execute DELETE.
+    await client.delete(`/BudgetType/${args.budget_type_id}?reason=${encodeURIComponent(args.reason)}`);
+    // Step 5: Cache invalidation.
+    client.invalidateCache('budget-types:*');
+    // Step 6: Structured success.
+    return JSON.stringify({
+        deleted: true,
+        budget_type_id: args.budget_type_id,
+        budget_type_name: existing.name,
+        reason: args.reason,
+        override_used: true,
+        safety_violations_bypassed: violations,
+    }, null, 2);
+}
+/**
+ * Get all budget entries for a specific ticket.
+ * Fetches GET /Tickets/{id}?includedetails=true and returns ticket.budgets[].
+ * Cache key 'ticket-budgets:{id}' TTL 1 min.
+ */
+export async function getTicketBudget(client, args) {
+    const formatOpts = args.format_options || { format: 'detailed' };
+    const ticket = await client.getCached(`/Tickets/${args.ticket_id}`, { includedetails: true }, {
+        enabled: true,
+        ttl: TTL.TICKET_LIST,
+        keyPrefix: `ticket-budgets:${args.ticket_id}`,
+    });
+    const budgets = ticket.budgets ?? [];
+    return formatResponse(budgets, formatOpts, { record_count: budgets.length, ticket_id: args.ticket_id });
+}
+/**
+ * Replace the budget array on a ticket.
+ *
+ * Read-before-write merge: fetches the existing ticket, spreads it into the
+ * POST body, and replaces the budgets[] array entirely (Halo REPLACE semantics).
+ * Returns the updated ticket's budgets[] after strip.
+ */
+export async function setTicketBudget(client, args) {
+    // Read the baseline ticket (no cache — must be current).
+    const existing = await client.get(`/Tickets/${args.ticket_id}`, { includedetails: true });
+    const newBudgets = args.budgets.map((b) => {
+        const entry = { budgettype_id: b.budgettype_id };
+        if (b.hours !== undefined)
+            entry.hours = b.hours;
+        if (b.days !== undefined)
+            entry.days = b.days;
+        if (b.rate !== undefined)
+            entry.rate = b.rate;
+        return entry;
+    });
+    const mergedPayload = { ...existing, budgets: newBudgets, id: args.ticket_id };
+    // POST /Tickets with array wrapper (Halo convention).
+    const rawResponse = await client.post('/Tickets', [mergedPayload]);
+    const updated = Array.isArray(rawResponse) ? rawResponse[0] : rawResponse;
+    // Cache invalidation.
+    client.invalidateCache('tickets:*');
+    client.invalidateCache(`ticket:${args.ticket_id}*`);
+    client.invalidateCache(`ticket-budgets:${args.ticket_id}*`);
+    const format = args.format_options?.format ?? 'compact';
+    const stripped = stripWriteResponse(updated, format, 'ticket');
+    // Return only the budgets sub-array from the updated ticket for clarity.
+    const returnedBudgets = stripped['budgets'] ?? updated.budgets ?? [];
+    return formatResponse(returnedBudgets, { format }, { ticket_id: args.ticket_id });
+}
+// =============================================================================
+// Tool Definitions
+// =============================================================================
+export const listBudgetTypesTool = {
+    name: 'list_halopsa_budget_types',
+    description: 'List all HaloPSA budget types (reference data). Compact response returns {id, name, defaultrate}. Cached 1 hour.',
+    schema: ListBudgetTypesArgsSchema,
+    handler: listBudgetTypes,
+};
+export const createBudgetTypeTool = {
+    name: 'create_halopsa_budget_type',
+    description: 'Create a new HaloPSA budget type. POST /BudgetType with array-wrapped body (Halo convention). Invalidates budget-types cache.',
+    schema: CreateBudgetTypeArgsSchema,
+    handler: createBudgetType,
+};
+export const deleteBudgetTypeTool = {
+    name: 'delete_halopsa_budget_type',
+    description: 'Delete a HaloPSA budget type by ID. Issues a soft safety refusal by default because Halo does not support ' +
+        'automatic dependency checking via /Tickets?budgettype_id=X. Pass confirm_destructive: true AND include ' +
+        '"OVERRIDE" (case-sensitive) in reason to proceed after manual verification. 404 returns already_absent: true (idempotent).',
+    schema: DeleteBudgetTypeArgsSchema,
+    handler: deleteBudgetType,
+};
+export const getTicketBudgetTool = {
+    name: 'get_halopsa_ticket_budget',
+    description: 'Get the budget entries for a HaloPSA ticket. Returns ticket.budgets[] (or [] if none set). Cached 1 min.',
+    schema: GetTicketBudgetArgsSchema,
+    handler: getTicketBudget,
+};
+export const setTicketBudgetTool = {
+    name: 'set_halopsa_ticket_budget',
+    description: 'Replace the budget array on a HaloPSA ticket. Performs read-before-write merge (Halo POST is REPLACE not PATCH). ' +
+        'The supplied budgets[] array FULLY REPLACES any existing budgets. Each entry requires budgettype_id; ' +
+        'hours/days/rate are optional. Returns the updated ticket budgets field.',
+    schema: SetTicketBudgetArgsSchema,
+    handler: setTicketBudget,
+};
+//# sourceMappingURL=budgets.js.map

package/dist/tools/budgets.js.map

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

package/dist/tools/milestones.d.ts

@@ -0,0 +1,90 @@
+/**
+ * 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 type { HaloPSAAPIClient } from '../api/client.js';
+import type { ZodToolDefinition } from './registry.js';
+export declare const ListTicketMilestonesArgsSchema: 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>;
+export declare const SetTicketMilestonesArgsSchema: z.ZodObject<{
+    ticket_id: z.ZodNumber;
+    milestones: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        target_date: z.ZodString;
+        start_date: z.ZodOptional<z.ZodString>;
+        sequence: z.ZodOptional<z.ZodNumber>;
+        billing_amount: z.ZodOptional<z.ZodNumber>;
+        status_id: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    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 const AddTicketMilestoneArgsSchema: z.ZodObject<{
+    ticket_id: z.ZodNumber;
+    milestone: z.ZodObject<{
+        name: z.ZodString;
+        target_date: z.ZodString;
+        start_date: z.ZodOptional<z.ZodString>;
+        sequence: z.ZodOptional<z.ZodNumber>;
+        billing_amount: z.ZodOptional<z.ZodNumber>;
+        status_id: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    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 const RemoveTicketMilestoneArgsSchema: z.ZodObject<{
+    ticket_id: z.ZodNumber;
+    milestone_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>;
+export declare function listTicketMilestones(client: HaloPSAAPIClient, args: z.infer<typeof ListTicketMilestonesArgsSchema>): Promise<string>;
+export declare function setTicketMilestones(client: HaloPSAAPIClient, args: z.infer<typeof SetTicketMilestonesArgsSchema>): Promise<string>;
+export declare function addTicketMilestone(client: HaloPSAAPIClient, args: z.infer<typeof AddTicketMilestoneArgsSchema>): Promise<string>;
+export declare function removeTicketMilestone(client: HaloPSAAPIClient, args: z.infer<typeof RemoveTicketMilestoneArgsSchema>): Promise<string>;
+export declare const listTicketMilestonesTool: ZodToolDefinition;
+export declare const setTicketMilestonesTool: ZodToolDefinition;
+export declare const addTicketMilestoneTool: ZodToolDefinition;
+export declare const removeTicketMilestoneTool: ZodToolDefinition;
+//# sourceMappingURL=milestones.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"milestones.d.ts","sourceRoot":"","sources":["../../src/tools/milestones.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;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;AA6BvD,eAAO,MAAM,8BAA8B;;;;;;;;;;;iBAIzC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;iBAMxC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;iBAMvC,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;iBAM1C,CAAC;AAmEH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,GACnD,OAAO,CAAC,MAAM,CAAC,CAkBjB;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,GAClD,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,GACjD,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,GACpD,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAMD,eAAO,MAAM,wBAAwB,EAAE,iBAKtC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,iBAKrC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,iBAKpC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,iBAKvC,CAAC"}

package/dist/tools/milestones.js

@@ -0,0 +1,170 @@
+/**
+ * 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'),
+});
+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,
+});
+// =============================================================================
+// 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,
+    });
+}
+// =============================================================================
+// 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 ?? [];
+    const formatOpts = args.format_options ?? { format: 'standard' };
+    return formatResponse(milestones, formatOpts, {
+        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);
+}
+// =============================================================================
+// 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,
+};
+//# 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 (66 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 (4 — list/set/add/remove on parent ticket),
+ *   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;AA+MlD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAI7D"}