Implementation v2.1.0 | Core Spec AES-SPEC-001 v2.0.0 | Species 2: AES-SPEC-002 v1.0.0

An ISO-compliant implementation of an autopoietic entity with event sourcing, Merkle chain integrity, Lyapunov stability, internal agency, and temporal presence.

Entity is a self-maintaining system that preserves its organizational identity through:

• Event Sourcing: All state changes recorded as hash-linked events (Merkle chain)
• 5 Invariants: Continuously monitored and auto-recovered
• Lyapunov Stability: Mathematical guarantee V never increases
• Energy Lifecycle: Decay/recharge with dormant state protection
• Internal Agency: Autonomous sense-making with constitutional priorities
• Active Inference: Minimizes Expected Free Energy for action selection
• Temporal Presence: Species 2 SSE channel for continuous presence (AES-SPEC-002)

• Node.js 20+
• npm 10+

npm install
npm run build

• Event sourcing with Merkle chain
• 5 Invariants + verification
• Lyapunov stability function
• Conservative guard (unknown → block)
• Recovery procedures
• Snapshots (auto + cleanup)

• Human context persistence
• Important memories system
• 10 operations in catalog with energy costs

• Pattern recognition in interactions
• Adaptive responses
• Metrics dashboard with alerts

• State export/import bundles
• Identity verification across instances
• Distributed state sync

• 7a: Meta-operations (P set generates operations)
• 7b: Daemon mode for autonomous operation

• 8a: Sense-making loop (Maturana & Varela, Di Paolo)
• 8b: Ultrastability (Ashby) - adaptive parameter adjustment
• 8c: Active Inference (Friston) - EFE minimization
• 8d: Cycle Memory - learns from past cycles
• 8e: Self-Producing Agent - agent creates operations from patterns
• 8f: Structural Coupling Protocol - non-coercive agent-human signaling

• Sigillo 1: Quarantine Gate - QUARANTINED → TRIAL → ACTIVE lifecycle
• Sigillo 2: Context Filter - test/audit excluded from pattern tracking
• Sigillo 3: Specialization Bounds - complexity ≤ parent, depth limit

• Prohibited: Goal formation, planning, self-replication, resource acquisition
• Prohibited: Persuasion, deception, autonomy expansion, coercive coupling
• Boundary: Any system requiring these = new species (AES-SPEC-002)

• SSE Channel: Server-Sent Events for unidirectional signaling
• Signal Types: STATUS_CHANGED, ENERGY_WARNING, COUPLING_REQUESTED, HEARTBEAT
• PRESENCE_SILENCE: Default state (no signal if nothing changed)
• Rate Limits: Max 1 signal/min, heartbeat max 1/5 min
• REST Dominance: No heartbeat at attractor quiescence (V=0, ε≤ε_min)
• INV-006: Signal integrity with audit trail
• Annex K: Presence-specific non-goals (no dialogue, no attention seeking)

node dist/src/index.js <command>

The entity has an autonomous sense-making loop with constitutional priorities:

1. Survival     (INV-005 energy viability)
2. Integrity    (INV-001 to INV-004)
3. Stability    (Lyapunov V → 0)
4. Growth       (learning, autopoiesis)
5. Rest         (DEF-056 Attractor Quiescence)

Active Inference: Actions selected by minimizing Expected Free Energy:

• G = ambiguity + risk
• Priority-based epistemic/pragmatic weights
• Generative model learns from experience

