@wilnertech/halopsa-mcp-server 1.0.2 → 1.1.0

package/dist/tools/ticket-custom-fields.js

@@ -0,0 +1,155 @@
+/**
+ * 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';
+// =============================================================================
+// Schemas
+// =============================================================================
+// These tools return purpose-built analysis objects (field schema summaries,
+// not raw HaloPSA records) so they intentionally do NOT accept format_options
+// — the response shape is fixed.
+export const ListTicketCustomFieldsArgsSchema = z.object({
+    tickettype_id: z.number().int()
+        .describe('Ticket type ID — schema is per-tickettype'),
+});
+export const GetTicketFieldSchemaArgsSchema = z.object({
+    tickettype_id: z.number().int()
+        .describe('Ticket type ID — sampling is scoped to this type'),
+    client_id: z.number().int().optional()
+        .describe('Optional client filter — narrows the sample further'),
+    sample_size: z.number().int().min(1).max(100).optional()
+        .describe('Number of tickets to inspect (default 50)'),
+});
+// =============================================================================
+// Helpers
+// =============================================================================
+function getValueType(value) {
+    if (value === null || value === undefined)
+        return 'null';
+    if (typeof value === 'string')
+        return 'string';
+    if (typeof value === 'number')
+        return 'number';
+    if (typeof value === 'boolean')
+        return 'boolean';
+    return 'mixed';
+}
+function unwrapList(response, preferredKey) {
+    if (Array.isArray(response))
+        return response;
+    const wrapped = response;
+    return wrapped[preferredKey] ?? [];
+}
+// =============================================================================
+// Implementations
+// =============================================================================
+export async function listTicketCustomFields(client, args) {
+    // Halo type=1 means ticket fields per the FieldInfo endpoint convention.
+    let fields = [];
+    let source = 'empty';
+    let warning;
+    try {
+        const response = await client.get('/FieldInfo', { type: 1, tickettype_id: args.tickettype_id });
+        fields = unwrapList(response, 'fields');
+        if (fields.length > 0) {
+            source = 'fieldinfo';
+        }
+    }
+    catch (err) {
+        warning = `FieldInfo endpoint failed: ${err instanceof Error ? err.message : String(err)}. ` +
+            'Use get_halopsa_ticket_field_schema for sampling-based schema discovery.';
+    }
+    const result = {
+        tickettype_id: args.tickettype_id,
+        source,
+        field_count: fields.length,
+        fields: fields.map((f) => ({
+            id: f.id ?? f.field_id,
+            name: f.name ?? f.label,
+            type: f.type,
+            required: f.required ?? false,
+            display_order: f.display_order,
+        })),
+        ...(warning && { warning }),
+    };
+    return JSON.stringify(result, null, 2);
+}
+export async function getTicketFieldSchema(client, args) {
+    const sampleSize = args.sample_size ?? 50;
+    const params = {
+        tickettype_id: args.tickettype_id,
+        count: sampleSize,
+    };
+    if (args.client_id !== undefined)
+        params.client_id = args.client_id;
+    const response = await client.get('/Tickets', params);
+    const tickets = Array.isArray(response)
+        ? response
+        : (response.tickets ?? []);
+    const fieldMap = new Map();
+    for (const ticket of tickets) {
+        const customfields = ticket.customfields ?? [];
+        for (const field of customfields) {
+            const existing = fieldMap.get(field.id);
+            const valueType = getValueType(field.value);
+            if (existing) {
+                if (existing.sample_values.length < 5 &&
+                    !existing.sample_values.includes(field.value)) {
+                    existing.sample_values.push(field.value);
+                }
+                existing.usage_count++;
+                if (existing.value_type !== valueType && existing.value_type !== 'mixed') {
+                    existing.value_type = 'mixed';
+                }
+            }
+            else {
+                fieldMap.set(field.id, {
+                    field_id: field.id,
+                    name: field.name,
+                    sample_values: [field.value],
+                    value_type: valueType,
+                    usage_count: 1,
+                });
+            }
+        }
+    }
+    const fieldSchemas = Array.from(fieldMap.values()).sort((a, b) => a.field_id - b.field_id);
+    const result = {
+        tickettype_id: args.tickettype_id,
+        client_id: args.client_id ?? 'all',
+        tickets_analyzed: tickets.length,
+        unique_fields: fieldSchemas.length,
+        field_schemas: fieldSchemas,
+    };
+    return JSON.stringify(result, null, 2);
+}
+// =============================================================================
+// Tool Definitions
+// =============================================================================
+export const listTicketCustomFieldsTool = {
+    name: 'list_halopsa_ticket_custom_fields',
+    description: 'List custom-field definitions for a ticket type via /FieldInfo. Falls back gracefully with a warning if the endpoint is empty/unauthorized — use get_halopsa_ticket_field_schema then.',
+    schema: ListTicketCustomFieldsArgsSchema,
+    handler: listTicketCustomFields,
+};
+export const getTicketFieldSchemaTool = {
+    name: 'get_halopsa_ticket_field_schema',
+    description: 'Sample N recent tickets of a given type and derive custom-field schema from their customfields[] arrays. Use when /FieldInfo is unavailable. Returns field_id, name, sample_values, value_type, usage_count per field.',
+    schema: GetTicketFieldSchemaArgsSchema,
+    handler: getTicketFieldSchema,
+};
+//# sourceMappingURL=ticket-custom-fields.js.map

package/dist/tools/ticket-custom-fields.js.map

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

package/dist/tools/ticket-reference-data.d.ts

@@ -0,0 +1,88 @@
+/**
+ * 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 type { HaloPSAAPIClient } from '../api/client.js';
+import type { ZodToolDefinition } from './registry.js';
+declare const ListTicketTypesArgsSchema: z.ZodObject<{
+    full: z.ZodOptional<z.ZodBoolean>;
+    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>;
+declare const GetTicketTypeArgsSchema: z.ZodObject<{
+    tickettype_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>;
+declare const ListTicketStatusesArgsSchema: z.ZodObject<{
+    full: z.ZodOptional<z.ZodBoolean>;
+    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>;
+declare const ListTicketPrioritiesArgsSchema: z.ZodObject<{
+    full: z.ZodOptional<z.ZodBoolean>;
+    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>;
+declare const ListTicketCategoriesArgsSchema: z.ZodObject<{
+    full: z.ZodOptional<z.ZodBoolean>;
+    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 listTicketTypes(client: HaloPSAAPIClient, args: z.infer<typeof ListTicketTypesArgsSchema>): Promise<string>;
+export declare function getTicketType(client: HaloPSAAPIClient, args: z.infer<typeof GetTicketTypeArgsSchema>): Promise<string>;
+export declare function listTicketStatuses(client: HaloPSAAPIClient, args: z.infer<typeof ListTicketStatusesArgsSchema>): Promise<string>;
+export declare function listTicketPriorities(client: HaloPSAAPIClient, args: z.infer<typeof ListTicketPrioritiesArgsSchema>): Promise<string>;
+export declare function listTicketCategories(client: HaloPSAAPIClient, args: z.infer<typeof ListTicketCategoriesArgsSchema>): Promise<string>;
+export declare const listTicketTypesTool: ZodToolDefinition;
+export declare const getTicketTypeTool: ZodToolDefinition;
+export declare const listTicketStatusesTool: ZodToolDefinition;
+export declare const listTicketPrioritiesTool: ZodToolDefinition;
+export declare const listTicketCategoriesTool: ZodToolDefinition;
+export {};
+//# sourceMappingURL=ticket-reference-data.d.ts.map

package/dist/tools/ticket-reference-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket-reference-data.d.ts","sourceRoot":"","sources":["../../src/tools/ticket-reference-data.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;AAoBvD,QAAA,MAAM,yBAAyB;;;;;;;;;;;iBAI7B,CAAC;AAEH,QAAA,MAAM,uBAAuB;;;;;;;;;;;iBAI3B,CAAC;AAEH,QAAA,MAAM,4BAA4B;;;;;;;;;;;iBAIhC,CAAC;AAEH,QAAA,MAAM,8BAA8B;;;;;;;;;;;iBAIlC,CAAC;AAEH,QAAA,MAAM,8BAA8B;;;;;;;;;;;iBAIlC,CAAC;AAqEH,wBAAsB,eAAe,CACnC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,GAC9C,OAAO,CAAC,MAAM,CAAC,CAejB;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,GAC5C,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,GACjD,OAAO,CAAC,MAAM,CAAC,CAejB;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,GACnD,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,GACnD,OAAO,CAAC,MAAM,CAAC,CAejB;AAMD,eAAO,MAAM,mBAAmB,EAAE,iBAKjC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,iBAK/B,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,iBAKpC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,iBAKtC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,iBAKtC,CAAC"}

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":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,OAAO,EAAE,cAAc,EAAsB,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SACzB,QAAQ,CAAC,yGAAyG,CAAC;IACtH,cAAc,EAAE,mBAAmB;CACpC,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;SAC5B,QAAQ,CAAC,wBAAwB,CAAC;IACrC,cAAc,EAAE,mBAAmB;CACpC,CAAC,CAAC;AAEH,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SACzB,QAAQ,CAAC,yDAAyD,CAAC;IACtE,cAAc,EAAE,mBAAmB;CACpC,CAAC,CAAC;AAEH,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SACzB,QAAQ,CAAC,yDAAyD,CAAC;IACtE,cAAc,EAAE,mBAAmB;CACpC,CAAC,CAAC;AAEH,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SACzB,QAAQ,CAAC,yDAAyD,CAAC;IACtE,cAAc,EAAE,mBAAmB;CACpC,CAAC,CAAC;AAEH,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;;;GAIG;AACH,SAAS,aAAa,CACpB,IAAyB,EACzB,aAAwC;IAExC,MAAM,IAAI,GAAkB,EAAE,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,CAAC;IACzD,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;IAC3B,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,iBAAiB,CAAC,CAAwB;IACjD,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,UAAU;QAChB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,eAAe,EAAE,CAAC,CAAC,EAAE;QACrB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,aAAa,EAAE,CAAC,CAAC,aAAa;QAC9B,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,iBAAiB,EAAE,CAAC,CAAC,iBAAiB;QACtC,kBAAkB,EAAE,CAAC,CAAC,kBAAkB;KACzC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,SAAS,UAAU,CACjB,QAAsB,EACtB,YAAoB;IAEpB,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC5D,CAAC;IACD,MAAM,OAAO,GAAG,QAAmC,CAAC;IACpD,MAAM,KAAK,GAAI,OAAO,CAAC,YAAY,CAAqB,IAAI,EAAE,CAAC;IAC/D,MAAM,YAAY,GAAI,OAAO,CAAC,YAAmC,IAAI,KAAK,CAAC,MAAM,CAAC;IAClF,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;AACjC,CAAC;AAED,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAwB,EACxB,IAA+C;IAE/C,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IAEjE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CACrC,aAAa,EACb,EAAE,KAAK,EAAE,GAAG,EAAE,EACd;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,GAAG,CAAC,YAAY;QACrB,SAAS,EAAE,iBAAiB;KAC7B,CACF,CAAC;IAEF,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,UAAU,CAAoB,QAAQ,EAAE,aAAa,CAAC,CAAC;IACvF,OAAO,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAwB,EACxB,IAA6C;IAE7C,MAAM,UAAU,GAAkB,IAAI,CAAC,cAAc,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAEhF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CACrC,eAAe,IAAI,CAAC,aAAa,EAAE,EACnC,SAAS,EACT;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,GAAG,CAAC,YAAY;QACrB,SAAS,EAAE,cAAc,IAAI,CAAC,aAAa,EAAE;KAC9C,CACF,CAAC;IAEF,OAAO,cAAc,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAwB,EACxB,IAAkD;IAElD,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IAEjE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CACrC,SAAS,EACT,EAAE,KAAK,EAAE,GAAG,EAAE,EACd;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,GAAG,CAAC,eAAe;QACxB,SAAS,EAAE,oBAAoB;KAChC,CACF,CAAC;IAEF,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,UAAU,CAAsB,QAAQ,EAAE,UAAU,CAAC,CAAC;IACtF,OAAO,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAwB,EACxB,IAAoD;IAEpD,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IAEjE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CACrC,WAAW,EACX,EAAE,KAAK,EAAE,GAAG,EAAE,EACd;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,GAAG,CAAC,iBAAiB;QAC1B,SAAS,EAAE,sBAAsB;KAClC,CACF,CAAC;IAEF,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,UAAU,CAAwB,QAAQ,EAAE,YAAY,CAAC,CAAC;IACpG,MAAM,KAAK,GAAsC,QAAQ,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACjF,OAAO,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAwB,EACxB,IAAoD;IAEpD,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IAEjE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,SAAS,CACrC,WAAW,EACX,EAAE,KAAK,EAAE,GAAG,EAAE,EACd;QACE,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,GAAG,CAAC,iBAAiB;QAC1B,SAAS,EAAE,sBAAsB;KAClC,CACF,CAAC;IAEF,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,UAAU,CAAwB,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC1F,OAAO,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,MAAM,CAAC,MAAM,mBAAmB,GAAsB;IACpD,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE,6IAA6I;IAC1J,MAAM,EAAE,yBAAyB;IACjC,OAAO,EAAE,eAAe;CACzB,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,oDAAoD;IACjE,MAAM,EAAE,uBAAuB;IAC/B,OAAO,EAAE,aAAa;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAsB;IACvD,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE,2eAA2e;IACxf,MAAM,EAAE,4BAA4B;IACpC,OAAO,EAAE,kBAAkB;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAsB;IACzD,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,+XAA+X;IAC5Y,MAAM,EAAE,8BAA8B;IACtC,OAAO,EAAE,oBAAoB;CAC9B,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAsB;IACzD,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,oGAAoG;IACjH,MAAM,EAAE,8BAA8B;IACtC,OAAO,EAAE,oBAAoB;CAC9B,CAAC"}

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"}