@wilnertech/halopsa-mcp-server 1.0.0

package/dist/types/halopsa.d.ts

@@ -0,0 +1,212 @@
+/**
+ * TypeScript type definitions for HaloPSA API objects
+ * Based on HaloPSA API documentation and WilnerTech requirements
+ *
+ * CRITICAL: These types support billing automation - accuracy is essential
+ */
+/**
+ * HaloPSA Asset (Configuration Item)
+ * Primary entity for billing - asset counts determine client charges
+ */
+export interface HaloPSAAsset {
+    id: number;
+    inventory_number: string;
+    key_field: string;
+    key_field2: string;
+    assettype_id: number;
+    assettype_name: string;
+    status_id: number;
+    status_name: string;
+    site_id: number;
+    site_name: string;
+    client_id: number;
+    client_name: string;
+    warranty_end?: string;
+    last_seen?: string;
+    notes?: string;
+    fields: HaloPSACustomField[];
+}
+/**
+ * Custom field in HaloPSA
+ * Used for extended asset/user data
+ */
+export interface HaloPSACustomField {
+    id: number;
+    name: string;
+    value: string | number | boolean | null;
+}
+/**
+ * HaloPSA User
+ * Secondary billing entity - user counts contribute to billing
+ */
+export interface HaloPSAUser {
+    id: number;
+    name: string;
+    emailaddress: string;
+    username: string;
+    site_id: number;
+    site_name: string;
+    client_id: number;
+    client_name: string;
+    inactive: boolean;
+    user_customfields: HaloPSAUserCustomField[];
+}
+/**
+ * User custom field
+ * Important: UPN (User Principal Name) stored here for Entra sync
+ */
+export interface HaloPSAUserCustomField {
+    id: number;
+    name: string;
+    value: string;
+}
+/**
+ * HaloPSA Site (Location)
+ * Organizational unit within a client
+ */
+export interface HaloPSASite {
+    id: number;
+    name: string;
+    client_id: number;
+    maincontact_name?: string;
+    phonenumber?: string;
+    notes?: string;
+    address?: HaloPSAAddress;
+}
+/**
+ * Address object for sites
+ */
+export interface HaloPSAAddress {
+    addressline1?: string;
+    addressline2?: string;
+    city?: string;
+    state?: string;
+    postalcode?: string;
+    country?: string;
+}
+/**
+ * HaloPSA Client (Top-level organization)
+ */
+export interface HaloPSAClient {
+    id: number;
+    name: string;
+    inactive: boolean;
+    website?: string;
+    notes?: string;
+    phonenumber?: string;
+}
+/**
+ * HaloPSA Asset Type (Reference data)
+ */
+export interface HaloPSAAssetType {
+    id: number;
+    name: string;
+}
+/**
+ * HaloPSA Asset Status (Reference data)
+ * CRITICAL: status_id=1 (Active) determines billing eligibility
+ */
+export interface HaloPSAAssetStatus {
+    id: number;
+    name: string;
+}
+/**
+ * HaloPSA Contact Type (Reference data)
+ */
+export interface HaloPSAContactType {
+    id: number;
+    name: string;
+}
+/**
+ * API Response wrapper for list endpoints
+ * Note: HaloPSA returns named arrays (assets, users, sites, clients) depending on endpoint
+ */
+export interface HaloPSAListResponse<T> {
+    data: T[];
+    record_count: number;
+    page_count?: number;
+}
+/**
+ * Typed list response for assets
+ */
+export interface HaloPSAAssetListResponse {
+    assets: HaloPSAAsset[];
+    record_count: number;
+    page_count?: number;
+}
+/**
+ * Typed list response for users
+ */
+export interface HaloPSAUserListResponse {
+    users: HaloPSAUser[];
+    record_count: number;
+}
+/**
+ * Typed list response for sites
+ */
+export interface HaloPSASiteListResponse {
+    sites: HaloPSASite[];
+    record_count: number;
+}
+/**
+ * Typed list response for clients
+ */
+export interface HaloPSAClientListResponse {
+    clients: HaloPSAClient[];
+    record_count: number;
+}
+/**
+ * Query parameters for HaloPSA API requests
+ */
+export interface HaloPSAQueryParams {
+    count?: number;
+    page_no?: number;
+    pageinate?: boolean;
+    order?: string;
+    orderdesc?: boolean;
+    search?: string;
+    client_id?: number;
+    site_id?: number;
+    assettype_id?: number;
+    status_id?: number;
+    includeactive?: boolean;
+    includeinactive?: boolean;
+}
+/**
+ * Deduplication result with confidence scoring
+ * Used for asset/user/site matching operations
+ */
+export interface DeduplicationResult {
+    match: HaloPSAAsset | HaloPSAUser | HaloPSASite | null;
+    confidence: number;
+    matchField: string;
+    action: 'Update' | 'CreateNew' | 'ManualReview';
+    warning?: string;
+    matches?: Array<HaloPSAAsset | HaloPSAUser | HaloPSASite>;
+}
+/**
+ * Duplicate group for scan results
+ */
+export interface DuplicateGroup {
+    type: 'asset' | 'user' | 'site';
+    matchField: string;
+    matchValue: string;
+    confidence: 'High' | 'Medium';
+    asset_count: number;
+    entities: Array<{
+        id: number;
+        name: string;
+        [key: string]: unknown;
+    }>;
+}
+/**
+ * Asset field schema for custom field inspection
+ */
+export interface AssetFieldSchema {
+    field_id: number;
+    name: string;
+    sample_values: Array<string | number | boolean | null>;
+    value_type: 'string' | 'number' | 'boolean' | 'null' | 'mixed';
+    usage_count: number;
+}
+//# sourceMappingURL=halopsa.d.ts.map

