@intlayer/ai 8.4.3 → 8.4.5

package/dist/cjs/translateJSON/index.cjs

@@ -1,8 +1,137 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../aiSdk-Du5xFzsz.cjs`);const e=require(`../_utils_asset-mukucLSM.cjs`),t=require(`../utils/extractJSON.cjs`);let n=require(`ai`),r=require(`zod`),i=require(`@intlayer/core/localization`),a=require(`@intlayer/types/locales`),o=require(`@toon-format/toon`);const s={provider:require(`@intlayer/types/config`).AiProviders.OPENAI,model:`gpt-5-mini`},c=e=>`${e}: ${(0,i.getLocaleName)(e,a.ENGLISH)}`,l=e=>!e||e.length===0?``:`Based on the dictionary content, identify specific tags from the list below that would be relevant:
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require__utils_asset = require('../_virtual/_utils_asset.cjs');
+const require_utils_extractJSON = require('../utils/extractJSON.cjs');
+let ai = require("ai");
+let zod = require("zod");
+let _intlayer_core_localization = require("@intlayer/core/localization");
+let _intlayer_types_locales = require("@intlayer/types/locales");
+let _toon_format_toon = require("@toon-format/toon");
+let _intlayer_types_config = require("@intlayer/types/config");
+
+//#region src/translateJSON/index.ts
+const aiDefaultOptions = {
+	provider: _intlayer_types_config.AiProviders.OPENAI,
+	model: "gpt-5-mini"
+};
+/**
+* Format a locale with its name.
+*
+* @param locale - The locale to format.
+* @returns A string in the format "locale: name", e.g. "en: English".
+*/
+const formatLocaleWithName = (locale) => `${locale}: ${(0, _intlayer_core_localization.getLocaleName)(locale, _intlayer_types_locales.ENGLISH)}`;
+/**
+* Formats tag instructions for the AI prompt.
+* Creates a string with all available tags and their descriptions.
+*
+* @param tags - The list of tags to format.
+* @returns A formatted string with tag instructions.
+*/
+const formatTagInstructions = (tags) => {
+	if (!tags || tags.length === 0) return "";
+	return `Based on the dictionary content, identify specific tags from the list below that would be relevant:
   
-${e.map(({key:e,description:t})=>`- ${e}: ${t}`).join(`
+${tags.map(({ key, description }) => `- ${key}: ${description}`).join("\n\n")}`;
+};
+const getModeInstructions = (mode) => {
+	if (mode === "complete") return "Mode: \"Complete\" - Enrich the preset content with the missing keys and values in the output locale. Do not update existing keys. Everything should be returned in the output.";
+	return "Mode: \"Review\" - Fill missing content and review existing keys from the preset content. If a key from the entry is missing in the output, it must be translated to the target language and added. If you detect misspelled content, or content that should be reformulated, correct it. If a translation is not coherent with the desired language, translate it.";
+};
+const jsonToZod = (content) => {
+	if (typeof content === "string") return zod.z.string();
+	if (typeof content === "number") return zod.z.number();
+	if (typeof content === "boolean") return zod.z.boolean();
+	if (Array.isArray(content)) {
+		if (content.length === 0) return zod.z.array(zod.z.string());
+		return zod.z.array(jsonToZod(content[0]));
+	}
+	if (typeof content === "object" && content !== null) {
+		const shape = {};
+		for (const key in content) shape[key] = jsonToZod(content[key]);
+		return zod.z.object(shape);
+	}
+	return zod.z.string();
+};
+const countKeys = (obj) => {
+	if (typeof obj !== "object" || obj === null) return 0;
+	let count = 0;
+	for (const key in obj) count += 1 + countKeys(obj[key]);
+	return count;
+};
+/**
+* TranslateJSONs a content declaration file by constructing a prompt for AI models.
+* The prompt includes details about the project's locales, file paths of content declarations,
+* and requests for identifying issues or inconsistencies.
+*/
+const translateJSON = async ({ entryFileContent, presetOutputContent, dictionaryDescription, aiConfig, entryLocale, outputLocale, tags, mode, applicationContext }) => {
+	const { dataSerialization, ...restAiConfig } = aiConfig;
+	const { output: _unusedOutput, ...validAiConfig } = restAiConfig;
+	const formattedEntryLocale = formatLocaleWithName(entryLocale);
+	const formattedOutputLocale = formatLocaleWithName(outputLocale);
+	const isToon = dataSerialization === "toon";
+	const promptFile = require__utils_asset.readAsset(isToon ? "./PROMPT_TOON.md" : "./PROMPT_JSON.md");
+	const entryContentStr = isToon ? (0, _toon_format_toon.encode)(entryFileContent) : JSON.stringify(entryFileContent);
+	const presetContentStr = isToon ? (0, _toon_format_toon.encode)(presetOutputContent) : JSON.stringify(presetOutputContent);
+	const schema = jsonToZod(entryFileContent);
+	const prompt = promptFile.replace("{{entryLocale}}", formattedEntryLocale).replace("{{outputLocale}}", formattedOutputLocale).replace("{{presetOutputContent}}", presetContentStr).replace("{{dictionaryDescription}}", dictionaryDescription ?? "").replace("{{applicationContext}}", applicationContext ?? "").replace("{{tagsInstructions}}", formatTagInstructions(tags ?? [])).replace("{{modeInstructions}}", getModeInstructions(mode));
+	if (isToon) {
+		const { text, usage } = await (0, ai.generateText)({
+			...aiConfig,
+			messages: [{
+				role: "system",
+				content: prompt
+			}, {
+				role: "user",
+				content: [
+					`# Translation Request`,
+					`Please translate the following TOON content.`,
+					`- **From:** ${formattedEntryLocale}`,
+					`- **To:** ${formattedOutputLocale}`,
+					``,
+					`## Entry Content:`,
+					entryContentStr
+				].join("\n")
+			}]
+		});
+		return {
+			fileContent: (0, _toon_format_toon.decode)(text.replace(/^```(?:toon)?\n([\s\S]*?)\n```$/gm, "$1").trim()),
+			tokenUsed: usage?.totalTokens ?? 0
+		};
+	}
+	const useStrictOutput = countKeys(entryFileContent) <= 70;
+	const { text, usage } = await (0, ai.generateText)({
+		...validAiConfig,
+		output: useStrictOutput ? ai.Output.object({ schema }) : void 0,
+		messages: [{
+			role: "system",
+			content: prompt
+		}, {
+			role: "user",
+			content: [
+				`# Translation Request`,
+				`Please translate the following JSON content.`,
+				`- **From:** ${formattedEntryLocale}`,
+				`- **To:** ${formattedOutputLocale}`,
+				``,
+				`CRITICAL INSTRUCTIONS:`,
+				`- You MUST return ONLY raw, valid JSON.`,
+				`- DO NOT wrap the response in Markdown code blocks (e.g., no \`\`\`json).`,
+				`- DO NOT include any conversational text before or after the JSON object.`,
+				``,
+				`## Entry Content:`,
+				entryContentStr
+			].join("\n")
+		}]
+	});
+	const extractedJSON = require_utils_extractJSON.extractJson(text);
+	return {
+		fileContent: schema.parse(extractedJSON),
+		tokenUsed: usage?.totalTokens ?? 0
+	};
+};
 
