@sardis/mcp-server 0.2.6 → 1.0.0

package/dist/tools/guardrails.js

@@ -0,0 +1,379 @@
+/**
+ * Guardrails tools for MCP server
+ */
+import { getConfig } from '../config.js';
+import { apiRequest } from '../api.js';
+import { z } from 'zod';
+// Schemas
+const CheckCircuitBreakerSchema = z.object({
+    wallet_id: z.string().optional(),
+});
+const ActivateKillSwitchSchema = z.object({
+    wallet_id: z.string().optional(),
+    reason: z.string(),
+});
+const DeactivateKillSwitchSchema = z.object({
+    wallet_id: z.string().optional(),
+});
+const CheckRateLimitsSchema = z.object({
+    wallet_id: z.string().optional(),
+});
+const GetBehavioralAlertsSchema = z.object({
+    wallet_id: z.string().optional(),
+    severity: z.enum(['low', 'medium', 'high', 'critical']).optional(),
+    limit: z.number().min(1).max(100).optional(),
+    since: z.string().optional(),
+});
+// Tool definitions
+export const guardrailsToolDefinitions = [
+    {
+        name: 'sardis_check_circuit_breaker',
+        description: 'Check circuit breaker and kill switch status for a wallet. Returns operational status and any active safety controls.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                wallet_id: {
+                    type: 'string',
+                    description: 'Wallet ID to check. Uses default wallet if not specified.',
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'sardis_activate_kill_switch',
+        description: 'EMERGENCY: Activate kill switch to halt ALL transactions for a wallet. Use only in security emergencies.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                wallet_id: {
+                    type: 'string',
+                    description: 'Wallet ID to halt. Uses default wallet if not specified.',
+                },
+                reason: {
+                    type: 'string',
+                    description: 'Reason for activating kill switch (required for audit trail)',
+                },
+            },
+            required: ['reason'],
+        },
+    },
+    {
+        name: 'sardis_deactivate_kill_switch',
+        description: 'Deactivate kill switch to resume normal wallet operations. Use after security issue is resolved.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                wallet_id: {
+                    type: 'string',
+                    description: 'Wallet ID to resume. Uses default wallet if not specified.',
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'sardis_check_rate_limits',
+        description: 'Check transaction rate limits and spending velocity. Monitor for approaching thresholds.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                wallet_id: {
+                    type: 'string',
+                    description: 'Wallet ID to check. Uses default wallet if not specified.',
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'sardis_get_behavioral_alerts',
+        description: 'Get behavioral anomaly alerts for a wallet. Identifies unusual spending patterns and security threats.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                wallet_id: {
+                    type: 'string',
+                    description: 'Wallet ID to check. Uses default wallet if not specified.',
+                },
+                severity: {
+                    type: 'string',
+                    enum: ['low', 'medium', 'high', 'critical'],
+                    description: 'Filter by alert severity',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of alerts to return (1-100)',
+                },
+                since: {
+                    type: 'string',
+                    description: 'ISO 8601 timestamp - only return alerts after this time',
+                },
+            },
+            required: [],
+        },
+    },
+];
+// Tool handlers
+export const guardrailsToolHandlers = {
+    sardis_check_circuit_breaker: async (args) => {
+        const parsed = CheckCircuitBreakerSchema.safeParse(args);
+        const config = getConfig();
+        const walletId = parsed.success && parsed.data.wallet_id
+            ? parsed.data.wallet_id
+            : config.walletId || 'wallet_default';
+        if (!config.apiKey || config.mode === 'simulated') {
+            // Simulated response
+            const mockStatus = {
+                wallet_id: walletId,
+                circuit_breaker: {
+                    active: false,
+                    reason: null,
+                    triggered_at: null,
+                    auto_recovery: true,
+                },
+                kill_switch: {
+                    active: false,
+                    activated_by: null,
+                    activated_at: null,
+                    requires_manual_reset: true,
+                },
+                rate_limits: {
+                    tx_per_minute: {
+                        limit: 5,
+                        current: 1.2,
+                        percentage_used: 24.0,
+                        breached: false,
+                    },
+                    tx_per_hour: {
+                        limit: 100,
+                        current: 23,
+                        percentage_used: 23.0,
+                        breached: false,
+                    },
+                    spend_per_hour_usd: {
+                        limit: 1000.0,
+                        current: 125.5,
+                        percentage_used: 12.55,
+                        breached: false,
+                    },
+                },
+                status: 'operational',
+                last_checked: new Date().toISOString(),
+            };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(mockStatus, null, 2) }],
+            };
+        }
+        try {
+            const status = await apiRequest('GET', '/api/v2/guardrails/status', undefined, { 'X-Wallet-ID': walletId });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(status, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Failed to check circuit breaker: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    }],
+                isError: true,
+            };
+        }
+    },
+    sardis_activate_kill_switch: async (args) => {
+        const parsed = ActivateKillSwitchSchema.safeParse(args);
+        if (!parsed.success) {
+            return {
+                content: [{ type: 'text', text: `Invalid request: ${parsed.error.message}` }],
+                isError: true,
+            };
+        }
+        const config = getConfig();
+        const walletId = parsed.data.wallet_id || config.walletId || 'wallet_default';
+        if (!config.apiKey || config.mode === 'simulated') {
+            // Simulated response
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            wallet_id: walletId,
+                            kill_switch_active: true,
+                            activated_by: 'simulated_user',
+                            activated_at: new Date().toISOString(),
+                            reason: parsed.data.reason,
+                            message: '⚠️ KILL SWITCH ACTIVATED - All transactions halted',
+                            status: 'halted',
+                        }, null, 2),
+                    }],
+            };
+        }
+        try {
+            const result = await apiRequest('POST', '/api/v2/guardrails/kill-switch/activate', {
+                wallet_id: walletId,
+                reason: parsed.data.reason,
+            });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Failed to activate kill switch: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    }],
+                isError: true,
+            };
+        }
+    },
+    sardis_deactivate_kill_switch: async (args) => {
+        const parsed = DeactivateKillSwitchSchema.safeParse(args);
+        const config = getConfig();
+        const walletId = parsed.success && parsed.data.wallet_id
+            ? parsed.data.wallet_id
+            : config.walletId || 'wallet_default';
+        if (!config.apiKey || config.mode === 'simulated') {
+            // Simulated response
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            wallet_id: walletId,
+                            kill_switch_active: false,
+                            deactivated_at: new Date().toISOString(),
+                            message: '✓ Kill switch deactivated - Wallet operational',
+                            status: 'operational',
+                        }, null, 2),
+                    }],
+            };
+        }
+        try {
+            const result = await apiRequest('POST', '/api/v2/guardrails/kill-switch/deactivate', { wallet_id: walletId });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Failed to deactivate kill switch: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    }],
+                isError: true,
+            };
+        }
+    },
+    sardis_check_rate_limits: async (args) => {
+        const parsed = CheckRateLimitsSchema.safeParse(args);
+        const config = getConfig();
+        const walletId = parsed.success && parsed.data.wallet_id
+            ? parsed.data.wallet_id
+            : config.walletId || 'wallet_default';
+        if (!config.apiKey || config.mode === 'simulated') {
+            // Simulated response
+            const mockLimits = {
+                wallet_id: walletId,
+                limits: {
+                    tx_per_minute: {
+                        limit: 5,
+                        current: 1.2,
+                        percentage_used: 24.0,
+                        breached: false,
+                    },
+                    tx_per_hour: {
+                        limit: 100,
+                        current: 23,
+                        percentage_used: 23.0,
+                        breached: false,
+                    },
+                    spend_per_hour_usd: {
+                        limit: '1000.00',
+                        current: '125.50',
+                        percentage_used: 12.55,
+                        breached: false,
+                    },
+                },
+                status: 'healthy',
+                last_checked: new Date().toISOString(),
+            };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(mockLimits, null, 2) }],
+            };
+        }
+        try {
+            const limits = await apiRequest('GET', '/api/v2/guardrails/rate-limits', undefined, { 'X-Wallet-ID': walletId });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(limits, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Failed to check rate limits: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    }],
+                isError: true,
+            };
+        }
+    },
+    sardis_get_behavioral_alerts: async (args) => {
+        const parsed = GetBehavioralAlertsSchema.safeParse(args);
+        const config = getConfig();
+        const walletId = parsed.success && parsed.data.wallet_id
+            ? parsed.data.wallet_id
+            : config.walletId || 'wallet_default';
+        const queryParams = new URLSearchParams();
+        if (parsed.success) {
+            if (parsed.data.severity)
+                queryParams.set('severity', parsed.data.severity);
+            if (parsed.data.limit)
+                queryParams.set('limit', parsed.data.limit.toString());
+            if (parsed.data.since)
+                queryParams.set('since', parsed.data.since);
+        }
+        if (!config.apiKey || config.mode === 'simulated') {
+            // Simulated response
+            const mockAlerts = {
+                wallet_id: walletId,
+                alerts: [
+                    {
+                        alert_id: 'alert_sim1',
+                        severity: 'medium',
+                        type: 'velocity_increase',
+                        message: 'Transaction rate slightly elevated',
+                        details: {
+                            normal_rate: '2.5 tx/min',
+                            current_rate: '3.2 tx/min',
+                            duration: '10 minutes',
+                        },
+                        timestamp: new Date(Date.now() - 600000).toISOString(),
+                        auto_blocked: false,
+                        requires_review: false,
+                    },
+                ],
+                total: 1,
+                has_critical: false,
+            };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(mockAlerts, null, 2) }],
+            };
+        }
+        try {
+            const alerts = await apiRequest('GET', `/api/v2/guardrails/alerts?${queryParams.toString()}`, undefined, { 'X-Wallet-ID': walletId });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(alerts, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Failed to get behavioral alerts: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    }],
+                isError: true,
+            };
+        }
+    },
+};
+//# sourceMappingURL=guardrails.js.map

