@gemstack/ai-sdk

@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

The core stands alone: @gemstack/ai-sdk's only required runtime dependency is zod. Persistence is via neutral contracts you implement against your own infrastructure:

• ConversationStore, UserMemory, BudgetStorage ship in-memory defaults; bring your own backend by implementing the interface.
• CacheAdapter (the suspendable run stores) and StorageAdapter (ImageGenerator/AudioGenerator .store()) are caller-supplied — no storage/cache package is bundled.

The engine is now fully framework-agnostic: it has no @rudderjs/* peer dependency. The ORM-backed implementations of those contracts (Prisma/Drizzle/native), the /server provider, and the make:agent scaffolder and ai:eval CLI command are all Rudder bindings and live in @rudderjs/ai (@rudderjs/ai/conversation-orm, /memory-orm, /budget-orm, /memory-embedding, plus the provider and CLI), not here. Rudder users pick them up there unchanged. 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.

Moved to @rudderjs/ai: the ORM-backed stores (./conversation-orm, ./memory-orm, ./budget-orm, ./memory-embedding) coupled the engine to @rudderjs/orm, so they now live in @rudderjs/ai under the same subpath names. Update @gemstack/ai-sdk/conversation-orm imports to @rudderjs/ai/conversation-orm (etc.). They implement the same ConversationStore / UserMemory / BudgetStorage contracts, still exported from here.

Moved to @rudderjs/ai: the /server provider (which carried a @rudderjs/core peer) and the make:agent scaffolder + ai:eval CLI command (which carried a @rudderjs/console peer) are Rudder bindings, so they now live in @rudderjs/ai. The engine no longer ships the ./server / ./commands/* subpaths or any @rudderjs/* peer.

License

MIT