@iamsamuelfraga/mcp-pipedrive 1.0.3

package/dist/tools/search/universal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"universal.d.ts","sourceRoot":"","sources":["../../../src/tools/search/universal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA6ClC,OAAO;;EAsBlC"}

package/dist/tools/search/universal.js

@@ -0,0 +1,64 @@
+import { UniversalSearchSchema } from '../../schemas/search.js';
+export function getUniversalSearchTool(client) {
+    return {
+        'search/universal': {
+            description: `Search across all Pipedrive entities (deals, persons, organizations, products, leads, files).
+
+Performs a universal search that can search across multiple item types simultaneously.
+
+Workflow tips:
+- Search term must be at least 2 characters (1 if exact_match is true)
+- Specify item_types to limit search to specific entities
+- Use exact_match=true for precise searches
+- search_for_related_items=true includes up to 100 related items
+- Results include result_score for relevance ranking
+- Can search specific fields using the fields parameter
+
+Common use cases:
+- Search everything: { "term": "acme" }
+- Search deals only: { "term": "contract", "item_types": ["deal"] }
+- Search persons and orgs: { "term": "john", "item_types": ["person", "organization"] }
+- Exact match search: { "term": "John Smith", "exact_match": true }
+- Search specific fields: { "term": "email@example.com", "fields": "email,phone" }`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    term: { type: 'string', description: 'Search term (min 2 chars, 1 if exact_match)' },
+                    item_types: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                            enum: ['deal', 'person', 'organization', 'product', 'lead', 'file'],
+                        },
+                        description: 'Array of item types to search',
+                    },
+                    fields: { type: 'string', description: 'Comma-separated field names to search' },
+                    exact_match: { type: 'boolean', description: 'Perform exact match search' },
+                    search_for_related_items: {
+                        type: 'boolean',
+                        description: 'Include up to 100 related items in results',
+                        default: true,
+                    },
+                    start: { type: 'number', description: 'Pagination start', default: 0 },
+                    limit: { type: 'number', description: 'Number of items to return', default: 100 },
+                },
+                required: ['term'],
+            },
+            handler: async (args) => {
+                const validated = UniversalSearchSchema.parse(args);
+                const { start, limit, item_types, ...filters } = validated;
+                const params = {
+                    ...filters,
+                    start: start ?? 0,
+                    limit: limit ?? 100,
+                };
+                if (item_types) {
+                    params.item_types = item_types.join(',');
+                }
+                return client.get('/itemSearch', params, { enabled: true, ttl: 60000 } // Cache for 1 minute
+                );
+            },
+        },
+    };
+}
+//# sourceMappingURL=universal.js.map

package/dist/tools/search/universal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"universal.js","sourceRoot":"","sources":["../../../src/tools/search/universal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,UAAU,sBAAsB,CAAC,MAAuB;IAC5D,OAAO;QACL,kBAAkB,EAAE;YAClB,WAAW,EAAE;;;;;;;;;;;;;;;;;mFAiBgE;YAC7E,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6CAA6C,EAAE;oBACpF,UAAU,EAAE;wBACV,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC;yBACpE;wBACD,WAAW,EAAE,+BAA+B;qBAC7C;oBACD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;oBAChF,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,4BAA4B,EAAE;oBAC3E,wBAAwB,EAAE;wBACxB,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,4CAA4C;wBACzD,OAAO,EAAE,IAAI;qBACd;oBACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC,EAAE;oBACtE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE,OAAO,EAAE,GAAG,EAAE;iBAClF;gBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;aACnB;YACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC/B,MAAM,SAAS,GAAG,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACpD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,EAAE,GAAG,SAAS,CAAC;gBAE3D,MAAM,MAAM,GAA8C;oBACxD,GAAG,OAAO;oBACV,KAAK,EAAE,KAAK,IAAI,CAAC;oBACjB,KAAK,EAAE,KAAK,IAAI,GAAG;iBACpB,CAAC;gBAEF,IAAI,UAAU,EAAE,CAAC;oBACf,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC3C,CAAC;gBAED,OAAO,MAAM,CAAC,GAAG,CACf,aAAa,EACb,MAAM,EACN,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,qBAAqB;iBACpD,CAAC;YACJ,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/system/addons.d.ts

@@ -0,0 +1,13 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+export declare function getListAddonsTool(client: PipedriveClient): {
+    'system/list_addons': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+            required: never[];
+        };
+        handler: () => Promise<unknown>;
+    };
+};
+//# sourceMappingURL=addons.d.ts.map