-`)}`,u=e=>e===`complete`?`Mode: "Complete" - Enrich the preset content with the missing keys and values in the output locale. Do not update existing keys. Everything should be returned in the output.`:`Mode: "Review" - Fill missing content and review existing keys from the preset content. If a key from the entry is missing in the output, it must be translated to the target language and added. If you detect misspelled content, or content that should be reformulated, correct it. If a translation is not coherent with the desired language, translate it.`,d=e=>{if(typeof e==`string`)return r.z.string();if(typeof e==`number`)return r.z.number();if(typeof e==`boolean`)return r.z.boolean();if(Array.isArray(e))return e.length===0?r.z.array(r.z.string()):r.z.array(d(e[0]));if(typeof e==`object`&&e){let t={};for(let n in e)t[n]=d(e[n]);return r.z.object(t)}return r.z.string()},f=e=>{if(typeof e!=`object`||!e)return 0;let t=0;for(let n in e)t+=1+f(e[n]);return t},p=async({entryFileContent:r,presetOutputContent:i,dictionaryDescription:a,aiConfig:s,entryLocale:p,outputLocale:m,tags:h,mode:g,applicationContext:_})=>{let{dataSerialization:v,...y}=s,{output:b,...x}=y,S=c(p),C=c(m),w=v===`toon`,T=e.t(w?`./PROMPT_TOON.md`:`./PROMPT_JSON.md`),E=w?(0,o.encode)(r):JSON.stringify(r),D=w?(0,o.encode)(i):JSON.stringify(i),O=d(r),k=T.replace(`{{entryLocale}}`,S).replace(`{{outputLocale}}`,C).replace(`{{presetOutputContent}}`,D).replace(`{{dictionaryDescription}}`,a??``).replace(`{{applicationContext}}`,_??``).replace(`{{tagsInstructions}}`,l(h??[])).replace(`{{modeInstructions}}`,u(g));if(w){let{text:e,usage:t}=await(0,n.generateText)({...s,messages:[{role:`system`,content:k},{role:`user`,content:[`# Translation Request`,`Please translate the following TOON content.`,`- **From:** ${S}`,`- **To:** ${C}`,``,`## Entry Content:`,E].join(`
-`)}]});return{fileContent:(0,o.decode)(e.replace(/^```(?:toon)?\n([\s\S]*?)\n```$/gm,`$1`).trim()),tokenUsed:t?.totalTokens??0}}let A=f(r)<=70,{text:j,usage:M}=await(0,n.generateText)({...x,output:A?n.Output.object({schema:O}):void 0,messages:[{role:`system`,content:k},{role:`user`,content:[`# Translation Request`,`Please translate the following JSON content.`,`- **From:** ${S}`,`- **To:** ${C}`,``,`CRITICAL INSTRUCTIONS:`,`- You MUST return ONLY raw, valid JSON.`,"- DO NOT wrap the response in Markdown code blocks (e.g., no ```json).",`- DO NOT include any conversational text before or after the JSON object.`,``,`## Entry Content:`,E].join(`
-`)}]}),N=t.extractJson(j);return{fileContent:O.parse(N),tokenUsed:M?.totalTokens??0}};exports.aiDefaultOptions=s,exports.translateJSON=p;
+//#endregion
+exports.aiDefaultOptions = aiDefaultOptions;
+exports.translateJSON = translateJSON;
 //# sourceMappingURL=index.cjs.map

