@wilnertech/halopsa-mcp-server 1.0.1 → 1.1.0

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

@@ -0,0 +1,185 @@
+/**
+ * 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
+ * optimization) and use 1-hour cache TTLs because reference data on a
+ * Halo tenant changes infrequently — most reads should hit cache.
+ *
+ * The tools deliberately accept BOTH a `full` boolean shortcut AND the
+ * 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.
+ */
+import { z } from 'zod';
+import { formatResponse } from '../utils/formatter.js';
+import { TTL } from '../cache/memory-cache.js';
+import { FormatOptionsSchema } from '../schemas/common.js';
+// =============================================================================
+// Schemas
+// =============================================================================
+const ListTicketTypesArgsSchema = z.object({
+    full: z.boolean().optional()
+        .describe('Return full records instead of compact (default false). Equivalent to format_options.format="detailed".'),
+    format_options: FormatOptionsSchema,
+});
+const GetTicketTypeArgsSchema = z.object({
+    tickettype_id: z.number().int()
+        .describe('HaloPSA ticket type ID'),
+    format_options: FormatOptionsSchema,
+});
+const ListTicketStatusesArgsSchema = z.object({
+    full: z.boolean().optional()
+        .describe('Return full records instead of compact (default false).'),
+    format_options: FormatOptionsSchema,
+});
+const ListTicketPrioritiesArgsSchema = z.object({
+    full: z.boolean().optional()
+        .describe('Return full records instead of compact (default false).'),
+    format_options: FormatOptionsSchema,
+});
+const ListTicketCategoriesArgsSchema = z.object({
+    full: z.boolean().optional()
+        .describe('Return full records instead of compact (default false).'),
+    format_options: FormatOptionsSchema,
+});
+// =============================================================================
+// Helpers
+// =============================================================================
+/**
+ * Resolve the effective FormatOptions from caller input, defaulting to
+ * compact unless the user opted in to a fuller view via `full: true` or
+ * an explicit `format_options.format`.
+ */
+function resolveFormat(full, formatOptions) {
+    const opts = { ...(formatOptions || {}) };
+    if (full && !opts.format) {
+        opts.format = 'detailed';
+    }
+    if (!opts.format) {
+        opts.format = 'compact';
+    }
+    return opts;
+}
+/**
+ * Normalize a raw /Priority record.
+ *
+ * The raw API shape has:
+ *   - `id`:         GUID string — uniquely identifies this priority+SLA combo
+ *   - `priorityid`: integer 1-4 — the value Faults.priority_id expects
+ *
+ * We promote `priorityid` to `id` and expose the GUID as `sla_priority_id`
+ * to prevent callers from accidentally passing the GUID as priority_id.
+ */
+function normalizePriority(p) {
+    return {
+        id: p.priorityid,
+        name: p.name,
+        sla_priority_id: p.id,
+        slaid: p.slaid,
+        fixtime: p.fixtime,
+        fixunits: p.fixunits,
+        responsetime: p.responsetime,
+        responseunits: p.responseunits,
+        colour: p.colour,
+        firstresponsetime: p.firstresponsetime,
+        firstresponseunits: p.firstresponseunits,
+    };
+}
+/** Halo list endpoints return either bare arrays or `{ <plural>: [...] }`. */
+function unwrapList(response, preferredKey) {
+    if (Array.isArray(response)) {
+        return { items: response, record_count: response.length };
+    }
+    const wrapped = response;
+    const items = wrapped[preferredKey] ?? [];
+    const record_count = wrapped.record_count ?? items.length;
+    return { items, record_count };
+}
+// =============================================================================
+// Implementations
+// =============================================================================
+export async function listTicketTypes(client, args) {
+    const formatOpts = resolveFormat(args.full, args.format_options);
+    const response = await client.getCached('/TicketType', { count: 500 }, {
+        enabled: true,
+        ttl: TTL.TICKET_TYPES,
+        keyPrefix: 'tickettypes:all',
+    });
+    const { items, record_count } = unwrapList(response, 'tickettypes');
+    return formatResponse(items, formatOpts, { record_count });
+}
+export async function getTicketType(client, args) {
+    const formatOpts = args.format_options || { format: 'standard' };
+    const response = await client.getCached(`/TicketType/${args.tickettype_id}`, undefined, {
+        enabled: true,
+        ttl: TTL.TICKET_TYPES,
+        keyPrefix: `tickettype:${args.tickettype_id}`,
+    });
+    return formatResponse(response, formatOpts);
+}
+export async function listTicketStatuses(client, args) {
+    const formatOpts = resolveFormat(args.full, args.format_options);
+    const response = await client.getCached('/Status', { count: 500 }, {
+        enabled: true,
+        ttl: TTL.TICKET_STATUSES,
+        keyPrefix: 'ticketstatuses:all',
+    });
+    const { items, record_count } = unwrapList(response, 'statuses');
+    return formatResponse(items, formatOpts, { record_count });
+}
+export async function listTicketPriorities(client, args) {
+    const formatOpts = resolveFormat(args.full, args.format_options);
+    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 });
+}
+export async function listTicketCategories(client, args) {
+    const formatOpts = resolveFormat(args.full, args.format_options);
+    const response = await client.getCached('/Category', { count: 500 }, {
+        enabled: true,
+        ttl: TTL.TICKET_CATEGORIES,
+        keyPrefix: 'ticketcategories:all',
+    });
+    const { items, record_count } = unwrapList(response, 'categories');
+    return formatResponse(items, formatOpts, { record_count });
+}
+// =============================================================================
+// Tool Definitions
+// =============================================================================
+export const listTicketTypesTool = {
+    name: 'list_halopsa_tickettypes',
+    description: 'List all HaloPSA ticket types (Incident, Service Request, Change, etc.) with 1h cache. Compact by default; pass full=true for full records.',
+    schema: ListTicketTypesArgsSchema,
+    handler: listTicketTypes,
+};
+export const getTicketTypeTool = {
+    name: 'get_halopsa_tickettype',
+    description: 'Get a single HaloPSA ticket type by ID. Cached 1h.',
+    schema: GetTicketTypeArgsSchema,
+    handler: getTicketType,
+};
+export const listTicketStatusesTool = {
+    name: 'list_halopsa_ticket_statuses',
+    description: 'List HaloPSA ticket statuses. Each record carries `type` (0=regular ticket statuses, 1=Order, 2=Item, 3=Action Required/Invoiced/With CAB) and `sequence` (UI ordering). NOTE: the API does NOT return `complete` / `is_closed` / `is_active` flags despite some prior documentation. To find the canonical Closed status, match `name === "Closed" && type === 0` (returns id=9 on this tenant). For Order/Item flavours, see id=13 "Closed Order" (type=1) and id=15 "Closed Item" (type=2). Cached 1h.',
+    schema: ListTicketStatusesArgsSchema,
+    handler: listTicketStatuses,
+};
+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.',
+    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.',
+    schema: ListTicketCategoriesArgsSchema,
+    handler: listTicketCategories,
+};
+//# sourceMappingURL=ticket-reference-data.js.map

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

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