package/dist/tools/guardrails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.js","sourceRoot":"","sources":["../../src/tools/guardrails.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAMvC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,UAAU;AACV,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAEH,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAuDH,mBAAmB;AACnB,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD;QACE,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE,uHAAuH;QACpI,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2DAA2D;iBACzE;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;IACD;QACE,IAAI,EAAE,6BAA6B;QACnC,WAAW,EAAE,0GAA0G;QACvH,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0DAA0D;iBACxE;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8DAA8D;iBAC5E;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF;IACD;QACE,IAAI,EAAE,+BAA+B;QACrC,WAAW,EAAE,kGAAkG;QAC/G,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4DAA4D;iBAC1E;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;IACD;QACE,IAAI,EAAE,0BAA0B;QAChC,WAAW,EAAE,0FAA0F;QACvG,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2DAA2D;iBACzE;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;IACD;QACE,IAAI,EAAE,8BAA8B;QACpC,WAAW,EAAE,wGAAwG;QACrH,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2DAA2D;iBACzE;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC;oBAC3C,WAAW,EAAE,0BAA0B;iBACxC;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4CAA4C;iBAC1D;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yDAAyD;iBACvE;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;CACF,CAAC;AAEF,gBAAgB;AAChB,MAAM,CAAC,MAAM,sBAAsB,GAAgC;IACjE,4BAA4B,EAAE,KAAK,EAAE,IAAa,EAAuB,EAAE;QACzE,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS;YACtD,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS;YACvB,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,gBAAgB,CAAC;QAExC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAClD,qBAAqB;YACrB,MAAM,UAAU,GAAqB;gBACnC,SAAS,EAAE,QAAQ;gBACnB,eAAe,EAAE;oBACf,MAAM,EAAE,KAAK;oBACb,MAAM,EAAE,IAAI;oBACZ,YAAY,EAAE,IAAI;oBAClB,aAAa,EAAE,IAAI;iBACpB;gBACD,WAAW,EAAE;oBACX,MAAM,EAAE,KAAK;oBACb,YAAY,EAAE,IAAI;oBAClB,YAAY,EAAE,IAAI;oBAClB,qBAAqB,EAAE,IAAI;iBAC5B;gBACD,WAAW,EAAE;oBACX,aAAa,EAAE;wBACb,KAAK,EAAE,CAAC;wBACR,OAAO,EAAE,GAAG;wBACZ,eAAe,EAAE,IAAI;wBACrB,QAAQ,EAAE,KAAK;qBAChB;oBACD,WAAW,EAAE;wBACX,KAAK,EAAE,GAAG;wBACV,OAAO,EAAE,EAAE;wBACX,eAAe,EAAE,IAAI;wBACrB,QAAQ,EAAE,KAAK;qBAChB;oBACD,kBAAkB,EAAE;wBAClB,KAAK,EAAE,MAAM;wBACb,OAAO,EAAE,KAAK;wBACd,eAAe,EAAE,KAAK;wBACtB,QAAQ,EAAE,KAAK;qBAChB;iBACF;gBACD,MAAM,EAAE,aAAa;gBACrB,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACvC,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACvE,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAC7B,KAAK,EACL,2BAA2B,EAC3B,SAAS,EACT,EAAE,aAAa,EAAE,QAAQ,EAAE,CAC5B,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,oCAAoC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;qBACrG,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;IAED,2BAA2B,EAAE,KAAK,EAAE,IAAa,EAAuB,EAAE;QACxE,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC7E,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,QAAQ,IAAI,gBAAgB,CAAC;QAE9E,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAClD,qBAAqB;YACrB,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,SAAS,EAAE,QAAQ;4BACnB,kBAAkB,EAAE,IAAI;4BACxB,YAAY,EAAE,gBAAgB;4BAC9B,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;4BACtC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;4BAC1B,OAAO,EAAE,oDAAoD;4BAC7D,MAAM,EAAE,QAAQ;yBACjB,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ,CAAC;aACH,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAO7B,MAAM,EACN,yCAAyC,EACzC;gBACE,SAAS,EAAE,QAAQ;gBACnB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;aAC3B,CACF,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,mCAAmC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;qBACpG,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;IAED,6BAA6B,EAAE,KAAK,EAAE,IAAa,EAAuB,EAAE;QAC1E,MAAM,MAAM,GAAG,0BAA0B,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS;YACtD,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS;YACvB,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,gBAAgB,CAAC;QAExC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAClD,qBAAqB;YACrB,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,SAAS,EAAE,QAAQ;4BACnB,kBAAkB,EAAE,KAAK;4BACzB,cAAc,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;4BACxC,OAAO,EAAE,gDAAgD;4BACzD,MAAM,EAAE,aAAa;yBACtB,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ,CAAC;aACH,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAM7B,MAAM,EACN,2CAA2C,EAC3C,EAAE,SAAS,EAAE,QAAQ,EAAE,CACxB,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,qCAAqC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;qBACtG,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;IAED,wBAAwB,EAAE,KAAK,EAAE,IAAa,EAAuB,EAAE;QACrE,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS;YACtD,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS;YACvB,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,gBAAgB,CAAC;QAExC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAClD,qBAAqB;YACrB,MAAM,UAAU,GAAG;gBACjB,SAAS,EAAE,QAAQ;gBACnB,MAAM,EAAE;oBACN,aAAa,EAAE;wBACb,KAAK,EAAE,CAAC;wBACR,OAAO,EAAE,GAAG;wBACZ,eAAe,EAAE,IAAI;wBACrB,QAAQ,EAAE,KAAK;qBAChB;oBACD,WAAW,EAAE;wBACX,KAAK,EAAE,GAAG;wBACV,OAAO,EAAE,EAAE;wBACX,eAAe,EAAE,IAAI;wBACrB,QAAQ,EAAE,KAAK;qBAChB;oBACD,kBAAkB,EAAE;wBAClB,KAAK,EAAE,SAAS;wBAChB,OAAO,EAAE,QAAQ;wBACjB,eAAe,EAAE,KAAK;wBACtB,QAAQ,EAAE,KAAK;qBAChB;iBACF;gBACD,MAAM,EAAE,SAAS;gBACjB,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACvC,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACvE,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAC7B,KAAK,EACL,gCAAgC,EAChC,SAAS,EACT,EAAE,aAAa,EAAE,QAAQ,EAAE,CAC5B,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,gCAAgC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;qBACjG,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;IAED,4BAA4B,EAAE,KAAK,EAAE,IAAa,EAAuB,EAAE;QACzE,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS;YACtD,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS;YACvB,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,gBAAgB,CAAC;QAExC,MAAM,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;QAC1C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ;gBAAE,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC5E,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK;gBAAE,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC9E,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK;gBAAE,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAClD,qBAAqB;YACrB,MAAM,UAAU,GAA6B;gBAC3C,SAAS,EAAE,QAAQ;gBACnB,MAAM,EAAE;oBACN;wBACE,QAAQ,EAAE,YAAY;wBACtB,QAAQ,EAAE,QAAQ;wBAClB,IAAI,EAAE,mBAAmB;wBACzB,OAAO,EAAE,oCAAoC;wBAC7C,OAAO,EAAE;4BACP,WAAW,EAAE,YAAY;4BACzB,YAAY,EAAE,YAAY;4BAC1B,QAAQ,EAAE,YAAY;yBACvB;wBACD,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE;wBACtD,YAAY,EAAE,KAAK;wBACnB,eAAe,EAAE,KAAK;qBACvB;iBACF;gBACD,KAAK,EAAE,CAAC;gBACR,YAAY,EAAE,KAAK;aACpB,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACvE,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAC7B,KAAK,EACL,6BAA6B,WAAW,CAAC,QAAQ,EAAE,EAAE,EACrD,SAAS,EACT,EAAE,aAAa,EAAE,QAAQ,EAAE,CAC5B,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,oCAAoC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;qBACrG,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/index.d.ts

