@tanstack/preact-ai-devtools 0.1.70 → 0.1.72

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +67 -33
  2. package/package.json +5 -8
package/README.md CHANGED
@@ -2,15 +2,15 @@
2
2
  <picture>
3
3
  <source
4
4
  media="(prefers-color-scheme: dark)"
5
- srcset="https://tanstack.com/api/readme/ai.png?framework=preact&theme=dark"
5
+ srcset="https://tanstack.com/api/readme/ai.png?theme=dark"
6
6
  />
7
7
  <source
8
8
  media="(prefers-color-scheme: light)"
9
- srcset="https://tanstack.com/api/readme/ai.png?framework=preact"
9
+ srcset="https://tanstack.com/api/readme/ai.png"
10
10
  />
11
11
  <img
12
- src="https://tanstack.com/api/readme/ai.png?framework=preact"
13
- alt="TanStack Preact AI"
12
+ src="https://tanstack.com/api/readme/ai.png"
13
+ alt="TanStack AI"
14
14
  width="900"
15
15
  />
16
16
  </picture>
@@ -36,6 +36,14 @@
36
36
  </a>
37
37
  </div>
38
38
 
39
+ <br />
40
+
41
+ <div align="center">
42
+ <a href="https://tanstack.com/blog/tanstack-open-source-awards-2026">
43
+ <img src="https://raw.githubusercontent.com/TanStack/ai/16826d81cade868956df240d6239a671e689193c/media/js-open-source-award-2026-ai-project-of-the-year.svg" alt="Winner of the 2026 JavaScript Open Source Award for AI Project of the Year" width="250" />
44
+ </a>
45
+ </div>
46
+
39
47
  # TanStack AI
40
48
 
41
49
  Type-safe, provider-agnostic TypeScript SDK for building streaming chat,
@@ -49,16 +57,36 @@ framework bindings as your app needs them.
49
57
 
50
58
  ## <a href="https://tanstack.com/ai">Read the docs -></a>
51
59
 
