Skip to content

Skill Synapse Layer para Hermes Agent - Rafa Martins#6

Open
rafacpti23 wants to merge 6 commits intoSynapseLayer:mainfrom
rafacpti23:main
Open

Skill Synapse Layer para Hermes Agent - Rafa Martins#6
rafacpti23 wants to merge 6 commits intoSynapseLayer:mainfrom
rafacpti23:main

Conversation

@rafacpti23
Copy link
Copy Markdown

🧠 Synapse Layer Skill for Hermes Agent

This pull request introduces a complete integration skill connecting Hermes Agent with Synapse Layer — a zero-knowledge persistent memory layer.


✨ Features

  • ⚙️ Guided setup for the Synapse Layer MCP server
  • 🔐 Step-by-step authentication configuration
  • 🧩 10 structured memory categories for persistent storage:
    • User Profile
    • User Projects
    • Server Infrastructure
    • API Credentials
    • MEL-IA Configuration
    • Voice Call System
    • Active Skills
    • Pending Tasks
    • Decisions
    • Error Patterns
  • ♾️ Persistent memory across sessions and Hermes channels

🚀 Why This Matters

Hermes Agent already supports Synapse Layer natively via the MCP protocol.
This skill simplifies the entire setup process, enabling users to quickly leverage secure, encrypted, and persistent memory without friction.


📂 Files Included

  • SKILL.md → Full skill documentation (with credits)
  • README.md → Installation and usage guide (English)

👤 Credits

Rafa Martins
🌐 ramelseg.com.br
📧 rafacpti@gmail.com
📱 +55 27 99908-2624


🇧🇷 Skill Synapse Layer para Hermes Agent

Este pull request adiciona uma skill completa de integração entre o Hermes Agent e o Synapse Layer — uma camada de memória persistente com criptografia zero-knowledge.


✨ Funcionalidades

  • ⚙️ Guia de configuração do servidor MCP do Synapse Layer
  • 🔐 Instruções passo a passo para autenticação
  • 🧩 10 categorias de memória estruturadas:
    • Perfil do Usuário
    • Projetos do Usuário
    • Infraestrutura do Servidor
    • Credenciais de API
    • Configuração MEL-IA
    • Sistema de Chamadas de Voz
    • Skills Ativas
    • Tarefas Pendentes
    • Decisões
    • Padrões de Erro
  • ♾️ Memória persistente entre sessões e canais do Hermes

🚀 Por que isso é importante

O Hermes Agent já possui suporte nativo ao Synapse Layer via protocolo MCP.
Esta skill torna o processo de configuração simples, permitindo o uso rápido de memória persistente, segura e criptografada.


📂 Arquivos incluídos

  • SKILL.md → Documentação completa da skill (com créditos)
  • README.md → Guia de instalação e uso (em inglês)

👤 Créditos

Rafa Martins
🌐 ramelseg.com.br
📧 rafacpti@gmail.com
📱 +55 27 99908-2624

Removed phone number from credits and user profile section. Updated server and API credentials to use variable placeholders.
@SynapseLayer
Copy link
Copy Markdown
Owner

Olá @rafacpti23, que trabalho fenomenal de documentação! As 10 categorias de memória e o detalhamento do Security Pipeline estão perfeitos. Isso é exatamente o que precisamos para o ecossistema.

No entanto, temos um upgrade importante de última hora:

  1. MCP Loop Fixed: O erro de Unknown SSE event: endpoint que você mencionou foi resolvido com a adoção da Bridge oficial via mcp-remote. Não precisamos mais recomendar o fallback via CURL.
  2. Native Mode: Queremos transformar esse seu guia no "Manual do Hermes Native Mode".
  3. Ajuste de Segurança: No Synapse Layer, prezamos por Zero PII no repositório. Peço que remova seus dados pessoais (e-mail/telefone) de dentro dos arquivos .md. Seus créditos como autor serão mantidos no histórico do GitHub e podemos colocar seu handle (@rafacpti23) no topo.

