Adding support for wildcard models in the model_providers config (#696)

* cleaning up plano cli commands

* adding support for wildcard model providers

* fixing compile errors

* fixing bugs related to default model provider, provider hint and duplicates in the model provider list

* fixed cargo fmt issues

* updating tests to always include the model id

* using default for the prompt_gateway path

* fixed the model name, as gpt-5-mini-2025-08-07 wasn't in the config

* making sure that all aliases and models match the config

* fixed the config generator to allow for base_url providers LLMs to include wildcard models

* re-ran the models list utility and added a shell script to run it

* updating docs to mention wildcard model providers

* updated provider_models.json to yaml, added that file to our docs for reference

* updating the build docs to use the new root-based build

---------

Co-authored-by: Salman Paracha <salmanparacha@MacBook-Pro-342.local>

docs/source/_ext/provider_models.py

@@ -0,0 +1,44 @@
+"""Sphinx extension to copy provider_models.yaml to build output."""
+from __future__ import annotations
+
+from pathlib import Path
+from typing import TYPE_CHECKING
+import shutil
+
+if TYPE_CHECKING:
+    from sphinx.application import Sphinx
+
+
+def _on_build_finished(app: Sphinx, exception: Exception | None) -> None:
+    """Copy provider_models.yaml to the build output after build completes."""
+    if exception is not None:
+        return
+
+    # Only generate for HTML-like builders where app.outdir is a website root.
+    if getattr(app.builder, "format", None) != "html":
+        return
+
+    # Source path: provider_models.yaml is copied into the Docker image at /docs/provider_models.yaml
+    # This follows the pattern used for config templates like envoy.template.yaml and arch_config_schema.yaml
+    docs_root = Path(app.srcdir).parent  # Goes from source/ to docs/
+    source_path = docs_root / "provider_models.yaml"
+
+    if not source_path.exists():
+        # Silently skip if source file doesn't exist
+        return
+
+    # Per repo convention, place generated artifacts under an `includes/` folder.
+    out_path = Path(app.outdir) / "includes" / "provider_models.yaml"
+    out_path.parent.mkdir(parents=True, exist_ok=True)
+
+    shutil.copy2(source_path, out_path)
+
+
+def setup(app: Sphinx) -> dict[str, object]:
+    """Register the extension with Sphinx."""
+    app.connect("build-finished", _on_build_finished)
+    return {
+        "version": "0.1.0",
+        "parallel_read_safe": True,
+        "parallel_write_safe": True,
+    }