> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thaliq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SDK

> Libreria headless y type-safe para integrar agentes de Thaliq en tus aplicaciones

El SDK de Thaliq (`@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.

<Note>
  **v1.1** — Feedback, Handoff, Insights, y nuevos eventos SSE. Ver [Changelog](/sdk/changelog).
</Note>

## Caracteristicas

<CardGroup cols={2}>
  <Card title="Streaming" icon="bolt">
    Respuestas en tiempo real via `AsyncIterable`. Consume eventos con `for await`.
  </Card>

  <Card title="Human-in-the-Loop" icon="hand-pointer">
    Acciones interactivas (consent, confirm, select, form) con helpers programaticos.
  </Card>

  <Card title="Feedback e Insights" icon="thumbs-up">
    Califica respuestas y recibe insights extraidos automaticamente del contexto.
  </Card>

  <Card title="Handoff a humano" icon="headset">
    Detecta cuando la conversacion se escala a un agente humano.
  </Card>

  <Card title="Identidad de usuario" icon="user-shield">
    Identifica usuarios autenticados para acceder a tools protegidas y MCP Servers.
  </Card>

  <Card title="Conversaciones" icon="messages">
    Auto-tracking de threads con continuidad entre mensajes.
  </Card>

  <Card title="Retry automatico" icon="rotate">
    Reintentos con exponential backoff para errores transitorios.
  </Card>

  <Card title="Zero dependencias" icon="feather">
    \~3KB gzip. Solo APIs nativas del runtime (`fetch`, SSE parsing).
  </Card>
</CardGroup>

## 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

El SDK esta **disponible en todos los planes**. Lo que cambia entre planes son los limites de uso (resoluciones, agentes, modelos disponibles, RAG/MCP). Ver [Planes y limites](/introduction/plans) para el detalle.

## Compatibilidad

| Runtime  | Version minima                      |
| -------- | ----------------------------------- |
| Node.js  | 18+ (fetch nativo)                  |
| Browsers | Chrome 89+, Firefox 89+, Safari 15+ |
| Deno     | 1.28+                               |
| Bun      | 1.0+                                |

## Siguiente paso

<Card title="Instalacion" icon="download" href="/sdk/installation">
  Instala el SDK y envia tu primer mensaje en 2 minutos.
</Card>