@gemstack/ai-sdk

AI engine: providers, agents, tools, streaming, middleware, structured output, conversation memory, evals, computer-use, and testing fakes.

The first GemStack package. Spun out of Rudder's @rudderjs/ai (carried forward from the 1.17.x line, renamed and re-versioned under the GemStack umbrella). The Rudder package now ships as a thin deprecated re-export of this one.

Installation

pnpm add @gemstack/ai-sdk

Install the provider SDK(s) you need:

pnpm add @anthropic-ai/sdk             # Anthropic (Claude)
pnpm add openai                         # OpenAI (GPT), also used for OpenRouter / Mistral / DeepSeek / Groq / xAI / Ollama
pnpm add @google/genai                  # Google (Gemini)
pnpm add cohere-ai                      # Cohere (reranking + embeddings)
pnpm add @aws-sdk/client-bedrock-runtime # AWS Bedrock
# ElevenLabs (premium TTS + STT)        - no extra package needed (direct HTTP)
# VoyageAI (embeddings + reranking)     - no extra package needed (direct HTTP)
# Jina                                   - no extra package needed (direct HTTP)

Status

As of 0.2.0 the core stands alone: @gemstack/ai-sdk's only required runtime dependency is zod. Every framework integration is an optional, opt-in subpath behind an optional peer dependency:

• the Rudder /server provider (optional peer @rudderjs/core)
• the ORM-backed stores /conversation-orm, /memory-orm, /budget-orm (optional peer @rudderjs/orm)
• the doctor check + make:agent scaffolder (optional peer @rudderjs/console)

The neutral storage contracts (UserMemory, ConversationStore, BudgetStorage) ship in-memory defaults, so a non-Rudder app uses the SDK with zero @rudderjs/* installed. The version line stays 0.x while the API settles toward 1.0.0.

Subpath exports

Moved in 0.3.0: the MCP bridge (mcpClientTools / mcpServerFromAgent), previously the ./mcp subpath, is now its own package, @gemstack/ai-mcp. Update @gemstack/ai-sdk/mcp imports to @gemstack/ai-mcp and move the @modelcontextprotocol/sdk peer there.

License

MIT