package/dist/tools/system/addons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addons.d.ts","sourceRoot":"","sources":["../../../src/tools/system/addons.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe;;;;;;;;;;EA0CxD"}

package/dist/tools/system/addons.js

@@ -0,0 +1,44 @@
+export function getListAddonsTool(client) {
+    return {
+        'system/list_addons': {
+            description: `Get all add-ons for a single company.
+
+Returns the add-ons (billing subscriptions) configured for your Pipedrive company account.
+
+Add-ons include features like:
+- LeadBooster (lead generation tools)
+- Prospector (contact database access)
+- Smart Docs (document management)
+- And other premium features
+
+This is useful for:
+- Checking which premium features are enabled
+- Understanding account capabilities
+- Determining available integrations
+- Auditing subscription status
+
+Cached for 24 hours as add-on configuration doesn't change frequently.
+
+Response includes array of add-on codes:
+- code: Add-on identifier (e.g., "leadbooster_v2", "prospector", "smart_docs_v2")
+
+Common use cases:
+- Check if LeadBooster is available before using lead features
+- Verify Smart Docs access for document operations
+- List all active premium features
+- Audit company subscriptions`,
+            inputSchema: {
+                type: 'object',
+                properties: {},
+                required: [],
+            },
+            handler: async () => {
+                return client.get('/billing/subscriptions/addons', undefined, {
+                    enabled: true,
+                    ttl: 86400000, // 24 hours
+                });
+            },
+        },
+    };
+}
+//# sourceMappingURL=addons.js.map

package/dist/tools/system/addons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addons.js","sourceRoot":"","sources":["../../../src/tools/system/addons.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAAC,MAAuB;IACvD,OAAO;QACL,oBAAoB,EAAE;YACpB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;8BAyBW;YACxB,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE,EAAE;gBACd,QAAQ,EAAE,EAAE;aACb;YACD,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,OAAO,MAAM,CAAC,GAAG,CAAC,+BAA+B,EAAE,SAAS,EAAE;oBAC5D,OAAO,EAAE,IAAI;oBACb,GAAG,EAAE,QAAQ,EAAE,WAAW;iBAC3B,CAAC,CAAC;YACL,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/system/currencies.d.ts

@@ -0,0 +1,13 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+export declare function getListCurrenciesTool(client: PipedriveClient): {
+    'system/list_currencies': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+            required: never[];
+        };
+        handler: () => Promise<unknown>;
+    };
+};
+//# sourceMappingURL=currencies.d.ts.map

package/dist/tools/system/currencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currencies.d.ts","sourceRoot":"","sources":["../../../src/tools/system/currencies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe;;;;;;;;;;EA2C5D"}

package/dist/tools/system/currencies.js

@@ -0,0 +1,45 @@
+export function getListCurrenciesTool(client) {
+    return {
+        'system/list_currencies': {
+            description: `Get list of supported currencies and exchange rates.
+
+Returns all currencies configured in your Pipedrive account, including:
+- Currency codes (USD, EUR, GBP, etc.)
+- Currency symbols and names
+- Exchange rates relative to account's default currency
+- Whether currency is active
+- Decimal precision
+
+This is essential for working with monetary fields and understanding currency conversions in deals and products.
+
+Cached for 24 hours as currency rates don't change frequently in Pipedrive configuration.
+
+Response includes array of currencies with:
+- id: Currency ID
+- code: ISO 4217 currency code (e.g., "USD", "EUR")
+- name: Full currency name (e.g., "US Dollar")
+- symbol: Currency symbol (e.g., "$", "€")
+- decimal_points: Number of decimal places
+- is_custom_flag: Whether it's a custom currency
+- active_flag: Whether currency is active
+
+Common use cases:
+- Get supported currencies before creating deals
+- Validate currency codes for monetary fields
+- Understand exchange rates for reporting
+- Check which currencies are active in the account`,
+            inputSchema: {
+                type: 'object',
+                properties: {},
+                required: [],
+            },
+            handler: async () => {
+                return client.get('/currencies', undefined, {
+                    enabled: true,
+                    ttl: 86400000, // 24 hours
+                });
+            },
+        },
+    };
+}
+//# sourceMappingURL=currencies.js.map

