agentdb 3.0.0-alpha.11 → 3.0.0-alpha.13

package/dist/src/consensus/RaftConsensus.d.ts

@@ -1,220 +0,0 @@
-/**
- * RaftConsensus - Fault-Tolerant Distributed Consensus
- *
- * Implements the Raft consensus algorithm for multi-agent coordination with:
- * - Leader election with automatic failover (<1s)
- * - Log replication with strong consistency
- * - Byzantine fault tolerance (BFT)
- * - Gossip protocols for large-scale coordination
- * - CRDT synchronization for eventually consistent state
- * - Distributed locks with deadlock detection
- * - Automatic sharding and partitioning
- *
- * References:
- * - Raft Paper: https://raft.github.io/raft.pdf
- * - Byzantine Fault Tolerance: https://pmg.csail.mit.edu/papers/osdi99.pdf
- */
-import { EventEmitter } from 'events';
-export type NodeState = 'follower' | 'candidate' | 'leader';
-export type LogEntryType = 'command' | 'config' | 'noop';
-export interface RaftConfig {
-    nodeId: string;
-    nodes: string[];
-    electionTimeoutMin?: number;
-    electionTimeoutMax?: number;
-    heartbeatInterval?: number;
-    maxEntriesPerRequest?: number;
-    snapshotThreshold?: number;
-    byzantineTolerance?: boolean;
-    quorumSize?: number;
-}
-export interface LogEntry {
-    term: number;
-    index: number;
-    type: LogEntryType;
-    command?: any;
-    timestamp: number;
-    signature?: string;
-}
-export interface RaftState {
-    currentTerm: number;
-    votedFor: string | null;
-    log: LogEntry[];
-    commitIndex: number;
-    lastApplied: number;
-    state: NodeState;
-    leaderId: string | null;
-}
-export interface PeerState {
-    nodeId: string;
-    nextIndex: number;
-    matchIndex: number;
-    lastHeartbeat: number;
-    isHealthy: boolean;
-}
-export interface VoteRequest {
-    term: number;
-    candidateId: string;
-    lastLogIndex: number;
-    lastLogTerm: number;
-    signature?: string;
-}
-export interface VoteResponse {
-    term: number;
-    voteGranted: boolean;
-    signature?: string;
-}
-export interface AppendEntriesRequest {
-    term: number;
-    leaderId: string;
-    prevLogIndex: number;
-    prevLogTerm: number;
-    entries: LogEntry[];
-    leaderCommit: number;
-    signature?: string;
-}
-export interface AppendEntriesResponse {
-    term: number;
-    success: boolean;
-    matchIndex?: number;
-    signature?: string;
-}
-export interface GossipMessage {
-    type: 'state' | 'health' | 'metadata';
-    nodeId: string;
-    data: any;
-    timestamp: number;
-    signature?: string;
-}
-export interface CRDTState {
-    type: 'counter' | 'set' | 'map' | 'register';
-    value: any;
-    vectorClock: Map<string, number>;
-}
-export interface DistributedLock {
-    key: string;
-    holder: string | null;
-    acquiredAt: number;
-    expiresAt: number;
-    waiters: string[];
-}
-export declare class RaftConsensus extends EventEmitter {
-    private config;
-    private state;
-    private peers;
-    private electionTimer;
-    private heartbeatTimer;
-    private votesReceived;
-    private commandQueue;
-    private privateKey?;
-    private publicKeys;
-    private gossipInterval;
-    private gossipState;
-    private crdtStates;
-    private locks;
-    private lockCheckInterval;
-    private metrics;
-    constructor(config: RaftConfig);
-    /**
-     * Start the Raft node
-     */
-    start(): void;
-    /**
-     * Stop the Raft node
-     */
-    stop(): void;
-    /**
-     * Replicate a command to the cluster
-     */
-    replicate(command: any, timeout?: number): Promise<boolean>;
-    /**
-     * Handle vote request from candidate
-     */
-    handleVoteRequest(request: VoteRequest): VoteResponse;
-    /**
-     * Handle append entries request from leader
-     */
-    handleAppendEntries(request: AppendEntriesRequest): AppendEntriesResponse;
-    /**
-     * Handle vote response (exposed for testing/network layer)
-     */
-    handleVoteResponse(response: VoteResponse, peerId: string): void;
-    /**
-     * Handle append entries response (exposed for testing/network layer)
-     */
-    handleAppendEntriesResponse(response: AppendEntriesResponse, peerId: string): void;
-    /**
-     * Get current cluster status
-     */
-    getStatus(): {
-        nodeId: string;
-        state: NodeState;
-        term: number;
-        leaderId: string | null;
-        logLength: number;
-        commitIndex: number;
-        lastApplied: number;
-        peers: {
-            nodeId: string;
-            isHealthy: boolean;
-            matchIndex: number;
-        }[];
-        metrics: {
-            totalElections: number;
-            totalLeaderChanges: number;
-            totalCommittedEntries: number;
-            lastElectionTime: number;
-            avgElectionTimeMs: number;
-            uptime: number;
-        };
-    };
-    /**
-     * Update CRDT state with eventual consistency
-     */
-    updateCRDT(key: string, operation: 'increment' | 'add' | 'set', value: any): void;
-    /**
-     * Get CRDT value
-     */
-    getCRDT(key: string): any;
-    /**
-     * Merge CRDT state from remote node
-     */
-    mergeCRDT(key: string, remoteState: CRDTState): void;
-    /**
-     * Acquire distributed lock
-     */
-    acquireLock(key: string, ttlMs?: number): Promise<boolean>;
-    /**
-     * Release distributed lock
-     */
-    releaseLock(key: string): Promise<void>;
-    /**
-     * Check for deadlocks
-     */
-    detectDeadlocks(): string[][];
-    private becomeFollower;
-    private becomeCandidate;
-    private becomeLeader;
-    private requestVotes;
-    private processVoteResponse;
-    private isLogUpToDate;
-    private sendHeartbeat;
-    private replicateToFollowers;
-    private processAppendEntriesResponse;
-    private updateCommitIndex;
-    private applyCommittedEntries;
-    private resetElectionTimer;
-    private clearElectionTimer;
-    private clearHeartbeatTimer;
-    private setupBFT;
-    private signData;
-    private verifySignature;
-    private startGossipProtocol;
-    private stopGossipProtocol;
-    private gossipToRandomPeers;
-    private gossipCRDTUpdate;
-    private startLockMonitoring;
-    private stopLockMonitoring;
-    private checkExpiredLocks;
-}
-//# sourceMappingURL=RaftConsensus.d.ts.map

package/dist/src/consensus/RaftConsensus.d.ts.map

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