Papers: Economic Attention Networks — Iklé, Pitt, Goertzel, Sellman (2009); Nonlinear Dynamical Attention — Iklé & Goertzel (2011); Guiding PLN with Attention Allocation — Harrigan et al. (2014); Goertzel (2025), Hyperon Whitepaper §5.3–5.4, §6.3
Status: Current. The ECAN model is operational in two implementations: C++ (legacy, attention repo) and MeTTa (metta-attention on PeTTa). The fluid-dynamic extensions (In-Fluid-Net, incompressible-fluid networks) described in the 2025 whitepaper are proposed.
This card provides technical depth beyond the concise ECAN index card. ECAN (Economic Attention Allocation Networks) is Hyperon's primary attention-allocation and resource-regulation subsystem. It determines which atoms in a potentially vast AtomSpace receive computational resources at any given moment — functioning as an internal economy that balances short-term responsiveness with long-term coherence.
Implementation note. None of the four subsystems that today touch ECAN-style attention — the C++ attention repo, metta-attention on PeTTa, the DAS Attention Broker, and OpenPsi's default action-selector — implements the 2009 paper's math literally. Each is an engineering approximation with its own simplifications. The cleanest historical bridge between attention and inference, a URE forward-chainer hook that consulted atom STI for source selection, was wired into the legacy C++ AtomSpace around 2016 and actively used through 2018; the C++→MeTTa migration left it behind. The subcards below trace this lineage in detail, including the OpenPsi action-selector path and Linas Vepstas's parallel Hyperon-era perception portfolio (which lives on the AtomSpace-Scheme branch rather than the MeTTa-runtime branch).
Related cards: PLN (inference control integration), MORK (Weighted Atom Sweeps), DAS (Attention Broker), MetaMo (motivational priorities), PRIMUS (ambient cognitive loop), Attention and Motivation (synthesis card)
Two Importance Currencies. Every Atom carries two dynamically updated scalar values:
Economic Dynamics. ECAN implements an attention economy with several interacting mechanisms:
Fringe Spreading (Third Diffusion Mode). The AF-only and WA diffusion modes have a known gap: atoms 2-3 hops from the Attentional Focus receive negligible STI even when they are highly relevant (e.g., question-answer ImplicationLinks connected to AF words only via intermediate nodes). Fringe spreading addresses this by diffusing STI K hops out from each AF atom (typically K=2 or K=3), analogous to a "fringe of consciousness." This is faster than WA diffusion but broader than AF-only. A design tension remains between fringe spreading and intra-AF attractor dynamics: variable-K spreading (Matt Iklé's proposal to replace AF-only entirely) risks slowing attractor formation by orders of magnitude. (mailing-list-backed: Fringe-of-consciousness-importance-spreading, 2016)
Directional Diffusion and Hebbian/Non-Hebbian Split. STI diffusion follows a tunable split: x% along HebbianLinks, (1-x)% along non-Hebbian links (e.g., InheritanceLinks, EvaluationLinks). Early implementation revealed that STI could get "stuck" on intermediate structures (e.g., ListLinks inside EvaluationLinks) because diffusion originally only flowed along ordered link targets, not back to source atoms. The fix required diffusion along both incoming and outgoing sets. For calibrating non-Hebbian weights, a three-step empirical methodology was proposed: (1) run Hebbian-only diffusion, (2) measure co-activation frequency for each (link-type, source-node-type, target-node-type) combination, (3) derive "virtual Hebbian weights" from the resulting statistics. (mailing-list-backed: Importance diffusion, 2014)
Information Geometry. The 2011 paper by Iklé and Goertzel formalizes ECAN using information geometry, casting attention allocation as movement on a statistical manifold where the distance metric reflects information-theoretic cost of attention reallocation.
Fluid-Dynamic Extension (Proposed). The 2025 whitepaper (§5.3–5.4) proposes extending ECAN with an incompressible fluid dynamics model where attention mass (STI values) becomes a conserved fluid density \(\rho(t,x)\) advected by a divergence-free velocity field \(u(t,x)\). Key proposed properties:
The continuity equation governing attention transport:
\[\frac{\partial \rho}{\partial t} + \nabla \cdot (\rho\, u) = 0\]This fluid-dynamic layer would not replace ECAN's economic mechanisms but provide a continuous-time transport substrate between ECAN's discrete steps. The whitepaper notes this is particularly useful for credit assignment in multi-hop causal chains where traditional diffusion may lag.
0a0b09912 2016-03-09 wire-up by Misgana Bayetta; commit 0b744dbab 2018-10-23 unwired by Nil Geisweiller with the comment "An attentionbank is needed in order to get the STI..."; constructor argument removed in commit 5a5b7785d 2019-01-08), and the OpenPsi default action-selector STI path 2016-05 to 2016-11 (commit 8ab0e8f81 2016-05-10 added by Amen Belayneh; commit 9f2697859 2016-11-24 removed by Linas Vepstas; reintroduced as uncalled helper in commit e5bae708f 2017-11-08). Separately, the Loving AI Ghost dialogue runtime explicitly disables STI weighting via the supported Ghost API in commit 51a413e7 (2018-06-06 DevHEAD), then carried forward in the Scheme runner via commit 6ec13879 (2020-09-21 leungmanhin). Modern URE replaced its hook with internal complexity-penalty source weighting (no AttentionBank dependency). Current MeTTa-PLN has no attention-layer integration. See ECAN Full → Development and Historical Context for the full reconstructed nine-event lifecycle, including the OpenPsi action-selector path documented during the OpenPsi cluster pilot (2026-04-28).STI × (1 − decay_rate)^averageElapsedTime), not the literal 0.5 × (1 + tanh(shape × (si − FocusBoundary))) stochastic focus-boundary probability. Hebbian learning, AF/WA rent, and AF/WA diffusion are real running agents under PeTTa's hyperpose superposition; performance and concurrency caveats apply (see Development and Historical Context).Last verified: 2026-05-13
× (1 − decay_rate)^averageElapsedTime not the literal × (1 + tanh(...)) focus-boundary probability — confirmed by direct code inspection of both repos.0b744dbab when the URE rewrite did not preserve the AttentionBank dependency. Current MeTTa-PLN has no attention-layer integration; the 2014 Harrigan et al. paper-architectural design has not been productionized as an executable runtime. See ECAN Full → Development and Historical Context for the full timeline.matcher.scm:117-130, 284; STI/AF reads/writes in matcher and schema procedures), NLP fuzzy matching (AF-only via bank->atom_is_in_AF), Python web API AttentionValue surfaces, and OpenPsi (action-selector seam plus an uncalled rule-sca-weight STI helper — an enabler rather than a default consumer) — all confirmed at the pre-removal monorepo snapshot during the ECAN cluster pilot. None were preserved as functioning ECAN integrations across the 2019 AttentionBank removal; none have documented MeTTa equivalents. Selecting which consumer integrations to rebuild is an open Hyperon-ecosystem decision.scripts/archive/ecan_pilot/ in the wiki repository. Cross-model triangulation by Claude orchestrator + Codex + Gemini.