@od-oneapp/ai-platform 0.1.0

package/src/models/providers/openai.ts

@@ -0,0 +1,346 @@
+/**
+ * @fileoverview OpenAI provider configuration
+ *
+ * Provider-specific model IDs, option helpers, capability detection,
+ * and metadata extraction for OpenAI models.
+ *
+ * All AI SDK imports come from the shared module.
+ *
+ * @module @od-oneapp/ai-platform/models/providers/openai
+ */
+
+import { openai as openaiProvider, createOpenAI } from '../../shared';
+
+import { commonModes } from './shared';
+
+import type { SDKSharedV3ProviderMetadata } from '../../shared';
+
+// ---------------------------------------------------------------------------
+// Internal types
+// ---------------------------------------------------------------------------
+
+interface GenerationResult {
+  providerOptions?: SDKSharedV3ProviderMetadata;
+}
+
+// ---------------------------------------------------------------------------
+// Re-export provider
+// ---------------------------------------------------------------------------
+
+export { openaiProvider as openai, createOpenAI };
+
+// ---------------------------------------------------------------------------
+// Model IDs
+// ---------------------------------------------------------------------------
+
+/** Single source of truth for OpenAI model IDs. */
+export const OPENAI_MODEL_IDS = {
+  // GPT-5
+  GPT_5: 'gpt-5',
+  GPT_5_MINI: 'gpt-5-mini',
+  GPT_5_NANO: 'gpt-5-nano',
+  GPT_5_CHAT_LATEST: 'gpt-5-chat-latest',
+  // GPT-4.1
+  GPT_41: 'gpt-4.1',
+  GPT_41_MINI: 'gpt-4.1-mini',
+  GPT_41_NANO: 'gpt-4.1-nano',
+  // GPT-4
+  GPT_4O: 'gpt-4o',
+  GPT_4O_LATEST: 'chatgpt-4o-latest',
+  GPT_4O_MINI: 'gpt-4o-mini',
+  GPT_4O_AUDIO: 'gpt-4o-audio-preview',
+  GPT_4O_REALTIME: 'gpt-4o-realtime-preview',
+  GPT_4_TURBO: 'gpt-4-turbo',
+  GPT_4: 'gpt-4',
+  GPT_4_32K: 'gpt-4-32k',
+  // GPT-3.5
+  GPT_35_TURBO: 'gpt-3.5-turbo',
+  GPT_35_TURBO_INSTRUCT: 'gpt-3.5-turbo-instruct',
+  // O1 reasoning
+  O1: 'o1',
+  O1_MINI: 'o1-mini',
+  O1_PREVIEW: 'o1-preview',
+  // O3
+  O3: 'o3',
+  O3_MINI: 'o3-mini',
+  // O4
+  O4_MINI: 'o4-mini',
+  // Specialized
+  CODEX_MINI_LATEST: 'codex-mini-latest',
+  COMPUTER_USE_PREVIEW: 'computer-use-preview',
+  // Audio
+  WHISPER_1: 'whisper-1',
+  GPT_4O_MINI_TRANSCRIBE: 'gpt-4o-mini-transcribe',
+  GPT_4O_TRANSCRIBE: 'gpt-4o-transcribe',
+  TTS_1: 'tts-1',
+  TTS_1_HD: 'tts-1-hd',
+  GPT_4O_MINI_TTS: 'gpt-4o-mini-tts',
+  // Image
+  GPT_IMAGE_1: 'gpt-image-1',
+  DALL_E_3: 'dall-e-3',
+  DALL_E_2: 'dall-e-2',
+  // Embedding
+  EMBEDDING_3_SMALL: 'text-embedding-3-small',
+  EMBEDDING_3_LARGE: 'text-embedding-3-large',
+  EMBEDDING_ADA_002: 'text-embedding-ada-002',
+  // Moderation
+  MODERATION_LATEST: 'text-moderation-latest',
+  MODERATION_STABLE: 'text-moderation-stable',
+} as const;
+
+/** Model groups for categorization. */
+const OPENAI_MODEL_GROUPS = {
+  REASONING_MODELS: [
+    OPENAI_MODEL_IDS.O1,
+    OPENAI_MODEL_IDS.O1_MINI,
+    OPENAI_MODEL_IDS.O1_PREVIEW,
+    OPENAI_MODEL_IDS.O3,
+    OPENAI_MODEL_IDS.O3_MINI,
+    OPENAI_MODEL_IDS.O4_MINI,
+    OPENAI_MODEL_IDS.CODEX_MINI_LATEST,
+    OPENAI_MODEL_IDS.COMPUTER_USE_PREVIEW,
+  ] as const,
+  GPT5_FAMILY: [
+    OPENAI_MODEL_IDS.GPT_5,
+    OPENAI_MODEL_IDS.GPT_5_MINI,
+    OPENAI_MODEL_IDS.GPT_5_NANO,
+    OPENAI_MODEL_IDS.GPT_5_CHAT_LATEST,
+  ] as const,
+  CHAT_MODELS: [
+    OPENAI_MODEL_IDS.GPT_5,
+    OPENAI_MODEL_IDS.GPT_5_MINI,
+    OPENAI_MODEL_IDS.GPT_5_NANO,
+    OPENAI_MODEL_IDS.GPT_5_CHAT_LATEST,
+    OPENAI_MODEL_IDS.GPT_4O,
+    OPENAI_MODEL_IDS.GPT_4O_MINI,
+    OPENAI_MODEL_IDS.GPT_4_TURBO,
+    OPENAI_MODEL_IDS.GPT_41,
+    OPENAI_MODEL_IDS.GPT_41_MINI,
+    OPENAI_MODEL_IDS.GPT_4,
+    OPENAI_MODEL_IDS.GPT_4_32K,
+    OPENAI_MODEL_IDS.GPT_35_TURBO,
+  ] as const,
+  VISION_MODELS: [
+    OPENAI_MODEL_IDS.GPT_4O,
+    OPENAI_MODEL_IDS.GPT_4O_MINI,
+    OPENAI_MODEL_IDS.GPT_4_TURBO,
+    OPENAI_MODEL_IDS.GPT_41,
+    OPENAI_MODEL_IDS.GPT_41_MINI,
+    OPENAI_MODEL_IDS.GPT_5,
+    OPENAI_MODEL_IDS.GPT_5_MINI,
+  ] as const,
+  LEGACY_MODELS: [
+    OPENAI_MODEL_IDS.GPT_4,
+    OPENAI_MODEL_IDS.GPT_4_32K,
+    OPENAI_MODEL_IDS.GPT_35_TURBO,
+    OPENAI_MODEL_IDS.GPT_35_TURBO_INSTRUCT,
+  ] as const,
+} as const;
+
+export { OPENAI_MODEL_GROUPS };
+
+// ---------------------------------------------------------------------------
+// Option helpers (provider-agnostic spread objects)
+// ---------------------------------------------------------------------------
+
+/** Structured output mode with optional strict JSON schema. */
+export function withStructuredOutput(
+  responseFormat: 'json_object' | 'json_schema' = 'json_object',
+  strictJsonSchema: boolean = false,
+) {
+  return {
+    openai: { responseFormat: { type: responseFormat }, strictJsonSchema },
+  };
+}
+
+/** Reasoning mode for O1/O3/O4 series models. */
+export function withReasoningMode(
+  maxCompletionTokens: number = 25000,
+  reasoningEffort: 'minimal' | 'low' | 'medium' | 'high' = 'medium',
+) {
+  return {
+    providerOptions: {
+      openai: { maxCompletionTokens, reasoningEffort },
+    },
+  };
+}
+
+/** Predicted output for latency optimization. */
+export function withPredictedOutput(prediction: string) {
+  return {
+    openai: {
+      prediction: { type: 'content', content: prediction },
+    },
+  };
+}
+
+/** Prompt caching control. */
+export function withPromptCache(cacheEnabled: boolean = true, promptCacheKey?: string) {
+  const options: Record<string, unknown> = { store: cacheEnabled };
+  if (promptCacheKey) {
+    options.promptCacheKey = promptCacheKey;
+  }
+  return { openai: options };
+}
+
+/** Service tier for latency/cost tradeoffs. */
+export function withServiceTier(tier: 'auto' | 'flex' | 'priority' | 'default' = 'auto') {
+  return { openai: { serviceTier: tier } };
+}
+
+/** Strict mode for structured output validation. */
+export function withStrictMode(enabled: boolean = true) {
+  return { openai: { strict: enabled } };
+}
+
+// ---------------------------------------------------------------------------
+// Presets
+// ---------------------------------------------------------------------------
+
+/** Configuration presets for OpenAI-specific use cases. */
+export const OPENAI_PRESETS = {
+  FAST: {
+    ...commonModes.quick(),
+    openai: { serviceTier: 'flex' },
+  },
+  ACCURATE: {
+    ...commonModes.precise(),
+    openai: { serviceTier: 'priority' },
+  },
+  CREATIVE: {
+    ...commonModes.creative(),
+    frequencyPenalty: 0.5,
+    presencePenalty: 0.5,
+  },
+  REASONING: {
+    ...commonModes.research(),
+    maxOutputTokens: 30000,
+    openai: { reasoningEffort: 'high', reasoningSummary: 'auto' },
+  },
+  CODING: {
+    ...commonModes.code(),
+    maxOutputTokens: 8192,
+    openai: {
+      responseFormat: { type: 'json_object' },
+      logprobs: true,
+      topLogprobs: 3,
+    },
+  },
+} as const;
+
+// ---------------------------------------------------------------------------
+// Capability detection
+// ---------------------------------------------------------------------------
+
+/** Check if model supports reasoning mode. */
+export function supportsReasoningMode(modelId: string): boolean {
+  return OPENAI_MODEL_GROUPS.REASONING_MODELS.includes(
+    modelId as (typeof OPENAI_MODEL_GROUPS.REASONING_MODELS)[number],
+  );
+}
+
+/** Check if model supports service tier selection. */
+export function supportsServiceTier(modelId: string): boolean {
+  const isReasoning = OPENAI_MODEL_GROUPS.REASONING_MODELS.includes(
+    modelId as (typeof OPENAI_MODEL_GROUPS.REASONING_MODELS)[number],
+  );
+  const supported =
+    OPENAI_MODEL_GROUPS.CHAT_MODELS.includes(
+      modelId as (typeof OPENAI_MODEL_GROUPS.CHAT_MODELS)[number],
+    ) ||
+    OPENAI_MODEL_GROUPS.VISION_MODELS.includes(
+      modelId as (typeof OPENAI_MODEL_GROUPS.VISION_MODELS)[number],
+    );
+  return !isReasoning && supported;
+}
+
+/** Check if model supports structured outputs. */
+export function supportsStructuredOutputs(modelId: string): boolean {
+  return (
+    OPENAI_MODEL_GROUPS.CHAT_MODELS.includes(
+      modelId as (typeof OPENAI_MODEL_GROUPS.CHAT_MODELS)[number],
+    ) ||
+    OPENAI_MODEL_GROUPS.VISION_MODELS.includes(
+      modelId as (typeof OPENAI_MODEL_GROUPS.VISION_MODELS)[number],
+    )
+  );
+}
+
+/** Check if model supports prompt caching. */
+export function supportsPromptCaching(modelId: string): boolean {
+  return !OPENAI_MODEL_GROUPS.LEGACY_MODELS.includes(
+    modelId as (typeof OPENAI_MODEL_GROUPS.LEGACY_MODELS)[number],
+  );
+}
+
+// ---------------------------------------------------------------------------
+// Metadata extraction
+// ---------------------------------------------------------------------------
+
+/** Extract reasoning tokens from OpenAI reasoning models. */
+export function extractReasoningTokens(result: GenerationResult): number | undefined {
+  const tokens = result.providerOptions?.openai?.reasoningTokens;
+  return typeof tokens === 'number' ? tokens : undefined;
+}
+
+/** Extract cached prompt tokens from OpenAI responses. */
+export function extractCachedPromptTokens(result: GenerationResult): number | undefined {
+  const tokens = result.providerOptions?.openai?.cachedPromptTokens;
+  return typeof tokens === 'number' ? tokens : undefined;
+}
+
+/** Extract prediction tokens from OpenAI predicted outputs. */
+export function extractPredictionTokens(
+  result: GenerationResult,
+): { accepted?: number; rejected?: number } | undefined {
+  const metadata = result.providerOptions?.openai;
+  if (!metadata) return undefined;
+  const accepted = metadata.acceptedPredictionTokens;
+  const rejected = metadata.rejectedPredictionTokens;
+  return {
+    accepted: typeof accepted === 'number' ? accepted : undefined,
+    rejected: typeof rejected === 'number' ? rejected : undefined,
+  };
+}
+
+/** Extract complete OpenAI provider metadata. */
+export function extractOpenAIMetadata(result: GenerationResult): OpenAIMetadata | null {
+  const openaiMeta = result.providerOptions?.openai;
+  if (!openaiMeta || typeof openaiMeta !== 'object' || Array.isArray(openaiMeta)) return null;
+
+  const meta = openaiMeta;
+  return {
+    responseId: typeof meta.responseId === 'string' ? meta.responseId : undefined,
+    reasoningTokens: typeof meta.reasoningTokens === 'number' ? meta.reasoningTokens : undefined,
+    cachedPromptTokens:
+      typeof meta.cachedPromptTokens === 'number' ? meta.cachedPromptTokens : undefined,
+    acceptedPredictionTokens:
+      typeof meta.acceptedPredictionTokens === 'number' ? meta.acceptedPredictionTokens : undefined,
+    rejectedPredictionTokens:
+      typeof meta.rejectedPredictionTokens === 'number' ? meta.rejectedPredictionTokens : undefined,
+    logprobs: meta.logprobs as OpenAIMetadata['logprobs'],
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+/** OpenAI-specific metadata from generation results. */
+export interface OpenAIMetadata {
+  responseId?: string;
+  reasoningTokens?: number;
+  cachedPromptTokens?: number;
+  acceptedPredictionTokens?: number;
+  rejectedPredictionTokens?: number;
+  logprobs?: Array<{
+    token: string;
+    logprob: number;
+    bytes?: number[];
+    top_logprobs?: Array<{
+      token: string;
+      logprob: number;
+      bytes?: number[];
+    }>;
+  }>;
+}

package/src/models/providers/perplexity.ts

@@ -0,0 +1,276 @@
+/**
+ * @fileoverview Perplexity provider configuration
+ *
+ * Provider-specific model IDs, option helpers, capability detection,
+ * and metadata extraction for Perplexity models.
+ *
+ * Note: @ai-sdk/perplexity is not a direct dependency. Perplexity is accessed
+ * via createOpenAICompatible from the shared module. This file provides
+ * provider-specific configurations, model IDs, and metadata extraction.
+ *
+ * @module @od-oneapp/ai-platform/models/providers/perplexity
+ */
+
+import { commonModes } from './shared';
+
+import type { SDKSharedV3ProviderMetadata } from '../../shared';
+
+// ---------------------------------------------------------------------------
+// Internal types
+// ---------------------------------------------------------------------------
+
+interface GenerationResult {
+  providerOptions?: SDKSharedV3ProviderMetadata;
+  sources?: PerplexitySource[];
+}
+
+// ---------------------------------------------------------------------------
+// Model IDs
+// ---------------------------------------------------------------------------
+
+/** Single source of truth for Perplexity model IDs. */
+export const PERPLEXITY_MODEL_IDS = {
+  SONAR_PRO: 'sonar-pro',
+  SONAR: 'sonar',
+  SONAR_REASONING_PRO: 'sonar-reasoning-pro',
+  SONAR_REASONING: 'sonar-reasoning',
+  SONAR_DEEP_RESEARCH: 'sonar-deep-research',
+} as const;
+
+/** Model groups for categorization. */
+export const PERPLEXITY_MODEL_GROUPS = {
+  RESEARCH_MODELS: [
+    PERPLEXITY_MODEL_IDS.SONAR_DEEP_RESEARCH,
+    PERPLEXITY_MODEL_IDS.SONAR_PRO,
+    PERPLEXITY_MODEL_IDS.SONAR,
+  ] as const,
+  REASONING_MODELS: [
+    PERPLEXITY_MODEL_IDS.SONAR_REASONING_PRO,
+    PERPLEXITY_MODEL_IDS.SONAR_REASONING,
+  ] as const,
+  MULTIMODAL_MODELS: [
+    PERPLEXITY_MODEL_IDS.SONAR_REASONING_PRO,
+    PERPLEXITY_MODEL_IDS.SONAR_REASONING,
+    PERPLEXITY_MODEL_IDS.SONAR_PRO,
+    PERPLEXITY_MODEL_IDS.SONAR,
+  ] as const,
+} as const;
+
+// ---------------------------------------------------------------------------
+// Model capabilities (Perplexity-unique features only)
+// ---------------------------------------------------------------------------
+
+const PERPLEXITY_MODEL_CAPABILITIES: Record<string, PerplexityModelCapabilities> = {
+  [PERPLEXITY_MODEL_IDS.SONAR_DEEP_RESEARCH]: {
+    webSearch: true,
+    citations: true,
+    tierRequirement: 'basic',
+    imageResponses: false,
+  },
+  [PERPLEXITY_MODEL_IDS.SONAR_REASONING_PRO]: {
+    webSearch: true,
+    citations: true,
+    tierRequirement: 'basic',
+    imageResponses: true,
+  },
+  [PERPLEXITY_MODEL_IDS.SONAR_REASONING]: {
+    webSearch: true,
+    citations: true,
+    tierRequirement: 'basic',
+    imageResponses: true,
+  },
+  [PERPLEXITY_MODEL_IDS.SONAR_PRO]: {
+    webSearch: true,
+    citations: true,
+    tierRequirement: 'basic',
+    imageResponses: true,
+  },
+  [PERPLEXITY_MODEL_IDS.SONAR]: {
+    webSearch: true,
+    citations: true,
+    tierRequirement: 'basic',
+    imageResponses: true,
+  },
+};
+
+// ---------------------------------------------------------------------------
+// Option helpers
+// ---------------------------------------------------------------------------
+
+/** Enable image responses (Tier-2+ only). */
+export function withImages() {
+  return {
+    providerOptions: {
+      perplexity: { return_images: true },
+    },
+  };
+}
+
+/** Research mode combining shared research settings with Perplexity image capability. */
+export function withResearchMode(returnImages: boolean = false) {
+  return {
+    ...commonModes.research(),
+    providerOptions: {
+      perplexity: { return_images: returnImages },
+    },
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Capability detection
+// ---------------------------------------------------------------------------
+
+function getModelCapabilities(modelId: string): PerplexityModelCapabilities | undefined {
+  return PERPLEXITY_MODEL_CAPABILITIES[modelId];
+}
+
+/** Check if model supports image responses (Tier-2+ feature). */
+export function supportsImageResponses(modelId: string): boolean {
+  return getModelCapabilities(modelId)?.imageResponses ?? false;
+}
+
+/** Check if model supports web search. */
+export function supportsWebSearch(modelId: string): boolean {
+  return getModelCapabilities(modelId)?.webSearch ?? false;
+}
+
+/** Check if model supports citations. */
+export function supportsCitations(modelId: string): boolean {
+  return getModelCapabilities(modelId)?.citations ?? false;
+}
+
+/** Check if model has reasoning capabilities. */
+export function isReasoningModel(modelId: string): boolean {
+  return PERPLEXITY_MODEL_GROUPS.REASONING_MODELS.includes(
+    modelId as (typeof PERPLEXITY_MODEL_GROUPS.REASONING_MODELS)[number],
+  );
+}
+
+/** Check if model is optimized for research. */
+export function isResearchModel(modelId: string): boolean {
+  return PERPLEXITY_MODEL_GROUPS.RESEARCH_MODELS.includes(
+    modelId as (typeof PERPLEXITY_MODEL_GROUPS.RESEARCH_MODELS)[number],
+  );
+}
+
+// ---------------------------------------------------------------------------
+// Metadata extraction
+// ---------------------------------------------------------------------------
+
+/** Extract sources from Perplexity responses. */
+export function extractSources(result: GenerationResult): PerplexitySource[] {
+  if (Array.isArray(result.sources)) return result.sources;
+
+  const perplexityMetadata = result.providerOptions?.perplexity;
+  if (!perplexityMetadata || typeof perplexityMetadata !== 'object') return [];
+
+  const { sources } = perplexityMetadata;
+  if (!Array.isArray(sources)) return [];
+  return sources as unknown as PerplexitySource[];
+}
+
+/** Extract image responses from Perplexity. */
+export function extractImages(result: GenerationResult): PerplexityImage[] {
+  const perplexityMetadata = result.providerOptions?.perplexity;
+  if (!perplexityMetadata || typeof perplexityMetadata !== 'object') return [];
+
+  const { images } = perplexityMetadata;
+  if (!Array.isArray(images)) return [];
+  return images as unknown as PerplexityImage[];
+}
+
+/** Extract usage metadata from Perplexity. */
+export function extractUsageMetadata(result: GenerationResult): PerplexityUsageMetadata | null {
+  const perplexityMetadata = result.providerOptions?.perplexity;
+  if (
+    !perplexityMetadata ||
+    typeof perplexityMetadata !== 'object' ||
+    Array.isArray(perplexityMetadata)
+  )
+    return null;
+
+  const meta = perplexityMetadata;
+  const { usage } = meta;
+  if (!usage || typeof usage !== 'object' || Array.isArray(usage)) return null;
+
+  const usageData = usage;
+  return {
+    citationTokens: typeof usageData.citationTokens === 'number' ? usageData.citationTokens : 0,
+    numSearchQueries:
+      typeof usageData.numSearchQueries === 'number' ? usageData.numSearchQueries : 0,
+  };
+}
+
+/** Extract complete Perplexity provider metadata. */
+export function extractProviderMetadata(result: GenerationResult): PerplexityMetadata | null {
+  const perplexityMetadata = result.providerOptions?.perplexity;
+  if (!perplexityMetadata || typeof perplexityMetadata !== 'object') return null;
+
+  const meta = perplexityMetadata;
+  const { usage, images } = meta;
+  const sourcesFromMetadata = meta.sources;
+  const sourcesFromResult = Array.isArray(result.sources) ? result.sources : undefined;
+
+  return {
+    usage:
+      usage && typeof usage === 'object' && !Array.isArray(usage)
+        ? ({
+            citationTokens:
+              typeof (usage as Record<string, unknown>).citationTokens === 'number'
+                ? ((usage as Record<string, number>).citationTokens as number)
+                : 0,
+            numSearchQueries:
+              typeof (usage as Record<string, unknown>).numSearchQueries === 'number'
+                ? ((usage as Record<string, number>).numSearchQueries as number)
+                : 0,
+          } satisfies PerplexityUsageMetadata)
+        : undefined,
+    images: Array.isArray(images) ? (images as unknown as PerplexityImage[]) : [],
+    sources:
+      sourcesFromResult && sourcesFromResult.length > 0
+        ? sourcesFromResult
+        : Array.isArray(sourcesFromMetadata)
+          ? (sourcesFromMetadata as unknown as PerplexitySource[])
+          : [],
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+/** Source from Perplexity citations. */
+export interface PerplexitySource {
+  url: string;
+  title?: string;
+  snippet?: string;
+}
+
+/** Image from Perplexity responses. */
+export interface PerplexityImage {
+  imageUrl: string;
+  originUrl: string;
+  height?: number;
+  width?: number;
+}
+
+/** Perplexity usage metadata. */
+export interface PerplexityUsageMetadata {
+  citationTokens: number;
+  numSearchQueries: number;
+}
+
+/** Complete Perplexity metadata. */
+export interface PerplexityMetadata {
+  usage?: PerplexityUsageMetadata;
+  images?: PerplexityImage[];
+  sources?: PerplexitySource[];
+}
+
+/** Perplexity-unique model capabilities. */
+interface PerplexityModelCapabilities {
+  webSearch: boolean;
+  citations: boolean;
+  imageResponses: boolean;
+  tierRequirement: 'basic' | 'tier-2' | 'tier-3';
+}

package/src/models/providers/shared.ts

@@ -0,0 +1,90 @@
+/**
+ * @fileoverview Shared provider utilities
+ *
+ * Common constants and helpers used across all AI providers.
+ * Single source of truth for temperature, token, and topP presets.
+ *
+ * @module @od-oneapp/ai-platform/models/providers/shared
+ */
+
+/**
+ * Common temperature presets used across providers.
+ */
+export const TEMPS = {
+  PRECISE: 0,
+  VERY_LOW: 0.1,
+  FACTUAL: 0.2,
+  LOW_CREATIVE: 0.3,
+  MODERATE: 0.5,
+  BALANCED: 0.7,
+  HIGH_CREATIVE: 0.8,
+  CREATIVE: 0.9,
+} as const;
+
+/**
+ * Common token limit presets.
+ */
+export const TOKENS = {
+  TINY: 256,
+  SHORT: 1024,
+  MEDIUM: 2048,
+  LONG: 4096,
+  EXTENDED: 8192,
+  MAX: 16384,
+} as const;
+
+/**
+ * Common topP values for nucleus sampling.
+ */
+export const TOP_P = {
+  DETERMINISTIC: 1.0,
+  FOCUSED: 0.95,
+  BALANCED: 0.98,
+} as const;
+
+/**
+ * Common mode configurations shared across providers.
+ */
+export const commonModes = {
+  /** Precise mode - deterministic outputs */
+  precise: () => ({
+    temperature: TEMPS.PRECISE,
+    topP: TOP_P.DETERMINISTIC,
+  }),
+
+  /** Code mode - optimized for programming */
+  code: () => ({
+    temperature: TEMPS.FACTUAL,
+    topP: TOP_P.FOCUSED,
+  }),
+
+  /** Creative mode - higher variability */
+  creative: () => ({
+    temperature: TEMPS.CREATIVE,
+    topP: TOP_P.BALANCED,
+  }),
+
+  /** Research mode - balanced accuracy */
+  research: () => ({
+    temperature: TEMPS.FACTUAL,
+    maxOutputTokens: TOKENS.LONG,
+  }),
+
+  /** Quick mode - fast responses */
+  quick: () => ({
+    temperature: TEMPS.MODERATE,
+    maxOutputTokens: TOKENS.SHORT,
+  }),
+};
+
+/** Type for temperature preset keys */
+export type TemperaturePreset = keyof typeof TEMPS;
+
+/** Type for token preset keys */
+export type TokenPreset = keyof typeof TOKENS;
+
+/** Type for topP preset keys */
+export type TopPPreset = keyof typeof TOP_P;
+
+/** Type for common mode keys */
+export type CommonMode = keyof typeof commonModes;