@tanstack/ai-persistence 0.5.5 → 0.5.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-persistence",
-  "version": "0.5.5",
+  "version": "0.5.7",
   "description": "Composable state persistence for TanStack AI messages, runs, interrupts, metadata, and locks.",
   "author": "",
   "license": "MIT",
@@ -43,7 +43,7 @@
   },
   "peerDependencies": {
     "vitest": "^4.1.10",
-    "@tanstack/ai": "^0.52.1"
+    "@tanstack/ai": "^0.54.0"
   },
   "peerDependenciesMeta": {
     "vitest": {
@@ -53,7 +53,7 @@
   "devDependencies": {
     "@vitest/coverage-v8": "4.1.10",
     "vitest": "^4.1.10",
-    "@tanstack/ai": "0.52.1"
+    "@tanstack/ai": "0.54.0"
   },
   "scripts": {
     "build": "vite build",

package/skills/ai-persistence/build-cloudflare-artifact-store/SKILL.md

@@ -28,6 +28,17 @@ type an object literal inline (autocomplete + contract checking, no separate
 annotation).
 
 ```ts
+import type {
+  ArtifactRecord,
+  BlobBody,
+  BlobGetOptions,
+  BlobListOptions,
+  BlobListPage,
+  BlobObject,
+  BlobPutOptions,
+  BlobRecord,
+} from '@tanstack/ai-persistence'
+
 // BlobStore — the byte layer. R2 backs it.
 interface BlobStore {
   put: (

package/skills/ai-persistence/build-custom-adapter/SKILL.md

@@ -259,7 +259,7 @@ inspects your storage.
 You rarely need all four stores at once. Implement what you own and fill the
 rest from another base:
 
-```ts ignore
+```ts
 import { composePersistence, memoryPersistence } from '@tanstack/ai-persistence'
 import { messages, runs } from './my-stores'
 
@@ -307,7 +307,7 @@ This matters more here than anywhere else: there is no reference driver to
 compare against, so the testkit is the only thing standing between a subtle
 idempotency bug and stuck approvals in production.
 
-```ts ignore
+```ts
 import { runPersistenceConformance } from '@tanstack/ai-persistence/testkit'
 import { chatPersistence } from '../src/lib/chat-persistence'
 

package/skills/ai-persistence/build-drizzle-adapter/SKILL.md

@@ -516,7 +516,7 @@ route** — derive the user from the session, never trust a client-supplied id.
 
 ## 5. Verify
 
-```ts ignore
+```ts
 import { runPersistenceConformance } from '@tanstack/ai-persistence/testkit'
 import { chatPersistence } from '../src/lib/chat-persistence'
 

package/skills/ai-persistence/build-prisma-adapter/SKILL.md

@@ -474,7 +474,7 @@ route** — derive the user from the session, never trust a client-supplied id.
 
 ## 5. Verify
 
-```ts ignore
+```ts
 import { runPersistenceConformance } from '@tanstack/ai-persistence/testkit'
 import { chatPersistence } from '../src/lib/chat-persistence'
 

package/skills/ai-persistence/server/SKILL.md

@@ -98,6 +98,9 @@ preserve plain-text and structured-output assistant messages separately when
 those messages use different ids.
 
 ```ts
+import { withPersistence } from '@tanstack/ai-persistence'
+import { persistence } from './persistence'
+
 withPersistence(persistence, {
   snapshotStreaming: true,
   snapshotIntervalMs: 1000, // default
@@ -159,6 +162,8 @@ Server-authoritative clients load history by `threadId` (often `GET`):
 
 ```ts
 import { reconstructChat } from '@tanstack/ai-persistence'
+import { persistence } from './persistence'
+import { sessionUserId, userOwnsThread } from './auth'
 
 export async function GET(request: Request) {
   return reconstructChat(persistence, request, {

package/skills/ai-persistence/stores/SKILL.md

@@ -37,6 +37,7 @@ a complete `node:sqlite` implementation lives in
 ```ts
 import { defineAIPersistence } from '@tanstack/ai-persistence'
 import type { ChatWithInterruptsPersistence } from '@tanstack/ai-persistence'
+import { messages, runs, interrupts } from './stores'
 
 // Sparse is fine — only implement what you need.
 export const persistence: ChatWithInterruptsPersistence = defineAIPersistence({
@@ -73,9 +74,11 @@ mistake when writing an adapter.
 ### `MessageStore`
 
 ```ts
+import type { ModelMessage } from '@tanstack/ai'
+
 interface MessageStore {
-  loadThread(threadId: string): Promise<Array<ModelMessage>>
-  saveThread(threadId: string, messages: Array<ModelMessage>): Promise<void>
+  loadThread: (threadId: string) => Promise<Array<ModelMessage>>
+  saveThread: (threadId: string, messages: Array<ModelMessage>) => Promise<void>
 }
 ```
 
@@ -120,6 +123,9 @@ always a choice you made on purpose rather than a check that quietly did not
 run. Declare yours and the suite reports them as skipped with a reason:
 
 ```ts
+import { runPersistenceConformance } from '@tanstack/ai-persistence/testkit'
+import { persistence } from './persistence'
+
 // The shipped sqlite example implements findActiveRun and listReclaimable and
 // declares only the one it omits.
 runPersistenceConformance('sqlite', () => persistence, {
@@ -128,14 +134,16 @@ runPersistenceConformance('sqlite', () => persistence, {
 ```
 
 ```ts
+import type { RunRecord, RunStatus } from '@tanstack/ai-persistence'
+
 interface RunStore {
   // Required
-  createOrResume(
+  createOrResume: (
     input: Pick<RunRecord, 'runId' | 'threadId' | 'startedAt'> & {
       status?: RunStatus
     },
-  ): Promise<RunRecord>
-  update(
+  ) => Promise<RunRecord>
+  update: (
     runId: string,
     patch: Partial<
       Pick<
@@ -150,16 +158,16 @@ interface RunStore {
         | 'driverEpoch'
       >
     >,
-  ): Promise<void>
-  get(runId: string): Promise<RunRecord | null>
-  findActiveRun(threadId: string): Promise<RunRecord | null>
+  ) => Promise<void>
+  get: (runId: string) => Promise<RunRecord | null>
+  findActiveRun: (threadId: string) => Promise<RunRecord | null>
 
   // Optional
-  listByThread?(threadId: string): Promise<Array<RunRecord>>
-  listReclaimable?(opts: {
+  listByThread?: (threadId: string) => Promise<Array<RunRecord>>
+  listReclaimable?: (opts: {
     now: number
     ttlMs: number
-  }): Promise<Array<RunRecord>>
+  }) => Promise<Array<RunRecord>>
 }
 ```
 
@@ -293,15 +301,25 @@ and each must be declared via `skipMethods` when absent.
 ### `InterruptStore`
 
 ```ts
+import type {
+  InterruptCommitEntry,
+  InterruptRecord,
+} from '@tanstack/ai-persistence'
+
 interface InterruptStore {
-  create(record: Omit<InterruptRecord, 'status' | 'resolvedAt'>): Promise<void>
-  resolve(interruptId: string, response?: unknown): Promise<void>
-  cancel(interruptId: string): Promise<void>
-  get(interruptId: string): Promise<InterruptRecord | null>
-  list(threadId: string): Promise<Array<InterruptRecord>>
-  listPending(threadId: string): Promise<Array<InterruptRecord>>
-  listByRun(runId: string): Promise<Array<InterruptRecord>>
-  listPendingByRun(runId: string): Promise<Array<InterruptRecord>>
+  create: (
+    record: Omit<InterruptRecord, 'status' | 'resolvedAt'>,
+  ) => Promise<void>
+  resolve: (interruptId: string, response?: unknown) => Promise<void>
+  cancel: (interruptId: string) => Promise<void>
+  // Optional: apply a validated resume batch all-or-nothing instead of
+  // per-entry resolve/cancel.
+  commitBatch?: (entries: ReadonlyArray<InterruptCommitEntry>) => Promise<void>
+  get: (interruptId: string) => Promise<InterruptRecord | null>
+  list: (threadId: string) => Promise<Array<InterruptRecord>>
+  listPending: (threadId: string) => Promise<Array<InterruptRecord>>
+  listByRun: (runId: string) => Promise<Array<InterruptRecord>>
+  listPendingByRun: (runId: string) => Promise<Array<InterruptRecord>>
 }
 ```
 
@@ -314,9 +332,9 @@ interface InterruptStore {
 
 ```ts
 interface MetadataStore {
-  get(namespace: string, key: string): Promise<unknown | null>
-  set(namespace: string, key: string, value: unknown): Promise<void>
-  delete(namespace: string, key: string): Promise<void>
+  get: (namespace: string, key: string) => Promise<unknown | null>
+  set: (namespace: string, key: string, value: unknown) => Promise<void>
+  delete: (namespace: string, key: string) => Promise<void>
 }
 ```