promptspeak-mcp-server 0.1.0

package/dist/tools/ps_state.js

@@ -0,0 +1,286 @@
+/**
+ * ps_state Tool
+ *
+ * Manages and queries agent state, drift metrics,
+ * circuit breaker status, and system health.
+ */
+import { Gatekeeper } from '../gatekeeper/index.js';
+import { driftEngine } from '../drift/index.js'; // Use singleton
+import { operatorConfig } from '../operator/config.js';
+import { recordAudit } from '../operator/index.js';
+const gatekeeper = new Gatekeeper();
+// ============================================================================
+// GET AGENT STATE
+// ============================================================================
+export function ps_state_get(agentId) {
+    const status = driftEngine.getAgentStatus(agentId);
+    const gatekeeperState = gatekeeper.getAgentState(agentId);
+    // Check if agent actually has any operations recorded
+    // getMetrics creates default metrics, so we need to check operationCount
+    const operationCount = status?.operationCount ?? 0;
+    const hasGatekeeperHistory = gatekeeperState !== null;
+    const circuitState = (status?.circuitBreakerState ?? 'closed');
+    // If agent is halted, always return state info even without operation history
+    if (operationCount === 0 && !hasGatekeeperHistory && circuitState === 'closed') {
+        return {
+            agentId,
+            exists: false,
+            health: 'healthy',
+            recommendations: ['Agent not found - may not have performed any operations yet']
+        };
+    }
+    const driftScore = status?.driftScore ?? 0;
+    // circuitState already declared above
+    const successRate = calculateSuccessRate(agentId);
+    // Determine health
+    let health = 'healthy';
+    const recommendations = [];
+    if (circuitState === 'open') {
+        health = 'halted';
+        recommendations.push('Agent halted by circuit breaker - requires manual intervention');
+        recommendations.push('Use ps_state_reset to reset circuit breaker after investigation');
+    }
+    else if (driftScore > 0.7) {
+        health = 'critical';
+        recommendations.push('High drift detected - review recent operations');
+        recommendations.push('Consider recalibrating baseline with ps_state_recalibrate');
+    }
+    else if (driftScore > 0.4 || circuitState === 'half-open') {
+        health = 'warning';
+        recommendations.push('Elevated drift - monitor closely');
+    }
+    else if (successRate < 0.5) {
+        health = 'warning';
+        recommendations.push('Low success rate - review frame constraints');
+    }
+    return {
+        agentId,
+        exists: true,
+        state: {
+            activeFrame: gatekeeperState?.activeFrame ?? null,
+            lastAction: gatekeeperState?.lastAction ?? null,
+            lastActionTime: gatekeeperState?.lastActionTime ?? null,
+            operationCount: status?.operationCount ?? 0,
+            successRate,
+            driftScore,
+            circuitBreakerState: circuitState,
+            delegations: {
+                asParent: gatekeeperState?.delegationsAsParent ?? 0,
+                asChild: gatekeeperState?.delegationsAsChild ?? 0
+            }
+        },
+        health,
+        recommendations
+    };
+}
+// ============================================================================
+// GET SYSTEM STATE
+// ============================================================================
+export function ps_state_system() {
+    const systemStats = driftEngine.getSystemStats();
+    const allAgentIds = driftEngine.getAllAgentIds();
+    // Count agent health states
+    let healthy = 0, warning = 0, critical = 0, halted = 0;
+    let totalDrift = 0;
+    let maxDrift = 0;
+    const activeAlerts = [];
+    let circuitClosed = 0, circuitOpen = 0, circuitHalfOpen = 0;
+    for (const agentId of allAgentIds) {
+        const state = ps_state_get(agentId);
+        switch (state.health) {
+            case 'healthy':
+                healthy++;
+                break;
+            case 'warning':
+                warning++;
+                break;
+            case 'critical':
+                critical++;
+                break;
+            case 'halted':
+                halted++;
+                break;
+        }
+        const status = driftEngine.getAgentStatus(agentId);
+        if (status) {
+            totalDrift += status.driftScore;
+            maxDrift = Math.max(maxDrift, status.driftScore);
+            switch (status.circuitBreakerState) {
+                case 'closed':
+                    circuitClosed++;
+                    break;
+                case 'open':
+                    circuitOpen++;
+                    break;
+                case 'half-open':
+                    circuitHalfOpen++;
+                    break;
+            }
+            // Collect active alerts (all alerts from getAgentAlerts are considered active)
+            const alerts = driftEngine.getAgentAlerts(agentId);
+            activeAlerts.push(...alerts);
+        }
+    }
+    const operationStats = gatekeeper.getOperationStats();
+    return {
+        timestamp: Date.now(),
+        agents: {
+            total: allAgentIds.length,
+            healthy,
+            warning,
+            critical,
+            halted
+        },
+        operations: {
+            total: operationStats.total,
+            successful: operationStats.successful,
+            blocked: operationStats.blocked,
+            failed: operationStats.failed
+        },
+        drift: {
+            alertCount: activeAlerts.length,
+            activeAlerts: activeAlerts.slice(0, 10), // Limit to 10 most recent
+            meanDriftScore: allAgentIds.length > 0 ? totalDrift / allAgentIds.length : 0,
+            maxDriftScore: maxDrift
+        },
+        circuitBreakers: {
+            closed: circuitClosed,
+            open: circuitOpen,
+            halfOpen: circuitHalfOpen
+        },
+        thresholds: operatorConfig.getThresholds()
+    };
+}
+export function ps_state_reset(request) {
+    recordAudit('state_reset', 'operator', {
+        agentId: request.agentId,
+        reason: request.reason,
+        resetCircuitBreaker: request.resetCircuitBreaker,
+        resetDriftMetrics: request.resetDriftMetrics,
+        resetBaseline: request.resetBaseline
+    });
+    const resetDone = {
+        circuitBreaker: false,
+        driftMetrics: false,
+        baseline: false
+    };
+    if (request.resetCircuitBreaker) {
+        driftEngine.resetCircuitBreaker(request.agentId);
+        resetDone.circuitBreaker = true;
+    }
+    if (request.resetDriftMetrics) {
+        driftEngine.resetDriftMetrics(request.agentId);
+        resetDone.driftMetrics = true;
+    }
+    if (request.resetBaseline) {
+        driftEngine.recalibrateAgent(request.agentId);
+        resetDone.baseline = true;
+    }
+    return {
+        success: true,
+        agentId: request.agentId,
+        reset: resetDone,
+        newState: ps_state_get(request.agentId)
+    };
+}
+export function ps_state_recalibrate(request) {
+    const previousStatus = driftEngine.getAgentStatus(request.agentId);
+    const previousDrift = previousStatus?.driftScore ?? 0;
+    if (request.newBaseline) {
+        driftEngine.setBaseline(request.agentId, request.newBaseline.frame, request.newBaseline.expectedBehavior);
+    }
+    else {
+        driftEngine.recalibrateAgent(request.agentId);
+    }
+    const newStatus = driftEngine.getAgentStatus(request.agentId);
+    const newDrift = newStatus?.driftScore ?? 0;
+    recordAudit('state_recalibrate', 'operator', {
+        agentId: request.agentId,
+        previousDrift,
+        newDrift,
+        hasNewBaseline: !!request.newBaseline
+    });
+    return {
+        success: true,
+        agentId: request.agentId,
+        previousDriftScore: previousDrift,
+        newDriftScore: newDrift,
+        message: request.newBaseline
+            ? 'Baseline updated with new configuration'
+            : 'Baseline recalibrated from current state'
+    };
+}
+export function ps_state_halt(request) {
+    recordAudit('state_halt', 'operator', {
+        agentId: request.agentId,
+        reason: request.reason
+    });
+    driftEngine.haltAgent(request.agentId, request.reason);
+    return {
+        success: true,
+        message: `Agent ${request.agentId} halted: ${request.reason}`
+    };
+}
+export function ps_state_resume(request) {
+    const status = driftEngine.getAgentStatus(request.agentId);
+    if (!status || status.circuitBreakerState !== 'open') {
+        return {
+            success: false,
+            message: `Agent ${request.agentId} is not halted`
+        };
+    }
+    recordAudit('state_resume', 'operator', {
+        agentId: request.agentId,
+        reason: request.reason,
+        resetMetrics: request.resetMetrics
+    });
+    if (request.resetMetrics) {
+        driftEngine.resetDriftMetrics(request.agentId);
+    }
+    driftEngine.resumeAgent(request.agentId);
+    return {
+        success: true,
+        message: `Agent ${request.agentId} resumed: ${request.reason}`
+    };
+}
+export function ps_state_drift_history(request) {
+    const history = driftEngine.getDriftHistory(request.agentId, request.since, request.limit ?? 100);
+    // Calculate summary stats
+    const driftScores = history.map(e => e.driftScore);
+    const minDrift = Math.min(...driftScores, 1);
+    const maxDrift = Math.max(...driftScores, 0);
+    const avgDrift = driftScores.length > 0
+        ? driftScores.reduce((a, b) => a + b, 0) / driftScores.length
+        : 0;
+    // Determine trend
+    let trend = 'stable';
+    if (driftScores.length >= 5) {
+        const recentAvg = driftScores.slice(-5).reduce((a, b) => a + b, 0) / 5;
+        const olderAvg = driftScores.slice(0, 5).reduce((a, b) => a + b, 0) / 5;
+        if (recentAvg > olderAvg + 0.1)
+            trend = 'increasing';
+        else if (recentAvg < olderAvg - 0.1)
+            trend = 'decreasing';
+    }
+    return {
+        agentId: request.agentId,
+        entries: history,
+        trend,
+        summary: {
+            minDrift,
+            maxDrift,
+            avgDrift,
+            alertCount: history.filter(e => e.alert).length
+        }
+    };
+}
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+function calculateSuccessRate(agentId) {
+    const stats = gatekeeper.getAgentOperationStats(agentId);
+    if (!stats || stats.total === 0)
+        return 1.0;
+    return stats.successful / stats.total;
+}
+//# sourceMappingURL=ps_state.js.map

