@promptlycms/prompts 0.1.0 → 0.1.1

package/README.md

@@ -2,15 +2,33 @@
 
 TypeScript SDK for the [Promptly CMS](https://promptlycms.com) API. Fetch prompts at runtime, get typed template variables via codegen, and integrate with the [Vercel AI SDK](https://sdk.vercel.ai).
 
+- **Runtime client** — `getPrompt()`, `getPrompts()`, `aiParams()` with full TypeScript support
+- **Codegen CLI** — generates typed template variables via declaration merging
+- **AI SDK integration** — spread-ready params for `generateText` / `streamText`
+- **Model auto-detection** — resolves Anthropic, OpenAI, Google, and Mistral models automatically
+- **Structured output** — Zod schemas built from CMS-defined output schemas
+
 ## Install
 
 ```bash
 npm install @promptlycms/prompts
-# or
-bun add @promptlycms/prompts
 ```
 
-Peer dependencies: `zod@^4`, `ai@^4 || ^5 || ^6`, `typescript@^5`
+Peer dependencies:
+
+```bash
+npm install zod ai typescript
+```
+
+You'll also need at least one AI provider SDK for model resolution:
+
+```bash
+# Install the provider(s) your prompts use
+npm install @ai-sdk/anthropic  # Claude models
+npm install @ai-sdk/openai     # GPT / o-series models
+npm install @ai-sdk/google     # Gemini models
+npm install @ai-sdk/mistral    # Mistral / Mixtral models
+```
 
 ## Quick start
 
@@ -27,7 +45,7 @@ PROMPTLY_API_KEY=pk_live_...
 npx promptly generate
 ```
 
-This fetches all your prompts from the API and generates a `promptly-env.d.ts` file in your project root. This gives you typed autocomplete on `userMessage()` variables for every prompt ID.
+This fetches all your prompts from the API and generates a `promptly-env.d.ts` file in your project root with typed autocomplete for every prompt ID and its template variables.
 
 ```bash
 # Custom output path
@@ -40,9 +58,9 @@ npx promptly generate --api-key pk_live_...
 ### 3. Create a client
 
 ```typescript
-import { createPromptClient } from '@promptlycms/prompts';
+import { createPromptlyClient } from '@promptlycms/prompts';
 
-const promptly = createPromptClient({
+const promptly = createPromptlyClient({
   apiKey: process.env.PROMPTLY_API_KEY,
 });
 ```
@@ -52,13 +70,14 @@ const promptly = createPromptClient({
 ### Single prompt
 
 ```typescript
-const result = await promptly.get('JPxlUpstuhXB5OwOtKPpj');
+const result = await promptly.getPrompt('JPxlUpstuhXB5OwOtKPpj');
 
 // Access prompt metadata
 result.promptId;      // 'JPxlUpstuhXB5OwOtKPpj'
 result.promptName;    // 'Review Prompt'
 result.systemMessage; // 'You are a helpful assistant.'
 result.temperature;   // 0.7
+result.model;         // LanguageModel (auto-resolved from CMS config)
 
 // Interpolate template variables (typed if you ran codegen)
 const message = result.userMessage({
@@ -74,7 +93,7 @@ const template = String(result.userMessage);
 Fetch a specific version:
 
 ```typescript
-const result = await promptly.get('JPxlUpstuhXB5OwOtKPpj', {
+const result = await promptly.getPrompt('JPxlUpstuhXB5OwOtKPpj', {
   version: '2.0.0',
 });
 ```
@@ -102,23 +121,48 @@ welcomePrompt.userMessage({ email: 'a@b.com', subject: 'Hi' });
 
 ```typescript
 import { generateText } from 'ai';
-import { anthropic } from '@ai-sdk/anthropic';
 
 const params = await promptly.aiParams('my-prompt', {
   variables: { name: 'Alice', task: 'coding' },
 });
 
 const { text } = await generateText({
-  model: anthropic('claude-sonnet-4-5-20250929'),
   ...params,
+  // model is already included from your CMS prompt config
 });
 ```
 
-If the prompt has a structured output schema defined in the CMS, `params.output` is automatically populated with a Zod schema wrapped in `Output.object()`.
+The model configured in the CMS is auto-resolved to the correct AI SDK provider. If the prompt has a structured output schema defined in the CMS, `params.output` is automatically populated with a Zod schema wrapped in `Output.object()`.
+
+## Model auto-detection
+
+The SDK automatically resolves models configured in the CMS to the correct AI SDK provider based on the model name prefix:
+
+| Prefix | Provider | Package |
+|--------|----------|---------|
+| `claude-*` | Anthropic | `@ai-sdk/anthropic` |
+| `gpt-*`, `o1-*`, `o3-*`, `o4-*`, `chatgpt-*` | OpenAI | `@ai-sdk/openai` |
+| `gemini-*` | Google | `@ai-sdk/google` |
+| `mistral-*`, `mixtral-*`, `codestral-*` | Mistral | `@ai-sdk/mistral` |
+
+CMS model display names (e.g. `claude-sonnet-4.5`) are mapped to their full API model IDs automatically.
+
+### Custom model resolver
+
+If you need full control over model resolution, pass a `model` function:
+
+```typescript
+import { anthropic } from '@ai-sdk/anthropic';
+
+const promptly = createPromptlyClient({
+  apiKey: process.env.PROMPTLY_API_KEY,
+  model: (modelId) => anthropic('claude-sonnet-4-5-20250929'),
+});
+```
 
 ## Type generation
 
-Running `npx promptly generate` creates a `promptly-env.d.ts` file that uses [declaration merging](https://www.typescriptlang.org/docs/handbook/declaration-merging.html) to narrow types:
+Running `npx promptly generate` creates a `promptly-env.d.ts` file that uses [declaration merging](https://www.typescriptlang.org/docs/handbook/declaration-merging.html) to type your prompts:
 
 ```typescript
 // Auto-generated by @promptlycms/prompts — do not edit
@@ -127,26 +171,24 @@ import '@promptlycms/prompts';
 declare module '@promptlycms/prompts' {
   interface PromptVariableMap {
     'JPxlUpstuhXB5OwOtKPpj': {
-      pickupLocation: string;
-      items: string;
+      [V in 'latest' | '2.0.0' | '1.0.0']: {
+        pickupLocation: string;
+        items: string;
+      };
     };
     'abc123': {
-      email: string;
-      subject: string;
+      [V in 'latest' | '1.0.0']: {
+        email: string;
+        subject: string;
+      };
     };
   }
 }
 ```
 
-With this file present, `get()` and `getPrompts()` return typed `userMessage` functions with autocomplete. Unknown prompt IDs fall back to `Record<string, string>`.
+With this file present, `getPrompt()` and `getPrompts()` return typed `userMessage` functions with autocomplete. Unknown prompt IDs fall back to `Record<string, string>`.
 
-Add the generated file to version control so types are available without running codegen in CI:
-
-```bash
-# .gitignore — do NOT ignore promptly-env.d.ts
-```
-
-Re-run `npx promptly generate` whenever you add, remove, or rename template variables in the CMS.
+Add the generated file to version control so types are available without running codegen in CI. Re-run `npx promptly generate` whenever you add, remove, or rename template variables in the CMS.
 
 ## Error handling
 
@@ -156,7 +198,7 @@ All API errors throw `PromptlyError`:
 import { PromptlyError } from '@promptlycms/prompts';
 
 try {
-  await promptly.get('nonexistent');
+  await promptly.getPrompt('nonexistent');
 } catch (err) {
   if (err instanceof PromptlyError) {
     err.code;       // 'NOT_FOUND' | 'INVALID_KEY' | 'USAGE_LIMIT_EXCEEDED' | ...
@@ -170,26 +212,47 @@ try {
 
 ## API reference
 
-### `createPromptClient(config)`
+### `createPromptlyClient(config?)`
 
 | Option    | Type     | Required | Description                                        |
 |-----------|----------|----------|----------------------------------------------------|
-| `apiKey`  | `string` | Yes      | Your Promptly CMS API key                          |
+| `apiKey`  | `string` | No       | Your Promptly API key (defaults to `PROMPTLY_API_KEY` env var) |
 | `baseUrl` | `string` | No       | API base URL (default: `https://api.promptlycms.com`) |
+| `model`   | `(modelId: string) => LanguageModel` | No | Custom model resolver — overrides auto-detection |
 
-Returns a `PromptClient` with `get()`, `getPrompts()`, and `aiParams()` methods.
+Returns a `PromptlyClient` with `getPrompt()`, `getPrompts()`, and `aiParams()` methods.
 
-### `client.get(promptId, options?)`
+### `client.getPrompt(promptId, options?)`
 
 Fetch a single prompt. Returns `PromptResult` with typed `userMessage` when codegen types are present.
 
+| Option    | Type     | Description          |
+|-----------|----------|----------------------|
+| `version` | `string` | Specific version to fetch (default: latest) |
+
 ### `client.getPrompts(entries)`
 
 Fetch multiple prompts in parallel. Accepts `PromptRequest[]` and returns a typed tuple matching the input order.
 
 ### `client.aiParams(promptId, options?)`
 
-Fetch a prompt and return params ready to spread into AI SDK functions (`system`, `prompt`, `temperature`, and optionally `output`).
+Fetch a prompt and return params ready to spread into AI SDK functions (`system`, `prompt`, `temperature`, `model`, and optionally `output`).
+
+| Option      | Type                    | Description                    |
+|-------------|-------------------------|--------------------------------|
+| `version`   | `string`                | Specific version to fetch      |
+| `variables` | `Record<string, string>` | Template variables to interpolate |
+
+### `@promptlycms/prompts/schema`
+
+Subpath export for working with Zod schemas from CMS schema fields:
+
+```typescript
+import { buildZodSchema, schemaFieldsToZodSource } from '@promptlycms/prompts/schema';
+```
+
+- `buildZodSchema(fields)` — builds a Zod object schema at runtime from `SchemaField[]`
+- `schemaFieldsToZodSource(fields)` — generates Zod source code as a string for codegen
 
 ### CLI: `npx promptly generate`
 
@@ -197,3 +260,7 @@ Fetch a prompt and return params ready to spread into AI SDK functions (`system`
 |-------------|-------|------------------------------------------------------|
 | `--api-key` |       | API key (defaults to `PROMPTLY_API_KEY` env var)     |
 | `--output`  | `-o`  | Output path (default: `./promptly-env.d.ts`)         |
+
+## License
+
+MIT

package/dist/cli.js

@@ -41,6 +41,41 @@ var createErrorFromResponse = async (response) => {
 
 // src/cli/generate.ts
 import { writeFile } from "fs/promises";
+import { createRequire } from "module";
+
+// src/schema/builder.ts
+import { z } from "zod";
+
+// src/client.ts
+var PROVIDER_PREFIXES = [
+  ["claude", "anthropic"],
+  ["gpt", "openai"],
+  ["o1", "openai"],
+  ["o3", "openai"],
+  ["o4", "openai"],
+  ["chatgpt", "openai"],
+  ["gemini", "google"],
+  ["mistral", "mistral"],
+  ["mixtral", "mistral"],
+  ["codestral", "mistral"]
+];
+var detectProviderName = (modelId) => {
+  const lower = modelId.toLowerCase();
+  for (const [prefix, provider] of PROVIDER_PREFIXES) {
+    if (lower.startsWith(prefix)) {
+      return provider;
+    }
+  }
+  return void 0;
+};
+
+// src/cli/generate.ts
+var PROVIDER_PACKAGES = {
+  anthropic: "@ai-sdk/anthropic",
+  openai: "@ai-sdk/openai",
+  google: "@ai-sdk/google",
+  mistral: "@ai-sdk/mistral"
+};
 var DEFAULT_BASE_URL = "https://api.promptlycms.com";
 var extractTemplateVariables = (text) => {
   const matches = text.matchAll(/\$\{(\w+)\}/g);
@@ -215,6 +250,36 @@ var generateTypeDeclaration = (prompts) => {
   lines.push("");
   return lines.join("\n");
 };
+var warnMissingProviders = (prompts) => {
+  const require2 = createRequire(import.meta.url);
+  const needed = /* @__PURE__ */ new Map();
+  for (const prompt of prompts) {
+    const provider = detectProviderName(prompt.config.model);
+    if (!provider) {
+      continue;
+    }
+    const pkg = PROVIDER_PACKAGES[provider];
+    if (!pkg) {
+      continue;
+    }
+    const existing = needed.get(pkg);
+    if (existing) {
+      existing.push(prompt.promptName);
+    } else {
+      needed.set(pkg, [prompt.promptName]);
+    }
+  }
+  for (const [pkg, promptNames] of needed) {
+    try {
+      require2.resolve(pkg);
+    } catch {
+      const names = promptNames.map((n) => `"${n}"`).join(", ");
+      console.warn(
+        `  Warning: ${names} requires ${pkg} \u2014 install it: npm install ${pkg}`
+      );
+    }
+  }
+};
 var generate = async (apiKey, outputPath, baseUrl) => {
   const prompts = await fetchAllPrompts(apiKey, baseUrl);
   if (prompts.length === 0) {
@@ -222,6 +287,7 @@ var generate = async (apiKey, outputPath, baseUrl) => {
     return;
   }
   console.log(`  Found ${prompts.length} prompt(s)`);
+  warnMissingProviders(prompts);
   const content = generateTypeDeclaration(prompts);
   await writeFile(outputPath, content, "utf-8");
   console.log(`  Generated ${outputPath}`);

package/dist/index.cjs

@@ -32,6 +32,7 @@ var src_exports = {};
 __export(src_exports, {
   PromptlyError: () => PromptlyError,
   createPromptlyClient: () => createPromptlyClient,
+  getSdkModelId: () => getSdkModelId,
   interpolate: () => interpolate
 });
 module.exports = __toCommonJS(src_exports);
@@ -352,6 +353,22 @@ var buildZodSchema = (fields) => {
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.promptlycms.com";
+var MODEL_ID_MAP = {
+  // Anthropic: CMS display IDs → API model IDs
+  "claude-opus-4.6": "claude-opus-4-6-20250917",
+  "claude-sonnet-4.5": "claude-sonnet-4-5-20250929",
+  "claude-haiku-4.5": "claude-haiku-4-5-20251001",
+  "claude-opus-4": "claude-opus-4-20250514",
+  "claude-sonnet-4": "claude-sonnet-4-20250514",
+  "claude-3.7-sonnet": "claude-3-7-sonnet-20250219",
+  // Google: CMS display IDs → Gemini SDK model names
+  "gemini-3-pro": "gemini-3.0-pro",
+  "gemini-3-flash": "gemini-3.0-flash",
+  "gemini-3-deep-think": "gemini-3.0-deep-think",
+  "gemini-2.5-pro": "gemini-2.5-pro-latest",
+  "gemini-2.5-flash": "gemini-2.5-flash-preview-05-20"
+};
+var getSdkModelId = (modelId) => MODEL_ID_MAP[modelId] ?? modelId;
 var PROVIDER_PREFIXES = [
   ["claude", "anthropic"],
   ["gpt", "openai"],
@@ -364,12 +381,6 @@ var PROVIDER_PREFIXES = [
   ["mixtral", "mistral"],
   ["codestral", "mistral"]
 ];
-var PROVIDER_PACKAGES = {
-  anthropic: "@ai-sdk/anthropic",
-  openai: "@ai-sdk/openai",
-  google: "@ai-sdk/google",
-  mistral: "@ai-sdk/mistral"
-};
 var detectProviderName = (modelId) => {
   const lower = modelId.toLowerCase();
   for (const [prefix, provider] of PROVIDER_PREFIXES) {
@@ -384,13 +395,28 @@ var resolveModel = async (modelId) => {
   if (!providerName) {
     return void 0;
   }
-  const pkg = PROVIDER_PACKAGES[providerName];
-  if (!pkg) {
-    return void 0;
-  }
+  const sdkModelId = getSdkModelId(modelId);
   try {
-    const mod = await import(pkg);
-    return mod[providerName](modelId);
+    switch (providerName) {
+      case "anthropic": {
+        const { anthropic } = await import("@ai-sdk/anthropic");
+        return anthropic(sdkModelId);
+      }
+      case "openai": {
+        const { openai } = await import("@ai-sdk/openai");
+        return openai(sdkModelId);
+      }
+      case "google": {
+        const { google } = await import("@ai-sdk/google");
+        return google(sdkModelId);
+      }
+      case "mistral": {
+        const { mistral } = await import("@ai-sdk/mistral");
+        return mistral(sdkModelId);
+      }
+      default:
+        return void 0;
+    }
   } catch {
     return void 0;
   }
@@ -407,6 +433,32 @@ var createPromptMessage = (template) => {
   fn.toString = () => template;
   return fn;
 };
+var PROVIDER_PACKAGES = {
+  anthropic: "@ai-sdk/anthropic",
+  openai: "@ai-sdk/openai",
+  google: "@ai-sdk/google",
+  mistral: "@ai-sdk/mistral"
+};
+var createModelResolver = (config) => {
+  if (config?.model) {
+    const userResolver = config.model;
+    return async (modelId) => userResolver(modelId);
+  }
+  return async (modelId) => {
+    const model = await resolveModel(modelId);
+    if (model) {
+      return model;
+    }
+    const providerName = detectProviderName(modelId);
+    const pkg = providerName ? PROVIDER_PACKAGES[providerName] : void 0;
+    const hint = pkg ? `Make sure "${pkg}" is installed: npm install ${pkg}` : `Supported model prefixes: ${PROVIDER_PREFIXES.map(([p]) => p).join(", ")}`;
+    throw new PromptlyError(
+      `Failed to resolve model "${modelId}". ${hint}`,
+      "BAD_REQUEST",
+      0
+    );
+  };
+};
 var createPromptlyClient = (config) => {
   const apiKey = config?.apiKey ?? process.env.PROMPTLY_API_KEY;
   if (!apiKey) {
@@ -417,6 +469,7 @@ var createPromptlyClient = (config) => {
     );
   }
   const baseUrl = config?.baseUrl ?? DEFAULT_BASE_URL;
+  const modelResolver = createModelResolver(config);
   const fetchPrompt = async (promptId, options) => {
     const url = new URL(`/prompts/${promptId}`, baseUrl);
     if (options?.version) {
@@ -434,7 +487,7 @@ var createPromptlyClient = (config) => {
   };
   const getPrompt = async (promptId, options) => {
     const response = await fetchPrompt(promptId, options);
-    const model = await resolveModel(response.config.model);
+    const model = await modelResolver(response.config.model);
     return {
       ...response,
       userMessage: createPromptMessage(response.userMessage),
@@ -455,7 +508,7 @@ var createPromptlyClient = (config) => {
       version: options?.version
     });
     const userMessage = options?.variables ? interpolate(prompt.userMessage, options.variables) : prompt.userMessage;
-    const model = await resolveModel(prompt.config.model);
+    const model = await modelResolver(prompt.config.model);
     const result = {
       system: prompt.systemMessage,
       prompt: userMessage,
@@ -475,5 +528,6 @@ var createPromptlyClient = (config) => {
 0 && (module.exports = {
   PromptlyError,
   createPromptlyClient,
+  getSdkModelId,
   interpolate
 });

package/dist/index.d.cts

@@ -1,7 +1,8 @@
-import { P as PromptlyClientConfig, a as PromptlyClient, E as ErrorCode } from './types-DtbFuFmA.cjs';
-export { A as AiParams, b as AiParamsOptions, c as ErrorResponse, G as GetOptions, d as PromptConfig, e as PromptId, f as PromptMessage, g as PromptRequest, h as PromptResponse, i as PromptResult, j as PromptVariableMap, k as PromptVersion, l as PublishedVersion, S as SchemaField, m as SchemaFieldParams, V as ValidationRule } from './types-DtbFuFmA.cjs';
+import { P as PromptlyClientConfig, a as PromptlyClient, E as ErrorCode } from './types-W-omtl43.cjs';
+export { A as AiParams, b as AiParamsOptions, c as ErrorResponse, G as GetOptions, d as PromptConfig, e as PromptId, f as PromptMessage, g as PromptRequest, h as PromptResponse, i as PromptResult, j as PromptVariableMap, k as PromptVersion, l as PublishedVersion, S as SchemaField, m as SchemaFieldParams, V as ValidationRule } from './types-W-omtl43.cjs';
 import 'ai';
 
+declare const getSdkModelId: (modelId: string) => string;
 declare const interpolate: (template: string, variables: Record<string, string>) => string;
 declare const createPromptlyClient: (config?: PromptlyClientConfig) => PromptlyClient;
 
@@ -13,4 +14,4 @@ declare class PromptlyError extends Error {
     constructor(message: string, code: ErrorCode, status: number, usage?: unknown, upgradeUrl?: string);
 }
 
-export { ErrorCode, PromptlyClient, PromptlyClientConfig, PromptlyError, createPromptlyClient, interpolate };
+export { ErrorCode, PromptlyClient, PromptlyClientConfig, PromptlyError, createPromptlyClient, getSdkModelId, interpolate };

package/dist/index.d.ts

@@ -1,7 +1,8 @@
-import { P as PromptlyClientConfig, a as PromptlyClient, E as ErrorCode } from './types-DtbFuFmA.js';
-export { A as AiParams, b as AiParamsOptions, c as ErrorResponse, G as GetOptions, d as PromptConfig, e as PromptId, f as PromptMessage, g as PromptRequest, h as PromptResponse, i as PromptResult, j as PromptVariableMap, k as PromptVersion, l as PublishedVersion, S as SchemaField, m as SchemaFieldParams, V as ValidationRule } from './types-DtbFuFmA.js';
+import { P as PromptlyClientConfig, a as PromptlyClient, E as ErrorCode } from './types-W-omtl43.js';
+export { A as AiParams, b as AiParamsOptions, c as ErrorResponse, G as GetOptions, d as PromptConfig, e as PromptId, f as PromptMessage, g as PromptRequest, h as PromptResponse, i as PromptResult, j as PromptVariableMap, k as PromptVersion, l as PublishedVersion, S as SchemaField, m as SchemaFieldParams, V as ValidationRule } from './types-W-omtl43.js';
 import 'ai';
 
+declare const getSdkModelId: (modelId: string) => string;
 declare const interpolate: (template: string, variables: Record<string, string>) => string;
 declare const createPromptlyClient: (config?: PromptlyClientConfig) => PromptlyClient;
 
@@ -13,4 +14,4 @@ declare class PromptlyError extends Error {
     constructor(message: string, code: ErrorCode, status: number, usage?: unknown, upgradeUrl?: string);
 }
 
-export { ErrorCode, PromptlyClient, PromptlyClientConfig, PromptlyError, createPromptlyClient, interpolate };
+export { ErrorCode, PromptlyClient, PromptlyClientConfig, PromptlyError, createPromptlyClient, getSdkModelId, interpolate };

package/dist/index.js

@@ -38,6 +38,22 @@ var createErrorFromResponse = async (response) => {
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.promptlycms.com";
+var MODEL_ID_MAP = {
+  // Anthropic: CMS display IDs → API model IDs
+  "claude-opus-4.6": "claude-opus-4-6-20250917",
+  "claude-sonnet-4.5": "claude-sonnet-4-5-20250929",
+  "claude-haiku-4.5": "claude-haiku-4-5-20251001",
+  "claude-opus-4": "claude-opus-4-20250514",
+  "claude-sonnet-4": "claude-sonnet-4-20250514",
+  "claude-3.7-sonnet": "claude-3-7-sonnet-20250219",
+  // Google: CMS display IDs → Gemini SDK model names
+  "gemini-3-pro": "gemini-3.0-pro",
+  "gemini-3-flash": "gemini-3.0-flash",
+  "gemini-3-deep-think": "gemini-3.0-deep-think",
+  "gemini-2.5-pro": "gemini-2.5-pro-latest",
+  "gemini-2.5-flash": "gemini-2.5-flash-preview-05-20"
+};
+var getSdkModelId = (modelId) => MODEL_ID_MAP[modelId] ?? modelId;
 var PROVIDER_PREFIXES = [
   ["claude", "anthropic"],
   ["gpt", "openai"],
@@ -50,12 +66,6 @@ var PROVIDER_PREFIXES = [
   ["mixtral", "mistral"],
   ["codestral", "mistral"]
 ];
-var PROVIDER_PACKAGES = {
-  anthropic: "@ai-sdk/anthropic",
-  openai: "@ai-sdk/openai",
-  google: "@ai-sdk/google",
-  mistral: "@ai-sdk/mistral"
-};
 var detectProviderName = (modelId) => {
   const lower = modelId.toLowerCase();
   for (const [prefix, provider] of PROVIDER_PREFIXES) {
@@ -70,13 +80,28 @@ var resolveModel = async (modelId) => {
   if (!providerName) {
     return void 0;
   }
-  const pkg = PROVIDER_PACKAGES[providerName];
-  if (!pkg) {
-    return void 0;
-  }
+  const sdkModelId = getSdkModelId(modelId);
   try {
-    const mod = await import(pkg);
-    return mod[providerName](modelId);
+    switch (providerName) {
+      case "anthropic": {
+        const { anthropic } = await import("@ai-sdk/anthropic");
+        return anthropic(sdkModelId);
+      }
+      case "openai": {
+        const { openai } = await import("@ai-sdk/openai");
+        return openai(sdkModelId);
+      }
+      case "google": {
+        const { google } = await import("@ai-sdk/google");
+        return google(sdkModelId);
+      }
+      case "mistral": {
+        const { mistral } = await import("@ai-sdk/mistral");
+        return mistral(sdkModelId);
+      }
+      default:
+        return void 0;
+    }
   } catch {
     return void 0;
   }
@@ -93,6 +118,32 @@ var createPromptMessage = (template) => {
   fn.toString = () => template;
   return fn;
 };
+var PROVIDER_PACKAGES = {
+  anthropic: "@ai-sdk/anthropic",
+  openai: "@ai-sdk/openai",
+  google: "@ai-sdk/google",
+  mistral: "@ai-sdk/mistral"
+};
+var createModelResolver = (config) => {
+  if (config?.model) {
+    const userResolver = config.model;
+    return async (modelId) => userResolver(modelId);
+  }
+  return async (modelId) => {
+    const model = await resolveModel(modelId);
+    if (model) {
+      return model;
+    }
+    const providerName = detectProviderName(modelId);
+    const pkg = providerName ? PROVIDER_PACKAGES[providerName] : void 0;
+    const hint = pkg ? `Make sure "${pkg}" is installed: npm install ${pkg}` : `Supported model prefixes: ${PROVIDER_PREFIXES.map(([p]) => p).join(", ")}`;
+    throw new PromptlyError(
+      `Failed to resolve model "${modelId}". ${hint}`,
+      "BAD_REQUEST",
+      0
+    );
+  };
+};
 var createPromptlyClient = (config) => {
   const apiKey = config?.apiKey ?? process.env.PROMPTLY_API_KEY;
   if (!apiKey) {
@@ -103,6 +154,7 @@ var createPromptlyClient = (config) => {
     );
   }
   const baseUrl = config?.baseUrl ?? DEFAULT_BASE_URL;
+  const modelResolver = createModelResolver(config);
   const fetchPrompt = async (promptId, options) => {
     const url = new URL(`/prompts/${promptId}`, baseUrl);
     if (options?.version) {
@@ -120,7 +172,7 @@ var createPromptlyClient = (config) => {
   };
   const getPrompt = async (promptId, options) => {
     const response = await fetchPrompt(promptId, options);
-    const model = await resolveModel(response.config.model);
+    const model = await modelResolver(response.config.model);
     return {
       ...response,
       userMessage: createPromptMessage(response.userMessage),
@@ -141,7 +193,7 @@ var createPromptlyClient = (config) => {
       version: options?.version
     });
     const userMessage = options?.variables ? interpolate(prompt.userMessage, options.variables) : prompt.userMessage;
-    const model = await resolveModel(prompt.config.model);
+    const model = await modelResolver(prompt.config.model);
     const result = {
       system: prompt.systemMessage,
       prompt: userMessage,
@@ -160,5 +212,6 @@ var createPromptlyClient = (config) => {
 export {
   PromptlyError,
   createPromptlyClient,
+  getSdkModelId,
   interpolate
 };

package/dist/schema.d.cts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { S as SchemaField } from './types-DtbFuFmA.cjs';
+import { S as SchemaField } from './types-W-omtl43.cjs';
 import 'ai';
 
 declare const buildFieldSchema: (field: SchemaField) => z.ZodTypeAny;

package/dist/schema.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { S as SchemaField } from './types-DtbFuFmA.js';
+import { S as SchemaField } from './types-W-omtl43.js';
 import 'ai';
 
 declare const buildFieldSchema: (field: SchemaField) => z.ZodTypeAny;

package/dist/{types-DtbFuFmA.d.cts → types-W-omtl43.d.cts}

@@ -105,6 +105,7 @@ type ErrorResponse = {
 type PromptlyClientConfig = {
     apiKey?: string;
     baseUrl?: string;
+    model?: (modelId: string) => ai.LanguageModel;
 };
 type GetOptions<V extends string = string> = {
     version?: V;

package/dist/{types-DtbFuFmA.d.ts → types-W-omtl43.d.ts}

@@ -105,6 +105,7 @@ type ErrorResponse = {
 type PromptlyClientConfig = {
     apiKey?: string;
     baseUrl?: string;
+    model?: (modelId: string) => ai.LanguageModel;
 };
 type GetOptions<V extends string = string> = {
     version?: V;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@promptlycms/prompts",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "TypeScript SDK for Promptly CMS — fetch prompts, build Zod schemas, generate typed code",
   "type": "module",
   "exports": {
@@ -36,6 +36,10 @@
     "citty": "^0.2.1"
   },
   "devDependencies": {
+    "@ai-sdk/anthropic": "^3.0.44",
+    "@ai-sdk/google": "^3.0.29",
+    "@ai-sdk/mistral": "^3.0.20",
+    "@ai-sdk/openai": "^3.0.29",
     "@biomejs/biome": "^2.3.15",
     "@changesets/changelog-github": "^0.5.2",
     "@changesets/cli": "^2.29.8",