@thaliq/sdk) es una libreria headless que te da control programatico completo sobre los agentes de IA. A diferencia del widget (que incluye UI), el SDK expone todo como APIs para que construyas tu propia experiencia.
v1.1 — Feedback, Handoff, Insights, y nuevos eventos SSE. Ver Changelog.
Caracteristicas
Streaming
Respuestas en tiempo real via
AsyncIterable. Consume eventos con for await.Human-in-the-Loop
Acciones interactivas (consent, confirm, select, form) con helpers programaticos.
Feedback e Insights
Califica respuestas y recibe insights extraidos automaticamente del contexto.
Handoff a humano
Detecta cuando la conversacion se escala a un agente humano.
Identidad de usuario
Identifica usuarios autenticados para acceder a tools protegidas y MCP Servers.
Conversaciones
Auto-tracking de threads con continuidad entre mensajes.
Retry automatico
Reintentos con exponential backoff para errores transitorios.
Zero dependencias
~3KB gzip. Solo APIs nativas del runtime (
fetch, SSE parsing).Widget vs SDK
| Aspecto | Widget | SDK |
|---|---|---|
| Tipo | UI Component (chat flotante) | Headless Client (sin UI) |
| Uso | Sitios web con chat embebido | Apps con logica custom |
| Autenticacion | Solo API Key (anonimo) | API Key + Identidad de usuario |
| Tools | Solo publicas (requiresAuth: false) | Todas las habilitadas |
| Streaming | Interno (renderiza en el chat) | Expuesto como AsyncIterable |
| HITL | Cards visuales automaticas | Eventos programaticos |
| Feedback | Thumbs up/down integrado | API programatica |
| Target | Browser only | Node.js + Browser + Deno + Bun |
Cuando usar el SDK
- Tu app tiene usuarios autenticados que necesitan acceder a datos privados
- Necesitas control total sobre la UI y la experiencia del chat
- Quieres integrar agentes en flujos de backend (Node.js, APIs)
- Necesitas manejar acciones interactivas (HITL) con tu propia UI
- Quieres tracking por usuario y feedback en las metricas
Disponibilidad por plan
| Plan | SDK disponible |
|---|---|
| Starter | — |
| Growth | Incluido |
| Enterprise | Incluido |
Compatibilidad
| Runtime | Version minima |
|---|---|
| Node.js | 18+ (fetch nativo) |
| Browsers | Chrome 89+, Firefox 89+, Safari 15+ |
| Deno | 1.28+ |
| Bun | 1.0+ |
Siguiente paso
Instalacion
Instala el SDK y envia tu primer mensaje en 2 minutos.