Method resolveModel

src/llm/router.ts:199–235

(modelId: string)

    return out;
  }

  resolveModel(modelId: string): { provider: Provider; modelInfo: ModelInfo; resolvedId: string } | null {
    // Try exact match first
    const direct = this.modelIndex.get(modelId);
    if (direct) {
      // The matched model's OWN id is exactly what the provider expects on the wire.
      // Using it (instead of stripping a leading "provider/") is correct in every case:
      //   - `openai/gpt-4o`        → info.id `gpt-4o`                       (provider prefix dropped)
      //   - `qwen/qwen3-coder-next`→ info.id `qwen/qwen3-coder-next`        (HF publisher kept)
      //   - `nvidia/nemotron-3-super-120b-a12b` on a provider NAMED nvidia → info.id kept VERBATIM.
      // The old "strip if first segment is a provider name" heuristic broke that last case: a
      // custom provider named `nvidia` made it strip the model's `nvidia/` VENDOR prefix, so the
      // gateway got `nemotron-3-...` and 404'd. info.id never has that collision.
      return { provider: direct.provider, modelInfo: direct.info, resolvedId: direct.info.id };
    }
    // Try fuzzy match — only for QodeX-provider prefixes, same rule as above.
    for (const [key, val] of this.modelIndex) {
      if (key.includes('/') && key.endsWith('/' + modelId)) {
        const prefix = key.slice(0, key.length - modelId.length - 1);
        if (this.providers.has(prefix)) {
          return { provider: val.provider, modelInfo: val.info, resolvedId: modelId };
        }
      }
    }

    // Partial match (case-insensitive): lets `--model qwen2.5` select
    // `qwen2.5-coder:32b` when that's the ONLY model matching. Prefix matches are
    // preferred over substring; an ambiguous query (matching 2+ distinct models)
    // resolves to nothing so we never silently pick the wrong model — route()
    // turns that into an error listing the candidates.
    const matches = this.matchModelCandidates(modelId);
    if (matches.length === 1) {
      const val = matches[0]!;
      return { provider: val.provider, modelInfo: val.info, resolvedId: val.info.id };
    }

    return null;
  }

  /**