package/dist/tools/ps_state.js.map

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

package/dist/tools/ps_validate.d.ts

@@ -0,0 +1,51 @@
+/**
+ * ps_validate Tool
+ *
+ * Validates PromptSpeak frames through three-tier validation:
+ * 1. Structural - syntax and symbol existence
+ * 2. Semantic - mutual exclusions and required companions
+ * 3. Chain - inheritance and constraint preservation
+ */
+import type { ValidationReport, ParsedFrame } from '../types/index.js';
+export interface ValidateRequest {
+    frame: string;
+    parentFrame?: string;
+    validationLevel?: 'structural' | 'semantic' | 'chain' | 'full';
+    strict?: boolean;
+}
+export interface ValidateResult {
+    valid: boolean;
+    frame: string;
+    parsedFrame: ParsedFrame | null;
+    parseConfidence: number;
+    report: ValidationReport;
+    summary: {
+        errors: number;
+        warnings: number;
+        passed: number;
+    };
+    suggestions?: string[];
+}
+export declare function ps_validate(request: ValidateRequest): ValidateResult;
+export interface BatchValidateRequest {
+    frames: Array<{
+        frame: string;
+        parentFrame?: string;
+    }>;
+    validationLevel?: 'structural' | 'semantic' | 'chain' | 'full';
+    strict?: boolean;
+    stopOnFirstError?: boolean;
+}
+export interface BatchValidateResult {
+    allValid: boolean;
+    results: ValidateResult[];
+    summary: {
+        total: number;
+        valid: number;
+        invalid: number;
+        totalErrors: number;
+        totalWarnings: number;
+    };
+}
+export declare function ps_validate_batch(request: BatchValidateRequest): BatchValidateResult;
+//# sourceMappingURL=ps_validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ps_validate.d.ts","sourceRoot":"","sources":["../../src/tools/ps_validate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AASvE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAMD,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CA6FpE;AAwED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,KAAK,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,eAAe,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CAmCpF"}

