@monoes/monomindcli 2.7.5 → 2.7.6

package/dist/src/mcp-tools/coordination-tools.js

@@ -1,758 +0,0 @@
-import { getProjectCwd } from './types.js';
-import { existsSync, readFileSync, statSync, writeFileSync, renameSync, mkdirSync } from 'node:fs';
-import { join } from 'node:path';
-// Storage paths
-const STORAGE_DIR = '.monomind';
-const COORD_DIR = 'coordination';
-const COORD_FILE = 'store.json';
-function getCoordDir() {
-    return join(getProjectCwd(), STORAGE_DIR, COORD_DIR);
-}
-function getCoordPath() {
-    return join(getCoordDir(), COORD_FILE);
-}
-function ensureCoordDir() {
-    const dir = getCoordDir();
-    if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true });
-    }
-}
-const MAX_COORD_STORE_BYTES = 10 * 1024 * 1024; // 10 MB
-function loadCoordStore() {
-    try {
-        const path = getCoordPath();
-        if (existsSync(path) && statSync(path).size <= MAX_COORD_STORE_BYTES) {
-            return JSON.parse(readFileSync(path, 'utf-8'));
-        }
-    }
-    catch {
-        // Return default store
-    }
-    return {
-        topology: {
-            type: 'hierarchical',
-            maxNodes: 15,
-            redundancy: 2,
-            consensusAlgorithm: 'raft',
-        },
-        loadBalance: {
-            algorithm: 'adaptive',
-            weights: {},
-            healthCheck: true,
-        },
-        sync: {
-            lastSync: new Date().toISOString(),
-            syncCount: 0,
-            conflicts: 0,
-            pendingChanges: 0,
-        },
-        nodes: {},
-        version: '3.0.0',
-    };
-}
-function saveCoordStore(store) {
-    ensureCoordDir();
-    const dest = getCoordPath();
-    const tmp = dest + '.tmp';
-    writeFileSync(tmp, JSON.stringify(store, null, 2), 'utf-8');
-    renameSync(tmp, dest);
-}
-export const coordinationTools = [
-    {
-        name: 'coordination_topology',
-        description: 'Configure swarm topology',
-        category: 'coordination',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                action: { type: 'string', enum: ['get', 'set', 'optimize'], description: 'Action to perform' },
-                type: { type: 'string', enum: ['mesh', 'hierarchical', 'ring', 'star', 'hybrid', 'hierarchical-mesh'], description: 'Topology type' },
-                maxNodes: { type: 'number', description: 'Maximum nodes' },
-                redundancy: { type: 'number', description: 'Redundancy level' },
-                consensusAlgorithm: { type: 'string', enum: ['raft', 'byzantine', 'gossip', 'crdt'], description: 'Consensus algorithm' },
-            },
-        },
-        handler: async (input) => {
-            const args = input;
-            const store = loadCoordStore();
-            const action = args.action || 'get';
-            if (action === 'get') {
-                return {
-                    success: true,
-                    topology: store.topology,
-                    nodes: Object.keys(store.nodes).length,
-                    status: 'active',
-                };
-            }
-            if (action === 'set') {
-                if (args.type)
-                    store.topology.type = args.type;
-                if (args.maxNodes)
-                    store.topology.maxNodes = args.maxNodes;
-                if (args.redundancy)
-                    store.topology.redundancy = args.redundancy;
-                if (args.consensusAlgorithm)
-                    store.topology.consensusAlgorithm = args.consensusAlgorithm;
-                saveCoordStore(store);
-                return {
-                    success: true,
-                    action: 'updated',
-                    topology: store.topology,
-                };
-            }
-            if (action === 'optimize') {
-                // Analyze current state and suggest optimal topology
-                const nodeCount = Object.keys(store.nodes).length;
-                let recommended = 'hierarchical';
-                if (nodeCount <= 5) {
-                    recommended = 'mesh';
-                }
-                else if (nodeCount <= 15) {
-                    recommended = 'hierarchical';
-                }
-                else {
-                    recommended = 'hybrid';
-                }
-                return {
-                    success: true,
-                    action: 'optimize',
-                    current: store.topology.type,
-                    recommended,
-                    reason: nodeCount <= 5
-                        ? 'Small cluster benefits from full mesh connectivity'
-                        : nodeCount <= 15
-                            ? 'Medium cluster works well with hierarchical coordination'
-                            : 'Large cluster needs hybrid approach for scalability',
-                };
-            }
-            return { success: false, error: 'Unknown action' };
-        },
-    },
-    {
-        name: 'coordination_load_balance',
-        description: 'Configure load balancing',
-        category: 'coordination',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                action: { type: 'string', enum: ['get', 'set', 'distribute'], description: 'Action to perform' },
-                algorithm: { type: 'string', enum: ['round-robin', 'least-connections', 'weighted', 'adaptive'], description: 'Algorithm' },
-                weights: { type: 'object', description: 'Node weights' },
-                task: { type: 'string', description: 'Task to distribute' },
-            },
-        },
-        handler: async (input) => {
-            const args = input;
-            const store = loadCoordStore();
-            const action = args.action || 'get';
-            if (action === 'get') {
-                const nodes = Object.values(store.nodes);
-                const avgLoad = nodes.length > 0
-                    ? nodes.reduce((sum, n) => sum + n.load, 0) / nodes.length
-                    : 0;
-                return {
-                    success: true,
-                    loadBalance: store.loadBalance,
-                    metrics: {
-                        nodeCount: nodes.length,
-                        avgLoad,
-                        maxLoad: nodes.length > 0 ? Math.max(...nodes.map(n => n.load)) : 0,
-                        minLoad: nodes.length > 0 ? Math.min(...nodes.map(n => n.load)) : 0,
-                    },
-                };
-            }
-            if (action === 'set') {
-                if (args.algorithm)
-                    store.loadBalance.algorithm = args.algorithm;
-                if (args.weights)
-                    store.loadBalance.weights = args.weights;
-                saveCoordStore(store);
-                return {
-                    success: true,
-                    action: 'updated',
-                    loadBalance: store.loadBalance,
-                };
-            }
-            if (action === 'distribute') {
-                const task = args.task;
-                const nodes = Object.values(store.nodes).filter(n => n.status === 'active');
-                if (nodes.length === 0) {
-                    return { success: false, error: 'No active nodes available' };
-                }
-                // Select node based on algorithm
-                let selectedNode;
-                const algorithm = store.loadBalance.algorithm;
-                if (algorithm === 'least-connections' || algorithm === 'adaptive') {
-                    selectedNode = nodes.reduce((min, n) => n.load < min.load ? n : min);
-                }
-                else if (algorithm === 'weighted') {
-                    const weights = store.loadBalance.weights;
-                    selectedNode = nodes.reduce((max, n) => (weights[n.id] || 1) > (weights[max.id] || 1) ? n : max);
-                }
-                else {
-                    // Round robin - just pick first active
-                    selectedNode = nodes[0];
-                }
-                // Update load
-                selectedNode.load += 1;
-                saveCoordStore(store);
-                return {
-                    success: true,
-                    action: 'distributed',
-                    task,
-                    assignedTo: selectedNode.id,
-                    algorithm,
-                    nodeLoad: selectedNode.load,
-                };
-            }
-            return { success: false, error: 'Unknown action' };
-        },
-    },
-    {
-        name: 'coordination_sync',
-        description: 'Synchronize state across nodes',
-        category: 'coordination',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                action: { type: 'string', enum: ['status', 'trigger', 'resolve'], description: 'Action to perform' },
-                force: { type: 'boolean', description: 'Force synchronization' },
-                conflictResolution: { type: 'string', enum: ['latest', 'merge', 'manual'], description: 'Conflict resolution strategy' },
-            },
-        },
-        handler: async (input) => {
-            const args = input;
-            const store = loadCoordStore();
-            const action = args.action || 'status';
-            if (action === 'status') {
-                const timeSinceSync = Date.now() - new Date(store.sync.lastSync).getTime();
-                return {
-                    success: true,
-                    sync: store.sync,
-                    timeSinceSync: `${Math.floor(timeSinceSync / 1000)}s`,
-                    status: store.sync.conflicts > 0 ? 'conflicts' : store.sync.pendingChanges > 0 ? 'pending' : 'synced',
-                };
-            }
-            if (action === 'trigger') {
-                store.sync.syncCount++;
-                store.sync.lastSync = new Date().toISOString();
-                store.sync.pendingChanges = 0;
-                // Simulate sync
-                await new Promise(resolve => setTimeout(resolve, 50));
-                saveCoordStore(store);
-                return {
-                    success: true,
-                    action: 'synchronized',
-                    syncCount: store.sync.syncCount,
-                    syncedAt: store.sync.lastSync,
-                    nodesSync: Object.keys(store.nodes).length,
-                };
-            }
-            if (action === 'resolve') {
-                const strategy = args.conflictResolution || 'latest';
-                if (store.sync.conflicts > 0) {
-                    const resolved = store.sync.conflicts;
-                    store.sync.conflicts = 0;
-                    saveCoordStore(store);
-                    return {
-                        success: true,
-                        action: 'resolved',
-                        strategy,
-                        conflictsResolved: resolved,
-                    };
-                }
-                return {
-                    success: true,
-                    action: 'resolve',
-                    message: 'No conflicts to resolve',
-                };
-            }
-            return { success: false, error: 'Unknown action' };
-        },
-    },
-    {
-        name: 'coordination_node',
-        description: 'Manage coordination nodes',
-        category: 'coordination',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                action: { type: 'string', enum: ['list', 'add', 'remove', 'heartbeat'], description: 'Action to perform' },
-                nodeId: { type: 'string', description: 'Node ID' },
-                status: { type: 'string', description: 'Node status' },
-            },
-        },
-        handler: async (input) => {
-            const args = input;
-            const store = loadCoordStore();
-            const action = args.action || 'list';
-            if (action === 'list') {
-                const nodes = Object.values(store.nodes);
-                return {
-                    success: true,
-                    nodes: nodes.map(n => ({
-                        id: n.id,
-                        status: n.status,
-                        load: n.load,
-                        lastHeartbeat: n.lastHeartbeat,
-                    })),
-                    total: nodes.length,
-                    active: nodes.filter(n => n.status === 'active').length,
-                };
-            }
-            const FORBIDDEN_NODE_IDS = new Set(['__proto__', 'constructor', 'prototype']);
-            const MAX_NODES = 1000;
-            const MAX_NODE_ID_LEN = 200;
-            if (action === 'add') {
-                const nodeId = args.nodeId || `node-${Date.now()}`;
-                if (typeof nodeId !== 'string' || nodeId.length === 0 || nodeId.length > MAX_NODE_ID_LEN) {
-                    return { success: false, error: 'Invalid nodeId' };
-                }
-                if (FORBIDDEN_NODE_IDS.has(nodeId)) {
-                    return { success: false, error: 'Forbidden node ID' };
-                }
-                // Cap to prevent unbounded growth → disk exhaustion DoS via repeated
-                // add calls. Allow re-add of existing node (no growth in that case).
-                if (Object.keys(store.nodes).length >= MAX_NODES && !Object.hasOwn(store.nodes, nodeId)) {
-                    return { success: false, error: `Node limit reached (${MAX_NODES})` };
-                }
-                store.nodes[nodeId] = {
-                    id: nodeId,
-                    status: 'active',
-                    load: 0,
-                    lastHeartbeat: new Date().toISOString(),
-                };
-                saveCoordStore(store);
-                return {
-                    success: true,
-                    action: 'added',
-                    nodeId,
-                    totalNodes: Object.keys(store.nodes).length,
-                };
-            }
-            if (action === 'remove') {
-                const nodeId = args.nodeId;
-                // Match the `add` denylist + Object.hasOwn so a tampered store.json
-                // can't have its inherited Object.prototype slots exposed via remove.
-                if (typeof nodeId !== 'string' || nodeId.length === 0 || nodeId.length > MAX_NODE_ID_LEN ||
-                    FORBIDDEN_NODE_IDS.has(nodeId)) {
-                    return { success: false, error: 'Invalid nodeId' };
-                }
-                if (!Object.hasOwn(store.nodes, nodeId)) {
-                    return { success: false, error: 'Node not found' };
-                }
-                delete store.nodes[nodeId];
-                saveCoordStore(store);
-                return {
-                    success: true,
-                    action: 'removed',
-                    nodeId,
-                    totalNodes: Object.keys(store.nodes).length,
-                };
-            }
-            if (action === 'heartbeat') {
-                const nodeId = args.nodeId;
-                if (!nodeId || typeof nodeId !== 'string' || ['__proto__', 'constructor', 'prototype'].includes(nodeId)) {
-                    return {
-                        success: false,
-                        action: 'heartbeat',
-                        nodeId,
-                        error: 'Invalid node ID',
-                    };
-                }
-                if (Object.hasOwn(store.nodes, nodeId)) {
-                    store.nodes[nodeId].lastHeartbeat = new Date().toISOString();
-                    store.nodes[nodeId].status = 'active';
-                    saveCoordStore(store);
-                }
-                return {
-                    success: true,
-                    action: 'heartbeat',
-                    nodeId,
-                    timestamp: new Date().toISOString(),
-                };
-            }
-            return { success: false, error: 'Unknown action' };
-        },
-    },
-    {
-        name: 'coordination_consensus',
-        description: 'Manage consensus protocol with BFT, Raft, or Quorum strategies',
-        category: 'coordination',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                action: { type: 'string', enum: ['status', 'propose', 'vote', 'commit'], description: 'Action to perform' },
-                proposal: { type: 'object', description: 'Proposal data (for propose)' },
-                proposalId: { type: 'string', description: 'Proposal ID (for vote/commit/status)' },
-                vote: { type: 'string', enum: ['accept', 'reject'], description: 'Vote' },
-                voterId: { type: 'string', description: 'Voter node ID' },
-                strategy: { type: 'string', enum: ['bft', 'raft', 'quorum'], description: 'Consensus strategy (default: raft)' },
-                quorumPreset: { type: 'string', enum: ['unanimous', 'majority', 'supermajority'], description: 'Quorum threshold preset (default: majority)' },
-                term: { type: 'number', description: 'Term number (for raft strategy)' },
-            },
-        },
-        handler: async (input) => {
-            const args = input;
-            const store = loadCoordStore();
-            const action = args.action || 'status';
-            const strategy = args.strategy || 'raft';
-            const nodeCount = Object.keys(store.nodes).length || 1;
-            // Initialize consensus storage in the coordination store if missing
-            if (!store.consensus) {
-                store.consensus = { pending: [], history: [] };
-            }
-            const consensus = store.consensus;
-            function calcRequired(strat, total, preset) {
-                if (total <= 0)
-                    return 1;
-                if (strat === 'bft')
-                    return Math.floor((total * 2) / 3) + 1;
-                if (strat === 'quorum') {
-                    if (preset === 'unanimous')
-                        return total;
-                    if (preset === 'supermajority')
-                        return Math.floor((total * 2) / 3) + 1;
-                }
-                return Math.floor(total / 2) + 1;
-            }
-            if (action === 'status') {
-                if (args.proposalId) {
-                    // Validate proposalId length before O(n) .find() scan.
-                    if (typeof args.proposalId !== 'string' || args.proposalId.length > 256) {
-                        return { success: false, error: 'proposalId must be a string (max 256 chars)' };
-                    }
-                    // Status for specific proposal
-                    const p = consensus.pending.find(x => x.proposalId === args.proposalId);
-                    if (p) {
-                        const votesFor = Object.values(p.votes).filter(v => v).length;
-                        const votesAgainst = Object.values(p.votes).filter(v => !v).length;
-                        return {
-                            success: true,
-                            proposalId: p.proposalId,
-                            strategy: p.strategy,
-                            status: p.status,
-                            votesFor,
-                            votesAgainst,
-                            required: calcRequired(p.strategy, nodeCount, p.quorumPreset),
-                            totalNodes: nodeCount,
-                            resolved: false,
-                        };
-                    }
-                    const h = consensus.history.find(x => x.proposalId === args.proposalId);
-                    if (h)
-                        return { success: true, ...h, resolved: true, historical: true };
-                    return { success: false, error: 'Proposal not found' };
-                }
-                const quorum = calcRequired(strategy, nodeCount);
-                return {
-                    success: true,
-                    algorithm: store.topology.consensusAlgorithm,
-                    strategy,
-                    nodes: nodeCount,
-                    quorum,
-                    pendingProposals: consensus.pending.length,
-                    resolvedProposals: consensus.history.length,
-                    status: nodeCount >= quorum ? 'operational' : 'degraded',
-                };
-            }
-            if (action === 'propose') {
-                const proposalId = `proposal-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-                const quorumPreset = args.quorumPreset || 'majority';
-                const term = args.term || 1;
-                const required = calcRequired(strategy, nodeCount, quorumPreset);
-                // Raft: one pending proposal per term
-                if (strategy === 'raft') {
-                    const existing = consensus.pending.find(p => p.strategy === 'raft' && p.term === term);
-                    if (existing) {
-                        return {
-                            success: false,
-                            error: `Raft term ${term} already has pending proposal: ${existing.proposalId}`,
-                            existingProposalId: existing.proposalId,
-                        };
-                    }
-                }
-                if (consensus.pending.length >= 200) {
-                    return { success: false, error: 'Pending proposals limit (200) reached. Resolve existing proposals first.' };
-                }
-                // Validate proposal size and shape — schema only declares object,
-                // so without these checks an attacker could submit a 10MB blob 200x
-                // and inflate store.json to 2GB on every saveCoordStore.
-                if (args.proposal === null || typeof args.proposal !== 'object' || Array.isArray(args.proposal)) {
-                    return { success: false, error: 'proposal must be a plain object' };
-                }
-                let proposalSerialized;
-                try {
-                    proposalSerialized = JSON.stringify(args.proposal);
-                }
-                catch {
-                    return { success: false, error: 'proposal contains non-serializable values' };
-                }
-                if (proposalSerialized.length > 64 * 1024) {
-                    return { success: false, error: 'proposal exceeds 64KB limit' };
-                }
-                consensus.pending.push({
-                    proposalId,
-                    type: 'coordination',
-                    proposal: args.proposal,
-                    proposedBy: args.voterId || 'system',
-                    proposedAt: new Date().toISOString(),
-                    votes: {},
-                    status: 'pending',
-                    strategy,
-                    term: strategy === 'raft' ? term : undefined,
-                    quorumPreset: strategy === 'quorum' ? quorumPreset : undefined,
-                    byzantineVoters: strategy === 'bft' ? [] : undefined,
-                });
-                saveCoordStore(store);
-                return {
-                    success: true,
-                    action: 'proposed',
-                    proposalId,
-                    proposal: args.proposal,
-                    strategy,
-                    status: 'pending',
-                    required,
-                    totalNodes: nodeCount,
-                    term: strategy === 'raft' ? term : undefined,
-                };
-            }
-            if (action === 'vote') {
-                // Validate proposalId before using it in .find() to prevent DoS via
-                // oversized string comparisons across all pending proposals.
-                const rawProposalIdVote = args.proposalId;
-                if (typeof rawProposalIdVote !== 'string' || rawProposalIdVote.length === 0 || rawProposalIdVote.length > 256) {
-                    return { success: false, error: 'proposalId must be a non-empty string (max 256 chars)' };
-                }
-                const p = consensus.pending.find(x => x.proposalId === rawProposalIdVote);
-                if (!p)
-                    return { success: false, error: 'Proposal not found or already resolved' };
-                const rawVoterId = args.voterId;
-                // Validate voterId — it becomes a key in p.votes (a plain object).
-                // Without these checks an attacker can supply "__proto__", "constructor",
-                // or "prototype" to corrupt the object's inherited properties, or supply
-                // a very long string to cause O(n) comparisons, or flood the votes dict
-                // with thousands of unique IDs to inflate store.json indefinitely.
-                const FORBIDDEN_VOTER_IDS = new Set(['__proto__', 'constructor', 'prototype']);
-                const MAX_VOTER_ID_LEN = 256;
-                const MAX_VOTERS_PER_PROPOSAL = 10_000;
-                if (!rawVoterId || typeof rawVoterId !== 'string' || rawVoterId.length > MAX_VOTER_ID_LEN) {
-                    return { success: false, error: `voterId must be a non-empty string (max ${MAX_VOTER_ID_LEN} chars)` };
-                }
-                if (FORBIDDEN_VOTER_IDS.has(rawVoterId)) {
-                    return { success: false, error: 'Forbidden voterId' };
-                }
-                if (!Object.hasOwn(p.votes, rawVoterId) && Object.keys(p.votes).length >= MAX_VOTERS_PER_PROPOSAL) {
-                    return { success: false, error: `Voter limit per proposal (${MAX_VOTERS_PER_PROPOSAL}) reached` };
-                }
-                const voterId = rawVoterId;
-                if (!voterId)
-                    return { success: false, error: 'voterId is required' };
-                const voteValue = args.vote === 'accept';
-                const pStrategy = p.strategy || 'raft';
-                const required = calcRequired(pStrategy, nodeCount, p.quorumPreset);
-                // Double-vote prevention
-                if (voterId in p.votes) {
-                    if (pStrategy === 'bft' && p.votes[voterId] !== voteValue) {
-                        if (!p.byzantineVoters)
-                            p.byzantineVoters = [];
-                        if (!p.byzantineVoters.includes(voterId))
-                            p.byzantineVoters.push(voterId);
-                        delete p.votes[voterId];
-                        saveCoordStore(store);
-                        return {
-                            success: false,
-                            byzantineDetected: true,
-                            message: `Byzantine behavior: voter ${voterId} attempted conflicting vote. Vote invalidated.`,
-                            byzantineVoters: p.byzantineVoters,
-                        };
-                    }
-                    return { success: false, error: `Voter ${voterId} has already voted on this proposal` };
-                }
-                // BFT cross-proposal conflict check
-                if (pStrategy === 'bft') {
-                    for (const other of consensus.pending) {
-                        if (other.proposalId === p.proposalId)
-                            continue;
-                        if (voterId in other.votes && other.votes[voterId] !== voteValue) {
-                            if (!p.byzantineVoters)
-                                p.byzantineVoters = [];
-                            if (!p.byzantineVoters.includes(voterId))
-                                p.byzantineVoters.push(voterId);
-                            saveCoordStore(store);
-                            return {
-                                success: false,
-                                byzantineDetected: true,
-                                message: `Byzantine behavior: voter ${voterId} cast conflicting votes across proposals.`,
-                                byzantineVoters: p.byzantineVoters,
-                            };
-                        }
-                    }
-                }
-                p.votes[voterId] = voteValue;
-                const votesFor = Object.values(p.votes).filter(v => v).length;
-                const votesAgainst = Object.values(p.votes).filter(v => !v).length;
-                // Resolution check
-                let resolved = false;
-                let result;
-                if (votesFor >= required) {
-                    resolved = true;
-                    result = 'approved';
-                }
-                else if (votesAgainst >= required) {
-                    resolved = true;
-                    result = 'rejected';
-                }
-                else if (pStrategy === 'quorum' && p.quorumPreset === 'unanimous' && votesAgainst > 0) {
-                    resolved = true;
-                    result = 'rejected';
-                }
-                if (resolved && result) {
-                    p.status = result;
-                    consensus.history.push({
-                        proposalId: p.proposalId,
-                        result,
-                        votes: { for: votesFor, against: votesAgainst },
-                        decidedAt: new Date().toISOString(),
-                        strategy: pStrategy,
-                        term: p.term,
-                        byzantineDetected: p.byzantineVoters?.length ? p.byzantineVoters : undefined,
-                    });
-                    // Cap consensus history to prevent unbounded growth
-                    const MAX_CONSENSUS_HISTORY = 1000;
-                    if (consensus.history.length > MAX_CONSENSUS_HISTORY) {
-                        consensus.history = consensus.history.slice(-MAX_CONSENSUS_HISTORY);
-                    }
-                    consensus.pending = consensus.pending.filter(x => x.proposalId !== p.proposalId);
-                }
-                saveCoordStore(store);
-                return {
-                    success: true,
-                    action: 'voted',
-                    proposalId: p.proposalId,
-                    voterId,
-                    vote: args.vote,
-                    strategy: pStrategy,
-                    votesFor,
-                    votesAgainst,
-                    required,
-                    totalNodes: nodeCount,
-                    resolved,
-                    result: resolved ? result : undefined,
-                    status: p.status,
-                };
-            }
-            if (action === 'commit') {
-                // Commit is a no-op confirmation for already-resolved proposals
-                if (args.proposalId) {
-                    // Validate proposalId length before O(n) .find() scan.
-                    if (typeof args.proposalId !== 'string' || args.proposalId.length > 256) {
-                        return { success: false, error: 'proposalId must be a string (max 256 chars)' };
-                    }
-                    const h = consensus.history.find(x => x.proposalId === args.proposalId);
-                    if (h) {
-                        return {
-                            success: true,
-                            action: 'committed',
-                            proposalId: args.proposalId,
-                            result: h.result,
-                            committedAt: new Date().toISOString(),
-                        };
-                    }
-                    return { success: false, error: 'Proposal not found in resolved history. Vote must reach quorum first.' };
-                }
-                return { success: false, error: 'proposalId is required for commit' };
-            }
-            return { success: false, error: 'Unknown action' };
-        },
-    },
-    {
-        name: 'coordination_orchestrate',
-        description: 'Orchestrate multi-agent coordination',
-        category: 'coordination',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                task: { type: 'string', description: 'Task to orchestrate' },
-                agents: { type: 'array', items: { type: 'string' }, description: 'Agent IDs to coordinate' },
-                strategy: { type: 'string', enum: ['parallel', 'sequential', 'pipeline', 'broadcast'], description: 'Orchestration strategy' },
-                timeout: { type: 'number', description: 'Timeout in ms' },
-            },
-            required: ['task'],
-        },
-        handler: async (input) => {
-            const args = input;
-            const store = loadCoordStore();
-            const task = args.task;
-            const agents = args.agents || Object.keys(store.nodes);
-            const strategy = args.strategy || 'parallel';
-            const orchestrationId = `orch-${Date.now()}`;
-            return {
-                success: true,
-                orchestrationId,
-                task,
-                strategy,
-                agents,
-                status: 'initiated',
-                topology: store.topology.type,
-                estimatedCompletion: `${agents.length * (strategy === 'sequential' ? 100 : 50)}ms`,
-            };
-        },
-    },
-    {
-        name: 'coordination_metrics',
-        description: 'Get coordination metrics',
-        category: 'coordination',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                metric: { type: 'string', enum: ['all', 'latency', 'throughput', 'availability'], description: 'Metric type' },
-                timeRange: { type: 'string', description: 'Time range' },
-            },
-        },
-        handler: async (input) => {
-            const args = input;
-            const store = loadCoordStore();
-            const metric = args.metric || 'all';
-            const nodes = Object.values(store.nodes);
-            const activeNodes = nodes.filter(n => n.status === 'active');
-            const metrics = {
-                latency: {
-                    avg: null,
-                    p50: null,
-                    p95: null,
-                    p99: null,
-                    unit: 'ms',
-                    _note: 'Real-time latency metrics not available — coordination is state-tracking only',
-                },
-                throughput: {
-                    current: null,
-                    peak: null,
-                    avg: null,
-                    unit: 'ops/s',
-                    _note: 'Real-time throughput metrics not available — coordination is state-tracking only',
-                },
-                availability: {
-                    uptime: null,
-                    _note: 'Uptime not tracked — coordination store has no persistent start time',
-                    activeNodes: activeNodes.length,
-                    totalNodes: nodes.length,
-                    syncCount: store.sync.syncCount,
-                    lastSync: store.sync.lastSync,
-                    conflicts: store.sync.conflicts,
-                    pendingChanges: store.sync.pendingChanges,
-                    syncStatus: store.sync.conflicts === 0 ? 'healthy' : 'conflicts',
-                },
-            };
-            if (metric === 'all') {
-                return { success: true, metrics };
-            }
-            return {
-                success: true,
-                metric,
-                data: metrics[metric],
-            };
-        },
-    },
-];
-//# sourceMappingURL=coordination-tools.js.map