/ai-sdk-model-manager

name: ai-sdk-model-manager
description: Manages AI SDK model configurations - updates packages, identifies missing models, adds new models with research, and updates documentation
metadata:
  internal: true

AI SDK Model Manager

This skill helps maintain AI SDK model configurations in the Tambo Cloud codebase. It automates the process of keeping model definitions up-to-date with the latest AI SDK releases.

What This Skill Does

1. **Updates AI SDK Packages** - Checks and updates @ai-sdk/openai, @ai-sdk/google, @ai-sdk/groq, and other provider packages to their latest versions 2. **Identifies Missing Models** - Compares TypeScript definitions in the SDKs against configured models to find newly available models 3. **Researches Models** - Gathers information about new models including capabilities, context windows, pricing, and use cases 4. **Prompts User** - Asks which models to add before making changes 5. **Adds Models** - Updates model configuration files with proper TypeScript types and metadata 6. **Updates Documentation** - Updates relevant docs and README files to reflect new model availability

When to Use This Skill

Use this skill when:

• You want to check if AI SDK packages need updating
• New models have been released by OpenAI, Google, Anthropic, or other providers
• You're getting TypeScript errors about model IDs not being in SDK types
• You want to ensure Tambo supports the latest models

Files This Skill Works With

• `packages/core/src/llms/models/*.ts` - Model configuration files
• `packages/backend/package.json` - AI SDK dependencies (source of truth for versions)
• `docs/content/docs/models/*.mdx` - Model documentation
• `README.md` - Main documentation file

Process

Step 1: Update AI SDK Packages

Check current versions and update to latest:

cd packages/backend
npm outdated | grep '@ai-sdk'
npm install @ai-sdk/openai@latest @ai-sdk/google@latest @ai-sdk/groq@latest @ai-sdk/anthropic@latest @ai-sdk/mistral@latest

Step 2: Identify Missing Models

For each provider, inspect the TypeScript definitions:

# Check what models are in the SDK types
cat node_modules/@ai-sdk/openai/dist/index.d.ts | grep 'type.*ModelId'
cat node_modules/@ai-sdk/google/dist/index.d.ts | grep 'type.*ModelId'
cat node_modules/@ai-sdk/groq/dist/index.d.ts | grep 'type.*ModelId'

Compare against current model configurations in:

• `packages/core/src/llms/models/openai.ts`
• `packages/core/src/llms/models/gemini.ts`
• `packages/core/src/llms/models/groq.ts`
• `packages/core/src/llms/models/anthropic.ts`
• `packages/core/src/llms/models/mistral.ts`

Step 3: Research New Models

**Use the researcher subagent to gather information about each missing model:**

Launch a researcher subagent to find:
- Official documentation link
- Model capabilities (reasoning, vision, function calling, etc.)
- Context window size (inputTokenLimit)
- Pricing tier
- Best use cases
- Release date and status (experimental, stable, deprecated)

The researcher subagent has access to web search and can efficiently gather this information for multiple models in parallel.

Step 4: Prompt User

Present findings:

Found the following new models in updated AI SDK packages:

OpenAI:
- gpt-6-preview (200k context, experimental reasoning model)
- gpt-4.2-turbo (1M context, improved function calling)

Google:
- gemini-3.5-pro (2M context, advanced reasoning)

Which models would you like to add? (all/none/specific)

Wait for user response before proceeding.

Step 5: Add Selected Models

**Consider launching parallel subagents to add models to each provider file:**

For models spread across multiple providers (OpenAI, Google, Groq), launch separate subagents to edit each file concurrently. This is faster than doing them sequentially.

For each model being added, ensure these required fields:

• `apiName`: Exact model ID string from SDK
• `displayName`: Human-friendly name
• `status`: "untested" | "tested" | "known-issues"
• `notes`: Brief description of capabilities and use cases
• `docLink`: Official provider documentation URL
• `tamboDocLink`: "https://docs.tambo.co"
• `inputTokenLimit`: Context window size in tokens
• `modelSpecificParams`: Any special parameters (reasoning, thinking, etc.)

Follow existing patterns in each file and ensure model IDs match SDK type definitions exactly.

Example:

"gpt-6-preview": {
  apiName: "gpt-6-preview",
  displayName: "gpt-6-preview",
  status: "untested",
  notes: "Experimental next-generation reasoning model with extended context",
  docLink: "https://platform.openai.com/docs/models/gpt-6-preview",
  tamboDocLink: "https://docs.tambo.co",
  inputTokenLimit: 200000,
  modelSpecificParams: reasoningParameters,
},

Step 6: Verify TypeScript

Run type checking to ensure all model IDs are valid:

cd packages/core
npm run check-types

If there are type errors, fix model IDs to match SDK definitions exactly.

Step 7: Update Documentation

**Consider using subagents to update documentation in parallel:**

If updating multiple documentation files, launch parallel subagents to handle:

1. **README.md** - Update the "Supported LLM Providers" section if new providers or significant models were added 2. **docs/content/docs/models/\*.mdx** - Add new models to appropriate documentation pages with:

• Model name and description
• Key capabilities
• Context window
• Example use cases
• Links to provider docs

Step 8: Run Quality Checks

Before completing:

cd packages/core
npm run lint
npm run check-types
npm run test

Step 9: Create Pull Request

**Create a PR with proper conventional commit format:**

gh pr create --title "feat(models): add [model names] support" --body "$(cat <<'EOF'
Updated AI SDK packages and added support for newly released models:

Models added:
- [list models here]

Package updates:
- @ai-sdk/openai: X.X.X → X.X.X
- @ai-sdk/