ai.matey.core 0.2.0

package/dist/esm/model-translation.js

@@ -0,0 +1,163 @@
+/**
+ * Core Model Translation
+ *
+ * Backend-agnostic model translation utilities for converting model names
+ * between different AI providers. Works in any environment (Node.js, Browser, Deno, etc.).
+ *
+ * @module core/model-translation
+ */
+// ============================================================================
+// Core Translation Functions
+// ============================================================================
+/**
+ * Translate a model name using exact mapping.
+ *
+ * @param modelName - Original model name
+ * @param options - Translation options
+ * @returns Translation result
+ *
+ * @example
+ * ```typescript
+ * const result = translateModel('gpt-4', {
+ *   mapping: { 'gpt-4': 'claude-3-5-sonnet-20241022' }
+ * });
+ * // → { translated: 'claude-3-5-sonnet-20241022', source: 'exact', wasTranslated: true }
+ * ```
+ */
+export function translateModel(modelName, options = {}) {
+    const { mapping, defaultModel, strategy = 'exact', strictMode = false } = options;
+    // 1. Try exact match (all strategies except 'none')
+    if (strategy !== 'none' && mapping?.[modelName]) {
+        return {
+            translated: mapping[modelName],
+            source: 'exact',
+            wasTranslated: true,
+        };
+    }
+    // 2. Try backend default (only for hybrid strategy)
+    if (strategy === 'hybrid' && defaultModel) {
+        return {
+            translated: defaultModel,
+            source: 'default',
+            wasTranslated: true,
+        };
+    }
+    // 3. No translation found
+    if (strictMode) {
+        throw new Error(`No translation found for model: ${modelName}`);
+    }
+    return {
+        translated: modelName,
+        source: 'none',
+        wasTranslated: false,
+    };
+}
+/**
+ * Create a model translator with pre-configured options.
+ *
+ * @param options - Default translation options
+ * @returns Translator function
+ *
+ * @example
+ * ```typescript
+ * const translator = createModelTranslator({
+ *   mapping: { 'gpt-4': 'claude-3-5-sonnet-20241022' },
+ *   strategy: 'hybrid',
+ *   defaultModel: 'claude-3-5-haiku-20241022'
+ * });
+ *
+ * const result = translator('gpt-4');
+ * // → { translated: 'claude-3-5-sonnet-20241022', source: 'exact', wasTranslated: true }
+ * ```
+ */
+export function createModelTranslator(defaultOptions) {
+    return (modelName, overrides) => {
+        return translateModel(modelName, { ...defaultOptions, ...overrides });
+    };
+}
+/**
+ * Get reverse mapping (target model → source model).
+ *
+ * @param mapping - Forward mapping
+ * @returns Reverse mapping
+ *
+ * @example
+ * ```typescript
+ * const forward = { 'gpt-4': 'claude-3-5-sonnet' };
+ * const reverse = reverseMapping(forward);
+ * // → { 'claude-3-5-sonnet': 'gpt-4' }
+ * ```
+ */
+export function reverseMapping(mapping) {
+    const reversed = {};
+    for (const [key, value] of Object.entries(mapping)) {
+        reversed[value] = key;
+    }
+    return reversed;
+}
+/**
+ * Check if a model name has an exact translation.
+ *
+ * @param modelName - Model name to check
+ * @param mapping - Model mapping
+ * @returns True if exact translation exists
+ *
+ * @example
+ * ```typescript
+ * const mapping = { 'gpt-4': 'claude-3-5-sonnet' };
+ * hasTranslation('gpt-4', mapping); // → true
+ * hasTranslation('gpt-3.5', mapping); // → false
+ * ```
+ */
+export function hasTranslation(modelName, mapping) {
+    return modelName in mapping;
+}
+/**
+ * Merge multiple model mappings into one.
+ *
+ * Later mappings take precedence over earlier ones.
+ *
+ * @param mappings - Array of mappings to merge
+ * @returns Merged mapping
+ *
+ * @example
+ * ```typescript
+ * const mapping1 = { 'gpt-4': 'claude-3-opus' };
+ * const mapping2 = { 'gpt-4': 'claude-3-5-sonnet' }; // Override
+ * const merged = mergeMappings(mapping1, mapping2);
+ * // → { 'gpt-4': 'claude-3-5-sonnet' }
+ * ```
+ */
+export function mergeMappings(...mappings) {
+    const result = {};
+    for (const mapping of mappings) {
+        Object.assign(result, mapping);
+    }
+    return result;
+}
+/**
+ * Validate that a model mapping is well-formed.
+ *
+ * @param mapping - Mapping to validate
+ * @throws Error if mapping is invalid
+ *
+ * @example
+ * ```typescript
+ * validateMapping({ 'gpt-4': 'claude-3-5-sonnet' }); // OK
+ * validateMapping({ 'gpt-4': '' }); // Throws: empty target model
+ * ```
+ */
+export function validateMapping(mapping) {
+    if (typeof mapping !== 'object' || mapping === null) {
+        throw new Error('Model mapping must be an object');
+    }
+    for (const [source, target] of Object.entries(mapping)) {
+        if (typeof source !== 'string' || source.length === 0) {
+            throw new Error(`Invalid source model: ${source}`);
+        }
+        if (typeof target !== 'string' || target.length === 0) {
+            throw new Error(`Invalid target model for "${source}": ${target}`);
+        }
+    }
+}
+//# sourceMappingURL=model-translation.js.map

package/dist/esm/model-translation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-translation.js","sourceRoot":"","sources":["../../src/model-translation.ts"],"names":[],"mappings":"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"}