Splitting made operational with extra tests

[jherr]

🎯 Changes

1. New Unified ai() Function (Default Export)

• Introduced a single ai() function as the default export from @tanstack/ai
• Supports multiple activity types: text, embed, summarize, and image
• Type-safe based on adapter type - the compiler knows what options are valid per adapter

2. Split Adapters for Tree-Shaking

Each adapter package now exports specialized functions:

Package	Functions
@tanstack/ai-openai	openaiText, openaiEmbed, openaiSummarize, openaiImage
@tanstack/ai-anthropic	anthropicText, anthropicSummarize
@tanstack/ai-gemini	geminiText, geminiEmbed, geminiSummarize, geminiImage
@tanstack/ai-ollama	ollamaText, ollamaEmbed, ollamaSummarize
@tanstack/ai-grok(NEW!)	grokText, grokSummarize, grokImage

Each also exports create* variants for custom API key configuration (e.g., createOpenaiText(apiKey, config)).

3. New @tanstack/ai-grok Package

• Full support for xAI's Grok models (Grok 3, Grok 3 Mini, Grok 4, vision models)
• Text completion with tool support
• Summarization
• Image generation (grok-2-image-1212)
• Environment variable: XAI_API_KEY

---

📚 Documentation Updates

• New docs:

  • docs/adapters/grok.md - Complete Grok adapter documentation
  • docs/guides/image-generation.md - Image generation guide
  • docs/guides/tree-shakeable-adapters.md - Guide on the new adapter architecture

• Updated adapter docs with all available functions:

  • openai.md, anthropic.md, gemini.md, ollama.md
  • Each now covers: text, embeddings, summarization, image generation (where supported)

• Updated all example code across docs to use:

  • ai as default export
  • New adapter naming (openaiText instead of openai)

---

🧪 Testing Improvements

Smoke Tests (packages/typescript/smoke-tests/adapters/)

• Complete refactor with modular test structure
• New CLI interface for running specific tests
• Test categories:
  • CST - Chat Stream
  • TLS - Tool Calls (Server)
  • APR - Tool Approval Flow
  • AGS - Agentic Structured Loop
  • EMB - Embeddings
  • SUM - Summarization
  • IMG - Image Generation
  • OST - One-Shot Text
  • STR - Structured Output

Testing Panel (testing/panel/)

• Added Grok to provider selection UI
• New routes: /image, /summarize, /structured
• API endpoints: api.image.ts, api.summarize.ts, api.structured.ts
• Added @tanstack/ai-grok and @tanstack/ai-ollama dependencies
• Integrated into pnpm workspace

---

🏗️ Architecture Changes

• New activities system in packages/typescript/ai/src/activities/:

  • text/ - Text/chat completions with streaming
  • embedding/ - Vector embeddings
  • summarize/ - Text summarization
  • image/ - Image generation

• Renamed internals:

  • chat.ts → activities/text/index.ts
  • ChatOptions → TextOptions
  • chatOptions() → textOptions()

• Schema converters added to each adapter for Zod → provider schema conversion

---

📦 Package Updates

• All adapter packages bumped to minor version
• Added @tanstack/ai-grok as new package
• Updated workspace configuration to include testing/*

---

Example Usage (New Pattern)

importaifrom"@tanstack/ai";import{openaiText}from"@tanstack/ai-openai";// Text completionconststream=ai({adapter: openaiText(),messages: [{role: "user",content: "Hello!"}],model: "gpt-4o",});// Embeddingsimport{openaiEmbed}from"@tanstack/ai-openai";constresult=awaitai({adapter: openaiEmbed(),model: "text-embedding-3-small",input: "Text to embed",});// Image generationimport{openaiImage}from"@tanstack/ai-openai";constimages=awaitai({adapter: openaiImage(),model: "gpt-image-1",prompt: "A sunset over mountains",});

✅ Checklist

• I have followed the steps in the Contributing guide.
• I have tested this code locally with pnpm run test:pr. (many times)

🚀 Release Impact

• This change affects published code, and I have generated a changeset.
• This change is docs/CI/dev-only (no release).

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch splitting-made-functional

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 0b2e80a

Command	Status	Duration	Result
nx affected --targets=test:sherif,test:knip,tes...	✅ Succeeded	44s	View ↗
nx run-many --targets=build --exclude=examples/**	✅ Succeeded	8s	View ↗

---

☁️ Nx Cloud last updated this comment at 2025-12-12 17:06:43 UTC

[pkg-pr-new]

Open in StackBlitz

@tanstack/ai

npm i https://pkg.pr.new/TanStack/ai/@tanstack/ai@142

@tanstack/ai-anthropic

npm i https://pkg.pr.new/TanStack/ai/@tanstack/ai-anthropic@142

@tanstack/ai-client

npm i https://pkg.pr.new/TanStack/ai/@tanstack/ai-client@142

@tanstack/ai-devtools-core

npm i https://pkg.pr.new/TanStack/ai/@tanstack/ai-devtools-core@142

@tanstack/ai-gemini

npm i https://pkg.pr.new/TanStack/ai/@tanstack/ai-gemini@142

@tanstack/ai-ollama

npm i https://pkg.pr.new/TanStack/ai/@tanstack/ai-ollama@142

@tanstack/ai-openai

npm i https://pkg.pr.new/TanStack/ai/@tanstack/ai-openai@142

@tanstack/ai-react

npm i https://pkg.pr.new/TanStack/ai/@tanstack/ai-react@142

@tanstack/ai-react-ui

npm i https://pkg.pr.new/TanStack/ai/@tanstack/ai-react-ui@142

@tanstack/ai-solid

npm i https://pkg.pr.new/TanStack/ai/@tanstack/ai-solid@142

@tanstack/ai-solid-ui

npm i https://pkg.pr.new/TanStack/ai/@tanstack/ai-solid-ui@142

@tanstack/ai-svelte

npm i https://pkg.pr.new/TanStack/ai/@tanstack/ai-svelte@142

@tanstack/ai-vue

npm i https://pkg.pr.new/TanStack/ai/@tanstack/ai-vue@142

@tanstack/ai-vue-ui

npm i https://pkg.pr.new/TanStack/ai/@tanstack/ai-vue-ui@142

@tanstack/react-ai-devtools

npm i https://pkg.pr.new/TanStack/ai/@tanstack/react-ai-devtools@142

@tanstack/solid-ai-devtools

npm i https://pkg.pr.new/TanStack/ai/@tanstack/solid-ai-devtools@142

commit: 0b2e80a