package/dist/tools/system/currencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currencies.js","sourceRoot":"","sources":["../../../src/tools/system/currencies.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,qBAAqB,CAAC,MAAuB;IAC3D,OAAO;QACL,wBAAwB,EAAE;YACxB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;mDA0BgC;YAC7C,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE,EAAE;gBACd,QAAQ,EAAE,EAAE;aACb;YACD,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,OAAO,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,SAAS,EAAE;oBAC1C,OAAO,EAAE,IAAI;oBACb,GAAG,EAAE,QAAQ,EAAE,WAAW;iBAC3B,CAAC,CAAC;YACL,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/system/health.d.ts

@@ -0,0 +1,23 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+export declare function getHealthCheckTool(client: PipedriveClient): {
+    'system/health_check': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+            required: never[];
+        };
+        handler: () => Promise<{
+            healthy: boolean;
+            user: unknown;
+            timestamp: string;
+            error?: undefined;
+        } | {
+            healthy: boolean;
+            error: string;
+            timestamp: string;
+            user?: undefined;
+        }>;
+    };
+};
+//# sourceMappingURL=health.d.ts.map

package/dist/tools/system/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/tools/system/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe;;;;;;;;;;;;;;;;;;;;EA+CzD"}

package/dist/tools/system/health.js

@@ -0,0 +1,49 @@
+export function getHealthCheckTool(client) {
+    return {
+        'system/health_check': {
+            description: `Check API connectivity and authentication status.
+
+Verifies that the Pipedrive API is accessible and the authentication token is valid by making a test request to GET /users/me.
+
+Returns:
+- healthy: Boolean indicating if the API is accessible
+- user: Current authenticated user information (if healthy)
+- timestamp: Time of the health check
+- error: Error details if unhealthy
+
+Cached for 60 seconds to avoid excessive health checks.
+
+Common use cases:
+- Verify API token is valid
+- Check if Pipedrive API is accessible
+- Get basic connection status before performing operations
+- Troubleshoot authentication issues`,
+            inputSchema: {
+                type: 'object',
+                properties: {},
+                required: [],
+            },
+            handler: async () => {
+                try {
+                    const user = await client.get('/users/me', undefined, {
+                        enabled: true,
+                        ttl: 60000, // 60 seconds
+                    });
+                    return {
+                        healthy: true,
+                        user,
+                        timestamp: new Date().toISOString(),
+                    };
+                }
+                catch (error) {
+                    return {
+                        healthy: false,
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                        timestamp: new Date().toISOString(),
+                    };
+                }
+            },
+        },
+    };
+}
+//# sourceMappingURL=health.js.map

package/dist/tools/system/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../src/tools/system/health.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAAC,MAAuB;IACxD,OAAO;QACL,qBAAqB,EAAE;YACrB,WAAW,EAAE;;;;;;;;;;;;;;;;qCAgBkB;YAC/B,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE,EAAE;gBACd,QAAQ,EAAE,EAAE;aACb;YACD,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,EAAE;wBACpD,OAAO,EAAE,IAAI;wBACb,GAAG,EAAE,KAAK,EAAE,aAAa;qBAC1B,CAAC,CAAC;oBAEH,OAAO;wBACL,OAAO,EAAE,IAAI;wBACb,IAAI;wBACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;qBACpC,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;wBAC/D,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;qBACpC,CAAC;gBACJ,CAAC;YACH,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/system/index.d.ts