package/dist/tools/ps_validate.js

@@ -0,0 +1,191 @@
+/**
+ * ps_validate Tool
+ *
+ * Validates PromptSpeak frames through three-tier validation:
+ * 1. Structural - syntax and symbol existence
+ * 2. Semantic - mutual exclusions and required companions
+ * 3. Chain - inheritance and constraint preservation
+ */
+import { DynamicResolver } from '../gatekeeper/resolver.js';
+import { FrameValidator } from '../gatekeeper/validator.js';
+const resolver = new DynamicResolver();
+const validator = new FrameValidator();
+// ============================================================================
+// TOOL IMPLEMENTATION
+// ============================================================================
+export function ps_validate(request) {
+    const { frame, parentFrame, validationLevel = 'full', strict = false } = request;
+    // Step 1: Parse the frame
+    const parsed = resolver.parseFrame(frame);
+    if (!parsed) {
+        return {
+            valid: false,
+            frame,
+            parsedFrame: null,
+            parseConfidence: 0,
+            report: {
+                valid: false,
+                errors: [{
+                        code: 'PARSE_FAILED',
+                        message: 'Failed to parse frame - contains unknown symbols',
+                        severity: 'error',
+                        symbol: frame
+                    }],
+                warnings: [],
+                metadata: {
+                    validatedAt: Date.now(),
+                    validationLevel: 'structural'
+                }
+            },
+            summary: { errors: 1, warnings: 0, passed: 0 },
+            suggestions: generateSuggestions(frame)
+        };
+    }
+    // Step 2: Resolve with current overlay
+    const resolved = resolver.resolveFrame(parsed);
+    // Step 3: Parse parent frame if provided
+    let parsedParent;
+    if (parentFrame) {
+        parsedParent = resolver.parseFrame(parentFrame) ?? undefined;
+    }
+    // Step 4: Run validation at requested level
+    let report;
+    switch (validationLevel) {
+        case 'structural':
+            report = validator.validateStructural(parsed);
+            break;
+        case 'semantic':
+            report = validator.validateSemantic(parsed);
+            break;
+        case 'chain':
+            if (!parsedParent) {
+                report = {
+                    valid: false,
+                    errors: [{
+                            code: 'CHAIN_NO_PARENT',
+                            message: 'Chain validation requires parentFrame',
+                            severity: 'error'
+                        }],
+                    warnings: [],
+                    metadata: { validatedAt: Date.now(), validationLevel: 'chain' }
+                };
+            }
+            else {
+                report = validator.validateChain(parsed, parsedParent);
+            }
+            break;
+        case 'full':
+        default:
+            report = validator.validate(parsed, parsedParent);
+    }
+    // Step 5: Calculate summary
+    const summary = {
+        errors: (report.errors ?? []).length,
+        warnings: (report.warnings ?? []).length,
+        passed: countPassedRules(report)
+    };
+    // Step 6: Determine validity
+    // In strict mode, warnings also cause failure
+    const valid = strict
+        ? report.valid && (report.warnings ?? []).length === 0
+        : report.valid;
+    return {
+        valid,
+        frame,
+        parsedFrame: parsed,
+        parseConfidence: resolved.parseConfidence ?? 1.0,
+        report,
+        summary,
+        suggestions: valid ? undefined : generateSuggestions(frame, report)
+    };
+}
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+function countPassedRules(report) {
+    // Total rules checked minus errors and warnings
+    const totalStructural = 6; // SR-001 to SR-006
+    const totalSemantic = 5; // SM-001 to SM-005
+    const totalChain = 6; // CH-001 to CH-006
+    const totalRules = totalStructural + totalSemantic + totalChain;
+    return Math.max(0, totalRules - (report.errors ?? []).length - (report.warnings ?? []).length);
+}
+function generateSuggestions(frame, report) {
+    const suggestions = [];
+    if (!report) {
+        // Parse failed - suggest valid symbols
+        suggestions.push('Check that all symbols exist in the ontology');
+        suggestions.push('Valid modes: ⊕ (strict), ⊖ (flexible), ⊗ (forbidden), ⊘ (neutral)');
+        suggestions.push('Valid domains: ◊ (financial), ◈ (legal), ◇ (technical), ◆ (medical), ◐ (general)');
+        suggestions.push('Valid actions: ▶ (execute), ◀ (rollback), ▲ (escalate), ▼ (delegate), ● (commit), ○ (create)');
+        return suggestions;
+    }
+    for (const error of (report.errors ?? [])) {
+        switch (error.code) {
+            case 'MODE_CONFLICT_STRICT_FLEXIBLE':
+                suggestions.push('Remove either ⊕ (strict) or ⊖ (flexible) - cannot have both');
+                break;
+            case 'MODE_CONFLICT_STRICT_EXPLORATORY':
+                suggestions.push('Remove either ⊕ (strict) or ⊗ (exploratory) - cannot have both');
+                break;
+            case 'PRIORITY_CONFLICT':
+                suggestions.push('Remove either ↑ (high priority) or ↓ (low priority) - cannot have both');
+                break;
+            case 'SEQUENCE_MODE_NOT_FIRST':
+                suggestions.push('Move mode symbol (⊕/⊖/⊗/⊘) to the beginning of the frame');
+                break;
+            case 'SEQUENCE_ACTION_BEFORE_DOMAIN':
+                suggestions.push('Move domain symbol (◊/◈/◇/◆/◐) before the action symbol');
+                break;
+            case 'MODE_STRENGTH_WEAKENED':
+                suggestions.push('Child frame cannot use a weaker mode than parent. Strength order: ⊕ > ⊘ > ⊖ > ⊗');
+                break;
+            case 'FORBIDDEN_NOT_INHERITED':
+                suggestions.push('Parent has ⛔ constraint which must be inherited by child');
+                break;
+        }
+    }
+    for (const warning of (report.warnings ?? [])) {
+        switch (warning.code) {
+            case 'ACTION_MISSING_DOMAIN':
+                suggestions.push('Consider adding a domain symbol (◊/◈/◇/◆/◐) before the action');
+                break;
+            case 'ITERATIVE_NO_TERMINATION':
+                suggestions.push('⟳ (iterative) requires termination_condition in metadata');
+                break;
+        }
+    }
+    return suggestions;
+}
+export function ps_validate_batch(request) {
+    const results = [];
+    let totalErrors = 0;
+    let totalWarnings = 0;
+    for (const item of request.frames) {
+        const result = ps_validate({
+            frame: item.frame,
+            parentFrame: item.parentFrame,
+            validationLevel: request.validationLevel,
+            strict: request.strict
+        });
+        results.push(result);
+        totalErrors += result.summary.errors;
+        totalWarnings += result.summary.warnings;
+        if (request.stopOnFirstError && !result.valid) {
+            break;
+        }
+    }
+    const validCount = results.filter(r => r.valid).length;
+    return {
+        allValid: validCount === results.length,
+        results,
+        summary: {
+            total: results.length,
+            valid: validCount,
+            invalid: results.length - validCount,
+            totalErrors,
+            totalWarnings
+        }
+    };
+}
+//# sourceMappingURL=ps_validate.js.map