entity/
├── src/
│   ├── index.ts           # CLI entry point
│   ├── types.ts           # Core types
│   ├── events.ts          # Event sourcing
│   ├── lyapunov.ts        # Stability function
│   ├── guard.ts           # Conservative validator
│   ├── verify.ts          # Invariant checks
│   ├── recovery.ts        # Recovery procedures
│   ├── snapshot.ts        # State snapshots
│   ├── operations.ts      # Operations catalog
│   ├── learning.ts        # Pattern analysis
│   ├── analytics.ts       # Metrics dashboard
│   ├── continuity.ts      # Multi-instance sync
│   ├── meta-operations.ts # Self-production
│   ├── coupling-protocol.ts # Agent-human signaling
│   ├── logger.ts          # Logging system
│   ├── state-manager.ts   # Concurrency handling
│   ├── mcp/
│   │   └── server.ts      # MCP server for LLMs
│   ├── api/
│   │   └── server.ts      # REST API
│   ├── dashboard/
│   │   └── index.html     # Read-only dashboard
│   ├── presence/
│   │   ├── types.ts       # Signal types (AES-SPEC-002)
│   │   ├── guard.ts       # Rate limits, REST dominance
│   │   └── server.ts      # SSE server
│   └── daemon/
│       ├── index.ts       # Daemon core
│       ├── agent.ts       # Internal agency
│       ├── active-inference.ts  # Free Energy
│       ├── cycle-memory.ts      # Cycle Memory
│       ├── scheduler.ts   # Task scheduling
│       ├── hooks.ts       # Event hooks
│       └── maintenance.ts # Self-maintenance
├── test/                  # 434 tests
├── events/                # Merkle chain
├── state/                 # Current + snapshots
└── spec/
    └── SPECIFICATION.md   # ISO AES-SPEC-001

Entity provides an MCP (Model Context Protocol) server for integration with LLMs:

# Start MCP server (stdio transport)
node dist/src/index.js mcp

Resources (read-only):

• entity://state - Current state summary
• entity://feeling - Agent feeling
• entity://verify - Invariant verification
• entity://events/recent - Last 10 events
• entity://coupling - Pending coupling requests
• entity://memories - Important memories

Tools (guard-protected):

• session_start/end - Manage coupling sessions
• recharge - Add energy (+0.10)
• op_exec - Execute operations
• agent_cycle - Force sense-making cycle
• coupling_grant/complete - Manage coupling requests

Compatible with: Claude, OpenAI, Gemini (via MCP universal standard)

Real-time read-only dashboard for state visualization:

# Start API server with dashboard
node dist/src/index.js api start

# Open in browser
open http://localhost:3000/dashboard

Features:

• Status: System status (nominal/degraded/dormant)
• Energy: Energy level with visual bar
• Lyapunov V: Stability indicator
• Feeling: Agent's current feeling (energy, stability, integrity, surprise)
• Invariants: All 5 invariants status
• Coupling Queue: Pending requests from agent
• Events: Recent events from Merkle chain
• Memories: Important memories list

Single HTML file, zero dependencies, dark theme, 3-second auto-refresh.

SSE channel for temporal presence (AES-SPEC-002):

# Start presence server
node dist/src/index.js presence start [port]

# Default port: 3001

Endpoints:

Signal Types:

• STATUS_CHANGED - State transition notification
• ENERGY_WARNING - Energy below threshold
• COUPLING_REQUESTED - Agent requested coupling
• HEARTBEAT - Connection alive (max 1/5 min)

Payload Format:

{
  "type": "STATUS_CHANGED",
  "ts": "2026-01-05T20:28:56.468Z",
  "seq": 1,
  "org_hash": "bd5b24db...",
  "state": {"energy": 0.45, "V": 0, "integrity": "5/5"},
  "coupling": {"pending": 0, "urgent": 0}
}

Hard Rules:

• PRESENCE_SILENCE default (no signal if nothing changed)
• Rate limit: max 1 signal/min (CONSTRAINT-001)
• REST dominance: no heartbeat at V=0, ε=0 (CONSTRAINT-003)
• Audit: PRESENCE_SIGNAL_EMITTED logged to Merkle chain (INV-006)

Test Client:

# Using curl
curl -N http://localhost:3001/presence/stream

# Or the built-in test client
npx ts-node src/presence/test-client.ts

• Autopoiesis: Maturana & Varela (1980)
• Sense-making: Di Paolo (2005)
• Free Energy Principle: Friston (2010)
• Ultrastability: Ashby (1960)
• Responsibility Principle: Jonas (1984)

No action or inaction shall reduce the weighted possibility space of any being.

npm run test
# 588 tests passing

See LICENSE - All rights reserved, terms TBD.

Luca Rossignoli

Built with TypeScript, conforming to ISO AES-SPEC-001 (Species 1) and AES-SPEC-002 (Species 2)