The Pulse
TanStack AI 1.0 stabilizza le API principali, mentre l’harness per agent resta sperimentale
TanStack AI 1.0 rende stabili le sue API principali, mentre il nuovo harness per agent resta sperimentale. La versione aggiunge funzionalità e integrazioni, e le istruzioni per l’aggiornamento distinguono i pacchetti stabili da quelli speri
AI.info Team · Scritto con l’IA · verificato ·
«Le API principali sono stabili e pronte per l’uso in produzione».
Alem Tuzlak, Jack Herrington, Tom Beckenham e Tanner Linsley, autori dell’annuncio di TanStack
Le API principali arrivano alla versione 1.0
TanStack ha annunciato il 23 ottobre la versione 1.0 del suo toolkit per l’IA. La nuova versione formalizza l’impegno a mantenere stabili le API su cui gli sviluppatori costruiscono le proprie applicazioni, mentre il nuovo harness per agent resta sperimentale. La proposta centrale del progetto è lasciare agli sviluppatori la scelta del provider di modelli, del framework applicativo, della sandbox e del protocollo di comunicazione.
TanStack AI è passato da una versione alpha con una funzione di chat e quattro provider a un toolkit per chat, strumenti, contenuti multimediali, Model Context Protocol (MCP), persistenza, sandbox e agent. L’annuncio elenca 23 adapter per provider, oltre a un adapter openaiCompatible per le API in stile OpenAI. Tra le opzioni per l’interfaccia utente cita React, Vue, Solid, Svelte, Preact, Angular, Octane, Remix e JavaScript puro, ed elenca 11 provider di sandbox.
La versione include anche integrazioni con agent di programmazione per Claude Code, Codex, OpenCode, Grok Build e agent che usano l’Agent Client Protocol. Secondo TanStack, più di 140 persone hanno contribuito alla realizzazione del toolkit. L’annuncio descrive la versione 1.0 come priva di nuovi concetti per gli utenti esistenti: le API contrassegnate come deprecate nella serie 0.x sono state rimosse e le relative sostitute erano già state distribuite nella serie 0.x.
Le funzionalità aggiunte dopo la release candidate
TanStack elenca diverse aggiunte successive alla release candidate di agosto 2026. Gli sviluppatori possono affidare i turni in chat() o useChat ad agent secondari identificati per nome, come un ricercatore o un autore, con input tipizzati e limiti. Tra le altre funzionalità per gli agent figurano le Agent Skills portabili, che consentono ai modelli capaci di chiamare strumenti di caricare file SKILL.md, e l’uso del computer compatibile con OpenAI e Anthropic.
La versione aggiunge anche decide() per scelte tipizzate, punteggi e decisioni booleane; la compattazione per aiutare a mantenere le chat lunghe entro i limiti di contesto; e opzioni di chat per il ragionamento e i nuovi tentativi. L’annuncio descrive la memorizzazione automatica dei prompt nella cache, il supporto alla modifica degli strumenti o dei prompt di sistema nel corso di una conversazione senza perdere la cache e una cronologia riproducibile su modelli diversi. Una Files API offre un’unica interfaccia per i file di ciascun provider.
Tra le altre aggiunte figurano adapter per Cloudflare Workers AI e AI Gateway, Lovable AI Gateway, Azure OpenAI, World Labs Marble, TypeSafe e Ollaya. TanStack segnala inoltre il supporto per Remix 3, gli strumenti di sviluppo per Svelte e cinque provider di sandbox: Blaxel, Upstash Box, E2B, boxd e Railway. I suoi test end-to-end vengono eseguiti su ogni pull request usando fixture deterministiche per i modelli, senza chiamate API effettive.
L’aggiornamento distingue i pacchetti stabili da quelli sperimentali
I team che aggiornano dalla serie 0.x dovrebbero portare insieme alla versione 1.0 i loro pacchetti stabili @tanstack/ai*: un client 1.0 richiede un server 1.0. I pacchetti sperimentali dell’harness restano nella serie 0.x, quindi l’indicazione non si applica a ogni pacchetto che segue quello schema di denominazione. TanStack mette a disposizione un codemod per le ridenominazioni più comuni, tra cui il passaggio da body a forwardedProps e da conversationId a threadId.
La nuova API richiede un ID del thread sia nel browser sia sul server; nessuno dei due lo crea automaticamente. Gli sviluppatori che usano @tanstack/ai-react-ui, @tanstack/ai-solid-ui o @tanstack/ai-vue-ui devono rimuovere questi pacchetti, che non avranno versioni 1.0. I team che conservano chat, esecuzioni o file creati con la serie 0.x dovrebbero seguire i passaggi indicati da TanStack per la migrazione dei dati salvati prima della distribuzione.
L’harness per agent resta sperimentale
TanStack afferma che @tanstack/ai-harness e @tanstack/ai-harness-cli vengono distribuiti come versioni 0.x. Anche gli entry point dell’harness in altri pacchetti, tra cui @tanstack/ai-skills/harness e @tanstack/ai-acp/agent, sono sperimentali e potrebbero cambiare in una versione minore. Il progetto afferma di voler far provare l’harness agli sviluppatori prima di definire in via definitiva le sue API; l’harness è separato dalle API principali stabili della versione 1.0.
Questa distinzione definisce la portata pratica dell’annuncio: gli sviluppatori possono costruire applicazioni sulle API principali stabili, considerando però le interfacce dell’harness ancora in fase di sviluppo. Per le applicazioni esistenti, le indicazioni per l’aggiornamento si concentrano sull’allineamento delle versioni stabili di client e server, sulla rimozione dei pacchetti per l’interfaccia utente non più distribuiti, se utilizzati, e sulla migrazione dei dati salvati quando necessario.