goblins

plurigrid's avatarfrom plurigrid

Distributed object capability system (6.5K lines info).

⭐1stars🔀2forks📁View on GitHub🕐Updated Jan 9, 2026

When & Why to Use This Skill

Goblins is a sophisticated distributed object capability (OCap) system designed for building secure, decentralized software architectures. It leverages the actor model and the OCapN protocol to facilitate secure peer-to-peer communication and distributed state management. By treating actors as autopoietic systems and integrating principles of Active Inference and Category Theory, Goblins provides a robust framework for creating resilient, self-maintaining agentic environments with compositional coherence.

Use Cases

  • Secure P2P Networking: Establishing encrypted, capability-based communication between distributed nodes using the OCapN protocol.
  • Distributed Actor Systems: Implementing complex systems where actors maintain local state and interact asynchronously across different 'vats' or processes.
  • Agentic AI Infrastructure: Building AI agents that utilize Active Inference for state maintenance and prediction error minimization within a distributed framework.
  • Decentralized Security Models: Designing applications that enforce security through object capabilities rather than centralized access control lists (ACLs), adhering to the principle of least privilege.
  • Scientific Computing Integration: Utilizing mathematical triads and graph theory (via networkx) to ensure structural integrity in distributed computational models.
namegoblins
descriptionDistributed object capability system (6.5K lines info).
version1.0.0

goblins

Distributed object capability system (6.5K lines info).

bmorphism Contributions

"Autopoiesis refers to the self-maintenance of a system, where the system is capable of reproducing and maintaining itself." — vibes.lol gist

Goblins as Autopoietic Agents: Each Goblins actor is an autopoietic system — it maintains its own state via bcom (become), reproducing itself with updated behavior. This embodies the self-maintenance principle at the core of cognitive architecture.

Active Inference via CapTP: The OCapN protocol implements distributed Active Inference in String Diagrams where:

  • Sturdyref → Reference to external world (perception)
  • <- async call → Action that generates expected sensory response
  • Promise resolution → Prediction error minimization

GF(3) in Actor Triads: Actor systems naturally form triads: sender (+1, generator) → message (0, coordinator) → receiver (-1, validator). The async semantics preserve GF(3) conservation across distributed computation.

Model

peer → vat → actormap → {refr: behavior}

Operators

($  obj method args...)   ; Sync (near only)
(<- obj method args...)   ; Async (near/far)

Vat

(define vat (spawn-vat))
(define greeter
  (vat-spawn vat
    (lambda (bcom)
      (lambda (name)
        (format #f "Hello, ~a!" name)))))

($ greeter "World")  ; => "Hello, World!"

OCapN

Object Capability Network for secure p2p via CapTP.

Scientific Skill Interleaving

This skill connects to the K-Dense-AI/claude-scientific-skills ecosystem:

Graph Theory

  • networkx [○] via bicomodule
    • Universal graph hub

Bibliography References

  • general: 734 citations in bib.duckdb

Cat# Integration

This skill maps to Cat# = Comod(P) as a bicomodule in the equipment structure:

Trit: 0 (ERGODIC)
Home: Prof
Poly Op: ⊗
Kan Role: Adj
Color: #26D826

GF(3) Naturality

The skill participates in triads satisfying:

(-1) + (0) + (+1) ≡ 0 (mod 3)

This ensures compositional coherence in the Cat# equipment structure.