package/dist/tools/tickets.d.ts

@@ -0,0 +1,168 @@
+/**
+ * HaloPSA Ticket CRUD tools.
+ *
+ * Tickets are append-only business events — unlike assets/users/sites,
+ * there is no `find_*_match` deduplication step. Update by explicit id
+ * always.
+ *
+ * Update mechanics mirror `updateAsset` in `src/tools/assets.ts`:
+ * Halo's POST /api/Tickets is REPLACE-not-PATCH, so we read the current
+ * record first and spread it under the partial payload before sending.
+ *
+ * Compact responses INTENTIONALLY omit `details_html` (HTML body, can be
+ * 50KB+) and `customfields[]` to keep MCP responses sub-second and
+ * within token budgets. Callers that need them call `get_halopsa_ticket`
+ * or pass `format_options.format = 'detailed'` / `full: true`.
+ */
+import { z } from 'zod';
+import type { HaloPSAAPIClient } from '../api/client.js';
+import type { ZodToolDefinition } from './registry.js';
+export declare const ListTicketsArgsSchema: z.ZodObject<{
+    client_id: z.ZodOptional<z.ZodNumber>;
+    client_ids: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodArray<z.ZodNumber>]>>;
+    site_id: z.ZodOptional<z.ZodNumber>;
+    user_id: z.ZodOptional<z.ZodNumber>;
+    agent_id: z.ZodOptional<z.ZodNumber>;
+    agent: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodArray<z.ZodNumber>]>>;
+    team_id: z.ZodOptional<z.ZodNumber>;
+    tickettype_id: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodArray<z.ZodNumber>]>>;
+    status_id: z.ZodOptional<z.ZodNumber>;
+    category_1: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodArray<z.ZodNumber>]>>;
+    category_2: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodArray<z.ZodNumber>]>>;
+    category_3: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodArray<z.ZodNumber>]>>;
+    category_4: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodArray<z.ZodNumber>]>>;
+    search: z.ZodOptional<z.ZodString>;
+    open_only: z.ZodOptional<z.ZodBoolean>;
+    date_from: z.ZodOptional<z.ZodString>;
+    date_to: z.ZodOptional<z.ZodString>;
+    count: z.ZodOptional<z.ZodNumber>;
+    page_no: z.ZodOptional<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 GetTicketArgsSchema: 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 SearchTicketsArgsSchema: z.ZodObject<{
+    search: z.ZodString;
+    client_id: z.ZodOptional<z.ZodNumber>;
+    open_only: z.ZodOptional<z.ZodBoolean>;
+    count: z.ZodOptional<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 CreateTicketArgsSchema: z.ZodObject<{
+    summary: z.ZodString;
+    tickettype_id: z.ZodNumber;
+    client_id: z.ZodNumber;
+    details_html: z.ZodOptional<z.ZodString>;
+    category_1: z.ZodOptional<z.ZodString>;
+    priority_id: z.ZodOptional<z.ZodNumber>;
+    status_id: z.ZodOptional<z.ZodNumber>;
+    source: z.ZodOptional<z.ZodNumber>;
+    agent_id: z.ZodOptional<z.ZodNumber>;
+    team_id: z.ZodOptional<z.ZodNumber>;
+    site_id: z.ZodOptional<z.ZodNumber>;
+    user_id: z.ZodOptional<z.ZodNumber>;
+    parent_id: z.ZodOptional<z.ZodNumber>;
+    dateoccurred: z.ZodOptional<z.ZodString>;
+    startdate: z.ZodOptional<z.ZodString>;
+    customfields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodNumber>;
+        name: z.ZodOptional<z.ZodString>;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const UpdateTicketArgsSchema: z.ZodObject<{
+    ticket_id: z.ZodNumber;
+    summary: z.ZodOptional<z.ZodString>;
+    details_html: z.ZodOptional<z.ZodString>;
+    tickettype_id: z.ZodOptional<z.ZodNumber>;
+    status_id: z.ZodOptional<z.ZodNumber>;
+    priority_id: z.ZodOptional<z.ZodNumber>;
+    category_1: z.ZodOptional<z.ZodString>;
+    agent_id: z.ZodOptional<z.ZodNumber>;
+    team_id: z.ZodOptional<z.ZodNumber>;
+    site_id: z.ZodOptional<z.ZodNumber>;
+    user_id: z.ZodOptional<z.ZodNumber>;
+    parent_id: z.ZodOptional<z.ZodNumber>;
+    dateoccurred: z.ZodOptional<z.ZodString>;
+    startdate: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodNumber>;
+    customfields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodNumber>;
+        name: z.ZodOptional<z.ZodString>;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const CloseTicketArgsSchema: z.ZodObject<{
+    ticket_id: z.ZodNumber;
+    resolution_note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const DeleteTicketArgsSchema: z.ZodObject<{
+    ticket_id: z.ZodNumber;
+    reason: z.ZodString;
+    confirm_destructive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, 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>;
+export declare function createTicket(client: HaloPSAAPIClient, args: z.infer<typeof CreateTicketArgsSchema>): Promise<string>;
+export declare function updateTicket(client: HaloPSAAPIClient, args: z.infer<typeof UpdateTicketArgsSchema>): Promise<string>;
+/**
+ * Permanently delete a HaloPSA ticket by ID after running four safety
+ * pre-flight checks:
+ *
+ * 1. Financial — refuses if `timetaken > 0` or `hoursinvoiced > 0` (billable
+ *    history would be destroyed on delete).
+ * 2. Cascade — refuses if `child_count > 0` (children would orphan; Halo
+ *    cascade behavior is undocumented).
+ * 3. Historical — refuses if the ticket is closed or completed. Uses a
+ *    tenant-portable dual-check: primary `hasbeenclosed === true` (Halo
+ *    boolean); secondary fetches `/Status` (cached 1h) and matches against
+ *    known closed-flavour names (Closed, Closed Order, Closed Item, Completed).
+ * 4. Authorship — refuses unless `who === 'claude_mcp'` (prevents accidental
+ *    deletion of human-created tickets).
+ *
+ * OVERRIDE mechanism: when violations exist, pass `confirm_destructive: true`
+ * AND include the substring `"OVERRIDE"` (case-sensitive) in `reason` to
+ * bypass all checks and proceed with the DELETE.
+ *
+ * Return shapes:
+ * - `{ already_absent: true, deleted_id }` — 404 on GET (idempotent).
+ * - `{ deleted: false, refused: true, violations, remediation }` — safety block.
+ * - `{ deleted: true, ticket_id, reason, override_used, safety_violations_bypassed? }` — success.
+ */
+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>;
+export declare const listTicketsTool: ZodToolDefinition;
+export declare const getTicketTool: ZodToolDefinition;
+export declare const searchTicketsTool: ZodToolDefinition;
+export declare const createTicketTool: ZodToolDefinition;
+export declare const updateTicketTool: ZodToolDefinition;
+export declare const closeTicketTool: ZodToolDefinition;
+export declare const deleteTicketTool: ZodToolDefinition;
+//# sourceMappingURL=tickets.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;iBAiCjC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;iBAuBjC,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,CA2BjB;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,GAC3C,OAAO,CAAC,MAAM,CAAC,CA2CjB;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"}