Metadata-Version: 2.4
Name: kaizen-agents
Version: 0.6.0
Summary: PACT-governed autonomous agent engines built on Kailash Kaizen SDK
Author-email: Terrene Foundation <info@terrene.foundation>
License: Apache-2.0
Project-URL: Homepage, https://github.com/terrene-foundation/kailash-py
Project-URL: Bug Tracker, https://github.com/terrene-foundation/kailash-py/issues
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: kailash[pact]>=2.2.0
Requires-Dist: kailash-kaizen>=2.3.2
Requires-Dist: kailash-pact>=0.4.1
Requires-Dist: openai>=1.30.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: structlog>=23.1.0
Provides-Extra: dev
Requires-Dist: pytest>=7.2.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: black>=23.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: mypy>=1.0; extra == "dev"

# kaizen-agents

PACT-governed autonomous agent engines built on the [Kailash Kaizen SDK](https://github.com/terrene-foundation/kailash-py).

## Architecture

```
Layer 1: PRIMITIVES (kailash-kaizen) — deterministic, no LLM
Layer 2: ENGINES    (kaizen-agents)  — LLM judgment        ← this package
Layer 3: ENTRYPOINTS (kz CLI, aegis) — human interface
```

kaizen-agents provides the LLM-driven intelligence layer on top of kailash-kaizen primitives (Signature, BaseAgent, memory, tools).

## Installation

```bash
pip install kaizen-agents
```

This automatically installs `kailash-kaizen` and `kailash-pact` as dependencies.

## Quick Start

```python
from kaizen_agents import Agent

agent = Agent(model="claude-sonnet-4-6", budget_usd=5.0)
result = await agent.run("Analyze this codebase")
```

## What's Included

### Specialized Agents

ReAct, RAG, Tree-of-Thoughts, Chain-of-Thought, planning, vision, audio, streaming, batch processing, and more.

### Multi-Agent Patterns

Debate, supervisor-worker, consensus, ensemble, pipeline, sequential, parallel, handoff, blackboard.

### Journey Orchestration

Multi-pathway user journeys with LLM-based intent detection and context accumulation.

### Orchestration Engine

Planner (designer, composer, decomposer), protocols (delegation, escalation, clarification), recovery (diagnoser, recomposer), monitoring.

### PACT Governance

GovernedSupervisor with accountability tracking, budget enforcement, clearance checks, cascade governance.

### Delegate

Autonomous TAOD engine (Think-Act-Observe-Decide) for CLI and interactive agent applications.

## License

Apache 2.0 — [Terrene Foundation](https://terrene.foundation)