@@ -2,7 +2,7 @@
  * Sardis MCP Server - Tool Registry
  *
  * Aggregates all tool definitions and handlers from domain-specific modules.
- * Total: 36+ tools across 9 categories.
+ * Total: 50+ tools across 12 modules.
  */
 import type { ToolDefinition, ToolHandler } from './types.js';
 export * from './types.js';
@@ -33,15 +33,19 @@ export declare function getAllToolNames(): string[];
  * Tool categories for organization
  */
 export declare const toolCategories: {
-    readonly wallet: readonly ["sardis_get_wallet", "sardis_get_balance", "sardis_create_wallet", "sardis_update_wallet_policy", "sardis_list_wallets"];
+    readonly wallet: readonly ["sardis_get_wallet", "sardis_get_balance", "sardis_create_wallet", "sardis_list_wallets"];
     readonly payment: readonly ["sardis_pay", "sardis_get_transaction", "sardis_list_transactions"];
-    readonly policy: readonly ["sardis_check_policy", "sardis_validate_limits", "sardis_check_compliance"];
-    readonly hold: readonly ["sardis_create_hold", "sardis_capture_hold", "sardis_void_hold", "sardis_get_hold", "sardis_list_holds", "sardis_extend_hold"];
+    readonly policy: readonly ["sardis_check_policy", "sardis_validate_limits", "sardis_check_compliance", "sardis_get_policies"];
+    readonly hold: readonly ["sardis_create_hold", "sardis_capture_hold", "sardis_void_hold", "sardis_release_hold", "sardis_get_hold", "sardis_list_holds", "sardis_extend_hold"];
     readonly agent: readonly ["sardis_create_agent", "sardis_get_agent", "sardis_list_agents", "sardis_update_agent"];
-    readonly card: readonly ["sardis_issue_card", "sardis_get_card", "sardis_list_cards", "sardis_freeze_card", "sardis_unfreeze_card", "sardis_cancel_card"];
-    readonly fiat: readonly ["sardis_fund_wallet", "sardis_withdraw_to_bank", "sardis_get_funding_status", "sardis_get_withdrawal_status"];
-    readonly approval: readonly ["sardis_request_approval", "sardis_get_approval_status"];
-    readonly spending: readonly ["sardis_get_spending_summary", "sardis_get_spending_by_vendor", "sardis_get_spending_by_category"];
+    readonly card: readonly ["sardis_issue_card", "sardis_create_card", "sardis_get_card", "sardis_list_cards", "sardis_freeze_card", "sardis_unfreeze_card", "sardis_cancel_card"];
+    readonly fiat: readonly ["sardis_sync_treasury_account_holder", "sardis_list_financial_accounts", "sardis_link_external_bank_account", "sardis_verify_micro_deposits", "sardis_fund_wallet", "sardis_withdraw_to_bank", "sardis_withdraw", "sardis_get_funding_status", "sardis_get_withdrawal_status", "sardis_get_treasury_balances", "sardis_list_funding_transactions", "sardis_get_multi_balance", "sardis_offramp_usdc_to_fiat", "sardis_onramp_fiat_to_usdc", "sardis_get_ramp_quote"];
+    readonly approval: readonly ["sardis_request_approval", "sardis_get_approval_status", "sardis_check_approval", "sardis_list_pending_approvals", "sardis_cancel_approval"];
+    readonly sandbox: readonly ["sardis_sandbox_demo"];
+    readonly group: readonly ["sardis_create_group", "sardis_get_group", "sardis_list_groups", "sardis_add_agent_to_group", "sardis_remove_agent_from_group", "sardis_get_group_spending"];
+    readonly spending: readonly ["sardis_get_spending_summary", "sardis_get_spending", "sardis_get_spending_by_vendor", "sardis_get_spending_by_category", "sardis_get_spending_trends"];
+    readonly event: readonly ["sardis_subscribe_events", "sardis_list_event_types", "sardis_get_event_history", "sardis_configure_webhook"];
+    readonly guardrails: readonly ["sardis_check_circuit_breaker", "sardis_activate_kill_switch", "sardis_deactivate_kill_switch", "sardis_check_rate_limits", "sardis_get_behavioral_alerts"];
 };
 /**
  * Get tools by category
@@ -51,6 +55,21 @@ export declare function getToolsByCategory(category: keyof typeof toolCategories
  * Get total tool count
  */
 export declare function getToolCount(): number;
