Começar · README.md

Kit eve + Access#

Conteúdo público, sem credenciais ou dados de contas. Não é um SDK oficial do eve. Contrato v2: configure ACCESS_ORGANIZATION_ID além de ACCESS_BASE_URL. Os clientes conferem a organização antes de devolver identidade; sessões e credenciais devem ser associadas a organização + usuário + issuer.

Para um agente implementador#

Leia SKILL.md e siga seus links. A skill explica a tarefa, os limites e a ordem de implementação. AGENTS.md serve de ponto de entrada para editores/agentes.

O template de agente eve já traz esta skill. Para um projeto eve que você já tem, baixe só a skill (eve-access-integration.zip, nas telas Integração, Minhas sessões e na documentação do Access) e descompacte o ZIP no diretório de skills do seu agente de código, na raiz do projeto. O ZIP cria só a pasta eve-access-integration/, com um manifest.json de checksums:

text
<projeto-do-agente>/.claude/skills/eve-access-integration/   # Claude Code
<projeto-do-agente>/.agents/skills/eve-access-integration/   # Codex e outros

Não sobrescreva skills ou instruções existentes sem revisar o diff. Se seu editor usa outro diretório, siga a documentação dele ou forneça diretamente o caminho do SKILL.md no prompt. Não é necessário instalar a skill no runtime do eve; ela é para o agente que modifica o código.

Conteúdo#

  • SKILL.md: procedimento de implementação.
  • AGENTS.md: entrada para quem vai trabalhar no projeto.
  • references/integration.md: contrato, login e armazenamento, canal e ferramenta.
  • references/runtime-instructions.md: texto adaptável para o agente de negócio.
  • references/acceptance.md: matriz de testes e limites.
  • examples/access-client.ts: cliente de identidade, guard de papel e login (pelo navegador ou por senha).
  • examples/eve-access.ts: adaptador de canal eve com interface para cofre seguro.
  • tests/access-client.test.mjs: testes de mock executáveis.
  • references/browser-login.md: login pelo navegador, com link e retorno automático, código colado no agente ou retorno ao callback do login interativo do eve (pedido de entrada na própria conversa, em qualquer canal).
  • examples/eve-access-login.ts: provedor defineInteractiveAuthorization do eve 1.0+ e guards identify/requireRole para ferramentas.
  • tests/browser-login.test.mjs: testes simulados desse fluxo no cliente.
  • references/channels.md: fluxo real de vínculo para canais externos.
  • examples/channel-access-client.ts: cliente servidor para o adaptador do canal.
  • examples/eve-channel-access.ts: principal e guard de papel para canais eve (Telegram, Slack) com webhook validado.
  • tests/channel-access-client.test.mjs: testes simulados adicionais desse cliente.

Verificação#

Com Node 22.18+ e sem dependências adicionais:

sh
node --test tests/*.test.mjs

Os testes não chamam o Access e não executam um agente eve. No projeto de destino, são obrigatórios o adaptador real do cofre, a ACL de sessões, a operação de negócio e os testes com a versão instalada do framework. Ao copiar os exemplos para um projeto eve, remova a extensão .ts dos imports entre eles: o projeto criado pelo eve não habilita allowImportingTsExtensions. A extensão existe aqui só para os testes rodarem direto no Node.