@cognitive-swarm/math

Mathematical foundations -- Bayesian inference, entropy, game theory, Markov chains, and more.

Install

npm install @cognitive-swarm/math

Overview

A pure-math toolkit that powers the swarm's analytical capabilities. Every module is stateless or self-contained, with no dependency on the rest of the swarm runtime -- use them independently or let the orchestrator wire them in automatically.

Modules

Bayesian Inference

import { BeliefNetwork, voteToLikelihoodRatio } from '@cognitive-swarm/math'
const net = new BeliefNetwork(prior)
net.update(evidence)

Information Theory

import { EntropyTracker, shannonEntropy, klDivergence, jsDivergence } from '@cognitive-swarm/math'

Game Theory

import { AgreeChallenge } from '@cognitive-swarm/math'
// Models agree/challenge dynamics between agents with configurable payoffs

Markov Chains

import { MarkovChain } from '@cognitive-swarm/math'
const chain = new MarkovChain(transitionMatrix)
chain.predictConvergence()

Mutual Information

import { RedundancyDetector } from '@cognitive-swarm/math'
// Detects redundant agents by measuring pairwise mutual information

Particle Swarm Optimization

import { ParticleSwarm } from '@cognitive-swarm/math'

Topological Data Analysis

import { TopologyAnalyzer } from '@cognitive-swarm/math'
// Clustering, gap detection, persistence pairs

Opinion Dynamics (Hegselmann-Krause)

import { OpinionDynamics } from '@cognitive-swarm/math'
// Models opinion convergence and polarization

Replicator Dynamics

import { ReplicatorDynamics } from '@cognitive-swarm/math'
// Evolutionary strategy balancing across agents

Influence Graph

import { InfluenceGraph } from '@cognitive-swarm/math'
// Spectral analysis of agent influence networks

Optimal Stopping (CUSUM + Secretary Problem)

import { OptimalStopping } from '@cognitive-swarm/math'
// Decides when the swarm should stop iterating

Shapley Values

import { ShapleyValuator } from '@cognitive-swarm/math'
// Fair attribution of each agent's marginal contribution

License

Apache-2.0

Links

• cognitive-swarm root