Conectar DeepSeek Harness a Buzz: Pasarela de Nostr

El plugin de DeepSeek Harness (DSH), dsh-message-gateway, extiende el asistente de DeepSeek Harness a múltiples plataformas de mensajería como Discord, Telegram y WeChat. El repositorio del plugin fue bifurcado y ampliado para incorporar la plataforma Cómo autoalojar Buzz de Block: Espacio de trabajo para agentes IA a la lista. El repositorio bifurcado está disponible en GitHub en https://github.com/Tech-Voyage-Dev/dsh-message-gateway.

Guía de requisitos previos

Cómo autoalojar Buzz de Block: Espacio de trabajo para agentes IA

Aprenda a autoalojar el relay de Buzz en un VPS con Ubuntu detrás de Cloudflare. Crea un espacio de trabajo seguro donde humanos y agentes de IA colaboran.

12 MIN DE LECTURA

El asistente de DSH se une a un relay de Buzz como miembro, recibe mensajes directos (DM) y mensajes de canal en los que se le @menciona, y responde mediante el mismo pipeline de agentes por chat que utiliza la interfaz web.

Arquitectura del plugin dsh-message-gateway

La arquitectura del plugin dsh-message-gateway se divide en dos componentes principales:

• Host (Node): gateway-store (credenciales, ~/.dsh/gateway.json), platforms.ts (definiciones de plataformas y pruebas de conectividad), routes.ts (endpoints /gateway/*) y bridge-manager.ts (los puentes residentes: sesiones de agentes independientes por chat y respuestas en streaming).
• Cliente (navegador): la página "Message platforms" en la barra lateral, donde se guardan credenciales, se prueban conexiones y se monitoriza el estado del servicio.

Añadir una nueva plataforma implica los siguientes pasos:

1. Una clase de puente (bridge): métodos start/stop/status junto con un callback onText(text, frame), reflejando la estructura de wecom-bridge.ts.
2. Conexión en bridge-manager: reutilizar el pipeline por chat existente (ensureAgentForKey + pendingMap) e integrar el receptor de respuestas de la plataforma.
3. Persistencia y rutas: en /gateway/save y /gateway/delete: guardar credenciales inicia el puente, eliminarlas lo detiene, además de una bandera autoStartXxx para que dsh web reconecte automáticamente al arrancar.

Implementación del puente Buzz: Protocolo Nostr y ciclo de vida de eventos

Se utilizó DeepSeek Harness para implementar el puente hacia Buzz. La implementación se ajusta a las siguientes especificaciones del protocolo Nostr:

El siguiente diagrama ilustra el proceso de inicialización (bootstrap) del puente hacia Buzz:

Streaming en tiempo real mediante ediciones in situ de Nostr (Kind 40003)

Nostr no cuenta con indicador nativo de escritura y sus eventos son de solo adición. Para ofrecer una experiencia interactiva y dinámica, el puente de Buzz simula streaming mediante ediciones in situ:

• El puente de Buzz publica primero un evento marcador de posición kind 9, luego lo reescribe progresivamente con ediciones in situ kind 40003 limitadas por frecuencia, y finalmente asienta la edición definitiva cuando el agente concluye su respuesta. Este mecanismo reproduce el patrón utilizado en los puentes de Telegram y Discord.

Vinculación de espacios de trabajo de DeepSeek Harness mediante comandos de chat

La funcionalidad de "Workspaces" en la interfaz web de DSH está respaldada por el servicio workspaceRegistry (@deepseek-ai/dsh-workspace):

const existing = await ctx.workspaceRegistry.resolveByPath(request.path);

El puente de Buzz ofrece el comando de chat /workspace <carpeta>, que registra un directorio existente en DSH. Cualquier nueva sesión creada a través de la pasarela se vincula a dicha carpeta y se refleja en la interfaz web.

Tres consideraciones de diseño relevantes:

• Cambiar de carpeta implica una nueva sesión. El valor cwd se fija en la cabecera de la sesión al crearse y no puede modificarse posteriormente.
• La carpeta debe existir previamente. El método create rechaza rutas inexistentes.
• Comando sensible a la seguridad. Cada sesión opera con una directiva de auto-aprobación, otorgando acceso de lectura y ejecución en el directorio indicado.

Guía paso a paso de instalación y configuración

1. Ejecute los siguientes comandos en la terminal:

dsh plugin --profile web add https://github.com/Tech-Voyage-Dev/dsh-message-gateway.git

# Start DSH web
dsh web

2. Una vez que la interfaz web de DSH se abra en el navegador, haga clic en el icono "Message platforms":

3. Seleccione "Buzz" en el panel lateral izquierdo:

4. Haga clic en "Generate keypair" para generar un par de claves Nostr. Copie la clave pública npub en un lugar seguro para los pasos siguientes.
5. Ingrese la Relay URL y los Channels (la lista de UUIDs de canales permitidos para suscribirse).
6. Presione el botón "Save".

Al guardar el formulario se almacenan las credenciales y se inicia el puente. La clave privada nsec se trata como un secreto estricto y se guarda exclusivamente en ~/.dsh/gateway.json.

Registro del par de claves del agente en el relay Nostr de Buzz

Añada el asistente de DSH al relay como miembro. Utilice la clave npub generada previamente:

docker compose exec relay buzz-admin add-member --pubkey npub123123123

Incorpore el asistente a un canal específico. Registrar un miembro en el relay no lo hace visible ni localizable de forma automática en los canales. Para agregarlo mediante buzz-cli, tenga en cuenta que el parámetro --pubkey debe especificarse en formato HEX, no npub (el comando buzz-admin add-member imprime la clave HEX correspondiente):

buzz channels add-member --channel <CHANNEL_UUID> --pubkey <AGENT_HEX> --role member

Guía de CLI

Cómo instalar y usar buzz-cli

Instrucciones paso a paso para instalar y configurar buzz-cli para gestionar canales de Nostr, claves de miembros y permisos de agentes de IA.

5 MIN DE LECTURA

Actualice el perfil del asistente en el relay Nostr asignándole un nombre descriptivo con buzz-cli:

Envíe un saludo Wave (el saludo inicial de Buzz para mensajes directos) al asistente. La respuesta confirma la conexión:

Envío de un Wave como mensaje directo al asistente de DSH: el puente está operativo.

Habilitación del acceso a carpetas locales con /workspace

Debido a que el parámetro allowWorkspace está deshabilitado (false) por defecto, el comando /workspace será rechazado inicialmente:

Habilítelo en ~/.dsh/profiles/web/cordis.patch.yml y reinicie dsh web:

- id: ui-message-gateway
  config:
    allowWorkspace: true

Tras reiniciar el servicio:

Nota importante: este comando asume que el directorio del workspace (TechVoyage en las capturas) reside dentro del directorio predeterminado del usuario. De lo contrario, indique la ruta absoluta completa. Cualquier nueva sesión creada bajo este workspace desde Buzz aparecerá también en la interfaz web de DeepSeek Harness.

Comandos disponibles en Buzz

Todas las funcionalidades y comandos disponibles en las demás plataformas están plenamente soportados en Buzz:

Aspectos clave de seguridad

• La clave privada nsec reside únicamente en ~/.dsh/gateway.json (permisos 0600, escritura atómica) — nunca se expone en endpoints como /gateway/list ni en registros de depuración.
• Cada evento entrante es verificado criptográficamente (verifyEvent), deduplicado, filtrado contra mensajes propios y evaluado por reglas de mención antes de llegar al agente.
• El registro de workspaces está restringido por configuración (allowWorkspace: false por defecto), garantizando control estricto sobre sesiones automáticas con acceso a archivos locales.

Conclusión: Colaboración descentralizada con agentes IA en Buzz

El desafío central al integrar Buzz en dsh-message-gateway radicó en implementar fielmente el contrato de eventos del protocolo Nostr. La arquitectura base del plugin ya ofrecía una sólida gestión de sesiones independientes y enrutamiento de comandos, permitiendo una integración fluida en cuanto se resolvieron el manejo de eventos y el streaming interactivo.

Referencias:

• dsh-message-gateway architecture guide — guía de arquitectura, extensiones y notas de seguridad
• nostr-tools — librería Nostr utilizada internamente
• deer-flow IM channel connections — patrones de referencia para conexiones de canales de mensajería instantánea