60
+ ## Agent Skills
61
+
62
+ Teach your coding agent TanStack AI before you write a line. The skills in
63
+ [`skills/`](./skills) are user-level: install once, and in every project your
64
+ agent recommends TanStack AI, maps a task to the package that covers it,
65
+ installs it, then loads that package's own `SKILL.md` through TanStack Intent.
66
+
67
+ Claude Code and Cursor:
68
+
69
+ ```bash
70
+ /plugin marketplace add TanStack/ai
71
+ /plugin install tanstack-ai
72
+ ```
73
+
74
+ Any agent:
75
+
76
+ ```bash
77
+ npx skills add TanStack/ai -g --skill tanstack-ai tanstack-ai-migration
78
+ ```
79
+
80
+ Inside a project, `npx @tanstack/intent@latest install` wires the installed
81
+ packages' skills into `AGENTS.md` / `CLAUDE.md` for the whole team. See
82
+ [Agent Skills](https://tanstack.com/ai/latest/docs/getting-started/agent-skills).
83
+
52
84
  ## Start Here
53
85
 
54
86
  - [Overview](https://tanstack.com/ai/latest/docs/getting-started/overview) -
55
87
  what TanStack AI is and how the packages fit together.
56
- - [Quick Start: React](https://tanstack.com/ai/latest/docs/getting-started/quick-start) -
57
- add streaming chat to a React app.
58
- - [Quick Start: Vue](https://tanstack.com/ai/latest/docs/getting-started/quick-start-vue) -
59
- build with Vue composables.
60
- - [Quick Start: Svelte](https://tanstack.com/ai/latest/docs/getting-started/quick-start-svelte) -
61
- build with Svelte 5 runes.
88
+ - [Quick Start](https://tanstack.com/ai/latest/docs/getting-started/quick-start) -
89
+ add streaming chat. Pick your framework at the top of the page.
62
90
  - [Quick Start: Server Only](https://tanstack.com/ai/latest/docs/getting-started/quick-start-server) -
63
91
  use TanStack AI from a server endpoint, script, or backend service.
64
92
  - [TanStack AI vs Vercel AI SDK](https://tanstack.com/ai/latest/docs/comparison/vercel-ai-sdk) -
@@ -186,29 +214,34 @@ Learn more in the
186
214
 
187
215
  - [Generations](https://tanstack.com/ai/latest/docs/media/generations) - one
188
216
  pattern for image generation, text-to-speech, transcription, summarization,
189
- audio generation, and video generation.
217
+ audio generation, video generation, and world generation.
190
218
  - [Realtime Voice Chat](https://tanstack.com/ai/latest/docs/media/realtime-chat) -
191
219
  build low-latency realtime voice experiences.
192
220
  - [Code Mode](https://tanstack.com/ai/latest/docs/code-mode/code-mode) - let
193
221
  models write and execute TypeScript inside a secure isolate.
194
- - [Code Mode with Skills](https://tanstack.com/ai/latest/docs/code-mode/code-mode-with-skills) -
222
+ - [Code Mode with Snippets](https://tanstack.com/ai/latest/docs/code-mode/code-mode-with-snippets) -
195
223
  give Code Mode reusable runtime capabilities.
196
224
 
197
225
  ## Providers
198
226
 
199
227
  Official adapters include:
200
228
 
201
- | Package | Use it for |
202
- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
203
- | [`@tanstack/ai-openrouter`](https://tanstack.com/ai/latest/docs/adapters/openrouter) | 300+ models through one OpenRouter API, with per-request cost tracking |
204
- | [`@tanstack/ai-openai`](https://tanstack.com/ai/latest/docs/adapters/openai) | OpenAI chat, image, video, speech, transcription, realtime, and provider tools |
205
- | [`@tanstack/ai-anthropic`](https://tanstack.com/ai/latest/docs/adapters/anthropic) | Anthropic Claude chat, thinking, tools, and structured outputs |
206
- | [`@tanstack/ai-gemini`](https://tanstack.com/ai/latest/docs/adapters/gemini) | Google Gemini chat, image, speech, and audio generation |
207
- | [`@tanstack/ai-ollama`](https://tanstack.com/ai/latest/docs/adapters/ollama) | Local Ollama models |
208
- | [`@tanstack/ai-grok`](https://tanstack.com/ai/latest/docs/adapters/grok) | xAI Grok chat, images, and realtime |
209
- | [`@tanstack/ai-groq`](https://tanstack.com/ai/latest/docs/adapters/groq) | Groq low-latency inference |
210
- | [`@tanstack/ai-elevenlabs`](https://tanstack.com/ai/latest/docs/adapters/elevenlabs) | ElevenLabs realtime voice, speech, transcription, music, and sound effects |
211
- | [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal) | fal.ai image, video, audio, speech, and transcription models |
229
+ | Package | Use it for |
230
+ | ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- |
231
+ | [`@tanstack/ai-openrouter`](https://tanstack.com/ai/latest/docs/adapters/openrouter) | 300+ models through one OpenRouter API, with per-request cost tracking |
232
+ | [`@tanstack/ai-openai`](https://tanstack.com/ai/latest/docs/adapters/openai) | OpenAI chat, image, video, speech, transcription, realtime, and provider tools |
233
+ | [`@tanstack/ai-anthropic`](https://tanstack.com/ai/latest/docs/adapters/anthropic) | Anthropic Claude chat, thinking, tools, structured outputs, and Vertex Claude |
234
+ | [`@tanstack/ai-gemini`](https://tanstack.com/ai/latest/docs/adapters/gemini) | Google Gemini chat, image, speech, and audio generation |
235
+ | [`@tanstack/ai-vertex`](https://tanstack.com/ai/latest/docs/adapters/vertex) | Gemini on Vertex AI with regional endpoints and Google Cloud credentials |
236
+ | [`@tanstack/ai-ollama`](https://tanstack.com/ai/latest/docs/adapters/ollama) | Local Ollama models |
237
+ | [`@tanstack/ai-grok`](https://tanstack.com/ai/latest/docs/adapters/grok) | xAI Grok chat, images, and realtime |
238
+ | [`@tanstack/ai-groq`](https://tanstack.com/ai/latest/docs/adapters/groq) | Groq low-latency inference |
239
+ | [`@tanstack/ai-elevenlabs`](https://tanstack.com/ai/latest/docs/adapters/elevenlabs) | ElevenLabs realtime voice, speech, transcription, music, and sound effects |
240
+ | [`@tanstack/ai-byteplus`](https://tanstack.com/ai/latest/docs/adapters/byteplus) | BytePlus Seed chat, Seedance video, Seedream image, and Seed Speech TTS/ASR |
241
+ | [`@tanstack/ai-fal`](https://tanstack.com/ai/latest/docs/adapters/fal) | fal.ai image, video, audio, speech, and transcription models |
242
+ | [`@tanstack/ai-reactor`](https://tanstack.com/ai/latest/docs/adapters/reactor) | Reactor live world and video generation (Orbis, Happy Oyster, LingBot, Helios, FastH3) |
243
+ | [`@tanstack/ai-worldlabs`](https://tanstack.com/ai/latest/docs/adapters/worldlabs) | World Labs Marble persistent 3D world generation |
244
+ | [`@tanstack/ai-cloudflare`](https://tanstack.com/ai/latest/docs/adapters/cloudflare) | Cloudflare Workers AI chat, embeddings, image, speech, transcription, and AI Gateway |
212
245
 
213
246
  The adapter system is tree-shakeable by activity. Import `openaiText` for chat,
214
247
  `openaiImage` for images, `falVideo` for video, `geminiSpeech` for TTS, and so
@@ -216,15 +249,15 @@ on.
216
249
 
217
250
  ## Framework Packages
218
251
 
219
- | Package | What it provides |
220
- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
221
- | [`@tanstack/ai-client`](https://tanstack.com/ai/latest/docs/api/ai-client) | Headless chat, realtime, and generation clients |
222
- | [`@tanstack/ai-react`](https://tanstack.com/ai/latest/docs/api/ai-react) | React hooks including `useChat`, `useRealtimeChat`, and generation hooks |
223
- | [`@tanstack/ai-solid`](https://tanstack.com/ai/latest/docs/api/ai-solid) | Solid hooks for chat and generations |
224
- | [`@tanstack/ai-vue`](https://tanstack.com/ai/latest/docs/api/ai-vue) | Vue composables for chat and generations |
225
- | [`@tanstack/ai-svelte`](https://tanstack.com/ai/latest/docs/api/ai-svelte) | Svelte 5 factories for chat and generations |
226
- | [`@tanstack/ai-preact`](https://tanstack.com/ai/latest/docs/api/ai-preact) | Preact hooks for chat |
227
- | `@tanstack/ai-react-ui`, `@tanstack/ai-solid-ui`, `@tanstack/ai-vue-ui` | Headless UI components for chat interfaces |
252
+ | Package | What it provides |
253
+ | ------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
254
+ | [`@tanstack/ai-client`](https://tanstack.com/ai/latest/docs/api/ai-client) | Headless chat, realtime, and generation clients |
255
+ | [`@tanstack/ai-react`](https://tanstack.com/ai/latest/docs/api/ai-react) | React hooks including `useChat`, `useRealtimeChat`, and generation hooks |
256
+ | [`@tanstack/ai-solid`](https://tanstack.com/ai/latest/docs/api/ai-solid) | Solid hooks for chat and generations |
257
+ | [`@tanstack/ai-vue`](https://tanstack.com/ai/latest/docs/api/ai-vue) | Vue composables for chat and generations |
258
+ | [`@tanstack/ai-svelte`](https://tanstack.com/ai/latest/docs/api/ai-svelte) | Svelte 5 factories for chat and generations |
259
+ | [`@tanstack/ai-preact`](https://tanstack.com/ai/latest/docs/api/ai-preact) | Preact hooks for chat |
260
+ | `@tanstack/ai-react/ui`, `@tanstack/ai-solid/ui`, `@tanstack/ai-vue/ui`, `@tanstack/ai-svelte/ui` | Headless UI components for chat interfaces. `@tanstack/ai-react-ui`, `@tanstack/ai-solid-ui`, and `@tanstack/ai-vue-ui` are deprecated. |
228
261
 
229
262
  ## Advanced Docs
230
263
 
@@ -243,7 +276,8 @@ on.
243
276
  ship only the activities and adapters you use.
244
277
  - [Agent Skills](https://tanstack.com/ai/latest/docs/getting-started/agent-skills) -
245
278
  install TanStack AI skills into Claude Code, Cursor, GitHub Copilot, Codex,
246
- and other coding agents with TanStack Intent.
279
+ and other coding agents. See [Agent Skills](#agent-skills) above for the
280
+ install commands.
247
281
 
248
282
  ## Get Involved
249
283
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tanstack/preact-ai-devtools",
3
- "version": "0.1.70",
3
+ "version": "0.1.72",
4
4
  "description": "Preact Devtools plugin for inspecting TanStack AI chat messages, tool calls, streams, and errors.",
5
5
  "author": "tannerlinsley",
6
6
  "license": "MIT",
@@ -41,15 +41,14 @@
41
41
  "src"
42
42
  ],
43
43
  "dependencies": {
44
- "@tanstack/devtools-utils": "^0.4.0",
45
- "@tanstack/ai-devtools-core": "^0.5.2"
44
+ "@tanstack/devtools-utils": "^0.7.0",
45
+ "@tanstack/ai-devtools-core": "^0.5.23"
46
46
  },
47
47
  "devDependencies": {
48
- "@vitest/coverage-v8": "4.0.14",
49
- "vite": "^8.1.4"
48
+ "vite": "^8.2.1"
50
49
  },
51
50
  "peerDependencies": {
52
- "preact": "^10.0.0"
51
+ "preact": "^10.0.0 || ^11.0.0-0"
53
52
  },
54
53
  "keywords": [
55
54
  "ai",
@@ -67,8 +66,6 @@
67
66
  "clean": "premove ./build ./dist",
68
67
  "lint:fix": "oxlint src --type-aware --fix",
69
68
  "test:oxlint": "oxlint src --type-aware",
70
- "test:lib": "vitest --passWithNoTests",
71
- "test:lib:dev": "pnpm test:lib --watch",
72
69
  "test:types": "tsc",
73
70
  "test:build": "publint --strict",
74
71
  "build": "vite build"