@@ -0,0 +1,151 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+/**
+ * Get all system-related tools for the MCP server
+ *
+ * This function aggregates all 9 system utility tools into a single object:
+ * - Monitoring: get_metrics, health_check
+ * - User info: get_current_user, get_user_settings, get_user_connections
+ * - Configuration: list_currencies, list_addons
+ * - Activity: get_recents
+ * - Utilities: reset_cache
+ *
+ * These tools provide system utilities, monitoring capabilities, and meta-information
+ * about the MCP server and Pipedrive account.
+ *
+ * @param client - The PipedriveClient instance to use for API calls
+ * @returns Object containing all system tools with their configurations
+ */
+export declare function getSystemTools(client: PipedriveClient): {
+    'system/get_user_settings': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+            required: never[];
+        };
+        handler: () => Promise<unknown>;
+    };
+    'system/get_user_connections': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+            required: never[];
+        };
+        handler: () => Promise<unknown>;
+    };
+    'system/get_recents': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                since_timestamp: {
+                    type: string;
+                    description: string;
+                };
+                items: {
+                    type: string;
+                    description: string;
+                };
+                start: {
+                    type: string;
+                    description: string;
+                };
+                limit: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: unknown) => Promise<unknown>;
+    };
+    'system/list_addons': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+            required: never[];
+        };
+        handler: () => Promise<unknown>;
+    };
+    'system/reset_cache': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+            required: never[];
+        };
+        handler: () => Promise<{
+            message: string;
+            previousSize: number;
+            timestamp: string;
+        }>;
+    };
+    'system/list_currencies': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+            required: never[];
+        };
+        handler: () => Promise<unknown>;
+    };
+    'system/get_current_user': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+            required: never[];
+        };
+        handler: () => Promise<unknown>;
+    };
+    'system/health_check': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+            required: never[];
+        };
+        handler: () => Promise<{
+            healthy: boolean;
+            user: unknown;
+            timestamp: string;
+            error?: undefined;
+        } | {
+            healthy: boolean;
+            error: string;
+            timestamp: string;
+            user?: undefined;
+        }>;
+    };
+    'system/get_metrics': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+            required: never[];
+        };
+        handler: () => Promise<{
+            cacheStats: {
+                size: number;
+            };
+            rateLimiterStats: {
+                RECEIVED: number;
+                QUEUED: number;
+                RUNNING: number;
+                EXECUTING: number;
+                DONE?: number;
+            };
+            timestamp: string;
+            requestCount: number;
+            errorCount: number;
+            totalDuration: number;
+            averageDuration: number;
+            errorRate: number;
+            requestsByEndpoint: Record<string, number>;
+            errorsByEndpoint: Record<string, number>;
+        }>;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/system/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/system/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAWjE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYrD"}

package/dist/tools/system/index.js

@@ -0,0 +1,39 @@
+import { getMetricsTool } from './metrics.js';
+import { getHealthCheckTool } from './health.js';
+import { getCurrentUserTool } from './user.js';
+import { getListCurrenciesTool } from './currencies.js';
+import { getResetCacheTool } from './reset-cache.js';
+import { getListAddonsTool } from './addons.js';
+import { getRecentsTool } from './recents.js';
+import { getUserConnectionsTool } from './user-connections.js';
+import { getUserSettingsTool } from './user-settings.js';
+/**
+ * Get all system-related tools for the MCP server
+ *
+ * This function aggregates all 9 system utility tools into a single object:
+ * - Monitoring: get_metrics, health_check
+ * - User info: get_current_user, get_user_settings, get_user_connections
+ * - Configuration: list_currencies, list_addons
+ * - Activity: get_recents
+ * - Utilities: reset_cache
+ *
+ * These tools provide system utilities, monitoring capabilities, and meta-information
+ * about the MCP server and Pipedrive account.
+ *
+ * @param client - The PipedriveClient instance to use for API calls
+ * @returns Object containing all system tools with their configurations
+ */
+export function getSystemTools(client) {
+    return {
+        ...getMetricsTool(client),
+        ...getHealthCheckTool(client),
+        ...getCurrentUserTool(client),
+        ...getListCurrenciesTool(client),
+        ...getResetCacheTool(client),
+        ...getListAddonsTool(client),
+        ...getRecentsTool(client),
+        ...getUserConnectionsTool(client),
+        ...getUserSettingsTool(client),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/system/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/system/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,MAAuB;IACpD,OAAO;QACL,GAAG,cAAc,CAAC,MAAM,CAAC;QACzB,GAAG,kBAAkB,CAAC,MAAM,CAAC;QAC7B,GAAG,kBAAkB,CAAC,MAAM,CAAC;QAC7B,GAAG,qBAAqB,CAAC,MAAM,CAAC;QAChC,GAAG,iBAAiB,CAAC,MAAM,CAAC;QAC5B,GAAG,iBAAiB,CAAC,MAAM,CAAC;QAC5B,GAAG,cAAc,CAAC,MAAM,CAAC;QACzB,GAAG,sBAAsB,CAAC,MAAM,CAAC;QACjC,GAAG,mBAAmB,CAAC,MAAM,CAAC;KAC/B,CAAC;AACJ,CAAC"}

package/dist/tools/system/metrics.d.ts

@@ -0,0 +1,32 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+export declare function getMetricsTool(client: PipedriveClient): {
+    'system/get_metrics': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {};
+            required: never[];
+        };
+        handler: () => Promise<{
+            cacheStats: {
+                size: number;
+            };
+            rateLimiterStats: {
+                RECEIVED: number;
+                QUEUED: number;
+                RUNNING: number;
+                EXECUTING: number;
+                DONE?: number;
+            };
+            timestamp: string;
+            requestCount: number;
+            errorCount: number;
+            totalDuration: number;
+            averageDuration: number;
+            errorRate: number;
+            requestsByEndpoint: Record<string, number>;
+            errorsByEndpoint: Record<string, number>;
+        }>;
+    };
+};
+//# sourceMappingURL=metrics.d.ts.map

