Metadata-Version: 2.4
Name: paytime-agent
Version: 0.1.1
Summary: SDK de integração dos agentes da Paytime com o Agentes Hub
Project-URL: Hub, https://agents.paytimehub.com.br
Project-URL: Repositorio, https://github.com/paytime-ai/paytime-agent-sdk
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.31
Requires-Dist: PyYAML>=6.0

# paytime-agent

SDK que liga um agente ao Agentes Hub. Heartbeat, execuções, parada cooperativa,
log, alerta e artefato.

## Instalação

Não está em índice público. Instale direto do repositório:

```bash
pip install git+https://github.com/paytime-ai/paytime-agent-sdk@v0.1.0
```

No `requirements.txt` do agente:

```
paytime-agent @ git+https://github.com/paytime-ai/paytime-agent-sdk@v0.1.0
```

Fixe a tag. Não use `@main` — um agente em produção não deve mudar de SDK
porque alguém deu merge.

## Uso

```python
from paytime_agent import Agent

agent = Agent.start()
agent.run_forever(processar, source=proximo_item)
```

Três variáveis de ambiente, geradas na tela de pareamento do Hub:
`AGENT_ID`, `HUB_URL`, `HUB_TOKEN`.

A especificação completa está em
[`docs/agent-contract.md`](https://github.com/paytime-ai/agents-hub/blob/main/docs/agent-contract.md)
no repositório do Hub.

## Duas garantias

**Hub fora do ar não para agente.** Toda falha de rede é engolida e registrada no
stdout. A única exceção que sobe para o código do agente é `StopRequested`.

**SDK não bloqueia agente.** Log, evento e execução vão para fila limitada,
entregues por thread de fundo.

## Testes

```bash
python smoke_test.py    # sobe um Hub falso em 127.0.0.1 e exercita tudo
```