package/dist/types/halopsa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"halopsa.d.ts","sourceRoot":"","sources":["../../src/types/halopsa.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,EAAE,sBAAsB,EAAE,CAAC;CAC7C;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,IAAI,CAAC;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,cAAc,CAAC;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,KAAK,CAAC,YAAY,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;IACvD,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/D,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/halopsa.js

@@ -0,0 +1,8 @@
+/**
+ * TypeScript type definitions for HaloPSA API objects
+ * Based on HaloPSA API documentation and WilnerTech requirements
+ *
+ * CRITICAL: These types support billing automation - accuracy is essential
+ */
+export {};
+//# sourceMappingURL=halopsa.js.map

package/dist/types/halopsa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"halopsa.js","sourceRoot":"","sources":["../../src/types/halopsa.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/utils/formatter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Response formatting utilities for token optimization
+ * Provides compact, standard, and detailed output modes for HaloPSA responses
+ */
+export interface FormatOptions {
+    format?: 'compact' | 'standard' | 'detailed';
+    fields?: string[];
+    omit_empty?: boolean;
+}
+/**
+ * Format a response object based on options
+ * @param data - The data to format (single object or array)
+ * @param options - Formatting options
+ * @param meta - Optional metadata (pagination, counts)
+ * @returns JSON string formatted according to options
+ */
+export declare function formatResponse<T>(data: T | T[], options?: FormatOptions, meta?: Record<string, unknown>): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/utils/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/utils/formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;IAC7C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,EACb,OAAO,GAAE,aAAkB,EAC3B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CA0CR"}

package/dist/utils/formatter.js

@@ -0,0 +1,178 @@
+/**
+ * Response formatting utilities for token optimization
+ * Provides compact, standard, and detailed output modes for HaloPSA responses
+ */
+/**
+ * Format a response object based on options
+ * @param data - The data to format (single object or array)
+ * @param options - Formatting options
+ * @param meta - Optional metadata (pagination, counts)
+ * @returns JSON string formatted according to options
+ */
+export function formatResponse(data, options = {}, meta) {
+    const { format = 'standard', fields, omit_empty = false, } = options;
+    // Process data
+    let processedData;
+    if (Array.isArray(data)) {
+        processedData = data.map((item) => processItem(item, fields, omit_empty, format));
+    }
+    else {
+        processedData = processItem(data, fields, omit_empty, format);
+    }
+    // Build result object
+    const result = Array.isArray(data)
+        ? { data: processedData }
+        : processedData;
+    // Add metadata if provided and data is array
+    if (meta && Array.isArray(data)) {
+        result.meta = meta;
+    }
+    // Return with appropriate formatting
+    switch (format) {
+        case 'compact':
+            // No pretty printing, minimal whitespace
+            return JSON.stringify(result);
+        case 'standard':
+            // No pretty printing but clean structure
+            return JSON.stringify(result);
+        case 'detailed':
+            // Pretty printed with indentation
+            return JSON.stringify(result, null, 2);
+        default:
+            return JSON.stringify(result);
+    }
+}
+/**
+ * Process a single item based on formatting options
+ */
+function processItem(item, fields, omitEmpty, format) {
+    // Guard against null/undefined items
+    if (item === null || item === undefined || typeof item !== 'object') {
+        return item;
+    }
+    let processed = { ...item };
+    // Apply field filtering
+    if (fields && fields.length > 0) {
+        processed = filterFields(processed, fields);
+    }
+    // Remove empty fields if requested
+    if (omitEmpty) {
+        processed = removeEmptyFields(processed);
+    }
+    // For compact mode, further reduce data
+    if (format === 'compact') {
+        processed = compactItem(processed);
+    }
+    return processed;
+}
+/**
+ * Filter object to only include specified fields
+ */
+function filterFields(obj, fields) {
+    const filtered = {};
+    for (const field of fields) {
+        // Support nested field access with dot notation
+        if (field.includes('.')) {
+            const parts = field.split('.');
+            const value = getNestedValue(obj, parts);
+            if (value !== undefined) {
+                setNestedValue(filtered, parts, value);
+            }
+        }
+        else {
+            if (field in obj) {
+                filtered[field] = obj[field];
+            }
+        }
+    }
+    return filtered;
+}
+/**
+ * Remove fields with null, undefined, or empty string values
+ */
+function removeEmptyFields(obj) {
+    const cleaned = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value !== null && value !== undefined && value !== '') {
+            // Recursively clean nested objects
+            if (typeof value === 'object' && !Array.isArray(value)) {
+                const cleanedNested = removeEmptyFields(value);
+                if (Object.keys(cleanedNested).length > 0) {
+                    cleaned[key] = cleanedNested;
+                }
+            }
+            else {
+                cleaned[key] = value;
+            }
+        }
+    }
+    return cleaned;
+}
+/**
+ * Create compact representation of an item
+ * Removes verbose fields, keeps only essentials
+ */
+function compactItem(item) {
+    const compact = {};
+    // Always include id and name if present
+    if ('id' in item)
+        compact.id = item.id;
+    if ('name' in item)
+        compact.name = item.name;
+    // Include status fields if present (billing critical)
+    if ('status_id' in item)
+        compact.status_id = item.status_id;
+    if ('status_name' in item)
+        compact.status_name = item.status_name;
+    if ('inactive' in item)
+        compact.inactive = item.inactive;
+    // Include key identifiers for HaloPSA
+    if ('key_field' in item && item.key_field) {
+        compact.serial_number = item.key_field;
+    }
+    if ('key_field2' in item && item.key_field2) {
+        compact.hostname = item.key_field2;
+    }
+    if ('emailaddress' in item && item.emailaddress) {
+        compact.email = item.emailaddress;
+    }
+    if ('inventory_number' in item && item.inventory_number) {
+        compact.inventory_number = item.inventory_number;
+    }
+    // Include client/site references
+    if ('client_id' in item)
+        compact.client_id = item.client_id;
+    if ('client_name' in item)
+        compact.client_name = item.client_name;
+    return compact;
+}
+/**
+ * Get nested value from object using path parts
+ */
+function getNestedValue(obj, parts) {
+    let current = obj;
+    for (const part of parts) {
+        if (current && typeof current === 'object' && part in current) {
+            current = current[part];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return current;
+}
+/**
+ * Set nested value in object using path parts
+ */
+function setNestedValue(obj, parts, value) {
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (!(part in current)) {
+            current[part] = {};
+        }
+        current = current[part];
+    }
+    current[parts[parts.length - 1]] = value;
+}
+//# sourceMappingURL=formatter.js.map

package/dist/utils/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../src/utils/formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAa,EACb,UAAyB,EAAE,EAC3B,IAA8B;IAE9B,MAAM,EACJ,MAAM,GAAG,UAAU,EACnB,MAAM,EACN,UAAU,GAAG,KAAK,GACnB,GAAG,OAAO,CAAC;IAEZ,eAAe;IACf,IAAI,aAAsB,CAAC;IAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IACpF,CAAC;SAAM,CAAC;QACN,aAAa,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC;IAED,sBAAsB;IACtB,MAAM,MAAM,GAA4B,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QACzD,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE;QACzB,CAAC,CAAC,aAAwC,CAAC;IAE7C,6CAA6C;IAC7C,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,qCAAqC;IACrC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,yCAAyC;YACzC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAEhC,KAAK,UAAU;YACb,yCAAyC;YACzC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAEhC,KAAK,UAAU;YACb,kCAAkC;YAClC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAEzC;YACE,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAClB,IAAO,EACP,MAAiB,EACjB,SAAmB,EACnB,MAAe;IAEf,qCAAqC;IACrC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,SAAS,GAA4B,EAAE,GAAI,IAAgC,EAAE,CAAC;IAElF,wBAAwB;IACxB,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,SAAS,GAAG,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED,mCAAmC;IACnC,IAAI,SAAS,EAAE,CAAC;QACd,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IAED,wCAAwC;IACxC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CACnB,GAA4B,EAC5B,MAAgB;IAEhB,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAE7C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,gDAAgD;QAChD,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC/B,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACzC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,cAAc,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;gBACjB,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CACxB,GAA4B;IAE5B,MAAM,OAAO,GAA4B,EAAE,CAAC;IAE5C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YAC1D,mCAAmC;YACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvD,MAAM,aAAa,GAAG,iBAAiB,CAAC,KAAgC,CAAC,CAAC;gBAC1E,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC1C,OAAO,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC;gBAC/B,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,IAA6B;IAChD,MAAM,OAAO,GAA4B,EAAE,CAAC;IAE5C,wCAAwC;IACxC,IAAI,IAAI,IAAI,IAAI;QAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;IACvC,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IAE7C,sDAAsD;IACtD,IAAI,WAAW,IAAI,IAAI;QAAE,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAC5D,IAAI,aAAa,IAAI,IAAI;QAAE,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IAClE,IAAI,UAAU,IAAI,IAAI;QAAE,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAEzD,sCAAsC;IACtC,IAAI,WAAW,IAAI,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAC1C,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC;IACzC,CAAC;IACD,IAAI,YAAY,IAAI,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAC5C,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC;IACrC,CAAC;IACD,IAAI,cAAc,IAAI,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QAChD,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC;IACpC,CAAC;IACD,IAAI,kBAAkB,IAAI,IAAI,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxD,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;IACnD,CAAC;IAED,iCAAiC;IACjC,IAAI,WAAW,IAAI,IAAI;QAAE,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAC5D,IAAI,aAAa,IAAI,IAAI;QAAE,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IAElE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,GAA4B,EAAE,KAAe;IACnE,IAAI,OAAO,GAAY,GAAG,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,IAAI,IAAK,OAAmC,EAAE,CAAC;YAC3F,OAAO,GAAI,OAAmC,CAAC,IAAI,CAAC,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CACrB,GAA4B,EAC5B,KAAe,EACf,KAAc;IAEd,IAAI,OAAO,GAA4B,GAAG,CAAC;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACrB,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,IAAI,CAA4B,CAAC;IACrD,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AAC3C,CAAC"}

package/dist/utils/similarity.d.ts

@@ -0,0 +1,25 @@
+/**
+ * String similarity algorithms for deduplication
+ * Used for fuzzy matching in site/organization name comparisons
+ */
+/**
+ * Calculate Levenshtein distance between two strings
+ * Returns the minimum number of single-character edits required to change one string into another
+ */
+export declare function getLevenshteinDistance(str1: string, str2: string): number;
+/**
+ * Calculate similarity percentage between two strings using Levenshtein distance
+ * Returns a value between 0 (completely different) and 1 (identical)
+ */
+export declare function getStringSimilarity(str1: string, str2: string): number;
+/**
+ * Normalize an address string for comparison
+ * Removes common variations to improve matching
+ */
+export declare function normalizeAddress(address: string): string;
+/**
+ * Compare two addresses with normalization
+ * Returns similarity score between 0 and 1
+ */
+export declare function getAddressSimilarity(addr1: string, addr2: string): number;
+//# sourceMappingURL=similarity.d.ts.map

package/dist/utils/similarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"similarity.d.ts","sourceRoot":"","sources":["../../src/utils/similarity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA8BzE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAoBtE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAqBxD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKzE"}

package/dist/utils/similarity.js

@@ -0,0 +1,90 @@
+/**
+ * String similarity algorithms for deduplication
+ * Used for fuzzy matching in site/organization name comparisons
+ */
+/**
+ * Calculate Levenshtein distance between two strings
+ * Returns the minimum number of single-character edits required to change one string into another
+ */
+export function getLevenshteinDistance(str1, str2) {
+    const len1 = str1.length;
+    const len2 = str2.length;
+    // Create distance matrix
+    const matrix = Array(len1 + 1)
+        .fill(null)
+        .map(() => Array(len2 + 1).fill(0));
+    // Initialize first row and column
+    for (let i = 0; i <= len1; i++) {
+        matrix[i][0] = i;
+    }
+    for (let j = 0; j <= len2; j++) {
+        matrix[0][j] = j;
+    }
+    // Calculate distance
+    for (let i = 1; i <= len1; i++) {
+        for (let j = 1; j <= len2; j++) {
+            const cost = str1[i - 1] === str2[j - 1] ? 0 : 1;
+            matrix[i][j] = Math.min(matrix[i - 1][j] + 1, // deletion
+            matrix[i][j - 1] + 1, // insertion
+            matrix[i - 1][j - 1] + cost // substitution
+            );
+        }
+    }
+    return matrix[len1][len2];
+}
+/**
+ * Calculate similarity percentage between two strings using Levenshtein distance
+ * Returns a value between 0 (completely different) and 1 (identical)
+ */
+export function getStringSimilarity(str1, str2) {
+    if (!str1 || !str2) {
+        return 0;
+    }
+    // Normalize: lowercase, trim whitespace
+    const normalized1 = str1.toLowerCase().trim();
+    const normalized2 = str2.toLowerCase().trim();
+    if (normalized1 === normalized2) {
+        return 1;
+    }
+    const maxLength = Math.max(normalized1.length, normalized2.length);
+    const distance = getLevenshteinDistance(normalized1, normalized2);
+    // Convert distance to similarity percentage
+    const similarity = 1 - distance / maxLength;
+    return Math.round(similarity * 100) / 100; // Round to 2 decimal places
+}
+/**
+ * Normalize an address string for comparison
+ * Removes common variations to improve matching
+ */
+export function normalizeAddress(address) {
+    if (!address)
+        return '';
+    return address
+        .toLowerCase()
+        .trim()
+        // Normalize common abbreviations
+        .replace(/\bstreet\b/g, 'st')
+        .replace(/\bavenue\b/g, 'ave')
+        .replace(/\bboulevard\b/g, 'blvd')
+        .replace(/\bdrive\b/g, 'dr')
+        .replace(/\broad\b/g, 'rd')
+        .replace(/\blane\b/g, 'ln')
+        .replace(/\bcourt\b/g, 'ct')
+        .replace(/\bapartment\b/g, 'apt')
+        .replace(/\bsuite\b/g, 'ste')
+        .replace(/\bbuilding\b/g, 'bldg')
+        // Remove punctuation
+        .replace(/[.,#]/g, '')
+        // Normalize whitespace
+        .replace(/\s+/g, ' ');
+}
+/**
+ * Compare two addresses with normalization
+ * Returns similarity score between 0 and 1
+ */
+export function getAddressSimilarity(addr1, addr2) {
+    const normalized1 = normalizeAddress(addr1);
+    const normalized2 = normalizeAddress(addr2);
+    return getStringSimilarity(normalized1, normalized2);
+}
+//# sourceMappingURL=similarity.js.map

package/dist/utils/similarity.js.map

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

package/dist/utils/zod-to-schema.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Converts Zod schemas to MCP-compatible JSON Schema objects.
+ *
+ * The MCP SDK expects inputSchema as:
+ *   { type: 'object', properties: Record<string, unknown>, required?: string[] }
+ *
+ * This utility traverses Zod's internal _def structure to produce that shape,
+ * handling the types used across ITGlue MCP tool schemas: string, number,
+ * boolean, array, object, enum, literal, optional, default, and effects
+ * (z.coerce). Descriptions and numeric min/max checks are preserved.
+ */
+import { z } from 'zod';
+/**
+ * MCP-compatible JSON Schema for a tool's inputSchema.
+ */
+interface McpInputSchema {
+    type: 'object';
+    properties: Record<string, unknown>;
+    required?: string[];
+}
+/**
+ * Convert a top-level Zod object schema to an MCP-compatible inputSchema.
+ *
+ * The input is expected to be a z.ZodObject (possibly wrapped in optional/effects).
+ * Returns { type: 'object', properties: {...}, required?: [...] }.
+ */
+export declare function zodToJsonSchema(schema: z.ZodType): McpInputSchema;
+export {};
+//# sourceMappingURL=zod-to-schema.d.ts.map

package/dist/utils/zod-to-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-schema.d.ts","sourceRoot":"","sources":["../../src/utils/zod-to-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,UAAU,cAAc;IACtB,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAkLD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,cAAc,CASjE"}