package/dist/tools/system/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/tools/system/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoDrD"}

package/dist/tools/system/metrics.js

@@ -0,0 +1,54 @@
+import { metricsCollector } from '../../utils/metrics.js';
+export function getMetricsTool(client) {
+    return {
+        'system/get_metrics': {
+            description: `Get performance metrics for the MCP server.
+
+Returns comprehensive statistics about the server's performance including:
+- Request counts and error rates
+- Average response times
+- Requests and errors by endpoint
+- Cache statistics (size, hit rate)
+- Rate limiter statistics
+
+Useful for monitoring server health, debugging performance issues, and understanding usage patterns.
+
+Metrics are always fresh (not cached) to provide real-time data.
+
+Response includes:
+- requestCount: Total number of API requests made
+- errorCount: Total number of failed requests
+- totalDuration: Cumulative request duration in milliseconds
+- averageDuration: Average request duration in milliseconds
+- errorRate: Percentage of requests that failed (0.0 to 1.0)
+- requestsByEndpoint: Request count breakdown by endpoint
+- errorsByEndpoint: Error count breakdown by endpoint
+- cacheStats: Current cache size and statistics
+- rateLimiterStats: Rate limiter queue and token information
+- timestamp: Current server time
+
+Common use cases:
+- Monitor server performance
+- Debug slow responses or errors
+- Analyze usage patterns
+- Check cache effectiveness`,
+            inputSchema: {
+                type: 'object',
+                properties: {},
+                required: [],
+            },
+            handler: async () => {
+                const metrics = metricsCollector.getMetrics();
+                const cacheStats = client.getCacheStats();
+                const rateLimiterStats = client.getRateLimiterStats();
+                return {
+                    ...metrics,
+                    cacheStats,
+                    rateLimiterStats,
+                    timestamp: new Date().toISOString(),
+                };
+            },
+        },
+    };
+}
+//# sourceMappingURL=metrics.js.map

package/dist/tools/system/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/tools/system/metrics.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,UAAU,cAAc,CAAC,MAAuB;IACpD,OAAO;QACL,oBAAoB,EAAE;YACpB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BA6BS;YACtB,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE,EAAE;gBACd,QAAQ,EAAE,EAAE;aACb;YACD,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,MAAM,OAAO,GAAG,gBAAgB,CAAC,UAAU,EAAE,CAAC;gBAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;gBAC1C,MAAM,gBAAgB,GAAG,MAAM,CAAC,mBAAmB,EAAE,CAAC;gBAEtD,OAAO;oBACL,GAAG,OAAO;oBACV,UAAU;oBACV,gBAAgB;oBAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC,CAAC;YACJ,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/system/recents.d.ts

@@ -0,0 +1,30 @@
+import type { PipedriveClient } from '../../pipedrive-client.js';
+export declare function getRecentsTool(client: PipedriveClient): {
+    'system/get_recents': {
+        description: string;
+        inputSchema: {
+            type: "object";
+            properties: {
+                since_timestamp: {
+                    type: string;
+                    description: string;
+                };
+                items: {
+                    type: string;
+                    description: string;
+                };
+                start: {
+                    type: string;
+                    description: string;
+                };
+                limit: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        handler: (args: unknown) => Promise<unknown>;
+    };
+};
+//# sourceMappingURL=recents.d.ts.map

package/dist/tools/system/recents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recents.d.ts","sourceRoot":"","sources":["../../../src/tools/system/recents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;wBA4D1B,OAAO;;EAMlC"}