Implements durable chat and generation state persistence for TanStack AI applications.
npx skills add https://github.com/TanStack/ai --skill ai-persistence
Please help me install this Agent Skill. Skill: ai-persistence Source: https://github.com/TanStack/ai/tree/main/packages/ai-persistence/skills/ai-persistence Command: npx skills add https://github.com/TanStack/ai --skill ai-persistence
TanStack AI conversations and generated media disappear on reloads, server restarts, and multi-device use unless you persist them. This Skill guides you through wiring server-side chat persistence (withPersistence), client-side persistence, and the store contracts so conversations, runs, interrupts, and generated artifacts survive across sessions and devices.
withPersistence middleware with MessageStore, RunStore, InterruptStore, and MetadataStore contracts against your own database (Postgres, SQLite, D1, Mongo, Prisma, Drizzle).runPersistenceConformance testkit.withPersistence into the chat route, and verify idempotency invariants with the conformance suite.Ask the AI to add TanStack AI server-side chat persistence to your app using the database it already runs, wiring withPersistence into the chat route.
High-intent search queries and answers about installing and using this skill.
Implement the MessageStore, RunStore, InterruptStore, and MetadataStore contracts against your existing database, assemble them with defineAIPersistence, and pass the result to the withPersistence middleware in your chat route. The package ships contracts and an in-memory reference backend, not a database adapter.
Delivery durability reconnects a client to a stream still running, using memoryStream or @tanstack/ai-durable-stream. State persistence saves the conversation itself via withPersistence and the store contracts. They share no code, and production apps often use both.
No, it ships only the store interfaces, the middleware, an in-memory reference backend, and a conformance testkit. You implement the stores against whatever database you already run, such as Postgres, SQLite, D1, or MongoDB, and own the schema and migrations.
The factory must be annotated with a named shape like ChatPersistence, not the bare all-optional AIPersistence type, or withPersistence rejects it because stores.messages may be undefined. Also note stores accepts only messages, runs, interrupts, and metadata keys.
Provide both an ArtifactStore for metadata and a BlobStore for bytes to withGenerationPersistence; the middleware stores media at blob key artifacts/<runId>/<artifactId>. Recipes cover R2 plus D1 on Cloudflare Workers, with sketches for S3, GCS, Vercel Blob, and Supabase.
Run the runPersistenceConformance testkit from @tanstack/ai-persistence/testkit against a throwaway database. It checks full-overwrite saveThread, insert-if-absent createOrResume and interrupt create, list ordering, and composite-key handling; declare intentional omissions with skip or skipMethods.
skilld-devConfigure Vue 3 apps with TanStack AI useChat and clientTools for streaming conversations.
javierd009Implement Supabase authentication and persistent memory storage for multi-tenant SaaS apps.
yashs33244Save git state and session summaries into gstack-managed artifacts.
shotleybuilderImplement a custom IndexedDB adapter for persistent offline storage in ElectricSQL and TanStack DB.