@wilnertech/halopsa-mcp-server 1.0.2 → 1.1.0

package/dist/tools/registry.js

@@ -7,7 +7,7 @@
  *  - registerZod()  : Zod-first registration with automatic schema conversion
  *                     and input parsing (replaces coerceArgs per-tool)
  */
-import { zodToJsonSchema } from '../utils/zod-to-schema.js';
+import { z } from 'zod';
 export class ToolRegistry {
     tools = new Map();
     /**
@@ -24,9 +24,33 @@ export class ToolRegistry {
      * Register a tool using a Zod schema.
      * Converts the schema to JSON Schema for MCP and wraps the handler
      * to parse/coerce input before dispatching.
+     *
+     * Strips two categories of wire noise that Zod 4's native z.toJSONSchema()
+     * emits but MCP clients neither validate nor act on:
+     *   1. The top-level `$schema` URI — Zod attaches this to the final result
+     *      object AFTER override callbacks fire (see zod/v4/core/to-json-schema.js
+     *      line 299-313), so override cannot reach it; we delete it post-conversion.
+     *   2. Safe-integer minimum/maximum on integer nodes where the user did NOT
+     *      call .min()/.max() (i.e., bounds equal Number.MIN/MAX_SAFE_INTEGER).
+     *      Explicit user constraints (e.g., count.min(1).max(100)) are preserved.
+     * All other correctness-bearing additions — additionalProperties: false,
+     * propertyNames on records, anyOf for nullables, type: integer — are kept.
      */
     registerZod(tool) {
-        const inputSchema = zodToJsonSchema(tool.schema);
+        const inputSchema = z.toJSONSchema(tool.schema, {
+            target: 'draft-07',
+            override: (ctx) => {
+                if (ctx.jsonSchema.type === 'integer') {
+                    if (ctx.jsonSchema.minimum === Number.MIN_SAFE_INTEGER) {
+                        delete ctx.jsonSchema.minimum;
+                    }
+                    if (ctx.jsonSchema.maximum === Number.MAX_SAFE_INTEGER) {
+                        delete ctx.jsonSchema.maximum;
+                    }
+                }
+            },
+        });
+        delete inputSchema.$schema;
         this.register({
             name: tool.name,
             description: tool.description,

package/dist/tools/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AA8B5D,MAAM,OAAO,YAAY;IACf,KAAK,GAAgC,IAAI,GAAG,EAAE,CAAC;IAEvD;;;OAGG;IACH,QAAQ,CAAC,IAAoB;QAC3B,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,IAAuB;QACjC,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEjD,IAAI,CAAC,QAAQ,CAAC;YACZ,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW;YACX,OAAO,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;gBACxB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACvC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACtC,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,cAAc;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;YAClF,IAAI;YACJ,WAAW;YACX,WAAW;SACZ,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAwB,EAAE,IAAY,EAAE,IAA6B;QAClF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2BxB,MAAM,OAAO,YAAY;IACf,KAAK,GAAgC,IAAI,GAAG,EAAE,CAAC;IAEvD;;;OAGG;IACH,QAAQ,CAAC,IAAoB;QAC3B,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,IAAuB;QACjC,MAAM,WAAW,GAAG,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE;YAC9C,MAAM,EAAE,UAAU;YAClB,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;gBAChB,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;oBACtC,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,KAAK,MAAM,CAAC,gBAAgB,EAAE,CAAC;wBACvD,OAAO,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC;oBAChC,CAAC;oBACD,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,KAAK,MAAM,CAAC,gBAAgB,EAAE,CAAC;wBACvD,OAAO,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC;oBAChC,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAA4B,CAAC;QAC9B,OAAO,WAAW,CAAC,OAAO,CAAC;QAE3B,IAAI,CAAC,QAAQ,CAAC;YACZ,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW;YACX,OAAO,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;gBACxB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACvC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACtC,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,cAAc;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;YAClF,IAAI;YACJ,WAAW;YACX,WAAW;SACZ,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAwB,EAAE,IAAY,EAAE,IAA6B;QAClF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF"}

package/dist/tools/sites.d.ts

@@ -14,72 +14,30 @@ export declare const ListSitesArgsSchema: z.ZodObject<{
     count: z.ZodOptional<z.ZodNumber>;
     page_no: z.ZodOptional<z.ZodNumber>;
     format_options: z.ZodOptional<z.ZodObject<{
-        format: z.ZodOptional<z.ZodEnum<["compact", "standard", "detailed"]>>;
-        fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        format: z.ZodOptional<z.ZodEnum<{
+            compact: "compact";
+            standard: "standard";
+            detailed: "detailed";
+        }>>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
         omit_empty: z.ZodOptional<z.ZodBoolean>;
-    }, "strip", z.ZodTypeAny, {
-        format?: "compact" | "standard" | "detailed" | undefined;
-        fields?: string[] | undefined;
-        omit_empty?: boolean | undefined;
-    }, {
-        format?: "compact" | "standard" | "detailed" | undefined;
-        fields?: string[] | undefined;
-        omit_empty?: boolean | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    client_id?: number | undefined;
-    count?: number | undefined;
-    page_no?: number | undefined;
-    search?: string | undefined;
-    format_options?: {
-        format?: "compact" | "standard" | "detailed" | undefined;
-        fields?: string[] | undefined;
-        omit_empty?: boolean | undefined;
-    } | undefined;
-}, {
-    client_id?: number | undefined;
-    count?: number | undefined;
-    page_no?: number | undefined;
-    search?: string | undefined;
-    format_options?: {
-        format?: "compact" | "standard" | "detailed" | undefined;
-        fields?: string[] | undefined;
-        omit_empty?: boolean | undefined;
-    } | undefined;
-}>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 /**
  * Get single site schema
  */
 export declare const GetSiteArgsSchema: z.ZodObject<{
     site_id: z.ZodNumber;
     format_options: z.ZodOptional<z.ZodObject<{
-        format: z.ZodOptional<z.ZodEnum<["compact", "standard", "detailed"]>>;
-        fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        format: z.ZodOptional<z.ZodEnum<{
+            compact: "compact";
+            standard: "standard";
+            detailed: "detailed";
+        }>>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
         omit_empty: z.ZodOptional<z.ZodBoolean>;
-    }, "strip", z.ZodTypeAny, {
-        format?: "compact" | "standard" | "detailed" | undefined;
-        fields?: string[] | undefined;
-        omit_empty?: boolean | undefined;
-    }, {
-        format?: "compact" | "standard" | "detailed" | undefined;
-        fields?: string[] | undefined;
-        omit_empty?: boolean | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    site_id: number;
-    format_options?: {
-        format?: "compact" | "standard" | "detailed" | undefined;
-        fields?: string[] | undefined;
-        omit_empty?: boolean | undefined;
-    } | undefined;
-}, {
-    site_id: number;
-    format_options?: {
-        format?: "compact" | "standard" | "detailed" | undefined;
-        fields?: string[] | undefined;
-        omit_empty?: boolean | undefined;
-    } | undefined;
-}>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 /**
  * Create site schema
  */
@@ -96,50 +54,8 @@ export declare const CreateSiteArgsSchema: z.ZodObject<{
         state: z.ZodOptional<z.ZodString>;
         postalcode: z.ZodOptional<z.ZodString>;
         country: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        addressline1?: string | undefined;
-        addressline2?: string | undefined;
-        city?: string | undefined;
-        state?: string | undefined;
-        postalcode?: string | undefined;
-        country?: string | undefined;
-    }, {
-        addressline1?: string | undefined;
-        addressline2?: string | undefined;
-        city?: string | undefined;
-        state?: string | undefined;
-        postalcode?: string | undefined;
-        country?: string | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    client_id: number;
-    name: string;
-    notes?: string | undefined;
-    phonenumber?: string | undefined;
-    maincontact_name?: string | undefined;
-    address?: {
-        addressline1?: string | undefined;
-        addressline2?: string | undefined;
-        city?: string | undefined;
-        state?: string | undefined;
-        postalcode?: string | undefined;
-        country?: string | undefined;
-    } | undefined;
-}, {
-    client_id: number;
-    name: string;
-    notes?: string | undefined;
-    phonenumber?: string | undefined;
-    maincontact_name?: string | undefined;
-    address?: {
-        addressline1?: string | undefined;
-        addressline2?: string | undefined;
-        city?: string | undefined;
-        state?: string | undefined;
-        postalcode?: string | undefined;
-        country?: string | undefined;
-    } | undefined;
-}>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 /**
  * Find site match schema (deduplication)
  */
@@ -147,15 +63,7 @@ export declare const FindSiteMatchArgsSchema: z.ZodObject<{
     name: z.ZodString;
     address: z.ZodOptional<z.ZodString>;
     client_id: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    client_id: number;
-    name: string;
-    address?: string | undefined;
-}, {
-    client_id: number;
-    name: string;
-    address?: string | undefined;
-}>;
+}, z.core.$strip>;
 /**
  * List sites with optional filtering and token optimization
  * Uses 5-minute cache TTL

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

@@ -1 +1 @@
-{"version":3,"file":"sites.d.ts","sourceRoot":"","sources":["../../src/tools/sites.ts"],"names":[],"mappings":"AAAA;;;GAGG;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;AAcvD;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoB/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAOlC,CAAC;AAMH;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,GACxC,OAAO,CAAC,MAAM,CAAC,CAqCjB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC,CA8BjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,GAC5C,OAAO,CAAC,MAAM,CAAC,CAqGjB;AAMD,eAAO,MAAM,aAAa,EAAE,iBAK3B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,iBAKzB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,iBAK5B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,iBAK/B,CAAC"}
+{"version":3,"file":"sites.d.ts","sourceRoot":"","sources":["../../src/tools/sites.ts"],"names":[],"mappings":"AAAA;;;GAGG;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;AAcvD;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;iBAU9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;iBAI5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;iBAoB/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;iBAOlC,CAAC;AAMH;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,GACxC,OAAO,CAAC,MAAM,CAAC,CAqCjB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC,CA8BjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,GAC5C,OAAO,CAAC,MAAM,CAAC,CAqGjB;AAMD,eAAO,MAAM,aAAa,EAAE,iBAK3B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,iBAKzB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,iBAK5B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,iBAK/B,CAAC"}

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

@@ -0,0 +1,41 @@
+/**
+ * HaloPSA Ticket Action tools.
+ *
+ * Actions are the journal entries on a ticket — notes, email replies,
+ * status changes, time entries, etc. Halo's create endpoint is
+ * `POST /api/Actions` with an **array body** (mirrors Tickets/Asset
+ * convention). The list endpoint is `GET /api/Actions?ticket_id={id}`.
+ *
+ * The list response is cached briefly (1min) because action lists update
+ * any time someone touches the ticket; staleness > 1min would mislead
+ * agents reading the journal.
+ */
+import { z } from 'zod';
+import type { HaloPSAAPIClient } from '../api/client.js';
+import type { ZodToolDefinition } from './registry.js';
+export declare const AddTicketActionArgsSchema: z.ZodObject<{
+    ticket_id: z.ZodNumber;
+    note: z.ZodString;
+    outcome_id: z.ZodOptional<z.ZodNumber>;
+    email_reply: z.ZodOptional<z.ZodBoolean>;
+    hiddenfromuser: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const ListTicketActionsArgsSchema: z.ZodObject<{
+    ticket_id: z.ZodNumber;
+    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 function addTicketAction(client: HaloPSAAPIClient, args: z.infer<typeof AddTicketActionArgsSchema>): Promise<string>;
+export declare function listTicketActions(client: HaloPSAAPIClient, args: z.infer<typeof ListTicketActionsArgsSchema>): Promise<string>;
+export declare const addTicketActionTool: ZodToolDefinition;
+export declare const listTicketActionsTool: ZodToolDefinition;
+//# sourceMappingURL=ticket-actions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ticket-actions.d.ts","sourceRoot":"","sources":["../../src/tools/ticket-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAevD,eAAO,MAAM,yBAAyB;;;;;;iBAWpC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;iBAQtC,CAAC;AA2IH,wBAAsB,eAAe,CACnC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,GAC9C,OAAO,CAAC,MAAM,CAAC,CA0CjB;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,GAChD,OAAO,CAAC,MAAM,CAAC,CA0BjB;AAMD,eAAO,MAAM,mBAAmB,EAAE,iBAKjC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,iBAKnC,CAAC"}

package/dist/tools/ticket-actions.js

@@ -0,0 +1,222 @@
+/**
+ * HaloPSA Ticket Action tools.
+ *
+ * Actions are the journal entries on a ticket — notes, email replies,
+ * status changes, time entries, etc. Halo's create endpoint is
+ * `POST /api/Actions` with an **array body** (mirrors Tickets/Asset
+ * convention). The list endpoint is `GET /api/Actions?ticket_id={id}`.
+ *
+ * The list response is cached briefly (1min) because action lists update
+ * any time someone touches the ticket; staleness > 1min would mislead
+ * agents reading the journal.
+ */
+import { z } from 'zod';
+import { HaloPSAError } from '../api/errors.js';
+import { formatResponse } from '../utils/formatter.js';
+import { TTL } from '../cache/memory-cache.js';
+import { FormatOptionsSchema } from '../schemas/common.js';
+// =============================================================================
+// Schemas
+// =============================================================================
+export const AddTicketActionArgsSchema = z.object({
+    ticket_id: z.number().int()
+        .describe('HaloPSA ticket ID to attach the action to'),
+    note: z.string().min(1)
+        .describe('Note body (plain text or HTML)'),
+    outcome_id: z.number().int().optional()
+        .describe('Outcome enum ID (Public Note, Private Note, Email Reply, etc.). Halo REQUIRES this on most tenants — without it, POST /Actions returns 400 "An Outcome must be entered for this Action". Look up valid outcomes for your agent in Halo admin → Configuration → Tickets → Outcomes.'),
+    email_reply: z.boolean().optional()
+        .describe('If true, sends the note as an email reply to the ticket requester'),
+    hiddenfromuser: z.boolean().optional()
+        .describe('If true, hides the action from the customer portal'),
+});
+export const ListTicketActionsArgsSchema = z.object({
+    ticket_id: z.number().int()
+        .describe('Filter actions to a single ticket'),
+    count: z.number().int().min(1).max(100).optional()
+        .describe('Results per page (max 100)'),
+    page_no: z.number().int().min(1).optional()
+        .describe('Page number (1-indexed)'),
+    format_options: FormatOptionsSchema,
+});
+// =============================================================================
+// Helpers
+// =============================================================================
+const ACTION_PREVIEW_LEN = 200;
+/**
+ * Regex to detect Halo 400 messages that indicate a missing or invalid
+ * outcome_id — covers both "An Outcome must be entered for this Action"
+ * and "You do not have access to this Action at the moment."
+ */
+const OUTCOME_ERROR_RE = /Outcome must be entered|access to this Action/i;
+/**
+ * Scan an arbitrary object for any key whose name contains "outcome"
+ * (case-insensitive) and whose value is an array. Returns that array,
+ * or an empty array if nothing is found.
+ */
+function extractOutcomeHint(obj) {
+    for (const key of Object.keys(obj)) {
+        if (/outcome/i.test(key)) {
+            const val = obj[key];
+            if (Array.isArray(val)) {
+                return val;
+            }
+        }
+    }
+    return [];
+}
+/**
+ * When POST /Actions returns a 400 matching the outcome-required pattern,
+ * fetch the parent ticket and its tickettype config, then return a structured
+ * "refusal" object (not a thrown error) so the caller sees discovery info.
+ */
+async function buildOutcomeDiscoveryRefusal(client, ticketId, haloError) {
+    const discoveryWarnings = [];
+    // --- Step 1: fetch the parent ticket ---
+    let tickettypeId;
+    let tickettypeName;
+    try {
+        const ticket = await client.get(`/Tickets/${ticketId}`, { includedetails: true });
+        tickettypeId = ticket.tickettype_id;
+        tickettypeName = ticket.tickettype_name;
+    }
+    catch (innerErr) {
+        const msg = innerErr instanceof Error ? innerErr.message : String(innerErr);
+        discoveryWarnings.push('ticket lookup failed: ' + msg);
+        return {
+            action_created: false,
+            halo_error: haloError,
+            diagnosis: 'outcome_id is required for this tickettype and was either missing or invalid',
+            tickettype_id: null,
+            tickettype_name: null,
+            valid_outcomes_hint: [],
+            discovery_warning: discoveryWarnings.join('; '),
+            remediation: 'Either retry with a valid outcome_id (check Halo admin: Configuration > Tickets > Outcomes), ' +
+                'or fall back to update_halopsa_ticket to set details_html / status_id without going through the Actions surface.',
+        };
+    }
+    // --- Step 2: fetch the tickettype config ---
+    let validOutcomesHint = [];
+    if (tickettypeId !== undefined) {
+        try {
+            const ttConfig = await client.get(`/TicketType/${tickettypeId}`, { includedetails: true });
+            validOutcomesHint = extractOutcomeHint(ttConfig);
+        }
+        catch (innerErr) {
+            const msg = innerErr instanceof Error ? innerErr.message : String(innerErr);
+            discoveryWarnings.push('tickettype lookup failed: ' + msg);
+        }
+    }
+    const result = {
+        action_created: false,
+        halo_error: haloError,
+        diagnosis: 'outcome_id is required for this tickettype and was either missing or invalid',
+        tickettype_id: tickettypeId ?? null,
+        tickettype_name: tickettypeName ?? null,
+        valid_outcomes_hint: validOutcomesHint,
+        remediation: 'Either retry with a valid outcome_id from the list above, ' +
+            'or fall back to update_halopsa_ticket to set details_html / status_id without going through the Actions surface.',
+    };
+    if (discoveryWarnings.length > 0) {
+        result['discovery_warning'] = discoveryWarnings.join('; ');
+    }
+    return result;
+}
+/**
+ * Compact action shape — id/who/datetime/outcome plus a `note_preview`
+ * truncated to 200 chars so list responses stay LLM-friendly.
+ */
+function compactAction(action) {
+    const note = action.note ?? action.note_html ?? '';
+    return {
+        id: action.id,
+        ticket_id: action.ticket_id,
+        who: action.who,
+        datetime: action.datetime,
+        outcome: action.outcome,
+        note_preview: note.length > ACTION_PREVIEW_LEN
+            ? note.slice(0, ACTION_PREVIEW_LEN) + '…'
+            : note,
+    };
+}
+function unwrapActionList(response) {
+    if (Array.isArray(response)) {
+        return { actions: response, record_count: response.length };
+    }
+    return {
+        actions: response.actions ?? [],
+        record_count: response.record_count ?? response.actions?.length ?? 0,
+    };
+}
+// =============================================================================
+// Implementations
+// =============================================================================
+export async function addTicketAction(client, args) {
+    const payload = {
+        ticket_id: args.ticket_id,
+        note: args.note,
+    };
+    if (args.outcome_id !== undefined)
+        payload.outcome_id = args.outcome_id;
+    if (args.email_reply !== undefined)
+        payload.email_reply = args.email_reply;
+    if (args.hiddenfromuser !== undefined)
+        payload.hiddenfromuser = args.hiddenfromuser;
+    // Halo's array-body write may return `[{...}]` or `{...}` depending on
+    // tenant — normalize to a single object before formatting.
+    let raw;
+    try {
+        raw = await client.post('/Actions', [payload]);
+    }
+    catch (error) {
+        // When Halo returns 400 for a missing or invalid outcome_id, surface a
+        // structured refusal with discovery info instead of re-throwing the raw
+        // error.  This lets the caller retry with a valid outcome_id.
+        const haloMessage = error instanceof HaloPSAError ? error.message : String(error);
+        if (OUTCOME_ERROR_RE.test(haloMessage)) {
+            const refusal = await buildOutcomeDiscoveryRefusal(client, args.ticket_id, haloMessage);
+            return JSON.stringify(refusal);
+        }
+        throw error;
+    }
+    const created = Array.isArray(raw) ? raw[0] : raw;
+    client.invalidateCache(`ticket-actions:${args.ticket_id}*`);
+    client.invalidateCache(`ticket:${args.ticket_id}*`);
+    return formatResponse(created, { format: 'standard' });
+}
+export async function listTicketActions(client, args) {
+    const params = { ticket_id: args.ticket_id };
+    if (args.count !== undefined)
+        params.count = args.count;
+    if (args.page_no !== undefined)
+        params.page_no = args.page_no;
+    const formatOpts = args.format_options || { format: 'compact' };
+    const response = await client.getCached('/Actions', params, {
+        enabled: true,
+        ttl: TTL.TICKET_ACTION_LIST,
+        keyPrefix: `ticket-actions:${args.ticket_id}`,
+    });
+    const { actions, record_count } = unwrapActionList(response);
+    // Compact mode: substitute the preview-shaped objects so the response
+    // never echoes back full HTML bodies on a journal listing.
+    const items = formatOpts.format === 'compact'
+        ? actions.map(compactAction)
+        : actions;
+    return formatResponse(items, formatOpts, { record_count });
+}
+// =============================================================================
+// Tool Definitions
+// =============================================================================
+export const addTicketActionTool = {
+    name: 'add_halopsa_ticket_action',
+    description: 'Append an action (note, email reply, status change journal entry) to a HaloPSA ticket. POST /Actions with array body wrapper. Invalidates ticket and action caches.',
+    schema: AddTicketActionArgsSchema,
+    handler: addTicketAction,
+};
+export const listTicketActionsTool = {
+    name: 'list_halopsa_ticket_actions',
+    description: 'List actions/journal entries on a HaloPSA ticket. Compact response includes a 200-char note_preview; pass format_options.format="detailed" for full notes. Cached 1min.',
+    schema: ListTicketActionsArgsSchema,
+    handler: listTicketActions,
+};
+//# sourceMappingURL=ticket-actions.js.map

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

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

package/dist/tools/ticket-custom-fields.d.ts

@@ -0,0 +1,33 @@
+/**
+ * HaloPSA Ticket Custom Field tools.
+ *
+ * Two complementary inspection paths:
+ *   1. `list_halopsa_ticket_custom_fields` — preferred. Calls
+ *      GET /api/FieldInfo?type=1&tickettype_id={id}. If the tenant
+ *      returns a non-empty field list, that's the canonical schema.
+ *   2. `get_halopsa_ticket_field_schema` — fallback. Samples N recent
+ *      tickets of a given type and derives field shape from their
+ *      `customfields[]` arrays. Mirrors `getAssetFieldSchemaTool`.
+ *
+ * The dual approach exists because Halo's `/FieldInfo` endpoint behaves
+ * inconsistently across tenants — some installs gate it behind admin
+ * scope, others return empty arrays for non-admin agents. The sampling
+ * path is robust but lossy (only fields that ARE used on existing
+ * tickets show up).
+ */
+import { z } from 'zod';
+import type { HaloPSAAPIClient } from '../api/client.js';
+import type { ZodToolDefinition } from './registry.js';
+export declare const ListTicketCustomFieldsArgsSchema: z.ZodObject<{
+    tickettype_id: z.ZodNumber;
+}, z.core.$strip>;
+export declare const GetTicketFieldSchemaArgsSchema: z.ZodObject<{
+    tickettype_id: z.ZodNumber;
+    client_id: z.ZodOptional<z.ZodNumber>;
+    sample_size: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function listTicketCustomFields(client: HaloPSAAPIClient, args: z.infer<typeof ListTicketCustomFieldsArgsSchema>): Promise<string>;
+export declare function getTicketFieldSchema(client: HaloPSAAPIClient, args: z.infer<typeof GetTicketFieldSchemaArgsSchema>): Promise<string>;
+export declare const listTicketCustomFieldsTool: ZodToolDefinition;
+export declare const getTicketFieldSchemaTool: ZodToolDefinition;
+//# sourceMappingURL=ticket-custom-fields.d.ts.map

package/dist/tools/ticket-custom-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket-custom-fields.d.ts","sourceRoot":"","sources":["../../src/tools/ticket-custom-fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;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;AAWvD,eAAO,MAAM,gCAAgC;;iBAG3C,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;iBAOzC,CAAC;AAgDH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,GACrD,OAAO,CAAC,MAAM,CAAC,CAmCjB;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,GACnD,OAAO,CAAC,MAAM,CAAC,CAyDjB;AAMD,eAAO,MAAM,0BAA0B,EAAE,iBAKxC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,iBAKtC,CAAC"}