lingodotdev · The-Best-Codes · Nov 8, 2025 · Nov 8, 2025 · Nov 10, 2025 · Nov 11, 2025
diff --git a/.changeset/pink-lemons-buy.md b/.changeset/pink-lemons-buy.md
@@ -0,0 +1,6 @@
+---
+"@lingo.dev/_compiler": minor
+"lingo.dev": minor
+---
+
+Upgrade Compiler and CLI to AI SDK v5.
diff --git a/packages/cli/package.json b/packages/cli/package.json
@@ -122,10 +122,10 @@
   "author": "",
   "license": "Apache-2.0",
   "dependencies": {
-    "@ai-sdk/anthropic": "^1.2.11",
-    "@ai-sdk/google": "^1.2.19",
-    "@ai-sdk/mistral": "^1.2.8",
-    "@ai-sdk/openai": "^1.3.22",
+    "@ai-sdk/anthropic": "^2.0.42",
+    "@ai-sdk/google": "^2.0.29",
+    "@ai-sdk/mistral": "^2.0.23",
+    "@ai-sdk/openai": "^2.0.64",
     "@babel/generator": "^7.27.1",
     "@babel/parser": "^7.27.1",
     "@babel/traverse": "^7.27.4",
@@ -143,10 +143,10 @@
     "@lingo.dev/_spec": "workspace:*",
     "@markdoc/markdoc": "^0.5.4",
     "@modelcontextprotocol/sdk": "^1.5.0",
-    "@openrouter/ai-sdk-provider": "^0.7.1",
+    "@openrouter/ai-sdk-provider": "^1.2.1",
     "@paralleldrive/cuid2": "^2.2.2",
     "@types/ejs": "^3.1.5",
-    "ai": "^4.3.15",
+    "ai": "^5.0.89",
     "bitbucket": "^2.12.0",
     "chalk": "^5.4.1",
     "chokidar": "^4.0.3",
@@ -189,7 +189,7 @@
     "node-webvtt": "^1.9.4",
     "object-hash": "^3.0.0",
     "octokit": "^4.0.2",
-    "ollama-ai-provider": "^1.2.0",
+    "ollama-ai-provider-v2": "^1.5.3",
     "open": "^10.2.0",
     "ora": "^8.1.1",
     "p-limit": "^6.2.0",
@@ -216,7 +216,7 @@
     "xml2js": "^0.6.2",
     "xpath": "^0.0.34",
     "yaml": "^2.7.0",
-    "zod": "^3.25.76"
+    "zod": "^4.1.12"
   },
   "devDependencies": {
     "@types/babel__generator": "^7.27.0",

diff --git a/packages/cli/src/cli/cmd/i18n.ts b/packages/cli/src/cli/cmd/i18n.ts
@@ -637,8 +637,8 @@ function parseFlags(options: any) {
     strict: Z.boolean().optional(),
     key: Z.string().optional(),
     file: Z.array(Z.string()).optional(),
-    interactive: Z.boolean().default(false),
-    debug: Z.boolean().default(false),
+    interactive: Z.boolean().prefault(false),
+    debug: Z.boolean().prefault(false),
   }).parse(options);
 }
 

diff --git a/packages/cli/src/cli/cmd/lockfile.ts b/packages/cli/src/cli/cmd/lockfile.ts
@@ -61,5 +61,5 @@ export default new Command()
   });
 
 const flagsSchema = Z.object({
-  force: Z.boolean().default(false),
+  force: Z.boolean().prefault(false),
 });
