# TIM Contas — agent_framework_oci

Reconstrução framework-native do Agent Contas. O código executável em `app/`, `mcp/` e `config/` não depende do pacote anterior do Contas.

## Comece aqui

Leia **`docs/MANUAL_AGENT_CONTAS_MIGRADO.md`**.

## Arquitetura

- `app/`: backend e agentes de domínio sobre o LangGraph/framework.
- `app/domain/contas/`: regras e integrações específicas do Contas, sem runtime de agente próprio.
- `contas_mcp/servers/contas_mcp_server/`: exposição MCP das operações de domínio.
- `config/`: intents, tools, policies, identity, guardrails, judges e prompts.
- `agent_framework_oci/`: infraestrutura compartilhada reutilizada.

## Smoke test

```bash
uv sync
uv run uvicorn contas_mcp.servers.contas_mcp_server.main:app --port 8400
uv run uvicorn app.main:app --port 8000
```

Em outro terminal:

```bash
PYTHONPATH=".:agent_framework_oci/libs/agent_framework/src" python scripts/smoke_mcp.py
```

## Regra de arquitetura

```bash
grep -R "agente_contas_tim" app mcp config
```

Deve retornar zero ocorrências.


## V10 - VAS response renderer
`consultar_vas` agora usa `response.mode: renderer` com `renderer: contas.vas`. O renderer inclui o valor de cada serviço quando a tool o fornece (por exemplo `details.valor`) e nunca inventa preço quando ausente.