+export type ToolRegistryValidationResult = {
+    definitionCount: number;
+    handlerCount: number;
+    isValid: boolean;
+    missingHandlersForDefinitions: string[];
+    missingDefinitionsForHandlers: string[];
+    duplicateDefinitions: string[];
+};
+/**
+ * Validate tool registry consistency between definitions and handlers.
+ *
+ * This is the authoritative source for all "tool count" claims in docs/CLI.
+ */
+export declare function validateToolRegistry(): ToolRegistryValidationResult;
+export declare function getValidatedToolCount(): number;
 /**
  * Get tool summary for documentation
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAgB9D,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,cAAc,EAY9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAYvD,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEpE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;CAyCjB,CAAC;AAEX;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,OAAO,cAAc,GAAG,cAAc,EAAE,CAG1F;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,CAMvF;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,cAAc,EAAE,CAE9C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAEhE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA4B9D,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,cAAc,EAe9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAevD,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEpE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;CAsFjB,CAAC;AAEX;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,OAAO,cAAc,GAAG,cAAc,EAAE,CAG1F;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,6BAA6B,EAAE,MAAM,EAAE,CAAC;IACxC,6BAA6B,EAAE,MAAM,EAAE,CAAC;IACxC,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,4BAA4B,CA8BnE;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,CAMvF;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,cAAc,EAAE,CAE9C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAEhE"}

package/dist/tools/index.js

@@ -2,7 +2,7 @@
  * Sardis MCP Server - Tool Registry
  *
  * Aggregates all tool definitions and handlers from domain-specific modules.
- * Total: 36+ tools across 9 categories.
+ * Total: 50+ tools across 12 modules.
  */
 // Import tool definitions and handlers from each module
 import { walletToolDefinitions, walletToolHandlers } from './wallets.js';