package/dist/cjs/translateJSON/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["AIProvider","ENGLISH","z","readAsset","Output","extractJson"],"sources":["../../../src/translateJSON/index.ts"],"sourcesContent":["import { readAsset } from 'utils:asset';\nimport { getLocaleName } from '@intlayer/core/localization';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport { ENGLISH } from '@intlayer/types/locales';\nimport { decode, encode } from '@toon-format/toon';\nimport { generateText, Output } from 'ai';\nimport { z } from 'zod';\nimport { type AIConfig, type AIOptions, AIProvider } from '../aiSdk';\nimport { extractJson } from '../utils/extractJSON';\n\ntype Tag = {\n  key: string;\n  description?: string;\n};\n\nexport type TranslateJSONOptions<T = JSON> = {\n  entryFileContent: T;\n  presetOutputContent: Partial<T>;\n  dictionaryDescription?: string;\n  entryLocale: Locale;\n  outputLocale: Locale;\n  tags?: Tag[];\n  aiConfig: AIConfig;\n  mode: 'complete' | 'review';\n  applicationContext?: string;\n};\n\nexport type TranslateJSONResultData<T = JSON> = {\n  fileContent: T;\n  tokenUsed: number;\n};\n\nexport const aiDefaultOptions: AIOptions = {\n  provider: AIProvider.OPENAI,\n  model: 'gpt-5-mini',\n};\n\n/**\n * Format a locale with its name.\n *\n * @param locale - The locale to format.\n * @returns A string in the format \"locale: name\", e.g. \"en: English\".\n */\nconst formatLocaleWithName = (locale: Locale): string =>\n  `${locale}: ${getLocaleName(locale, ENGLISH)}`;\n\n/**\n * Formats tag instructions for the AI prompt.\n * Creates a string with all available tags and their descriptions.\n *\n * @param tags - The list of tags to format.\n * @returns A formatted string with tag instructions.\n */\nconst formatTagInstructions = (tags: Tag[]): string => {\n  if (!tags || tags.length === 0) {\n    return '';\n  }\n\n  // Prepare the tag instructions.\n  return `Based on the dictionary content, identify specific tags from the list below that would be relevant:\n  \n${tags.map(({ key, description }) => `- ${key}: ${description}`).join('\\n\\n')}`;\n};\n\nconst getModeInstructions = (mode: 'complete' | 'review'): string => {\n  if (mode === 'complete') {\n    return 'Mode: \"Complete\" - Enrich the preset content with the missing keys and values in the output locale. Do not update existing keys. Everything should be returned in the output.';\n  }\n\n  return 'Mode: \"Review\" - Fill missing content and review existing keys from the preset content. If a key from the entry is missing in the output, it must be translated to the target language and added. If you detect misspelled content, or content that should be reformulated, correct it. If a translation is not coherent with the desired language, translate it.';\n};\n\nconst jsonToZod = (content: any): z.ZodTypeAny => {\n  // Base case: content is a string (the translation target)\n  if (typeof content === 'string') {\n    return z.string();\n  }\n\n  // Base cases: primitives often preserved in i18n files (e.g. strict numbers/booleans)\n  if (typeof content === 'number') {\n    return z.number();\n  }\n  if (typeof content === 'boolean') {\n    return z.boolean();\n  }\n\n  // Recursive case: Array\n  if (Array.isArray(content)) {\n    // If array is empty, we assume array of strings as default for i18n\n    if (content.length === 0) {\n      return z.array(z.string());\n    }\n    // We assume all items in the array share the structure of the first item\n    return z.array(jsonToZod(content[0]));\n  }\n\n  // Recursive case: Object\n  if (typeof content === 'object' && content !== null) {\n    const shape: Record<string, z.ZodTypeAny> = {};\n    for (const key in content) {\n      shape[key] = jsonToZod(content[key]);\n    }\n    return z.object(shape);\n  }\n\n  // Fallback\n  return z.string();\n};\n\nconst countKeys = (obj: any): number => {\n  if (typeof obj !== 'object' || obj === null) return 0;\n  let count = 0;\n  for (const key in obj) {\n    count += 1 + countKeys(obj[key]);\n  }\n  return count;\n};\n\n/**\n * TranslateJSONs a content declaration file by constructing a prompt for AI models.\n * The prompt includes details about the project's locales, file paths of content declarations,\n * and requests for identifying issues or inconsistencies.\n */\nexport const translateJSON = async <T>({\n  entryFileContent,\n  presetOutputContent,\n  dictionaryDescription,\n  aiConfig,\n  entryLocale,\n  outputLocale,\n  tags,\n  mode,\n  applicationContext,\n}: TranslateJSONOptions<T>): Promise<\n  TranslateJSONResultData<T> | undefined\n> => {\n  const { dataSerialization, ...restAiConfig } = aiConfig;\n  const { output: _unusedOutput, ...validAiConfig } = restAiConfig;\n\n  const formattedEntryLocale = formatLocaleWithName(entryLocale);\n  const formattedOutputLocale = formatLocaleWithName(outputLocale);\n\n  const isToon = dataSerialization === 'toon';\n  const promptFile = readAsset(\n    isToon ? './PROMPT_TOON.md' : './PROMPT_JSON.md'\n  );\n  const entryContentStr = isToon\n    ? encode(entryFileContent)\n    : JSON.stringify(entryFileContent);\n  const presetContentStr = isToon\n    ? encode(presetOutputContent)\n    : JSON.stringify(presetOutputContent);\n\n  const schema = jsonToZod(entryFileContent);\n\n  // Prepare the prompt for AI by replacing placeholders with actual values.\n  const prompt = promptFile\n    .replace('{{entryLocale}}', formattedEntryLocale)\n    .replace('{{outputLocale}}', formattedOutputLocale)\n    .replace('{{presetOutputContent}}', presetContentStr)\n    .replace('{{dictionaryDescription}}', dictionaryDescription ?? '')\n    .replace('{{applicationContext}}', applicationContext ?? '')\n    .replace('{{tagsInstructions}}', formatTagInstructions(tags ?? []))\n    .replace('{{modeInstructions}}', getModeInstructions(mode));\n\n  if (isToon) {\n    const { text, usage } = await generateText({\n      ...aiConfig,\n      messages: [\n        { role: 'system', content: prompt },\n        {\n          role: 'user',\n          content: [\n            `# Translation Request`,\n            `Please translate the following TOON content.`,\n            `- **From:** ${formattedEntryLocale}`,\n            `- **To:** ${formattedOutputLocale}`,\n            ``,\n            `## Entry Content:`,\n            entryContentStr,\n          ].join('\\n'),\n        },\n      ],\n    });\n\n    // Strip markdown code blocks if present\n    const cleanedText = text\n      .replace(/^```(?:toon)?\\n([\\s\\S]*?)\\n```$/gm, '$1')\n      .trim();\n\n    const decodedJson = decode(cleanedText) as T;\n\n    // schema.parse(decodedJson);\n\n    return {\n      fileContent: decodedJson,\n      tokenUsed: usage?.totalTokens ?? 0,\n    };\n  }\n\n  const totalKeys = countKeys(entryFileContent);\n\n  const MAX_SAFE_KEYS = 70; // You will need to tune this threshold based on testing\n\n  const useStrictOutput = totalKeys <= MAX_SAFE_KEYS;\n\n  // Use the AI SDK to generate the completion\n  const { text, usage } = await generateText({\n    ...validAiConfig,\n\n    // Disable schema if Schema is too complex (Block with Anthropic)\n    output: useStrictOutput ? Output.object({ schema }) : undefined,\n    messages: [\n      { role: 'system', content: prompt },\n      {\n        role: 'user',\n        content: [\n          `# Translation Request`,\n          `Please translate the following JSON content.`,\n          `- **From:** ${formattedEntryLocale}`,\n          `- **To:** ${formattedOutputLocale}`,\n          ``,\n          `CRITICAL INSTRUCTIONS:`,\n          `- You MUST return ONLY raw, valid JSON.`,\n          `- DO NOT wrap the response in Markdown code blocks (e.g., no \\`\\`\\`json).`,\n          `- DO NOT include any conversational text before or after the JSON object.`,\n          ``,\n          `## Entry Content:`,\n          entryContentStr,\n        ].join('\\n'),\n      },\n    ],\n  });\n\n  // Extract and re-validate deeply\n  const extractedJSON = extractJson(text);\n  const validatedContent = schema.parse(extractedJSON) as T;\n\n  return {\n    fileContent: validatedContent,\n    tokenUsed: usage?.totalTokens ?? 0,\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["AIProvider","ENGLISH","z","readAsset","Output","extractJson"],"sources":["../../../src/translateJSON/index.ts"],"sourcesContent":["import { readAsset } from 'utils:asset';\nimport { getLocaleName } from '@intlayer/core/localization';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport { ENGLISH } from '@intlayer/types/locales';\nimport { decode, encode } from '@toon-format/toon';\nimport { generateText, Output } from 'ai';\nimport { z } from 'zod';\nimport { type AIConfig, type AIOptions, AIProvider } from '../aiSdk';\nimport { extractJson } from '../utils/extractJSON';\n\ntype Tag = {\n  key: string;\n  description?: string;\n};\n\nexport type TranslateJSONOptions<T = JSON> = {\n  entryFileContent: T;\n  presetOutputContent: Partial<T>;\n  dictionaryDescription?: string;\n  entryLocale: Locale;\n  outputLocale: Locale;\n  tags?: Tag[];\n  aiConfig: AIConfig;\n  mode: 'complete' | 'review';\n  applicationContext?: string;\n};\n\nexport type TranslateJSONResultData<T = JSON> = {\n  fileContent: T;\n  tokenUsed: number;\n};\n\nexport const aiDefaultOptions: AIOptions = {\n  provider: AIProvider.OPENAI,\n  model: 'gpt-5-mini',\n};\n\n/**\n * Format a locale with its name.\n *\n * @param locale - The locale to format.\n * @returns A string in the format \"locale: name\", e.g. \"en: English\".\n */\nconst formatLocaleWithName = (locale: Locale): string =>\n  `${locale}: ${getLocaleName(locale, ENGLISH)}`;\n\n/**\n * Formats tag instructions for the AI prompt.\n * Creates a string with all available tags and their descriptions.\n *\n * @param tags - The list of tags to format.\n * @returns A formatted string with tag instructions.\n */\nconst formatTagInstructions = (tags: Tag[]): string => {\n  if (!tags || tags.length === 0) {\n    return '';\n  }\n\n  // Prepare the tag instructions.\n  return `Based on the dictionary content, identify specific tags from the list below that would be relevant:\n  \n${tags.map(({ key, description }) => `- ${key}: ${description}`).join('\\n\\n')}`;\n};\n\nconst getModeInstructions = (mode: 'complete' | 'review'): string => {\n  if (mode === 'complete') {\n    return 'Mode: \"Complete\" - Enrich the preset content with the missing keys and values in the output locale. Do not update existing keys. Everything should be returned in the output.';\n  }\n\n  return 'Mode: \"Review\" - Fill missing content and review existing keys from the preset content. If a key from the entry is missing in the output, it must be translated to the target language and added. If you detect misspelled content, or content that should be reformulated, correct it. If a translation is not coherent with the desired language, translate it.';\n};\n\nconst jsonToZod = (content: any): z.ZodTypeAny => {\n  // Base case: content is a string (the translation target)\n  if (typeof content === 'string') {\n    return z.string();\n  }\n\n  // Base cases: primitives often preserved in i18n files (e.g. strict numbers/booleans)\n  if (typeof content === 'number') {\n    return z.number();\n  }\n  if (typeof content === 'boolean') {\n    return z.boolean();\n  }\n\n  // Recursive case: Array\n  if (Array.isArray(content)) {\n    // If array is empty, we assume array of strings as default for i18n\n    if (content.length === 0) {\n      return z.array(z.string());\n    }\n    // We assume all items in the array share the structure of the first item\n    return z.array(jsonToZod(content[0]));\n  }\n\n  // Recursive case: Object\n  if (typeof content === 'object' && content !== null) {\n    const shape: Record<string, z.ZodTypeAny> = {};\n    for (const key in content) {\n      shape[key] = jsonToZod(content[key]);\n    }\n    return z.object(shape);\n  }\n\n  // Fallback\n  return z.string();\n};\n\nconst countKeys = (obj: any): number => {\n  if (typeof obj !== 'object' || obj === null) return 0;\n  let count = 0;\n  for (const key in obj) {\n    count += 1 + countKeys(obj[key]);\n  }\n  return count;\n};\n\n/**\n * TranslateJSONs a content declaration file by constructing a prompt for AI models.\n * The prompt includes details about the project's locales, file paths of content declarations,\n * and requests for identifying issues or inconsistencies.\n */\nexport const translateJSON = async <T>({\n  entryFileContent,\n  presetOutputContent,\n  dictionaryDescription,\n  aiConfig,\n  entryLocale,\n  outputLocale,\n  tags,\n  mode,\n  applicationContext,\n}: TranslateJSONOptions<T>): Promise<\n  TranslateJSONResultData<T> | undefined\n> => {\n  const { dataSerialization, ...restAiConfig } = aiConfig;\n  const { output: _unusedOutput, ...validAiConfig } = restAiConfig;\n\n  const formattedEntryLocale = formatLocaleWithName(entryLocale);\n  const formattedOutputLocale = formatLocaleWithName(outputLocale);\n\n  const isToon = dataSerialization === 'toon';\n  const promptFile = readAsset(\n    isToon ? './PROMPT_TOON.md' : './PROMPT_JSON.md'\n  );\n  const entryContentStr = isToon\n    ? encode(entryFileContent)\n    : JSON.stringify(entryFileContent);\n  const presetContentStr = isToon\n    ? encode(presetOutputContent)\n    : JSON.stringify(presetOutputContent);\n\n  const schema = jsonToZod(entryFileContent);\n\n  // Prepare the prompt for AI by replacing placeholders with actual values.\n  const prompt = promptFile\n    .replace('{{entryLocale}}', formattedEntryLocale)\n    .replace('{{outputLocale}}', formattedOutputLocale)\n    .replace('{{presetOutputContent}}', presetContentStr)\n    .replace('{{dictionaryDescription}}', dictionaryDescription ?? '')\n    .replace('{{applicationContext}}', applicationContext ?? '')\n    .replace('{{tagsInstructions}}', formatTagInstructions(tags ?? []))\n    .replace('{{modeInstructions}}', getModeInstructions(mode));\n\n  if (isToon) {\n    const { text, usage } = await generateText({\n      ...aiConfig,\n      messages: [\n        { role: 'system', content: prompt },\n        {\n          role: 'user',\n          content: [\n            `# Translation Request`,\n            `Please translate the following TOON content.`,\n            `- **From:** ${formattedEntryLocale}`,\n            `- **To:** ${formattedOutputLocale}`,\n            ``,\n            `## Entry Content:`,\n            entryContentStr,\n          ].join('\\n'),\n        },\n      ],\n    });\n\n    // Strip markdown code blocks if present\n    const cleanedText = text\n      .replace(/^```(?:toon)?\\n([\\s\\S]*?)\\n```$/gm, '$1')\n      .trim();\n\n    const decodedJson = decode(cleanedText) as T;\n\n    // schema.parse(decodedJson);\n\n    return {\n      fileContent: decodedJson,\n      tokenUsed: usage?.totalTokens ?? 0,\n    };\n  }\n\n  const totalKeys = countKeys(entryFileContent);\n\n  const MAX_SAFE_KEYS = 70; // You will need to tune this threshold based on testing\n\n  const useStrictOutput = totalKeys <= MAX_SAFE_KEYS;\n\n  // Use the AI SDK to generate the completion\n  const { text, usage } = await generateText({\n    ...validAiConfig,\n\n    // Disable schema if Schema is too complex (Block with Anthropic)\n    output: useStrictOutput ? Output.object({ schema }) : undefined,\n    messages: [\n      { role: 'system', content: prompt },\n      {\n        role: 'user',\n        content: [\n          `# Translation Request`,\n          `Please translate the following JSON content.`,\n          `- **From:** ${formattedEntryLocale}`,\n          `- **To:** ${formattedOutputLocale}`,\n          ``,\n          `CRITICAL INSTRUCTIONS:`,\n          `- You MUST return ONLY raw, valid JSON.`,\n          `- DO NOT wrap the response in Markdown code blocks (e.g., no \\`\\`\\`json).`,\n          `- DO NOT include any conversational text before or after the JSON object.`,\n          ``,\n          `## Entry Content:`,\n          entryContentStr,\n        ].join('\\n'),\n      },\n    ],\n  });\n\n  // Extract and re-validate deeply\n  const extractedJSON = extractJson(text);\n  const validatedContent = schema.parse(extractedJSON) as T;\n\n  return {\n    fileContent: validatedContent,\n    tokenUsed: usage?.totalTokens ?? 0,\n  };\n};\n"],"mappings":"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"}

package/dist/cjs/utils/extractJSON.cjs

@@ -1,2 +1,62 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=e=>{let t=e.match(/[{[]/);if(!t)throw Error(`No JSON start character ({ or [) found.`);let n=t.index,r=e[n],i=r===`{`?`}`:`]`,a=0;for(let t=n;t<e.length;t++){let o=e[t];if(o===r)a++;else if(o===i&&(a--,a===0)){let r=e.slice(n,t+1);try{return JSON.parse(r)}catch(e){throw Error(`Failed to parse JSON: ${e.message}`)}}}throw Error(`Reached end of input without closing JSON bracket.`)};exports.extractJson=e;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/utils/extractJSON.ts
+/**
+* Extracts and parses the first valid JSON value (object or array) from a string containing arbitrary text.
+* This is used to safely extract JSON from LLM responses that may contain additional text or markdown.
+*
+* @example
+* // Extracts JSON object from markdown response:
+* ```json
+* {
+*   "title": "Test content declarations",
+*   "description": "A comprehensive test dictionary...",
+*   "tags": ["test tag"]
+* }
+* ```
+*
+* @example
+* // Extracts JSON array:
+* ```json
+* ["item1", "item2", "item3"]
+* ```
+*
+* @example
+* // Extracts JSON from markdown:
+* Here is the response:
+* ```json
+* {"key": "value"}
+* ```
+* End of response.
+*
+* @throws {Error} If no valid JSON object/array is found or if parsing fails
+* @returns {T} The parsed JSON value cast to type T
+*/
+const extractJson = (input) => {
+	const opening = input.match(/[{[]/);
+	if (!opening) throw new Error("No JSON start character ({ or [) found.");
+	const startIdx = opening.index;
+	const openChar = input[startIdx];
+	const closeChar = openChar === "{" ? "}" : "]";
+	let depth = 0;
+	for (let i = startIdx; i < input.length; i++) {
+		const char = input[i];
+		if (char === openChar) depth++;
+		else if (char === closeChar) {
+			depth--;
+			if (depth === 0) {
+				const jsonSubstring = input.slice(startIdx, i + 1);
+				try {
+					return JSON.parse(jsonSubstring);
+				} catch (err) {
+					throw new Error(`Failed to parse JSON: ${err.message}`);
+				}
+			}
+		}
+	}
+	throw new Error("Reached end of input without closing JSON bracket.");
+};
+
+//#endregion
+exports.extractJson = extractJson;
 //# sourceMappingURL=extractJSON.cjs.map

package/dist/cjs/utils/extractJSON.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"extractJSON.cjs","names":[],"sources":["../../../src/utils/extractJSON.ts"],"sourcesContent":["/**\n * Extracts and parses the first valid JSON value (object or array) from a string containing arbitrary text.\n * This is used to safely extract JSON from LLM responses that may contain additional text or markdown.\n *\n * @example\n * // Extracts JSON object from markdown response:\n * ```json\n * {\n *   \"title\": \"Test content declarations\",\n *   \"description\": \"A comprehensive test dictionary...\",\n *   \"tags\": [\"test tag\"]\n * }\n * ```\n *\n * @example\n * // Extracts JSON array:\n * ```json\n * [\"item1\", \"item2\", \"item3\"]\n * ```\n *\n * @example\n * // Extracts JSON from markdown:\n * Here is the response:\n * ```json\n * {\"key\": \"value\"}\n * ```\n * End of response.\n *\n * @throws {Error} If no valid JSON object/array is found or if parsing fails\n * @returns {T} The parsed JSON value cast to type T\n */\nexport const extractJson = <T = any>(input: string): T => {\n  const opening = input.match(/[{[]/);\n  if (!opening) throw new Error('No JSON start character ({ or [) found.');\n\n  const startIdx = opening.index!;\n  const openChar = input[startIdx];\n  const closeChar = openChar === '{' ? '}' : ']';\n  let depth = 0;\n\n  for (let i = startIdx; i < input.length; i++) {\n    const char = input[i];\n    if (char === openChar) depth++;\n    else if (char === closeChar) {\n      depth--;\n      if (depth === 0) {\n        const jsonSubstring = input.slice(startIdx, i + 1);\n        try {\n          return JSON.parse(jsonSubstring) as T;\n        } catch (err) {\n          throw new Error(`Failed to parse JSON: ${(err as Error).message}`);\n        }\n      }\n    }\n  }\n\n  throw new Error('Reached end of input without closing JSON bracket.');\n};\n"],"mappings":"mEA+BA,MAAa,EAAwB,GAAqB,CACxD,IAAM,EAAU,EAAM,MAAM,OAAO,CACnC,GAAI,CAAC,EAAS,MAAU,MAAM,0CAA0C,CAExE,IAAM,EAAW,EAAQ,MACnB,EAAW,EAAM,GACjB,EAAY,IAAa,IAAM,IAAM,IACvC,EAAQ,EAEZ,IAAK,IAAI,EAAI,EAAU,EAAI,EAAM,OAAQ,IAAK,CAC5C,IAAM,EAAO,EAAM,GACnB,GAAI,IAAS,EAAU,YACd,IAAS,IAChB,IACI,IAAU,GAAG,CACf,IAAM,EAAgB,EAAM,MAAM,EAAU,EAAI,EAAE,CAClD,GAAI,CACF,OAAO,KAAK,MAAM,EAAc,OACzB,EAAK,CACZ,MAAU,MAAM,yBAA0B,EAAc,UAAU,GAM1E,MAAU,MAAM,qDAAqD"}
+{"version":3,"file":"extractJSON.cjs","names":[],"sources":["../../../src/utils/extractJSON.ts"],"sourcesContent":["/**\n * Extracts and parses the first valid JSON value (object or array) from a string containing arbitrary text.\n * This is used to safely extract JSON from LLM responses that may contain additional text or markdown.\n *\n * @example\n * // Extracts JSON object from markdown response:\n * ```json\n * {\n *   \"title\": \"Test content declarations\",\n *   \"description\": \"A comprehensive test dictionary...\",\n *   \"tags\": [\"test tag\"]\n * }\n * ```\n *\n * @example\n * // Extracts JSON array:\n * ```json\n * [\"item1\", \"item2\", \"item3\"]\n * ```\n *\n * @example\n * // Extracts JSON from markdown:\n * Here is the response:\n * ```json\n * {\"key\": \"value\"}\n * ```\n * End of response.\n *\n * @throws {Error} If no valid JSON object/array is found or if parsing fails\n * @returns {T} The parsed JSON value cast to type T\n */\nexport const extractJson = <T = any>(input: string): T => {\n  const opening = input.match(/[{[]/);\n  if (!opening) throw new Error('No JSON start character ({ or [) found.');\n\n  const startIdx = opening.index!;\n  const openChar = input[startIdx];\n  const closeChar = openChar === '{' ? '}' : ']';\n  let depth = 0;\n\n  for (let i = startIdx; i < input.length; i++) {\n    const char = input[i];\n    if (char === openChar) depth++;\n    else if (char === closeChar) {\n      depth--;\n      if (depth === 0) {\n        const jsonSubstring = input.slice(startIdx, i + 1);\n        try {\n          return JSON.parse(jsonSubstring) as T;\n        } catch (err) {\n          throw new Error(`Failed to parse JSON: ${(err as Error).message}`);\n        }\n      }\n    }\n  }\n\n  throw new Error('Reached end of input without closing JSON bracket.');\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAa,eAAwB,UAAqB;CACxD,MAAM,UAAU,MAAM,MAAM,OAAO;AACnC,KAAI,CAAC,QAAS,OAAM,IAAI,MAAM,0CAA0C;CAExE,MAAM,WAAW,QAAQ;CACzB,MAAM,WAAW,MAAM;CACvB,MAAM,YAAY,aAAa,MAAM,MAAM;CAC3C,IAAI,QAAQ;AAEZ,MAAK,IAAI,IAAI,UAAU,IAAI,MAAM,QAAQ,KAAK;EAC5C,MAAM,OAAO,MAAM;AACnB,MAAI,SAAS,SAAU;WACd,SAAS,WAAW;AAC3B;AACA,OAAI,UAAU,GAAG;IACf,MAAM,gBAAgB,MAAM,MAAM,UAAU,IAAI,EAAE;AAClD,QAAI;AACF,YAAO,KAAK,MAAM,cAAc;aACzB,KAAK;AACZ,WAAM,IAAI,MAAM,yBAA0B,IAAc,UAAU;;;;;AAM1E,OAAM,IAAI,MAAM,qDAAqD"}

package/dist/esm/_virtual/_utils_asset.mjs

@@ -0,0 +1,97 @@
+import { existsSync, readFileSync } from "node:fs";
+import { basename, dirname, join, relative, resolve, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+
+//#region \0utils:asset
+const hereDirname = () => {
+	try {
+		return dirname(fileURLToPath(import.meta.url));
+	} catch {
+		return typeof __dirname !== "undefined" ? __dirname : process.cwd();
+	}
+};
+const findDistRoot = (startDir) => {
+	let dir = startDir;
+	for (let i = 0; i < 12; i++) {
+		if (basename(dir) === "dist") return dir;
+		const parent = resolve(dir, "..");
+		if (parent === dir) break;
+		dir = parent;
+	}
+	return null;
+};
+const normalizeFrameFile = (file) => {
+	if (!file) return null;
+	try {
+		if (file.startsWith("file://")) return fileURLToPath(file);
+	} catch {}
+	return file;
+};
+/**
+* Returns the directory of the *caller* module that invoked readAsset.
+* Prefers non-virtual frames; falls back to the first real frame.
+*/
+const getCallerDir = () => {
+	const prev = Error.prepareStackTrace;
+	try {
+		Error.prepareStackTrace = (_, structured) => structured;
+		const err = /* @__PURE__ */ new Error();
+		Error.captureStackTrace(err, getCallerDir);
+		/** @type {import('node:vm').CallSite[]} */
+		const frames = err.stack || [];
+		const isVirtualPath = (p) => p.includes(`${sep}_virtual${sep}`) || p.includes("/_virtual/");
+		for (const frame of frames) {
+			const file = normalizeFrameFile(typeof frame.getFileName === "function" ? frame.getFileName() : null);
+			if (!file) continue;
+			if (file.includes("node:internal") || file.includes(`${sep}internal${sep}modules${sep}`)) continue;
+			if (!isVirtualPath(file)) return dirname(file);
+		}
+		for (const frame of frames) {
+			const file = normalizeFrameFile(typeof frame.getFileName === "function" ? frame.getFileName() : null);
+			if (file) return dirname(file);
+		}
+	} catch {} finally {
+		Error.prepareStackTrace = prev;
+	}
+	return hereDirname();
+};
+/**
+* Read an asset copied from src/** to dist/assets/**.
+* - './' or '../' is resolved relative to the *caller module's* emitted directory.
+* - otherwise, treat as src-relative.
+*
+* @param {string} relPath - e.g. './PROMPT.md' or 'utils/AI/askDocQuestion/embeddings/<fileKey>.json'
+* @param {BufferEncoding} [encoding='utf8']
+*/
+const readAsset = (relPath, encoding = "utf8") => {
+	const here = hereDirname();
+	const distRoot = findDistRoot(here) ?? resolve(here, "..", "..", "dist");
+	const assetsRoot = join(distRoot, "assets");
+	const tried = [];
+	/**
+	* Transform dist/(esm|cjs)/... and _virtual/ prefix to clean subpath (Windows-safe)
+	*/
+	const callerSubpath = relative(distRoot, getCallerDir()).split("\\").join("/").replace(/^(?:dist\/)?(?:esm|cjs)\//, "").replace(/^_virtual\//, "");
+	if (relPath.startsWith("./") || relPath.startsWith("../")) {
+		const fromCallerAbs = resolve(assetsRoot, callerSubpath, relPath);
+		tried.push(fromCallerAbs);
+		if (existsSync(fromCallerAbs)) return readFileSync(fromCallerAbs, encoding);
+	}
+	const directPath = join(assetsRoot, relPath);
+	tried.push(directPath);
+	if (existsSync(directPath)) return readFileSync(directPath, encoding);
+	if (callerSubpath) {
+		const nested = join(assetsRoot, callerSubpath, relPath);
+		tried.push(nested);
+		if (existsSync(nested)) return readFileSync(nested, encoding);
+	}
+	const msg = [
+		"readAsset: file not found.",
+		"Searched:",
+		...tried.map((p) => `- ${p}`)
+	].join("\n");
+	throw new Error(msg);
+};
+
+//#endregion
+export { readAsset };

package/dist/esm/aiSdk.mjs

@@ -1,2 +1,202 @@
-import*as e from"@intlayer/config/colors";import{colorize as t,logger as n,x as r}from"@intlayer/config/logger";import{AiProviders as i}from"@intlayer/types/config";const a=(e,t,n=!1)=>{let r=process.env.OPENAI_API_KEY;if(e.includes(`public`))return t?.apiKey??r;if(e.includes(`apiKey`)&&t?.apiKey)return t?.apiKey;if(e.includes(`registered_user`)&&n||e.includes(`premium_user`)&&n)return t?.apiKey??r},o=(e,t,n,r=`gpt-5-mini`)=>{if(t||e===i.OLLAMA){if(e===i.OPENAI)return n??r;if(n)return n;switch(e){default:return`-`}}if(n||e)throw Error(`The user should use his own API key to use a custom model`);return r},s=async(a,s,c)=>{let l=async i=>{try{return await import(i)}catch{n(`${r} The package "${t(i,e.GREEN)}" is required to use this AI provider. Please install it using: ${t(`npm install ${i}`,e.GREY_DARK)}`,{level:`error`}),process.exit()}},u=a.provider??i.OPENAI,d=o(u,s,a.model,c),f=a.baseURL;switch(u){case i.OPENAI:{let{provider:e,model:t,temperature:n,applicationContext:r,dataSerialization:i,apiKey:o,baseURL:c,...u}=a,{createOpenAI:p}=await l(`@ai-sdk/openai`);return p({apiKey:s,baseURL:f,...u})(d)}case i.ANTHROPIC:{let{provider:e,model:t,temperature:n,applicationContext:r,dataSerialization:i,apiKey:o,baseURL:c,...u}=a,{createAnthropic:p}=await l(`@ai-sdk/anthropic`);return p({apiKey:s,baseURL:f,...u})(d)}case i.MISTRAL:{let{provider:e,model:t,temperature:n,applicationContext:r,dataSerialization:i,apiKey:o,baseURL:c,...u}=a,{createMistral:p}=await l(`@ai-sdk/mistral`);return p({apiKey:s,baseURL:f,...u})(d)}case i.DEEPSEEK:{let{provider:e,model:t,temperature:n,applicationContext:r,dataSerialization:i,apiKey:o,baseURL:c,...u}=a,{createDeepSeek:p}=await l(`@ai-sdk/deepseek`);return p({apiKey:s,baseURL:f,...u})(d)}case i.GEMINI:{let{provider:e,model:t,temperature:n,applicationContext:r,dataSerialization:i,apiKey:o,baseURL:c,...u}=a,{createGoogleGenerativeAI:p}=await l(`@ai-sdk/google`);return p({apiKey:s,baseURL:f,...u})(d)}case i.GOOGLEVERTEX:{let{provider:e,model:t,temperature:n,applicationContext:r,dataSerialization:i,apiKey:o,baseURL:c,...u}=a,{createVertex:p}=await l(`@ai-sdk/google-vertex`);return p({apiKey:s,baseURL:f,...u})(d)}case i.GOOGLEGENERATIVEAI:{let{provider:e,model:t,temperature:n,applicationContext:r,dataSerialization:i,apiKey:o,baseURL:c,...u}=a,{createGoogleGenerativeAI:p}=await l(`@ai-sdk/google`);return p({apiKey:s,baseURL:f,...u})(d)}case i.OLLAMA:{let{provider:e,model:t,temperature:n,applicationContext:r,dataSerialization:i,apiKey:o,baseURL:c,...u}=a,{createOpenAI:p}=await l(`@ai-sdk/openai`);return p({baseURL:f??`http://localhost:11434/v1`,apiKey:s??`ollama`,...u}).chat(d)}case i.OPENROUTER:{let{provider:e,model:t,temperature:n,applicationContext:r,dataSerialization:i,apiKey:o,baseURL:c,...u}=a,{createOpenRouter:p}=await l(`@openrouter/ai-sdk-provider`);return p({apiKey:s,baseURL:f,...u})(d)}case i.ALIBABA:{let{provider:e,model:t,temperature:n,applicationContext:r,dataSerialization:i,apiKey:o,baseURL:c,...u}=a,{createAlibaba:p}=await l(`@ai-sdk/alibaba`);return p({apiKey:s,baseURL:f,...u})(d)}case i.FIREWORKS:{let{provider:e,model:t,temperature:n,applicationContext:r,dataSerialization:i,apiKey:o,baseURL:c,...u}=a,{createFireworks:p}=await l(`@ai-sdk/fireworks`);return p({apiKey:s,baseURL:f,...u})(d)}case i.GROQ:{let{provider:e,model:t,temperature:n,applicationContext:r,dataSerialization:i,apiKey:o,baseURL:c,...u}=a,{createGroq:p}=await l(`@ai-sdk/groq`);return p({apiKey:s,baseURL:f,...u})(d)}case i.HUGGINGFACE:{let{provider:e,model:t,temperature:n,applicationContext:r,dataSerialization:i,apiKey:o,baseURL:c,...u}=a,{createHuggingFace:p}=await l(`@ai-sdk/huggingface`);return p({apiKey:s,baseURL:f,...u})(d)}case i.BEDROCK:{let{provider:e,model:t,temperature:n,applicationContext:r,dataSerialization:i,apiKey:o,baseURL:c,...u}=a,{createAmazonBedrock:p}=await l(`@ai-sdk/amazon-bedrock`);return p({accessKeyId:s,baseURL:f,...u})(d)}case i.TOGETHERAI:{let{provider:e,model:t,temperature:n,applicationContext:r,dataSerialization:i,apiKey:o,baseURL:c,...u}=a,{createTogetherAI:p}=await l(`@ai-sdk/togetherai`);return p({apiKey:s,baseURL:f,...u})(d)}default:throw Error(`Provider ${u} not supported`)}},c=i.OPENAI,l=async(e,t=!1)=>{let{userOptions:n,projectOptions:r,defaultOptions:o,accessType:l=[`registered_user`]}=e,u={provider:c,...o,...r,...n},d=a(l,u,t);if(!d&&u.provider!==i.OLLAMA)throw Error(`API key for ${u.provider} is missing`);return{model:await s(u,d,o?.model),temperature:u.temperature,dataSerialization:u.dataSerialization}};export{i as AIProvider,l as getAIConfig};
+import * as ANSIColors from "@intlayer/config/colors";
+import { colorize, logger, x } from "@intlayer/config/logger";
+import { AiProviders } from "@intlayer/types/config";
+
+//#region src/aiSdk.ts
+const getAPIKey = (accessType, aiOptions, isAuthenticated = false) => {
+	const defaultApiKey = process.env.OPENAI_API_KEY;
+	if (accessType.includes("public")) return aiOptions?.apiKey ?? defaultApiKey;
+	if (accessType.includes("apiKey") && aiOptions?.apiKey) return aiOptions?.apiKey;
+	if (accessType.includes("registered_user") && isAuthenticated) return aiOptions?.apiKey ?? defaultApiKey;
+	if (accessType.includes("premium_user") && isAuthenticated) return aiOptions?.apiKey ?? defaultApiKey;
+};
+const getModelName = (provider, userApiKey, userModel, defaultModel = "gpt-5-mini") => {
+	if (userApiKey || provider === AiProviders.OLLAMA) {
+		if (provider === AiProviders.OPENAI) return userModel ?? defaultModel;
+		if (userModel) return userModel;
+		switch (provider) {
+			default: return "-";
+		}
+	}
+	if (userModel || provider) throw new Error("The user should use his own API key to use a custom model");
+	return defaultModel;
+};
+const getLanguageModel = async (aiOptions, apiKey, defaultModel) => {
+	const loadModule = async (packageName) => {
+		try {
+			return await import(packageName);
+		} catch {
+			logger(`${x} The package "${colorize(packageName, ANSIColors.GREEN)}" is required to use this AI provider. Please install it using: ${colorize(`npm install ${packageName}`, ANSIColors.GREY_DARK)}`, { level: "error" });
+			process.exit();
+		}
+	};
+	const provider = aiOptions.provider ?? AiProviders.OPENAI;
+	const selectedModel = getModelName(provider, apiKey, aiOptions.model, defaultModel);
+	const baseURL = aiOptions.baseURL;
+	switch (provider) {
+		case AiProviders.OPENAI: {
+			const { provider, model, temperature, applicationContext, dataSerialization, apiKey: _apiKey, baseURL: _baseURL, ...otherOptions } = aiOptions;
+			const { createOpenAI } = await loadModule("@ai-sdk/openai");
+			return createOpenAI({
+				apiKey,
+				baseURL,
+				...otherOptions
+			})(selectedModel);
+		}
+		case AiProviders.ANTHROPIC: {
+			const { provider, model, temperature, applicationContext, dataSerialization, apiKey: _apiKey, baseURL: _baseURL, ...otherOptions } = aiOptions;
+			const { createAnthropic } = await loadModule("@ai-sdk/anthropic");
+			return createAnthropic({
+				apiKey,
+				baseURL,
+				...otherOptions
+			})(selectedModel);
+		}
+		case AiProviders.MISTRAL: {
+			const { provider, model, temperature, applicationContext, dataSerialization, apiKey: _apiKey, baseURL: _baseURL, ...otherOptions } = aiOptions;
+			const { createMistral } = await loadModule("@ai-sdk/mistral");
+			return createMistral({
+				apiKey,
+				baseURL,
+				...otherOptions
+			})(selectedModel);
+		}
+		case AiProviders.DEEPSEEK: {
+			const { provider, model, temperature, applicationContext, dataSerialization, apiKey: _apiKey, baseURL: _baseURL, ...otherOptions } = aiOptions;
+			const { createDeepSeek } = await loadModule("@ai-sdk/deepseek");
+			return createDeepSeek({
+				apiKey,
+				baseURL,
+				...otherOptions
+			})(selectedModel);
+		}
+		case AiProviders.GEMINI: {
+			const { provider, model, temperature, applicationContext, dataSerialization, apiKey: _apiKey, baseURL: _baseURL, ...otherOptions } = aiOptions;
+			const { createGoogleGenerativeAI } = await loadModule("@ai-sdk/google");
+			return createGoogleGenerativeAI({
+				apiKey,
+				baseURL,
+				...otherOptions
+			})(selectedModel);
+		}
+		case AiProviders.GOOGLEVERTEX: {
+			const { provider, model, temperature, applicationContext, dataSerialization, apiKey: _apiKey, baseURL: _baseURL, ...otherOptions } = aiOptions;
+			const { createVertex } = await loadModule("@ai-sdk/google-vertex");
+			return createVertex({
+				apiKey,
+				baseURL,
+				...otherOptions
+			})(selectedModel);
+		}
+		case AiProviders.GOOGLEGENERATIVEAI: {
+			const { provider, model, temperature, applicationContext, dataSerialization, apiKey: _apiKey, baseURL: _baseURL, ...otherOptions } = aiOptions;
+			const { createGoogleGenerativeAI } = await loadModule("@ai-sdk/google");
+			return createGoogleGenerativeAI({
+				apiKey,
+				baseURL,
+				...otherOptions
+			})(selectedModel);
+		}
+		case AiProviders.OLLAMA: {
+			const { provider, model, temperature, applicationContext, dataSerialization, apiKey: _apiKey, baseURL: _baseURL, ...otherOptions } = aiOptions;
+			const { createOpenAI } = await loadModule("@ai-sdk/openai");
+			return createOpenAI({
+				baseURL: baseURL ?? "http://localhost:11434/v1",
+				apiKey: apiKey ?? "ollama",
+				...otherOptions
+			}).chat(selectedModel);
+		}
+		case AiProviders.OPENROUTER: {
+			const { provider, model, temperature, applicationContext, dataSerialization, apiKey: _apiKey, baseURL: _baseURL, ...otherOptions } = aiOptions;
+			const { createOpenRouter } = await loadModule("@openrouter/ai-sdk-provider");
+			return createOpenRouter({
+				apiKey,
+				baseURL,
+				...otherOptions
+			})(selectedModel);
+		}
+		case AiProviders.ALIBABA: {
+			const { provider, model, temperature, applicationContext, dataSerialization, apiKey: _apiKey, baseURL: _baseURL, ...otherOptions } = aiOptions;
+			const { createAlibaba } = await loadModule("@ai-sdk/alibaba");
+			return createAlibaba({
+				apiKey,
+				baseURL,
+				...otherOptions
+			})(selectedModel);
+		}
+		case AiProviders.FIREWORKS: {
+			const { provider, model, temperature, applicationContext, dataSerialization, apiKey: _apiKey, baseURL: _baseURL, ...otherOptions } = aiOptions;
+			const { createFireworks } = await loadModule("@ai-sdk/fireworks");
+			return createFireworks({
+				apiKey,
+				baseURL,
+				...otherOptions
+			})(selectedModel);
+		}
+		case AiProviders.GROQ: {
+			const { provider, model, temperature, applicationContext, dataSerialization, apiKey: _apiKey, baseURL: _baseURL, ...otherOptions } = aiOptions;
+			const { createGroq } = await loadModule("@ai-sdk/groq");
+			return createGroq({
+				apiKey,
+				baseURL,
+				...otherOptions
+			})(selectedModel);
+		}
+		case AiProviders.HUGGINGFACE: {
+			const { provider, model, temperature, applicationContext, dataSerialization, apiKey: _apiKey, baseURL: _baseURL, ...otherOptions } = aiOptions;
+			const { createHuggingFace } = await loadModule("@ai-sdk/huggingface");
+			return createHuggingFace({
+				apiKey,
+				baseURL,
+				...otherOptions
+			})(selectedModel);
+		}
+		case AiProviders.BEDROCK: {
+			const { provider, model, temperature, applicationContext, dataSerialization, apiKey: _apiKey, baseURL: _baseURL, ...otherOptions } = aiOptions;
+			const { createAmazonBedrock } = await loadModule("@ai-sdk/amazon-bedrock");
+			return createAmazonBedrock({
+				accessKeyId: apiKey,
+				baseURL,
+				...otherOptions
+			})(selectedModel);
+		}
+		case AiProviders.TOGETHERAI: {
+			const { provider, model, temperature, applicationContext, dataSerialization, apiKey: _apiKey, baseURL: _baseURL, ...otherOptions } = aiOptions;
+			const { createTogetherAI } = await loadModule("@ai-sdk/togetherai");
+			return createTogetherAI({
+				apiKey,
+				baseURL,
+				...otherOptions
+			})(selectedModel);
+		}
+		default: throw new Error(`Provider ${provider} not supported`);
+	}
+};
+const DEFAULT_PROVIDER = AiProviders.OPENAI;
+/**
+* Get AI model configuration based on the selected provider and options
+* This function handles the configuration for different AI providers
+*
+* @param options Configuration options including provider, API keys, models and temperature
+* @returns Configured AI model ready to use with generateText
+*/
+const getAIConfig = async (options, isAuthenticated = false) => {
+	const { userOptions, projectOptions, defaultOptions, accessType = ["registered_user"] } = options;
+	const aiOptions = {
+		provider: DEFAULT_PROVIDER,
+		...defaultOptions,
+		...projectOptions,
+		...userOptions
+	};
+	const apiKey = getAPIKey(accessType, aiOptions, isAuthenticated);
+	if (!apiKey && aiOptions.provider !== AiProviders.OLLAMA) throw new Error(`API key for ${aiOptions.provider} is missing`);
+	return {
+		model: await getLanguageModel(aiOptions, apiKey, defaultOptions?.model),
+		temperature: aiOptions.temperature,
+		dataSerialization: aiOptions.dataSerialization
+	};
+};
+
+//#endregion
+export { AiProviders as AIProvider, getAIConfig };
 //# sourceMappingURL=aiSdk.mjs.map