> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Chat AI e assistente

Thread di chat in streaming ed esecuzioni singole dell'agente sull'API condivisa.

## I thread di chat usano il contratto web

Il tab chat chiama la stessa superficie REST dell'app browser: lista e creazione su /api/chat/threads, e lettura, rinomina o eliminazione su /api/chat/threads/:id. I titoli sono normalizzati al limite condiviso di 120 caratteri e la lista dei thread è coperta dalla cache di lettura offline.


## Risposte in streaming

Le risposte arrivano in streaming tramite POST /api/chat/stream su expo/fetch; i frame server-sent diventano eventi chunk, done o error e i frame malformati vengono saltati. Gli alias dei modelli sono fast, smart e cheap — fast è il default — un flag structuredOutput inoltra il requisito corrispondente, e il controllo di stop interrompe la richiesta in corso.


## Esecuzioni singole dell'agente

La schermata nascosta assistant invia {alias, prompt, workspaceId, maxSteps: 4} a /api/v1/agent-runs — una singola esecuzione con budget nel workspace attivo. Il client valida la risposta in modo stretto e rifiuta un'esecuzione attribuita a un workspace diverso. Rate limit, accesso, entitlement mancante e risposte forbidden mappano ciascuno a uno stato diverso, e la cronologia delle esecuzioni conserva le ultime dieci nella memoria di sessione con formattazione dei costi esatta in microunità.


## Verifica e risoluzione dei problemi

Testa uno stream annullato, una sessione revocata a metà esecuzione, un workspace con entitlement e uno bloccato, e il comportamento in modalità aereo sulla lista dei thread in cache. Un'esecuzione negata dal server deve emergere come lavoro non disponibile, mai come una risposta vuota silenziosa.


## Successivo

[Notifiche e push](https://supastack.dev/it/docs/mobile/notifications.md)