diff --git a/packages/cli/src/cli/cmd/mcp.ts b/packages/cli/src/cli/cmd/mcp.ts
@@ -48,8 +48,8 @@ export default new Command()
       "translate",
       "Detect language and translate text with Lingo.dev.",
       {
-        text: Z.string(),
-        targetLocale: Z.string().regex(/^[a-z]{2}(-[A-Z]{2})?$/),
+        text: Z.string() as any,
+        targetLocale: Z.string().regex(/^[a-z]{2}(-[A-Z]{2})?$/) as any,
       },
       async ({ text, targetLocale }) => {
         const sourceLocale = await replexicaEngine.recognizeLocale(text);

diff --git a/packages/cli/src/cli/cmd/run/_types.ts b/packages/cli/src/cli/cmd/run/_types.ts
@@ -45,13 +45,13 @@ export const flagsSchema = z.object({
   frozen: z.boolean().optional(),
   verbose: z.boolean().optional(),
   strict: z.boolean().optional(),
-  interactive: z.boolean().default(false),
-  concurrency: z.number().positive().default(10),
-  debug: z.boolean().default(false),
+  interactive: z.boolean().prefault(false),
+  concurrency: z.number().positive().prefault(10),
+  debug: z.boolean().prefault(false),
   sourceLocale: z.string().optional(),
   targetLocale: z.array(z.string()).optional(),
-  watch: z.boolean().default(false),
-  debounce: z.number().positive().default(5000), // 5 seconds default
+  watch: z.boolean().prefault(false),
+  debounce: z.number().positive().prefault(5000), // 5 seconds default
   sound: z.boolean().optional(),
 });
 export type CmdRunFlags = z.infer<typeof flagsSchema>;
diff --git a/packages/cli/src/cli/localizer/explicit.ts b/packages/cli/src/cli/localizer/explicit.ts
@@ -7,10 +7,10 @@ import { I18nConfig } from "@lingo.dev/_spec";
 import chalk from "chalk";
 import dedent from "dedent";
 import { ILocalizer, LocalizerData } from "./_types";
-import { LanguageModel, Message, generateText } from "ai";
+import { LanguageModel, ModelMessage, generateText } from "ai";
 import { colors } from "../constants";
 import { jsonrepair } from "jsonrepair";
-import { createOllama } from "ollama-ai-provider";
+import { createOllama } from "ollama-ai-provider-v2";
 
 export default function createExplicitLocalizer(
   provider: NonNullable<I18nConfig["provider"]>,
@@ -207,7 +207,7 @@ function createAiSdkLocalizer(params: {
               [
                 { role: "user", content: JSON.stringify(userShot) },
                 { role: "assistant", content: JSON.stringify(assistantShot) },
-              ] as Message[],
+              ] as ModelMessage[],
           ),
           { role: "user", content: JSON.stringify(payload) },
         ],

diff --git a/packages/cli/src/cli/processor/basic.ts b/packages/cli/src/cli/processor/basic.ts
@@ -1,4 +1,4 @@
-import { generateText, LanguageModelV1 } from "ai";
+import { generateText, LanguageModel } from "ai";
 import { LocalizerInput, LocalizerProgressFn } from "./_base";
 import _ from "lodash";
 
@@ -7,7 +7,7 @@ type ModelSettings = {
 };
 
 export function createBasicTranslator(
-  model: LanguageModelV1,
+  model: LanguageModel,
   systemPrompt: string,
   settings: ModelSettings = {},
 ) {

diff --git a/packages/cli/src/cli/processor/index.ts b/packages/cli/src/cli/processor/index.ts
@@ -10,7 +10,7 @@ import { createAnthropic } from "@ai-sdk/anthropic";
 import { createGoogleGenerativeAI } from "@ai-sdk/google";
 import { createOpenRouter } from "@openrouter/ai-sdk-provider";
 import { createMistral } from "@ai-sdk/mistral";
-import { createOllama } from "ollama-ai-provider";
+import { createOllama } from "ollama-ai-provider-v2";
 
 export default function createProcessor(
   provider: I18nConfig["provider"],

diff --git a/packages/cli/src/cli/utils/delta.ts b/packages/cli/src/cli/utils/delta.ts
@@ -6,7 +6,7 @@ import * as path from "path";
 import YAML from "yaml";
 
 const LockSchema = z.object({
-  version: z.literal(1).default(1),
+  version: z.literal(1).prefault(1),
   checksums: z
     .record(
       z.string(), // localizable files' keys
@@ -18,9 +18,9 @@ const LockSchema = z.object({
           // checksum of the key's value in the source locale
           z.string(),
         )
-        .default({}),
+        .prefault({}),
     )
-    .default({}),
+    .prefault({}),
 });
 export type LockData = z.infer<typeof LockSchema>;
 

diff --git a/packages/cli/src/cli/utils/exec.ts b/packages/cli/src/cli/utils/exec.ts
@@ -65,20 +65,20 @@ export async function execWithRetry(
 // Helpers
 
 const ExecAsyncSchema = Z.object({
-  delay: Z.number().nonnegative().default(1000),
-  concurrency: Z.number().positive().default(1),
-  onProgress: Z.function(
-    Z.tuple([
+  delay: Z.number().nonnegative().prefault(1000),
+  concurrency: Z.number().positive().prefault(1),
+  onProgress: Z.function({
+    input: Z.tuple([
       Z.number().positive(), // completed count
       Z.number().positive(), // total count
     ]),
-    Z.void(),
-  ).optional(),
+    output: Z.void(),
+  }).optional(),
 });
 
 const ExecWithRetrySchema = Z.object({
-  delay: Z.number().nonnegative().default(0),
-  attempts: Z.number().positive().default(3),
+  delay: Z.number().nonnegative().prefault(0),
+  attempts: Z.number().positive().prefault(3),
 });
 
 function delay(ms: number) {

diff --git a/packages/cli/src/cli/utils/lockfile.ts b/packages/cli/src/cli/utils/lockfile.ts
@@ -84,13 +84,13 @@ export function createLockfileHelper() {
 }
 
 const LockfileSchema = Z.object({
-  version: Z.literal(1).default(1),
+  version: Z.literal(1).prefault(1),
   checksums: Z.record(
     Z.string(), // localizable files' keys
     Z.record(
       // checksums hashmap
       Z.string(), // key
       Z.string(), // checksum of the key's value in the source locale
-    ).default({}),
-  ).default({}),
+    ).prefault({}),
+  ).prefault({}),
 });
diff --git a/packages/cli/src/cli/utils/settings.ts b/packages/cli/src/cli/utils/settings.ts
@@ -96,7 +96,7 @@ function _loadDefaults(): CliSettings {
 }
 
 function _loadEnv() {
-  return Z.object({
+  return Z.looseObject({
     LINGODOTDEV_API_KEY: Z.string().optional(),
     LINGODOTDEV_API_URL: Z.string().optional(),
     LINGODOTDEV_WEB_URL: Z.string().optional(),
@@ -106,9 +106,7 @@ function _loadEnv() {
     GOOGLE_API_KEY: Z.string().optional(),
     OPENROUTER_API_KEY: Z.string().optional(),
     MISTRAL_API_KEY: Z.string().optional(),
-  })
-    .passthrough()
-    .parse(process.env);
+  }).parse(process.env);
 }
 
 function _loadSystemFile() {
@@ -118,23 +116,21 @@ function _loadSystemFile() {
     : "";
   const data = Ini.parse(content);
 
-  return Z.object({
-    auth: Z.object({
+  return Z.looseObject({
+    auth: Z.looseObject({
       apiKey: Z.string().optional(),
       apiUrl: Z.string().optional(),
       webUrl: Z.string().optional(),
     }).optional(),
-    llm: Z.object({
+    llm: Z.looseObject({
       openaiApiKey: Z.string().optional(),
       anthropicApiKey: Z.string().optional(),
       groqApiKey: Z.string().optional(),
       googleApiKey: Z.string().optional(),
       openrouterApiKey: Z.string().optional(),
       mistralApiKey: Z.string().optional(),
     }).optional(),
-  })
-    .passthrough()
-    .parse(data);
+  }).parse(data);
 }
 
 function _saveSystemFile(settings: CliSettings) {

diff --git a/packages/compiler/package.json b/packages/compiler/package.json
@@ -45,30 +45,32 @@
     "vitest": "^2.1.4"
   },
   "dependencies": {
-    "@ai-sdk/anthropic": "^1.0.11",
-    "@ai-sdk/google": "^1.2.19",
-    "@ai-sdk/groq": "^1.2.3",
-    "@ai-sdk/mistral": "^1.2.8",
-    "@ai-sdk/openai": "^1.3.22",
+    "@ai-sdk/anthropic": "^2.0.45",
+    "@ai-sdk/google": "^2.0.29",
+    "@ai-sdk/groq": "^2.0.28",
+    "@ai-sdk/mistral": "^2.0.23",
+    "@ai-sdk/openai": "^2.0.68",
     "@babel/generator": "^7.26.5",
     "@babel/parser": "^7.26.7",
     "@babel/traverse": "^7.27.4",
     "@babel/types": "^7.26.7",
     "@lingo.dev/_sdk": "workspace:*",
     "@lingo.dev/_spec": "workspace:*",
-    "@openrouter/ai-sdk-provider": "^0.7.1",
-    "ai": "^4.2.10",
+    "@openrouter/ai-sdk-provider": "^1.2.1",
+    "@prettier/sync": "^0.6.1",
+    "ai": "^5.0.89",
     "dedent": "^1.6.0",
     "dotenv": "^16.4.5",
     "fast-xml-parser": "^5.0.8",
     "ini": "^5.0.0",
     "lodash": "^4.17.21",
+    "node-machine-id": "^1.1.12",
     "object-hash": "^3.0.0",
-    "ollama-ai-provider": "^1.2.0",
-    "unplugin": "^2.1.2",
-    "zod": "^3.25.76",
+    "ollama-ai-provider-v2": "^1.5.3",
     "posthog-node": "^5.5.1",
-    "node-machine-id": "^1.1.12"
+    "prettier": "^3.4.2",
+    "unplugin": "^2.1.2",
+    "zod": "^4.1.12"
   },
   "packageManager": "[email protected]"
 }
diff --git a/packages/compiler/src/lib/lcp/api/index.ts b/packages/compiler/src/lib/lcp/api/index.ts
@@ -1,7 +1,7 @@
 import { createGroq } from "@ai-sdk/groq";
 import { createGoogleGenerativeAI } from "@ai-sdk/google";
 import { createOpenRouter } from "@openrouter/ai-sdk-provider";
-import { createOllama } from "ollama-ai-provider";
+import { createOllama } from "ollama-ai-provider-v2";
 import { createMistral } from "@ai-sdk/mistral";
 import { createOpenAI } from "@ai-sdk/openai";
 import { createAnthropic } from "@ai-sdk/anthropic";

diff --git a/packages/compiler/src/lib/lcp/schema.ts b/packages/compiler/src/lib/lcp/schema.ts
@@ -20,7 +20,7 @@ export const lcpFile = z.object({
 export type LCPFile = z.infer<typeof lcpFile>;
 
 export const lcpSchema = z.object({
-  version: z.number().default(0.1),
+  version: z.number().prefault(0.1),
   files: z.record(z.string(), lcpFile).optional(),
 });
 
@@ -35,7 +35,7 @@ export const dictionaryFile = z.object({
 export type DictionaryFile = z.infer<typeof dictionaryFile>;
 
 export const dictionarySchema = z.object({
-  version: z.number().default(0.1),
+  version: z.number().prefault(0.1),
   locale: z.string(),
   files: z.record(z.string(), dictionaryFile),
 });
@@ -55,7 +55,7 @@ export const dictionaryCacheFile = z.object({
 });
 
 export const dictionaryCacheSchema = z.object({
-  version: z.number().default(0.1),
+  version: z.number().prefault(0.1),
   files: z.record(z.string(), dictionaryCacheFile),
 });
 

diff --git a/packages/sdk/package.json b/packages/sdk/package.json
@@ -27,7 +27,7 @@
     "@lingo.dev/_spec": "workspace:*",
     "@paralleldrive/cuid2": "^2.2.2",
     "jsdom": "^25.0.1",
-    "zod": "^3.25.76"
+    "zod": "^4.1.12"
   },
   "devDependencies": {
     "@types/jsdom": "^21.1.7",

diff --git a/packages/spec/package.json b/packages/spec/package.json
@@ -26,8 +26,7 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@lingo.dev/_locales": "workspace:*",
-    "zod": "^3.25.76",
-    "zod-to-json-schema": "^3.24.5"
+    "zod": "^4.1.12"
   },
   "devDependencies": {
     "@types/node": "^22.13.5",