Hephaestus now appears when any of its providers (openai, github-copilot, opencode) is connected, rather than requiring the exact gpt-5.2-codex model. This allows users with newer codex models (e.g., gpt-5.3-codex) to use Hephaestus without manual config overrides. - Add requiresProvider field to ModelRequirement type - Add isAnyProviderConnected() helper in model-availability - Update hephaestus config from requiresModel to requiresProvider - Update cli model-fallback to handle requiresProvider checks
358 lines
11 KiB
TypeScript
358 lines
11 KiB
TypeScript
import { existsSync, readFileSync } from "fs"
|
|
import { join } from "path"
|
|
import { log } from "./logger"
|
|
import { getOpenCodeCacheDir } from "./data-path"
|
|
import { readProviderModelsCache, hasProviderModelsCache, readConnectedProvidersCache } from "./connected-providers-cache"
|
|
|
|
/**
|
|
* Fuzzy match a target model name against available models
|
|
*
|
|
* @param target - The model name or substring to search for (e.g., "gpt-5.2", "claude-opus")
|
|
* @param available - Set of available model names in format "provider/model-name"
|
|
* @param providers - Optional array of provider names to filter by (e.g., ["openai", "anthropic"])
|
|
* @returns The matched model name or null if no match found
|
|
*
|
|
* Matching priority:
|
|
* 1. Exact match (if exists)
|
|
* 2. Shorter model name (more specific)
|
|
*
|
|
* Matching is case-insensitive substring match.
|
|
* If providers array is given, only models starting with "provider/" are considered.
|
|
*
|
|
* @example
|
|
* const available = new Set(["openai/gpt-5.2", "openai/gpt-5.2-codex", "anthropic/claude-opus-4-5"])
|
|
* fuzzyMatchModel("gpt-5.2", available) // → "openai/gpt-5.2"
|
|
* fuzzyMatchModel("claude", available, ["openai"]) // → null (provider filter excludes anthropic)
|
|
*/
|
|
function normalizeModelName(name: string): string {
|
|
return name
|
|
.toLowerCase()
|
|
.replace(/claude-(opus|sonnet|haiku)-4-5/g, "claude-$1-4.5")
|
|
.replace(/claude-(opus|sonnet|haiku)-4\.5/g, "claude-$1-4.5")
|
|
}
|
|
|
|
export function fuzzyMatchModel(
|
|
target: string,
|
|
available: Set<string>,
|
|
providers?: string[],
|
|
): string | null {
|
|
log("[fuzzyMatchModel] called", { target, availableCount: available.size, providers })
|
|
|
|
if (available.size === 0) {
|
|
log("[fuzzyMatchModel] empty available set")
|
|
return null
|
|
}
|
|
|
|
const targetNormalized = normalizeModelName(target)
|
|
|
|
// Filter by providers if specified
|
|
let candidates = Array.from(available)
|
|
if (providers && providers.length > 0) {
|
|
const providerSet = new Set(providers)
|
|
candidates = candidates.filter((model) => {
|
|
const [provider] = model.split("/")
|
|
return providerSet.has(provider)
|
|
})
|
|
log("[fuzzyMatchModel] filtered by providers", { candidateCount: candidates.length, candidates: candidates.slice(0, 10) })
|
|
}
|
|
|
|
if (candidates.length === 0) {
|
|
log("[fuzzyMatchModel] no candidates after filter")
|
|
return null
|
|
}
|
|
|
|
// Find all matches (case-insensitive substring match with normalization)
|
|
const matches = candidates.filter((model) =>
|
|
normalizeModelName(model).includes(targetNormalized),
|
|
)
|
|
|
|
log("[fuzzyMatchModel] substring matches", { targetNormalized, matchCount: matches.length, matches })
|
|
|
|
if (matches.length === 0) {
|
|
return null
|
|
}
|
|
|
|
// Priority 1: Exact match (normalized full model string)
|
|
const exactMatch = matches.find((model) => normalizeModelName(model) === targetNormalized)
|
|
if (exactMatch) {
|
|
log("[fuzzyMatchModel] exact match found", { exactMatch })
|
|
return exactMatch
|
|
}
|
|
|
|
// Priority 2: Exact model ID match (part after provider/)
|
|
// This ensures "glm-4.7-free" matches "zai-coding-plan/glm-4.7-free" over "zai-coding-plan/glm-4.7"
|
|
// Use filter + shortest to handle multi-provider cases (e.g., openai/gpt-5.2 + opencode/gpt-5.2)
|
|
const exactModelIdMatches = matches.filter((model) => {
|
|
const modelId = model.split("/").slice(1).join("/")
|
|
return normalizeModelName(modelId) === targetNormalized
|
|
})
|
|
if (exactModelIdMatches.length > 0) {
|
|
const result = exactModelIdMatches.reduce((shortest, current) =>
|
|
current.length < shortest.length ? current : shortest,
|
|
)
|
|
log("[fuzzyMatchModel] exact model ID match found", { result, candidateCount: exactModelIdMatches.length })
|
|
return result
|
|
}
|
|
|
|
// Priority 3: Shorter model name (more specific, fallback for partial matches)
|
|
const result = matches.reduce((shortest, current) =>
|
|
current.length < shortest.length ? current : shortest,
|
|
)
|
|
log("[fuzzyMatchModel] shortest match", { result })
|
|
return result
|
|
}
|
|
|
|
/**
|
|
* Check if a target model is available (fuzzy match by model name, no provider filtering)
|
|
*
|
|
* @param targetModel - Model name to check (e.g., "gpt-5.2-codex")
|
|
* @param availableModels - Set of available models in "provider/model" format
|
|
* @returns true if model is available, false otherwise
|
|
*/
|
|
export function isModelAvailable(
|
|
targetModel: string,
|
|
availableModels: Set<string>,
|
|
): boolean {
|
|
return fuzzyMatchModel(targetModel, availableModels) !== null
|
|
}
|
|
|
|
export async function getConnectedProviders(client: any): Promise<string[]> {
|
|
if (!client?.provider?.list) {
|
|
log("[getConnectedProviders] client.provider.list not available")
|
|
return []
|
|
}
|
|
|
|
try {
|
|
const result = await client.provider.list()
|
|
const connected = result.data?.connected ?? []
|
|
log("[getConnectedProviders] connected providers", { count: connected.length, providers: connected })
|
|
return connected
|
|
} catch (err) {
|
|
log("[getConnectedProviders] SDK error", { error: String(err) })
|
|
return []
|
|
}
|
|
}
|
|
|
|
export async function fetchAvailableModels(
|
|
client?: any,
|
|
options?: { connectedProviders?: string[] | null }
|
|
): Promise<Set<string>> {
|
|
let connectedProviders = options?.connectedProviders ?? null
|
|
let connectedProvidersUnknown = connectedProviders === null
|
|
|
|
log("[fetchAvailableModels] CALLED", {
|
|
connectedProvidersUnknown,
|
|
connectedProviders: options?.connectedProviders
|
|
})
|
|
|
|
if (connectedProvidersUnknown && client) {
|
|
const liveConnected = await getConnectedProviders(client)
|
|
if (liveConnected.length > 0) {
|
|
connectedProviders = liveConnected
|
|
connectedProvidersUnknown = false
|
|
log("[fetchAvailableModels] connected providers fetched from client", { count: liveConnected.length })
|
|
}
|
|
}
|
|
|
|
if (connectedProvidersUnknown) {
|
|
if (client?.model?.list) {
|
|
const modelSet = new Set<string>()
|
|
try {
|
|
const modelsResult = await client.model.list()
|
|
const models = modelsResult.data ?? []
|
|
for (const model of models) {
|
|
if (model?.provider && model?.id) {
|
|
modelSet.add(`${model.provider}/${model.id}`)
|
|
}
|
|
}
|
|
log("[fetchAvailableModels] fetched models from client without provider filter", {
|
|
count: modelSet.size,
|
|
})
|
|
return modelSet
|
|
} catch (err) {
|
|
log("[fetchAvailableModels] client.model.list error", { error: String(err) })
|
|
}
|
|
}
|
|
log("[fetchAvailableModels] connected providers unknown, returning empty set for fallback resolution")
|
|
return new Set<string>()
|
|
}
|
|
|
|
const connectedProvidersList = connectedProviders ?? []
|
|
const connectedSet = new Set(connectedProvidersList)
|
|
const modelSet = new Set<string>()
|
|
|
|
const providerModelsCache = readProviderModelsCache()
|
|
if (providerModelsCache) {
|
|
const providerCount = Object.keys(providerModelsCache.models).length
|
|
if (providerCount === 0) {
|
|
log("[fetchAvailableModels] provider-models cache empty, falling back to models.json")
|
|
} else {
|
|
log("[fetchAvailableModels] using provider-models cache (whitelist-filtered)")
|
|
|
|
for (const [providerId, modelIds] of Object.entries(providerModelsCache.models)) {
|
|
if (!connectedSet.has(providerId)) {
|
|
continue
|
|
}
|
|
for (const modelItem of modelIds) {
|
|
// Handle both string[] (legacy) and object[] (with metadata) formats
|
|
const modelId = typeof modelItem === 'string'
|
|
? modelItem
|
|
: (modelItem as any)?.id
|
|
|
|
if (modelId) {
|
|
modelSet.add(`${providerId}/${modelId}`)
|
|
}
|
|
}
|
|
}
|
|
|
|
log("[fetchAvailableModels] parsed from provider-models cache", {
|
|
count: modelSet.size,
|
|
connectedProviders: connectedProvidersList.slice(0, 5)
|
|
})
|
|
|
|
if (modelSet.size > 0) {
|
|
return modelSet
|
|
}
|
|
log("[fetchAvailableModels] provider-models cache produced no models for connected providers, falling back to models.json")
|
|
}
|
|
}
|
|
|
|
log("[fetchAvailableModels] provider-models cache not found, falling back to models.json")
|
|
const cacheFile = join(getOpenCodeCacheDir(), "models.json")
|
|
|
|
if (!existsSync(cacheFile)) {
|
|
log("[fetchAvailableModels] models.json cache file not found, falling back to client")
|
|
} else {
|
|
try {
|
|
const content = readFileSync(cacheFile, "utf-8")
|
|
const data = JSON.parse(content) as Record<string, { id?: string; models?: Record<string, { id?: string }> }>
|
|
|
|
const providerIds = Object.keys(data)
|
|
log("[fetchAvailableModels] providers found in models.json", { count: providerIds.length, providers: providerIds.slice(0, 10) })
|
|
|
|
for (const providerId of providerIds) {
|
|
if (!connectedSet.has(providerId)) {
|
|
continue
|
|
}
|
|
|
|
const provider = data[providerId]
|
|
const models = provider?.models
|
|
if (!models || typeof models !== "object") continue
|
|
|
|
for (const modelKey of Object.keys(models)) {
|
|
modelSet.add(`${providerId}/${modelKey}`)
|
|
}
|
|
}
|
|
|
|
log("[fetchAvailableModels] parsed models from models.json (NO whitelist filtering)", {
|
|
count: modelSet.size,
|
|
connectedProviders: connectedProvidersList.slice(0, 5)
|
|
})
|
|
|
|
if (modelSet.size > 0) {
|
|
return modelSet
|
|
}
|
|
} catch (err) {
|
|
log("[fetchAvailableModels] error", { error: String(err) })
|
|
}
|
|
}
|
|
|
|
if (client?.model?.list) {
|
|
try {
|
|
const modelsResult = await client.model.list()
|
|
const models = modelsResult.data ?? []
|
|
|
|
for (const model of models) {
|
|
if (!model?.provider || !model?.id) continue
|
|
if (connectedSet.has(model.provider)) {
|
|
modelSet.add(`${model.provider}/${model.id}`)
|
|
}
|
|
}
|
|
|
|
log("[fetchAvailableModels] fetched models from client (filtered)", {
|
|
count: modelSet.size,
|
|
connectedProviders: connectedProvidersList.slice(0, 5),
|
|
})
|
|
} catch (err) {
|
|
log("[fetchAvailableModels] client.model.list error", { error: String(err) })
|
|
}
|
|
}
|
|
|
|
return modelSet
|
|
}
|
|
|
|
export function isAnyFallbackModelAvailable(
|
|
fallbackChain: Array<{ providers: string[]; model: string }>,
|
|
availableModels: Set<string>,
|
|
): boolean {
|
|
// If we have models, check them first
|
|
if (availableModels.size > 0) {
|
|
for (const entry of fallbackChain) {
|
|
const hasAvailableProvider = entry.providers.some((provider) => {
|
|
return fuzzyMatchModel(entry.model, availableModels, [provider]) !== null
|
|
})
|
|
if (hasAvailableProvider) {
|
|
return true
|
|
}
|
|
}
|
|
}
|
|
|
|
// Fallback: check if any provider in the chain is connected
|
|
// This handles race conditions where availableModels is empty or incomplete
|
|
// but we know the provider is connected.
|
|
const connectedProviders = readConnectedProvidersCache()
|
|
if (connectedProviders) {
|
|
const connectedSet = new Set(connectedProviders)
|
|
for (const entry of fallbackChain) {
|
|
if (entry.providers.some((p) => connectedSet.has(p))) {
|
|
log("[isAnyFallbackModelAvailable] model not in available set, but provider is connected", {
|
|
model: entry.model,
|
|
availableCount: availableModels.size,
|
|
})
|
|
return true
|
|
}
|
|
}
|
|
}
|
|
|
|
return false
|
|
}
|
|
|
|
export function isAnyProviderConnected(
|
|
providers: string[],
|
|
availableModels: Set<string>,
|
|
): boolean {
|
|
if (availableModels.size > 0) {
|
|
const providerSet = new Set(providers)
|
|
for (const model of availableModels) {
|
|
const [provider] = model.split("/")
|
|
if (providerSet.has(provider)) {
|
|
log("[isAnyProviderConnected] found model from required provider", { provider, model })
|
|
return true
|
|
}
|
|
}
|
|
}
|
|
|
|
const connectedProviders = readConnectedProvidersCache()
|
|
if (connectedProviders) {
|
|
const connectedSet = new Set(connectedProviders)
|
|
for (const provider of providers) {
|
|
if (connectedSet.has(provider)) {
|
|
log("[isAnyProviderConnected] provider connected via cache", { provider })
|
|
return true
|
|
}
|
|
}
|
|
}
|
|
|
|
return false
|
|
}
|
|
|
|
export function __resetModelCache(): void {}
|
|
|
|
export function isModelCacheAvailable(): boolean {
|
|
if (hasProviderModelsCache()) {
|
|
return true
|
|
}
|
|
const cacheFile = join(getOpenCodeCacheDir(), "models.json")
|
|
return existsSync(cacheFile)
|
|
}
|