| Transporte |
Un WebSocket autenticado mediante NIP-42; por defecto
ws://localhost:3000
;
http(s)://
se normaliza a
ws(s)://
|
|---|---|
| Autenticación |
Evento AUTH
kind 22242
, etiquetas
[["relay", url], ["challenge", challenge]]
, contenido vacío, firmado con la clave privada del agente
|
| Suscripciones |
Por canal
:
REQ {"kinds":[9], "#h":[
— un REQ por canal. Un REQ global
kinds:[9]
recibe EOSE pero nunca difunde eventos; el filtro
#h
con múltiples valores
no
funciona
|
| Descubrimiento |
REQ {kinds:[39000]}
histórico para metadatos de canal (
type == "dm"
identifica canales de mensajes directos)
|
| Membresía |
REQ {kinds:[44100,44101], "#p":[nuestra pubkey], since: now-60s}
en tiempo real — 44100 = añadido, 44101 = eliminado, portando
p
+
h
; actualiza suscripciones
sin reconectar
|
| Eventos de chat |
kind 9
con etiquetas
["h", canal]
, opcional
["e", replyTo]
,
["p", mención]
|
| Ediciones in situ |
kind 40003
con
h
+
e
→objetivo; sustituye contenido; límite de 64 KB en relay → mantener payloads ≤ 60.000 B; respuestas grandes se fragmentan — el fragmento 0 viaja en la edición y los sobrantes se añaden como mensajes
kind 9
en hilo (
e
→raíz)
|
| Tramas CLOSED |
auth-required
antes de AUTH es normal durante el arranque (completar AUTH y reabrir subs); tras AUTH → reintento delimitado (3 intentos, backoff 0/1/2 s); reconectar reconstruye todo
|
| Límites de relay |
≤ 2000 eventos históricos por suscripción, ordenados del más reciente al más antiguo incluso usando
since
|
| Control de menciones |
Procesa
kind 9
entrantes solo cuando: (a) la etiqueta
p
incluye nuestra pubkey, (b) el canal es DM, o (c) la raíz
e
es nuestro propio evento. Ignora nuestra pubkey (anti-bucle)
|
| Menciones salientes |
El texto saliente se publica tal cual — el relay no valida tokens
@
; las etiquetas
p
incluyen al autor entrante más hasta 7 pubkeys adicionales mencionadas (máx. 8)
|
| Mensajes directos |
Canales de texto plano delimitados al relay (metadatos
type: "dm"
) — sin cifrado NIP-04/44 en este puente
|
| Archivos adjuntos |
NIP-92
imeta
(
url
,
sha256
,
m
) → descarga http(s) estándar, verificación de SHA-256, límite de 20 MB, máx. 4 por mensaje; las imágenes salientes no están soportadas
|
| Comando | Descripción |
|---|---|
/workspace
|
Registra una carpeta existente como espacio de trabajo del chat (requiere habilitación en configuración) |
/help
|
Muestra la lista de comandos disponibles |
/time
|
Informa la hora actual del sistema |
/new
|
Inicia una nueva sesión de conversación limpia |
/clear
|
Limpia el historial de la conversación actual |
/status
|
Muestra el estado operativo del puente |
/stats
|
Muestra estadísticas de chats activos y estado de puentes en todas las plataformas (incluido Buzz) |
/commands
|
Lista descriptiva de cada comando soportado |
@path/to/file
|
Funciona como las menciones web de archivos: el modelo lee el archivo relativo al workspace;
@
,
@prefijo
o
/files
devuelven archivos y carpetas coincidentes
|
/model
|
[provider model effort]
— validado frente al catálogo de modelos LLM activos;
/model
lista opciones disponibles y
/model reset
restablece valores predeterminados
|
/effort
|
modifica exclusivamente el esfuerzo de razonamiento del modelo;
/effort reset
restablece el valor por defecto
|