open-agents-ai 0.184.0 → 0.184.2

package/README.md

@@ -8,7 +8,7 @@
 <p align="center">
   <a href="https://www.npmjs.com/package/open-agents-ai"><img src="https://img.shields.io/npm/v/open-agents-ai?color=7C3AED&style=flat-square" alt="npm version" /></a>
   <a href="https://www.npmjs.com/package/open-agents-ai"><img src="https://img.shields.io/npm/dm/open-agents-ai?color=06B6D4&style=flat-square" alt="npm downloads" /></a>
-  <img src="https://img.shields.io/badge/license-MIT-10B981?style=flat-square" alt="license" />
+  <img src="https://img.shields.io/badge/license-CC--BY--NC--4.0-10B981?style=flat-square" alt="license" />
   <img src="https://img.shields.io/badge/node-%3E%3D20-F59E0B?style=flat-square" alt="node version" />
   <img src="https://img.shields.io/badge/models-open--weight-EC4899?style=flat-square" alt="open-weight models" />
   <a href="https://x.com/intent/post?url=https%3A%2F%2Fwww.npmjs.com%2Fpackage%2Fopen-agents-ai"><img src="https://img.shields.io/badge/SHARE%20ON%20X-000000?style=for-the-badge&logo=x&logoColor=white" alt="Share on X" /></a>
@@ -22,6 +22,36 @@ npm i -g open-agents-ai && oa
 
 An autonomous multi-turn tool-calling agent that reads your code, makes changes, runs tests, and fixes failures in an iterative loop until the task is complete. First launch auto-detects your hardware and configures the optimal model with expanded context window automatically.
 
+## The Organism, Not the Cortex
+
+An LLM is a high-bandwidth associative generative core — closer to a cortex-like prior than to a complete agent. Its weights contain broad latent structure, but they do not by themselves give you situated continuity, durable task state, calibrated action policies, or grounded memory management. Open Agents treats the model as one organ inside a larger organism. The framework provides the rest: sensors, effectors, memory stores, routing, gating, evaluation, and persistence.
+
+**Empirical proof** — 65 IQ-grade reasoning tasks (LSAT Logic Games, Bayesian probability, cryptarithmetic, constraint satisfaction, formal logic):
+
+| | With Framework (Full Organism) | Pure Reasoning (Cortex Only) |
+|---|---|---|
+| **4B model** | 65/65 (100%) | 15/15 (100%) |
+| **9B model** | 50/50 (100%) | 12/15 (80%) |
+| **30B model** | 20/20 (100%) | 11/15 (73%) |
+
+When the framework provides externalized computation (shell), persistent state (files), and verification loops (validators) — model size becomes irrelevant. A 4B model with the full agentic framework outperforms a 30B model reasoning alone.
+
+**What the framework provides:**
+
+| Layer | Biological Analog | Implementation |
+|---|---|---|
+| Associative core | Cortex | LLM weights (any size) |
+| Current workspace | Global workspace / attention | `assembleContext()` — structured context assembly |
+| Episodic memory | Hippocampus | `.oa/memory/` — write, search, retrieve across sessions |
+| Cognitive map | Hippocampal spatial maps | `semantic-map.ts` + `repo-map.ts` (PageRank) |
+| Action gating | Basal ganglia | Tool selection policy (task-aware filtering) |
+| Temporal hierarchy | Prefrontal executive | Task decomposition, sub-agent delegation |
+| Self-model | Metacognition | Environment snapshot, process health monitoring |
+| Skill chunks | Cerebellum | Compiled tools, slash commands, verified routines |
+| Safety / limits | Autonomic / immune system | Turn limits, budgets, timeout watchdogs |
+
+Don't chase larger models. Build the organism around whatever model you have.
+
 ## How It Works
 
 ```