Metadata-Version: 2.5
Name: atlas-agent-adapters
Version: 1.1.0
Summary: Adapters externos REST, gRPC e orientados a eventos para o Atlas
Project-URL: Repository, https://github.com/Medicode/ai-agent-framework
Project-URL: Documentation, https://github.com/Medicode/ai-agent-framework/tree/main/docs/adapters
Project-URL: Issues, https://github.com/Medicode/ai-agent-framework/issues
Author: Jorge Medina
Maintainer: Jorge Medina
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: atlas-agent-core~=1.1.0
Requires-Dist: pydantic<3,>=2.13
Provides-Extra: grpc
Requires-Dist: grpcio<2,>=1.81.1; extra == 'grpc'
Requires-Dist: protobuf<7,>=6.33.5; extra == 'grpc'
Provides-Extra: postgresql
Requires-Dist: psycopg[binary,pool]<4,>=3.3; extra == 'postgresql'
Provides-Extra: redis
Requires-Dist: redis<7,>=5.2; extra == 'redis'
Provides-Extra: rest
Requires-Dist: fastapi<1,>=0.141; extra == 'rest'
Description-Content-Type: text/markdown

# atlas-agent-adapters

Adapters externos opcionais para REST, gRPC, mensageria e persistência
PostgreSQL ou Redis de checkpoints.

Instale a integração PostgreSQL com:

```bash
pip install atlas-agent-adapters[postgresql]
```

Migrations são administrativas e nunca executadas no import. Depois de
provisionar o schema explicitamente, use o checker somente leitura no readiness:

```python
from atlas_agents.adapters.checkpoints.postgresql import (
    PostgreSQLCheckpointMigrator,
    PostgreSQLSchemaCompatibilityChecker,
)

await PostgreSQLCheckpointMigrator(pool).migrate()
schema = await PostgreSQLSchemaCompatibilityChecker(pool).check()
```

O resultado diferencia schema compatível, drift, versão não suportada e banco
não inicializado, sem carregar payloads nem realizar reparo automático.

Instale a integração Redis com:

```bash
pip install atlas-agent-adapters[redis]
```

O host deve injetar o cliente assíncrono e fornecer um namespace explícito:

```python
from redis.asyncio import Redis

from atlas_agents.adapters.checkpoints.redis import RedisCheckpointStore

client = Redis.from_url("rediss://redis.internal/0")
checkpoint_store = RedisCheckpointStore(client, namespace="produção:tenant-a")
```

O adapter não lê `REDIS_URL`, não fecha clientes injetados e usa scripts Lua
estáticos para save, atualização condicional e consumo único. A durabilidade
depende da configuração de AOF/RDB, replicação e eviction do serviço Redis.

Este pacote integra o ecossistema modular Atlas Agent Framework. Consulte a
[documentação oficial](https://github.com/Medicode/ai-agent-framework/tree/main/docs)
para instalação, compatibilidade e APIs públicas.
