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:
<projeto-do-agente>/.claude/skills/eve-access-integration/ # Claude Code
<projeto-do-agente>/.agents/skills/eve-access-integration/ # Codex e outrosNã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: provedordefineInteractiveAuthorizationdo eve 1.0+ e guardsidentify/requireRolepara 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:
node --test tests/*.test.mjsOs 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.