A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
TypeScript agent-skillsaidsh-pluginhacktoberfestjavascriptmcp-serverreactresume-builderself-hostedtypescript
import { z } from "zod";
import { AI_PROVIDER_DEFAULT_BASE_URLS } from "./defaults";
const AI_PROVIDERS = [
"openai",
"anthropic",
"gemini",
"vercel-ai-gateway",
"openrouter",
"mistral",
"cohere",
"xai",
"groq",
"deepseek",
"togetherai",
"fireworks",
"cerebras",
"perplexity",
"ollama",
"openai-compatible",
] as const;
export type AIProvider = (typeof AI_PROVIDERS)[number];
export const aiProviderSchema = z.enum(AI_PROVIDERS);
export { AI_PROVIDER_DEFAULT_BASE_URLS };
function normalizeDirectBaseUrl(baseURL: string) {
try {
const parsed = new URL(baseURL);
if (parsed.search || parsed.hash || parsed.username || parsed.password) return null;
return parsed.toString().replace(/\/+$/, "");
} catch {
return null;
}
}
/** Provider-native capabilities belong to the official endpoint, not a compatible proxy. */
export function isDirectAiProvider(input: { provider: AIProvider; baseURL?: string | null }) {
if (!input.baseURL?.trim()) return true;
const baseURL = normalizeDirectBaseUrl(input.baseURL);
return baseURL !== null && baseURL === normalizeDirectBaseUrl(AI_PROVIDER_DEFAULT_BASE_URLS[input.provider]);
}
/** The installed SDK exposes native search for these direct providers; individual models can still refuse it. */
export function supportsNativeWebSearch(input: { provider: AIProvider; baseURL?: string | null }) {
return (
(input.provider === "openai" || input.provider === "anthropic" || input.provider === "gemini") &&
isDirectAiProvider(input)
);
}
// Brand names, used when a message has to name the provider outside a translated UI string. Every
// such message opens with this value, so the generic fallback is capitalised to match.
export const AI_PROVIDER_DISPLAY_NAMES: Record<AIProvider, string> = {
openai: "OpenAI",
anthropic: "Anthropic",
gemini: "Google Gemini",
"vercel-ai-gateway": "Vercel AI Gateway",
openrouter: "OpenRouter",
mistral: "Mistral",
cohere: "Cohere",
xai: "xAI",
groq: "Groq",
deepseek: "DeepSeek",
togetherai: "Together AI",
fireworks: "Fireworks AI",
cerebras: "Cerebras",
perplexity: "Perplexity",
ollama: "Ollama",
"openai-compatible": "The provider",
};
/**
* Speech models each provider offers through the AI SDK, default first: `transcription` turns a recorded answer into
* text, `speech` reads a question aloud. A provider without a list (or with an empty one) has none, and voice practice
* uses the browser's own speech instead. xAI's speech model takes no id; its one entry only names it.
*/
export const AI_VOICE_MODELS: Partial<
Record<AIProvider, { transcription: readonly string[]; speech: readonly string[] }>
> = {
openai: {
transcription: ["gpt-4o-mini-transcribe", "gpt-4o-transcribe", "whisper-1"],
speech: ["gpt-4o-mini-tts", "tts-1"],
},
gemini: {
transcription: ["gemini-3.5-transcribe"],
speech: ["gemini-3.8-flash-tts", "gemini-3.8-flash-lite-tts", "gemini-2.5-flash-preview-tts"],
},
mistral: { transcription: ["voxtral-mini-latest"], speech: ["voxtral-mini-tts-latest"] },
xai: { transcription: ["grok-voice-transcribe-2.0"], speech: ["grok-tts"] },
groq: { transcription: ["whisper-large-v3-turbo", "whisper-large-v3"], speech: [] },
"vercel-ai-gateway": {
transcription: ["openai/gpt-4o-mini-transcribe", "google/gemini-3.5-transcribe", "openai/whisper-1"],
speech: ["openai/tts-1", "google/gemini-3.8-flash-tts"],
},
};
/** Explicit manual/web-only approval is different from an older client's absent approval header. */
export const NO_AI_DESTINATION = "none";
export type AiVoiceOperation = { kind: "speech" | "transcription"; model: string };
/** Opaque provider-owned recipient identity, plus the concrete voice operation when used. */
export function aiDestination(provider: { id: string; recipientVersion: string }, voice?: AiVoiceOperation) {
return JSON.stringify([provider.id, provider.recipientVersion, ...(voice ? [voice] : [])]);
}