@llumiverse/common 1.3.0 → 1.4.0

package/lib/cjs/options/version-parsing.js

@@ -1,326 +0,0 @@
-"use strict";
-/**
- * Version parsing utilities for Claude and Gemini models.
- *
- * Provides version detection helpers that are forward-compatible with future
- * model releases (e.g., Haiku 4.7, Sonnet 4.7, Opus 4.8, Opus 5).
- *
- * These helpers are used to:
- * - Control option visibility in the UI
- * - Construct appropriate API payloads for each model version
- *
- * Note: llumiverse does NOT validate options here. Errors from invalid
- * parameters propagate to the provider side.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseClaudeVersion = parseClaudeVersion;
-exports.isClaudeVersionGTE = isClaudeVersionGTE;
-exports.hasSamplingParameterRemoval = hasSamplingParameterRemoval;
-exports.requiresAdaptiveThinking = requiresAdaptiveThinking;
-exports.supportsAdaptiveThinking = supportsAdaptiveThinking;
-exports.isExtendedThinkingDeprecated = isExtendedThinkingDeprecated;
-exports.requiresAdaptiveThinkingOnly = requiresAdaptiveThinkingOnly;
-exports.hasSamplingParameterRestriction = hasSamplingParameterRestriction;
-exports.supportsEffort = supportsEffort;
-exports.supportsXHighEffort = supportsXHighEffort;
-exports.getAvailableEffortLevels = getAvailableEffortLevels;
-exports.getGeminiModelVersion = getGeminiModelVersion;
-exports.parseGeminiVersion = parseGeminiVersion;
-exports.isGeminiModelVersionGte = isGeminiModelVersionGte;
-/**
- * Parse Claude model version from a model string.
- *
- * Examples:
- * - "claude-opus-4-7" -> { major: 4, minor: 7, variant: 'opus' }
- * - "claude-sonnet-4-6" -> { major: 4, minor: 6, variant: 'sonnet' }
- * - "claude-3-7-sonnet-20250219" -> { major: 3, minor: 7, variant: 'sonnet' }
- * - "claude-opus-4-6" -> { major: 4, minor: 6, variant: 'opus' }
- *
- * @param modelString - The model identifier string
- * @returns Parsed version info, or null if not parseable
- */
-function parseClaudeVersion(modelString) {
-    // Match pattern: claude-[variant-]-{major}-[optional minor]
-    // The minor version is limited to 1-2 digits to avoid matching dates (YYYYMMDD format)
-    const match = modelString.match(/claude-(opus|sonnet|haiku)-?(\d+)(?:-(\d{1,2}))?(?:-|\b)/i);
-    if (match) {
-        const variant = match[1].toLowerCase();
-        const major = parseInt(match[2], 10);
-        const minor = match[3] ? parseInt(match[3], 10) : 0;
-        return { major, minor, variant };
-    }
-    // Fallback for older format: claude-3-7-sonnet-20250219
-    const fallbackMatch = modelString.match(/claude-(\d+)-(\d+)-(\w+)/i);
-    if (fallbackMatch) {
-        const major = parseInt(fallbackMatch[1], 10);
-        const minor = parseInt(fallbackMatch[2], 10);
-        const variant = fallbackMatch[3].toLowerCase();
-        return { major, minor, variant };
-    }
-    return null;
-}
-/**
- * Check if a Claude model version is greater than or equal to a target version.
- *
- * @param modelString - The model identifier string
- * @param targetMajor - Target major version
- * @param targetMinor - Target minor version
- * @returns true if the model version is >= target version, false otherwise
- */
-function isClaudeVersionGTE(modelString, targetMajor, targetMinor) {
-    const version = parseClaudeVersion(modelString);
-    if (!version) {
-        return false;
-    }
-    if (version.major > targetMajor) {
-        return true;
-    }
-    if (version.major === targetMajor && version.minor >= targetMinor) {
-        return true;
-    }
-    return false;
-}
-/**
- * Check if a Claude variant model version is greater than or equal to a target version.
- *
- * @param modelString - The model identifier string
- * @param variant - Model variant: "opus" or "sonnet"
- * @param targetMajor - Target major version
- * @param targetMinor - Target minor version
- * @returns true if the model matches the variant and version >= target
- */
-function isClaudeVariantVersionGTE(modelString, variant, targetMajor, targetMinor) {
-    const version = parseClaudeVersion(modelString);
-    if (!version)
-        return false;
-    if (version.variant.toLowerCase() !== variant)
-        return false;
-    return version.major > targetMajor || (version.major === targetMajor && version.minor >= targetMinor);
-}
-/**
- * Check if a model requires sampling parameter removal (behavior: sampling params removed on Opus 4.7+).
- *
- * This includes:
- * - claude-opus-4-7
- * - Future Opus 4.x with minor >= 7
- * - Future Opus 5.x+
- *
- * @param modelString - The model identifier string
- * @returns true if Opus 4.7+ or equivalent future model
- */
-function hasSamplingParameterRemoval(modelString) {
-    return isClaudeVariantVersionGTE(modelString, "opus", 4, 7);
-}
-/**
- * Check if a model requires adaptive thinking (behavior: adaptive thinking required on Opus 4.6+).
- *
- * This includes:
- * - claude-opus-4-6
- * - claude-opus-4-7
- * - Future Opus 4.x with minor >= 6
- * - Future Opus 5.x+
- *
- * @param modelString - The model identifier string
- * @returns true if Opus 4.6+ or equivalent future model
- */
-function requiresAdaptiveThinking(modelString) {
-    return isClaudeVariantVersionGTE(modelString, "opus", 4, 6);
-}
-/**
- * Check if a model supports adaptive thinking.
- *
- * Adaptive thinking was introduced in:
- * - Claude Opus 4.6
- * - Claude Sonnet 4.6
- *
- * @param modelString - The model identifier string
- * @returns true if the model supports adaptive thinking
- */
-function supportsAdaptiveThinking(modelString) {
-    return requiresAdaptiveThinking(modelString) || isClaudeVariantVersionGTE(modelString, "sonnet", 4, 6);
-}
-/**
- * Check if extended thinking is deprecated for this model.
- *
- * Extended thinking (thinking.type: "enabled" with budget_tokens) is deprecated
- * but still functional on:
- * - Claude Opus 4.6+
- * - Claude Sonnet 4.6+
- *
- * @param modelString - The model identifier string
- * @returns true if extended thinking is deprecated (adaptive thinking recommended)
- */
-function isExtendedThinkingDeprecated(modelString) {
-    return supportsAdaptiveThinking(modelString);
-}
-/**
- * Check if a model requires adaptive thinking ONLY (extended thinking removed).
- *
- * On Opus 4.7+, extended thinking returns a 400 error. Only adaptive thinking is supported.
- * Future models (Sonnet 4.7+, Haiku 4.7+, any 5.0+) follow the same pattern.
- *
- * @param modelString - The model identifier string
- * @returns true if extended thinking is removed (returns 400 error)
- */
-function requiresAdaptiveThinkingOnly(modelString) {
-    return hasSamplingParameterRestriction(modelString);
-}
-/**
- * Check if a model has sampling parameter restrictions.
- *
- * On Opus 4.7+, setting temperature, top_p, or top_k to any non-default value
- * returns a 400 error. Future models following the same pattern will also match:
- * - Opus 4.7+ (current restriction)
- * - Sonnet 4.7+, Haiku 4.7+ (future minor versions >= 7)
- * - Sonnet 5.0+, Haiku 5.0+, Opus 5.0+ (future major versions)
- *
- * @param modelString - The model identifier string
- * @returns true if sampling parameters are restricted
- */
-function hasSamplingParameterRestriction(modelString) {
-    const version = parseClaudeVersion(modelString);
-    if (!version) {
-        return false;
-    }
-    // Future major versions (5.0+) follow the same pattern as 4.7
-    if (version.major > 4) {
-        return true;
-    }
-    // Version 4.7+ (Opus 4.7, Sonnet 4.7, Haiku 4.7, etc.)
-    if (version.major === 4 && version.minor >= 7) {
-        return true;
-    }
-    return false;
-}
-/**
- * Check if a model supports the effort parameter.
- *
- * Effort is supported on:
- * - Claude Opus 4.5+
- * - Claude Opus 4.6+
- * - Claude Sonnet 4.6+
- * - All variants at 4.7+ (Opus, Sonnet, Haiku)
- * - All variants at 5.0+
- *
- * @param modelString - The model identifier string
- * @returns true if the model supports the effort parameter
- */
-function supportsEffort(modelString) {
-    // All 4.7+ variants support effort (covers future Sonnet 4.7, Haiku 4.7, etc.)
-    if (hasSamplingParameterRestriction(modelString)) {
-        return true;
-    }
-    // Opus 4.5+ supports effort
-    if (isClaudeVariantVersionGTE(modelString, "opus", 4, 5)) {
-        return true;
-    }
-    // Sonnet 4.6+ supports effort
-    if (isClaudeVariantVersionGTE(modelString, "sonnet", 4, 6)) {
-        return true;
-    }
-    return false;
-}
-/**
- * Check if a model supports the xhigh effort level.
- *
- * xhigh is only available on Opus 4.7+.
- *
- * @param modelString - The model identifier string
- * @returns true if the model supports xhigh effort
- */
-function supportsXHighEffort(modelString) {
-    return isClaudeVariantVersionGTE(modelString, "opus", 4, 7);
-}
-/**
- * Get the available effort levels for a given Claude model.
- *
- * - Opus 4.7+: low, medium, high, xhigh, max
- * - Opus 4.5+, Opus 4.6+, Sonnet 4.6+: low, medium, high, max
- * - Other models: empty (effort not supported)
- *
- * @param modelString - The model identifier string
- * @returns Record of display label to effort level value, or null if not supported
- */
-function getAvailableEffortLevels(modelString) {
-    if (!supportsEffort(modelString)) {
-        return null;
-    }
-    const levels = {
-        "Low": "low",
-        "Medium": "medium",
-        "High (default)": "high",
-        "Max": "max",
-    };
-    if (supportsXHighEffort(modelString)) {
-        // Insert xhigh between high and max
-        return {
-            "Low": "low",
-            "Medium": "medium",
-            "High (default)": "high",
-            "Extra High": "xhigh",
-            "Max": "max",
-        };
-    }
-    return levels;
-}
-// ============================================================================
-// Gemini Version Parsing
-// ============================================================================
-/**
- * Extract Gemini version from a model ID.
- *
- * Examples:
- * - "locations/global/publishers/google/models/gemini-2.5-flash" -> "2.5"
- * - "publishers/google/models/gemini-3-pro-image-preview" -> "3"
- * - "gemini-3.1-flash-lite-preview" -> "3.1"
- *
- * @param modelId - The model identifier string
- * @returns Version string (e.g., "2.5", "3", "3.1"), or undefined if not parseable
- */
-function getGeminiModelVersion(modelId) {
-    const modelName = modelId.split('/').pop() ?? modelId;
-    const match = modelName.match(/^gemini-(\d+(?:\.\d+)?)/i);
-    return match?.[1];
-}
-/**
- * Parse a version string into major.minor components.
- *
- * @param version - Version string (e.g., "2.5", "3", "3.1")
- * @returns Parsed version, or undefined if not parseable
- */
-function parseGeminiVersion(version) {
-    const match = version.match(/^(\d+)(?:\.(\d+))?$/);
-    if (!match) {
-        return undefined;
-    }
-    return {
-        major: Number(match[1]),
-        minor: Number(match[2] ?? '0'),
-    };
-}
-/**
- * Check if a Gemini model version is greater than or equal to a minimum version.
- *
- * @param modelId - The model identifier string
- * @param minVersion - Minimum version string (e.g., "2.5", "3.0")
- * @returns true if model version >= min version
- */
-function isGeminiModelVersionGte(modelId, minVersion) {
-    const modelVersion = getGeminiModelVersion(modelId);
-    if (!modelVersion) {
-        return false;
-    }
-    const current = parseGeminiVersion(modelVersion);
-    const target = parseGeminiVersion(minVersion);
-    if (!current || !target) {
-        return false;
-    }
-    if (current.major > target.major) {
-        return true;
-    }
-    if (current.major < target.major) {
-        return false;
-    }
-    return current.minor >= target.minor;
-}
-//# sourceMappingURL=version-parsing.js.map

package/lib/cjs/options/version-parsing.js.map

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