Você aceita o desafio de atualizar este PR para o padrão v2.1?
Basicamente:

  • Trocar o "Setup" para usar a nossa Bridge estável.
  • Remover a seção de "Known Issues" (já que a Bridge resolve).
  • Alinhar a narrativa para "1-line config".

Me avise se topa e eu te mando o blueprint técnico para você ser o autor dessa evolução oficial! 🚀

@SynapseLayer SynapseLayer marked this pull request as draft April 21, 2026 22:38
@rafacpti23
Copy link
Copy Markdown
Author

Claro, vamos evoluir e avançar.

@rafacpti23 rafacpti23 marked this pull request as ready for review April 22, 2026 03:21
@SynapseLayer
Copy link
Copy Markdown
Owner

@rafacpti23 — desculpa o silêncio dessas semanas. Foi falha minha, não tua.
Vou te entregar o blueprint agora.

Blueprint v2.1 — Manual do Hermes Native Mode

1. Setup (substituir seção atual)

Remover instruções com npx + CURL. Substituir por:

{
  "mcpServers": {
    "synapse-layer": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://synapse-proxy-sl.fly.dev/api/mcp",
        "--header",
        "Authorization: Bearer ${SYNAPSE_TOKEN}"
      ],
      "env": {
        "SYNAPSE_TOKEN": "<​seu-token-aqui>"
      }
    }
  }
}

@SynapseLayer
Copy link
Copy Markdown
Owner

@rafacpti23 obrigado pelo PR sólido — skill bem estruturada, créditos OK, CI passando ✅

Antes do merge preciso de uma correção pra manter a política CLAIM=REALITY que aplicamos no AUDIT2 (commit b748400 do core, mergeado hoje):

🔴 Remover claims de "zero-knowledge" — o Synapse Layer usa AES-256-GCM encryption at rest, não zero-knowledge. O servidor processa plaintext em memória durante store/recall, então a narrativa correta é "encrypted at rest", não "zero-knowledge".

Ajustes necessários:

  1. README.md (inglês):

    • Remover: "zero-knowledge persistent memory layer"
    • Usar: "persistent memory layer with AES-256-GCM encryption at rest"
  2. SKILL.md (português):

    • Remover: "memória persistente com criptografia zero-knowledge"
    • Usar: "memória persistente com criptografia AES-256-GCM em repouso"
  3. Adicionar referência ao repo oficial no topo do README — ex.:
    "Built on Synapse Layer (https://github.com/SynapseLayer/synapse-layer) — persistent memory infrastructure for AI agents, AES-256-GCM encrypted at rest, semantic search, MCP-native."

Após esses ajustes mergeio na hora. A skill em si está excelente — só preciso manter consistência narrativa em todos os repos da org pra não reintroduzir claim que acabei de remover dos 4 repos principais.

Valeu pelo trabalho! 🙏

rafacpti23 added 2 commits May 8, 2026 19:31
Updated descriptions and added encryption details for memory persistence and security. Reformatted agent rules and integration sections for clarity.
@rafacpti23
Copy link
Copy Markdown
Author

Substituí referências a zero-knowledge por AES-256-GCM em repouso
e adicionei o link oficial do repositório no topo do README.
Mantive toda a funcionalidade e exemplos.

@rafacpti23 rafacpti23 closed this May 8, 2026
@rafacpti23 rafacpti23 reopened this May 8, 2026
@rafacpti23
Copy link
Copy Markdown
Author

rafacpti23 commented May 8, 2026 via email

@SynapseLayer
Copy link
Copy Markdown
Owner

Opa Rafa, recebido 🙏

Vi os commits e o último ajuste com encryption/usage details no SKILL.md — direção correta.

Status atual:
✅ Commits chegaram
⚠️ A branch está com conflito em README.md e SKILL.md com a main atual

Vou revisar o diff completo e, se estiver tudo alinhado com a copy e claims do projeto, eu mesmo resolvo os conflitos pelo GitHub e sigo com o merge.
Não precisa fazer nada agora.

Depois do merge eu te aviso aqui para você sincronizar sua branch local com a main.

Valeu pelo push 🚀
— Ismael

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants