Metadata-Version: 2.4
Name: phronesis-framework
Version: 0.1.0
Summary: Phronesis Framework
Author-email: Eduardo Marrero González <edumarreroglezz@gmail.com>
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=1.27.2
Requires-Dist: pydantic>=2.5
Provides-Extra: dev
Requires-Dist: mypy>=1.11; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.6; extra == 'dev'
Provides-Extra: obs
Requires-Dist: opentelemetry-api>=1.27; extra == 'obs'
Requires-Dist: opentelemetry-exporter-otlp>=1.27; extra == 'obs'
Requires-Dist: opentelemetry-sdk>=1.27; extra == 'obs'
Description-Content-Type: text/markdown

#

<div align="center">
  <img src="./assets/banners/phronesis.svg" alt="Phronesis Framework" width="60%" />
</div>

<div align="center">

# Phronesis Framework - Documentation

</div>

<div align="center">
  Índice raíz de la documentación. Refleja la estructura de <code>src/phronesis/</code>.
</div>

<div align="center">
  <a href="https://github.com/phronesis-framework/phronesis">repo</a> ·
  <a href="../LICENSE">license</a>
</div>

<div align="center">

[![Status](https://img.shields.io/badge/status-WIP-orange)]()
[![Python](https://img.shields.io/badge/python-3.11+-blue?logo=python&logoColor=white)]()

</div>

---

<div align="center">

## 🗺️ Map

</div>

| Área | Estado | Documentación |
|---|---|---|
| `_internal` - infraestructura compartida | en construcción | [internal/](./internal/index.md) |
| `tools` - declaración y registro de tools | estable | [tools/](./tools/index.md) |
| `agents` - `@agent`, runtime, sessions, tool-calling loop | estable | [agents/](./agents/index.md) |
| `runtime` - orquestación de agentes (19 modos) | estable | [runtime/](./runtime/index.md) |
| `providers` - adaptadores por proveedor LLM | estable | [providers/](./providers/index.md) |
| `obs` - observabilidad (spans, metrics, log correlation) | estable | [obs/](./obs/index.md) |
| `context` - ContextBuilder + Context inyectado a tools | estable | [context/](./context/index.md) |
| `memory` - working/kv/vector/episodic stores + checkpoints | estable | [memory/](./memory/index.md) |
| `pipelines` - composición declarativa de Executables nombrados | estable | [pipelines/](./pipelines/index.md) |
| `mcp` - cliente y servidor Model Context Protocol | estable | [mcp/](./mcp/index.md) |
| `middleware` - cadena onion sobre `LLMProvider.complete` | estable | [middleware/](./middleware/index.md) |
| `replay` - record/replay de respuestas LLM en cassettes JSONL | estable | [replay/](./replay/index.md) |
| `core` - tipos de dominio (`Message`, `ContentBlock`) | estable | [core/](./core/index.md) |
| `communication` - identidad de sesión (`SessionId`) | estable | [communication/](./communication/index.md) |

<div align="center">

## 📐 Decisiones y planes

</div>
