effect-ai-provider

Effect AI Provider

Configure AI provider layers for language model integration using Effect's AI ecosystem.

When to Use This Skill

Use this skill when:

• Integrating AI language models (Anthropic, OpenAI, OpenRouter, etc.) into Effect applications
• Setting up multi-provider AI architectures with ExecutionPlan fallback
• Implementing stateful chat conversations with context history
• Managing AI provider configuration and API keys securely
• Composing AI capabilities with other Effect services

Import Patterns

CRITICAL: Always use namespace imports. Use { } destructured imports for the effect package barrel exports.

// From the "effect" barrel — destructured
import {
	Config,
	Effect,
	ExecutionPlan,
	Layer,
	Ref,
	Schema,
	Context,
	Stream
} from 'effect';

// From "effect/unstable/ai" — namespace imports
import {
	AiError,
	Chat,
	LanguageModel,
	Model,
	Prompt,
	Tool,
	Toolkit
} from 'effect/unstable/ai';
// Or individually:
import * as LanguageModel from 'effect/unstable/ai/LanguageModel';
import * as Chat from 'effect/unstable/ai/Chat';
import * as Model from 'effect/unstable/ai/Model';
import * as Prompt from 'effect/unstable/ai/Prompt';
import * as AiError from 'effect/unstable/ai/AiError';

// Anthropic
import { AnthropicClient, AnthropicLanguageModel } from '@effect/ai-anthropic';

// OpenAI
import {
	OpenAiClient,
	OpenAiClientGenerated,
	OpenAiLanguageModel,
	OpenAiSchema,
	OpenAiTool
} from '@effect/ai-openai';

// OpenRouter
import {
	OpenRouterClient,
	OpenRouterLanguageModel
} from '@effect/ai-openrouter';

// HTTP client (required by all providers)
import { FetchHttpClient } from 'effect/unstable/http';

Provider Layer Pattern

Every provider exposes two constructors:

• model(modelId, config?) — returns a Model.Model (preferred for ExecutionPlan and Effect.provide)
• layer({ model, config? }) — returns a raw Layer<LanguageModel.LanguageModel, never, Client>

-- Model constructor (preferred)
ProviderLanguageModel.model :: (modelId, config?) → Model.Model<providerName, LanguageModel, Client>

-- Layer constructor
ProviderLanguageModel.layer :: { model, config? } → Layer LanguageModel Client

-- Client layer
ProviderClient.layerConfig :: { apiKey } → Layer Client HttpClient