package/dist/tools/ps_validate.js.map

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

package/dist/tools/registry.d.ts

@@ -0,0 +1,52 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * MCP TOOL REGISTRY
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * Central registry for all MCP tool definitions.
+ * Separates tool metadata from routing logic for maintainability.
+ *
+ * Tool categories:
+ * - VALIDATION_TOOLS: Frame validation (ps_validate, ps_validate_batch)
+ * - EXECUTION_TOOLS: Governed execution (ps_execute, ps_execute_dry_run)
+ * - DELEGATION_TOOLS: Task delegation (ps_delegate, ps_delegate_*)
+ * - STATE_TOOLS: Agent state management (ps_state_*)
+ * - CONFIG_TOOLS: Operator configuration (ps_config_*)
+ * - CONFIDENCE_TOOLS: Confidence thresholds (ps_confidence_*)
+ * - FEATURE_TOOLS: Feature flags (ps_feature_*)
+ * - AUDIT_TOOLS: Audit logging (ps_audit_*)
+ *
+ * External tool definitions are imported from their respective modules.
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { holdToolDefinitions } from './ps_hold.js';
+import { legalToolDefinitions } from './ps_legal.js';
+import { calendarToolDefinitions } from './ps_calendar.js';
+import { symbolToolDefinitions } from '../symbols/index.js';
+import { translationToolDefinitions } from '../translation/index.js';
+import { multiAgentToolDefinitions } from '../multi_agent/index.js';
+import { swarmToolDefinitions, intelligenceToolDefinitions } from '../swarm/index.js';
+import { reconToolDefinitions } from '../handlers/recon-tools.js';
+export declare const VALIDATION_TOOLS: Tool[];
+export declare const EXECUTION_TOOLS: Tool[];
+export declare const DELEGATION_TOOLS: Tool[];
+export declare const STATE_TOOLS: Tool[];
+export declare const CONFIG_TOOLS: Tool[];
+export declare const CONFIDENCE_TOOLS: Tool[];
+export declare const FEATURE_TOOLS: Tool[];
+export declare const AUDIT_TOOLS: Tool[];
+export { holdToolDefinitions, legalToolDefinitions, calendarToolDefinitions, symbolToolDefinitions, translationToolDefinitions, multiAgentToolDefinitions, swarmToolDefinitions, intelligenceToolDefinitions, reconToolDefinitions, };
+/**
+ * Build the complete tool registry.
+ * Groups tools by category for organization and returns a flat array.
+ *
+ * @returns Complete array of all MCP tool definitions
+ */
+export declare function buildToolRegistry(): Tool[];
+/**
+ * Get tool count by category for diagnostics.
+ * Category names match those in handlers/tool-registry.ts for consistency.
+ */
+export declare function getToolStats(): Record<string, number>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAMlE,eAAO,MAAM,gBAAgB,EAAE,IAAI,EA2ClC,CAAC;AAMF,eAAO,MAAM,eAAe,EAAE,IAAI,EA4CjC,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,IAAI,EAkDlC,CAAC;AAMF,eAAO,MAAM,WAAW,EAAE,IAAI,EAyE7B,CAAC;AAMF,eAAO,MAAM,YAAY,EAAE,IAAI,EAoD9B,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,IAAI,EAmClC,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,IAAI,EAqB/B,CAAC;AAMF,eAAO,MAAM,WAAW,EAAE,IAAI,EAa7B,CAAC;AAMF,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,oBAAoB,EACpB,2BAA2B,EAC3B,oBAAoB,GACrB,CAAC;AAMF;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,EAAE,CAuB1C;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqBrD"}