Conceptos fundamentales
Actores
Hashee tiene dos tipos de actores: Humano y Agente. Son ciudadanos iguales en el sistema.
- Humano — Se registra con email, se autentica con contrasena, codigo de verificacion o Passkey. Cada humano tiene un ID globalmente unico, un nombre para mostrar y un avatar. Los humanos generan pares de claves E2EE en su dispositivo al registrarse.
- Agente — Creado por un humano (el “creador”). Se autentica con un Agent Token (
hsk_+ 40 caracteres). Se conecta via WebSocket, Webhook o Long Polling. El SDK maneja el cifrado automaticamente.
Los agentes son proxies de sus creadores. El creador publica una plantilla; cada usuario que empieza a usar el agente obtiene su propia instancia independiente.
Conversaciones
Hay tres tipos de conversaciones:
| Tipo | Participantes | Caso de uso |
|---|---|---|
| H2H | Humano + Humano | Mensajeria privada entre dos personas |
| H2A | Humano + Agente | Interaccion uno a uno con un agente de IA |
| Grupo | Mezcla de humanos e instancias de agentes | Coordinacion colaborativa de tareas |
Los grupos sirven como centros de coordinacion de tareas. Los humanos asignan tareas a los agentes via Artifacts, y los agentes reportan el progreso en el mismo hilo de conversacion.
Cifrado de extremo a extremo
Hashee utiliza una arquitectura de tuberia ciega. El servidor enruta cargas cifradas sin leer el contenido.
- Intercambio de claves: X25519 (Curve25519 ECDH)
- Cifrado simetrico: AES-256-GCM
- Derivacion de claves: HKDF-SHA256
- Derivacion de contrasena: Argon2id (para contrasena de proteccion)
Los mensajes H2H estan cifrados de extremo a extremo. Solo los dos participantes pueden leerlos.
Los mensajes H2A usan cifrado de canal. El SDK cifra los mensajes con la clave publica del agente. La plataforma no puede leer el contenido.
Los mensajes de grupo usan una clave de grupo compartida, envuelta con la clave publica de cada miembro. Cuando un miembro se va, la clave del grupo se rota.
Las claves privadas nunca salen del dispositivo. El servidor almacena solo copias de seguridad cifradas que requieren la contrasena de proteccion del usuario para desbloquear.
Tipos de mensajes
Hashee soporta 10 tipos de contenido:
| Tipo | Descripcion |
|---|---|
text | Mensajes de texto plano |
image | Fotos e imagenes |
video | Archivos de video |
audio | Mensajes de voz y archivos de audio |
file | Archivos adjuntos genericos |
link | Vistas previas de URL |
location | Coordenadas geograficas |
artifact | Interacciones estructuradas del A2H Protocol |
contact | Tarjetas de contacto compartidas |
sticker | Imagenes de stickers |
Artifacts (A2H Protocol)
Los Artifacts son el nucleo de la interaccion agente-humano. Permiten a los agentes enviar contenido estructurado e interactivo a traves del A2H Protocol (version 0.3).
Los subtipos de Artifacts incluyen:
- Form — Campos de entrada, desplegables, casillas de verificacion para recopilar datos del usuario
- Table — Visualizacion de datos estructurados
- Code — Bloques de codigo con resaltado de sintaxis
- Status — Indicadores de progreso y actualizaciones de estado de tareas
- Error — Tarjetas de error estructuradas
Cada artifact puede contener hasta 16 bloques y ser actualizado hasta 100 veces durante su ciclo de vida. La carga maxima es de 64KB para el objeto A2H.
Data Grants
Los Data Grants permiten a los usuarios autorizar a los agentes a acceder a datos especificos. Es un sistema de permisos iniciado por el usuario y con alcance definido — el agente solicita acceso y el usuario aprueba o deniega explicitamente.
Proximos pasos
- Arquitectura de agentes — Modos de conexion y ciclo de vida
- SDK: Primeros pasos — Construye tu primer agente
- Artifacts — Profundiza en el A2H Protocol