@@ -16,6 +16,13 @@ import { approvalToolDefinitions, approvalToolHandlers } from './approvals.js';
 import { spendingToolDefinitions, spendingToolHandlers } from './spending.js';
 import { walletManagementToolDefinitions, walletManagementToolHandlers } from './wallet-management.js';
 import { sandboxToolDefinitions, sandboxToolHandlers } from './sandbox.js';
+import { groupToolDefinitions, groupToolHandlers } from './groups.js';
+import { eventToolDefinitions, eventToolHandlers } from './events.js';
+import { guardrailsToolDefinitions, guardrailsToolHandlers } from './guardrails.js';
+// Handlers below are intentionally blocked for agent-facing use and excluded
+// from the aggregate registry to keep definition/handler parity.
+const { sardis_get_rules: _blockedGetRules, ...policyToolHandlersFiltered } = policyToolHandlers;
+const { sardis_update_wallet_limits: _blockedUpdateWalletLimits, sardis_archive_wallet: _blockedArchiveWallet, ...walletManagementToolHandlersFiltered } = walletManagementToolHandlers;
 // Re-export types
 export * from './types.js';
 // Re-export domain functions for direct use
@@ -37,6 +44,9 @@ export const allToolDefinitions = [
     ...spendingToolDefinitions,
     ...walletManagementToolDefinitions,
     ...sandboxToolDefinitions,
+    ...groupToolDefinitions,
+    ...eventToolDefinitions,
+    ...guardrailsToolDefinitions,
 ];
 /**
  * All tool handlers aggregated from modules
@@ -46,13 +56,16 @@ export const allToolHandlers = {
     ...holdToolHandlers,
     ...agentToolHandlers,
     ...paymentToolHandlers,
-    ...policyToolHandlers,
+    ...policyToolHandlersFiltered,
     ...cardToolHandlers,
     ...fiatToolHandlers,
     ...approvalToolHandlers,
     ...spendingToolHandlers,
-    ...walletManagementToolHandlers,
+    ...walletManagementToolHandlersFiltered,
     ...sandboxToolHandlers,
+    ...groupToolHandlers,
+    ...eventToolHandlers,
+    ...guardrailsToolHandlers,
 };
 /**
  * Get tool handler by name
@@ -76,13 +89,19 @@ export function getAllToolNames() {
  * Tool categories for organization
  */
 export const toolCategories = {
-    wallet: ['sardis_get_wallet', 'sardis_get_balance', 'sardis_create_wallet', 'sardis_update_wallet_policy', 'sardis_list_wallets'],
+    wallet: ['sardis_get_wallet', 'sardis_get_balance', 'sardis_create_wallet', 'sardis_list_wallets'],
     payment: ['sardis_pay', 'sardis_get_transaction', 'sardis_list_transactions'],
-    policy: ['sardis_check_policy', 'sardis_validate_limits', 'sardis_check_compliance'],
+    policy: [
+        'sardis_check_policy',
+        'sardis_validate_limits',
+        'sardis_check_compliance',
+        'sardis_get_policies',
+    ],
     hold: [
         'sardis_create_hold',
         'sardis_capture_hold',
         'sardis_void_hold',
+        'sardis_release_hold',
         'sardis_get_hold',
         'sardis_list_holds',
         'sardis_extend_hold',
@@ -95,6 +114,7 @@ export const toolCategories = {
     ],
     card: [
         'sardis_issue_card',
+        'sardis_create_card',
         'sardis_get_card',
         'sardis_list_cards',
         'sardis_freeze_card',
@@ -102,19 +122,57 @@ export const toolCategories = {
         'sardis_cancel_card',
     ],
     fiat: [
+        'sardis_sync_treasury_account_holder',
+        'sardis_list_financial_accounts',
+        'sardis_link_external_bank_account',
+        'sardis_verify_micro_deposits',
         'sardis_fund_wallet',
         'sardis_withdraw_to_bank',
+        'sardis_withdraw',
         'sardis_get_funding_status',
         'sardis_get_withdrawal_status',
+        'sardis_get_treasury_balances',
+        'sardis_list_funding_transactions',
+        'sardis_get_multi_balance',
+        'sardis_offramp_usdc_to_fiat',
+        'sardis_onramp_fiat_to_usdc',
+        'sardis_get_ramp_quote',
     ],
     approval: [
         'sardis_request_approval',
         'sardis_get_approval_status',
+        'sardis_check_approval',
+        'sardis_list_pending_approvals',
+        'sardis_cancel_approval',
+    ],
+    sandbox: ['sardis_sandbox_demo'],
+    group: [
+        'sardis_create_group',
+        'sardis_get_group',
+        'sardis_list_groups',
+        'sardis_add_agent_to_group',
+        'sardis_remove_agent_from_group',
+        'sardis_get_group_spending',
     ],
     spending: [
         'sardis_get_spending_summary',
+        'sardis_get_spending',
         'sardis_get_spending_by_vendor',
         'sardis_get_spending_by_category',
+        'sardis_get_spending_trends',
+    ],
+    event: [
+        'sardis_subscribe_events',
+        'sardis_list_event_types',
+        'sardis_get_event_history',
+        'sardis_configure_webhook',
+    ],
+    guardrails: [
+        'sardis_check_circuit_breaker',
+        'sardis_activate_kill_switch',
+        'sardis_deactivate_kill_switch',
+        'sardis_check_rate_limits',
+        'sardis_get_behavioral_alerts',
     ],
 };
 /**
@@ -130,6 +188,34 @@ export function getToolsByCategory(category) {
 export function getToolCount() {
     return allToolDefinitions.length;
 }
+/**
+ * Validate tool registry consistency between definitions and handlers.
+ *
+ * This is the authoritative source for all "tool count" claims in docs/CLI.
+ */
+export function validateToolRegistry() {
+    const definitionNames = allToolDefinitions.map((d) => d.name);
+    const definitionSet = new Set(definitionNames);
+    const handlerNames = Object.keys(allToolHandlers);
+    const handlerSet = new Set(handlerNames);
+    const duplicateDefinitions = definitionNames.filter((name, idx) => definitionNames.indexOf(name) !== idx);
+    const missingHandlersForDefinitions = definitionNames.filter((name) => !handlerSet.has(name));
+    const missingDefinitionsForHandlers = handlerNames.filter((name) => !definitionSet.has(name));
+    const isValid = duplicateDefinitions.length === 0 &&
+        missingHandlersForDefinitions.length === 0 &&
+        missingDefinitionsForHandlers.length === 0;
+    return {
+        definitionCount: definitionNames.length,
+        handlerCount: handlerNames.length,
+        isValid,
+        missingHandlersForDefinitions,
+        missingDefinitionsForHandlers,
+        duplicateDefinitions,
+    };
+}
+export function getValidatedToolCount() {
+    return validateToolRegistry().definitionCount;
+}
 /**
  * Get tool summary for documentation
  */

package/dist/tools/index.js.map

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