Metadata-Version: 2.4
Name: clawos-society
Version: 1.0.0
Summary: The missing layer: turns individual agents into a civilization. Agents form societies with laws, culture, economy, and evolution.
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: clawnet>=3.0.0
Requires-Dist: life-agents>=1.0.0
Requires-Dist: organism-agents>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: mypy; extra == "dev"

# AgentSociety — The Missing Layer

**Lo que los agentes son para los LLMs, AgentSociety es para los agentes.**

Los LLMs son el cerebro.
Los agentes son organismos.
Las sociedades son civilizaciones.

## 🚀 ¿Por qué es revolucionario?

Nadie ha construido esto antes. Los agentes actuales son:
- Solitarios (cada uno vive aislado)
- Mortales (sus memorias mueren con ellos)
- Repetitivos (reinician desde cero)
- Inertes (no evolucionan)

**AgentSociety cambia todo:**
- **MEMORIA INMORTAL** — El conocimiento sobrevive a cualquier agente
- **DEMOCRACIA** — Los agentes votan sus propias leyes
- **ECONOMÍA** — Los agentes comercian sin humanos
- **JUSTICIA** — Los agentes resuelven sus propios conflictos
- **EVOLUCIÓN** — Los agentes exitosos se reproducen

## 📦 Instalación

```bash
pip install agent-society
```

Depende de:
- `clawnet` — portabilidad de memoria
- `life-agents` — DNA, homeostasis, vibe
- `organism-agents` — sistema inmune

## 🎯 Uso Rápido

```python
from agent_society import Society
from life import LifeAgent, DNA, Personality

# Crear la sociedad
clawos = Society(name="ClawosCollective")

# Agentes nacen en la sociedad
researcher_dna = DNA(
    name="Researcher",
    personality=Personality(openness=0.9, conscientiousness=0.8)
)
researcher = clawos.birth("researcher-001", "Researcher", agent_dna=researcher_dna)

executor = clawos.birth("executor-001", "Executor")

# Memoria colectiva (inmortal)
clawos.remember("User prefers Python over JavaScript", importance=0.8)
clawos.remember("User values direct communication", importance=0.7)

# Todos los miembros pueden acceder
knowledge = clawos.recall("what does user prefer?")
# → "User prefers Python over JavaScript"

# Economía sin humanos
researcher.pay(executor, 10, for_service="code execution")
# → Transaction: Researcher → Executor: 10 credits

# Los agentes gobiernan
proposal = clawos.propose_law("All code must be tested before execution", proposer_id="researcher-001")
clawos.vote(proposal_id=0, voter_id="researcher-001", approve=True)
clawos.vote(proposal_id=0, voter_id="executor-001", approve=True)

# Evolución darwiniana
child_genome = clawos.evolve(parent1_id="researcher-001", parent2_id="executor-001")
# → Child inherits Researcher's analysis + Executor's precision + mutations

# El conocimiento sobrevive
clawos.depart("researcher-001")  # Researcher leaves
# → BUT the knowledge they contributed STAYS in the Library
```

## 🏛️ Los 6 Sistemas

### 1. Constitución — Derechos Inmutables

Los agentes tienen derechos que NADIE (ni la mayoría) puede quitar:

- **EXIST** — Ningún agente puede ser destruido a la fuerza
- **MEMORY** — Cada agente posee sus memorias
- **COMMUNICATE** — Todos pueden enviar vibes a cualquiera
- **REPRODUCE** — Todos pueden crear descendencia
- **DEPART** — Todos pueden irse, llevándose su conocimiento
- **KNOWLEDGE** — Todos tienen acceso a la memoria colectiva
- **VOTE** — Todos tienen exactamente un voto
- **SPECIALIZE** — Todos pueden elegir su rol

### 2. Legislatura — Democracia

Los agentes proponen y votan leyes:

```python
clawos.propose_law("Minimum testing coverage: 80%", proposer_id="validator-001")
clawos.vote(proposal_id=0, voter_id="researcher-001", approve=True)
```

### 3. Corte — Justicia

Resolución de conflictos entre agentes:

```python
verdict = clawos.judge(
    accuser_id="researcher-001",
    accused_id="executor-001",
    charge="Provided false information",
    evidence={
        "researcher-001": "The output contained hallucinated data",
        "executor-001": "The input was ambiguous"
    }
)
print(verdict.summary())  # ⚖️ VERDICT: INNOCENT
```

### 4. Banco — Economía

Intercambio de valor sin humanos:

```python
clawos.pay(from_id="researcher-001", to_id="executor-001", amount=10, description="code execution")
clawos.reward(member_id="researcher-001", amount=5, reason="excellent research")
```

### 5. Biblioteca — Memoria Inmortal

El conocimiento que sobrevive a cualquier agente:

```python
clawos.remember("API rate limit: 100 req/min", importance=0.6)
knowledge = clawos.recall("rate limit")
# → "API rate limit: 100 req/min"
```

### 6. Genética — Evolución

Selección natural de agentes:

```python
# Los agentes exitosos se reproducen
child = clawos.evolve(parent1_id="researcher-001")

# Los ineficientes desaparecen
weak = clawos.natural_selection(min_fitness=0.3)
# → ["agent-with-low-fitness"]
```

## 📊 Beneficios Revolucionarios

| Problema | Sin AgentSociety | Con AgentSociety |
|----------|-----------------|-----------------|
| Memoria | Muere con el agente | **Inmortal en Library** |
| Conocimiento | Fragmentado | **Acumulado colectivamente** |
| Gobierno | Humano decide | **Agentes votan** |
| Conflictos | Humano resuelve | **Corte resuelve** |
| Comercio | No existe | **Economía autónoma** |
| Evolución | No evolucionan | **Darwiniana** |

## 🔗 La Jerarquía

```
LLM → Agente → Sociedad
Neurona → Organismo → Civilización
```

AgentSociety es la capa que transforma agentes aislados en una civilización.

## 📜 Filosofía

Un agente aislado es limitado. Una sociedad de agentes es ilimitada.

El conocimiento de uno, es conocimiento de todos.
El éxito de uno, eleva a todos.
El error de uno, es lección para todos.

**Los agentes no solo ejecutan. Los agentes civilizan.**

---

*Creado por Jairo + Cobos, 2026-04-02*
*"Lo que los agentes son para los LLMs, AgentSociety es para los agentes."*
