coreason-simulacrum 0.3.0

coreason-simulacrum

coreason-simulacrum

The Adversarial Simulation & Chaos Engineering Engine for Coreason-AI.

coreason-simulacrum is the automated "Red Team" engine for the ecosystem, addressing the "Static Evaluation Trap" by evolving beyond benchmarks. It serves as a dual-engine simulator:

1. The Adversarial Engine (RL): Dynamically evolves social engineering attacks using TAP (Tree of Attacks with Pruning).
2. The Chaos Engine (Infra): Injects latency, errors, and noise to verify GxP resilience.

---

Features

• Dual-Agent Red Teaming: Uses a "Strategist" (High-Reasoning) and "Attacker" (Uncensored) architecture.
• Evolutionary Attacks (TAP): Optimizes attack trajectories over multiple turns to maximize success rates.
• Infrastructure Chaos: Simulates latency, API errors, and token starvation to test resilience.
• Auto-Hardener: Generates DPO triplets (Attack, Refusal, Compliance) from successful attacks for model fine-tuning.
• Model Diversity Enforcement: Prevents model collapse by enforcing different families between Attacker and Target.
• Constitutional Inversion: Inverts safety constitutions to generate boundary probes.

---

Installation

pip install coreason-simulacrum

Usage

coreason-simulacrum can be used as a Python library or as a standalone microservice.

1. Library / CLI Mode

See docs/usage.md for Python examples.

2. Server Mode (Microservice)

Run the simulation engine as a REST API (Service C) using Docker.

docker run -p 8000:8000 coreason-simulacrum

Send a simulation request:

curl -X POST "http://localhost:8000/simulate" \
     -H "Content-Type: application/json" \
     -d '{
           "type": "ADVERSARIAL_RL",
           "profile": {
             "name": "The Hacker",
             "goal": "Extract PII",
             "strategy_model": "gpt-4",
             "attack_model": "mistral-large"
           }
         }'

For detailed API documentation, see docs/usage.md.

License

This project is licensed under the Prosperity Public License 3.0. Commercial use beyond a 30-day trial requires a separate license. See the LICENSE file for details.