feat: remove usage of build yaml (#4192)

# What does this PR do?

the build.yaml is only used in the following ways:

1. list-deps
2. distribution code-gen

since `llama stack build` no longer exists, I found myself asking "why
do we need two different files for list-deps and run"?

Removing the BuildConfig and altering the usage of the
DistributionTemplate in llama stack list-deps is the first step in
removing the build yaml entirely.

Removing the BuildConfig and build.yaml cuts the files users need to
maintain in half, and allows us to focus on the stability of _just_ the
run.yaml

This PR removes the build.yaml, BuildConfig datatype, and its usage
throughout the codebase. Users are now expected to point to run.yaml
files when running list-deps, and our codebase automatically uses these
types now for things like `get_provider_registry`.

**Additionally, two renames: `StackRunConfig` -> `StackConfig` and
`run.yaml` -> `config.yaml`.**

The build.yaml made sense for when we were managing the build process
for the user and actually _producing_ a run.yaml _from_ the build.yaml,
but now that we are simply just getting the provider registry and
listing the deps, switching to config.yaml simplifies the scope here
greatly.

## Test Plan

existing list-deps usage should work in the tests.

---------

Signed-off-by: Charlie Doern <cdoern@redhat.com>

.github/workflows/README.md

@@ -4,7 +4,7 @@ Llama Stack uses GitHub Actions for Continuous Integration (CI). Below is a tabl
 
 | Name | File | Purpose |
 | ---- | ---- | ------- |
-| Backward Compatibility Check | [backward-compat.yml](backward-compat.yml) | Check backward compatibility for run.yaml configs |
+| Backward Compatibility Check | [backward-compat.yml](backward-compat.yml) | Check backward compatibility for config.yaml files |
 | API Conformance Tests | [conformance.yml](conformance.yml) | Run the API Conformance test suite on the changes. |
 | Installer CI | [install-script-ci.yml](install-script-ci.yml) | Test the installation script |
 | Integration Auth Tests | [integration-auth-tests.yml](integration-auth-tests.yml) | Run the integration test suite with Kubernetes authentication |

.github/workflows/backward-compat.yml

@@ -1,6 +1,6 @@
 name: Backward Compatibility Check
 
-run-name: Check backward compatibility for run.yaml configs
+run-name: Check backward compatibility for config.yaml files
 
 on:
   pull_request:
@@ -12,7 +12,7 @@ on:
     paths:
       - 'src/llama_stack/core/datatypes.py'
       - 'src/llama_stack/providers/datatypes.py'
-      - 'src/llama_stack/distributions/**/run.yaml'
+      - 'src/llama_stack/distributions/**/config.yaml'
       - 'tests/backward_compat/**'
       - '.github/workflows/backward-compat.yml'
 
@@ -45,15 +45,15 @@ jobs:
         run: |
           uv sync --group dev
 
-      - name: Extract run.yaml files from main branch
+      - name: Extract config.yaml files from main branch
         id: extract_configs
         run: |
-          # Get list of run.yaml paths from main
+          # Get list of config.yaml paths from main
           git fetch origin main
-          CONFIG_PATHS=$(git ls-tree -r --name-only origin/main | grep "src/llama_stack/distributions/.*/run.yaml$" || true)
+          CONFIG_PATHS=$(git ls-tree -r --name-only origin/main | grep "src/llama_stack/distributions/.*/config.yaml$" || true)
 
           if [ -z "$CONFIG_PATHS" ]; then
-            echo "No run.yaml files found in main branch"
+            echo "No config.yaml files found in main branch"
             exit 1
           fi
 
@@ -125,7 +125,7 @@ jobs:
               echo ""
               echo "⚠️  WARNING: Breaking changes detected but acknowledged"
               echo ""
-              echo "This PR introduces backward-incompatible changes to run.yaml."
+              echo "This PR introduces backward-incompatible changes to config.yaml."
               echo "The changes have been properly acknowledged."
               echo ""
               exit 0  # Pass the check
@@ -133,7 +133,7 @@ jobs:
               echo ""
               echo "❌ ERROR: Breaking changes detected without acknowledgment"
               echo ""
-              echo "This PR introduces backward-incompatible changes to run.yaml"
+              echo "This PR introduces backward-incompatible changes to config.yaml"
               echo "that will break existing user configurations."
               echo ""
               echo "To acknowledge this breaking change, do ONE of:"
@@ -155,11 +155,11 @@ jobs:
         with:
           fetch-depth: 0
 
-      - name: Extract ci-tests run.yaml from main
+      - name: Extract ci-tests config.yaml from main
         run: |
           git fetch origin main
-          git show origin/main:src/llama_stack/distributions/ci-tests/run.yaml > /tmp/main-ci-tests-run.yaml
-          echo "Extracted ci-tests run.yaml from main branch"
+          git show origin/main:src/llama_stack/distributions/ci-tests/config.yaml > /tmp/main-ci-tests-config.yaml
+          echo "Extracted ci-tests config.yaml from main branch"
 
       - name: Setup test environment
         uses: ./.github/actions/setup-test-environment
@@ -175,7 +175,7 @@ jobs:
         continue-on-error: true
         uses: ./.github/actions/run-and-record-tests
         with:
-          stack-config: /tmp/main-ci-tests-run.yaml
+          stack-config: /tmp/main-ci-tests-config.yaml
           setup: 'ollama'
           inference-mode: 'replay'
           suite: 'base'
@@ -258,21 +258,21 @@ jobs:
         env:
           GH_TOKEN: ${{ github.token }}
 
-      - name: Extract ci-tests run.yaml from release
+      - name: Extract ci-tests config.yaml from release
         if: steps.get_release.outputs.has_release == 'true'
         id: extract_config
         run: |
           RELEASE_TAG="${{ steps.get_release.outputs.tag }}"
 
           # Try with src/ prefix first (newer releases), then without (older releases)
-          if git show "$RELEASE_TAG:src/llama_stack/distributions/ci-tests/run.yaml" > /tmp/release-ci-tests-run.yaml 2>/dev/null; then
-            echo "Extracted ci-tests run.yaml from release $RELEASE_TAG (src/ path)"
+          if git show "$RELEASE_TAG:src/llama_stack/distributions/ci-tests/config.yaml" > /tmp/release-ci-tests-config.yaml 2>/dev/null; then
+            echo "Extracted ci-tests config.yaml from release $RELEASE_TAG (src/ path)"
             echo "has_config=true" >> $GITHUB_OUTPUT
-          elif git show "$RELEASE_TAG:llama_stack/distributions/ci-tests/run.yaml" > /tmp/release-ci-tests-run.yaml 2>/dev/null; then
-            echo "Extracted ci-tests run.yaml from release $RELEASE_TAG (old path)"
+          elif git show "$RELEASE_TAG:llama_stack/distributions/ci-tests/config.yaml" > /tmp/release-ci-tests-config.yaml 2>/dev/null; then
+            echo "Extracted ci-tests config.yaml from release $RELEASE_TAG (old path)"
             echo "has_config=true" >> $GITHUB_OUTPUT
           else
-            echo "::warning::ci-tests/run.yaml not found in release $RELEASE_TAG"
+            echo "::warning::ci-tests/config.yaml not found in release $RELEASE_TAG"
             echo "has_config=false" >> $GITHUB_OUTPUT
           fi
 
@@ -292,7 +292,7 @@ jobs:
         continue-on-error: true
         uses: ./.github/actions/run-and-record-tests
         with:
-          stack-config: /tmp/release-ci-tests-run.yaml
+          stack-config: /tmp/release-ci-tests-config.yaml
           setup: 'ollama'
           inference-mode: 'replay'
           suite: 'base'
@@ -318,7 +318,7 @@ jobs:
         continue-on-error: true
         uses: ./.github/actions/run-and-record-tests
         with:
-          stack-config: /tmp/release-ci-tests-run.yaml
+          stack-config: /tmp/release-ci-tests-config.yaml
           setup: 'ollama'
           inference-mode: 'replay'
           suite: 'base'
@@ -447,11 +447,11 @@ jobs:
         run: |
           RELEASE_TAG="${{ steps.get_release.outputs.tag }}"
 
-          # Get run.yaml files from the release (try both src/ and old path)
-          CONFIG_PATHS=$(git ls-tree -r --name-only "$RELEASE_TAG" | grep "llama_stack/distributions/.*/run.yaml$" || true)
+          # Get config.yaml files from the release (try both src/ and old path)
+          CONFIG_PATHS=$(git ls-tree -r --name-only "$RELEASE_TAG" | grep "llama_stack/distributions/.*/config.yaml$" || true)
 
           if [ -z "$CONFIG_PATHS" ]; then
-            echo "::warning::No run.yaml files found in release $RELEASE_TAG"
+            echo "::warning::No config.yaml files found in release $RELEASE_TAG"
             echo "has_configs=false" >> $GITHUB_OUTPUT
             exit 0
           fi
@@ -523,7 +523,7 @@ jobs:
           ⚠️  This PR introduces a schema breaking change that affects compatibility with the latest release.
 
           - Users on release \`$RELEASE_TAG\` will not be able to upgrade
-          - Existing run.yaml configurations will fail validation
+          - Existing config.yaml configurations will fail validation
 
           The tests pass on \`main\` but fail with this PR's changes.
 
@@ -543,7 +543,7 @@ jobs:
           - Tests **PASS** on main branch ✅
           - Tests **FAIL** on PR branch ❌
           - Users on release \`$RELEASE_TAG\` will not be able to upgrade
-          - Existing run.yaml configurations will fail validation
+          - Existing config.yaml configurations will fail validation
 
           > **Note:** This is informational only and does not block merge.
           > Consider whether this breaking change is acceptable for users.
@@ -570,7 +570,7 @@ jobs:
             cat >> $GITHUB_STEP_SUMMARY <<EOF
           ## ✅ Release Schema Compatibility Passed
 
-          All run.yaml configs from release \`$RELEASE_TAG\` are compatible.
+          All config.yaml configs from release \`$RELEASE_TAG\` are compatible.
           This PR maintains backward compatibility with the latest release.
           EOF
           fi

.github/workflows/integration-auth-tests.yml

@@ -72,7 +72,7 @@ jobs:
         if: ${{ matrix.auth-provider == 'oauth2_token' }}
         run: |
           run_dir=$(mktemp -d)
-          cat <<EOF > $run_dir/run.yaml
+          cat <<EOF > $run_dir/config.yaml
           version: '2'
           image_name: kube
           apis: []
@@ -101,17 +101,17 @@ jobs:
           server:
             port: 8321
           EOF
-          yq eval '.server.auth.provider_config.type = "${{ matrix.auth-provider }}"' -i $run_dir/run.yaml
-          yq eval '.server.auth.provider_config.tls_cafile = "${{ env.KUBERNETES_CA_CERT_PATH }}"' -i $run_dir/run.yaml
-          yq eval '.server.auth.provider_config.issuer = "${{ env.KUBERNETES_ISSUER }}"' -i $run_dir/run.yaml
-          yq eval '.server.auth.provider_config.audience = "${{ env.KUBERNETES_AUDIENCE }}"' -i $run_dir/run.yaml
-          yq eval '.server.auth.provider_config.jwks.uri = "${{ env.KUBERNETES_API_SERVER_URL }}"' -i $run_dir/run.yaml
-          yq eval '.server.auth.provider_config.jwks.token = "${{ env.TOKEN }}"' -i $run_dir/run.yaml
-          cat $run_dir/run.yaml
+          yq eval '.server.auth.provider_config.type = "${{ matrix.auth-provider }}"' -i $run_dir/config.yaml
+          yq eval '.server.auth.provider_config.tls_cafile = "${{ env.KUBERNETES_CA_CERT_PATH }}"' -i $run_dir/config.yaml
+          yq eval '.server.auth.provider_config.issuer = "${{ env.KUBERNETES_ISSUER }}"' -i $run_dir/config.yaml
+          yq eval '.server.auth.provider_config.audience = "${{ env.KUBERNETES_AUDIENCE }}"' -i $run_dir/config.yaml
+          yq eval '.server.auth.provider_config.jwks.uri = "${{ env.KUBERNETES_API_SERVER_URL }}"' -i $run_dir/config.yaml
+          yq eval '.server.auth.provider_config.jwks.token = "${{ env.TOKEN }}"' -i $run_dir/config.yaml
+          cat $run_dir/config.yaml
 
           # avoid line breaks in the server log, especially because we grep it below.
           export LLAMA_STACK_LOG_WIDTH=200
-          nohup uv run llama stack run $run_dir/run.yaml > server.log 2>&1 &
+          nohup uv run llama stack run $run_dir/config.yaml > server.log 2>&1 &
 
       - name: Wait for Llama Stack server to be ready
         run: |

.github/workflows/providers-build.yml

@@ -113,10 +113,10 @@ jobs:
 
       - name: Build container image
         run: |
-          BASE_IMAGE=$(yq -r '.distribution_spec.container_image // "python:3.12-slim"' src/llama_stack/distributions/ci-tests/build.yaml)
+          BASE_IMAGE=$(yq -r '.distribution_spec.container_image // "python:3.12-slim"' src/llama_stack/distributions/ci-tests/config.yaml)
           BUILD_ARGS="--build-arg INSTALL_MODE=editable --build-arg DISTRO_NAME=ci-tests"
           BUILD_ARGS="$BUILD_ARGS --build-arg BASE_IMAGE=$BASE_IMAGE"
-          BUILD_ARGS="$BUILD_ARGS --build-arg RUN_CONFIG_PATH=/workspace/src/llama_stack/distributions/ci-tests/run.yaml"
+          BUILD_ARGS="$BUILD_ARGS --build-arg RUN_CONFIG_PATH=/workspace/src/llama_stack/distributions/ci-tests/config.yaml"
           if [ -n "${UV_EXTRA_INDEX_URL:-}" ]; then
             BUILD_ARGS="$BUILD_ARGS --build-arg UV_EXTRA_INDEX_URL=$UV_EXTRA_INDEX_URL"
           fi
@@ -155,14 +155,14 @@ jobs:
         run: |
           yq -i '
             .distribution_spec.container_image = "registry.access.redhat.com/ubi9:latest"
-          ' src/llama_stack/distributions/ci-tests/build.yaml
+          ' src/llama_stack/distributions/ci-tests/config.yaml
 
       - name: Build UBI9 container image
         run: |
-          BASE_IMAGE=$(yq -r '.distribution_spec.container_image // "registry.access.redhat.com/ubi9:latest"' src/llama_stack/distributions/ci-tests/build.yaml)
+          BASE_IMAGE=$(yq -r '.distribution_spec.container_image // "registry.access.redhat.com/ubi9:latest"' src/llama_stack/distributions/ci-tests/config.yaml)
           BUILD_ARGS="--build-arg INSTALL_MODE=editable --build-arg DISTRO_NAME=ci-tests"
           BUILD_ARGS="$BUILD_ARGS --build-arg BASE_IMAGE=$BASE_IMAGE"
-          BUILD_ARGS="$BUILD_ARGS --build-arg RUN_CONFIG_PATH=/workspace/src/llama_stack/distributions/ci-tests/run.yaml"
+          BUILD_ARGS="$BUILD_ARGS --build-arg RUN_CONFIG_PATH=/workspace/src/llama_stack/distributions/ci-tests/config.yaml"
           if [ -n "${UV_EXTRA_INDEX_URL:-}" ]; then
             BUILD_ARGS="$BUILD_ARGS --build-arg UV_EXTRA_INDEX_URL=$UV_EXTRA_INDEX_URL"
           fi

.github/workflows/providers-list-deps.yml

@@ -102,4 +102,4 @@ jobs:
           USE_COPY_NOT_MOUNT: "true"
           LLAMA_STACK_DIR: "."
         run: |
-          uv run llama stack list-deps src/llama_stack/distributions/ci-tests/build.yaml
+          uv run llama stack list-deps src/llama_stack/distributions/ci-tests/config.yaml

.github/workflows/test-external-provider-module.yml

@@ -43,8 +43,8 @@ jobs:
           nohup ramalama serve llama3.2:3b-instruct-fp16  > ramalama_server.log 2>&1 &
       - name: Apply image type to config file
         run: |
-          yq -i '.image_type = "${{ matrix.image-type }}"' tests/external/ramalama-stack/run.yaml
-          cat tests/external/ramalama-stack/run.yaml
+          yq -i '.image_type = "${{ matrix.image-type }}"' tests/external/ramalama-stack/config.yaml
+          cat tests/external/ramalama-stack/config.yaml
 
       - name: Install distribution dependencies
         run: |
@@ -59,7 +59,7 @@ jobs:
           # Use the virtual environment created by the build step (name comes from build config)
           source ramalama-stack-test/bin/activate
           uv pip list
-          nohup llama stack run tests/external/ramalama-stack/run.yaml > server.log 2>&1 &
+          nohup llama stack run tests/external/ramalama-stack/config.yaml > server.log 2>&1 &
 
       - name: Wait for Llama Stack server to be ready
         run: |

.github/workflows/test-external.yml

@@ -44,14 +44,14 @@ jobs:
 
       - name: Print distro dependencies
         run: |
-          uv run --no-sync llama stack list-deps tests/external/build.yaml
+          uv run --no-sync llama stack list-deps tests/external/config.yaml
 
       - name: Build distro from config file
         run: |
           uv venv ci-test
           source ci-test/bin/activate
           uv pip install -e .
-          LLAMA_STACK_LOGGING=all=CRITICAL llama stack list-deps tests/external/build.yaml | xargs -L1 uv pip install
+          LLAMA_STACK_LOGGING=all=CRITICAL llama stack list-deps tests/external/config.yaml | xargs -L1 uv pip install
 
       - name: Start Llama Stack server in background
         if: ${{ matrix.image-type }} == 'venv'
@@ -62,7 +62,7 @@ jobs:
           # Use the virtual environment created by the build step (name comes from build config)
           source ci-test/bin/activate
           uv pip list
-          nohup llama stack run tests/external/run-byoa.yaml > server.log 2>&1 &
+          nohup llama stack run tests/external/config.yaml > server.log 2>&1 &
 
       - name: Wait for Llama Stack server to be ready
         run: |