Integration Model

O modelo de integracoes do looply organiza como servicos externos sao documentados, configurados e consumidos pelos agentes durante os workflows.

Camadas

flowchart TD
    A[Integration Context] --> B[Integration Adapter]
    B --> C[Integration Secrets/Config]
    
    style A fill:#17233b,stroke:#22D3EE,color:#eef6ff
    style B fill:#1a2740,stroke:#7C3AED,color:#eef6ff
    style C fill:#17233b,stroke:#EF4444,color:#eef6ff

Camada 1: Integration Context (ativo)

Contexto de integracao em Markdown puro. Cada integracao tem um arquivo .md com detalhes de API, autenticacao e constraints.

Estado: production-ready

looply integrations list
looply integrations add stripe
looply integrations configure stripe

Estrutura:

.looply/custom/integrations/
├── integrations-index.md
├── stripe.md
├── github.md
└── templates/
    └── integration-context.template.md

Cada arquivo de integracao segue o template:

# <nome>

## API Base URL
https://api.stripe.com

## Authentication
Bearer token via STRIPE_SECRET_KEY

## Key Endpoints
- POST /v1/charges
- GET /v1/customers/:id

## Constraints
- Rate limit: 100 req/s
- Idempotency keys required for POST

## Webhook Events
- charge.succeeded
- charge.failed

Camada 2: Integration Adapter (reservado)

Execucao programatica contra a integracao. Agentes poderao interagir com APIs externas atraves de adapters padronizados.

Estado: planejado, nao implementado

Camada 3: Integration Secrets/Config (reservado)

Gerenciamento seguro de credenciais e configuracao sensivel.

Estado: planejado, nao implementado

Integracoes suportadas (MCP activation)

O looply ativa contexto para 7 servicos:

Servico	Tipo	Contexto
GitHub	VCS	Repos, PRs, issues, actions
Kubernetes	Orquestracao	Pods, deployments, services
Linear	Project management	Issues, ciclos, times
MySQL	Banco de dados	Schema, queries, performance
PostgreSQL	Banco de dados	Schema, queries, performance
ELK	Observabilidade	Logs, metricas, alertas
Grafana	Monitoramento	Dashboards, alertas

Seguranca

• Zero credenciais: o looply nunca le nem persiste secrets
• Contexto estatico: analise de schema de banco e feita sem conexao (Camada 1)
• Markdown apenas: integration context nao executa codigo contra APIs
• User-owned: arquivos de integracao sao criados e mantidos pelo usuario

Templates

O template integration-context.template.md define a estrutura padrao para novas integracoes:

# <Integration Name>

## Overview
Brief description of the integration.

## API Base URL
https://api.example.com

## Authentication
How to authenticate (never include secrets).

## Key Endpoints
- METHOD /path — description

## Constraints
- Rate limits
- Quotas
- Regional availability

## Related Resources
- Links to docs, dashboards, runbooks

Evolucao prevista

Versao	Escopo
v1 (atual)	Contexto Markdown, comandos add/list/configure
v2 (planejado)	Integration adapter com execucao programatica
v3 (planejado)	Secrets/config com gerenciamento seguro