Rename sdk_v2/ to sdk/ and sdk/ to sdk_legacy/ (#532)

- Rename sdk_v2/ -> sdk/ (the current/active SDK)
- Rename sdk/ -> sdk_legacy/ (the legacy SDK)
- Update all cross-references in GitHub Actions workflows, docs,
samples, and tests
- Rename workflow from 'SDK V2 Build' to 'SDK Build'
- Update path triggers from sdk_v2/** to sdk/**

Author: MaanavD

.github/workflows/build-cs-steps.yml

@@ -45,13 +45,13 @@ jobs:
       # /p:FoundryLocalCoreVersion="*-*" to always use nightly version of Foundry Local Core
       - name: Restore dependencies
         run: |
-          # dotnet restore sdk_v2/cs/src/Microsoft.AI.Foundry.Local.csproj /p:UseWinML=${{ inputs.useWinML }} /p:FoundryLocalCoreVersion="*-*" --configfile sdk_v2/cs/NuGet.config
-          dotnet restore sdk_v2/cs/src/Microsoft.AI.Foundry.Local.csproj /p:UseWinML=${{ inputs.useWinML }} --configfile sdk_v2/cs/NuGet.config
+          # dotnet restore sdk/cs/src/Microsoft.AI.Foundry.Local.csproj /p:UseWinML=${{ inputs.useWinML }} /p:FoundryLocalCoreVersion="*-*" --configfile sdk/cs/NuGet.config
+          dotnet restore sdk/cs/src/Microsoft.AI.Foundry.Local.csproj /p:UseWinML=${{ inputs.useWinML }} --configfile sdk/cs/NuGet.config
 
       - name: Build solution
         run: |
-          # dotnet build sdk_v2/cs/src/Microsoft.AI.Foundry.Local.csproj --no-restore --configuration ${{ inputs.buildConfiguration }} /p:UseWinML=${{ inputs.useWinML }} /p:FoundryLocalCoreVersion="*-*"
-          dotnet build sdk_v2/cs/src/Microsoft.AI.Foundry.Local.csproj --no-restore --configuration ${{ inputs.buildConfiguration }} /p:UseWinML=${{ inputs.useWinML }}
+          # dotnet build sdk/cs/src/Microsoft.AI.Foundry.Local.csproj --no-restore --configuration ${{ inputs.buildConfiguration }} /p:UseWinML=${{ inputs.useWinML }} /p:FoundryLocalCoreVersion="*-*"
+          dotnet build sdk/cs/src/Microsoft.AI.Foundry.Local.csproj --no-restore --configuration ${{ inputs.buildConfiguration }} /p:UseWinML=${{ inputs.useWinML }}
 
       # need to use direct git commands to clone from Azure DevOps instead of actions/checkout
       - name: Checkout test-data-shared from Azure DevOps
@@ -85,14 +85,14 @@ jobs:
 
       - name: Run Foundry Local Core tests
         run: |
-          # dotnet test sdk_v2/cs/test/FoundryLocal.Tests/Microsoft.AI.Foundry.Local.Tests.csproj --verbosity normal /p:UseWinML=${{ inputs.useWinML }} /p:FoundryLocalCoreVersion="*-*"
-          dotnet test sdk_v2/cs/test/FoundryLocal.Tests/Microsoft.AI.Foundry.Local.Tests.csproj --verbosity normal /p:UseWinML=${{ inputs.useWinML }}
+          # dotnet test sdk/cs/test/FoundryLocal.Tests/Microsoft.AI.Foundry.Local.Tests.csproj --verbosity normal /p:UseWinML=${{ inputs.useWinML }} /p:FoundryLocalCoreVersion="*-*"
+          dotnet test sdk/cs/test/FoundryLocal.Tests/Microsoft.AI.Foundry.Local.Tests.csproj --verbosity normal /p:UseWinML=${{ inputs.useWinML }}
 
       - name: Pack NuGet package
         shell: pwsh
         run: |
-          $projectPath = "sdk_v2/cs/src/Microsoft.AI.Foundry.Local.csproj"
-          $outputDir = "sdk_v2/cs/bin"
+          $projectPath = "sdk/cs/src/Microsoft.AI.Foundry.Local.csproj"
+          $outputDir = "sdk/cs/bin"
           $version = "${{ inputs.version }}"
           $config = "${{ inputs.buildConfiguration }}"
           $useWinML = "${{ inputs.useWinML }}"
@@ -128,11 +128,11 @@ jobs:
         with:
           name: cs-sdk-${{ inputs.platform }}${{ inputs.useWinML == true && '-winml' || '' }}
           path: |
-            sdk_v2/cs/bin/*.nupkg
-            sdk_v2/cs/bin/*.snupkg
+            sdk/cs/bin/*.nupkg
+            sdk/cs/bin/*.snupkg
 
       - name: Upload flcore logs
         uses: actions/upload-artifact@v4
         with:
           name: cs-sdk-${{ inputs.platform }}${{ inputs.useWinML == true && '-winml' || '' }}-logs
-          path: sdk_v2/cs/logs/**
+          path: sdk/cs/logs/**

.github/workflows/build-js-steps.yml

@@ -87,39 +87,39 @@ jobs:
 
       - name: npm install (WinML)
         if: ${{ inputs.useWinML == true }}
-        working-directory: sdk_v2/js
+        working-directory: sdk/js
         run: npm install --winml
 
       - name: npm install (Standard)
         if: ${{ inputs.useWinML == false }}
-        working-directory: sdk_v2/js
+        working-directory: sdk/js
         run: npm install
 
       # Verify that installing new packages doesn't strip custom native binary folders
       - name: npm install openai (verify persistence)
-        working-directory: sdk_v2/js
+        working-directory: sdk/js
         run: npm install openai
 
       - name: Set package version
-        working-directory: sdk_v2/js
+        working-directory: sdk/js
         run: npm version ${{ env.ProjectVersion }} --no-git-tag-version --allow-same-version
 
       - name: Run tests
-        working-directory: sdk_v2/js
+        working-directory: sdk/js
         run: npm test
 
       - name: Build package
-        working-directory: sdk_v2/js
+        working-directory: sdk/js
         run: npm run build
 
       - name: Pack npm package
-        working-directory: sdk_v2/js
+        working-directory: sdk/js
         run: npm pack
 
       - name: Rename WinML artifact
         if: ${{ inputs.useWinML == true }}
         shell: pwsh
-        working-directory: sdk_v2/js
+        working-directory: sdk/js
         run: |
           $tgz = Get-ChildItem *.tgz | Select-Object -First 1
           if ($tgz) {
@@ -132,10 +132,10 @@ jobs:
         uses: actions/upload-artifact@v4
         with:
           name: js-sdk-${{ inputs.platform }}${{ inputs.useWinML == true && '-winml' || '' }}
-          path: sdk_v2/js/*.tgz
+          path: sdk/js/*.tgz
 
       - name: Upload flcore logs
         uses: actions/upload-artifact@v4
         with:
           name: js-sdk-${{ inputs.platform }}${{ inputs.useWinML == true && '-winml' || '' }}-logs
-          path: sdk_v2/js/logs/**
+          path: sdk/js/logs/**

.github/workflows/build-rust-steps.yml

@@ -25,7 +25,7 @@ jobs:
 
     defaults:
       run:
-        working-directory: sdk_v2/rust
+        working-directory: sdk/rust
 
     env:
       CARGO_FEATURES: ${{ inputs.useWinML && '--features winml' || '' }}
@@ -44,7 +44,7 @@ jobs:
       - name: Cache cargo dependencies
         uses: Swatinem/rust-cache@v2
         with:
-          workspaces: sdk_v2/rust -> target
+          workspaces: sdk/rust -> target
 
       - name: Checkout test-data-shared from Azure DevOps
         if: ${{ inputs.run-integration-tests }}
@@ -102,11 +102,11 @@ jobs:
         uses: actions/upload-artifact@v4
         with:
           name: rust-sdk-${{ inputs.platform }}${{ inputs.useWinML == true && '-winml' || '' }}
-          path: sdk_v2/rust/target/package/*.crate
+          path: sdk/rust/target/package/*.crate
 
       - name: Upload flcore logs
         uses: actions/upload-artifact@v4
         if: always()
         with:
           name: rust-sdk-${{ inputs.platform }}${{ inputs.useWinML == true && '-winml' || '' }}-logs
-          path: sdk_v2/rust/logs/**
+          path: sdk/rust/logs/**

.github/workflows/foundry-local-sdk-build.yml

@@ -1,13 +1,13 @@
-name: SDK V2 Build
+name: SDK Build
 
 on:
   pull_request:
     paths:
-      - 'sdk_v2/**'
+      - 'sdk/**'
       - '.github/workflows/**'
   push:
     paths:
-      - 'sdk_v2/**'
+      - 'sdk/**'
       - '.github/workflows/**'
     branches:
       - main

docs/README.md

@@ -4,8 +4,8 @@ Documentation for Foundry Local can be found in the following resources:
 
 - [Microsoft Learn](https://learn.microsoft.com/azure/foundry-local/): This is the official documentation for Foundry Local, providing comprehensive guides, tutorials, and reference materials to help you get started and make the most of Foundry Local.
 - SDK Reference:
-    - [C# SDK Reference](../sdk_v2/cs/README.md): This documentation provides detailed information about the C# SDK for Foundry Local, including API references, usage examples, and best practices for integrating Foundry Local into your applications.
-    - [JavaScript SDK Reference](../sdk_v2/js/README.md): This documentation offers detailed information about the JavaScript SDK for Foundry Local, including API references, usage examples, and best practices for integrating Foundry Local into your web applications.
+    - [C# SDK Reference](../sdk/cs/README.md): This documentation provides detailed information about the C# SDK for Foundry Local, including API references, usage examples, and best practices for integrating Foundry Local into your applications.
+    - [JavaScript SDK Reference](../sdk/js/README.md): This documentation offers detailed information about the JavaScript SDK for Foundry Local, including API references, usage examples, and best practices for integrating Foundry Local into your web applications.
 - [Foundry Local Lab](https://github.com/Microsoft-foundry/foundry-local-lab): This GitHub repository contains a lab designed to help you learn how to use Foundry Local effectively. It includes hands-on exercises, sample code, and step-by-step instructions to guide you through the process of setting up and using Foundry Local in various scenarios.
 
 ## Supported Capabilities

samples/rust/audio-transcription-example/Cargo.toml

@@ -5,6 +5,6 @@ edition = "2021"
 description = "Audio transcription example using the Foundry Local Rust SDK"
 
 [dependencies]
-foundry-local-sdk = { path = "../../../sdk_v2/rust" }
+foundry-local-sdk = { path = "../../../sdk/rust" }
 tokio = { version = "1", features = ["rt-multi-thread", "macros"] }
 tokio-stream = "0.1"

samples/rust/audio-transcription-example/README.md

@@ -5,7 +5,7 @@ This example demonstrates audio transcription (non-streaming and streaming) usin
 The `foundry-local-sdk` dependency is referenced via a local path. No crates.io publish is required:
 
 ```toml
-foundry-local-sdk = { path = "../../../sdk_v2/rust" }
+foundry-local-sdk = { path = "../../../sdk/rust" }
 ```
 
 Run the application with a path to a WAV file:
@@ -19,7 +19,7 @@ cargo run -- path/to/audio.wav
 To use the WinML backend, enable the `winml` feature in `Cargo.toml`:
 
 ```toml
-foundry-local-sdk = { path = "../../../sdk_v2/rust", features = ["winml"] }
+foundry-local-sdk = { path = "../../../sdk/rust", features = ["winml"] }
 ```
 
 No code changes are needed — same API, different backend.

samples/rust/foundry-local-webserver/Cargo.toml

@@ -5,7 +5,7 @@ edition = "2021"
 description = "Example of using the Foundry Local SDK with a local OpenAI-compatible web server"
 
 [dependencies]
-foundry-local-sdk = { path = "../../../sdk_v2/rust" }
+foundry-local-sdk = { path = "../../../sdk/rust" }
 tokio = { version = "1", features = ["rt-multi-thread", "macros"] }
 serde_json = "1"
 reqwest = { version = "0.12", features = ["json"] }

samples/rust/foundry-local-webserver/README.md

@@ -5,7 +5,7 @@ This example demonstrates how to start a local OpenAI-compatible web server usin
 The `foundry-local-sdk` dependency is referenced via a local path. No crates.io publish is required:
 
 ```toml
-foundry-local-sdk = { path = "../../../sdk_v2/rust" }
+foundry-local-sdk = { path = "../../../sdk/rust" }
 ```
 
 Run the application:
@@ -19,7 +19,7 @@ cargo run
 To use the WinML backend, enable the `winml` feature in `Cargo.toml`:
 
 ```toml
-foundry-local-sdk = { path = "../../../sdk_v2/rust", features = ["winml"] }
+foundry-local-sdk = { path = "../../../sdk/rust", features = ["winml"] }
 ```
 
 No code changes are needed — same API, different backend.

samples/rust/native-chat-completions/Cargo.toml

@@ -5,6 +5,6 @@ edition = "2021"
 description = "Native SDK chat completions (non-streaming and streaming) using the Foundry Local Rust SDK"
 
 [dependencies]
-foundry-local-sdk = { path = "../../../sdk_v2/rust" }
+foundry-local-sdk = { path = "../../../sdk/rust" }
 tokio = { version = "1", features = ["rt-multi-thread", "macros"] }
 tokio-stream = "0.1"