Remove trailing space

* feat(python): add Mistral chat client

Implements native Mistral support (#7366) with streaming, tool calling,
and structured output. Talks to the REST API directly over httpx: the
mistralai SDK's pinned OpenTelemetry deps conflict with the workspace.

* refactor(python): simplify Mistral client per review

Drop the streamed tool-call accumulator and multi-choice parsing in
favor of the framework's built-in fragment merging, mark n unsupported,
omit unset strict from json_schema, and leave CI secret wiring to
maintainers.

* test(python): drop n forwarding assertion

n is typed as unsupported on MistralChatOptions; the option-mapping test
still passed n, failing pyrefly/ty/zuban/mypy in CI.

* refactor(python): drop n from MistralChatOptions

n is not part of the base ChatOptions, so removing the key rejects it
without an explicit None override.

* feat(python): mark Mistral feature usage

Both clients flip the shared FeatureIndex.MISTRAL bit before each
request, matching the feature-usage telemetry other providers emit.

* fix(python): key streamed tool calls by index

Mistral omits the tool call id on continuation fragments, and the
framework only coalesces empty-id fragments into the immediately
preceding call, so interleaved parallel calls merged into the wrong
call with corrupted arguments. Accumulate fragments per (choice,
index) and emit each call only once complete.

* fix(python): restore Mistral SDK client injection

Dropping the mistralai dependency turned the embedding client's
client= parameter into a breaking change for injected SDK clients.
Add http_client= for httpx.AsyncClient and keep client= working:
httpx goes to the REST path, a duck-typed mistralai.Mistral goes
through the legacy SDK path with a DeprecationWarning until the
next major release.

* chore(python): tidy Mistral sample header

.github/.linkspector.yml

@@ -2,6 +2,7 @@ dirs:
   - .
 excludedFiles:
   - ./python/CHANGELOG.md
+  - "**/SKILL.md"
 ignorePatterns:
   - pattern: "/github/"
   - pattern: "./actions"
@@ -26,7 +27,7 @@ ignorePatterns:
   - pattern: "https:\/\/dotnet.microsoft.com"
   - pattern: "https://github.com/Rel1cx/eslint-react"
 # excludedDirs:
-  # Folders which include links to localhost, since it's not ignored with regular expressions
+# Folders which include links to localhost, since it's not ignored with regular expressions
 baseUrl: https://github.com/microsoft/agent-framework/
 aliveStatusCodes:
   - 200

.github/CODEOWNERS

@@ -1,7 +1,5 @@
 # Code ownership assignments
 # https://docs.github.com/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
 
-python/packages/azurefunctions/ @microsoft/agentframework-durabletask-developers
-python/packages/durabletask/ @microsoft/agentframework-durabletask-developers
 python/samples/getting_started/azure_functions/ @microsoft/agentframework-durabletask-developers
 python/samples/getting_started/durabletask/ @microsoft/agentframework-durabletask-developers

.github/actions/azure-functions-integration-setup/action.yml

@@ -1,48 +0,0 @@
-name: Azure Functions Integration Test Setup
-description: Prepare local emulators and tools for Azure Functions integration tests
-
-runs:
-    using: "composite"
-    steps:
-      - name: Start Durable Task Scheduler Emulator
-        shell: bash
-        run: |
-          if [ "$(docker ps -aq -f name=dts-emulator)" ]; then
-            echo "Stopping and removing existing Durable Task Scheduler Emulator"
-            docker rm -f dts-emulator
-          fi
-          echo "Starting Durable Task Scheduler Emulator"
-          docker run -d --name dts-emulator -p 8080:8080 -p 8082:8082 -e DTS_USE_DYNAMIC_TASK_HUBS=true mcr.microsoft.com/dts/dts-emulator:latest
-          echo "Waiting for Durable Task Scheduler Emulator to be ready"
-          timeout 30 bash -c 'until curl --silent http://localhost:8080/healthz; do sleep 1; done'
-          echo "Durable Task Scheduler Emulator is ready"
-      - name: Start Azurite (Azure Storage emulator)
-        shell: bash
-        run: |
-          if [ "$(docker ps -aq -f name=azurite)" ]; then
-            echo "Stopping and removing existing Azurite (Azure Storage emulator)"
-            docker rm -f azurite
-          fi
-          echo "Starting Azurite (Azure Storage emulator)"
-          docker run -d --name azurite -p 10000:10000 -p 10001:10001 -p 10002:10002 mcr.microsoft.com/azure-storage/azurite
-          echo "Waiting for Azurite (Azure Storage emulator) to be ready"
-          timeout 30 bash -c 'until curl --silent http://localhost:10000/devstoreaccount1; do sleep 1; done'
-          echo "Azurite (Azure Storage emulator) is ready"
-      - name: Start Redis
-        shell: bash
-        run: |
-          if [ "$(docker ps -aq -f name=redis)" ]; then
-            echo "Stopping and removing existing Redis"
-            docker rm -f redis
-          fi
-          echo "Starting Redis"
-          docker run -d --name redis -p 6379:6379 redis:latest
-          echo "Waiting for Redis to be ready"
-          timeout 30 bash -c 'until docker exec redis redis-cli ping | grep -q PONG; do sleep 1; done'
-          echo "Redis is ready"
-      - name: Install Azure Functions Core Tools
-        shell: bash
-        run: |
-          echo "Installing Azure Functions Core Tools"
-          npm install -g azure-functions-core-tools@4 --unsafe-perm true
-          func --version

.github/actions/sample-validation-save-playbooks/action.yml

@@ -0,0 +1,19 @@
+name: Save Sample Playbooks
+description: >
+  Save the cached sample-validation playbooks. Split out from
+  sample-validation-setup (which only restores) so the save runs even when the
+  validation step fails. Combining restore+save via actions/cache would skip the
+  save on a failing job (post-if: success()), so freshly authored playbooks for
+  samples that failed validation would never persist. Invoke this with
+  'if: not-cancelled' after the validation step in each job.
+
+runs:
+  using: "composite"
+  steps:
+    - name: Save sample playbooks cache
+      uses: actions/cache/save@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+      with:
+        # Must match the restore path/key in sample-validation-setup/action.yml and the
+        # sample_validation --playbooks-dir default (samples/sample_validation/playbooks).
+        path: python/samples/sample_validation/playbooks/
+        key: sample-playbooks-${{ github.job }}-${{ github.run_id }}

.github/actions/sample-validation-setup/action.yml

@@ -36,15 +36,31 @@ runs:
       shell: bash
       run: copilot --version && copilot -p "What can you do in one sentence?"
 
+    - name: Set up python and install the project
+      uses: ./.github/actions/python-setup
+      with:
+        python-version: ${{ inputs.python-version }}
+        os: ${{ inputs.os }}
+
+    - name: Restore sample playbooks
+      # Restore-only. The matching save is a separate step in each job that runs with
+      # `if: ${{ !cancelled() }}` (see .github/actions/sample-validation-save-playbooks).
+      # A combined actions/cache would skip its post-job save on a failing job
+      # (post-if: success()), so playbooks authored for samples that failed validation
+      # would never persist. Keyed per job so each validate-* job keeps its own playbooks.
+      uses: actions/cache/restore@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+      with:
+        # Must match the sample_validation --playbooks-dir default, which resolves to
+        # samples/sample_validation/playbooks (see python/scripts/sample_validation/__main__.py).
+        # If a job overrides --playbooks-dir, update this path to match.
+        path: python/samples/sample_validation/playbooks/
+        key: sample-playbooks-${{ github.job }}-${{ github.run_id }}
+        restore-keys: |
+          sample-playbooks-${{ github.job }}-
+
     - name: Azure CLI Login
       uses: azure/login@a457da9ea143d694b1b9c7c869ebb04ebe844ef5 # v2
       with:
         client-id: ${{ inputs.azure-client-id }}
         tenant-id: ${{ inputs.azure-tenant-id }}
         subscription-id: ${{ inputs.azure-subscription-id }}
-
-    - name: Set up python and install the project
-      uses: ./.github/actions/python-setup
-      with:
-        python-version: ${{ inputs.python-version }}
-        os: ${{ inputs.os }}

.github/instructions/durabletask-dotnet.instructions.md

@@ -1,17 +0,0 @@
----
-applyTo: "dotnet/src/Microsoft.Agents.AI.DurableTask/**,dotnet/src/Microsoft.Agents.AI.Hosting.AzureFunctions/**"
----
-
-# Durable Task area code instructions
-
-The following guidelines apply to pull requests that modify files under
-`dotnet/src/Microsoft.Agents.AI.DurableTask/**` or
-`dotnet/src/Microsoft.Agents.AI.Hosting.AzureFunctions/**`:
-
-## CHANGELOG.md
-
-- Each pull request that modifies code should add just one bulleted entry to the `CHANGELOG.md` file containing a change title (usually the PR title) and a link to the PR itself.
-- New PRs should be added to the top of the `CHANGELOG.md` file under a "## [Unreleased]" heading.
-- If the PR is the first since the last release, the existing "## [Unreleased]" heading should be replaced with a "## v[X.Y.Z]" heading and the PRs since the last release should be added to the new "## [Unreleased]" heading.
-- The style of new `CHANGELOG.md` entries should match the style of the other entries in the file.
-- If the PR introduces a breaking change, the changelog entry should be prefixed with "[BREAKING]".

.github/workflows/dotnet-build-and-test.yml

@@ -38,7 +38,6 @@ jobs:
       dotnetChanges: ${{ steps.filter.outputs.dotnet }}
       cosmosDbChanges: ${{ steps.filter.outputs.cosmosdb }}
       foundryHostingChanges: ${{ steps.filter.outputs.foundryHosting }}
-      functionsChanged: ${{ steps.filter.outputs.functions }}
       coreChanged: ${{ steps.filter.outputs.core }}
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
@@ -66,13 +65,6 @@ jobs:
               - 'dotnet/Directory.Packages.props'
               - 'dotnet/tests/Foundry.Hosting.IntegrationTests/scripts/it-build-image.ps1'
               - '.github/workflows/dotnet-build-and-test.yml'
-            functions:
-              - 'dotnet/src/Microsoft.Agents.AI.DurableTask/**'
-              - 'dotnet/src/Microsoft.Agents.AI.Hosting.AzureFunctions/**'
-              - 'dotnet/tests/Microsoft.Agents.AI.DurableTask.IntegrationTests/**'
-              - 'dotnet/tests/Microsoft.Agents.AI.Hosting.AzureFunctions.IntegrationTests/**'
-              - '.github/actions/azure-functions-integration-setup/**'
-              - '.github/workflows/dotnet-build-and-test.yml'
             core:
               - 'dotnet/src/Microsoft.Agents.AI/**'
               - 'dotnet/src/Microsoft.Agents.AI.Abstractions/**'
@@ -242,7 +234,6 @@ jobs:
             -OutputPath dotnet/filtered-unit.slnx
           ./dotnet/eng/scripts/New-FilteredSolution.ps1 @commonArgs `
             -TestProjectNameIncludeFilter "*IntegrationTests*" `
-            -TestProjectNameExcludeFilter "*DurableTask.IntegrationTests*","*AzureFunctions.IntegrationTests*" `
             -OutputPath dotnet/filtered-integration.slnx
 
       - name: Run Unit Tests
@@ -440,113 +431,11 @@ jobs:
           AZURE_SEARCH_INDEX_NAME: ${{ secrets.AZURE_SEARCH_INDEX_NAME }}
           # IT_HOSTED_AGENT_IMAGE was exported into $GITHUB_ENV by the previous step.
 
-  # DurableTask and AzureFunctions integration tests (ubuntu/net10.0 only).
-  # Split from main dotnet-test job for path-based filtering and parallelism.
-  dotnet-test-functions:
-    needs: [paths-filter]
-    if: >
-      github.event_name != 'pull_request' &&
-      (needs.paths-filter.outputs.functionsChanged == 'true' ||
-       needs.paths-filter.outputs.coreChanged == 'true' ||
-       github.event_name == 'schedule' ||
-       github.event_name == 'workflow_dispatch')
-    runs-on: ubuntu-latest
-    environment: integration
-    steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-        with:
-          persist-credentials: false
-          sparse-checkout: |
-            .
-            .github
-            dotnet
-            python
-            declarative-agents
-
-      - name: Free runner disk space
-        uses: ./.github/actions/free-runner-disk-space
-
-      - name: Setup dotnet
-        uses: actions/setup-dotnet@c2fa09f4bde5ebb9d1777cf28262a3eb3db3ced7 # v5.2.0
-        with:
-          global-json-file: ${{ github.workspace }}/dotnet/global.json
-
-      - name: Build functions integration test projects
-        shell: bash
-        working-directory: dotnet
-        run: |
-          dotnet build ./tests/Microsoft.Agents.AI.DurableTask.IntegrationTests -c Release -f net10.0 --warnaserror
-          dotnet build ./tests/Microsoft.Agents.AI.Hosting.AzureFunctions.IntegrationTests -c Release -f net10.0 --warnaserror
-
-      - name: Azure CLI Login
-        uses: azure/login@a457da9ea143d694b1b9c7c869ebb04ebe844ef5 # v2
-        with:
-          client-id: ${{ secrets.AZURE_CLIENT_ID }}
-          tenant-id: ${{ secrets.AZURE_TENANT_ID }}
-          subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}
-
-      - name: Set up Durable Task and Azure Functions Integration Test Emulators
-        uses: ./.github/actions/azure-functions-integration-setup
-        id: azure-functions-setup
-
-      - name: Run Functions Integration Tests
-        shell: pwsh
-        working-directory: dotnet
-        run: |
-          # Run DurableTask integration tests
-          dotnet test `
-            --project ./tests/Microsoft.Agents.AI.DurableTask.IntegrationTests `
-            -f net10.0 `
-            -c Release `
-            --no-build -v Normal `
-            --report-xunit-trx `
-            --report-junit `
-            --results-directory ../IntegrationTestResults/ `
-            --ignore-exit-code 8 `
-            --filter-not-trait "Category=IntegrationDisabled" `
-            --parallel-algorithm aggressive `
-            --max-threads 2.0x
-
-          # Run AzureFunctions integration tests
-          dotnet test `
-            --project ./tests/Microsoft.Agents.AI.Hosting.AzureFunctions.IntegrationTests `
-            -f net10.0 `
-            -c Release `
-            --no-build -v Normal `
-            --report-xunit-trx `
-            --report-junit `
-            --results-directory ../IntegrationTestResults/ `
-            --ignore-exit-code 8 `
-            --filter-not-trait "Category=IntegrationDisabled" `
-            --parallel-algorithm aggressive `
-            --max-threads 2.0x
-        env:
-          # OpenAI Models
-          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-          OPENAI_CHAT_MODEL_NAME: ${{ vars.OPENAI_CHAT_MODEL_NAME }}
-          OPENAI_REASONING_MODEL_NAME: ${{ vars.OPENAI_REASONING_MODEL_NAME }}
-          # Azure OpenAI Models
-          AZURE_OPENAI_DEPLOYMENT_NAME: ${{ vars.AZURE_OPENAI_DEPLOYMENT_NAME }}
-          AZURE_OPENAI_CHAT_DEPLOYMENT_NAME: ${{ vars.AZURE_OPENAI_DEPLOYMENT_NAME }}
-          AZURE_OPENAI_ENDPOINT: ${{ vars.AZURE_OPENAI_ENDPOINT }}
-          # Microsoft Foundry
-          AZURE_AI_PROJECT_ENDPOINT: ${{ vars.AZURE_AI_PROJECT_ENDPOINT }}
-          AZURE_AI_MODEL_DEPLOYMENT_NAME: ${{ vars.AZURE_AI_MODEL_DEPLOYMENT_NAME }}
-          AZURE_AI_BING_CONNECTION_ID: ${{ vars.AZURE_AI_BING_CONNECTION_ID }}
-
-      - name: Upload functions test results
-        if: always()
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
-        with:
-          name: dotnet-test-results-functions-net10.0-ubuntu-latest
-          path: IntegrationTestResults/**/*.junit
-          if-no-files-found: ignore
-
   # This final job is required to satisfy the merge queue. It must only run (or succeed) if no tests failed
   dotnet-build-and-test-check:
     if: always()
     runs-on: ubuntu-latest
-    needs: [dotnet-build, dotnet-test, dotnet-foundry-hosted-it, dotnet-test-functions]
+    needs: [dotnet-build, dotnet-test, dotnet-foundry-hosted-it]
     steps:
       - name: Get Date
         shell: bash
@@ -593,7 +482,7 @@ jobs:
       github.event_name != 'pull_request' &&
       (contains(join(needs.*.result, ','), 'success') ||
        contains(join(needs.*.result, ','), 'failure'))
-    needs: [dotnet-test, dotnet-test-functions]
+    needs: [dotnet-test]
     runs-on: ubuntu-latest
     defaults:
       run:

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

@@ -83,10 +83,6 @@ jobs:
           tenant-id: ${{ secrets.AZURE_TENANT_ID }}
           subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}
 
-      - name: Set up Durable Task and Azure Functions Integration Test Emulators
-        if: matrix.os == 'ubuntu-latest'
-        uses: ./.github/actions/azure-functions-integration-setup
-
       - name: Run Integration Tests
         shell: bash
         run: |

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

@@ -232,11 +232,12 @@ jobs:
           fallback_url: ${{ env.LOCAL_MCP_URL }}
       - name: Prefer local MCP URL when available
         run: echo "LOCAL_MCP_URL=${{ steps.local-mcp.outputs.effective_url }}" >> "$GITHUB_ENV"
-      - name: Test with pytest (Anthropic, Hyperlight, Ollama, MCP integration)
+      - name: Test with pytest (Anthropic, Hyperlight, Mistral, Ollama, MCP integration)
         run: >
           uv run pytest --import-mode=importlib
           packages/anthropic/tests
           packages/hyperlight/tests
+          packages/mistral/tests
           packages/ollama/tests
           packages/core/tests/core/test_mcp.py
           packages/hosting-mcp/tests
@@ -273,73 +274,6 @@ jobs:
           done
           kill -KILL -- "-$server_pid" 2>/dev/null || kill -KILL "$server_pid" 2>/dev/null || true
 
-  # Azure Functions + Durable Task integration tests
-  python-tests-functions:
-    name: Python Integration Tests - Functions
-    permissions:
-      contents: read
-      id-token: write
-    runs-on: ubuntu-latest
-    environment: integration
-    timeout-minutes: 60
-    env:
-      UV_PYTHON: "3.11"
-      OPENAI_CHAT_COMPLETION_MODEL: ${{ vars.OPENAI__CHATMODELID }}
-      OPENAI_CHAT_MODEL: ${{ vars.OPENAI__RESPONSESMODELID }}
-      OPENAI_MODEL: ${{ vars.OPENAI__RESPONSESMODELID }}
-      OPENAI_EMBEDDING_MODEL: ${{ vars.OPENAI_EMBEDDING_MODEL_ID }}
-      OPENAI_API_KEY: ${{ secrets.OPENAI__APIKEY }}
-      AZURE_OPENAI_ENDPOINT: ${{ vars.AZUREOPENAI__ENDPOINT }}
-      AZURE_OPENAI_MODEL: ${{ vars.AZUREOPENAI__RESPONSESDEPLOYMENTNAME }}
-      AZURE_OPENAI_CHAT_MODEL: ${{ vars.AZUREOPENAI__RESPONSESDEPLOYMENTNAME }}
-      AZURE_OPENAI_CHAT_COMPLETION_MODEL: ${{ vars.AZUREOPENAI__CHATDEPLOYMENTNAME }}
-      FOUNDRY_PROJECT_ENDPOINT: ${{ vars.FOUNDRY_PROJECT_ENDPOINT }}
-      FOUNDRY_MODEL: ${{ vars.FOUNDRY_MODEL }}
-      FUNCTIONS_WORKER_RUNTIME: "python"
-      DURABLE_TASK_SCHEDULER_CONNECTION_STRING: "Endpoint=http://localhost:8080;TaskHub=default;Authentication=None"
-      AzureWebJobsStorage: "UseDevelopmentStorage=true"
-    defaults:
-      run:
-        working-directory: python
-    steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-        with:
-          ref: ${{ inputs.checkout-ref }}
-          persist-credentials: false
-      - name: Set up python and install the project
-        id: python-setup
-        uses: ./.github/actions/python-setup
-        with:
-          python-version: ${{ env.UV_PYTHON }}
-          os: ${{ runner.os }}
-      - name: Azure CLI Login
-        uses: azure/login@a457da9ea143d694b1b9c7c869ebb04ebe844ef5 # v2
-        with:
-          client-id: ${{ secrets.AZURE_CLIENT_ID }}
-          tenant-id: ${{ secrets.AZURE_TENANT_ID }}
-          subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}
-      - name: Set up Azure Functions Integration Test Emulators
-        uses: ./.github/actions/azure-functions-integration-setup
-        id: azure-functions-setup
-      - name: Test with pytest (Functions + Durable Task integration)
-        run: >
-          uv run pytest --import-mode=importlib
-          packages/azurefunctions/tests/integration_tests
-          packages/durabletask/tests/integration_tests
-          -m integration
-          -n logical --dist worksteal
-          -x
-          --timeout=480 --session-timeout=900 --timeout_method thread
-          --retries 2 --retry-delay 5
-          --junitxml=pytest.xml
-      - name: Upload test results
-        if: always()
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
-        with:
-          name: test-results-functions
-          path: ./python/pytest.xml
-          if-no-files-found: ignore
-
   # Foundry integration tests
   python-tests-foundry:
     name: Python Integration Tests - Foundry
@@ -553,7 +487,6 @@ jobs:
         python-tests-openai,
         python-tests-azure-openai,
         python-tests-misc-integration,
-        python-tests-functions,
         python-tests-foundry,
         python-tests-foundry-hosting,
         python-tests-cosmos,
@@ -618,7 +551,6 @@ jobs:
         python-tests-openai,
         python-tests-azure-openai,
         python-tests-misc-integration,
-        python-tests-functions,
         python-tests-foundry,
         python-tests-foundry-hosting,
         python-tests-cosmos,

.github/workflows/python-merge-tests.yml

@@ -36,7 +36,6 @@ jobs:
       openaiChanged: ${{ steps.filter.outputs.openai }}
       azureChanged: ${{ steps.filter.outputs.azure }}
       miscChanged: ${{ steps.filter.outputs.misc }}
-      functionsChanged: ${{ steps.filter.outputs.functions }}
       foundryChanged: ${{ steps.filter.outputs.foundry }}
       foundryHostingChanged: ${{ steps.filter.outputs.foundry_hosting }}
       cosmosChanged: ${{ steps.filter.outputs.cosmos }}
@@ -68,6 +67,7 @@ jobs:
             misc:
               - 'python/packages/anthropic/**'
               - 'python/packages/hyperlight/**'
+              - 'python/packages/mistral/**'
               - 'python/packages/ollama/**'
               - 'python/packages/core/agent_framework/_mcp.py'
               - 'python/packages/core/tests/core/test_mcp.py'
@@ -76,9 +76,6 @@ jobs:
               - '.github/actions/setup-local-mcp-server/**'
               - '.github/workflows/python-merge-tests.yml'
               - '.github/workflows/python-integration-tests.yml'
-            functions:
-              - 'python/packages/azurefunctions/**'
-              - 'python/packages/durabletask/**'
             foundry:
               - 'python/packages/foundry/**'
               - 'python/samples/**/providers/foundry/**'
@@ -339,11 +336,12 @@ jobs:
           fallback_url: ${{ env.LOCAL_MCP_URL }}
       - name: Prefer local MCP URL when available
         run: echo "LOCAL_MCP_URL=${{ steps.local-mcp.outputs.effective_url }}" >> "$GITHUB_ENV"
-      - name: Test with pytest (Anthropic, Hyperlight, Ollama, MCP integration)
+      - name: Test with pytest (Anthropic, Hyperlight, Mistral, Ollama, MCP integration)
         run: >
           uv run pytest --import-mode=importlib
           packages/anthropic/tests
           packages/hyperlight/tests
+          packages/mistral/tests
           packages/ollama/tests
           packages/core/tests/core/test_mcp.py
           packages/hosting-mcp/tests
@@ -390,84 +388,6 @@ jobs:
           path: ./python/pytest.xml
           if-no-files-found: ignore
 
-  # Azure Functions + Durable Task integration tests
-  python-tests-functions:
-    name: Python Tests - Functions Integration
-    needs: paths-filter
-    if: >
-      github.event_name != 'pull_request' &&
-      needs.paths-filter.outputs.pythonChanges == 'true' &&
-      (github.event_name != 'merge_group' ||
-       needs.paths-filter.outputs.functionsChanged == 'true' ||
-       needs.paths-filter.outputs.coreChanged == 'true')
-    runs-on: ubuntu-latest
-    environment: integration
-    env:
-      UV_PYTHON: "3.11"
-      OPENAI_CHAT_COMPLETION_MODEL: ${{ vars.OPENAI__CHATMODELID }}
-      OPENAI_CHAT_MODEL: ${{ vars.OPENAI__RESPONSESMODELID }}
-      OPENAI_MODEL: ${{ vars.OPENAI__RESPONSESMODELID }}
-      OPENAI_EMBEDDING_MODEL: ${{ vars.OPENAI_EMBEDDING_MODEL_ID }}
-      OPENAI_API_KEY: ${{ secrets.OPENAI__APIKEY }}
-      AZURE_OPENAI_ENDPOINT: ${{ vars.AZUREOPENAI__ENDPOINT }}
-      AZURE_OPENAI_MODEL: ${{ vars.AZUREOPENAI__RESPONSESDEPLOYMENTNAME }}
-      AZURE_OPENAI_CHAT_MODEL: ${{ vars.AZUREOPENAI__RESPONSESDEPLOYMENTNAME }}
-      AZURE_OPENAI_CHAT_COMPLETION_MODEL: ${{ vars.AZUREOPENAI__CHATDEPLOYMENTNAME }}
-      FOUNDRY_PROJECT_ENDPOINT: ${{ vars.FOUNDRY_PROJECT_ENDPOINT }}
-      FOUNDRY_MODEL: ${{ vars.FOUNDRY_MODEL }}
-      FUNCTIONS_WORKER_RUNTIME: "python"
-      DURABLE_TASK_SCHEDULER_CONNECTION_STRING: "Endpoint=http://localhost:8080;TaskHub=default;Authentication=None"
-      AzureWebJobsStorage: "UseDevelopmentStorage=true"
-    defaults:
-      run:
-        working-directory: python
-    steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
-      - name: Set up python and install the project
-        id: python-setup
-        uses: ./.github/actions/python-setup
-        with:
-          python-version: ${{ env.UV_PYTHON }}
-          os: ${{ runner.os }}
-      - name: Azure CLI Login
-        if: github.event_name != 'pull_request'
-        uses: azure/login@a457da9ea143d694b1b9c7c869ebb04ebe844ef5 # v2
-        with:
-          client-id: ${{ secrets.AZURE_CLIENT_ID }}
-          tenant-id: ${{ secrets.AZURE_TENANT_ID }}
-          subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}
-      - name: Set up Azure Functions Integration Test Emulators
-        uses: ./.github/actions/azure-functions-integration-setup
-        id: azure-functions-setup
-      - name: Test with pytest (Functions + Durable Task integration)
-        run: >
-          uv run pytest --import-mode=importlib
-          packages/azurefunctions/tests/integration_tests
-          packages/durabletask/tests/integration_tests
-          -m integration
-          -n logical --dist worksteal
-          -x
-          --timeout=480 --session-timeout=900 --timeout_method thread
-          --retries 2 --retry-delay 5
-          --junitxml=pytest.xml
-        working-directory: ./python
-      - name: Surface failing tests
-        if: always()
-        uses: pmeier/pytest-results-action@20b595761ba9bf89e115e875f8bc863f913bc8ad # v0.7.2
-        with:
-          path: ./python/pytest.xml
-          summary: true
-          display-options: fEX
-          fail-on-empty: false
-          title: Functions integration test results
-      - name: Upload test results
-        if: always()
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
-        with:
-          name: test-results-functions
-          path: ./python/pytest.xml
-          if-no-files-found: ignore
-
   python-tests-foundry:
     name: Python Integration Tests - Foundry
     needs: paths-filter
@@ -730,7 +650,6 @@ jobs:
         python-tests-openai,
         python-tests-azure-openai,
         python-tests-misc-integration,
-        python-tests-functions,
         python-tests-foundry,
         python-tests-foundry-hosting,
         python-tests-cosmos,
@@ -792,7 +711,6 @@ jobs:
         python-tests-openai,
         python-tests-azure-openai,
         python-tests-misc-integration,
-        python-tests-functions,
         python-tests-foundry,
         python-tests-foundry-hosting,
         python-tests-cosmos,

.github/workflows/python-sample-validation.yml

@@ -8,8 +8,11 @@ on:
 env:
   # Configure a constant location for the uv cache
   UV_CACHE_DIR: /tmp/.uv-cache
+  GITHUB_TOKEN: ${{ github.token }}
+  GITHUB_COPILOT_MODEL: auto
 
 permissions:
+  copilot-requests: write
   contents: read
   id-token: write
 
@@ -20,8 +23,8 @@ jobs:
     environment: integration
     env:
       # Required configuration for get-started samples
-      FOUNDRY_PROJECT_ENDPOINT: ${{ vars.FOUNDRY_PROJECT_ENDPOINT || vars.AZURE_AI_PROJECT_ENDPOINT }}
-      FOUNDRY_MODEL: ${{ vars.FOUNDRY_MODEL || vars.AZUREOPENAI__RESPONSESDEPLOYMENTNAME }}
+      FOUNDRY_PROJECT_ENDPOINT: ${{ vars.FOUNDRY_PROJECT_ENDPOINT }}
+      FOUNDRY_MODEL: ${{ vars.FOUNDRY_MODEL }}
     defaults:
       run:
         working-directory: python
@@ -45,6 +48,10 @@ jobs:
         run: |
           cd scripts && uv run python -m sample_validation --subdir 01-get-started --save-report --report-name 01-get-started
 
+      - name: Save sample playbooks
+        if: ${{ !cancelled() }}
+        uses: ./.github/actions/sample-validation-save-playbooks
+
       - name: Upload validation report
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         if: always()
@@ -54,12 +61,13 @@ jobs:
 
   validate-02-agents:
     name: Validate 02-agents
+    if: false # Temporarily disabled - to free up Copilot quota for other jobs
     runs-on: ubuntu-latest
     environment: integration
     env:
       # Foundry configuration
-      FOUNDRY_PROJECT_ENDPOINT: ${{ vars.FOUNDRY_PROJECT_ENDPOINT || vars.AZURE_AI_PROJECT_ENDPOINT }}
-      FOUNDRY_MODEL: ${{ vars.FOUNDRY_MODEL || vars.AZUREOPENAI__RESPONSESDEPLOYMENTNAME }}
+      FOUNDRY_PROJECT_ENDPOINT: ${{ vars.FOUNDRY_PROJECT_ENDPOINT }}
+      FOUNDRY_MODEL: ${{ vars.FOUNDRY_MODEL }}
       # Azure OpenAI configuration
       AZURE_OPENAI_ENDPOINT: ${{ vars.AZUREOPENAI__ENDPOINT }}
       AZURE_OPENAI_MODEL: ${{ vars.AZURE_OPENAI_DEPLOYMENT_NAME || vars.AZUREOPENAI__RESPONSESDEPLOYMENTNAME }}
@@ -67,12 +75,12 @@ jobs:
       AZURE_OPENAI_CHAT_MODEL: ${{ vars.AZUREOPENAI__RESPONSESDEPLOYMENTNAME }}
       AZURE_OPENAI_EMBEDDING_MODEL: ${{ vars.AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME || vars.AZUREOPENAI__EMBEDDINGDEPLOYMENTNAME }}
       # OpenAI configuration
-      OPENAI_API_KEY: ${{ secrets.OPENAI__APIKEY }}
-      OPENAI_CHAT_COMPLETION_MODEL: ${{ vars.OPENAI__CHATMODELID }}
-      OPENAI_CHAT_MODEL: ${{ vars.OPENAI__RESPONSESMODELID }}
+      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+      OPENAI_CHAT_COMPLETION_MODEL: ${{ vars.OPENAI_CHAT_MODEL_NAME }}
+      OPENAI_CHAT_MODEL: ${{ vars.OPENAI_REASONING_MODEL_NAME }}
       # GitHub MCP
       GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }}
-      OPENAI_MODEL: ${{ vars.OPENAI__RESPONSESMODELID }}
+      OPENAI_MODEL: ${{ vars.OPENAI_REASONING_MODEL_NAME }}
       # Observability
       ENABLE_INSTRUMENTATION: "true"
     defaults:
@@ -105,7 +113,11 @@ jobs:
 
       - name: Run sample validation
         run: |
-          cd scripts && uv run python -m sample_validation --subdir 02-agents --exclude providers --save-report --report-name 02-agents
+          cd scripts && uv run python -m sample_validation --subdir 02-agents --exclude providers harness tools --save-report --report-name 02-agents
+
+      - name: Save sample playbooks
+        if: ${{ !cancelled() }}
+        uses: ./.github/actions/sample-validation-save-playbooks
 
       - name: Upload validation report
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
@@ -114,15 +126,105 @@ jobs:
           name: validation-report-02-agents
           path: python/samples/sample_validation/reports/
 
-  validate-02-agents-openai:
-    name: Validate 02-agents/providers/openai
+  validate-02-agents-harness:
+    name: Validate 02-agents/harness
+    if: false # Temporarily disabled - to free up Copilot quota for other jobs
     runs-on: ubuntu-latest
     environment: integration
     env:
-      OPENAI_API_KEY: ${{ secrets.OPENAI__APIKEY }}
-      OPENAI_MODEL: ${{ vars.OPENAI__CHATMODELID }}
-      OPENAI_CHAT_COMPLETION_MODEL: ${{ vars.OPENAI__CHATMODELID }}
-      OPENAI_CHAT_MODEL: ${{ vars.OPENAI__RESPONSESMODELID }}
+      FOUNDRY_PROJECT_ENDPOINT: ${{ vars.FOUNDRY_PROJECT_ENDPOINT }}
+      FOUNDRY_MODEL: ${{ vars.FOUNDRY_MODEL }}
+      # Optional: enables the Foundry memory path in harness samples
+      FOUNDRY_EMBEDDING_MODEL: ${{ vars.FOUNDRY_EMBEDDING_MODEL || '' }}
+      FOUNDRY_MEMORY_STORE: ${{ vars.FOUNDRY_MEMORY_STORE || '' }}
+    defaults:
+      run:
+        working-directory: python
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+
+      - name: Setup environment
+        uses: ./.github/actions/sample-validation-setup
+        with:
+          azure-client-id: ${{ secrets.AZURE_CLIENT_ID }}
+          azure-tenant-id: ${{ secrets.AZURE_TENANT_ID }}
+          azure-subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}
+          os: ${{ runner.os }}
+
+      - name: Create .env for samples
+        run: |
+          echo "FOUNDRY_PROJECT_ENDPOINT=$FOUNDRY_PROJECT_ENDPOINT" >> .env
+          echo "FOUNDRY_MODEL=$FOUNDRY_MODEL" >> .env
+          echo "FOUNDRY_EMBEDDING_MODEL=$FOUNDRY_EMBEDDING_MODEL" >> .env
+          echo "FOUNDRY_MEMORY_STORE=$FOUNDRY_MEMORY_STORE" >> .env
+
+      - name: Run sample validation
+        run: |
+          cd scripts && uv run python -m sample_validation --subdir 02-agents/harness --save-report --report-name 02-agents-harness
+
+      - name: Save sample playbooks
+        if: ${{ !cancelled() }}
+        uses: ./.github/actions/sample-validation-save-playbooks
+
+      - name: Upload validation report
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        if: always()
+        with:
+          name: validation-report-02-agents-harness
+          path: python/samples/sample_validation/reports/
+
+  validate-02-agents-tools:
+    name: Validate 02-agents/tools
+    if: false # Temporarily disabled - to free up Copilot quota for other jobs
+    runs-on: ubuntu-latest
+    environment: integration
+    env:
+      FOUNDRY_PROJECT_ENDPOINT: ${{ vars.FOUNDRY_PROJECT_ENDPOINT }}
+      FOUNDRY_MODEL: ${{ vars.FOUNDRY_MODEL }}
+    defaults:
+      run:
+        working-directory: python
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+
+      - name: Setup environment
+        uses: ./.github/actions/sample-validation-setup
+        with:
+          azure-client-id: ${{ secrets.AZURE_CLIENT_ID }}
+          azure-tenant-id: ${{ secrets.AZURE_TENANT_ID }}
+          azure-subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}
+          os: ${{ runner.os }}
+
+      - name: Create .env for samples
+        run: |
+          echo "FOUNDRY_PROJECT_ENDPOINT=$FOUNDRY_PROJECT_ENDPOINT" >> .env
+          echo "FOUNDRY_MODEL=$FOUNDRY_MODEL" >> .env
+
+      - name: Run sample validation
+        run: |
+          cd scripts && uv run python -m sample_validation --subdir 02-agents/tools --save-report --report-name 02-agents-tools
+
+      - name: Save sample playbooks
+        if: ${{ !cancelled() }}
+        uses: ./.github/actions/sample-validation-save-playbooks
+
+      - name: Upload validation report
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        if: always()
+        with:
+          name: validation-report-02-agents-tools
+          path: python/samples/sample_validation/reports/
+
+  validate-02-agents-openai:
+    name: Validate 02-agents/providers/openai
+    if: false # Temporarily disabled - to free up Copilot quota for other jobs
+    runs-on: ubuntu-latest
+    environment: integration
+    env:
+      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+      OPENAI_MODEL: ${{ vars.OPENAI_CHAT_MODEL_NAME }}
+      OPENAI_CHAT_COMPLETION_MODEL: ${{ vars.OPENAI_CHAT_MODEL_NAME }}
+      OPENAI_CHAT_MODEL: ${{ vars.OPENAI_REASONING_MODEL_NAME }}
     defaults:
       run:
         working-directory: python
@@ -148,6 +250,10 @@ jobs:
         run: |
           cd scripts && uv run python -m sample_validation --subdir 02-agents/providers/openai --save-report --report-name 02-agents-openai
 
+      - name: Save sample playbooks
+        if: ${{ !cancelled() }}
+        uses: ./.github/actions/sample-validation-save-playbooks
+
       - name: Upload validation report
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         if: always()
@@ -157,6 +263,7 @@ jobs:
 
   validate-02-agents-azure:
     name: Validate 02-agents/providers/azure
+    if: false # Temporarily disabled - to free up Copilot quota for other jobs
     runs-on: ubuntu-latest
     environment: integration
     env:
@@ -187,6 +294,10 @@ jobs:
         run: |
           cd scripts && uv run python -m sample_validation --subdir 02-agents/providers/azure --save-report --report-name 02-agents-azure
 
+      - name: Save sample playbooks
+        if: ${{ !cancelled() }}
+        uses: ./.github/actions/sample-validation-save-playbooks
+
       - name: Upload validation report
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         if: always()
@@ -196,6 +307,7 @@ jobs:
 
   validate-02-agents-anthropic:
     name: Validate 02-agents/providers/anthropic
+    if: false # Temporarily disabled - to free up Copilot quota for other jobs
     runs-on: ubuntu-latest
     environment: integration
     env:
@@ -224,6 +336,10 @@ jobs:
         run: |
           cd scripts && uv run python -m sample_validation --subdir 02-agents/providers/anthropic --save-report --report-name 02-agents-anthropic
 
+      - name: Save sample playbooks
+        if: ${{ !cancelled() }}
+        uses: ./.github/actions/sample-validation-save-playbooks
+
       - name: Upload validation report
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         if: always()
@@ -233,15 +349,9 @@ jobs:
 
   validate-02-agents-github-copilot:
     name: Validate 02-agents/providers/github_copilot
+    if: false # Temporarily disabled - to free up Copilot quota for other jobs
     runs-on: ubuntu-latest
     environment: integration
-    permissions:
-      copilot-requests: write
-      contents: read
-      id-token: write
-    env:
-      GITHUB_TOKEN: ${{ github.token }}
-      GITHUB_COPILOT_MODEL: claude-opus-4.6
     defaults:
       run:
         working-directory: python
@@ -260,6 +370,10 @@ jobs:
         run: |
           cd scripts && uv run python -m sample_validation --subdir 02-agents/providers/github_copilot --save-report --report-name 02-agents-github-copilot
 
+      - name: Save sample playbooks
+        if: ${{ !cancelled() }}
+        uses: ./.github/actions/sample-validation-save-playbooks
+
       - name: Upload validation report
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         if: always()
@@ -292,6 +406,10 @@ jobs:
         run: |
           cd scripts && uv run python -m sample_validation --subdir 02-agents/providers/amazon --save-report --report-name 02-agents-amazon
 
+      - name: Save sample playbooks
+        if: ${{ !cancelled() }}
+        uses: ./.github/actions/sample-validation-save-playbooks
+
       - name: Upload validation report
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         if: always()
@@ -324,6 +442,10 @@ jobs:
         run: |
           cd scripts && uv run python -m sample_validation --subdir 02-agents/providers/ollama --save-report --report-name 02-agents-ollama
 
+      - name: Save sample playbooks
+        if: ${{ !cancelled() }}
+        uses: ./.github/actions/sample-validation-save-playbooks
+
       - name: Upload validation report
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         if: always()
@@ -333,12 +455,12 @@ jobs:
 
   validate-02-agents-foundry:
     name: Validate 02-agents/providers/foundry
-    if: false # Temporarily disabled - provider folder also contains the local Foundry sample
+    if: false # Temporarily disabled - to free up Copilot quota for other jobs
     runs-on: ubuntu-latest
     environment: integration
     env:
-      FOUNDRY_PROJECT_ENDPOINT: ${{ vars.FOUNDRY_PROJECT_ENDPOINT || vars.AZURE_AI_PROJECT_ENDPOINT }}
-      FOUNDRY_MODEL: ${{ vars.FOUNDRY_MODEL || vars.AZUREOPENAI__RESPONSESDEPLOYMENTNAME }}
+      FOUNDRY_PROJECT_ENDPOINT: ${{ vars.FOUNDRY_PROJECT_ENDPOINT }}
+      FOUNDRY_MODEL: ${{ vars.FOUNDRY_MODEL }}
       FOUNDRY_AGENT_NAME: ${{ vars.FOUNDRY_AGENT_NAME || '' }}
       FOUNDRY_AGENT_VERSION: ${{ vars.FOUNDRY_AGENT_VERSION || '' }}
     defaults:
@@ -366,6 +488,10 @@ jobs:
         run: |
           cd scripts && uv run python -m sample_validation --subdir 02-agents/providers/foundry --save-report --report-name 02-agents-foundry
 
+      - name: Save sample playbooks
+        if: ${{ !cancelled() }}
+        uses: ./.github/actions/sample-validation-save-playbooks
+
       - name: Upload validation report
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         if: always()
@@ -408,6 +534,10 @@ jobs:
         run: |
           cd scripts && uv run python -m sample_validation --subdir 02-agents/providers/copilotstudio --save-report --report-name 02-agents-copilotstudio
 
+      - name: Save sample playbooks
+        if: ${{ !cancelled() }}
+        uses: ./.github/actions/sample-validation-save-playbooks
+
       - name: Upload validation report
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         if: always()
@@ -437,6 +567,10 @@ jobs:
         run: |
           cd scripts && uv run python -m sample_validation --subdir 02-agents/providers/custom --save-report --report-name 02-agents-custom
 
+      - name: Save sample playbooks
+        if: ${{ !cancelled() }}
+        uses: ./.github/actions/sample-validation-save-playbooks
+
       - name: Upload validation report
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         if: always()
@@ -446,11 +580,12 @@ jobs:
 
   validate-03-workflows:
     name: Validate 03-workflows
+    if: false # Temporarily disabled - to free up Copilot quota for other jobs
     runs-on: ubuntu-latest
     environment: integration
     env:
-      FOUNDRY_PROJECT_ENDPOINT: ${{ vars.FOUNDRY_PROJECT_ENDPOINT || vars.AZURE_AI_PROJECT_ENDPOINT }}
-      FOUNDRY_MODEL: ${{ vars.FOUNDRY_MODEL || vars.AZUREOPENAI__RESPONSESDEPLOYMENTNAME }}
+      FOUNDRY_PROJECT_ENDPOINT: ${{ vars.FOUNDRY_PROJECT_ENDPOINT }}
+      FOUNDRY_MODEL: ${{ vars.FOUNDRY_MODEL }}
     defaults:
       run:
         working-directory: python
@@ -474,6 +609,10 @@ jobs:
         run: |
           cd scripts && uv run python -m sample_validation --subdir 03-workflows --save-report --report-name 03-workflows
 
+      - name: Save sample playbooks
+        if: ${{ !cancelled() }}
+        uses: ./.github/actions/sample-validation-save-playbooks
+
       - name: Upload validation report
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         if: always()
@@ -481,14 +620,61 @@ jobs:
           name: validation-report-03-workflows
           path: python/samples/sample_validation/reports/
 
-  validate-04-hosting:
-    name: Validate 04-hosting
-    if: false # Temporarily disabled because of sample complexity
+  validate-04-hosting-foundry-hosted-agents:
+    name: Validate 04-hosting (foundry-hosted-agents)
     runs-on: ubuntu-latest
     environment: integration
     env:
-      FOUNDRY_PROJECT_ENDPOINT: ${{ vars.FOUNDRY_PROJECT_ENDPOINT || vars.AZURE_AI_PROJECT_ENDPOINT }}
-      FOUNDRY_MODEL: ${{ vars.FOUNDRY_MODEL || vars.AZUREOPENAI__RESPONSESDEPLOYMENTNAME }}
+      FOUNDRY_PROJECT_ENDPOINT: ${{ vars.FOUNDRY_PROJECT_ENDPOINT }}
+      FOUNDRY_MODEL: ${{ vars.FOUNDRY_MODEL }}
+      # Foundry hosted agent configuration
+      AZURE_AI_MODEL_DEPLOYMENT_NAME: ${{ vars.FOUNDRY_MODEL }}
+      FOUNDRY_PROJECT_ID: ${{ vars.FOUNDRY_PROJECT_ID }}
+      AZURE_CONTAINER_REGISTRY_ENDPOINT: ${{ vars.AZURE_CONTAINER_REGISTRY_ENDPOINT }}
+      GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }}
+      TOOLBOX_ENDPOINT: ${{ vars.TOOLBOX_ENDPOINT }}
+      FOUNDRY_AGENT_NAME: ${{ vars.FOUNDRY_HOSTED_AGENT_NAME }}
+      MEMORY_STORE_NAME: ${{ vars.FOUNDRY_HOSTED_AGENT_MEMORY_STORE }}
+      AZURE_SEARCH_ENDPOINT: ${{ vars.AZURE_SEARCH_ENDPOINT }}
+      AZURE_SEARCH_INDEX_NAME: ${{ vars.FOUNDRY_HOSTED_AGENT_SEARCH_INDEX_NAME }}
+    defaults:
+      run:
+        working-directory: python
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+
+      - name: Setup environment
+        uses: ./.github/actions/sample-validation-setup
+        with:
+          azure-client-id: ${{ secrets.AZURE_CLIENT_ID }}
+          azure-tenant-id: ${{ secrets.AZURE_TENANT_ID }}
+          azure-subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}
+          os: ${{ runner.os }}
+
+      - name: Run sample validation
+        # Maximum parallel workers is set to 1 because all samples use the same port
+        run: |
+          cd scripts && uv run python -m sample_validation --subdir 04-hosting/foundry-hosted-agents --save-report --report-name 04-hosting-foundry-hosted-agents --max-parallel-workers 1
+
+      - name: Save sample playbooks
+        if: ${{ !cancelled() }}
+        uses: ./.github/actions/sample-validation-save-playbooks
+
+      - name: Upload validation report
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        if: always()
+        with:
+          name: validation-report-04-hosting-foundry-hosted-agents
+          path: python/samples/sample_validation/reports/
+
+  validate-04-hosting-other:
+    name: Validate 04-hosting (other)
+    if: false # Temporarily disabled - to free up Copilot quota for other jobs
+    runs-on: ubuntu-latest
+    environment: integration
+    env:
+      FOUNDRY_PROJECT_ENDPOINT: ${{ vars.FOUNDRY_PROJECT_ENDPOINT }}
+      FOUNDRY_MODEL: ${{ vars.FOUNDRY_MODEL }}
       # A2A configuration
       A2A_AGENT_HOST: http://localhost:5001/
     defaults:
@@ -507,13 +693,17 @@ jobs:
 
       - name: Run sample validation
         run: |
-          cd scripts && uv run python -m sample_validation --subdir 04-hosting --save-report --report-name 04-hosting
+          cd scripts && uv run python -m sample_validation --subdir 04-hosting --exclude foundry-hosted-agents --save-report --report-name 04-hosting-other
+
+      - name: Save sample playbooks
+        if: ${{ !cancelled() }}
+        uses: ./.github/actions/sample-validation-save-playbooks
 
       - name: Upload validation report
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         if: always()
         with:
-          name: validation-report-04-hosting
+          name: validation-report-04-hosting-other
           path: python/samples/sample_validation/reports/
 
   validate-05-end-to-end:
@@ -522,8 +712,8 @@ jobs:
     runs-on: ubuntu-latest
     environment: integration
     env:
-      FOUNDRY_PROJECT_ENDPOINT: ${{ vars.FOUNDRY_PROJECT_ENDPOINT || vars.AZURE_AI_PROJECT_ENDPOINT }}
-      FOUNDRY_MODEL: ${{ vars.FOUNDRY_MODEL || vars.AZUREOPENAI__RESPONSESDEPLOYMENTNAME }}
+      FOUNDRY_PROJECT_ENDPOINT: ${{ vars.FOUNDRY_PROJECT_ENDPOINT }}
+      FOUNDRY_MODEL: ${{ vars.FOUNDRY_MODEL }}
       # Azure OpenAI configuration
       AZURE_OPENAI_ENDPOINT: ${{ vars.AZUREOPENAI__ENDPOINT }}
       AZURE_OPENAI_MODEL: ${{ vars.AZURE_OPENAI_DEPLOYMENT_NAME || vars.AZUREOPENAI__RESPONSESDEPLOYMENTNAME }}
@@ -552,6 +742,10 @@ jobs:
         run: |
           cd scripts && uv run python -m sample_validation --subdir 05-end-to-end --save-report --report-name 05-end-to-end
 
+      - name: Save sample playbooks
+        if: ${{ !cancelled() }}
+        uses: ./.github/actions/sample-validation-save-playbooks
+
       - name: Upload validation report
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         if: always()
@@ -564,16 +758,16 @@ jobs:
     runs-on: ubuntu-latest
     environment: integration
     env:
-      FOUNDRY_PROJECT_ENDPOINT: ${{ vars.FOUNDRY_PROJECT_ENDPOINT || vars.AZURE_AI_PROJECT_ENDPOINT }}
-      FOUNDRY_MODEL: ${{ vars.FOUNDRY_MODEL || vars.AZUREOPENAI__RESPONSESDEPLOYMENTNAME }}
+      FOUNDRY_PROJECT_ENDPOINT: ${{ vars.FOUNDRY_PROJECT_ENDPOINT }}
+      FOUNDRY_MODEL: ${{ vars.FOUNDRY_MODEL }}
       # Azure OpenAI configuration
       AZURE_OPENAI_ENDPOINT: ${{ vars.AZUREOPENAI__ENDPOINT }}
       AZURE_OPENAI_MODEL: ${{ vars.AZURE_OPENAI_DEPLOYMENT_NAME || vars.AZUREOPENAI__RESPONSESDEPLOYMENTNAME }}
       # OpenAI configuration
-      OPENAI_API_KEY: ${{ secrets.OPENAI__APIKEY }}
-      OPENAI_CHAT_COMPLETION_MODEL: ${{ vars.OPENAI__CHATMODELID }}
-      OPENAI_CHAT_MODEL: ${{ vars.OPENAI__RESPONSESMODELID }}
-      OPENAI_MODEL: ${{ vars.OPENAI__RESPONSESMODELID }}
+      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+      OPENAI_CHAT_COMPLETION_MODEL: ${{ vars.OPENAI_CHAT_MODEL_NAME }}
+      OPENAI_CHAT_MODEL: ${{ vars.OPENAI_REASONING_MODEL_NAME }}
+      OPENAI_MODEL: ${{ vars.OPENAI_REASONING_MODEL_NAME }}
     defaults:
       run:
         working-directory: python
@@ -598,9 +792,16 @@ jobs:
           echo "OPENAI_CHAT_COMPLETION_MODEL=$OPENAI_CHAT_COMPLETION_MODEL" >> .env
           echo "OPENAI_CHAT_MODEL=$OPENAI_CHAT_MODEL" >> .env
 
+      - name: Pre-install AutoGen dependencies for migration samples
+        run: uv pip install "autogen-agentchat" "autogen-ext[openai]"
+
       - name: Run sample validation
         run: |
-          cd scripts && uv run python -m sample_validation --subdir autogen-migration --save-report --report-name autogen-migration
+          cd scripts && uv run python -m sample_validation --subdir autogen-migration --save-report --report-name autogen-migration --agent-timeout 600
+
+      - name: Save sample playbooks
+        if: ${{ !cancelled() }}
+        uses: ./.github/actions/sample-validation-save-playbooks
 
       - name: Upload validation report
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
@@ -611,23 +812,25 @@ jobs:
 
   validate-semantic-kernel-migration:
     name: Validate semantic-kernel-migration
+    if: false # Temporarily disabled - to free up Copilot quota for other jobs
     runs-on: ubuntu-latest
     environment: integration
     env:
-      FOUNDRY_PROJECT_ENDPOINT: ${{ vars.FOUNDRY_PROJECT_ENDPOINT || vars.AZURE_AI_PROJECT_ENDPOINT }}
-      FOUNDRY_MODEL: ${{ vars.FOUNDRY_MODEL || vars.AZUREOPENAI__RESPONSESDEPLOYMENTNAME }}
+      FOUNDRY_PROJECT_ENDPOINT: ${{ vars.FOUNDRY_PROJECT_ENDPOINT }}
+      FOUNDRY_MODEL: ${{ vars.FOUNDRY_MODEL }}
       # Azure OpenAI configuration for AF
       AZURE_OPENAI_ENDPOINT: ${{ vars.AZUREOPENAI__ENDPOINT }}
       AZURE_OPENAI_MODEL: ${{ vars.AZURE_OPENAI_DEPLOYMENT_NAME || vars.AZUREOPENAI__RESPONSESDEPLOYMENTNAME }}
       # Azure OpenAI configuration for SK
       AZURE_OPENAI_CHAT_DEPLOYMENT_NAME: ${{ vars.AZURE_OPENAI_DEPLOYMENT_NAME }}
       # OpenAI key
-      OPENAI_API_KEY: ${{ secrets.OPENAI__APIKEY }}
-      OPENAI_CHAT_COMPLETION_MODEL: ${{ vars.OPENAI__CHATMODELID }}
-      OPENAI_CHAT_MODEL: ${{ vars.OPENAI__RESPONSESMODELID }}
-      OPENAI_MODEL: ${{ vars.OPENAI__RESPONSESMODELID }}
+      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+      OPENAI_CHAT_COMPLETION_MODEL: ${{ vars.OPENAI_CHAT_MODEL_NAME }}
+      OPENAI_CHAT_MODEL: ${{ vars.OPENAI_REASONING_MODEL_NAME }}
+      OPENAI_MODEL: ${{ vars.OPENAI_REASONING_MODEL_NAME }}
       # OpenAI configuration for SK
-      OPENAI_CHAT_MODEL_ID: ${{ vars.OPENAI__CHATMODELID }}
+      OPENAI_CHAT_MODEL_ID: ${{ vars.OPENAI_CHAT_MODEL_NAME }}
+      OPENAI_RESPONSES_MODEL_ID: ${{ vars.OPENAI__RESPONSESMODELID }}
       # Copilot Studio
       COPILOTSTUDIOAGENT__ENVIRONMENTID: ${{ secrets.COPILOTSTUDIOAGENT__ENVIRONMENTID }}
       COPILOTSTUDIOAGENT__SCHEMANAME: ${{ secrets.COPILOTSTUDIOAGENT__SCHEMANAME }}
@@ -665,6 +868,10 @@ jobs:
         run: |
           cd scripts && uv run python -m sample_validation --subdir semantic-kernel-migration --save-report --report-name semantic-kernel-migration
 
+      - name: Save sample playbooks
+        if: ${{ !cancelled() }}
+        uses: ./.github/actions/sample-validation-save-playbooks
+
       - name: Upload validation report
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         if: always()
@@ -679,6 +886,8 @@ jobs:
     needs:
       - validate-01-get-started
       - validate-02-agents
+      - validate-02-agents-harness
+      - validate-02-agents-tools
       - validate-02-agents-openai
       - validate-02-agents-azure
       - validate-02-agents-anthropic
@@ -689,7 +898,8 @@ jobs:
       - validate-02-agents-copilotstudio
       - validate-02-agents-custom
       - validate-03-workflows
-      - validate-04-hosting
+      - validate-04-hosting-foundry-hosted-agents
+      - validate-04-hosting-other
       - validate-05-end-to-end
       - validate-autogen-migration
       - validate-semantic-kernel-migration

README.md

@@ -161,19 +161,19 @@ Console.WriteLine(await agent.RunAsync("Write a haiku about Microsoft Agent Fram
 
 ### Python
 
-- [Getting Started](./python/samples/01-get-started): progressive tutorial from hello-world to hosting
+- [Getting Started](./python/samples/01-get-started): progressive tutorial from hello-world to workflows
 - [Agent Concepts](./python/samples/02-agents): deep-dive samples by topic (tools, middleware, providers, etc.)
 - [Workflows](./python/samples/03-workflows): workflow creation and integration with agents
-- [Hosting](./python/samples/04-hosting): A2A, Azure Functions, Durable Task hosting
+- [Hosting](./python/samples/04-hosting): A2A, self-hosted protocol helpers, and Foundry hosted agents. Durable Task and Azure Functions samples are in the [Durable Agent Framework extension](https://github.com/microsoft/agent-framework-durable-extension/tree/main/python/samples).
 - [End-to-End](./python/samples/05-end-to-end): full applications, evaluation, and demos
 
 ### .NET
 
-- [Getting Started](./dotnet/samples/01-get-started): progressive tutorial from hello agent to hosting
+- [Getting Started](./dotnet/samples/01-get-started): progressive tutorial from hello agent to workflows
 - [Agent Concepts](./dotnet/samples/02-agents/Agents): basic agent creation and tool usage
 - [Agent Providers](./dotnet/samples/02-agents/AgentProviders): samples showing different agent providers
 - [Workflows](./dotnet/samples/03-workflows): advanced multi-agent patterns and workflow orchestration
-- [Hosting](./dotnet/samples/04-hosting): A2A, Durable Agents, Durable Workflows
+- [Hosting](./dotnet/samples/04-hosting): A2A and Foundry hosted agents. Durable agent and workflow samples are in the [Durable Agent Framework extension](https://github.com/microsoft/agent-framework-durable-extension/tree/main/dotnet/samples).
 - [End-to-End](./dotnet/samples/05-end-to-end): full applications and demos
 
 ## Community & Feedback

docs/decisions/0032-durable-azure-functions-extraction.md

@@ -0,0 +1,104 @@
+---
+status: Accepted
+contact: cgillum
+date: 2026-07-21
+deciders: cgillum, vrdmr, chetantoshniwal
+consulted: westey-m, eavanvalkenburg, kshyju, larohra, ahmedmuhsin
+informed:
+---
+
+# Extract Durable Task and Azure Functions hosting into a separate repository
+
+## Context and Problem Statement
+
+The Durable Task and Azure Functions hosting integrations (`agent-framework-durabletask`,
+`agent-framework-azurefunctions`, plus their samples, docs, and CI) currently live in the
+`microsoft/agent-framework` (MAF) monorepo. They carry heavyweight specialized dependencies
+(Azure Functions runtime, Durable Task) and need integration-test infrastructure (Functions Core
+Tools, Azurite, a DTS emulator) that the core repo otherwise does not.
+
+This ADR proposes moving them into a dedicated repository
+([`microsoft/agent-framework-durable-extension`](https://github.com/microsoft/agent-framework-durable-extension))
+and considers how to do so without breaking existing users who import them today.
+
+## Decision Drivers
+
+- **Independent lifecycle** — the hosting integrations should be able to version and release on their
+  own cadence, decoupled from core (extends [ADR-0008](0008-python-subpackages.md)'s goal of keeping
+  heavyweight/optional dependencies out of the main package).
+- **Dependency & CI isolation** — keep core lean and its PR pipeline free of heavyweight hosting
+  dependencies and integration-test prerequisites.
+- **Ownership** — a dedicated repo would give the integrations their own issues, CODEOWNERS, and
+  contribution flow.
+- **No breaking change** — existing `from agent_framework.azure import …` code and
+  `pip install agent-framework[all]` should keep working (stable-import-path guarantee, ADR-0008).
+
+## Considered Options
+
+1. **Keep in the MAF repo** (status quo).
+2. **Move out, drop the core shim** — the extension becomes standalone; core stops re-exporting the
+   types and removes them from `[all]`.
+3. **Move out, keep core's backward-compat shim + `[all]`** (proposed) — the code would live in the
+   new repo; core would still lazily re-export the entry-point types from `agent_framework.azure` and
+   keep both packages in the `[all]` extra (resolved from PyPI).
+
+## Decision Outcome
+
+Proposed choice: **Option 3.** Extract the integrations for lifecycle, dependency, and ownership
+isolation, while preserving the existing import surface so the move is invisible to consumers.
+Option 1 forgoes the isolation benefits; Option 2 achieves them but would be a breaking change for
+existing imports and the `[all]` extra.
+
+### Consequences
+
+- Good — would give independent release cadence, a leaner/faster core repo and CI, and clear
+  ownership for the hosting integrations.
+- Good — no user-visible break: existing imports and `agent-framework[all]` would continue to work
+  unchanged.
+- Neutral — type *definitions* would live once in the extension; the core shim would re-export only a
+  curated subset of entry-point types (no metadata duplication). The extension's own samples/docs
+  would import directly from `agent_framework_durabletask` / `agent_framework_azurefunctions`; the
+  shim would be compatibility-only.
+- Neutral — users may still open GitHub issues against the core repo for problems in the extension,
+  but the extension's own repo would be the primary place for issues and PRs. These issues would
+  need to be triaged and transferred to the extension repo.
+- Neutral — **.NET public API boundary.** The extension should prefer the smallest stable public core
+  API over friend-assembly access where the capability is useful to external hosts or tooling. For
+  workflow routing metadata, the agreed first step is to expose a read-only `Workflow.Edges` view plus
+  public `EdgeData.Connection` and `FanOutEdgeData`, while keeping graph construction internal
+  ([#7448](https://github.com/microsoft/agent-framework/issues/7448),
+  [#7459](https://github.com/microsoft/agent-framework/pull/7459)). This reduces internal coupling but
+  adds a public API compatibility commitment. Any remaining internal dependencies would still need to
+  be evaluated individually before retaining `InternalsVisibleTo`.
+- Bad — **Python version coordination.** Core's shim correctness would track the extension's publish
+  cadence. In the other direction, when an extension package adopts a new core API, maintainers would
+  need to choose per feature between raising its minimum core version (simpler, but forces every
+  extension user to upgrade) and conditional imports with fallback behavior (preserves support for
+  older core versions, but adds implementation and testing complexity).
+
+## Validation
+
+Compliance would be validated by:
+
+- Python: `uv lock --check` passing with both packages resolving from PyPI; the shim entry-point
+  symbols importing at runtime after `uv sync --all-extras`; `pyright` staying clean on
+  `agent_framework/azure/__init__.pyi`; and extension tests running against both the minimum supported
+  and current core versions when conditional compatibility behavior is used.
+- .NET: tests from an external assembly confirming that workflow routing metadata is inspectable
+  through the agreed public surface while graph construction remains internal.
+
+A known risk is **publish-lag**: if a symbol is added to core's shim before the extension has
+published a release that exports it, that symbol would not resolve at runtime. The mitigation would
+be to omit any such symbol from the shim until the extension publishes it, then add the entry and
+re-lock.
+
+## More Information
+
+- Related: [ADR-0008](0008-python-subpackages.md) (vendor namespaces + stable import paths),
+  [ADR-0021](0021-provider-leading-clients.md) (lazy-loading gateways),
+  [issue #7448](https://github.com/microsoft/agent-framework/issues/7448) and
+  [PR #7459](https://github.com/microsoft/agent-framework/pull/7459) (.NET workflow routing API).
+- Follow-ups: during extraction, keep the shim's re-exported symbols in sync with each newly
+  published extension release (adding any symbol only once the extension publishes it); document the
+  direct-import convention in the extension's samples READMEs so samples are not switched back to the
+  shim.

docs/features/durable-agents/AGENTS.md

@@ -1,48 +0,0 @@
-# AGENTS.md
-
-Instructions for AI coding agents working on durable agents documentation.
-
-## Scope
-
-This directory contains feature documentation for the durable agents integration. The source code and samples live elsewhere:
-
-- .NET implementation: `dotnet/src/Microsoft.Agents.AI.DurableTask/` and `dotnet/src/Microsoft.Agents.AI.Hosting.AzureFunctions/`
-- Python implementation: `python/packages/durabletask/` and `python/packages/azurefunctions/` (package `agent-framework-azurefunctions`)
-- .NET samples: `dotnet/samples/04-hosting/DurableAgents/`
-- Python samples: `python/samples/04-hosting/durabletask/`
-- Official docs (Microsoft Learn): <https://learn.microsoft.com/agent-framework/integrations/azure-functions>
-
-## Document structure
-
-| File | Purpose |
-| --- | --- |
-| `README.md` | Main technical overview: architecture, hosting models, orchestration patterns, and links to samples. |
-| `durable-agents-ttl.md` | Deep-dive on session Time-To-Live (TTL) configuration and behavior. |
-
-Add new sibling documents when a topic is too detailed for the README (e.g., a new feature like reliable streaming or MCP tool exposure). Keep the README focused on orientation and link out to siblings for depth.
-
-## Writing guidelines
-
-- **Audience**: Developers already familiar with the Microsoft Agent Framework who want to understand what durability adds and how to use it.
-- **Host-agnostic first**: Durable agents work in console apps, Azure Functions, and any Durable Task–compatible host. Show host-agnostic patterns (plain orchestration functions, `IServiceCollection` registration) before Azure Functions–specific patterns. Avoid giving the impression that Azure Functions is the only hosting option.
-- **Both languages**: Always include C# and Python examples side by side. Keep them equivalent in functionality.
-- **Callout syntax**: Use GitHub-flavored callouts (`> [!NOTE]`, `> [!IMPORTANT]`, `> [!WARNING]`) rather than bold-text callouts (`> **Note:** ...`).
-- **Line length**: Do not wrap long lines. Rely on text viewers / renderers for line wrapping.
-- **Tables**: Use spaces around pipes in separator rows (`| --- |` not `|---|`).
-- **Code snippets**: Keep them minimal and self-contained. Omit boilerplate (using statements, environment variable reads) unless the snippet is specifically about setup.
-- **Cross-references**: Link to Microsoft Learn for conceptual background (Durable Entities, Durable Task Scheduler, Azure Functions). Link to sibling docs within this directory for feature deep-dives.
-
-## Linting
-
-Run markdownlint on all documents before committing, with line-length checks disabled:
-
-```bash
-markdownlint docs/features/durable-agents/ --disable MD013
-```
-
-## When to update these docs
-
-- A new durable agent feature is added (e.g., a new orchestration pattern, hosting model, or configuration option).
-- The public API surface changes in a way that affects how developers use durable agents.
-- New sample directories are added — update the sample links in README.md.
-- The official Microsoft Learn documentation is restructured — update external links.

docs/features/durable-agents/README.md

@@ -1,239 +1,9 @@
-# Durable agents
+# Durable Agents Have Moved
 
-## Overview
+Durable Task and Azure Functions integrations for Microsoft Agent Framework are now maintained in the [Durable Agent Framework extension repository](https://github.com/microsoft/agent-framework-durable-extension).
 
-Durable agents extend the standard Microsoft Agent Framework with **durable state management** powered by the Durable Task framework. An ordinary Agent Framework agent runs in-process: its conversation history lives in memory and is lost when the process ends. A durable agent persists conversation history and execution state in external storage so that sessions survive process restarts, failures, and scale-out events.
-
-| Capability | Ordinary agent | Durable agent |
-| --- | --- | --- |
-| Conversation history | In-memory only | Durably persisted |
-| Failure recovery | State lost on crash | Automatically resumed |
-| Multi-instance scale-out | Not supported | Any worker can resume a session |
-| Multi-agent orchestrations | Manual coordination | Deterministic, checkpointed workflows |
-| Human-in-the-loop | Must keep process alive | Can wait days/weeks with zero compute |
-| Hosting | Any process | Console app, Azure Functions, or any Durable Task–compatible host |
-
-> [!NOTE]
-> For a step-by-step tutorial and deployment guidance, see [Azure Functions (Durable)](https://learn.microsoft.com/agent-framework/integrations/azure-functions) on Microsoft Learn.
-
-## How durable agents work
-
-Durable agents are implemented on top of [Durable Entities](https://learn.microsoft.com/azure/azure-functions/durable/durable-functions-entities) (also called "virtual actors"). Each **agent session** maps to one entity instance whose state contains the full conversation history. When you send a message to a durable agent, the following happens:
-
-1. The message is dispatched to the entity identified by an `AgentSessionId` (a composite of the agent name and a unique session key).
-2. The entity loads its persisted `DurableAgentState`, which includes the complete conversation history.
-3. The entity invokes the underlying `AIAgent` with the full conversation history, collects the response, and appends both the request and the response to the state.
-4. The updated state is persisted back to durable storage automatically.
-
-Because the entity framework serializes access to each entity instance, concurrent messages to the same session are processed one at a time, eliminating race conditions.
-
-### Agent session identity
-
-Every durable agent session is identified by an `AgentSessionId`, which has two components:
-
-- **Name** – the registered name of the agent (case-insensitive).
-- **Key** – a unique session key (case-sensitive), typically a GUID.
-
-The session ID is mapped to an underlying Durable Task entity ID with a `dafx-` prefix (e.g., `dafx-joker`). This naming convention is consistent across both .NET and Python implementations.
-
-## Architecture
-
-### .NET
-
-The .NET implementation consists of two NuGet packages:
-
-| Package | Purpose |
-| --- | --- |
-| `Microsoft.Agents.AI.DurableTask` | Core durable agent types: `DurableAIAgent`, `AgentEntity`, `DurableAgentSession`, `AgentSessionId`, `DurableAgentsOptions`, and the state model. |
-| `Microsoft.Agents.AI.Hosting.AzureFunctions` | Azure Functions hosting integration: auto-generated HTTP endpoints, MCP tool triggers, entity function triggers, and the `ConfigureDurableAgents` extension method on `FunctionsApplicationBuilder`. |
-
-Key types:
-
-- **`DurableAIAgent`** – A subclass of `AIAgent` used *inside orchestrations*. Obtained via `context.GetAgent("agentName")`, it routes `RunAsync` calls through the orchestration's entity APIs so that each call is checkpointed.
-- **`DurableAIAgentProxy`** – A subclass of `AIAgent` used *outside orchestrations* (e.g., from HTTP triggers or console apps). It signals the entity via `DurableTaskClient` and polls for the response.
-- **`AgentEntity`** – The `TaskEntity<DurableAgentState>` that hosts the real agent. It loads the registered `AIAgent` by name, wraps it in an `EntityAgentWrapper`, feeds it the full conversation history, and persists the result.
-- **`DurableAgentSession`** – An `AgentSession` subclass that carries the `AgentSessionId`.
-- **`DurableAgentsOptions`** – Builder for registering agents and configuring TTL.
-
-### Python
-
-The core Python implementation is in the `agent-framework-durabletask` package (`python/packages/durabletask`). Azure Functions hosting (including `AgentFunctionApp`) is in the separate `agent-framework-azurefunctions` package (`python/packages/azurefunctions`).
-
-Key types:
-
-- **`DurableAIAgent`** – A generic proxy (`DurableAIAgent[TaskT]`) implementing `SupportsAgentRun`. Returns a `TaskT` from `run()` — either an `AgentResponse` (client context) or a `DurableAgentTask` (orchestration context, must be `yield`ed).
-- **`DurableAIAgentWorker`** – Wraps a `TaskHubGrpcWorker` and registers agents as durable entities via `add_agent()`.
-- **`DurableAIAgentClient`** – Wraps a `TaskHubGrpcClient` for external callers. `get_agent()` returns a `DurableAIAgent[AgentResponse]`.
-- **`DurableAIAgentOrchestrationContext`** – Wraps an `OrchestrationContext` for use inside orchestrations. `get_agent()` returns a `DurableAIAgent[DurableAgentTask]`.
-- **`AgentEntity`** – Platform-agnostic agent execution logic that manages state, invokes the agent, handles streaming, and calls response callbacks.
-
-## Hosting models
-
-### Azure Functions
-
-The recommended production hosting model. A single call to `ConfigureDurableAgents` (C#) or `AgentFunctionApp` (Python) automatically:
-
-- Registers agent entities with the Durable Task worker.
-- Generates HTTP endpoints at `/api/agents/{agentName}/run` for each registered agent.
-- Supports `thread_id` query parameter / JSON field and the `x-ms-thread-id` response header for session continuity.
-- Supports fire-and-forget via the `x-ms-wait-for-response: false` header (returns HTTP 202).
-- Optionally exposes agents as MCP tools.
-
-**C# example:**
-
-```csharp
-using IHost app = FunctionsApplication
-    .CreateBuilder(args)
-    .ConfigureFunctionsWebApplication()
-    .ConfigureDurableAgents(options => options.AddAIAgent(agent))
-    .Build();
-app.Run();
-```
-
-**Python example:**
-
-```python
-app = AgentFunctionApp(agents=[agent])
-```
-
-### Console apps / generic hosts
-
-For self-hosted or non-serverless scenarios, register durable agents via `IServiceCollection.ConfigureDurableAgents` (.NET) or `DurableAIAgentWorker` (Python) with explicit Durable Task worker and client configuration.
-
-**C# example:**
-
-```csharp
-IHost host = Host.CreateDefaultBuilder(args)
-    .ConfigureServices(services =>
-    {
-        services.ConfigureDurableAgents(
-            options => options.AddAIAgent(agent),
-            workerBuilder: b => b.UseDurableTaskScheduler(connectionString),
-            clientBuilder: b => b.UseDurableTaskScheduler(connectionString));
-    })
-    .Build();
-```
-
-**Python example:**
-
-```python
-worker = DurableAIAgentWorker(TaskHubGrpcWorker(host_address="localhost:4001"))
-worker.add_agent(agent)
-worker.start()
-```
-
-## Deterministic multi-agent orchestrations
-
-Durable agents can be composed into deterministic, checkpointed workflows using Durable Task orchestrations. The orchestration framework replays orchestrator code on failure, so completed agent calls are not re-executed.
-
-### Patterns
-
-| Pattern | Description |
-| --- | --- |
-| **Sequential (chaining)** | Call agents one after another, passing outputs forward. |
-| **Parallel (fan-out/fan-in)** | Run multiple agents concurrently and aggregate results. |
-| **Conditional** | Branch orchestration logic based on structured agent output. |
-| **Human-in-the-loop** | Pause for external events (approvals, feedback) with optional timeouts. |
-
-### Using agents in orchestrations
-
-Inside an orchestration function, obtain a `DurableAIAgent` via the orchestration context. Each agent gets its own session (created with `CreateSessionAsync` / `create_session`), and you can call the same agent multiple times on the same session to maintain conversation context across sequential invocations.
-
-**C#:**
-
-```csharp
-static async Task<string> WritingOrchestration(TaskOrchestrationContext context)
-{
-    // Get a durable agent reference — works in any host (console app, Azure Functions, etc.)
-    DurableAIAgent writer = context.GetAgent("WriterAgent");
-
-    // Create a session to maintain conversation context across multiple calls
-    AgentSession session = await writer.CreateSessionAsync();
-
-    // First call: generate an initial draft
-    AgentResponse<TextResponse> draft = await writer.RunAsync<TextResponse>(
-        message: "Write a concise inspirational sentence about learning.",
-        session: session);
-
-    // Second call: refine the draft — the agent sees the full conversation history
-    AgentResponse<TextResponse> refined = await writer.RunAsync<TextResponse>(
-        message: $"Improve this further while keeping it under 25 words: {draft.Result.Text}",
-        session: session);
-
-    return refined.Result.Text;
-}
-```
-
-**Python:**
-
-```python
-def writing_orchestration(context, _):
-    agent_ctx = DurableAIAgentOrchestrationContext(context)
-
-    # Get a durable agent reference — works in any host (standalone worker, Azure Functions, etc.)
-    writer = agent_ctx.get_agent("WriterAgent")
-
-    # Create a session to maintain conversation context across multiple calls
-    session = writer.create_session()
-
-    # First call: generate an initial draft
-    draft = yield writer.run(
-        messages="Write a concise inspirational sentence about learning.",
-        session=session,
-    )
-
-    # Second call: refine the draft — the agent sees the full conversation history
-    refined = yield writer.run(
-        messages=f"Improve this further while keeping it under 25 words: {draft.text}",
-        session=session,
-    )
-
-    return refined.text
-```
-
-> [!IMPORTANT]
-> In .NET, `DurableAIAgent.RunAsync<T>` deliberately avoids `ConfigureAwait(false)` because the Durable Task Framework uses a custom synchronization context — all continuations must run on the orchestration thread.
-
-## Streaming and response callbacks
-
-Durable agents do not support true end-to-end streaming because entity operations are request/response. However, **reliable streaming** is supported via response callbacks:
-
-- **`IAgentResponseHandler`** (.NET) or **`AgentResponseCallbackProtocol`** (Python) – Implement this interface to receive streaming updates as the underlying agent generates them (e.g., push tokens to a Redis Stream for client consumption).
-- The entity still returns the complete `AgentResponse` after the stream is fully consumed.
-- Clients can reconnect and resume reading from a cursor-based stream (e.g., Redis Streams) without losing messages.
-
-See the **Reliable Streaming** samples for a complete implementation using Redis Streams.
-
-## Session TTL (Time-To-Live)
-
-Durable agent sessions support automatic cleanup via configurable TTL. See [Session TTL](durable-agents-ttl.md) for details on configuration, behavior, and best practices.
-
-## Observability
-
-When using the [Durable Task Scheduler](https://learn.microsoft.com/azure/azure-functions/durable/durable-task-scheduler/durable-task-scheduler) as the durable backend, you get built-in observability through its dashboard:
-
-- **Conversation history** – View complete chat history for each agent session.
-- **Orchestration visualization** – See multi-agent execution flows, including parallel branches and conditional logic.
-- **Performance metrics** – Monitor agent response times, token usage, and orchestration duration.
-- **Debugging** – Trace tool invocations and external event handling.
-
-## Samples
-
-- **.NET** – [Console app samples](../../../dotnet/samples/04-hosting/DurableAgents/ConsoleApps/) and [Azure Functions samples](../../../dotnet/samples/04-hosting/DurableAgents/AzureFunctions/) covering single-agent, chaining, concurrency, conditionals, human-in-the-loop, long-running tools, MCP tool exposure, and reliable streaming.
-- **Python** – [Durable Task samples](../../../python/samples/04-hosting/durabletask/) covering single-agent, multi-agent, streaming, chaining, concurrency, conditionals, and human-in-the-loop.
-
-## Packages
-
-| Language | Package | Source |
-| --- | --- | --- |
-| .NET | `Microsoft.Agents.AI.DurableTask` | [`dotnet/src/Microsoft.Agents.AI.DurableTask`](../../../dotnet/src/Microsoft.Agents.AI.DurableTask) |
-| .NET | `Microsoft.Agents.AI.Hosting.AzureFunctions` | [`dotnet/src/Microsoft.Agents.AI.Hosting.AzureFunctions`](../../../dotnet/src/Microsoft.Agents.AI.Hosting.AzureFunctions) |
-| Python | `agent-framework-durabletask` | [`python/packages/durabletask`](../../../python/packages/durabletask) |
-| Python | `agent-framework-azurefunctions` | [`python/packages/azurefunctions`](../../../python/packages/azurefunctions) |
-
-## Further reading
-
-- [Azure Functions (Durable) — Microsoft Learn](https://learn.microsoft.com/agent-framework/integrations/azure-functions)
-- [Durable Task Scheduler](https://learn.microsoft.com/azure/azure-functions/durable/durable-task-scheduler/durable-task-scheduler)
-- [Durable Entities](https://learn.microsoft.com/azure/azure-functions/durable/durable-functions-entities)
-- [Session TTL](durable-agents-ttl.md)
+- [.NET source](https://github.com/microsoft/agent-framework-durable-extension/tree/main/dotnet/src)
+- [.NET samples](https://github.com/microsoft/agent-framework-durable-extension/tree/main/dotnet/samples)
+- [Python source](https://github.com/microsoft/agent-framework-durable-extension/tree/main/python/packages)
+- [Python samples](https://github.com/microsoft/agent-framework-durable-extension/tree/main/python/samples)
+- [Durable agent documentation](https://github.com/microsoft/agent-framework-durable-extension/tree/main/docs/features/durable-agents)

docs/features/durable-agents/durable-agents-ttl.md

@@ -1,147 +0,0 @@
-# Time-To-Live (TTL) for durable agent sessions
-
-## Overview
-
-The durable agents automatically maintain conversation history and state for each session. Without automatic cleanup, this state can accumulate indefinitely, consuming storage resources and increasing costs. The Time-To-Live (TTL) feature provides automatic cleanup of idle agent sessions, ensuring that sessions are automatically deleted after a period of inactivity.
-
-## What is TTL?
-
-Time-To-Live (TTL) is a configurable duration that determines how long an agent session state will be retained after its last interaction. When an agent session is idle (no messages sent to it) for longer than the TTL period, the session state is automatically deleted. Each new interaction with an agent resets the TTL timer, extending the session's lifetime.
-
-## Benefits
-
-- **Automatic cleanup**: No manual intervention required to clean up idle agent sessions
-- **Cost optimization**: Reduces storage costs by automatically removing unused session state
-- **Resource management**: Prevents unbounded growth of agent session state in storage
-- **Configurable**: Set TTL globally or per-agent type to match your application's needs
-
-## Configuration
-
-TTL can be configured at two levels:
-
-1. **Global default TTL**: Applies to all agent sessions unless overridden
-2. **Per-agent type TTL**: Overrides the global default for specific agent types
-
-Additionally, you can configure a **minimum deletion delay** that controls how frequently deletion operations are scheduled. The default value is 5 minutes, and the maximum allowed value is also 5 minutes.
-
-> [!NOTE]
-> Reducing the minimum deletion delay below 5 minutes can be useful for testing or for ensuring rapid cleanup of short-lived agent sessions. However, this can also increase the load on the system and should be used with caution.
-
-### Default values
-
-- **Default TTL**: 14 days
-- **Minimum TTL deletion delay**: 5 minutes (maximum allowed value, subject to change in future releases)
-
-### Configuration examples
-
-#### .NET
-
-```csharp
-// Configure global default TTL and minimum signal delay
-services.ConfigureDurableAgents(
-    options =>
-    {
-        // Set global default TTL to 7 days
-        options.DefaultTimeToLive = TimeSpan.FromDays(7);
-
-        // Add agents (will use global default TTL)
-        options.AddAIAgent(myAgent);
-    });
-
-// Configure per-agent TTL
-services.ConfigureDurableAgents(
-    options =>
-    {
-        options.DefaultTimeToLive = TimeSpan.FromDays(14); // Global default
-        
-        // Agent with custom TTL of 1 day
-        options.AddAIAgent(shortLivedAgent, timeToLive: TimeSpan.FromDays(1));
-        
-        // Agent with custom TTL of 90 days
-        options.AddAIAgent(longLivedAgent, timeToLive: TimeSpan.FromDays(90));
-        
-        // Agent using global default (14 days)
-        options.AddAIAgent(defaultAgent);
-    });
-
-// Disable TTL for specific agents by setting TTL to null
-services.ConfigureDurableAgents(
-    options =>
-    {
-        options.DefaultTimeToLive = TimeSpan.FromDays(14);
-        
-        // Agent with no TTL (never expires)
-        options.AddAIAgent(permanentAgent, timeToLive: null);
-    });
-```
-
-## How TTL works
-
-The following sections describe how TTL works in detail.
-
-### Expiration tracking
-
-Each agent session maintains an expiration timestamp in its internally managed state that is updated whenever the session processes a message:
-
-1. When a message is sent to an agent session, the expiration time is set to `current time + TTL`
-2. The runtime schedules a delete operation for the expiration time (subject to minimum delay constraints)
-3. When the delete operation runs, if the current time is past the expiration time, the session state is deleted. Otherwise, the delete operation is rescheduled for the next expiration time.
-
-### State deletion
-
-When an agent session expires, its entire state is deleted, including:
-
-- Conversation history
-- Any custom state data
-- Expiration timestamps
-
-After deletion, if a message is sent to the same agent session, a new session is created with a fresh conversation history.
-
-## Behavior examples
-
-The following examples illustrate how TTL works in different scenarios.
-
-### Example 1: Agent session expires after TTL
-
-1. Agent configured with 30-day TTL
-2. User sends message at Day 0 → agent session created, expiration set to Day 30
-3. No further messages sent
-4. At Day 30 → Agent session is deleted
-5. User sends message at Day 31 → New agent session created with fresh conversation history
-
-### Example 2: TTL reset on interaction
-
-1. Agent configured with 30-day TTL
-2. User sends message at Day 0 → agent session created, expiration set to Day 30
-3. User sends message at Day 15 → Expiration reset to Day 45
-4. User sends message at Day 40 → Expiration reset to Day 70
-5. Agent session remains active as long as there are regular interactions
-
-## Logging
-
-The TTL feature includes comprehensive logging to track state changes:
-
-- **Expiration time updated**: Logged when TTL expiration time is set or updated
-- **Deletion scheduled**: Logged when a deletion check signal is scheduled
-- **Deletion check**: Logged when a deletion check operation runs
-- **Session expired**: Logged when an agent session is deleted due to expiration
-- **TTL rescheduled**: Logged when a deletion signal is rescheduled
-
-These logs help monitor TTL behavior and troubleshoot any issues.
-
-## Best practices
-
-1. **Choose appropriate TTL values**: Balance between storage costs and user experience. Too short TTLs may delete active sessions, while too long TTLs may accumulate unnecessary state.
-
-2. **Use per-agent TTLs**: Different agents may have different usage patterns. Configure TTLs per-agent based on expected session lifetimes.
-
-3. **Monitor expiration logs**: Review logs to understand TTL behavior and adjust configuration as needed.
-
-4. **Test with short TTLs**: During development, use short TTLs (e.g., minutes) to verify TTL behavior without waiting for long periods.
-
-## Limitations
-
-- TTL is based on wall-clock time, not activity time. The expiration timer starts from the last message timestamp.
-- Deletion checks are durably scheduled operations and may have slight delays depending on system load.
-- Once an agent session is deleted, its conversation history cannot be recovered.
-- TTL deletion requires at least one worker to be available to process the deletion operation message.

dotnet/Directory.Packages.props

@@ -134,22 +134,6 @@
     <PackageVersion Include="Microsoft.Agents.ObjectModel.Json" Version="2026.2.4.1" />
     <PackageVersion Include="Microsoft.Agents.ObjectModel.PowerFx" Version="2026.2.4.1" />
     <PackageVersion Include="Microsoft.PowerFx.Interpreter" Version="1.8.1" />
-    <!-- Durable Task -->
-    <PackageVersion Include="Microsoft.DurableTask.Client" Version="1.18.0" />
-    <PackageVersion Include="Microsoft.DurableTask.Client.AzureManaged" Version="1.18.0" />
-    <PackageVersion Include="Microsoft.DurableTask.Worker" Version="1.18.0" />
-    <PackageVersion Include="Microsoft.DurableTask.Worker.AzureManaged" Version="1.18.0" />
-    <!-- Azure Functions -->
-    <PackageVersion Include="Microsoft.Azure.Functions.Worker" Version="2.50.0" />
-    <PackageVersion Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask" Version="1.12.1" />
-    <PackageVersion Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask.AzureManaged" Version="1.0.1" />
-    <PackageVersion Include="Microsoft.Azure.Functions.Worker.Extensions.Http" Version="3.3.0" />
-    <PackageVersion Include="Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore" Version="2.1.0" />
-    <PackageVersion Include="Microsoft.Azure.Functions.Worker.Extensions.Mcp" Version="1.0.0" />
-    <PackageVersion Include="Microsoft.Azure.Functions.Worker.Sdk" Version="2.0.7" />
-    <!-- Valkey -->
-    <!-- Redis -->
-    <PackageVersion Include="StackExchange.Redis" Version="2.10.1" />
     <!-- Valkey -->
     <PackageVersion Include="Valkey.Glide" Version="1.1.0" />
     <!-- Console UX -->

dotnet/agent-framework-dotnet.slnx

@@ -15,7 +15,6 @@
     <Project Path="samples/01-get-started/03_multi_turn/03_multi_turn.csproj" />
     <Project Path="samples/01-get-started/04_memory/04_memory.csproj" />
     <Project Path="samples/01-get-started/05_first_workflow/05_first_workflow.csproj" />
-    <Project Path="samples/01-get-started/06_host_your_agent/06_host_your_agent.csproj" />
   </Folder>
   <Folder Name="/Samples/02-agents/">
     <File Path="samples/02-agents/README.md" />
@@ -73,24 +72,6 @@
   <Folder Name="/Samples/02-agents/DeclarativeAgents/">
     <Project Path="samples/02-agents/DeclarativeAgents/ChatClient/DeclarativeChatClientAgents.csproj" />
   </Folder>
-  <Folder Name="/Samples/04-hosting/DurableWorkflows/" />
-  <Folder Name="/Samples/04-hosting/DurableWorkflows/ConsoleApps/">
-    <Project Path="samples/04-hosting/DurableWorkflows/ConsoleApps/01_SequentialWorkflow/01_SequentialWorkflow.csproj" />
-    <Project Path="samples/04-hosting/DurableWorkflows/ConsoleApps/02_ConcurrentWorkflow/02_ConcurrentWorkflow.csproj" />
-    <Project Path="samples/04-hosting/DurableWorkflows/ConsoleApps/03_ConditionalEdges/03_ConditionalEdges.csproj" />
-    <Project Path="samples/04-hosting/DurableWorkflows/ConsoleApps/04_WorkflowAndAgents/04_WorkflowAndAgents.csproj" />
-    <Project Path="samples/04-hosting/DurableWorkflows/ConsoleApps/05_WorkflowEvents/05_WorkflowEvents.csproj" />
-    <Project Path="samples/04-hosting/DurableWorkflows/ConsoleApps/06_WorkflowSharedState/06_WorkflowSharedState.csproj" />
-    <Project Path="samples/04-hosting/DurableWorkflows/ConsoleApps/07_SubWorkflows/07_SubWorkflows.csproj" />
-    <Project Path="samples/04-hosting/DurableWorkflows/ConsoleApps/08_WorkflowHITL/08_WorkflowHITL.csproj" />
-  </Folder>
-  <Folder Name="/Samples/04-hosting/DurableWorkflows/AzureFunctions/">
-    <Project Path="samples/04-hosting/DurableWorkflows/AzureFunctions/01_SequentialWorkflow/01_SequentialWorkflow.csproj" />
-    <Project Path="samples/04-hosting/DurableWorkflows/AzureFunctions/02_ConcurrentWorkflow/02_ConcurrentWorkflow.csproj" />
-    <Project Path="samples/04-hosting/DurableWorkflows/AzureFunctions/03_WorkflowHITL/03_WorkflowHITL.csproj" />
-    <Project Path="samples/04-hosting/DurableWorkflows/AzureFunctions/04_WorkflowMcpTool/04_WorkflowMcpTool.csproj" />
-    <Project Path="samples/04-hosting/DurableWorkflows/AzureFunctions/05_WorkflowAndAgents/05_WorkflowAndAgents.csproj" />
-  </Folder>
   <Folder Name="/Samples/GettingStarted/">
     <File Path="samples/GettingStarted/README.md" />
   </Folder>
@@ -401,29 +382,6 @@
   <Folder Name="/Samples/04-hosting/FoundryHostedAgents/responses/Hosted-AgentSkills/">
     <Project Path="samples/04-hosting/FoundryHostedAgents/responses/Hosted-AgentSkills/HostedAgentSkills.csproj" />
   </Folder>
-  <Folder Name="/Samples/04-hosting/DurableAgents/" />
-  <Folder Name="/Samples/04-hosting/DurableAgents/AzureFunctions/">
-    <File Path="samples/04-hosting/DurableAgents/AzureFunctions/.editorconfig" />
-    <File Path="samples/04-hosting/DurableAgents/AzureFunctions/README.md" />
-    <Project Path="samples/04-hosting/DurableAgents/AzureFunctions/01_SingleAgent/01_SingleAgent.csproj" />
-    <Project Path="samples/04-hosting/DurableAgents/AzureFunctions/02_AgentOrchestration_Chaining/02_AgentOrchestration_Chaining.csproj" />
-    <Project Path="samples/04-hosting/DurableAgents/AzureFunctions/03_AgentOrchestration_Concurrency/03_AgentOrchestration_Concurrency.csproj" />
-    <Project Path="samples/04-hosting/DurableAgents/AzureFunctions/04_AgentOrchestration_Conditionals/04_AgentOrchestration_Conditionals.csproj" />
-    <Project Path="samples/04-hosting/DurableAgents/AzureFunctions/05_AgentOrchestration_HITL/05_AgentOrchestration_HITL.csproj" />
-    <Project Path="samples/04-hosting/DurableAgents/AzureFunctions/06_LongRunningTools/06_LongRunningTools.csproj" />
-    <Project Path="samples/04-hosting/DurableAgents/AzureFunctions/07_AgentAsMcpTool/07_AgentAsMcpTool.csproj" />
-    <Project Path="samples/04-hosting/DurableAgents/AzureFunctions/08_ReliableStreaming/08_ReliableStreaming.csproj" />
-  </Folder>
-  <Folder Name="/Samples/04-hosting/DurableAgents/ConsoleApps/">
-    <File Path="samples/04-hosting/DurableAgents/ConsoleApps/README.md" />
-    <Project Path="samples/04-hosting/DurableAgents/ConsoleApps/01_SingleAgent/01_SingleAgent.csproj" />
-    <Project Path="samples/04-hosting/DurableAgents/ConsoleApps/02_AgentOrchestration_Chaining/02_AgentOrchestration_Chaining.csproj" />
-    <Project Path="samples/04-hosting/DurableAgents/ConsoleApps/03_AgentOrchestration_Concurrency/03_AgentOrchestration_Concurrency.csproj" />
-    <Project Path="samples/04-hosting/DurableAgents/ConsoleApps/04_AgentOrchestration_Conditionals/04_AgentOrchestration_Conditionals.csproj" />
-    <Project Path="samples/04-hosting/DurableAgents/ConsoleApps/05_AgentOrchestration_HITL/05_AgentOrchestration_HITL.csproj" />
-    <Project Path="samples/04-hosting/DurableAgents/ConsoleApps/06_LongRunningTools/06_LongRunningTools.csproj" />
-    <Project Path="samples/04-hosting/DurableAgents/ConsoleApps/07_ReliableStreaming/07_ReliableStreaming.csproj" />
-  </Folder>
   <Folder Name="/Samples/02-agents/A2A/">
     <File Path="samples/02-agents/A2A/README.md" />
     <Project Path="samples/02-agents/A2A/A2AAgent_AsFunctionTools/A2AAgent_AsFunctionTools.csproj" />
@@ -633,7 +591,6 @@
     <Project Path="src/Microsoft.Agents.AI.CosmosNoSql/Microsoft.Agents.AI.CosmosNoSql.csproj" />
     <Project Path="src/Microsoft.Agents.AI.Declarative/Microsoft.Agents.AI.Declarative.csproj" />
     <Project Path="src/Microsoft.Agents.AI.DevUI/Microsoft.Agents.AI.DevUI.csproj" />
-    <Project Path="src/Microsoft.Agents.AI.DurableTask/Microsoft.Agents.AI.DurableTask.csproj" />
     <Project Path="src/Microsoft.Agents.AI.Foundry.Hosting/Microsoft.Agents.AI.Foundry.Hosting.csproj" />
     <Project Path="src/Microsoft.Agents.AI.Foundry/Microsoft.Agents.AI.Foundry.csproj" />
     <Project Path="src/Microsoft.Agents.AI.GitHub.Copilot/Microsoft.Agents.AI.GitHub.Copilot.csproj" />
@@ -642,7 +599,6 @@
     <Project Path="src/Microsoft.Agents.AI.Hosting.A2A/Microsoft.Agents.AI.Hosting.A2A.csproj" />
     <Project Path="src/Microsoft.Agents.AI.Hosting.AGUI.AspNetCore/Microsoft.Agents.AI.Hosting.AGUI.AspNetCore.csproj" />
     <Project Path="src/Microsoft.Agents.AI.Hosting.AspNetCore/Microsoft.Agents.AI.Hosting.AspNetCore.csproj" />
-    <Project Path="src/Microsoft.Agents.AI.Hosting.AzureFunctions/Microsoft.Agents.AI.Hosting.AzureFunctions.csproj" />
     <Project Path="src/Microsoft.Agents.AI.Hosting.OpenAI/Microsoft.Agents.AI.Hosting.OpenAI.csproj" />
     <Project Path="src/Microsoft.Agents.AI.Hosting/Microsoft.Agents.AI.Hosting.csproj" />
     <Project Path="src/Microsoft.Agents.AI.Hyperlight/Microsoft.Agents.AI.Hyperlight.csproj" />
@@ -671,10 +627,8 @@
     <Project Path="tests/Foundry.Hosting.IntegrationTests.TestContainer/Foundry.Hosting.IntegrationTests.TestContainer.csproj" />
     <Project Path="tests/Foundry.Hosting.IntegrationTests/Foundry.Hosting.IntegrationTests.csproj" />
     <Project Path="tests/Foundry.IntegrationTests/Foundry.IntegrationTests.csproj" />
-    <Project Path="tests/Microsoft.Agents.AI.DurableTask.IntegrationTests/Microsoft.Agents.AI.DurableTask.IntegrationTests.csproj" />
     <Project Path="tests/Microsoft.Agents.AI.GitHub.Copilot.IntegrationTests/Microsoft.Agents.AI.GitHub.Copilot.IntegrationTests.csproj" />
     <Project Path="tests/Microsoft.Agents.AI.Hosting.AGUI.AspNetCore.IntegrationTests/Microsoft.Agents.AI.Hosting.AGUI.AspNetCore.IntegrationTests.csproj" />
-    <Project Path="tests/Microsoft.Agents.AI.Hosting.AzureFunctions.IntegrationTests/Microsoft.Agents.AI.Hosting.AzureFunctions.IntegrationTests.csproj" />
     <Project Path="tests/Microsoft.Agents.AI.Hyperlight.IntegrationTests/Microsoft.Agents.AI.Hyperlight.IntegrationTests.csproj" />
     <Project Path="tests/Microsoft.Agents.AI.Mem0.IntegrationTests/Microsoft.Agents.AI.Mem0.IntegrationTests.csproj" />
     <Project Path="tests/Microsoft.Agents.AI.Tools.Shell.IntegrationTests/Microsoft.Agents.AI.Tools.Shell.IntegrationTests.csproj" />
@@ -692,14 +646,12 @@
     <Project Path="tests/Microsoft.Agents.AI.CosmosNoSql.UnitTests/Microsoft.Agents.AI.CosmosNoSql.UnitTests.csproj" />
     <Project Path="tests/Microsoft.Agents.AI.Declarative.UnitTests/Microsoft.Agents.AI.Declarative.UnitTests.csproj" />
     <Project Path="tests/Microsoft.Agents.AI.DevUI.UnitTests/Microsoft.Agents.AI.DevUI.UnitTests.csproj" />
-    <Project Path="tests/Microsoft.Agents.AI.DurableTask.UnitTests/Microsoft.Agents.AI.DurableTask.UnitTests.csproj" />
     <Project Path="tests/Microsoft.Agents.AI.Foundry.Hosting.UnitTests/Microsoft.Agents.AI.Foundry.Hosting.UnitTests.csproj" />
     <Project Path="tests/Microsoft.Agents.AI.Foundry.UnitTests/Microsoft.Agents.AI.Foundry.UnitTests.csproj" />
     <Project Path="tests/Microsoft.Agents.AI.GitHub.Copilot.UnitTests/Microsoft.Agents.AI.GitHub.Copilot.UnitTests.csproj" />
     <Project Path="tests/Microsoft.Agents.AI.Harness.UnitTests/Microsoft.Agents.AI.Harness.UnitTests.csproj" />
     <Project Path="tests/Microsoft.Agents.AI.Hosting.A2A.UnitTests/Microsoft.Agents.AI.Hosting.A2A.UnitTests.csproj" />
     <Project Path="tests/Microsoft.Agents.AI.Hosting.AGUI.AspNetCore.UnitTests/Microsoft.Agents.AI.Hosting.AGUI.AspNetCore.UnitTests.csproj" />
-    <Project Path="tests/Microsoft.Agents.AI.Hosting.AzureFunctions.UnitTests/Microsoft.Agents.AI.Hosting.AzureFunctions.UnitTests.csproj" />
     <Project Path="tests/Microsoft.Agents.AI.Hosting.OpenAI.UnitTests/Microsoft.Agents.AI.Hosting.OpenAI.UnitTests.csproj" />
     <Project Path="tests/Microsoft.Agents.AI.Hosting.UnitTests/Microsoft.Agents.AI.Hosting.UnitTests.csproj" />
     <Project Path="tests/Microsoft.Agents.AI.Hyperlight.UnitTests/Microsoft.Agents.AI.Hyperlight.UnitTests.csproj" />
@@ -718,4 +670,3 @@
   </Folder>
 </Solution>
 
-

dotnet/agent-framework-release.slnf

@@ -14,13 +14,11 @@
       "src\\Microsoft.Agents.AI.CosmosNoSql\\Microsoft.Agents.AI.CosmosNoSql.csproj",
       "src\\Microsoft.Agents.AI.Declarative\\Microsoft.Agents.AI.Declarative.csproj",
       "src\\Microsoft.Agents.AI.DevUI\\Microsoft.Agents.AI.DevUI.csproj",
-      "src\\Microsoft.Agents.AI.DurableTask\\Microsoft.Agents.AI.DurableTask.csproj",
 
       "src\\Microsoft.Agents.AI.Hosting.A2A.AspNetCore\\Microsoft.Agents.AI.Hosting.A2A.AspNetCore.csproj",
       "src\\Microsoft.Agents.AI.Hosting.A2A\\Microsoft.Agents.AI.Hosting.A2A.csproj",
       "src\\Microsoft.Agents.AI.Hosting.AGUI.AspNetCore\\Microsoft.Agents.AI.Hosting.AGUI.AspNetCore.csproj",
       "src\\Microsoft.Agents.AI.Hosting.AspNetCore\\Microsoft.Agents.AI.Hosting.AspNetCore.csproj",
-      "src\\Microsoft.Agents.AI.Hosting.AzureFunctions\\Microsoft.Agents.AI.Hosting.AzureFunctions.csproj",      
       "src\\Microsoft.Agents.AI.Hosting.OpenAI\\Microsoft.Agents.AI.Hosting.OpenAI.csproj",
       "src\\Microsoft.Agents.AI.Hosting\\Microsoft.Agents.AI.Hosting.csproj",
       "src\\Microsoft.Agents.AI.LocalCodeAct\\Microsoft.Agents.AI.LocalCodeAct.csproj",

dotnet/eng/scripts/New-FilteredSolution.ps1

@@ -26,7 +26,7 @@
     When specified, only test projects whose filename matches this pattern are kept.
 
 .PARAMETER TestProjectNameExcludeFilter
-    Optional wildcard pattern(s) to exclude test projects by name (e.g., *DurableTask.IntegrationTests*).
+    Optional wildcard pattern(s) to exclude test projects by name (e.g., *Slow.IntegrationTests*).
     When specified, test projects whose filename matches any of these patterns are removed.
     Applied after TestProjectNameIncludeFilter. Can be a single string or an array of strings.
 
@@ -50,8 +50,8 @@
     dotnet test --solution (./dotnet/eng/scripts/New-FilteredSolution.ps1 -Solution dotnet/agent-framework-dotnet.slnx -TargetFramework net472) --no-build -f net472
 
 .EXAMPLE
-    # Generate integration tests excluding DurableTask and AzureFunctions
-    ./dotnet/eng/scripts/New-FilteredSolution.ps1 -Solution dotnet/agent-framework-dotnet.slnx -TargetFramework net10.0 -TestProjectNameIncludeFilter "*IntegrationTests*" -TestProjectNameExcludeFilter "*DurableTask.IntegrationTests*","*AzureFunctions.IntegrationTests*" -OutputPath filtered-other-integration.slnx
+    # Generate integration tests while excluding a long-running test project
+    ./dotnet/eng/scripts/New-FilteredSolution.ps1 -Solution dotnet/agent-framework-dotnet.slnx -TargetFramework net10.0 -TestProjectNameIncludeFilter "*IntegrationTests*" -TestProjectNameExcludeFilter "*Slow.IntegrationTests*" -OutputPath filtered-integration.slnx
 #>
 
 [CmdletBinding()]

dotnet/eng/verify-samples/GetStartedSamples.cs

@@ -92,14 +92,5 @@ internal static class GetStartedSamples
                 "The output should not contain error messages or stack traces.",
             ],
         },
-
-        new SampleDefinition
-        {
-            Name = "06_host_your_agent",
-            ProjectPath = "samples/01-get-started/06_host_your_agent",
-            RequiredEnvironmentVariables = ["FOUNDRY_PROJECT_ENDPOINT"],
-            OptionalEnvironmentVariables = ["FOUNDRY_MODEL"],
-            SkipReason = "Requires Azure Functions Core Tools runtime and starts a web server.",
-        },
     ];
 }

dotnet/samples/01-get-started/06_host_your_agent/06_host_your_agent.csproj

@@ -1,30 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-  <PropertyGroup>
-    <OutputType>Exe</OutputType>
-    <TargetFrameworks>net10.0</TargetFrameworks>
-    <AzureFunctionsVersion>v4</AzureFunctionsVersion>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-    <!-- The Functions build tools don't like namespaces that start with a number -->
-    <AssemblyName>HostedAgent</AssemblyName>
-    <RootNamespace>HostedAgent</RootNamespace>
-  </PropertyGroup>
-  <ItemGroup>
-    <FrameworkReference Include="Microsoft.AspNetCore.App" />
-  </ItemGroup>
-  <!-- Azure Functions packages -->
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Azure.Functions.Worker" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask.AzureManaged" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" />
-  </ItemGroup>
-  <ItemGroup>
-    <PackageReference Include="Azure.Identity" />
-  </ItemGroup>
-  <ItemGroup>
-    <ProjectReference Include="..\..\..\src\Microsoft.Agents.AI.Hosting.AzureFunctions\Microsoft.Agents.AI.Hosting.AzureFunctions.csproj" />
-    <ProjectReference Include="..\..\..\src\Microsoft.Agents.AI.Foundry\Microsoft.Agents.AI.Foundry.csproj" />
-  </ItemGroup>
-</Project>

dotnet/samples/01-get-started/06_host_your_agent/Program.cs

@@ -1,41 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-// This sample shows how to host an AI agent with Azure Functions (DurableAgents).
-//
-// Prerequisites:
-//   - Azure Functions Core Tools
-//   - Foundry project endpoint and credentials
-//
-// Environment variables:
-//   FOUNDRY_PROJECT_ENDPOINT
-//   FOUNDRY_MODEL (defaults to "gpt-5.4-mini")
-//
-// Run with: func start
-// Then call: POST http://localhost:7071/api/agents/HostedAgent/run
-
-using Azure.AI.Projects;
-using Azure.Identity;
-using Microsoft.Agents.AI;
-using Microsoft.Agents.AI.Hosting.AzureFunctions;
-using Microsoft.Azure.Functions.Worker.Builder;
-using Microsoft.Extensions.Hosting;
-
-var endpoint = Environment.GetEnvironmentVariable("FOUNDRY_PROJECT_ENDPOINT")
-    ?? throw new InvalidOperationException("FOUNDRY_PROJECT_ENDPOINT is not set.");
-var model = Environment.GetEnvironmentVariable("FOUNDRY_MODEL") ?? "gpt-5.4-mini";
-
-// Set up an AI agent following the standard Microsoft Agent Framework pattern.
-// WARNING: DefaultAzureCredential is convenient for development but requires careful consideration in production.
-// In production, consider using a specific credential (e.g., ManagedIdentityCredential) to avoid
-// latency issues, unintended credential probing, and potential security risks from fallback mechanisms.
-AIAgent agent = new AIProjectClient(new Uri(endpoint), new DefaultAzureCredential())
-    .AsAIAgent(model: model, instructions: "You are a helpful assistant hosted in Azure Functions.", name: "HostedAgent");
-
-// Configure the function app to host the AI agent.
-// This will automatically generate HTTP API endpoints for the agent.
-using IHost app = FunctionsApplication
-    .CreateBuilder(args)
-    .ConfigureFunctionsWebApplication()
-    .ConfigureDurableAgents(options => options.AddAIAgent(agent, timeToLive: TimeSpan.FromHours(1)))
-    .Build();
-app.Run();

dotnet/samples/01-get-started/06_host_your_agent/README.md

@@ -0,0 +1,3 @@
+# Azure Functions Hosting Sample Has Moved
+
+The Azure Functions hosting tutorial is now maintained as the [single-agent Durable Agent sample](https://github.com/microsoft/agent-framework-durable-extension/tree/main/dotnet/samples/DurableAgents/AzureFunctions/01_SingleAgent).

dotnet/samples/03-workflows/Orchestration/Handoff/Program.cs

@@ -59,6 +59,10 @@ static async Task RunWorkflowAsync(Workflow workflow)
         }
 
         await run.TrySendMessageAsync(userInput);
+
+        // Agents are wrapped as executors that cache incoming messages and only run when they receive a TurnToken,
+        // so the turn must be triggered explicitly after sending the user input.
+        await run.TrySendMessageAsync(new TurnToken(emitEvents: true));
         string? speakingAgent = null;
         await foreach (WorkflowEvent evt in run.WatchStreamAsync(cts.Token))
         {

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/.editorconfig

@@ -1,10 +0,0 @@
-# .editorconfig
-[*.cs]
-
-# See https://github.com/Azure/azure-functions-durable-extension/issues/3173
-dotnet_diagnostic.DURABLE0001.severity = none
-dotnet_diagnostic.DURABLE0002.severity = none
-dotnet_diagnostic.DURABLE0003.severity = none
-dotnet_diagnostic.DURABLE0004.severity = none
-dotnet_diagnostic.DURABLE0005.severity = none
-dotnet_diagnostic.DURABLE0006.severity = none

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/01_SingleAgent/01_SingleAgent.csproj

@@ -1,42 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-  <PropertyGroup>
-    <TargetFrameworks>net10.0</TargetFrameworks>
-    <AzureFunctionsVersion>v4</AzureFunctionsVersion>
-    <OutputType>Exe</OutputType>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-    <!-- The Functions build tools don't like namespaces that start with a number -->
-    <AssemblyName>SingleAgent</AssemblyName>
-    <RootNamespace>SingleAgent</RootNamespace>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <FrameworkReference Include="Microsoft.AspNetCore.App" />
-  </ItemGroup>
-
-  <!-- Azure Functions packages -->
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Azure.Functions.Worker" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask.AzureManaged" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" />
-  </ItemGroup>
-
-  <ItemGroup>
-    <PackageReference Include="Azure.AI.OpenAI" />
-    <PackageReference Include="Azure.Identity" />
-  </ItemGroup>
-
-  <!-- Local projects that should be switched to package references when using the sample outside of this MAF repo -->
-  <!--
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Agents.AI.Hosting.AzureFunctions" />
-    <PackageReference Include="Microsoft.Agents.AI.OpenAI" />
-  </ItemGroup>
-  -->
-  <ItemGroup>
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.Hosting.AzureFunctions\Microsoft.Agents.AI.Hosting.AzureFunctions.csproj" />
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.OpenAI\Microsoft.Agents.AI.OpenAI.csproj" />
-  </ItemGroup>
-</Project>

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/01_SingleAgent/Program.cs

@@ -1,42 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-#pragma warning disable IDE0002 // Simplify Member Access
-
-using Azure;
-using Azure.AI.OpenAI;
-using Azure.Identity;
-using Microsoft.Agents.AI;
-using Microsoft.Agents.AI.Hosting.AzureFunctions;
-using Microsoft.Azure.Functions.Worker.Builder;
-using Microsoft.Extensions.Hosting;
-using OpenAI.Chat;
-
-// Get the Azure OpenAI endpoint and deployment name from environment variables.
-string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_ENDPOINT is not set.");
-string deploymentName = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT_NAME")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_DEPLOYMENT_NAME is not set.");
-
-// Use Azure Key Credential if provided, otherwise use Azure CLI Credential.
-string? azureOpenAiKey = System.Environment.GetEnvironmentVariable("AZURE_OPENAI_KEY");
-// WARNING: DefaultAzureCredential is convenient for development but requires careful consideration in production.
-// In production, consider using a specific credential (e.g., ManagedIdentityCredential) to avoid
-// latency issues, unintended credential probing, and potential security risks from fallback mechanisms.
-AzureOpenAIClient client = !string.IsNullOrEmpty(azureOpenAiKey)
-    ? new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(azureOpenAiKey))
-    : new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential());
-
-// Set up an AI agent following the standard Microsoft Agent Framework pattern.
-const string JokerName = "Joker";
-const string JokerInstructions = "You are good at telling jokes.";
-
-AIAgent agent = client.GetChatClient(deploymentName).AsAIAgent(JokerInstructions, JokerName);
-
-// Configure the function app to host the AI agent.
-// This will automatically generate HTTP API endpoints for the agent.
-using IHost app = FunctionsApplication
-    .CreateBuilder(args)
-    .ConfigureFunctionsWebApplication()
-    .ConfigureDurableAgents(options => options.AddAIAgent(agent, timeToLive: TimeSpan.FromHours(1)))
-    .Build();
-app.Run();

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/01_SingleAgent/README.md

@@ -1,89 +0,0 @@
-# Single Agent Sample
-
-This sample demonstrates how to use the Durable Agent Framework (DAFx) to create a simple Azure Functions app that hosts a single AI agent and provides direct HTTP API access for interactive conversations.
-
-## Key Concepts Demonstrated
-
-- Using the Microsoft Agent Framework to define a simple AI agent with a name and instructions.
-- Registering agents with the Function app and running them using HTTP.
-- Conversation management (via session IDs) for isolated interactions.
-
-## Environment Setup
-
-See the [README.md](../README.md) file in the parent directory for more information on how to configure the environment, including how to install and run common sample dependencies.
-
-## Running the Sample
-
-With the environment setup and function app running, you can test the sample by sending an HTTP request to the agent endpoint.
-
-You can use the `demo.http` file to send a message to the agent, or a command line tool like `curl` as shown below:
-
-Bash (Linux/macOS/WSL):
-
-```bash
-curl -X POST http://localhost:7071/api/agents/Joker/run \
-    -H "Content-Type: text/plain" \
-    -d "Tell me a joke about a pirate."
-```
-
-PowerShell:
-
-```powershell
-Invoke-RestMethod -Method Post `
-    -Uri http://localhost:7071/api/agents/Joker/run `
-    -ContentType text/plain `
-    -Body "Tell me a joke about a pirate."
-```
-
-You can also send JSON requests:
-
-```bash
-curl -X POST http://localhost:7071/api/agents/Joker/run \
-    -H "Content-Type: application/json" \
-    -H "Accept: application/json" \
-    -d '{"message": "Tell me a joke about a pirate."}'
-```
-
-To continue a conversation, include the `thread_id` in the query string or JSON body:
-
-```bash
-curl -X POST "http://localhost:7071/api/agents/Joker/run?thread_id=your-thread-id" \
-    -H "Content-Type: application/json" \
-    -H "Accept: application/json" \
-    -d '{"message": "Tell me another one."}'
-```
-
-The response from the agent will be displayed in the terminal where you ran `func start`. The expected `text/plain` output will look something like:
-
-```text
-Why don't pirates ever learn the alphabet? Because they always get stuck at "C"!
-```
-
-The expected `application/json` output will look something like:
-
-```json
-{
-  "status": 200,
-  "thread_id": "ee6e47a0-f24b-40b1-ade8-16fcebb9eb40",
-  "response": {
-    "Messages": [
-      {
-        "AuthorName": "Joker",
-        "CreatedAt": "2025-11-11T12:00:00.0000000Z",
-        "Role": "assistant",
-        "Contents": [
-          {
-            "Type": "text",
-            "Text": "Why don't pirates ever learn the alphabet? Because they always get stuck at 'C'!"
-          }
-        ]
-      }
-    ],
-    "Usage": {
-      "InputTokenCount": 78,
-      "OutputTokenCount": 36,
-      "TotalTokenCount": 114
-    }
-  }
-}
-```

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/01_SingleAgent/demo.http

@@ -1,8 +0,0 @@
-# Default endpoint address for local testing
-@authority=http://localhost:7071
-
-### Prompt the agent
-POST {{authority}}/api/agents/Joker/run
-Content-Type: text/plain
-
-Tell me a joke about a pirate.

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/01_SingleAgent/host.json

@@ -1,20 +0,0 @@
-{
-  "version": "2.0",
-  "logging": {
-    "logLevel": {
-      "Microsoft.Agents.AI.DurableTask": "Information",
-      "Microsoft.Agents.AI.Hosting.AzureFunctions": "Information",
-      "DurableTask": "Information",
-      "Microsoft.DurableTask": "Information"
-    }
-  },
-  "extensions": {
-    "durableTask": {
-      "hubName": "default",
-      "storageProvider": {
-        "type": "AzureManaged",
-        "connectionStringName": "DURABLE_TASK_SCHEDULER_CONNECTION_STRING"
-      }
-    }
-  }
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/02_AgentOrchestration_Chaining/02_AgentOrchestration_Chaining.csproj

@@ -1,42 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-  <PropertyGroup>
-    <TargetFrameworks>net10.0</TargetFrameworks>
-    <AzureFunctionsVersion>v4</AzureFunctionsVersion>
-    <OutputType>Exe</OutputType>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-    <!-- The Functions build tools don't like namespaces that start with a number -->
-    <AssemblyName>AgentOrchestration_Chaining</AssemblyName>
-    <RootNamespace>AgentOrchestration_Chaining</RootNamespace>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <FrameworkReference Include="Microsoft.AspNetCore.App" />
-  </ItemGroup>
-
-  <!-- Azure Functions packages -->
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Azure.Functions.Worker" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask.AzureManaged" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" />
-  </ItemGroup>
-
-  <ItemGroup>
-    <PackageReference Include="Azure.AI.OpenAI" />
-    <PackageReference Include="Azure.Identity" />
-  </ItemGroup>
-
-  <!-- Local projects that should be switched to package references when using the sample outside of this MAF repo -->
-  <!--
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Agents.AI.Hosting.AzureFunctions" />
-    <PackageReference Include="Microsoft.Agents.AI.OpenAI" />
-  </ItemGroup>
-  -->
-  <ItemGroup>
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.Hosting.AzureFunctions\Microsoft.Agents.AI.Hosting.AzureFunctions.csproj" />
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.OpenAI\Microsoft.Agents.AI.OpenAI.csproj" />
-  </ItemGroup>
-</Project>

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/02_AgentOrchestration_Chaining/FunctionTriggers.cs

@@ -1,92 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-using System.Net;
-using System.Text.Json;
-using Microsoft.Agents.AI;
-using Microsoft.Agents.AI.DurableTask;
-using Microsoft.Azure.Functions.Worker;
-using Microsoft.Azure.Functions.Worker.Http;
-using Microsoft.DurableTask;
-using Microsoft.DurableTask.Client;
-
-namespace AgentOrchestration_Chaining;
-
-public static class FunctionTriggers
-{
-    public sealed record TextResponse(string Text);
-
-    [Function(nameof(RunOrchestrationAsync))]
-    public static async Task<string> RunOrchestrationAsync([OrchestrationTrigger] TaskOrchestrationContext context)
-    {
-        DurableAIAgent writer = context.GetAgent("WriterAgent");
-        AgentSession writerSession = await writer.CreateSessionAsync();
-
-        AgentResponse<TextResponse> initial = await writer.RunAsync<TextResponse>(
-            message: "Write a concise inspirational sentence about learning.",
-            session: writerSession);
-
-        AgentResponse<TextResponse> refined = await writer.RunAsync<TextResponse>(
-            message: $"Improve this further while keeping it under 25 words: {initial.Result.Text}",
-            session: writerSession);
-
-        return refined.Result.Text;
-    }
-
-    // POST /singleagent/run
-    [Function(nameof(StartOrchestrationAsync))]
-    public static async Task<HttpResponseData> StartOrchestrationAsync(
-        [HttpTrigger(AuthorizationLevel.Anonymous, "post", Route = "singleagent/run")] HttpRequestData req,
-        [DurableClient] DurableTaskClient client)
-    {
-        string instanceId = await client.ScheduleNewOrchestrationInstanceAsync(
-            orchestratorName: nameof(RunOrchestrationAsync));
-
-        HttpResponseData response = req.CreateResponse(HttpStatusCode.Accepted);
-        await response.WriteAsJsonAsync(new
-        {
-            message = "Single-agent orchestration started.",
-            instanceId,
-            statusQueryGetUri = GetStatusQueryGetUri(req, instanceId),
-        });
-        return response;
-    }
-
-    // GET /singleagent/status/{instanceId}
-    [Function(nameof(GetOrchestrationStatusAsync))]
-    public static async Task<HttpResponseData> GetOrchestrationStatusAsync(
-        [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = "singleagent/status/{instanceId}")] HttpRequestData req,
-        string instanceId,
-        [DurableClient] DurableTaskClient client)
-    {
-        OrchestrationMetadata? status = await client.GetInstanceAsync(
-            instanceId,
-            getInputsAndOutputs: true,
-            req.FunctionContext.CancellationToken);
-
-        if (status is null)
-        {
-            HttpResponseData notFound = req.CreateResponse(HttpStatusCode.NotFound);
-            await notFound.WriteAsJsonAsync(new { error = "Instance not found" });
-            return notFound;
-        }
-
-        HttpResponseData response = req.CreateResponse(HttpStatusCode.OK);
-        await response.WriteAsJsonAsync(new
-        {
-            instanceId = status.InstanceId,
-            runtimeStatus = status.RuntimeStatus.ToString(),
-            input = status.SerializedInput is not null ? (object)status.ReadInputAs<JsonElement>() : null,
-            output = status.SerializedOutput is not null ? (object)status.ReadOutputAs<JsonElement>() : null,
-            failureDetails = status.FailureDetails
-        });
-        return response;
-    }
-
-    private static string GetStatusQueryGetUri(HttpRequestData req, string instanceId)
-    {
-        // NOTE: This can be made more robust by considering the value of
-        //       request headers like "X-Forwarded-Host" and "X-Forwarded-Proto".
-        string authority = $"{req.Url.Scheme}://{req.Url.Authority}";
-        return $"{authority}/api/singleagent/status/{instanceId}";
-    }
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/02_AgentOrchestration_Chaining/Program.cs

@@ -1,45 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-#pragma warning disable IDE0002 // Simplify Member Access
-
-using Azure;
-using Azure.AI.OpenAI;
-using Azure.Identity;
-using Microsoft.Agents.AI;
-using Microsoft.Agents.AI.Hosting.AzureFunctions;
-using Microsoft.Azure.Functions.Worker.Builder;
-using Microsoft.Extensions.Hosting;
-using OpenAI.Chat;
-
-// Get the Azure OpenAI endpoint and deployment name from environment variables.
-string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_ENDPOINT is not set.");
-string deploymentName = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT_NAME")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_DEPLOYMENT_NAME is not set.");
-
-// Use Azure Key Credential if provided, otherwise use Azure CLI Credential.
-string? azureOpenAiKey = System.Environment.GetEnvironmentVariable("AZURE_OPENAI_API_KEY");
-// WARNING: DefaultAzureCredential is convenient for development but requires careful consideration in production.
-// In production, consider using a specific credential (e.g., ManagedIdentityCredential) to avoid
-// latency issues, unintended credential probing, and potential security risks from fallback mechanisms.
-AzureOpenAIClient client = !string.IsNullOrEmpty(azureOpenAiKey)
-    ? new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(azureOpenAiKey))
-    : new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential());
-
-// Single agent used by the orchestration to demonstrate sequential calls on the same session.
-const string WriterName = "WriterAgent";
-const string WriterInstructions =
-    """
-    You refine short pieces of text. When given an initial sentence you enhance it;
-    when given an improved sentence you polish it further.
-    """;
-
-AIAgent writerAgent = client.GetChatClient(deploymentName).AsAIAgent(WriterInstructions, WriterName);
-
-using IHost app = FunctionsApplication
-    .CreateBuilder(args)
-    .ConfigureFunctionsWebApplication()
-    .ConfigureDurableAgents(options => options.AddAIAgent(writerAgent))
-    .Build();
-
-app.Run();

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/02_AgentOrchestration_Chaining/README.md

@@ -1,59 +0,0 @@
-# Single Agent Orchestration Sample
-
-This sample demonstrates how to use the Durable Agent Framework (DAFx) to create a simple Azure Functions app that orchestrates sequential calls to a single AI agent using the same session for context continuity.
-
-## Key Concepts Demonstrated
-
-- Orchestrating multiple interactions with the same agent in a deterministic order
-- Using the same `AgentSession` across multiple calls to maintain conversational context
-- Durable orchestration with automatic checkpointing and resumption from failures
-- HTTP API integration for starting and monitoring orchestrations
-
-## Environment Setup
-
-See the [README.md](../README.md) file in the parent directory for more information on how to configure the environment, including how to install and run common sample dependencies.
-
-## Running the Sample
-
-With the environment setup and function app running, you can test the sample by sending an HTTP request to start the orchestration.
-
-You can use the `demo.http` file to start the orchestration, or a command line tool like `curl` as shown below:
-
-Bash (Linux/macOS/WSL):
-
-```bash
-curl -X POST http://localhost:7071/api/singleagent/run
-```
-
-PowerShell:
-
-```powershell
-Invoke-RestMethod -Method Post -Uri http://localhost:7071/api/singleagent/run
-```
-
-The response will be a JSON object that looks something like the following, which indicates that the orchestration has started.
-
-```json
-{
-  "message": "Single-agent orchestration started.",
-  "instanceId": "86313f1d45fb42eeb50b1852626bf3ff",
-  "statusQueryGetUri": "http://localhost:7071/api/singleagent/status/86313f1d45fb42eeb50b1852626bf3ff"
-}
-```
-
-The orchestration will proceed to run the WriterAgent twice in sequence:
-
-1. First, it writes an inspirational sentence about learning
-2. Then, it refines the initial output using the same conversation thread
-
-Once the orchestration has completed, you can get the status of the orchestration by sending a GET request to the `statusQueryGetUri` URL. The response will be a JSON object that looks something like the following:
-
-```json
-{
-    "failureDetails": null,
-    "input": null,
-    "instanceId": "86313f1d45fb42eeb50b1852626bf3ff",
-    "output": "Learning serves as the key, opening doors to boundless opportunities and a brighter future.",
-    "runtimeStatus": "Completed"
-}
-```

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/02_AgentOrchestration_Chaining/demo.http

@@ -1,3 +0,0 @@
-### Start the single-agent orchestration
-POST http://localhost:7071/api/singleagent/run
-

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/02_AgentOrchestration_Chaining/host.json

@@ -1,20 +0,0 @@
-{
-  "version": "2.0",
-  "logging": {
-    "logLevel": {
-      "Microsoft.Agents.AI.DurableTask": "Information",
-      "Microsoft.Agents.AI.Hosting.AzureFunctions": "Information",
-      "DurableTask": "Information",
-      "Microsoft.DurableTask": "Information"
-    }
-  },
-  "extensions": {
-    "durableTask": {
-      "hubName": "default",
-      "storageProvider": {
-        "type": "AzureManaged",
-        "connectionStringName": "DURABLE_TASK_SCHEDULER_CONNECTION_STRING"
-      }
-    }
-  }
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/03_AgentOrchestration_Concurrency/03_AgentOrchestration_Concurrency.csproj

@@ -1,42 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-  <PropertyGroup>
-    <TargetFrameworks>net10.0</TargetFrameworks>
-    <AzureFunctionsVersion>v4</AzureFunctionsVersion>
-    <OutputType>Exe</OutputType>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-    <!-- The Functions build tools don't like namespaces that start with a number -->
-    <AssemblyName>AgentOrchestration_Concurrency</AssemblyName>
-    <RootNamespace>AgentOrchestration_Concurrency</RootNamespace>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <FrameworkReference Include="Microsoft.AspNetCore.App" />
-  </ItemGroup>
-
-  <!-- Azure Functions packages -->
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Azure.Functions.Worker" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask.AzureManaged" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" />
-  </ItemGroup>
-
-  <ItemGroup>
-    <PackageReference Include="Azure.AI.OpenAI" />
-    <PackageReference Include="Azure.Identity" />
-  </ItemGroup>
-
-  <!-- Local projects that should be switched to package references when using the sample outside of this MAF repo -->
-  <!--
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Agents.AI.Hosting.AzureFunctions" />
-    <PackageReference Include="Microsoft.Agents.AI.OpenAI" />
-  </ItemGroup>
-  -->
-  <ItemGroup>
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.Hosting.AzureFunctions\Microsoft.Agents.AI.Hosting.AzureFunctions.csproj" />
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.OpenAI\Microsoft.Agents.AI.OpenAI.csproj" />
-  </ItemGroup>
-</Project>

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/03_AgentOrchestration_Concurrency/FunctionTriggers.cs

@@ -1,116 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-using System.Net;
-using System.Text.Json;
-using Microsoft.Agents.AI;
-using Microsoft.Agents.AI.DurableTask;
-using Microsoft.Azure.Functions.Worker;
-using Microsoft.Azure.Functions.Worker.Http;
-using Microsoft.DurableTask;
-using Microsoft.DurableTask.Client;
-
-namespace AgentOrchestration_Concurrency;
-
-public static class FunctionsTriggers
-{
-    public sealed record TextResponse(string Text);
-
-    [Function(nameof(RunOrchestrationAsync))]
-    public static async Task<object> RunOrchestrationAsync([OrchestrationTrigger] TaskOrchestrationContext context)
-    {
-        // Get the prompt from the orchestration input
-        string prompt = context.GetInput<string>() ?? throw new InvalidOperationException("Prompt is required");
-
-        // Get both agents
-        DurableAIAgent physicist = context.GetAgent("PhysicistAgent");
-        DurableAIAgent chemist = context.GetAgent("ChemistAgent");
-
-        // Start both agent runs concurrently
-        Task<AgentResponse<TextResponse>> physicistTask = physicist.RunAsync<TextResponse>(prompt);
-
-        Task<AgentResponse<TextResponse>> chemistTask = chemist.RunAsync<TextResponse>(prompt);
-
-        // Wait for both tasks to complete using Task.WhenAll
-        await Task.WhenAll(physicistTask, chemistTask);
-
-        // Get the results
-        TextResponse physicistResponse = (await physicistTask).Result;
-        TextResponse chemistResponse = (await chemistTask).Result;
-
-        // Return the result as a structured, anonymous type
-        return new
-        {
-            physicist = physicistResponse.Text,
-            chemist = chemistResponse.Text,
-        };
-    }
-
-    // POST /multiagent/run
-    [Function(nameof(StartOrchestrationAsync))]
-    public static async Task<HttpResponseData> StartOrchestrationAsync(
-        [HttpTrigger(AuthorizationLevel.Anonymous, "post", Route = "multiagent/run")] HttpRequestData req,
-        [DurableClient] DurableTaskClient client)
-    {
-        // Read the prompt from the request body
-        string? prompt = await req.ReadAsStringAsync();
-        if (string.IsNullOrWhiteSpace(prompt))
-        {
-            HttpResponseData badRequestResponse = req.CreateResponse(HttpStatusCode.BadRequest);
-            await badRequestResponse.WriteAsJsonAsync(new { error = "Prompt is required" });
-            return badRequestResponse;
-        }
-
-        string instanceId = await client.ScheduleNewOrchestrationInstanceAsync(
-            orchestratorName: nameof(RunOrchestrationAsync),
-            input: prompt);
-
-        HttpResponseData response = req.CreateResponse(HttpStatusCode.Accepted);
-        await response.WriteAsJsonAsync(new
-        {
-            message = "Multi-agent concurrent orchestration started.",
-            prompt,
-            instanceId,
-            statusQueryGetUri = GetStatusQueryGetUri(req, instanceId),
-        });
-        return response;
-    }
-
-    // GET /multiagent/status/{instanceId}
-    [Function(nameof(GetOrchestrationStatusAsync))]
-    public static async Task<HttpResponseData> GetOrchestrationStatusAsync(
-        [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = "multiagent/status/{instanceId}")] HttpRequestData req,
-        string instanceId,
-        [DurableClient] DurableTaskClient client)
-    {
-        OrchestrationMetadata? status = await client.GetInstanceAsync(
-            instanceId,
-            getInputsAndOutputs: true,
-            req.FunctionContext.CancellationToken);
-
-        if (status is null)
-        {
-            HttpResponseData notFound = req.CreateResponse(HttpStatusCode.NotFound);
-            await notFound.WriteAsJsonAsync(new { error = "Instance not found" });
-            return notFound;
-        }
-
-        HttpResponseData response = req.CreateResponse(HttpStatusCode.OK);
-        await response.WriteAsJsonAsync(new
-        {
-            instanceId = status.InstanceId,
-            runtimeStatus = status.RuntimeStatus.ToString(),
-            input = status.SerializedInput is not null ? (object)status.ReadInputAs<JsonElement>() : null,
-            output = status.SerializedOutput is not null ? (object)status.ReadOutputAs<JsonElement>() : null,
-            failureDetails = status.FailureDetails
-        });
-        return response;
-    }
-
-    private static string GetStatusQueryGetUri(HttpRequestData req, string instanceId)
-    {
-        // NOTE: This can be made more robust by considering the value of
-        //       request headers like "X-Forwarded-Host" and "X-Forwarded-Proto".
-        string authority = $"{req.Url.Scheme}://{req.Url.Authority}";
-        return $"{authority}/api/multiagent/status/{instanceId}";
-    }
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/03_AgentOrchestration_Concurrency/Program.cs

@@ -1,50 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-#pragma warning disable IDE0002 // Simplify Member Access
-
-using Azure;
-using Azure.AI.OpenAI;
-using Azure.Identity;
-using Microsoft.Agents.AI;
-using Microsoft.Agents.AI.Hosting.AzureFunctions;
-using Microsoft.Azure.Functions.Worker.Builder;
-using Microsoft.Extensions.Hosting;
-using OpenAI.Chat;
-
-// Get the Azure OpenAI endpoint and deployment name from environment variables.
-string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_ENDPOINT is not set.");
-string deploymentName = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT_NAME")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_DEPLOYMENT_NAME is not set.");
-
-// Use Azure Key Credential if provided, otherwise use Azure CLI Credential.
-string? azureOpenAiKey = System.Environment.GetEnvironmentVariable("AZURE_OPENAI_API_KEY");
-// WARNING: DefaultAzureCredential is convenient for development but requires careful consideration in production.
-// In production, consider using a specific credential (e.g., ManagedIdentityCredential) to avoid
-// latency issues, unintended credential probing, and potential security risks from fallback mechanisms.
-AzureOpenAIClient client = !string.IsNullOrEmpty(azureOpenAiKey)
-    ? new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(azureOpenAiKey))
-    : new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential());
-
-// Two agents used by the orchestration to demonstrate concurrent execution.
-const string PhysicistName = "PhysicistAgent";
-const string PhysicistInstructions = "You are an expert in physics. You answer questions from a physics perspective.";
-
-const string ChemistName = "ChemistAgent";
-const string ChemistInstructions = "You are an expert in chemistry. You answer questions from a chemistry perspective.";
-
-AIAgent physicistAgent = client.GetChatClient(deploymentName).AsAIAgent(PhysicistInstructions, PhysicistName);
-AIAgent chemistAgent = client.GetChatClient(deploymentName).AsAIAgent(ChemistInstructions, ChemistName);
-
-using IHost app = FunctionsApplication
-    .CreateBuilder(args)
-    .ConfigureFunctionsWebApplication()
-    .ConfigureDurableAgents(options =>
-    {
-        options
-            .AddAIAgent(physicistAgent)
-            .AddAIAgent(chemistAgent);
-    })
-    .Build();
-
-app.Run();

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/03_AgentOrchestration_Concurrency/README.md

@@ -1,65 +0,0 @@
-# Multi-Agent Concurrent Orchestration Sample
-
-This sample demonstrates how to use the Durable Agent Framework (DAFx) to create an Azure Functions app that orchestrates concurrent execution of multiple AI agents, each with specialized expertise, to provide comprehensive answers to complex questions.
-
-## Key Concepts Demonstrated
-
-- Multi-agent orchestration with specialized AI agents (physics and chemistry)
-- Concurrent execution using the fan-out/fan-in pattern for improved performance and distributed processing
-- Response aggregation from multiple agents into a unified result
-- Durable orchestration with automatic checkpointing and resumption from failures
-
-## Environment Setup
-
-See the [README.md](../README.md) file in the parent directory for more information on how to configure the environment, including how to install and run common sample dependencies.
-
-## Running the Sample
-
-With the environment setup and function app running, you can test the sample by sending an HTTP request with a custom prompt to the orchestration.
-
-You can use the `demo.http` file to send a message to the agents, or a command line tool like `curl` as shown below:
-
-Bash (Linux/macOS/WSL):
-
-```bash
-curl -X POST http://localhost:7071/api/multiagent/run \
-    -H "Content-Type: text/plain" \
-    -d "What is temperature?"
-```
-
-PowerShell:
-
-```powershell
-Invoke-RestMethod -Method Post `
-    -Uri http://localhost:7071/api/multiagent/run `
-    -ContentType text/plain `
-    -Body "What is temperature?"
-```
-
-The response will be a JSON object that looks something like the following, which indicates that the orchestration has started.
-
-```json
-{
-  "message": "Multi-agent concurrent orchestration started.",
-  "prompt": "What is temperature?",
-  "instanceId": "e7e29999b6b8424682b3539292afc9ed",
-  "statusQueryGetUri": "http://localhost:7071/api/multiagent/status/e7e29999b6b8424682b3539292afc9ed"
-}
-```
-
-The orchestration will run both the PhysicistAgent and ChemistAgent concurrently, asking them the same question. Their responses will be combined to provide a comprehensive answer covering both physical and chemical aspects.
-
-Once the orchestration has completed, you can get the status of the orchestration by sending a GET request to the `statusQueryGetUri` URL. The response will be a JSON object that looks something like the following:
-
-```json
-{
-  "failureDetails": null,
-  "input": "What is temperature?",
-  "instanceId": "e7e29999b6b8424682b3539292afc9ed",
-  "output": {
-    "physicist": "Temperature is a measure of the average kinetic energy of particles in a system. From a physics perspective, it represents the thermal energy and determines the direction of heat flow between objects.",
-    "chemist": "From a chemistry perspective, temperature is crucial for chemical reactions as it affects reaction rates through the Arrhenius equation. It influences the equilibrium position of reversible reactions and determines the physical state of substances."
-  },
-  "runtimeStatus": "Completed"
-}
-```

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/03_AgentOrchestration_Concurrency/demo.http

@@ -1,5 +0,0 @@
-### Start the multi-agent concurrent orchestration
-POST http://localhost:7071/api/multiagent/run
-Content-Type: text/plain
-
-What is temperature?

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/03_AgentOrchestration_Concurrency/host.json

@@ -1,20 +0,0 @@
-{
-  "version": "2.0",
-  "logging": {
-    "logLevel": {
-      "Microsoft.Agents.AI.DurableTask": "Information",
-      "Microsoft.Agents.AI.Hosting.AzureFunctions": "Information",
-      "DurableTask": "Information",
-      "Microsoft.DurableTask": "Information"
-    }
-  },
-  "extensions": {
-    "durableTask": {
-      "hubName": "default",
-      "storageProvider": {
-        "type": "AzureManaged",
-        "connectionStringName": "DURABLE_TASK_SCHEDULER_CONNECTION_STRING"
-      }
-    }
-  }
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/04_AgentOrchestration_Conditionals/04_AgentOrchestration_Conditionals.csproj

@@ -1,42 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-  <PropertyGroup>
-    <TargetFrameworks>net10.0</TargetFrameworks>
-    <AzureFunctionsVersion>v4</AzureFunctionsVersion>
-    <OutputType>Exe</OutputType>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-    <!-- The Functions build tools don't like namespaces that start with a number -->
-    <AssemblyName>AgentOrchestration_Conditionals</AssemblyName>
-    <RootNamespace>AgentOrchestration_Conditionals</RootNamespace>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <FrameworkReference Include="Microsoft.AspNetCore.App" />
-  </ItemGroup>
-
-  <!-- Azure Functions packages -->
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Azure.Functions.Worker" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask.AzureManaged" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" />
-  </ItemGroup>
-
-  <ItemGroup>
-    <PackageReference Include="Azure.AI.OpenAI" />
-    <PackageReference Include="Azure.Identity" />
-  </ItemGroup>
-
-  <!-- Local projects that should be switched to package references when using the sample outside of this MAF repo -->
-  <!--
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Agents.AI.Hosting.AzureFunctions" />
-    <PackageReference Include="Microsoft.Agents.AI.OpenAI" />
-  </ItemGroup>
-  -->
-  <ItemGroup>
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.Hosting.AzureFunctions\Microsoft.Agents.AI.Hosting.AzureFunctions.csproj" />
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.OpenAI\Microsoft.Agents.AI.OpenAI.csproj" />
-  </ItemGroup>
-</Project>

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/04_AgentOrchestration_Conditionals/FunctionTriggers.cs

@@ -1,143 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-using System.Net;
-using System.Text.Json;
-using Microsoft.Agents.AI;
-using Microsoft.Agents.AI.DurableTask;
-using Microsoft.Azure.Functions.Worker;
-using Microsoft.Azure.Functions.Worker.Http;
-using Microsoft.DurableTask;
-using Microsoft.DurableTask.Client;
-
-namespace AgentOrchestration_Conditionals;
-
-public static class FunctionTriggers
-{
-    [Function(nameof(RunOrchestrationAsync))]
-    public static async Task<string> RunOrchestrationAsync([OrchestrationTrigger] TaskOrchestrationContext context)
-    {
-        // Get the email from the orchestration input
-        Email email = context.GetInput<Email>() ?? throw new InvalidOperationException("Email is required");
-
-        // Get the spam detection agent
-        DurableAIAgent spamDetectionAgent = context.GetAgent("SpamDetectionAgent");
-        AgentSession spamSession = await spamDetectionAgent.CreateSessionAsync();
-
-        // Step 1: Check if the email is spam
-        AgentResponse<DetectionResult> spamDetectionResponse = await spamDetectionAgent.RunAsync<DetectionResult>(
-            message:
-                $"""
-                Analyze this email for spam content and return a JSON response with 'is_spam' (boolean) and 'reason' (string) fields:
-                Email ID: {email.EmailId}
-                Content: {email.EmailContent}
-                """,
-            session: spamSession);
-        DetectionResult result = spamDetectionResponse.Result;
-
-        // Step 2: Conditional logic based on spam detection result
-        if (result.IsSpam)
-        {
-            // Handle spam email
-            return await context.CallActivityAsync<string>(nameof(HandleSpamEmail), result.Reason);
-        }
-
-        // Generate and send response for legitimate email
-        DurableAIAgent emailAssistantAgent = context.GetAgent("EmailAssistantAgent");
-        AgentSession emailSession = await emailAssistantAgent.CreateSessionAsync();
-
-        AgentResponse<EmailResponse> emailAssistantResponse = await emailAssistantAgent.RunAsync<EmailResponse>(
-            message:
-                $"""
-                    Draft a professional response to this email. Return a JSON response with a 'response' field containing the reply:
-                    
-                    Email ID: {email.EmailId}
-                    Content: {email.EmailContent}
-                    """,
-            session: emailSession);
-
-        EmailResponse emailResponse = emailAssistantResponse.Result;
-
-        return await context.CallActivityAsync<string>(nameof(SendEmail), emailResponse.Response);
-    }
-
-    [Function(nameof(HandleSpamEmail))]
-    public static string HandleSpamEmail([ActivityTrigger] string reason)
-    {
-        return $"Email marked as spam: {reason}";
-    }
-
-    [Function(nameof(SendEmail))]
-    public static string SendEmail([ActivityTrigger] string message)
-    {
-        return $"Email sent: {message}";
-    }
-
-    // POST /spamdetection/run
-    [Function(nameof(StartOrchestrationAsync))]
-    public static async Task<HttpResponseData> StartOrchestrationAsync(
-        [HttpTrigger(AuthorizationLevel.Anonymous, "post", Route = "spamdetection/run")] HttpRequestData req,
-        [DurableClient] DurableTaskClient client)
-    {
-        // Read the email from the request body
-        Email? email = await req.ReadFromJsonAsync<Email>();
-        if (email is null || string.IsNullOrWhiteSpace(email.EmailContent))
-        {
-            HttpResponseData badRequestResponse = req.CreateResponse(HttpStatusCode.BadRequest);
-            await badRequestResponse.WriteAsJsonAsync(new { error = "Email with content is required" });
-            return badRequestResponse;
-        }
-
-        string instanceId = await client.ScheduleNewOrchestrationInstanceAsync(
-            orchestratorName: nameof(RunOrchestrationAsync),
-            input: email);
-
-        HttpResponseData response = req.CreateResponse(HttpStatusCode.Accepted);
-        await response.WriteAsJsonAsync(new
-        {
-            message = "Spam detection orchestration started.",
-            emailId = email.EmailId,
-            instanceId,
-            statusQueryGetUri = GetStatusQueryGetUri(req, instanceId),
-        });
-        return response;
-    }
-
-    // GET /spamdetection/status/{instanceId}
-    [Function(nameof(GetOrchestrationStatusAsync))]
-    public static async Task<HttpResponseData> GetOrchestrationStatusAsync(
-        [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = "spamdetection/status/{instanceId}")] HttpRequestData req,
-        string instanceId,
-        [DurableClient] DurableTaskClient client)
-    {
-        OrchestrationMetadata? status = await client.GetInstanceAsync(
-            instanceId,
-            getInputsAndOutputs: true,
-            req.FunctionContext.CancellationToken);
-
-        if (status is null)
-        {
-            HttpResponseData notFound = req.CreateResponse(HttpStatusCode.NotFound);
-            await notFound.WriteAsJsonAsync(new { error = "Instance not found" });
-            return notFound;
-        }
-
-        HttpResponseData response = req.CreateResponse(HttpStatusCode.OK);
-        await response.WriteAsJsonAsync(new
-        {
-            instanceId = status.InstanceId,
-            runtimeStatus = status.RuntimeStatus.ToString(),
-            input = status.SerializedInput is not null ? (object)status.ReadInputAs<JsonElement>() : null,
-            output = status.SerializedOutput is not null ? (object)status.ReadOutputAs<JsonElement>() : null,
-            failureDetails = status.FailureDetails
-        });
-        return response;
-    }
-
-    private static string GetStatusQueryGetUri(HttpRequestData req, string instanceId)
-    {
-        // NOTE: This can be made more robust by considering the value of
-        //       request headers like "X-Forwarded-Host" and "X-Forwarded-Proto".
-        string authority = $"{req.Url.Scheme}://{req.Url.Authority}";
-        return $"{authority}/api/spamdetection/status/{instanceId}";
-    }
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/04_AgentOrchestration_Conditionals/Models.cs

@@ -1,38 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-using System.Text.Json.Serialization;
-
-namespace AgentOrchestration_Conditionals;
-
-/// <summary>
-/// Represents an email input for spam detection and response generation.
-/// </summary>
-public sealed class Email
-{
-    [JsonPropertyName("email_id")]
-    public string EmailId { get; set; } = string.Empty;
-
-    [JsonPropertyName("email_content")]
-    public string EmailContent { get; set; } = string.Empty;
-}
-
-/// <summary>
-/// Represents the result of spam detection analysis.
-/// </summary>
-public sealed class DetectionResult
-{
-    [JsonPropertyName("is_spam")]
-    public bool IsSpam { get; set; }
-
-    [JsonPropertyName("reason")]
-    public string Reason { get; set; } = string.Empty;
-}
-
-/// <summary>
-/// Represents a generated email response.
-/// </summary>
-public sealed class EmailResponse
-{
-    [JsonPropertyName("response")]
-    public string Response { get; set; } = string.Empty;
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/04_AgentOrchestration_Conditionals/Program.cs

@@ -1,53 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-#pragma warning disable IDE0002 // Simplify Member Access
-
-using Azure;
-using Azure.AI.OpenAI;
-using Azure.Identity;
-using Microsoft.Agents.AI;
-using Microsoft.Agents.AI.Hosting.AzureFunctions;
-using Microsoft.Azure.Functions.Worker.Builder;
-using Microsoft.Extensions.Hosting;
-using OpenAI.Chat;
-
-// Get the Azure OpenAI endpoint and deployment name from environment variables.
-string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_ENDPOINT is not set.");
-string deploymentName = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT_NAME")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_DEPLOYMENT_NAME is not set.");
-
-// Use Azure Key Credential if provided, otherwise use Azure CLI Credential.
-string? azureOpenAiKey = System.Environment.GetEnvironmentVariable("AZURE_OPENAI_API_KEY");
-// WARNING: DefaultAzureCredential is convenient for development but requires careful consideration in production.
-// In production, consider using a specific credential (e.g., ManagedIdentityCredential) to avoid
-// latency issues, unintended credential probing, and potential security risks from fallback mechanisms.
-AzureOpenAIClient client = !string.IsNullOrEmpty(azureOpenAiKey)
-    ? new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(azureOpenAiKey))
-    : new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential());
-
-// Two agents used by the orchestration to demonstrate conditional logic.
-const string SpamDetectionName = "SpamDetectionAgent";
-const string SpamDetectionInstructions = "You are a spam detection assistant that identifies spam emails.";
-
-const string EmailAssistantName = "EmailAssistantAgent";
-const string EmailAssistantInstructions = "You are an email assistant that helps users draft responses to emails with professionalism.";
-
-AIAgent spamDetectionAgent = client.GetChatClient(deploymentName)
-    .AsAIAgent(SpamDetectionInstructions, SpamDetectionName);
-
-AIAgent emailAssistantAgent = client.GetChatClient(deploymentName)
-    .AsAIAgent(EmailAssistantInstructions, EmailAssistantName);
-
-using IHost app = FunctionsApplication
-    .CreateBuilder(args)
-    .ConfigureFunctionsWebApplication()
-    .ConfigureDurableAgents(options =>
-    {
-        options
-            .AddAIAgent(spamDetectionAgent)
-            .AddAIAgent(emailAssistantAgent);
-    })
-    .Build();
-
-app.Run();

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/04_AgentOrchestration_Conditionals/README.md

@@ -1,113 +0,0 @@
-# Multi-Agent Orchestration with Conditionals Sample
-
-This sample demonstrates how to use the Durable Agent Framework (DAFx) to create a multi-agent orchestration workflow that includes conditional logic. The workflow implements a spam detection system that processes emails and takes different actions based on whether the email is identified as spam or legitimate.
-
-## Key Concepts Demonstrated
-
-- Multi-agent orchestration with conditional logic and different processing paths
-- Spam detection using AI agent analysis
-- Structured output from agents for reliable processing
-- Activity functions for integrating non-agentic workflow actions
-
-## Environment Setup
-
-See the [README.md](../README.md) file in the parent directory for more information on how to configure the environment, including how to install and run common sample dependencies.
-
-## Running the Sample
-
-With the environment setup and function app running, you can test the sample by sending an HTTP request with email data to the orchestration.
-
-You can use the `demo.http` file to send email data to the agents, or a command line tool like `curl` as shown below:
-
-Bash (Linux/macOS/WSL):
-
-```bash
-# Test with a legitimate email
-curl -X POST http://localhost:7071/api/spamdetection/run \
-    -H "Content-Type: application/json" \
-    -d '{
-      "email_id": "email-001",
-      "email_content": "Hi John, I hope you are doing well. I wanted to follow up on our meeting yesterday about the quarterly report. Could you please send me the updated figures by Friday? Thanks!"
-    }'
-
-# Test with a spam email
-curl -X POST http://localhost:7071/api/spamdetection/run \
-    -H "Content-Type: application/json" \
-    -d '{
-      "email_id": "email-002",
-      "email_content": "URGENT! You have won $1,000,000! Click here now to claim your prize! Limited time offer! Do not miss out!"
-    }'
-```
-
-PowerShell:
-
-```powershell
-# Test with a legitimate email
-$body = @{
-    email_id = "email-001"
-    email_content = "Hi John, I hope you are doing well. I wanted to follow up on our meeting yesterday about the quarterly report. Could you please send me the updated figures by Friday? Thanks!"
-} | ConvertTo-Json
-
-Invoke-RestMethod -Method Post `
-    -Uri http://localhost:7071/api/spamdetection/run `
-    -ContentType application/json `
-    -Body $body
-
-# Test with a spam email
-$body = @{
-    email_id = "email-002"
-    email_content = "URGENT! You have won $1,000,000! Click here now to claim your prize! Limited time offer! Do not miss out!"
-} | ConvertTo-Json
-
-Invoke-RestMethod -Method Post `
-    -Uri http://localhost:7071/api/spamdetection/run `
-    -ContentType application/json `
-    -Body $body
-```
-
-The response from either input will be a JSON object that looks something like the following, which indicates that the orchestration has started.
-
-```json
-{
-  "message": "Spam detection orchestration started.",
-  "emailId": "email-001",
-  "instanceId": "555dbbb63f75406db2edf9f1f092de95",
-  "statusQueryGetUri": "http://localhost:7071/api/spamdetection/status/555dbbb63f75406db2edf9f1f092de95"
-}
-```
-
-The orchestration will:
-
-1. Analyze the email content using the SpamDetectionAgent
-2. If spam: Mark the email as spam with a reason
-3. If legitimate: Use the EmailAssistantAgent to draft a professional response and "send" it
-
-Once the orchestration has completed, you can get the status of the orchestration by sending a GET request to the `statusQueryGetUri` URL. The response for the legitimate email will be a JSON object that looks something like the following:
-
-```json
-{
-  "failureDetails": null,
-  "input": {
-    "email_content": "Hi John, I hope you're doing well. I wanted to follow up on our meeting yesterday about the quarterly report. Could you please send me the updated figures by Friday? Thanks!",
-    "email_id": "email-001"
-  },
-  "instanceId": "555dbbb63f75406db2edf9f1f092de95",
-  "output": "Email sent: Subject: Re: Follow-Up on Quarterly Report\n\nHi [Recipient's Name],\n\nI hope this message finds you well. Thank you for your patience. I will ensure the updated figures for the quarterly report are sent to you by Friday.\n\nIf you have any further questions or need additional information, please feel free to reach out.\n\nBest regards,\n\nJohn",
-  "runtimeStatus": "Completed"
-}
-```
-
-The response for the spam email will be a JSON object that looks something like the following, which indicates that the email was marked as spam:
-
-```json
-{
-  "failureDetails": null,
-  "input": {
-    "email_content": "URGENT! You have won $1,000,000! Click here now to claim your prize! Limited time offer! Do not miss out!",
-    "email_id": "email-002"
-  },
-  "instanceId": "555dbbb63f75406db2edf9f1f092de95",
-  "output": "Email marked as spam: The email contains misleading claims of winning a large sum of money and encourages immediate action, which are common characteristics of spam.",
-  "runtimeStatus": "Completed"
-}
-```

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/04_AgentOrchestration_Conditionals/demo.http

@@ -1,18 +0,0 @@
-### Test spam detection with a legitimate email
-POST http://localhost:7071/api/spamdetection/run
-Content-Type: application/json
-
-{
-  "email_id": "email-001",
-  "email_content": "Hi John, I hope you're doing well. I wanted to follow up on our meeting yesterday about the quarterly report. Could you please send me the updated figures by Friday? Thanks!"
-}
-
-
-### Test spam detection with a spam email
-POST http://localhost:7071/api/spamdetection/run
-Content-Type: application/json
-
-{
-  "email_id": "email-002", 
-  "email_content": "URGENT! You've won $1,000,000! Click here now to claim your prize! Limited time offer! Don't miss out!"
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/04_AgentOrchestration_Conditionals/host.json

@@ -1,20 +0,0 @@
-{
-  "version": "2.0",
-  "logging": {
-    "logLevel": {
-      "Microsoft.Agents.AI.DurableTask": "Information",
-      "Microsoft.Agents.AI.Hosting.AzureFunctions": "Information",
-      "DurableTask": "Information",
-      "Microsoft.DurableTask": "Information"
-    }
-  },
-  "extensions": {
-    "durableTask": {
-      "hubName": "default",
-      "storageProvider": {
-        "type": "AzureManaged",
-        "connectionStringName": "DURABLE_TASK_SCHEDULER_CONNECTION_STRING"
-      }
-    }
-  }
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/05_AgentOrchestration_HITL/05_AgentOrchestration_HITL.csproj

@@ -1,43 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-  <PropertyGroup>
-    <TargetFrameworks>net10.0</TargetFrameworks>
-    <AzureFunctionsVersion>v4</AzureFunctionsVersion>
-    <OutputType>Exe</OutputType>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-    <!-- The Functions build tools don't like namespaces that start with a number -->
-    <AssemblyName>AgentOrchestration_HITL</AssemblyName>
-    <RootNamespace>AgentOrchestration_HITL</RootNamespace>
-    <NoWarn>$(NoWarn);DURABLE0001;DURABLE0002;DURABLE0003;DURABLE0004;DURABLE0005;DURABLE0006</NoWarn>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <FrameworkReference Include="Microsoft.AspNetCore.App" />
-  </ItemGroup>
-
-  <!-- Azure Functions packages -->
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Azure.Functions.Worker" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask.AzureManaged" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" />
-  </ItemGroup>
-
-  <ItemGroup>
-    <PackageReference Include="Azure.AI.OpenAI" />
-    <PackageReference Include="Azure.Identity" />
-  </ItemGroup>
-
-  <!-- Local projects that should be switched to package references when using the sample outside of this MAF repo -->
-  <!--
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Agents.AI.Hosting.AzureFunctions" />
-    <PackageReference Include="Microsoft.Agents.AI.OpenAI" />
-  </ItemGroup>
-  -->
-  <ItemGroup>
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.Hosting.AzureFunctions\Microsoft.Agents.AI.Hosting.AzureFunctions.csproj" />
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.OpenAI\Microsoft.Agents.AI.OpenAI.csproj" />
-  </ItemGroup>
-</Project>

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/05_AgentOrchestration_HITL/FunctionTriggers.cs

@@ -1,229 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-using System.Net;
-using System.Text.Json;
-using Microsoft.Agents.AI;
-using Microsoft.Agents.AI.DurableTask;
-using Microsoft.Azure.Functions.Worker;
-using Microsoft.Azure.Functions.Worker.Http;
-using Microsoft.DurableTask;
-using Microsoft.DurableTask.Client;
-using Microsoft.Extensions.Logging;
-
-namespace AgentOrchestration_HITL;
-
-public static class FunctionTriggers
-{
-    [Function(nameof(RunOrchestrationAsync))]
-    public static async Task<object> RunOrchestrationAsync(
-        [OrchestrationTrigger] TaskOrchestrationContext context)
-    {
-        // Get the input from the orchestration
-        ContentGenerationInput input = context.GetInput<ContentGenerationInput>()
-            ?? throw new InvalidOperationException("Content generation input is required");
-
-        // Get the writer agent
-        DurableAIAgent writerAgent = context.GetAgent("WriterAgent");
-        AgentSession writerSession = await writerAgent.CreateSessionAsync();
-
-        // Set initial status
-        context.SetCustomStatus($"Starting content generation for topic: {input.Topic}");
-
-        // Step 1: Generate initial content
-        AgentResponse<GeneratedContent> writerResponse = await writerAgent.RunAsync<GeneratedContent>(
-            message: $"Write a short article about '{input.Topic}'.",
-            session: writerSession);
-        GeneratedContent content = writerResponse.Result;
-
-        // Human-in-the-loop iteration - we set a maximum number of attempts to avoid infinite loops
-        int iterationCount = 0;
-        while (iterationCount++ < input.MaxReviewAttempts)
-        {
-            context.SetCustomStatus(
-                $"Requesting human feedback. Iteration #{iterationCount}. Timeout: {input.ApprovalTimeoutHours} hour(s).");
-
-            // Step 2: Notify user to review the content
-            await context.CallActivityAsync(nameof(NotifyUserForApproval), content);
-
-            // Step 3: Wait for human feedback with configurable timeout
-            HumanApprovalResponse humanResponse;
-            try
-            {
-                humanResponse = await context.WaitForExternalEvent<HumanApprovalResponse>(
-                    eventName: "HumanApproval",
-                    timeout: TimeSpan.FromHours(input.ApprovalTimeoutHours));
-            }
-            catch (OperationCanceledException)
-            {
-                // Timeout occurred - treat as rejection
-                context.SetCustomStatus(
-                    $"Human approval timed out after {input.ApprovalTimeoutHours} hour(s). Treating as rejection.");
-                throw new TimeoutException($"Human approval timed out after {input.ApprovalTimeoutHours} hour(s).");
-            }
-
-            if (humanResponse.Approved)
-            {
-                context.SetCustomStatus("Content approved by human reviewer. Publishing content...");
-
-                // Step 4: Publish the approved content
-                await context.CallActivityAsync(nameof(PublishContent), content);
-
-                context.SetCustomStatus($"Content published successfully at {context.CurrentUtcDateTime:s}");
-                return new { content = content.Content };
-            }
-
-            context.SetCustomStatus("Content rejected by human reviewer. Incorporating feedback and regenerating...");
-
-            // Incorporate human feedback and regenerate
-            writerResponse = await writerAgent.RunAsync<GeneratedContent>(
-                message: $"""
-                    The content was rejected by a human reviewer. Please rewrite the article incorporating their feedback.
-                    
-                    Human Feedback: {humanResponse.Feedback}
-                    """,
-                session: writerSession);
-
-            content = writerResponse.Result;
-        }
-
-        // If we reach here, it means we exhausted the maximum number of iterations
-        throw new InvalidOperationException(
-            $"Content could not be approved after {input.MaxReviewAttempts} iterations.");
-    }
-
-    // POST /hitl/run
-    [Function(nameof(StartOrchestrationAsync))]
-    public static async Task<HttpResponseData> StartOrchestrationAsync(
-        [HttpTrigger(AuthorizationLevel.Anonymous, "post", Route = "hitl/run")] HttpRequestData req,
-        [DurableClient] DurableTaskClient client)
-    {
-        // Read the input from the request body
-        ContentGenerationInput? input = await req.ReadFromJsonAsync<ContentGenerationInput>();
-        if (input is null || string.IsNullOrWhiteSpace(input.Topic))
-        {
-            HttpResponseData badRequestResponse = req.CreateResponse(HttpStatusCode.BadRequest);
-            await badRequestResponse.WriteAsJsonAsync(new { error = "Topic is required" });
-            return badRequestResponse;
-        }
-
-        string instanceId = await client.ScheduleNewOrchestrationInstanceAsync(
-            orchestratorName: nameof(RunOrchestrationAsync),
-            input: input);
-
-        HttpResponseData response = req.CreateResponse(HttpStatusCode.Accepted);
-        await response.WriteAsJsonAsync(new
-        {
-            message = "HITL content generation orchestration started.",
-            topic = input.Topic,
-            instanceId,
-            statusQueryGetUri = GetStatusQueryGetUri(req, instanceId),
-        });
-        return response;
-    }
-
-    // POST /hitl/approve/{instanceId}
-    [Function(nameof(SendHumanApprovalAsync))]
-    public static async Task<HttpResponseData> SendHumanApprovalAsync(
-        [HttpTrigger(AuthorizationLevel.Anonymous, "post", Route = "hitl/approve/{instanceId}")] HttpRequestData req,
-        string instanceId,
-        [DurableClient] DurableTaskClient client)
-    {
-        // Read the approval response from the request body
-        HumanApprovalResponse? approvalResponse = await req.ReadFromJsonAsync<HumanApprovalResponse>();
-        if (approvalResponse is null)
-        {
-            HttpResponseData badRequestResponse = req.CreateResponse(HttpStatusCode.BadRequest);
-            await badRequestResponse.WriteAsJsonAsync(new { error = "Approval response is required" });
-            return badRequestResponse;
-        }
-
-        // Send the approval event to the orchestration
-        await client.RaiseEventAsync(instanceId, "HumanApproval", approvalResponse);
-
-        HttpResponseData response = req.CreateResponse(HttpStatusCode.OK);
-        await response.WriteAsJsonAsync(new
-        {
-            message = "Human approval sent to orchestration.",
-            instanceId,
-            approved = approvalResponse.Approved
-        });
-        return response;
-    }
-
-    // GET /hitl/status/{instanceId}
-    [Function(nameof(GetOrchestrationStatusAsync))]
-    public static async Task<HttpResponseData> GetOrchestrationStatusAsync(
-        [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = "hitl/status/{instanceId}")] HttpRequestData req,
-        string instanceId,
-        [DurableClient] DurableTaskClient client)
-    {
-        OrchestrationMetadata? status = await client.GetInstanceAsync(
-            instanceId,
-            getInputsAndOutputs: true,
-            req.FunctionContext.CancellationToken);
-
-        if (status is null)
-        {
-            HttpResponseData notFound = req.CreateResponse(HttpStatusCode.NotFound);
-            await notFound.WriteAsJsonAsync(new { error = "Instance not found" });
-            return notFound;
-        }
-
-        HttpResponseData response = req.CreateResponse(HttpStatusCode.OK);
-        await response.WriteAsJsonAsync(new
-        {
-            instanceId = status.InstanceId,
-            runtimeStatus = status.RuntimeStatus.ToString(),
-            workflowStatus = status.SerializedCustomStatus is not null ? (object)status.ReadCustomStatusAs<JsonElement>() : null,
-            input = status.SerializedInput is not null ? (object)status.ReadInputAs<JsonElement>() : null,
-            output = status.SerializedOutput is not null ? (object)status.ReadOutputAs<JsonElement>() : null,
-            failureDetails = status.FailureDetails
-        });
-        return response;
-    }
-
-    [Function(nameof(NotifyUserForApproval))]
-    public static void NotifyUserForApproval(
-        [ActivityTrigger] GeneratedContent content,
-        FunctionContext functionContext)
-    {
-        ILogger logger = functionContext.GetLogger(nameof(NotifyUserForApproval));
-
-        // In a real implementation, this would send notifications via email, SMS, etc.
-        logger.LogInformation(
-            """
-            NOTIFICATION: Please review the following content for approval:
-            Title: {Title}
-            Content: {Content}
-            Use the approval endpoint to approve or reject this content.
-            """,
-            content.Title,
-            content.Content);
-    }
-
-    [Function(nameof(PublishContent))]
-    public static void PublishContent(
-        [ActivityTrigger] GeneratedContent content,
-        FunctionContext functionContext)
-    {
-        ILogger logger = functionContext.GetLogger(nameof(PublishContent));
-
-        // In a real implementation, this would publish to a CMS, website, etc.
-        logger.LogInformation(
-            """
-            PUBLISHING: Content has been published successfully.
-            Title: {Title}
-            Content: {Content}
-            """,
-            content.Title,
-            content.Content);
-    }
-
-    private static string GetStatusQueryGetUri(HttpRequestData req, string instanceId)
-    {
-        // NOTE: This can be made more robust by considering the value of
-        //       request headers like "X-Forwarded-Host" and "X-Forwarded-Proto".
-        string authority = $"{req.Url.Scheme}://{req.Url.Authority}";
-        return $"{authority}/api/hitl/status/{instanceId}";
-    }
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/05_AgentOrchestration_HITL/Models.cs

@@ -1,44 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-using System.Text.Json.Serialization;
-
-namespace AgentOrchestration_HITL;
-
-/// <summary>
-/// Represents the input for the Human-in-the-Loop content generation workflow.
-/// </summary>
-public sealed class ContentGenerationInput
-{
-    [JsonPropertyName("topic")]
-    public string Topic { get; set; } = string.Empty;
-
-    [JsonPropertyName("max_review_attempts")]
-    public int MaxReviewAttempts { get; set; } = 3;
-
-    [JsonPropertyName("approval_timeout_hours")]
-    public float ApprovalTimeoutHours { get; set; } = 72;
-}
-
-/// <summary>
-/// Represents the content generated by the writer agent.
-/// </summary>
-public sealed class GeneratedContent
-{
-    [JsonPropertyName("title")]
-    public string Title { get; set; } = string.Empty;
-
-    [JsonPropertyName("content")]
-    public string Content { get; set; } = string.Empty;
-}
-
-/// <summary>
-/// Represents the human approval response.
-/// </summary>
-public sealed class HumanApprovalResponse
-{
-    [JsonPropertyName("approved")]
-    public bool Approved { get; set; }
-
-    [JsonPropertyName("feedback")]
-    public string Feedback { get; set; } = string.Empty;
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/05_AgentOrchestration_HITL/Program.cs

@@ -1,45 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-#pragma warning disable IDE0002 // Simplify Member Access
-
-using Azure;
-using Azure.AI.OpenAI;
-using Azure.Identity;
-using Microsoft.Agents.AI;
-using Microsoft.Agents.AI.Hosting.AzureFunctions;
-using Microsoft.Azure.Functions.Worker.Builder;
-using Microsoft.Extensions.Hosting;
-using OpenAI.Chat;
-
-// Get the Azure OpenAI endpoint and deployment name from environment variables.
-string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_ENDPOINT is not set.");
-string deploymentName = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT_NAME")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_DEPLOYMENT_NAME is not set.");
-
-// Use Azure Key Credential if provided, otherwise use Azure CLI Credential.
-string? azureOpenAiKey = System.Environment.GetEnvironmentVariable("AZURE_OPENAI_API_KEY");
-// WARNING: DefaultAzureCredential is convenient for development but requires careful consideration in production.
-// In production, consider using a specific credential (e.g., ManagedIdentityCredential) to avoid
-// latency issues, unintended credential probing, and potential security risks from fallback mechanisms.
-AzureOpenAIClient client = !string.IsNullOrEmpty(azureOpenAiKey)
-    ? new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(azureOpenAiKey))
-    : new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential());
-
-// Single agent used by the orchestration to demonstrate human-in-the-loop workflow.
-const string WriterName = "WriterAgent";
-const string WriterInstructions =
-    """
-    You are a professional content writer who creates high-quality articles on various topics.
-    You write engaging, informative, and well-structured content that follows best practices for readability and accuracy.
-    """;
-
-AIAgent writerAgent = client.GetChatClient(deploymentName).AsAIAgent(WriterInstructions, WriterName);
-
-using IHost app = FunctionsApplication
-    .CreateBuilder(args)
-    .ConfigureFunctionsWebApplication()
-    .ConfigureDurableAgents(options => options.AddAIAgent(writerAgent))
-    .Build();
-
-app.Run();

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/05_AgentOrchestration_HITL/README.md

@@ -1,126 +0,0 @@
-# Multi-Agent Orchestration with Human-in-the-Loop Sample
-
-This sample demonstrates how to use the Durable Agent Framework (DAFx) to create a human-in-the-loop (HITL) workflow using a single AI agent. The workflow uses a writer agent to generate content and requires human approval on every iteration, emphasizing the human-in-the-loop pattern.
-
-## Key Concepts Demonstrated
-
-- Single-agent orchestration
-- Human-in-the-loop feedback loop using external events (`WaitForExternalEvent`)
-- Activity functions for non-agentic workflow steps
-- Iterative content refinement based on human feedback
-- Custom status tracking for workflow visibility
-- Error handling with maximum retry attempts and timeout handling for human approval
-
-## Environment Setup
-
-See the [README.md](../README.md) file in the parent directory for more information on how to configure the environment, including how to install and run common sample dependencies.
-
-## Running the Sample
-
-With the environment setup and function app running, you can test the sample by sending an HTTP request with a topic to start the content generation workflow.
-
-You can use the `demo.http` file to send a topic to the agents, or a command line tool like `curl` as shown below:
-
-Bash (Linux/macOS/WSL):
-
-```bash
-curl -X POST http://localhost:7071/api/hitl/run \
-    -H "Content-Type: application/json" \
-    -d '{
-      "topic": "The Future of Artificial Intelligence",
-      "max_review_attempts": 3,
-      "timeout_minutes": 5
-    }'
-```
-
-PowerShell:
-
-```powershell
-$body = @{
-    topic = "The Future of Artificial Intelligence"
-    max_review_attempts = 3
-    timeout_minutes = 5
-} | ConvertTo-Json
-
-Invoke-RestMethod -Method Post `
-    -Uri http://localhost:7071/api/hitl/run `
-    -ContentType application/json `
-    -Body $body
-```
-
-The response will be a JSON object that looks something like the following, which indicates that the orchestration has started.
-
-```json
-{
-  "message": "HITL content generation orchestration started.",
-  "topic": "The Future of Artificial Intelligence",
-  "instanceId": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
-  "statusQueryGetUri": "http://localhost:7071/api/hitl/status/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
-}
-```
-
-The orchestration will:
-
-1. Generate initial content using the WriterAgent
-2. Notify the user to review the content
-3. Wait for human feedback via external event (configurable timeout)
-4. If approved by human, publish the content
-5. If rejected by human, incorporate feedback and regenerate content
-6. If approval timeout occurs, treat as rejection and fail the orchestration
-7. Repeat until human approval is received or maximum loop iterations are reached
-
-Once the orchestration is waiting for human approval, you can send approval or rejection using the approval endpoint:
-
-Bash (Linux/macOS/WSL):
-
-```bash
-# Approve the content
-curl -X POST http://localhost:7071/api/hitl/approve/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6 \
-    -H "Content-Type: application/json" \
-    -d '{
-      "approved": true,
-      "feedback": "Great article! The content is well-structured and informative."
-    }'
-
-# Reject the content with feedback
-curl -X POST http://localhost:7071/api/hitl/approve/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6 \
-    -H "Content-Type: application/json" \
-    -d '{
-      "approved": false,
-      "feedback": "The article needs more technical depth and better examples."
-    }'
-```
-
-PowerShell:
-
-```powershell
-# Approve the content
-Invoke-RestMethod -Method Post `
-    -Uri http://localhost:7071/api/hitl/approve/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6 `
-    -ContentType application/json `
-    -Body '{ "approved": true, "feedback": "Great article! The content is well-structured and informative." }'
-
-# Reject the content with feedback
-Invoke-RestMethod -Method Post `
-    -Uri http://localhost:7071/api/hitl/approve/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6 `
-    -ContentType application/json `
-    -Body '{ "approved": false, "feedback": "The article needs more technical depth and better examples." }'
-```
-
-Once the orchestration has completed, you can get the status by sending a GET request to the `statusQueryGetUri` URL. The response will be a JSON object that looks something like the following:
-
-```json
-{
-  "failureDetails": null,
-  "input": {
-    "topic": "The Future of Artificial Intelligence",
-    "max_review_attempts": 3
-  },
-  "instanceId": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
-  "output": {
-    "content": "The Future of Artificial Intelligence is..."
-  },
-  "runtimeStatus": "Completed",
-  "workflowStatus": "Content published successfully at 2025-10-15T12:00:00Z"
-}
-```

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/05_AgentOrchestration_HITL/demo.http

@@ -1,44 +0,0 @@
-### Start the HITL content generation orchestration with default timeout (30 days)
-POST http://localhost:7071/api/hitl/run
-Content-Type: application/json
-
-{
-  "topic": "The Future of Artificial Intelligence",
-  "max_review_attempts": 3
-}
-
-
-### Start the HITL content generation orchestration with very short timeout for demonstration (~4 seconds)
-POST http://localhost:7071/api/hitl/run
-Content-Type: application/json
-
-{
-  "topic": "The Future of Artificial Intelligence",
-  "max_review_attempts": 3,
-  "approval_timeout_hours": 0.001
-}
-
-
-### Copy/paste the instanceId from the response above
-@instanceId=INSTANCE_ID_GOES_HERE
-
-### Check the status of the orchestration (replace {instanceId} with the actual instance ID from the response above)
-GET http://localhost:7071/api/hitl/status/{{instanceId}}
-
-### Send human approval (replace {instanceId} with the actual instance ID)
-POST http://localhost:7071/api/hitl/approve/{{instanceId}}
-Content-Type: application/json
-
-{
-  "approved": true,
-  "feedback": "Great article! The content is well-structured and informative."
-}
-
-### Send human rejection with feedback (replace {instanceId} with the actual instance ID)
-POST http://localhost:7071/api/hitl/approve/{{instanceId}}
-Content-Type: application/json
-
-{
-  "approved": false,
-  "feedback": "The article needs more technical depth and better examples. Please add more specific use cases and implementation details."
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/05_AgentOrchestration_HITL/host.json

@@ -1,20 +0,0 @@
-{
-  "version": "2.0",
-  "logging": {
-    "logLevel": {
-      "Microsoft.Agents.AI.DurableTask": "Information",
-      "Microsoft.Agents.AI.Hosting.AzureFunctions": "Information",
-      "DurableTask": "Information",
-      "Microsoft.DurableTask": "Information"
-    }
-  },
-  "extensions": {
-    "durableTask": {
-      "hubName": "default",
-      "storageProvider": {
-        "type": "AzureManaged",
-        "connectionStringName": "DURABLE_TASK_SCHEDULER_CONNECTION_STRING"
-      }
-    }
-  }
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/06_LongRunningTools/06_LongRunningTools.csproj

@@ -1,42 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-  <PropertyGroup>
-    <TargetFrameworks>net10.0</TargetFrameworks>
-    <AzureFunctionsVersion>v4</AzureFunctionsVersion>
-    <OutputType>Exe</OutputType>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-    <!-- The Functions build tools don't like namespaces that start with a number -->
-    <AssemblyName>LongRunningTools</AssemblyName>
-    <RootNamespace>LongRunningTools</RootNamespace>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <FrameworkReference Include="Microsoft.AspNetCore.App" />
-  </ItemGroup>
-
-  <!-- Azure Functions packages -->
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Azure.Functions.Worker" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask.AzureManaged" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" />
-  </ItemGroup>
-
-  <ItemGroup>
-    <PackageReference Include="Azure.AI.OpenAI" />
-    <PackageReference Include="Azure.Identity" />
-  </ItemGroup>
-
-  <!-- Local projects that should be switched to package references when using the sample outside of this MAF repo -->
-  <!--
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Agents.AI.Hosting.AzureFunctions" />
-    <PackageReference Include="Microsoft.Agents.AI.OpenAI" />
-  </ItemGroup>
-  -->
-  <ItemGroup>
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.Hosting.AzureFunctions\Microsoft.Agents.AI.Hosting.AzureFunctions.csproj" />
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.OpenAI\Microsoft.Agents.AI.OpenAI.csproj" />
-  </ItemGroup>
-</Project>

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/06_LongRunningTools/FunctionTriggers.cs

@@ -1,152 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-using Microsoft.Agents.AI;
-using Microsoft.Agents.AI.DurableTask;
-using Microsoft.Azure.Functions.Worker;
-using Microsoft.DurableTask;
-using Microsoft.Extensions.Logging;
-
-namespace LongRunningTools;
-
-public static class FunctionTriggers
-{
-    [Function(nameof(RunOrchestrationAsync))]
-    public static async Task<object> RunOrchestrationAsync(
-        [OrchestrationTrigger] TaskOrchestrationContext context)
-    {
-        // Get the input from the orchestration
-        ContentGenerationInput input = context.GetInput<ContentGenerationInput>()
-            ?? throw new InvalidOperationException("Content generation input is required");
-
-        // Get the writer agent
-        DurableAIAgent writerAgent = context.GetAgent("Writer");
-        AgentSession writerSession = await writerAgent.CreateSessionAsync();
-
-        // Set initial status
-        context.SetCustomStatus($"Starting content generation for topic: {input.Topic}");
-
-        // Step 1: Generate initial content
-        AgentResponse<GeneratedContent> writerResponse = await writerAgent.RunAsync<GeneratedContent>(
-            message: $"Write a short article about '{input.Topic}'.",
-            session: writerSession);
-        GeneratedContent content = writerResponse.Result;
-
-        // Human-in-the-loop iteration - we set a maximum number of attempts to avoid infinite loops
-        int iterationCount = 0;
-        while (iterationCount++ < input.MaxReviewAttempts)
-        {
-            // NOTE: CustomStatus has a 16 KB UTF-16 limit in Durable Functions.
-            // Only include short metadata here - the full content is passed via activity inputs/outputs.
-            context.SetCustomStatus(
-                new
-                {
-                    message = "Requesting human feedback.",
-                    approvalTimeoutHours = input.ApprovalTimeoutHours,
-                    iterationCount,
-                    contentTitle = content.Title,
-                });
-
-            // Step 2: Notify user to review the content
-            await context.CallActivityAsync(nameof(NotifyUserForApproval), content);
-
-            // Step 3: Wait for human feedback with configurable timeout
-            HumanApprovalResponse humanResponse;
-            try
-            {
-                humanResponse = await context.WaitForExternalEvent<HumanApprovalResponse>(
-                    eventName: "HumanApproval",
-                    timeout: TimeSpan.FromHours(input.ApprovalTimeoutHours));
-            }
-            catch (OperationCanceledException)
-            {
-                // Timeout occurred - treat as rejection
-                context.SetCustomStatus(
-                    new
-                    {
-                        message = $"Human approval timed out after {input.ApprovalTimeoutHours} hour(s). Treating as rejection.",
-                        iterationCount,
-                    });
-                throw new TimeoutException($"Human approval timed out after {input.ApprovalTimeoutHours} hour(s).");
-            }
-
-            if (humanResponse.Approved)
-            {
-                context.SetCustomStatus(new
-                {
-                    message = "Content approved by human reviewer. Publishing content...",
-                    contentTitle = content.Title,
-                });
-
-                // Step 4: Publish the approved content
-                await context.CallActivityAsync(nameof(PublishContent), content);
-
-                context.SetCustomStatus(new
-                {
-                    message = $"Content published successfully at {context.CurrentUtcDateTime:s}",
-                    humanFeedback = humanResponse,
-                    contentTitle = content.Title,
-                });
-                return new { content = content.Content };
-            }
-
-            context.SetCustomStatus(new
-            {
-                message = "Content rejected by human reviewer. Incorporating feedback and regenerating...",
-                humanFeedback = humanResponse,
-                contentTitle = content.Title,
-            });
-
-            // Incorporate human feedback and regenerate
-            writerResponse = await writerAgent.RunAsync<GeneratedContent>(
-                message: $"""
-                    The content was rejected by a human reviewer. Please rewrite the article incorporating their feedback.
-                    
-                    Human Feedback: {humanResponse.Feedback}
-                    """,
-                session: writerSession);
-
-            content = writerResponse.Result;
-        }
-
-        // If we reach here, it means we exhausted the maximum number of iterations
-        throw new InvalidOperationException(
-            $"Content could not be approved after {input.MaxReviewAttempts} iterations.");
-    }
-
-    [Function(nameof(NotifyUserForApproval))]
-    public static void NotifyUserForApproval(
-        [ActivityTrigger] GeneratedContent content,
-        FunctionContext functionContext)
-    {
-        ILogger logger = functionContext.GetLogger(nameof(NotifyUserForApproval));
-
-        // In a real implementation, this would send notifications via email, SMS, etc.
-        logger.LogInformation(
-            """
-            NOTIFICATION: Please review the following content for approval:
-            Title: {Title}
-            Content: {Content}
-            Use the approval endpoint to approve or reject this content.
-            """,
-            content.Title,
-            content.Content);
-    }
-
-    [Function(nameof(PublishContent))]
-    public static void PublishContent(
-        [ActivityTrigger] GeneratedContent content,
-        FunctionContext functionContext)
-    {
-        ILogger logger = functionContext.GetLogger(nameof(PublishContent));
-
-        // In a real implementation, this would publish to a CMS, website, etc.
-        logger.LogInformation(
-            """
-            PUBLISHING: Content has been published successfully.
-            Title: {Title}
-            Content: {Content}
-            """,
-            content.Title,
-            content.Content);
-    }
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/06_LongRunningTools/Models.cs

@@ -1,44 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-using System.Text.Json.Serialization;
-
-namespace LongRunningTools;
-
-/// <summary>
-/// Represents the input for the content generation workflow.
-/// </summary>
-public sealed class ContentGenerationInput
-{
-    [JsonPropertyName("topic")]
-    public string Topic { get; set; } = string.Empty;
-
-    [JsonPropertyName("max_review_attempts")]
-    public int MaxReviewAttempts { get; set; } = 3;
-
-    [JsonPropertyName("approval_timeout_hours")]
-    public float ApprovalTimeoutHours { get; set; } = 72;
-}
-
-/// <summary>
-/// Represents the content generated by the writer agent.
-/// </summary>
-public sealed class GeneratedContent
-{
-    [JsonPropertyName("title")]
-    public string Title { get; set; } = string.Empty;
-
-    [JsonPropertyName("content")]
-    public string Content { get; set; } = string.Empty;
-}
-
-/// <summary>
-/// Represents the human approval response.
-/// </summary>
-public sealed class HumanApprovalResponse
-{
-    [JsonPropertyName("approved")]
-    public bool Approved { get; set; }
-
-    [JsonPropertyName("feedback")]
-    public string Feedback { get; set; } = string.Empty;
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/06_LongRunningTools/Program.cs

@@ -1,78 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-#pragma warning disable IDE0002 // Simplify Member Access
-
-using Azure;
-using Azure.AI.OpenAI;
-using Azure.Identity;
-using LongRunningTools;
-using Microsoft.Agents.AI;
-using Microsoft.Agents.AI.Hosting.AzureFunctions;
-using Microsoft.Azure.Functions.Worker.Builder;
-using Microsoft.Extensions.AI;
-using Microsoft.Extensions.DependencyInjection;
-using Microsoft.Extensions.Hosting;
-using Microsoft.Extensions.Logging;
-using OpenAI.Chat;
-
-// Get the Azure OpenAI endpoint and deployment name from environment variables.
-string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_ENDPOINT is not set.");
-string deploymentName = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT_NAME")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_DEPLOYMENT_NAME is not set.");
-
-// Use Azure Key Credential if provided, otherwise use Azure CLI Credential.
-string? azureOpenAiKey = System.Environment.GetEnvironmentVariable("AZURE_OPENAI_API_KEY");
-// WARNING: DefaultAzureCredential is convenient for development but requires careful consideration in production.
-// In production, consider using a specific credential (e.g., ManagedIdentityCredential) to avoid
-// latency issues, unintended credential probing, and potential security risks from fallback mechanisms.
-AzureOpenAIClient client = !string.IsNullOrEmpty(azureOpenAiKey)
-    ? new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(azureOpenAiKey))
-    : new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential());
-
-// Agent used by the orchestration to write content.
-const string WriterAgentName = "Writer";
-const string WriterAgentInstructions =
-    """
-    You are a professional content writer who creates high-quality articles on various topics.
-    You write engaging, informative, and well-structured content that follows best practices for readability and accuracy.
-    """;
-
-AIAgent writerAgent = client.GetChatClient(deploymentName).AsAIAgent(WriterAgentInstructions, WriterAgentName);
-
-// Agent that can start content generation workflows using tools
-const string PublisherAgentName = "Publisher";
-const string PublisherAgentInstructions =
-    """
-    You are a publishing agent that can manage content generation workflows.
-    You have access to tools to start, monitor, and raise events for content generation workflows.
-    """;
-
-using IHost app = FunctionsApplication
-    .CreateBuilder(args)
-    .ConfigureFunctionsWebApplication()
-    .ConfigureDurableAgents(options =>
-    {
-        // Add the writer agent used by the orchestration
-        options.AddAIAgent(writerAgent);
-
-        // Define the agent that can start orchestrations from tool calls
-        options.AddAIAgentFactory(PublisherAgentName, sp =>
-        {
-            // Initialize the tools to be used by the agent.
-            Tools publisherTools = new(sp.GetRequiredService<ILogger<Tools>>());
-
-            return client.GetChatClient(deploymentName).AsAIAgent(
-                instructions: PublisherAgentInstructions,
-                name: PublisherAgentName,
-                services: sp,
-                tools: [
-                    AIFunctionFactory.Create(publisherTools.StartContentGenerationWorkflow),
-                    AIFunctionFactory.Create(publisherTools.GetWorkflowStatusAsync),
-                    AIFunctionFactory.Create(publisherTools.SubmitHumanApprovalAsync),
-                ]);
-        });
-    })
-    .Build();
-
-app.Run();

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/06_LongRunningTools/README.md

@@ -1,129 +0,0 @@
-# Long Running Tools Sample
-
-This sample demonstrates how to use the Durable Agent Framework (DAFx) to create agents with long running tools. This sample builds on the [05_AgentOrchestration_HITL](../05_AgentOrchestration_HITL) sample by adding a publisher agent that can start and manage content generation workflows. A key difference is that the publisher agent knows the IDs of the workflows it starts, so it can check the status of the workflows and approve or reject them without being explicitly given the context (instance IDs, etc).
-
-## Key Concepts Demonstrated
-
-The same key concepts as the [05_AgentOrchestration_HITL](../05_AgentOrchestration_HITL) sample are demonstrated, but with the following additional concepts:
-
-- **Long running tools**: Using `DurableAgentContext.Current` to start orchestrations from tool calls
-- **Multi-agent orchestration**: Agents can start and manage workflows that orchestrate other agents
-- **Human-in-the-loop (with delegation)**: The agent acts as an intermediary between the human and the workflow. The human remains in the loop, but delegates to the agent to start the workflow and approve or reject the content.
-
-## Environment Setup
-
-See the [README.md](../README.md) file in the parent directory for more information on how to configure the environment, including how to install and run common sample dependencies.
-
-## Running the Sample
-
-With the environment setup and function app running, you can test the sample by sending an HTTP request to start the agent, which will then trigger the content generation workflow.
-
-You can use the `demo.http` file to send requests to the agent, or a command line tool like `curl` as shown below.
-
-Bash (Linux/macOS/WSL):
-
-```bash
-curl -i -X POST http://localhost:7071/api/agents/publisher/run \
-    -D headers.txt \
-    -H "Content-Type: text/plain" \
-    -d 'Start a content generation workflow for the topic \"The Future of Artificial Intelligence\"'
-
-# Save the thread ID to a variable and print it to the terminal
-threadId=$(cat headers.txt | grep "x-ms-thread-id" | cut -d' ' -f2)
-echo "Thread ID: $threadId"
-```
-
-PowerShell:
-
-```powershell
-Invoke-RestMethod -Method Post `
-    -Uri http://localhost:7071/api/agents/publisher/run `
-    -ResponseHeadersVariable ResponseHeaders `
-    -ContentType text/plain `
-    -Body 'Start a content generation workflow for the topic \"The Future of Artificial Intelligence\"' `
-
-# Save the thread ID to a variable and print it to the console
-$threadId = $ResponseHeaders['x-ms-thread-id']
-Write-Host "Thread ID: $threadId"
-```
-
-The response will be a text string that looks something like the following, indicating that the agent request has been received and will be processed:
-
-```http
-HTTP/1.1 200 OK
-Content-Type: text/plain
-x-ms-thread-id: 351ec855-7f4d-4527-a60d-498301ced36d
-
-```
-
-The `x-ms-thread-id` response header contains the thread ID, which can be used to continue the conversation by passing it as a query parameter (`thread_id`) to the `run` endpoint. The commands above show how to save the thread ID to a `$threadId` variable for use in subsequent requests.
-
-Behind the scenes, the publisher agent will:
-
-1. Start the content generation workflow via a tool call
-1. The workflow will generate initial content using the Writer agent and wait for human approval, which will be visible in the logs
-
-Once the workflow is waiting for human approval, you can send approval or rejection by prompting the publisher agent accordingly (e.g. "Approve the content" or "Reject the content with feedback: The article needs more technical depth and better examples."):
-
-Bash (Linux/macOS/WSL):
-
-```bash
-# Approve the content
-curl -X POST "http://localhost:7071/api/agents/publisher/run?thread_id=$threadId" \
-    -H "Content-Type: text/plain" \
-    -d 'Approve the content'
-
-# Reject the content with feedback
-curl -X POST "http://localhost:7071/api/agents/publisher/run?thread_id=$threadId" \
-    -H "Content-Type: text/plain" \
-    -d 'Reject the content with feedback: The article needs more technical depth and better examples.'
-```
-
-PowerShell:
-
-```powershell
-# Approve the content
-Invoke-RestMethod -Method Post `
-    -Uri "http://localhost:7071/api/agents/publisher/run?thread_id=$threadId" `
-    -ContentType text/plain `
-    -Body 'Approve the content'
-
-# Reject the content with feedback
-Invoke-RestMethod -Method Post `
-    -Uri "http://localhost:7071/api/agents/publisher/run?thread_id=$threadId" `
-    -ContentType text/plain `
-    -Body 'Reject the content with feedback: The article needs more technical depth and better examples.'
-```
-
-Once the workflow has completed, you can get the status by prompting the publisher agent to give you the status.
-
-Bash (Linux/macOS/WSL):
-
-```bash
-curl -X POST "http://localhost:7071/api/agents/publisher/run?thread_id=$threadId" \
-    -H "Content-Type: text/plain" \
-    -d 'Get the status of the workflow you previously started'
-```
-
-PowerShell:
-
-```powershell
-Invoke-RestMethod -Method Post `
-    -Uri "http://localhost:7071/api/agents/publisher/run?thread_id=$threadId" `
-    -ContentType text/plain `
-    -Body 'Get the status of the workflow you previously started'
-```
-
-The response from the publisher agent will look something like the following:
-
-```text
-The status of the workflow with instance ID **ab1076d6e7ec49d8a2c2474d09b69ded** is as follows:
-
-- **Execution Status:** Completed
-- **Workflow Status:** Content published successfully at `2025-10-24T20:42:02`
-- **Created At:** `2025-10-24T20:41:40.7531781+00:00`
-- **Last Updated At:** `2025-10-24T20:42:02.1410736+00:00`
-
-The content has been successfully published.
-```
-```

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/06_LongRunningTools/Tools.cs

@@ -1,93 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-using System.ComponentModel;
-using Microsoft.Agents.AI.DurableTask;
-using Microsoft.DurableTask.Client;
-using Microsoft.Extensions.Logging;
-
-namespace LongRunningTools;
-
-/// <summary>
-/// Tools that demonstrate starting orchestrations from agent tool calls.
-/// </summary>
-internal sealed class Tools(ILogger<Tools> logger)
-{
-    private readonly ILogger<Tools> _logger = logger;
-
-    [Description("Starts a content generation workflow and returns the instance ID for tracking.")]
-    public string StartContentGenerationWorkflow([Description("The topic for content generation")] string topic)
-    {
-        this._logger.LogInformation("Starting content generation workflow for topic: {Topic}", SanitizeLogValue(topic));
-
-        const int MaxReviewAttempts = 3;
-        const float ApprovalTimeoutHours = 72;
-
-        // Schedule the orchestration, which will start running after the tool call completes.
-        string instanceId = DurableAgentContext.Current.ScheduleNewOrchestration(
-            name: nameof(FunctionTriggers.RunOrchestrationAsync),
-            input: new ContentGenerationInput
-            {
-                Topic = topic,
-                MaxReviewAttempts = MaxReviewAttempts,
-                ApprovalTimeoutHours = ApprovalTimeoutHours
-            });
-
-        this._logger.LogInformation(
-            "Content generation workflow scheduled to be started for topic '{Topic}' with instance ID: {InstanceId}",
-            SanitizeLogValue(topic),
-            instanceId);
-
-        return $"Workflow started with instance ID: {instanceId}";
-    }
-
-    [Description("Gets the status of a workflow orchestration.")]
-    public async Task<object> GetWorkflowStatusAsync(
-        [Description("The instance ID of the workflow to check")] string instanceId,
-        [Description("Whether to include detailed information")] bool includeDetails = true)
-    {
-        this._logger.LogInformation("Getting status for workflow instance: {InstanceId}", SanitizeLogValue(instanceId));
-
-        // Get the current agent context using the session-static property
-        OrchestrationMetadata? status = await DurableAgentContext.Current.GetOrchestrationStatusAsync(
-            instanceId,
-            includeDetails);
-
-        if (status is null)
-        {
-            this._logger.LogInformation("Workflow instance '{InstanceId}' not found.", SanitizeLogValue(instanceId));
-            return new
-            {
-                instanceId,
-                error = $"Workflow instance '{instanceId}' not found.",
-            };
-        }
-
-        return new
-        {
-            instanceId = status.InstanceId,
-            createdAt = status.CreatedAt,
-            executionStatus = status.RuntimeStatus,
-            workflowStatus = status.SerializedCustomStatus,
-            lastUpdatedAt = status.LastUpdatedAt,
-            failureDetails = status.FailureDetails
-        };
-    }
-
-    [Description("Raises a feedback event for the content generation workflow.")]
-    public async Task SubmitHumanApprovalAsync(
-        [Description("The instance ID of the workflow to submit feedback for")] string instanceId,
-        [Description("Feedback to submit")] HumanApprovalResponse feedback)
-    {
-        this._logger.LogInformation("Submitting human approval for workflow instance: {InstanceId}", SanitizeLogValue(instanceId));
-        await DurableAgentContext.Current.RaiseOrchestrationEventAsync(instanceId, "HumanApproval", feedback);
-    }
-
-    /// <summary>
-    /// Sanitizes a user-provided value for safe inclusion in log entries
-    /// by removing control characters that could be used for log forging.
-    /// </summary>
-    private static string SanitizeLogValue(string value) =>
-        value
-            .Replace("\r", string.Empty, StringComparison.Ordinal)
-            .Replace("\n", string.Empty, StringComparison.Ordinal);
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/06_LongRunningTools/demo.http

@@ -1,27 +0,0 @@
-### Run an agent that can schedule orchestrations as tool calls
-POST http://localhost:7071/api/agents/publisher/run
-Content-Type: text/plain
-
-Start a content generation workflow for the topic 'The Future of Artificial Intelligence'
-
-
-### Save the session ID from the response to continue the conversation
-@threadId = <YOUR_THREAD_ID>
-
-### Check the status of the workflow
-POST http://localhost:7071/api/agents/publisher/run?thread_id={{threadId}}
-Content-Type: text/plain
-
-Check the status of the workflow you previously started
-
-### Reject content with feedback
-POST http://localhost:7071/api/agents/publisher/run?thread_id={{threadId}}
-Content-Type: text/plain
-
-Reject the content with feedback: The article needs more technical depth and better examples.
-
-### Approve content
-POST http://localhost:7071/api/agents/publisher/run?thread_id={{threadId}}
-Content-Type: text/plain
-
-Approve the content

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/06_LongRunningTools/host.json

@@ -1,20 +0,0 @@
-{
-  "version": "2.0",
-  "logging": {
-    "logLevel": {
-      "Microsoft.Agents.AI.DurableTask": "Information",
-      "Microsoft.Agents.AI.Hosting.AzureFunctions": "Information",
-      "DurableTask": "Information",
-      "Microsoft.DurableTask": "Information"
-    }
-  },
-  "extensions": {
-    "durableTask": {
-      "hubName": "default",
-      "storageProvider": {
-        "type": "AzureManaged",
-        "connectionStringName": "DURABLE_TASK_SCHEDULER_CONNECTION_STRING"
-      }
-    }
-  }
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/07_AgentAsMcpTool/07_AgentAsMcpTool.csproj

@@ -1,42 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-  <PropertyGroup>
-    <TargetFrameworks>net10.0</TargetFrameworks>
-    <AzureFunctionsVersion>v4</AzureFunctionsVersion>
-    <OutputType>Exe</OutputType>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-    <!-- The Functions build tools don't like namespaces that start with a number -->
-    <AssemblyName>AgentAsMcpTool</AssemblyName>
-    <RootNamespace>AgentAsMcpTool</RootNamespace>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <FrameworkReference Include="Microsoft.AspNetCore.App" />
-  </ItemGroup>
-
-  <!-- Azure Functions packages -->
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Azure.Functions.Worker" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask.AzureManaged" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" />
-  </ItemGroup>
-
-  <ItemGroup>
-    <PackageReference Include="Azure.AI.OpenAI" />
-    <PackageReference Include="Azure.Identity" />
-  </ItemGroup>
-
-  <!-- Local projects that should be switched to package references when using the sample outside of this MAF repo -->
-  <!--
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Agents.AI.Hosting.AzureFunctions" />
-    <PackageReference Include="Microsoft.Agents.AI.OpenAI" />
-  </ItemGroup>
-  -->
-  <ItemGroup>
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.Hosting.AzureFunctions\Microsoft.Agents.AI.Hosting.AzureFunctions.csproj" />
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.OpenAI\Microsoft.Agents.AI.OpenAI.csproj" />
-  </ItemGroup>
-</Project>

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/07_AgentAsMcpTool/Program.cs

@@ -1,58 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-// This sample demonstrates how to configure AI agents to be accessible as MCP tools.
-// When using AddAIAgent and enabling MCP tool triggers, the Functions host will automatically
-// generate a remote MCP endpoint for the app at /runtime/webhooks/mcp with a agent-specific
-// query tool name.
-
-#pragma warning disable IDE0002 // Simplify Member Access
-
-using Azure;
-using Azure.AI.OpenAI;
-using Azure.Identity;
-using Microsoft.Agents.AI;
-using Microsoft.Agents.AI.DurableTask;
-using Microsoft.Agents.AI.Hosting.AzureFunctions;
-using Microsoft.Azure.Functions.Worker.Builder;
-using Microsoft.Extensions.Hosting;
-using OpenAI.Chat;
-
-// Get the Azure OpenAI endpoint and deployment name from environment variables.
-string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_ENDPOINT is not set.");
-string deploymentName = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT_NAME")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_DEPLOYMENT_NAME is not set.");
-
-// Use Azure Key Credential if provided, otherwise use Azure CLI Credential.
-string? azureOpenAiKey = System.Environment.GetEnvironmentVariable("AZURE_OPENAI_API_KEY");
-// WARNING: DefaultAzureCredential is convenient for development but requires careful consideration in production.
-// In production, consider using a specific credential (e.g., ManagedIdentityCredential) to avoid
-// latency issues, unintended credential probing, and potential security risks from fallback mechanisms.
-AzureOpenAIClient client = !string.IsNullOrEmpty(azureOpenAiKey)
-    ? new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(azureOpenAiKey))
-    : new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential());
-
-// Define three AI agents we are going to use in this application.
-AIAgent agent1 = client.GetChatClient(deploymentName).AsAIAgent("You are good at telling jokes.", "Joker");
-
-AIAgent agent2 = client.GetChatClient(deploymentName)
-    .AsAIAgent("Check stock prices.", "StockAdvisor");
-
-AIAgent agent3 = client.GetChatClient(deploymentName)
-    .AsAIAgent("Recommend plants.", "PlantAdvisor", description: "Get plant recommendations.");
-
-using IHost app = FunctionsApplication
-    .CreateBuilder(args)
-    .ConfigureFunctionsWebApplication()
-    .ConfigureDurableAgents(options =>
-    {
-        options
-        .AddAIAgent(agent1)  // Enables HTTP trigger by default.
-        .AddAIAgent(agent2, enableHttpTrigger: false, enableMcpToolTrigger: true) // Disable HTTP trigger, enable MCP Tool trigger.
-        .AddAIAgent(agent3, agentOptions =>
-        {
-            agentOptions.McpToolTrigger.IsEnabled = true; // Enable MCP Tool trigger.
-        });
-    })
-    .Build();
-app.Run();

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/07_AgentAsMcpTool/README.md

@@ -1,87 +0,0 @@
-# Agent as MCP Tool Sample
-
-This sample demonstrates how to configure AI agents to be accessible as both HTTP endpoints and [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) tools, enabling flexible integration patterns for AI agent consumption.
-
-## Key Concepts Demonstrated
-
-- **Multi-trigger Agent Configuration**: Configure agents to support HTTP triggers, MCP tool triggers, or both
-- **Microsoft Agent Framework Integration**: Use the framework to define AI agents with specific roles and capabilities
-- **Flexible Agent Registration**: Register agents with customizable trigger configurations
-- **MCP Server Hosting**: Expose agents as MCP tools for consumption by MCP-compatible clients
-
-## Sample Architecture
-
-This sample creates three agents with different trigger configurations:
-
-| Agent | Role | HTTP Trigger | MCP Tool Trigger | Description |
-|-------|------|--------------|------------------|-------------|
-| **Joker** | Comedy specialist | ✅ Enabled | ❌ Disabled | Accessible only via HTTP requests |
-| **StockAdvisor** | Financial data | ❌ Disabled | ✅ Enabled | Accessible only as MCP tool |
-| **PlantAdvisor** | Indoor plant recommendations | ✅ Enabled | ✅ Enabled | Accessible via both HTTP and MCP |
-
-## Environment Setup
-
-See the [README.md](../README.md) file in the parent directory for complete setup instructions, including:
-
-- Prerequisites installation
-- Azure OpenAI configuration
-- Durable Task Scheduler setup
-- Storage emulator configuration
-
-For this sample, you'll also need to install [node.js](https://nodejs.org/en/download) in order to use the [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector) tool.
-
-## Configuration
-
-Update your `local.settings.json` with your Azure OpenAI credentials:
-
-```json
-{
-  "Values": {
-    "AZURE_OPENAI_ENDPOINT": "https://your-resource.openai.azure.com/",
-    "AZURE_OPENAI_DEPLOYMENT_NAME": "your-deployment-name",
-    "AZURE_OPENAI_API_KEY": "your-api-key-if-not-using-rbac"
-  }
-}
-```
-
-## Running the Sample
-
-1. **Start the Function App**:
-
-   ```bash
-   cd dotnet/samples/04-hosting/DurableAgents/AzureFunctions/07_AgentAsMcpTool
-   func start
-   ```
-
-2. **Note the MCP Server Endpoint**: When the app starts, you'll see the MCP server endpoint in the terminal output. It will look like:
-
-   ```text
-   MCP server endpoint:  http://localhost:7071/runtime/webhooks/mcp
-   ```
-
-## Testing MCP Tool Integration
-
-Any MCP-compatible client can connect to the server endpoint and utilize the exposed agent tools. The agents will appear as callable tools within the MCP protocol.
-
-### Using MCP Inspector
-
-1. Run the [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector) from the command line:
-
-   ```bash
-   npx @modelcontextprotocol/inspector
-   ```
-
-1. Connect using the MCP server endpoint from your terminal output
-
-   - For **Transport Type**, select **"Streamable HTTP"**
-   - For **URL**, enter the MCP server endpoint `http://localhost:7071/runtime/webhooks/mcp`
-   - Click the **Connect** button
-
-1. Click the **List Tools** button to see the available MCP tools. You should see the `StockAdvisor` and `PlantAdvisor` tools.
-
-1. Test the available MCP tools:
-
-   - **StockAdvisor** - Set "MSFT ATH" (ATH is "all time high") as the query and click the **Run Tool** button.
-   - **PlantAdvisor** - Set "Low light in Seattle" as the query and click the **Run Tool** button.
-
-You'll see the results of the tool calls in the MCP Inspector interface under the **Tool Results** section. You should also see the results in the terminal where you ran the `func start` command.

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/07_AgentAsMcpTool/host.json

@@ -1,19 +0,0 @@
-{
-  "version": "2.0",
-  "logging": {
-    "logLevel": {
-      "Microsoft.Azure.Functions.DurableAgents": "Information",
-      "DurableTask": "Information",
-      "Microsoft.DurableTask": "Information"
-    }
-  },
-  "extensions": {
-    "durableTask": {
-      "hubName": "default",
-      "storageProvider": {
-        "type": "AzureManaged",
-        "connectionStringName": "DURABLE_TASK_SCHEDULER_CONNECTION_STRING"
-      }
-    }
-  }
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/08_ReliableStreaming/08_ReliableStreaming.csproj

@@ -1,47 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-  <PropertyGroup>
-    <TargetFrameworks>net10.0</TargetFrameworks>
-    <AzureFunctionsVersion>v4</AzureFunctionsVersion>
-    <OutputType>Exe</OutputType>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-    <!-- The Functions build tools don't like namespaces that start with a number -->
-    <AssemblyName>ReliableStreaming</AssemblyName>
-    <RootNamespace>ReliableStreaming</RootNamespace>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <FrameworkReference Include="Microsoft.AspNetCore.App" />
-  </ItemGroup>
-
-  <!-- Azure Functions packages -->
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Azure.Functions.Worker" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask.AzureManaged" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore" />
-    <PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" />
-  </ItemGroup>
-
-  <ItemGroup>
-    <PackageReference Include="Azure.AI.OpenAI" />
-    <PackageReference Include="Azure.Identity" />
-  </ItemGroup>
-
-  <!-- Redis for reliable streaming -->
-  <ItemGroup>
-    <PackageReference Include="StackExchange.Redis" />
-  </ItemGroup>
-
-  <!-- Local projects that should be switched to package references when using the sample outside of this MAF repo -->
-  <!--
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Agents.AI.Hosting.AzureFunctions" />
-    <PackageReference Include="Microsoft.Agents.AI.OpenAI" />
-  </ItemGroup>
-  -->
-  <ItemGroup>
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.Hosting.AzureFunctions\Microsoft.Agents.AI.Hosting.AzureFunctions.csproj" />
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.OpenAI\Microsoft.Agents.AI.OpenAI.csproj" />
-  </ItemGroup>
-</Project>

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/08_ReliableStreaming/FunctionTriggers.cs

@@ -1,335 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-using System.Text;
-using Microsoft.Agents.AI;
-using Microsoft.Agents.AI.DurableTask;
-using Microsoft.Agents.AI.Hosting.AzureFunctions;
-using Microsoft.AspNetCore.Http;
-using Microsoft.AspNetCore.Http.Features;
-using Microsoft.AspNetCore.Mvc;
-using Microsoft.Azure.Functions.Worker;
-using Microsoft.DurableTask.Client;
-using Microsoft.Extensions.Logging;
-
-namespace ReliableStreaming;
-
-/// <summary>
-/// HTTP trigger functions for reliable streaming of durable agent responses.
-/// </summary>
-/// <remarks>
-/// This class exposes two endpoints:
-/// <list type="bullet">
-/// <item>
-/// <term>Create</term>
-/// <description>Starts an agent run and streams responses. The response format depends on the
-/// <c>Accept</c> header: <c>text/plain</c> returns raw text (ideal for terminals), while
-/// <c>text/event-stream</c> or any other value returns Server-Sent Events (SSE).</description>
-/// </item>
-/// <item>
-/// <term>Stream</term>
-/// <description>Resumes a stream from a cursor position, enabling reliable message delivery</description>
-/// </item>
-/// </list>
-/// </remarks>
-public sealed class FunctionTriggers
-{
-    private readonly RedisStreamResponseHandler _streamHandler;
-    private readonly ILogger<FunctionTriggers> _logger;
-
-    /// <summary>
-    /// Initializes a new instance of the <see cref="FunctionTriggers"/> class.
-    /// </summary>
-    /// <param name="streamHandler">The Redis stream handler for reading/writing agent responses.</param>
-    /// <param name="logger">The logger instance.</param>
-    public FunctionTriggers(RedisStreamResponseHandler streamHandler, ILogger<FunctionTriggers> logger)
-    {
-        this._streamHandler = streamHandler;
-        this._logger = logger;
-    }
-
-    /// <summary>
-    /// Creates a new agent session, starts an agent run with the provided prompt,
-    /// and streams the response back to the client.
-    /// </summary>
-    /// <remarks>
-    /// <para>
-    /// The response format depends on the <c>Accept</c> header:
-    /// <list type="bullet">
-    /// <item><c>text/plain</c>: Returns raw text output, ideal for terminal display with curl</item>
-    /// <item><c>text/event-stream</c> or other: Returns Server-Sent Events (SSE) with cursor support</item>
-    /// </list>
-    /// </para>
-    /// <para>
-    /// The response includes an <c>x-conversation-id</c> header containing the conversation ID.
-    /// For SSE responses, clients can use this conversation ID to resume the stream if disconnected
-    /// by calling the <see cref="StreamAsync"/> endpoint with the conversation ID and the last received cursor.
-    /// </para>
-    /// <para>
-    /// Each SSE event contains the following fields:
-    /// <list type="bullet">
-    /// <item><c>id</c>: The Redis stream entry ID (use as cursor for resumption)</item>
-    /// <item><c>event</c>: Either "message" for content or "done" for stream completion</item>
-    /// <item><c>data</c>: The text content of the response chunk</item>
-    /// </list>
-    /// </para>
-    /// </remarks>
-    /// <param name="request">The HTTP request containing the prompt in the body.</param>
-    /// <param name="durableClient">The Durable Task client for signaling agents.</param>
-    /// <param name="context">The function invocation context.</param>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>A streaming response in the format specified by the Accept header.</returns>
-    [Function(nameof(CreateAsync))]
-    public async Task<IActionResult> CreateAsync(
-        [HttpTrigger(AuthorizationLevel.Anonymous, "post", Route = "agent/create")] HttpRequest request,
-        [DurableClient] DurableTaskClient durableClient,
-        FunctionContext context,
-        CancellationToken cancellationToken)
-    {
-        // Read the prompt from the request body
-        string prompt = await new StreamReader(request.Body).ReadToEndAsync(cancellationToken);
-        if (string.IsNullOrWhiteSpace(prompt))
-        {
-            return new BadRequestObjectResult("Request body must contain a prompt.");
-        }
-
-        AIAgent agentProxy = durableClient.AsDurableAgentProxy(context, "TravelPlanner");
-
-        // Create a new agent session
-        AgentSession session = await agentProxy.CreateSessionAsync(cancellationToken);
-        string agentSessionId = session.GetService<AgentSessionId>().ToString();
-
-        this._logger.LogInformation("Creating new agent session: {AgentSessionId}", agentSessionId);
-
-        // Run the agent in the background (fire-and-forget)
-        DurableAgentRunOptions options = new() { IsFireAndForget = true };
-        await agentProxy.RunAsync(prompt, session, options, cancellationToken);
-
-        this._logger.LogInformation("Agent run started for session: {AgentSessionId}", agentSessionId);
-
-        // Check Accept header to determine response format
-        // text/plain = raw text output (ideal for terminals)
-        // text/event-stream or other = SSE format (supports resumption)
-        string? acceptHeader = request.Headers.Accept.FirstOrDefault();
-        bool useSseFormat = acceptHeader?.Contains("text/plain", StringComparison.OrdinalIgnoreCase) != true;
-
-        return await this.StreamToClientAsync(
-            conversationId: agentSessionId, cursor: null, useSseFormat, request.HttpContext, cancellationToken);
-    }
-
-    /// <summary>
-    /// Resumes streaming from a specific cursor position for an existing session.
-    /// </summary>
-    /// <remarks>
-    /// <para>
-    /// Use this endpoint to resume a stream after disconnection. Pass the conversation ID
-    /// (from the <c>x-conversation-id</c> response header) and the last received cursor
-    /// (Redis stream entry ID) to continue from where you left off.
-    /// </para>
-    /// <para>
-    /// If no cursor is provided, streaming starts from the beginning of the stream.
-    /// This allows clients to replay the entire response if needed.
-    /// </para>
-    /// <para>
-    /// The response format depends on the <c>Accept</c> header:
-    /// <list type="bullet">
-    /// <item><c>text/plain</c>: Returns raw text output, ideal for terminal display with curl</item>
-    /// <item><c>text/event-stream</c> or other: Returns Server-Sent Events (SSE) with cursor support</item>
-    /// </list>
-    /// </para>
-    /// </remarks>
-    /// <param name="request">The HTTP request. Use the <c>cursor</c> query parameter to specify the cursor position.</param>
-    /// <param name="conversationId">The conversation ID to stream from.</param>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>A streaming response in the format specified by the Accept header.</returns>
-    [Function(nameof(StreamAsync))]
-    public async Task<IActionResult> StreamAsync(
-        [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = "agent/stream/{conversationId}")] HttpRequest request,
-        string conversationId,
-        CancellationToken cancellationToken)
-    {
-        if (string.IsNullOrWhiteSpace(conversationId))
-        {
-            return new BadRequestObjectResult("Conversation ID is required.");
-        }
-
-        // Get the cursor from query string (optional)
-        string? cursor = request.Query["cursor"].FirstOrDefault();
-
-        this._logger.LogInformation(
-            "Resuming stream for conversation {ConversationId} from cursor: {Cursor}",
-            SanitizeLogValue(conversationId),
-            SanitizeLogValue(cursor) ?? "(beginning)");
-
-        // Check Accept header to determine response format
-        // text/plain = raw text output (ideal for terminals)
-        // text/event-stream or other = SSE format (supports cursor-based resumption)
-        string? acceptHeader = request.Headers.Accept.FirstOrDefault();
-        bool useSseFormat = acceptHeader?.Contains("text/plain", StringComparison.OrdinalIgnoreCase) != true;
-
-        return await this.StreamToClientAsync(conversationId, cursor, useSseFormat, request.HttpContext, cancellationToken);
-    }
-
-    /// <summary>
-    /// Streams chunks from the Redis stream to the HTTP response.
-    /// </summary>
-    /// <param name="conversationId">The conversation ID to stream from.</param>
-    /// <param name="cursor">Optional cursor to resume from. If null, streams from the beginning.</param>
-    /// <param name="useSseFormat">True to use SSE format, false for plain text.</param>
-    /// <param name="httpContext">The HTTP context for writing the response.</param>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>An empty result after streaming completes.</returns>
-    private async Task<IActionResult> StreamToClientAsync(
-        string conversationId,
-        string? cursor,
-        bool useSseFormat,
-        HttpContext httpContext,
-        CancellationToken cancellationToken)
-    {
-        // Set response headers based on format
-        httpContext.Response.Headers.ContentType = useSseFormat
-            ? "text/event-stream"
-            : "text/plain; charset=utf-8";
-        httpContext.Response.Headers.CacheControl = "no-cache";
-        httpContext.Response.Headers.Connection = "keep-alive";
-        httpContext.Response.Headers["x-conversation-id"] = conversationId;
-
-        // Disable response buffering if supported
-        httpContext.Features.Get<IHttpResponseBodyFeature>()?.DisableBuffering();
-
-        try
-        {
-            await foreach (StreamChunk chunk in this._streamHandler.ReadStreamAsync(
-                conversationId,
-                cursor,
-                cancellationToken))
-            {
-                if (chunk.Error != null)
-                {
-                    this._logger.LogWarning("Stream error for conversation {ConversationId}: {Error}", SanitizeLogValue(conversationId), chunk.Error);
-                    await WriteErrorAsync(httpContext.Response, chunk.Error, useSseFormat, cancellationToken);
-                    break;
-                }
-
-                if (chunk.IsDone)
-                {
-                    await WriteEndOfStreamAsync(httpContext.Response, chunk.EntryId, useSseFormat, cancellationToken);
-                    break;
-                }
-
-                if (chunk.Text != null)
-                {
-                    await WriteChunkAsync(httpContext.Response, chunk, useSseFormat, cancellationToken);
-                }
-            }
-        }
-        catch (OperationCanceledException)
-        {
-            this._logger.LogInformation("Client disconnected from stream {ConversationId}", SanitizeLogValue(conversationId));
-        }
-
-        return new EmptyResult();
-    }
-
-    /// <summary>
-    /// Writes a text chunk to the response.
-    /// </summary>
-    private static async Task WriteChunkAsync(
-        HttpResponse response,
-        StreamChunk chunk,
-        bool useSseFormat,
-        CancellationToken cancellationToken)
-    {
-        if (useSseFormat)
-        {
-            await WriteSSEEventAsync(response, "message", chunk.Text!, chunk.EntryId);
-        }
-        else
-        {
-            await response.WriteAsync(chunk.Text!, cancellationToken);
-        }
-
-        await response.Body.FlushAsync(cancellationToken);
-    }
-
-    /// <summary>
-    /// Writes an end-of-stream marker to the response.
-    /// </summary>
-    private static async Task WriteEndOfStreamAsync(
-        HttpResponse response,
-        string entryId,
-        bool useSseFormat,
-        CancellationToken cancellationToken)
-    {
-        if (useSseFormat)
-        {
-            await WriteSSEEventAsync(response, "done", "[DONE]", entryId);
-        }
-        else
-        {
-            await response.WriteAsync("\n", cancellationToken);
-        }
-
-        await response.Body.FlushAsync(cancellationToken);
-    }
-
-    /// <summary>
-    /// Writes an error message to the response.
-    /// </summary>
-    private static async Task WriteErrorAsync(
-        HttpResponse response,
-        string error,
-        bool useSseFormat,
-        CancellationToken cancellationToken)
-    {
-        if (useSseFormat)
-        {
-            await WriteSSEEventAsync(response, "error", error, null);
-        }
-        else
-        {
-            await response.WriteAsync($"\n[Error: {error}]\n", cancellationToken);
-        }
-
-        await response.Body.FlushAsync(cancellationToken);
-    }
-
-    /// <summary>
-    /// Writes a Server-Sent Event to the response stream.
-    /// </summary>
-    private static async Task WriteSSEEventAsync(
-        HttpResponse response,
-        string eventType,
-        string data,
-        string? id)
-    {
-        StringBuilder sb = new();
-
-        // Include the ID if provided (used as cursor for resumption)
-        if (!string.IsNullOrEmpty(id))
-        {
-            sb.AppendLine($"id: {id}");
-        }
-
-        sb.AppendLine($"event: {eventType}");
-        sb.AppendLine($"data: {data}");
-        sb.AppendLine(); // Empty line marks end of event
-
-        await response.WriteAsync(sb.ToString());
-    }
-
-    /// <summary>
-    /// Sanitizes a user-provided value for safe inclusion in log entries
-    /// by removing control characters that could be used for log forging.
-    /// </summary>
-    private static string? SanitizeLogValue(string? value)
-    {
-        if (value is null)
-        {
-            return null;
-        }
-
-        return value
-            .Replace("\r", string.Empty, StringComparison.Ordinal)
-            .Replace("\n", string.Empty, StringComparison.Ordinal);
-    }
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/08_ReliableStreaming/Program.cs

@@ -1,105 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-// This sample demonstrates how to implement reliable streaming for durable agents using Redis Streams.
-// It exposes two HTTP endpoints:
-// 1. Create - Starts an agent run and streams responses back via Server-Sent Events (SSE)
-// 2. Stream - Resumes a stream from a specific cursor position, enabling reliable message delivery
-//
-// This pattern is inspired by OpenAI's background mode for the Responses API, which allows clients
-// to disconnect and reconnect to ongoing agent responses without losing messages.
-
-#pragma warning disable IDE0002 // Simplify Member Access
-
-using Azure;
-using Azure.AI.OpenAI;
-using Azure.Identity;
-using Microsoft.Agents.AI.DurableTask;
-using Microsoft.Agents.AI.Hosting.AzureFunctions;
-using Microsoft.Azure.Functions.Worker.Builder;
-using Microsoft.Extensions.AI;
-using Microsoft.Extensions.DependencyInjection;
-using Microsoft.Extensions.Hosting;
-using OpenAI.Chat;
-using ReliableStreaming;
-using StackExchange.Redis;
-
-// Get the Azure OpenAI endpoint and deployment name from environment variables.
-string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_ENDPOINT is not set.");
-string deploymentName = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT_NAME")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_DEPLOYMENT_NAME is not set.");
-
-// Get Redis connection string from environment variable.
-string redisConnectionString = Environment.GetEnvironmentVariable("REDIS_CONNECTION_STRING")
-    ?? "localhost:6379";
-
-// Get the Redis stream TTL from environment variable (default: 10 minutes).
-int redisStreamTtlMinutes = int.TryParse(
-    Environment.GetEnvironmentVariable("REDIS_STREAM_TTL_MINUTES"),
-    out int ttlMinutes) ? ttlMinutes : 10;
-
-// Use Azure Key Credential if provided, otherwise use Azure CLI Credential.
-string? azureOpenAiKey = System.Environment.GetEnvironmentVariable("AZURE_OPENAI_API_KEY");
-// WARNING: DefaultAzureCredential is convenient for development but requires careful consideration in production.
-// In production, consider using a specific credential (e.g., ManagedIdentityCredential) to avoid
-// latency issues, unintended credential probing, and potential security risks from fallback mechanisms.
-AzureOpenAIClient client = !string.IsNullOrEmpty(azureOpenAiKey)
-    ? new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(azureOpenAiKey))
-    : new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential());
-
-// Travel Planner agent instructions - designed to produce longer responses for demonstrating streaming.
-const string TravelPlannerName = "TravelPlanner";
-const string TravelPlannerInstructions =
-    """
-    You are an expert travel planner who creates detailed, personalized travel itineraries.
-    When asked to plan a trip, you should:
-    1. Create a comprehensive day-by-day itinerary
-    2. Include specific recommendations for activities, restaurants, and attractions
-    3. Provide practical tips for each destination
-    4. Consider weather and local events when making recommendations
-    5. Include estimated times and logistics between activities
-    
-    Always use the available tools to get current weather forecasts and local events
-    for the destination to make your recommendations more relevant and timely.
-    
-    Format your response with clear headings for each day and include emoji icons
-    to make the itinerary easy to scan and visually appealing.
-    """;
-
-// Configure the function app to host the AI agent.
-FunctionsApplicationBuilder builder = FunctionsApplication
-    .CreateBuilder(args)
-    .ConfigureFunctionsWebApplication()
-    .ConfigureDurableAgents(options =>
-    {
-        // Define the Travel Planner agent with tools for weather and events
-        options.AddAIAgentFactory(TravelPlannerName, sp =>
-        {
-            return client.GetChatClient(deploymentName).AsAIAgent(
-                instructions: TravelPlannerInstructions,
-                name: TravelPlannerName,
-                services: sp,
-                tools: [
-                    AIFunctionFactory.Create(TravelTools.GetWeatherForecast),
-                    AIFunctionFactory.Create(TravelTools.GetLocalEvents),
-                ]);
-        });
-    });
-
-// Register Redis connection as a singleton
-builder.Services.AddSingleton<IConnectionMultiplexer>(_ =>
-    ConnectionMultiplexer.Connect(redisConnectionString));
-
-// Register the Redis stream response handler - this captures agent responses
-// and publishes them to Redis Streams for reliable delivery.
-// Registered as both the concrete type (for FunctionTriggers) and the interface (for the agent framework).
-builder.Services.AddSingleton(sp =>
-    new RedisStreamResponseHandler(
-        sp.GetRequiredService<IConnectionMultiplexer>(),
-        TimeSpan.FromMinutes(redisStreamTtlMinutes)));
-builder.Services.AddSingleton<IAgentResponseHandler>(sp =>
-    sp.GetRequiredService<RedisStreamResponseHandler>());
-
-using IHost app = builder.Build();
-
-app.Run();

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/08_ReliableStreaming/README.md

@@ -1,264 +0,0 @@
-# Reliable Streaming with Redis
-
-This sample demonstrates how to implement reliable streaming for durable agents using Redis Streams as a message broker. It enables clients to disconnect and reconnect to ongoing agent responses without losing messages, inspired by [OpenAI's background mode](https://platform.openai.com/docs/guides/background) for the Responses API.
-
-## Key Concepts Demonstrated
-
-- **Reliable message delivery**: Agent responses are persisted to Redis Streams, allowing clients to resume from any point
-- **Content negotiation**: Use `Accept: text/plain` for raw terminal output, or `Accept: text/event-stream` for SSE format
-- **Server-Sent Events (SSE)**: Standard streaming format that works with `curl`, browsers, and most HTTP clients
-- **Cursor-based resumption**: Each SSE event includes an `id` field that can be used to resume the stream
-- **Fire-and-forget agent invocation**: The agent runs in the background while the client streams from Redis via an HTTP trigger function
-
-## Environment Setup
-
-See the [README.md](../README.md) file in the parent directory for more information on how to configure the environment, including how to install and run common sample dependencies.
-
-### Additional Requirements: Redis
-
-This sample requires a Redis instance. Start a local Redis instance using Docker:
-
-```bash
-docker run -d --name redis -p 6379:6379 redis:latest
-```
-
-To verify Redis is running:
-
-```bash
-docker ps | grep redis
-```
-
-## Running the Sample
-
-Start the Azure Functions host:
-
-```bash
-func start
-```
-
-### 1. Test Streaming with curl
-
-Open a new terminal and start a travel planning request. Use the `-i` flag to see response headers (including the conversation ID) and `Accept: text/plain` for raw text output:
-
-**Bash (Linux/macOS/WSL):**
-
-```bash
-curl -i -N -X POST http://localhost:7071/api/agent/create \
-  -H "Content-Type: text/plain" \
-  -H "Accept: text/plain" \
-  -d "Plan a 7-day trip to Tokyo, Japan for next month. Include daily activities, restaurant recommendations, and tips for getting around."
-```
-
-**PowerShell:**
-
-```powershell
-curl -i -N -X POST http://localhost:7071/api/agent/create `
-  -H "Content-Type: text/plain" `
-  -H "Accept: text/plain" `
-  -d "Plan a 7-day trip to Tokyo, Japan for next month. Include daily activities, restaurant recommendations, and tips for getting around."
-```
-
-You'll first see the response headers, including:
-
-```text
-HTTP/1.1 200 OK
-Content-Type: text/plain; charset=utf-8
-x-conversation-id: @dafx-travelplanner@a1b2c3d4e5f67890abcdef1234567890
-...
-```
-
-Then the agent's response will stream to your terminal in chunks, similar to a ChatGPT-style experience (though not character-by-character).
-
-> **Note:** The `-N` flag in curl disables output buffering, which is essential for seeing the stream in real-time. The `-i` flag includes the HTTP headers in the output.
-
-### 2. Demonstrate Stream Interruption and Resumption
-
-This is the key feature of reliable streaming! Follow these steps to see it in action:
-
-#### Step 1: Start a stream and note the conversation ID
-
-Run the curl command from step 1. Watch for the `x-conversation-id` header in the response - **copy this value**, you'll need it to resume.
-
-```text
-x-conversation-id: @dafx-travelplanner@a1b2c3d4e5f67890abcdef1234567890
-```
-
-#### Step 2: Interrupt the stream
-
-While the agent is still generating text, press **`Ctrl+C`** to interrupt the stream. The agent continues running in the background - your messages are being saved to Redis!
-
-#### Step 3: Resume the stream
-
-Use the conversation ID you copied to resume streaming from where you left off. Include the `Accept: text/plain` header to get raw text output:
-
-**Bash (Linux/macOS/WSL):**
-
-```bash
-# Replace with your actual conversation ID from the x-conversation-id header
-CONVERSATION_ID="@dafx-travelplanner@a1b2c3d4e5f67890abcdef1234567890"
-
-curl -N -H "Accept: text/plain" "http://localhost:7071/api/agent/stream/${CONVERSATION_ID}"
-```
-
-**PowerShell:**
-
-```powershell
-# Replace with your actual conversation ID from the x-conversation-id header
-$conversationId = "@dafx-travelplanner@a1b2c3d4e5f67890abcdef1234567890"
-
-curl -N -H "Accept: text/plain" "http://localhost:7071/api/agent/stream/$conversationId"
-```
-
-You'll see the **entire response replayed from the beginning**, including the parts you already received before interrupting.
-
-#### Step 4 (Advanced): Resume from a specific cursor
-
-If you're using SSE format, each event includes an `id` field that you can use as a cursor to resume from a specific point:
-
-```bash
-# Resume from a specific cursor position
-curl -N "http://localhost:7071/api/agent/stream/${CONVERSATION_ID}?cursor=1734567890123-0"
-```
-
-### 3. Alternative: SSE Format for Programmatic Clients
-
-If you need the full Server-Sent Events format with cursors for resumable streaming, use `Accept: text/event-stream` (or omit the Accept header):
-
-```bash
-curl -i -N -X POST http://localhost:7071/api/agent/create \
-  -H "Content-Type: text/plain" \
-  -H "Accept: text/event-stream" \
-  -d "Plan a 7-day trip to Tokyo, Japan."
-```
-
-This returns SSE-formatted events with `id`, `event`, and `data` fields:
-
-```text
-id: 1734567890123-0
-event: message
-data: # 7-Day Tokyo Adventure
-
-id: 1734567890124-0
-event: message
-data: ## Day 1: Arrival and Exploration
-
-id: 1734567890999-0
-event: done
-data: [DONE]
-```
-
-The `id` field is the Redis stream entry ID - use it as the `cursor` parameter to resume from that exact point.
-
-### Understanding the Response Headers
-
-| Header | Description |
-|--------|-------------|
-| `x-conversation-id` | The conversation ID (session key). Use this to resume the stream. |
-| `Content-Type` | Either `text/plain` or `text/event-stream` depending on your `Accept` header. |
-| `Cache-Control` | Set to `no-cache` to prevent caching of the stream. |
-
-## Architecture Overview
-
-```text
-┌─────────────┐      POST /agent/create     ┌─────────────────────┐
-│   Client    │  (Accept: text/plain or SSE)│  Azure Functions    │
-│   (curl)    │ ──────────────────────────► │  (FunctionTriggers) │
-└─────────────┘                             └──────────┬──────────┘
-       ▲                                               │
-       │ Text or SSE stream                  Signal Entity
-       │                                               │
-       │                                               ▼
-       │                                    ┌─────────────────────┐
-       │                                    │   AgentEntity       │
-       │                                    │   (Durable Entity)  │
-       │                                    └──────────┬──────────┘
-       │                                               │
-       │                                    IAgentResponseHandler
-       │                                               │
-       │                                               ▼
-       │                                    ┌─────────────────────┐
-       │                                    │ RedisStreamResponse │
-       │                                    │      Handler        │
-       │                                    └──────────┬──────────┘
-       │                                               │
-       │                                     XADD (write)
-       │                                               │
-       │                                               ▼
-       │                                    ┌─────────────────────┐
-       └─────────── XREAD (poll) ────────── │   Redis Streams     │
-                                            │  (Durable Log)      │
-                                            └─────────────────────┘
-```
-
-### Data Flow
-
-1. **Client sends prompt**: The `Create` endpoint receives the prompt and generates a new agent thread.
-
-2. **Agent invoked**: The durable entity (`AgentEntity`) is signaled to run the travel planner agent. This is fire-and-forget from the HTTP request's perspective.
-
-3. **Responses captured**: As the agent generates responses, `RedisStreamResponseHandler` (implementing `IAgentResponseHandler`) extracts the text from each `AgentResponseUpdate` and publishes it to a Redis Stream keyed by session ID.
-
-4. **Client polls Redis**: The HTTP response streams events by polling the Redis Stream. For SSE format, each event includes the Redis entry ID as the `id` field.
-
-5. **Resumption**: If the client disconnects, it can call the `Stream` endpoint with the conversation ID (from the `x-conversation-id` header) and optionally the last received cursor to resume from that point.
-
-## Message Delivery Guarantees
-
-This sample provides **at-least-once delivery** with the following characteristics:
-
-- **Durability**: Messages are persisted to Redis Streams with configurable TTL (default: 10 minutes).
-- **Ordering**: Messages are delivered in order within a session.
-- **Resumption**: Clients can resume from any point using cursor-based pagination.
-- **Replay**: Clients can replay the entire stream by omitting the cursor.
-
-### Important Considerations
-
-- **No exactly-once delivery**: If a client disconnects exactly when receiving a message, it may receive that message again upon resumption. Clients should handle duplicate messages idempotently.
-- **TTL expiration**: Streams expire after the configured TTL. Clients cannot resume streams that have expired.
-- **Redis guarantees**: Redis streams are backed by Redis persistence mechanisms (RDB/AOF). Ensure your Redis instance is configured for durability as needed.
-
-## When to Use These Patterns
-
-The patterns demonstrated in this sample are ideal for:
-
-- **Long-running agent tasks**: When agent responses take minutes to complete (e.g., deep research, complex planning)
-- **Unreliable network connections**: Mobile apps, unstable WiFi, or connections that may drop
-- **Resumable experiences**: Users should be able to close and reopen an app without losing context
-- **Background processing**: When you want to fire off a task and check on it later
-
-These patterns may be overkill for:
-
-- **Simple, fast responses**: If responses complete in a few seconds, standard streaming is simpler
-- **Stateless interactions**: If there's no need to resume or replay conversations
-- **Very high throughput**: Redis adds latency; for maximum throughput, direct streaming may be better
-
-## Configuration
-
-| Environment Variable | Description | Default |
-|---------------------|-------------|---------|
-| `REDIS_CONNECTION_STRING` | Redis connection string | `localhost:6379` |
-| `REDIS_STREAM_TTL_MINUTES` | How long streams are retained after last write | `10` |
-| `AZURE_OPENAI_ENDPOINT` | Azure OpenAI endpoint URL | (required) |
-| `AZURE_OPENAI_DEPLOYMENT_NAME` | Azure OpenAI deployment name | (required) |
-| `AZURE_OPENAI_API_KEY` | API key (optional, uses Azure CLI auth if not set) | (optional) |
-
-## Cleanup
-
-To stop and remove the Redis Docker containers:
-
-```bash
-docker stop redis
-docker rm redis
-```
-
-## Disclaimer
-
-> ⚠️ **This sample is for illustration purposes only and is not intended to be production-ready.**
->
-> A production implementation should consider:
->
-> - Redis cluster configuration for high availability
-> - Authentication and authorization for the streaming endpoints
-> - Rate limiting and abuse prevention
-> - Monitoring and alerting for stream health
-> - Graceful handling of Redis failures

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/08_ReliableStreaming/RedisStreamResponseHandler.cs

@@ -1,212 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-using System.Runtime.CompilerServices;
-using Microsoft.Agents.AI;
-using Microsoft.Agents.AI.DurableTask;
-using StackExchange.Redis;
-
-namespace ReliableStreaming;
-
-/// <summary>
-/// Represents a chunk of data read from a Redis stream.
-/// </summary>
-/// <param name="EntryId">The Redis stream entry ID (can be used as a cursor for resumption).</param>
-/// <param name="Text">The text content of the chunk, or null if this is a completion/error marker.</param>
-/// <param name="IsDone">True if this chunk marks the end of the stream.</param>
-/// <param name="Error">An error message if something went wrong, or null otherwise.</param>
-public readonly record struct StreamChunk(string EntryId, string? Text, bool IsDone, string? Error);
-
-/// <summary>
-/// An implementation of <see cref="IAgentResponseHandler"/> that publishes agent response updates
-/// to Redis Streams for reliable delivery. This enables clients to disconnect and reconnect
-/// to ongoing agent responses without losing messages.
-/// </summary>
-/// <remarks>
-/// <para>
-/// Redis Streams provide a durable, append-only log that supports consumer groups and message
-/// acknowledgment. This implementation uses auto-generated IDs (which are timestamp-based)
-/// as sequence numbers, allowing clients to resume from any point in the stream.
-/// </para>
-/// <para>
-/// Each agent session gets its own Redis Stream, keyed by session ID. The stream entries
-/// contain text chunks extracted from <see cref="AgentResponseUpdate"/> objects.
-/// </para>
-/// </remarks>
-public sealed class RedisStreamResponseHandler : IAgentResponseHandler
-{
-    private const int MaxEmptyReads = 300; // 5 minutes at 1 second intervals
-    private const int PollIntervalMs = 1000;
-
-    private readonly IConnectionMultiplexer _redis;
-    private readonly TimeSpan _streamTtl;
-
-    /// <summary>
-    /// Initializes a new instance of the <see cref="RedisStreamResponseHandler" /> class.
-    /// </summary>
-    /// <param name="redis">The Redis connection multiplexer.</param>
-    /// <param name="streamTtl">The time-to-live for stream entries. Streams will expire after this duration of inactivity.</param>
-    public RedisStreamResponseHandler(IConnectionMultiplexer redis, TimeSpan streamTtl)
-    {
-        this._redis = redis;
-        this._streamTtl = streamTtl;
-    }
-
-    /// <inheritdoc/>
-    public async ValueTask OnStreamingResponseUpdateAsync(
-        IAsyncEnumerable<AgentResponseUpdate> messageStream,
-        CancellationToken cancellationToken)
-    {
-        // Get the current session ID from the DurableAgentContext
-        // This is set by the AgentEntity before invoking the response handler
-        DurableAgentContext? context = DurableAgentContext.Current;
-        if (context is null)
-        {
-            throw new InvalidOperationException(
-                "DurableAgentContext.Current is not set. This handler must be used within a durable agent context.");
-        }
-
-        // Get session ID from the current session context, which is only available in the context of
-        // a durable agent execution.
-        string agentSessionId = context.CurrentSession.GetService<AgentSessionId>().ToString();
-        string streamKey = GetStreamKey(agentSessionId);
-
-        IDatabase db = this._redis.GetDatabase();
-        int sequenceNumber = 0;
-
-        await foreach (AgentResponseUpdate update in messageStream.WithCancellation(cancellationToken))
-        {
-            // Extract just the text content - this avoids serialization round-trip issues
-            string text = update.Text;
-
-            // Only publish non-empty text chunks
-            if (!string.IsNullOrEmpty(text))
-            {
-                // Create the stream entry with the text and metadata
-                NameValueEntry[] entries =
-                [
-                    new NameValueEntry("text", text),
-                    new NameValueEntry("sequence", sequenceNumber++),
-                    new NameValueEntry("timestamp", DateTimeOffset.UtcNow.ToUnixTimeMilliseconds()),
-                ];
-
-                // Add to the Redis Stream with auto-generated ID (timestamp-based)
-                await db.StreamAddAsync(streamKey, entries);
-
-                // Refresh the TTL on each write to keep the stream alive during active streaming
-                await db.KeyExpireAsync(streamKey, this._streamTtl);
-            }
-        }
-
-        // Add a sentinel entry to mark the end of the stream
-        NameValueEntry[] endEntries =
-        [
-            new NameValueEntry("text", ""),
-            new NameValueEntry("sequence", sequenceNumber),
-            new NameValueEntry("timestamp", DateTimeOffset.UtcNow.ToUnixTimeMilliseconds()),
-            new NameValueEntry("done", "true"),
-        ];
-        await db.StreamAddAsync(streamKey, endEntries);
-
-        // Set final TTL - the stream will be cleaned up after this duration
-        await db.KeyExpireAsync(streamKey, this._streamTtl);
-    }
-
-    /// <inheritdoc/>
-    public ValueTask OnAgentResponseAsync(AgentResponse message, CancellationToken cancellationToken)
-    {
-        // This handler is optimized for streaming responses.
-        // For non-streaming responses, we don't need to store in Redis since
-        // the response is returned directly to the caller.
-        return ValueTask.CompletedTask;
-    }
-
-    /// <summary>
-    /// Reads chunks from a Redis stream for the given session, yielding them as they become available.
-    /// </summary>
-    /// <param name="conversationId">The conversation ID to read from.</param>
-    /// <param name="cursor">Optional cursor to resume from. If null, reads from the beginning.</param>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>An async enumerable of stream chunks.</returns>
-    public async IAsyncEnumerable<StreamChunk> ReadStreamAsync(
-        string conversationId,
-        string? cursor,
-        [EnumeratorCancellation] CancellationToken cancellationToken)
-    {
-        string streamKey = GetStreamKey(conversationId);
-
-        IDatabase db = this._redis.GetDatabase();
-        string startId = string.IsNullOrEmpty(cursor) ? "0-0" : cursor;
-
-        int emptyReadCount = 0;
-        bool hasSeenData = false;
-
-        while (!cancellationToken.IsCancellationRequested)
-        {
-            StreamEntry[]? entries = null;
-            string? errorMessage = null;
-
-            try
-            {
-                entries = await db.StreamReadAsync(streamKey, startId, count: 100);
-            }
-            catch (Exception ex)
-            {
-                errorMessage = ex.Message;
-            }
-
-            if (errorMessage != null)
-            {
-                yield return new StreamChunk(startId, null, false, errorMessage);
-                yield break;
-            }
-
-            // entries is guaranteed to be non-null if errorMessage is null
-            if (entries!.Length == 0)
-            {
-                if (!hasSeenData)
-                {
-                    emptyReadCount++;
-                    if (emptyReadCount >= MaxEmptyReads)
-                    {
-                        yield return new StreamChunk(
-                            startId,
-                            null,
-                            false,
-                            $"Stream not found or timed out after {MaxEmptyReads * PollIntervalMs / 1000} seconds");
-                        yield break;
-                    }
-                }
-
-                await Task.Delay(PollIntervalMs, cancellationToken);
-                continue;
-            }
-
-            hasSeenData = true;
-
-            foreach (StreamEntry entry in entries)
-            {
-                startId = entry.Id.ToString();
-                string? text = entry["text"];
-                string? done = entry["done"];
-
-                if (done == "true")
-                {
-                    yield return new StreamChunk(startId, null, true, null);
-                    yield break;
-                }
-
-                if (!string.IsNullOrEmpty(text))
-                {
-                    yield return new StreamChunk(startId, text, false, null);
-                }
-            }
-        }
-    }
-
-    /// <summary>
-    /// Gets the Redis Stream key for a given conversation ID.
-    /// </summary>
-    /// <param name="conversationId">The conversation ID.</param>
-    /// <returns>The Redis Stream key.</returns>
-    internal static string GetStreamKey(string conversationId) => $"agent-stream:{conversationId}";
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/08_ReliableStreaming/Tools.cs

@@ -1,161 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-using System.ComponentModel;
-
-namespace ReliableStreaming;
-
-/// <summary>
-/// Mock travel tools that return hardcoded data for demonstration purposes.
-/// In a real application, these would call actual weather and events APIs.
-/// </summary>
-internal static class TravelTools
-{
-    /// <summary>
-    /// Gets a weather forecast for a destination on a specific date.
-    /// Returns mock weather data for demonstration purposes.
-    /// </summary>
-    /// <param name="destination">The destination city or location.</param>
-    /// <param name="date">The date for the forecast (e.g., "2025-01-15" or "next Monday").</param>
-    /// <returns>A weather forecast summary.</returns>
-    [Description("Gets the weather forecast for a destination on a specific date. Use this to provide weather-aware recommendations in the itinerary.")]
-    public static string GetWeatherForecast(string destination, string date)
-    {
-        // Mock weather data based on destination for realistic responses
-        Dictionary<string, (string condition, int highF, int lowF)> weatherByRegion = new(StringComparer.OrdinalIgnoreCase)
-        {
-            ["Tokyo"] = ("Partly cloudy with a chance of light rain", 58, 45),
-            ["Paris"] = ("Overcast with occasional drizzle", 52, 41),
-            ["New York"] = ("Clear and cold", 42, 28),
-            ["London"] = ("Foggy morning, clearing in afternoon", 48, 38),
-            ["Sydney"] = ("Sunny and warm", 82, 68),
-            ["Rome"] = ("Sunny with light breeze", 62, 48),
-            ["Barcelona"] = ("Partly sunny", 59, 47),
-            ["Amsterdam"] = ("Cloudy with light rain", 46, 38),
-            ["Dubai"] = ("Sunny and hot", 85, 72),
-            ["Singapore"] = ("Tropical thunderstorms in afternoon", 88, 77),
-            ["Bangkok"] = ("Hot and humid, afternoon showers", 91, 78),
-            ["Los Angeles"] = ("Sunny and pleasant", 72, 55),
-            ["San Francisco"] = ("Morning fog, afternoon sun", 62, 52),
-            ["Seattle"] = ("Rainy with breaks", 48, 40),
-            ["Miami"] = ("Warm and sunny", 78, 65),
-            ["Honolulu"] = ("Tropical paradise weather", 82, 72),
-        };
-
-        // Find a matching destination or use a default
-        (string condition, int highF, int lowF) forecast = ("Partly cloudy", 65, 50);
-        foreach (KeyValuePair<string, (string, int, int)> entry in weatherByRegion)
-        {
-            if (destination.Contains(entry.Key, StringComparison.OrdinalIgnoreCase))
-            {
-                forecast = entry.Value;
-                break;
-            }
-        }
-
-        return $"""
-            Weather forecast for {destination} on {date}:
-            Conditions: {forecast.condition}
-            High: {forecast.highF}°F ({(forecast.highF - 32) * 5 / 9}°C)
-            Low: {forecast.lowF}°F ({(forecast.lowF - 32) * 5 / 9}°C)
-            
-            Recommendation: {GetWeatherRecommendation(forecast.condition)}
-            """;
-    }
-
-    /// <summary>
-    /// Gets local events happening at a destination around a specific date.
-    /// Returns mock event data for demonstration purposes.
-    /// </summary>
-    /// <param name="destination">The destination city or location.</param>
-    /// <param name="date">The date to search for events (e.g., "2025-01-15" or "next week").</param>
-    /// <returns>A list of local events and activities.</returns>
-    [Description("Gets local events and activities happening at a destination around a specific date. Use this to suggest timely activities and experiences.")]
-    public static string GetLocalEvents(string destination, string date)
-    {
-        // Mock events data based on destination
-        Dictionary<string, string[]> eventsByCity = new(StringComparer.OrdinalIgnoreCase)
-        {
-            ["Tokyo"] = [
-                "🎭 Kabuki Theater Performance at Kabukiza Theatre - Traditional Japanese drama",
-                "🌸 Winter Illuminations at Yoyogi Park - Spectacular light displays",
-                "🍜 Ramen Festival at Tokyo Station - Sample ramen from across Japan",
-                "🎮 Gaming Expo at Tokyo Big Sight - Latest video games and technology",
-            ],
-            ["Paris"] = [
-                "🎨 Impressionist Exhibition at Musée d'Orsay - Extended evening hours",
-                "🍷 Wine Tasting Tour in Le Marais - Local sommelier guided",
-                "🎵 Jazz Night at Le Caveau de la Huchette - Historic jazz club",
-                "🥐 French Pastry Workshop - Learn from master pâtissiers",
-            ],
-            ["New York"] = [
-                "🎭 Broadway Show: Hamilton - Limited engagement performances",
-                "🏀 Knicks vs Lakers at Madison Square Garden",
-                "🎨 Modern Art Exhibit at MoMA - New installations",
-                "🍕 Pizza Walking Tour of Brooklyn - Artisan pizzerias",
-            ],
-            ["London"] = [
-                "👑 Royal Collection Exhibition at Buckingham Palace",
-                "🎭 West End Musical: The Phantom of the Opera",
-                "🍺 Craft Beer Festival at Brick Lane",
-                "🎪 Winter Wonderland at Hyde Park - Rides and markets",
-            ],
-            ["Sydney"] = [
-                "🏄 Pro Surfing Competition at Bondi Beach",
-                "🎵 Opera at Sydney Opera House - La Bohème",
-                "🦘 Wildlife Night Safari at Taronga Zoo",
-                "🍽️ Harbor Dinner Cruise with fireworks",
-            ],
-            ["Rome"] = [
-                "🏛️ After-Hours Vatican Tour - Skip the crowds",
-                "🍝 Pasta Making Class in Trastevere",
-                "🎵 Classical Concert at Borghese Gallery",
-                "🍷 Wine Tasting in Roman Cellars",
-            ],
-        };
-
-        // Find events for the destination or use generic events
-        string[] events = [
-            "🎭 Local theater performance",
-            "🍽️ Food and wine festival",
-            "🎨 Art gallery opening",
-            "🎵 Live music at local venues",
-        ];
-
-        foreach (KeyValuePair<string, string[]> entry in eventsByCity)
-        {
-            if (destination.Contains(entry.Key, StringComparison.OrdinalIgnoreCase))
-            {
-                events = entry.Value;
-                break;
-            }
-        }
-
-        string eventList = string.Join("\n• ", events);
-        return $"""
-            Local events in {destination} around {date}:
-            
-            • {eventList}
-            
-            💡 Tip: Book popular events in advance as they may sell out quickly!
-            """;
-    }
-
-    private static string GetWeatherRecommendation(string condition)
-    {
-        // Use case-insensitive comparison instead of ToLowerInvariant() to satisfy CA1308
-        return condition switch
-        {
-            string c when c.Contains("rain", StringComparison.OrdinalIgnoreCase) || c.Contains("drizzle", StringComparison.OrdinalIgnoreCase) =>
-                "Bring an umbrella and waterproof jacket. Consider indoor activities for backup.",
-            string c when c.Contains("fog", StringComparison.OrdinalIgnoreCase) =>
-                "Morning visibility may be limited. Plan outdoor sightseeing for afternoon.",
-            string c when c.Contains("cold", StringComparison.OrdinalIgnoreCase) =>
-                "Layer up with warm clothing. Hot drinks and cozy cafés recommended.",
-            string c when c.Contains("hot", StringComparison.OrdinalIgnoreCase) || c.Contains("warm", StringComparison.OrdinalIgnoreCase) =>
-                "Stay hydrated and use sunscreen. Plan strenuous activities for cooler morning hours.",
-            string c when c.Contains("thunder", StringComparison.OrdinalIgnoreCase) || c.Contains("storm", StringComparison.OrdinalIgnoreCase) =>
-                "Keep an eye on weather updates. Have indoor alternatives ready.",
-            _ => "Pleasant conditions expected. Great day for outdoor exploration!"
-        };
-    }
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/08_ReliableStreaming/host.json

@@ -1,21 +0,0 @@
-{
-  "version": "2.0",
-  "logging": {
-    "logLevel": {
-      "Microsoft.Agents.AI.DurableTask": "Information",
-      "Microsoft.Agents.AI.Hosting.AzureFunctions": "Information",
-      "DurableTask": "Information",
-      "Microsoft.DurableTask": "Information",
-      "ReliableStreaming": "Information"
-    }
-  },
-  "extensions": {
-    "durableTask": {
-      "hubName": "default",
-      "storageProvider": {
-        "type": "AzureManaged",
-        "connectionStringName": "DURABLE_TASK_SCHEDULER_CONNECTION_STRING"
-      }
-    }
-  }
-}

dotnet/samples/04-hosting/DurableAgents/AzureFunctions/README.md

@@ -1,152 +1,3 @@
-# Azure Functions Samples
+# Durable Agent Azure Functions Samples Have Moved
 
-This directory contains samples for Azure Functions.
-
-- **[01_SingleAgent](01_SingleAgent)**: A sample that demonstrates how to host a single conversational agent in an Azure Functions app and invoke it directly over HTTP.
-- **[02_AgentOrchestration_Chaining](02_AgentOrchestration_Chaining)**: A sample that demonstrates how to host a single conversational agent in an Azure Functions app and invoke it using a durable orchestration.
-- **[03_AgentOrchestration_Concurrency](03_AgentOrchestration_Concurrency)**: A sample that demonstrates how to host multiple agents in an Azure Functions app and run them concurrently using a durable orchestration.
-- **[04_AgentOrchestration_Conditionals](04_AgentOrchestration_Conditionals)**: A sample that demonstrates how to host multiple agents in an Azure Functions app and run them sequentially using a durable orchestration with conditionals.
-- **[05_AgentOrchestration_HITL](05_AgentOrchestration_HITL)**: A sample that demonstrates how to implement a human-in-the-loop workflow using durable orchestration, including external event handling for human approval.
-- **[06_LongRunningTools](06_LongRunningTools)**: A sample that demonstrates how agents can start and interact with durable orchestrations from tool calls to enable long-running tool scenarios.
-- **[07_AgentAsMcpTool](07_AgentAsMcpTool)**: A sample that demonstrates how to configure durable AI agents to be accessible as Model Context Protocol (MCP) tools.
-- **[08_ReliableStreaming](08_ReliableStreaming)**: A sample that demonstrates how to implement reliable streaming for durable agents using Redis Streams, enabling clients to disconnect and reconnect without losing messages.
-
-## Running the Samples
-
-These samples are designed to be run locally in a cloned repository.
-
-### Prerequisites
-
-The following prerequisites are required to run the samples:
-
-- [.NET 10.0 SDK or later](https://dotnet.microsoft.com/download/dotnet)
-- [Azure Functions Core Tools](https://learn.microsoft.com/azure/azure-functions/functions-run-local) (version 4.x or later)
-- [Azure CLI](https://learn.microsoft.com/cli/azure/install-azure-cli) installed and authenticated (`az login`) or an API key for the Azure OpenAI service
-- [Azure OpenAI Service](https://learn.microsoft.com/azure/ai-services/openai/how-to/create-resource) with a deployed model (gpt-5.4-mini or better is recommended)
-- [Durable Task Scheduler](https://learn.microsoft.com/azure/azure-functions/durable/durable-task-scheduler/develop-with-durable-task-scheduler) (local emulator or Azure-hosted)
-- [Docker](https://docs.docker.com/get-docker/) installed if running the Durable Task Scheduler emulator locally
-
-### Configuring RBAC Permissions for Azure OpenAI
-
-These samples are configured to use the Azure OpenAI service with RBAC permissions to access the model. You'll need to configure the RBAC permissions for the Azure OpenAI service to allow the Azure Functions app to access the model.
-
-Below is an example of how to configure the RBAC permissions for the Azure OpenAI service to allow the current user to access the model.
-
-Bash (Linux/macOS/WSL):
-
-```bash
-az role assignment create \
-    --assignee "yourname@contoso.com" \
-    --role "Cognitive Services OpenAI User" \
-    --scope /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.CognitiveServices/accounts/<your-openai-resource-name>
-```
-
-PowerShell:
-
-```powershell
-az role assignment create `
-    --assignee "yourname@contoso.com" `
-    --role "Cognitive Services OpenAI User" `
-    --scope /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.CognitiveServices/accounts/<your-openai-resource-name>
-```
-
-More information on how to configure RBAC permissions for Azure OpenAI can be found in the [Azure OpenAI documentation](https://learn.microsoft.com/azure/ai-services/openai/how-to/create-resource?pivots=cli).
-
-### Setting an API key for the Azure OpenAI service
-
-As an alternative to configuring Azure RBAC permissions, you can set an API key for the Azure OpenAI service by setting the `AZURE_OPENAI_API_KEY` environment variable.
-
-Bash (Linux/macOS/WSL):
-
-```bash
-export AZURE_OPENAI_API_KEY="your-api-key"
-```
-
-PowerShell:
-
-```powershell
-$env:AZURE_OPENAI_API_KEY="your-api-key"
-```
-
-### Start Durable Task Scheduler
-
-Most samples use the Durable Task Scheduler (DTS) to support hosted agents and durable orchestrations. DTS also allows you to view the status of orchestrations and their inputs and outputs from a web UI.
-
-To run the Durable Task Scheduler locally, you can use the following `docker` command:
-
-```bash
-docker run -d --name dts-emulator -p 8080:8080 -p 8082:8082 mcr.microsoft.com/dts/dts-emulator:latest
-```
-
-The DTS dashboard will be available at `http://localhost:8080`.
-
-### Start the Azure Storage Emulator
-
-All Function apps require an Azure Storage account to store functions-specific state. You can use the Azure Storage Emulator to run a local instance of the Azure Storage service.
-
-You can run the Azure Storage emulator locally as a standalone process or via a Docker container.
-
-#### Docker
-
-```bash
-docker run -d --name storage-emulator -p 10000:10000 -p 10001:10001 -p 10002:10002 mcr.microsoft.com/azure-storage/azurite
-```
-
-#### Standalone
-
-```bash
-npm install -g azurite
-azurite
-```
-
-### Environment Configuration
-
-Each sample has its own `local.settings.json` file that contains the environment variables for the sample. You'll need to update the `local.settings.json` file with the correct values for your Azure OpenAI resource.
-
-```json
-{
-  "Values": {
-    "AZURE_OPENAI_ENDPOINT": "https://your-resource.openai.azure.com/",
-    "AZURE_OPENAI_DEPLOYMENT_NAME": "your-deployment-name"
-  }
-}
-```
-
-Alternatively, you can set the environment variables in the command line.
-
-### Bash (Linux/macOS/WSL)
-
-```bash
-export AZURE_OPENAI_ENDPOINT="https://your-resource.openai.azure.com/"
-export AZURE_OPENAI_DEPLOYMENT_NAME="your-deployment-name"
-```
-
-### PowerShell
-
-```powershell
-$env:AZURE_OPENAI_ENDPOINT="https://your-resource.openai.azure.com/"
-$env:AZURE_OPENAI_DEPLOYMENT_NAME="your-deployment-name"
-```
-
-These environment variables, when set, will override the values in the `local.settings.json` file, making it convenient to test the sample without having to update the `local.settings.json` file.
-
-### Start the Azure Functions app
-
-Navigate to the sample directory and start the Azure Functions app:
-
-```bash
-cd dotnet/samples/04-hosting/DurableAgents/AzureFunctions/01_SingleAgent
-func start
-```
-
-The Azure Functions app will be available at `http://localhost:7071`.
-
-### Test the Azure Functions app
-
-The README.md file in each sample directory contains instructions for testing the sample. Each sample also includes a `demo.http` file that can be used to test the sample from the command line. These files can be opened in VS Code with the [REST Client](https://marketplace.visualstudio.com/items?itemName=humao.rest-client) extension or in the Visual Studio IDE.
-
-### Viewing the sample output
-
-The Azure Functions app logs are displayed in the terminal where you ran `func start`. This is where most agent output will be displayed. You can adjust logging levels in the `host.json` file as needed.
-
-You can also see the state of agents and orchestrations in the DTS dashboard.
+These samples are now maintained in the [Durable Agent Framework extension repository](https://github.com/microsoft/agent-framework-durable-extension/tree/main/dotnet/samples/DurableAgents/AzureFunctions).

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/01_SingleAgent/01_SingleAgent.csproj

@@ -1,30 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-  <PropertyGroup>
-    <TargetFrameworks>net10.0</TargetFrameworks>
-    <OutputType>Exe</OutputType>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-    <AssemblyName>SingleAgent</AssemblyName>
-    <RootNamespace>SingleAgent</RootNamespace>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <PackageReference Include="Azure.AI.OpenAI" />
-    <PackageReference Include="Azure.Identity" />
-    <PackageReference Include="Microsoft.DurableTask.Client.AzureManaged" />
-    <PackageReference Include="Microsoft.DurableTask.Worker.AzureManaged" />
-    <PackageReference Include="Microsoft.Extensions.Hosting" />
-  </ItemGroup>
-
-  <!-- Local projects that should be switched to package references when using the sample outside of this MAF repo -->
-  <!--
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Agents.AI.DurableTask" />
-    <PackageReference Include="Microsoft.Agents.AI.OpenAI" />
-  </ItemGroup>
-  -->
-  <ItemGroup>
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.DurableTask\Microsoft.Agents.AI.DurableTask.csproj" />
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.OpenAI\Microsoft.Agents.AI.OpenAI.csproj" />
-  </ItemGroup>
-</Project>

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/01_SingleAgent/Program.cs

@@ -1,106 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-using Azure;
-using Azure.AI.OpenAI;
-using Azure.Identity;
-using Microsoft.Agents.AI;
-using Microsoft.Agents.AI.DurableTask;
-using Microsoft.DurableTask.Client.AzureManaged;
-using Microsoft.DurableTask.Worker.AzureManaged;
-using Microsoft.Extensions.AI;
-using Microsoft.Extensions.DependencyInjection;
-using Microsoft.Extensions.Hosting;
-using Microsoft.Extensions.Logging;
-using OpenAI.Chat;
-
-// Get the Azure OpenAI endpoint and deployment name from environment variables.
-string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_ENDPOINT is not set.");
-string deploymentName = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT_NAME")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_DEPLOYMENT_NAME is not set.");
-
-// Get DTS connection string from environment variable
-string dtsConnectionString = Environment.GetEnvironmentVariable("DURABLE_TASK_SCHEDULER_CONNECTION_STRING")
-    ?? "Endpoint=http://localhost:8080;TaskHub=default;Authentication=None";
-
-// Use Azure Key Credential if provided, otherwise use Azure CLI Credential.
-string? azureOpenAiKey = Environment.GetEnvironmentVariable("AZURE_OPENAI_API_KEY");
-// WARNING: DefaultAzureCredential is convenient for development but requires careful consideration in production.
-// In production, consider using a specific credential (e.g., ManagedIdentityCredential) to avoid
-// latency issues, unintended credential probing, and potential security risks from fallback mechanisms.
-AzureOpenAIClient client = !string.IsNullOrEmpty(azureOpenAiKey)
-    ? new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(azureOpenAiKey))
-    : new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential());
-
-// Set up an AI agent following the standard Microsoft Agent Framework pattern.
-const string JokerName = "Joker";
-const string JokerInstructions = "You are good at telling jokes.";
-
-AIAgent agent = client.GetChatClient(deploymentName).AsAIAgent(JokerInstructions, JokerName);
-
-// Configure the console app to host the AI agent.
-IHost host = Host.CreateDefaultBuilder(args)
-    .ConfigureLogging(logging => logging.SetMinimumLevel(LogLevel.Warning))
-    .ConfigureServices(services =>
-    {
-        services.ConfigureDurableAgents(
-            options => options.AddAIAgent(agent, timeToLive: TimeSpan.FromHours(1)),
-            workerBuilder: builder => builder.UseDurableTaskScheduler(dtsConnectionString),
-            clientBuilder: builder => builder.UseDurableTaskScheduler(dtsConnectionString));
-    })
-    .Build();
-
-await host.StartAsync();
-
-// Get the agent proxy from services
-IServiceProvider services = host.Services;
-AIAgent agentProxy = services.GetRequiredKeyedService<AIAgent>(JokerName);
-
-// Console colors for better UX
-Console.ForegroundColor = ConsoleColor.Cyan;
-Console.WriteLine("=== Single Agent Console Sample ===");
-Console.ResetColor();
-Console.WriteLine("Enter a message for the Joker agent (or 'exit' to quit):");
-Console.WriteLine();
-
-// Create a session for the conversation
-AgentSession session = await agentProxy.CreateSessionAsync();
-
-while (true)
-{
-    // Read input from stdin
-    Console.ForegroundColor = ConsoleColor.Yellow;
-    Console.Write("You: ");
-    Console.ResetColor();
-
-    string? input = Console.ReadLine();
-    if (string.IsNullOrWhiteSpace(input) || input.Equals("exit", StringComparison.OrdinalIgnoreCase))
-    {
-        break;
-    }
-
-    // Run the agent
-    Console.ForegroundColor = ConsoleColor.Green;
-    Console.Write("Joker: ");
-    Console.ResetColor();
-
-    try
-    {
-        AgentResponse agentResponse = await agentProxy.RunAsync(
-            message: input,
-            session: session,
-            cancellationToken: CancellationToken.None);
-
-        Console.WriteLine(agentResponse.Text);
-        Console.WriteLine();
-    }
-    catch (Exception ex)
-    {
-        Console.ForegroundColor = ConsoleColor.Red;
-        Console.Error.WriteLine($"Error: {ex.Message}");
-        Console.ResetColor();
-        Console.WriteLine();
-    }
-}
-
-await host.StopAsync();

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/01_SingleAgent/README.md

@@ -1,56 +0,0 @@
-# Single Agent Sample
-
-This sample demonstrates how to use the durable agents extension to create a simple console app that hosts a single AI agent and provides interactive conversation via stdin/stdout.
-
-## Key Concepts Demonstrated
-
-- Using the Microsoft Agent Framework to define a simple AI agent with a name and instructions.
-- Registering durable agents with the console app and running them interactively.
-- Conversation management (via threads) for isolated interactions.
-
-## Environment Setup
-
-See the [README.md](../README.md) file in the parent directory for more information on how to configure the environment, including how to install and run common sample dependencies.
-
-## Running the Sample
-
-With the environment setup, you can run the sample:
-
-```bash
-cd dotnet/samples/04-hosting/DurableAgents/ConsoleApps/01_SingleAgent
-dotnet run --framework net10.0
-```
-
-The app will prompt you for input. You can interact with the Joker agent:
-
-```text
-=== Single Agent Console Sample ===
-Enter a message for the Joker agent (or 'exit' to quit):
-
-You: Tell me a joke about a pirate.
-Joker: Why don't pirates ever learn the alphabet? Because they always get stuck at "C"!
-
-You: Now explain the joke.
-Joker: The joke plays on the word "sea" (C), which pirates are famously associated with...
-
-You: exit
-```
-
-## Scriptable Usage
-
-You can also pipe input to the app for scriptable usage:
-
-```bash
-echo "Tell me a joke about a pirate." | dotnet run
-```
-
-The app will read from stdin, process the input, and write the response to stdout.
-
-## Viewing Agent State
-
-You can view the state of the agent in the Durable Task Scheduler dashboard:
-
-1. Open your browser and navigate to `http://localhost:8082`
-2. In the dashboard, you can view the state of the Joker agent, including its conversation history and current state
-
-The agent maintains conversation state across multiple interactions, and you can inspect this state in the dashboard to understand how the durable agents extension manages conversation context.

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/02_AgentOrchestration_Chaining/02_AgentOrchestration_Chaining.csproj

@@ -1,30 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-  <PropertyGroup>
-    <TargetFrameworks>net10.0</TargetFrameworks>
-    <OutputType>Exe</OutputType>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-    <AssemblyName>AgentOrchestration_Chaining</AssemblyName>
-    <RootNamespace>AgentOrchestration_Chaining</RootNamespace>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <PackageReference Include="Azure.AI.OpenAI" />
-    <PackageReference Include="Azure.Identity" />
-    <PackageReference Include="Microsoft.DurableTask.Client.AzureManaged" />
-    <PackageReference Include="Microsoft.DurableTask.Worker.AzureManaged" />
-    <PackageReference Include="Microsoft.Extensions.Hosting" />
-  </ItemGroup>
-
-  <!-- Local projects that should be switched to package references when using the sample outside of this MAF repo -->
-  <!--
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Agents.AI.DurableTask" />
-    <PackageReference Include="Microsoft.Agents.AI.OpenAI" />
-  </ItemGroup>
-  -->
-  <ItemGroup>
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.DurableTask\Microsoft.Agents.AI.DurableTask.csproj" />
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.OpenAI\Microsoft.Agents.AI.OpenAI.csproj" />
-  </ItemGroup>
-</Project>

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/02_AgentOrchestration_Chaining/Models.cs

@@ -1,6 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-namespace AgentOrchestration_Chaining;
-
-// Response model
-public sealed record TextResponse(string Text);

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/02_AgentOrchestration_Chaining/Program.cs

@@ -1,151 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-using AgentOrchestration_Chaining;
-using Azure;
-using Azure.AI.OpenAI;
-using Azure.Identity;
-using Microsoft.Agents.AI;
-using Microsoft.Agents.AI.DurableTask;
-using Microsoft.DurableTask;
-using Microsoft.DurableTask.Client;
-using Microsoft.DurableTask.Client.AzureManaged;
-using Microsoft.DurableTask.Worker;
-using Microsoft.DurableTask.Worker.AzureManaged;
-using Microsoft.Extensions.DependencyInjection;
-using Microsoft.Extensions.Hosting;
-using Microsoft.Extensions.Logging;
-using OpenAI.Chat;
-using Environment = System.Environment;
-
-// Get the Azure OpenAI endpoint and deployment name from environment variables.
-string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_ENDPOINT is not set.");
-string deploymentName = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT_NAME")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_DEPLOYMENT_NAME is not set.");
-
-// Get DTS connection string from environment variable
-string dtsConnectionString = Environment.GetEnvironmentVariable("DURABLE_TASK_SCHEDULER_CONNECTION_STRING")
-    ?? "Endpoint=http://localhost:8080;TaskHub=default;Authentication=None";
-
-// Use Azure Key Credential if provided, otherwise use Azure CLI Credential.
-string? azureOpenAiKey = Environment.GetEnvironmentVariable("AZURE_OPENAI_API_KEY");
-// WARNING: DefaultAzureCredential is convenient for development but requires careful consideration in production.
-// In production, consider using a specific credential (e.g., ManagedIdentityCredential) to avoid
-// latency issues, unintended credential probing, and potential security risks from fallback mechanisms.
-AzureOpenAIClient client = !string.IsNullOrEmpty(azureOpenAiKey)
-    ? new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(azureOpenAiKey))
-    : new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential());
-
-// Single agent used by the orchestration to demonstrate sequential calls on the same session.
-const string WriterName = "WriterAgent";
-const string WriterInstructions =
-    """
-    You refine short pieces of text. When given an initial sentence you enhance it;
-    when given an improved sentence you polish it further.
-    """;
-
-AIAgent writerAgent = client.GetChatClient(deploymentName).AsAIAgent(WriterInstructions, WriterName);
-
-// Orchestrator function
-static async Task<string> RunOrchestratorAsync(TaskOrchestrationContext context)
-{
-    DurableAIAgent writer = context.GetAgent("WriterAgent");
-    AgentSession writerSession = await writer.CreateSessionAsync();
-
-    AgentResponse<TextResponse> initial = await writer.RunAsync<TextResponse>(
-        message: "Write a concise inspirational sentence about learning.",
-        session: writerSession);
-
-    AgentResponse<TextResponse> refined = await writer.RunAsync<TextResponse>(
-        message: $"Improve this further while keeping it under 25 words: {initial.Result.Text}",
-        session: writerSession);
-
-    return refined.Result.Text;
-}
-
-// Configure the console app to host the AI agent.
-IHost host = Host.CreateDefaultBuilder(args)
-    .ConfigureLogging(loggingBuilder => loggingBuilder.SetMinimumLevel(LogLevel.Warning))
-    .ConfigureServices(services =>
-    {
-        services.ConfigureDurableAgents(
-            options => options.AddAIAgent(writerAgent),
-            workerBuilder: builder =>
-            {
-                builder.UseDurableTaskScheduler(dtsConnectionString);
-                builder.AddTasks(registry => registry.AddOrchestratorFunc(nameof(RunOrchestratorAsync), RunOrchestratorAsync));
-            },
-            clientBuilder: builder => builder.UseDurableTaskScheduler(dtsConnectionString));
-    })
-    .Build();
-
-await host.StartAsync();
-
-DurableTaskClient durableClient = host.Services.GetRequiredService<DurableTaskClient>();
-
-// Console colors for better UX
-Console.ForegroundColor = ConsoleColor.Cyan;
-Console.WriteLine("=== Single Agent Orchestration Chaining Sample ===");
-Console.ResetColor();
-Console.WriteLine("Starting orchestration...");
-Console.WriteLine();
-
-try
-{
-    // Start the orchestration
-    string instanceId = await durableClient.ScheduleNewOrchestrationInstanceAsync(
-        orchestratorName: nameof(RunOrchestratorAsync));
-
-    Console.ForegroundColor = ConsoleColor.Gray;
-    Console.WriteLine($"Orchestration started with instance ID: {instanceId}");
-    Console.WriteLine("Waiting for completion...");
-    Console.ResetColor();
-
-    // Wait for orchestration to complete
-    OrchestrationMetadata status = await durableClient.WaitForInstanceCompletionAsync(
-        instanceId,
-        getInputsAndOutputs: true,
-        CancellationToken.None);
-
-    Console.WriteLine();
-
-    if (status.RuntimeStatus == OrchestrationRuntimeStatus.Completed)
-    {
-        Console.ForegroundColor = ConsoleColor.Green;
-        Console.WriteLine("✓ Orchestration completed successfully!");
-        Console.ResetColor();
-        Console.WriteLine();
-        Console.ForegroundColor = ConsoleColor.Yellow;
-        Console.Write("Result: ");
-        Console.ResetColor();
-        Console.WriteLine(status.ReadOutputAs<string>());
-    }
-    else if (status.RuntimeStatus == OrchestrationRuntimeStatus.Failed)
-    {
-        Console.ForegroundColor = ConsoleColor.Red;
-        Console.WriteLine("✗ Orchestration failed!");
-        Console.ResetColor();
-        if (status.FailureDetails != null)
-        {
-            Console.WriteLine($"Error: {status.FailureDetails.ErrorMessage}");
-        }
-        Environment.Exit(1);
-    }
-    else
-    {
-        Console.ForegroundColor = ConsoleColor.Yellow;
-        Console.WriteLine($"Orchestration status: {status.RuntimeStatus}");
-        Console.ResetColor();
-    }
-}
-catch (Exception ex)
-{
-    Console.ForegroundColor = ConsoleColor.Red;
-    Console.Error.WriteLine($"Error: {ex.Message}");
-    Console.ResetColor();
-    Environment.Exit(1);
-}
-finally
-{
-    await host.StopAsync();
-}

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/02_AgentOrchestration_Chaining/README.md

@@ -1,53 +0,0 @@
-# Single Agent Orchestration Sample
-
-This sample demonstrates how to use the durable agents extension to create a simple console app that orchestrates sequential calls to a single AI agent using the same session for context continuity.
-
-## Key Concepts Demonstrated
-
-- Orchestrating multiple interactions with the same agent in a deterministic order
-- Using the same `AgentSession` across multiple calls to maintain conversational context
-- Durable orchestration with automatic checkpointing and resumption from failures
-- Waiting for orchestration completion using `WaitForInstanceCompletionAsync`
-
-## Environment Setup
-
-See the [README.md](../README.md) file in the parent directory for more information on how to configure the environment, including how to install and run common sample dependencies.
-
-## Running the Sample
-
-With the environment setup, you can run the sample:
-
-```bash
-cd dotnet/samples/04-hosting/DurableAgents/ConsoleApps/02_AgentOrchestration_Chaining
-dotnet run --framework net10.0
-```
-
-The app will start the orchestration, wait for it to complete, and display the result:
-
-```text
-=== Single Agent Orchestration Chaining Sample ===
-Starting orchestration...
-
-Orchestration started with instance ID: 86313f1d45fb42eeb50b1852626bf3ff
-Waiting for completion...
-
-✓ Orchestration completed successfully!
-
-Result: Learning serves as the key, opening doors to boundless opportunities and a brighter future.
-```
-
-The orchestration will proceed to run the WriterAgent twice in sequence:
-
-1. First, it writes an inspirational sentence about learning
-2. Then, it refines the initial output using the same conversation thread
-
-## Viewing Orchestration State
-
-You can view the state of the orchestration in the Durable Task Scheduler dashboard:
-
-1. Open your browser and navigate to `http://localhost:8082`
-2. In the dashboard, you can see:
-   - **Orchestrations**: View the orchestration instance, including its runtime status, input, output, and execution history
-   - **Agents**: View the state of the WriterAgent, including conversation history maintained across the orchestration steps
-
-The orchestration instance ID is displayed in the console output. You can use this ID to find the specific orchestration in the dashboard and inspect its execution details, including the sequence of agent calls and their results.

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/03_AgentOrchestration_Concurrency/03_AgentOrchestration_Concurrency.csproj

@@ -1,30 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-  <PropertyGroup>
-    <TargetFrameworks>net10.0</TargetFrameworks>
-    <OutputType>Exe</OutputType>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-    <AssemblyName>AgentOrchestration_Concurrency</AssemblyName>
-    <RootNamespace>AgentOrchestration_Concurrency</RootNamespace>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <PackageReference Include="Azure.AI.OpenAI" />
-    <PackageReference Include="Azure.Identity" />
-    <PackageReference Include="Microsoft.DurableTask.Client.AzureManaged" />
-    <PackageReference Include="Microsoft.DurableTask.Worker.AzureManaged" />
-    <PackageReference Include="Microsoft.Extensions.Hosting" />
-  </ItemGroup>
-
-  <!-- Local projects that should be switched to package references when using the sample outside of this MAF repo -->
-  <!--
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Agents.AI.DurableTask" />
-    <PackageReference Include="Microsoft.Agents.AI.OpenAI" />
-  </ItemGroup>
-  -->
-  <ItemGroup>
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.DurableTask\Microsoft.Agents.AI.DurableTask.csproj" />
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.OpenAI\Microsoft.Agents.AI.OpenAI.csproj" />
-  </ItemGroup>
-</Project>

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/03_AgentOrchestration_Concurrency/Models.cs

@@ -1,6 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-namespace AgentOrchestration_Concurrency;
-
-// Response model
-public sealed record TextResponse(string Text);

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/03_AgentOrchestration_Concurrency/Program.cs

@@ -1,194 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-using System.Text.Json;
-using AgentOrchestration_Concurrency;
-using Azure;
-using Azure.AI.OpenAI;
-using Azure.Identity;
-using Microsoft.Agents.AI;
-using Microsoft.Agents.AI.DurableTask;
-using Microsoft.DurableTask;
-using Microsoft.DurableTask.Client;
-using Microsoft.DurableTask.Client.AzureManaged;
-using Microsoft.DurableTask.Worker;
-using Microsoft.DurableTask.Worker.AzureManaged;
-using Microsoft.Extensions.DependencyInjection;
-using Microsoft.Extensions.Hosting;
-using Microsoft.Extensions.Logging;
-using OpenAI.Chat;
-
-// Get the Azure OpenAI endpoint and deployment name from environment variables.
-string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_ENDPOINT is not set.");
-string deploymentName = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT_NAME")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_DEPLOYMENT_NAME is not set.");
-
-// Get DTS connection string from environment variable
-string dtsConnectionString = Environment.GetEnvironmentVariable("DURABLE_TASK_SCHEDULER_CONNECTION_STRING")
-    ?? "Endpoint=http://localhost:8080;TaskHub=default;Authentication=None";
-
-// Use Azure Key Credential if provided, otherwise use Azure CLI Credential.
-string? azureOpenAiKey = Environment.GetEnvironmentVariable("AZURE_OPENAI_API_KEY");
-// WARNING: DefaultAzureCredential is convenient for development but requires careful consideration in production.
-// In production, consider using a specific credential (e.g., ManagedIdentityCredential) to avoid
-// latency issues, unintended credential probing, and potential security risks from fallback mechanisms.
-AzureOpenAIClient client = !string.IsNullOrEmpty(azureOpenAiKey)
-    ? new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(azureOpenAiKey))
-    : new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential());
-
-// Two agents used by the orchestration to demonstrate concurrent execution.
-const string PhysicistName = "PhysicistAgent";
-const string PhysicistInstructions = "You are an expert in physics. You answer questions from a physics perspective.";
-
-const string ChemistName = "ChemistAgent";
-const string ChemistInstructions = "You are a middle school chemistry teacher. You answer questions so that middle school students can understand.";
-
-AIAgent physicistAgent = client.GetChatClient(deploymentName).AsAIAgent(PhysicistInstructions, PhysicistName);
-AIAgent chemistAgent = client.GetChatClient(deploymentName).AsAIAgent(ChemistInstructions, ChemistName);
-
-// Orchestrator function
-static async Task<object> RunOrchestratorAsync(TaskOrchestrationContext context, string prompt)
-{
-    // Get both agents
-    DurableAIAgent physicist = context.GetAgent(PhysicistName);
-    DurableAIAgent chemist = context.GetAgent(ChemistName);
-
-    // Start both agent runs concurrently
-    Task<AgentResponse<TextResponse>> physicistTask = physicist.RunAsync<TextResponse>(prompt);
-    Task<AgentResponse<TextResponse>> chemistTask = chemist.RunAsync<TextResponse>(prompt);
-
-    // Wait for both tasks to complete using Task.WhenAll
-    await Task.WhenAll(physicistTask, chemistTask);
-
-    // Get the results
-    TextResponse physicistResponse = (await physicistTask).Result;
-    TextResponse chemistResponse = (await chemistTask).Result;
-
-    // Return the result as a structured, anonymous type
-    return new
-    {
-        physicist = physicistResponse.Text,
-        chemist = chemistResponse.Text,
-    };
-}
-
-// Configure the console app to host the AI agents.
-IHost host = Host.CreateDefaultBuilder(args)
-    .ConfigureLogging(loggingBuilder => loggingBuilder.SetMinimumLevel(LogLevel.Warning))
-    .ConfigureServices(services =>
-    {
-        services.ConfigureDurableAgents(
-            options =>
-            {
-                options
-                    .AddAIAgent(physicistAgent)
-                    .AddAIAgent(chemistAgent);
-            },
-            workerBuilder: builder =>
-            {
-                builder.UseDurableTaskScheduler(dtsConnectionString);
-                builder.AddTasks(
-                    registry => registry.AddOrchestratorFunc<string, object>(nameof(RunOrchestratorAsync), RunOrchestratorAsync));
-            },
-            clientBuilder: builder => builder.UseDurableTaskScheduler(dtsConnectionString));
-    })
-    .Build();
-
-await host.StartAsync();
-
-DurableTaskClient durableTaskClient = host.Services.GetRequiredService<DurableTaskClient>();
-
-// Console colors for better UX
-Console.ForegroundColor = ConsoleColor.Cyan;
-Console.WriteLine("=== Multi-Agent Concurrent Orchestration Sample ===");
-Console.ResetColor();
-Console.WriteLine("Enter a question for the agents:");
-Console.WriteLine();
-
-// Read prompt from stdin
-string? prompt = Console.ReadLine();
-if (string.IsNullOrWhiteSpace(prompt))
-{
-    Console.ForegroundColor = ConsoleColor.Red;
-    Console.Error.WriteLine("Error: Prompt is required.");
-    Console.ResetColor();
-    Environment.Exit(1);
-    return;
-}
-
-Console.WriteLine();
-Console.ForegroundColor = ConsoleColor.Gray;
-Console.WriteLine("Starting orchestration...");
-Console.ResetColor();
-
-try
-{
-    // Start the orchestration
-    string instanceId = await durableTaskClient.ScheduleNewOrchestrationInstanceAsync(
-        orchestratorName: nameof(RunOrchestratorAsync),
-        input: prompt);
-
-    Console.ForegroundColor = ConsoleColor.Gray;
-    Console.WriteLine($"Orchestration started with instance ID: {instanceId}");
-    Console.WriteLine("Waiting for completion...");
-    Console.ResetColor();
-
-    // Wait for orchestration to complete
-    OrchestrationMetadata status = await durableTaskClient.WaitForInstanceCompletionAsync(
-        instanceId,
-        getInputsAndOutputs: true,
-        CancellationToken.None);
-
-    Console.WriteLine();
-
-    if (status.RuntimeStatus == OrchestrationRuntimeStatus.Completed)
-    {
-        Console.ForegroundColor = ConsoleColor.Green;
-        Console.WriteLine("✓ Orchestration completed successfully!");
-        Console.ResetColor();
-        Console.WriteLine();
-
-        // Parse the output
-        using JsonDocument doc = JsonDocument.Parse(status.SerializedOutput!);
-        JsonElement output = doc.RootElement;
-
-        Console.ForegroundColor = ConsoleColor.Yellow;
-        Console.WriteLine("Physicist's response:");
-        Console.ResetColor();
-        Console.WriteLine(output.GetProperty("physicist").GetString());
-        Console.WriteLine();
-
-        Console.ForegroundColor = ConsoleColor.Yellow;
-        Console.WriteLine("Chemist's response:");
-        Console.ResetColor();
-        Console.WriteLine(output.GetProperty("chemist").GetString());
-    }
-    else if (status.RuntimeStatus == OrchestrationRuntimeStatus.Failed)
-    {
-        Console.ForegroundColor = ConsoleColor.Red;
-        Console.WriteLine("✗ Orchestration failed!");
-        Console.ResetColor();
-        if (status.FailureDetails != null)
-        {
-            Console.WriteLine($"Error: {status.FailureDetails.ErrorMessage}");
-        }
-        Environment.Exit(1);
-    }
-    else
-    {
-        Console.ForegroundColor = ConsoleColor.Yellow;
-        Console.WriteLine($"Orchestration status: {status.RuntimeStatus}");
-        Console.ResetColor();
-    }
-}
-catch (Exception ex)
-{
-    Console.ForegroundColor = ConsoleColor.Red;
-    Console.Error.WriteLine($"Error: {ex.Message}");
-    Console.ResetColor();
-    Environment.Exit(1);
-}
-finally
-{
-    await host.StopAsync();
-}

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/03_AgentOrchestration_Concurrency/README.md

@@ -1,68 +0,0 @@
-# Multi-Agent Concurrent Orchestration Sample
-
-This sample demonstrates how to use the durable agents extension to create a console app that orchestrates concurrent execution of multiple AI agents using durable orchestration.
-
-## Key Concepts Demonstrated
-
-- Running multiple agents concurrently in a single orchestration
-- Using `Task.WhenAll` to wait for concurrent agent executions
-- Combining results from multiple agents into a single response
-- Waiting for orchestration completion using `WaitForInstanceCompletionAsync`
-
-## Environment Setup
-
-See the [README.md](../README.md) file in the parent directory for more information on how to configure the environment, including how to install and run common sample dependencies.
-
-## Running the Sample
-
-With the environment setup, you can run the sample:
-
-```bash
-cd dotnet/samples/04-hosting/DurableAgents/ConsoleApps/03_AgentOrchestration_Concurrency
-dotnet run --framework net10.0
-```
-
-The app will prompt you for a question:
-
-```text
-=== Multi-Agent Concurrent Orchestration Sample ===
-Enter a question for the agents:
-
-What is temperature?
-```
-
-The orchestration will run both agents concurrently and display their responses:
-
-```text
-Orchestration started with instance ID: 86313f1d45fb42eeb50b1852626bf3ff
-Waiting for completion...
-
-✓ Orchestration completed successfully!
-
-Physicist's response:
-Temperature is a measure of the average kinetic energy of particles in a system...
-
-Chemist's response:
-From a chemistry perspective, temperature is crucial for chemical reactions...
-```
-
-Both agents run in parallel, and the orchestration waits for both to complete before returning the combined results.
-
-## Viewing Orchestration State
-
-You can view the state of the orchestration in the Durable Task Scheduler dashboard:
-
-1. Open your browser and navigate to `http://localhost:8082`
-2. In the dashboard, you can see:
-   - **Orchestrations**: View the orchestration instance, including its runtime status, input, output, and execution history
-   - **Agents**: View the state of both the PhysicistAgent and ChemistAgent, including their individual conversation histories
-
-The orchestration instance ID is displayed in the console output. You can use this ID to find the specific orchestration in the dashboard and inspect how the concurrent agent executions were coordinated, including the timing of when each agent started and completed.
-
-## Scriptable Usage
-
-You can also pipe input to the app:
-
-```bash
-echo "What is temperature?" | dotnet run
-```

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/04_AgentOrchestration_Conditionals/04_AgentOrchestration_Conditionals.csproj

@@ -1,30 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-  <PropertyGroup>
-    <TargetFrameworks>net10.0</TargetFrameworks>
-    <OutputType>Exe</OutputType>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-    <AssemblyName>AgentOrchestration_Conditionals</AssemblyName>
-    <RootNamespace>AgentOrchestration_Conditionals</RootNamespace>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <PackageReference Include="Azure.AI.OpenAI" />
-    <PackageReference Include="Azure.Identity" />
-    <PackageReference Include="Microsoft.DurableTask.Client.AzureManaged" />
-    <PackageReference Include="Microsoft.DurableTask.Worker.AzureManaged" />
-    <PackageReference Include="Microsoft.Extensions.Hosting" />
-  </ItemGroup>
-
-  <!-- Local projects that should be switched to package references when using the sample outside of this MAF repo -->
-  <!--
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Agents.AI.DurableTask" />
-    <PackageReference Include="Microsoft.Agents.AI.OpenAI" />
-  </ItemGroup>
-  -->
-  <ItemGroup>
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.DurableTask\Microsoft.Agents.AI.DurableTask.csproj" />
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.OpenAI\Microsoft.Agents.AI.OpenAI.csproj" />
-  </ItemGroup>
-</Project>

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/04_AgentOrchestration_Conditionals/Models.cs

@@ -1,38 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-using System.Text.Json.Serialization;
-
-namespace AgentOrchestration_Conditionals;
-
-/// <summary>
-/// Represents an email input for spam detection and response generation.
-/// </summary>
-public sealed class Email
-{
-    [JsonPropertyName("email_id")]
-    public string EmailId { get; set; } = string.Empty;
-
-    [JsonPropertyName("email_content")]
-    public string EmailContent { get; set; } = string.Empty;
-}
-
-/// <summary>
-/// Represents the result of spam detection analysis.
-/// </summary>
-public sealed class DetectionResult
-{
-    [JsonPropertyName("is_spam")]
-    public bool IsSpam { get; set; }
-
-    [JsonPropertyName("reason")]
-    public string Reason { get; set; } = string.Empty;
-}
-
-/// <summary>
-/// Represents a generated email response.
-/// </summary>
-public sealed class EmailResponse
-{
-    [JsonPropertyName("response")]
-    public string Response { get; set; } = string.Empty;
-}

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/04_AgentOrchestration_Conditionals/Program.cs

@@ -1,231 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-using AgentOrchestration_Conditionals;
-using Azure;
-using Azure.AI.OpenAI;
-using Azure.Identity;
-using Microsoft.Agents.AI;
-using Microsoft.Agents.AI.DurableTask;
-using Microsoft.DurableTask;
-using Microsoft.DurableTask.Client;
-using Microsoft.DurableTask.Client.AzureManaged;
-using Microsoft.DurableTask.Worker;
-using Microsoft.DurableTask.Worker.AzureManaged;
-using Microsoft.Extensions.DependencyInjection;
-using Microsoft.Extensions.Hosting;
-using Microsoft.Extensions.Logging;
-using OpenAI.Chat;
-
-// Get the Azure OpenAI endpoint and deployment name from environment variables.
-string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_ENDPOINT is not set.");
-string deploymentName = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT_NAME")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_DEPLOYMENT_NAME is not set.");
-
-// Get DTS connection string from environment variable
-string dtsConnectionString = Environment.GetEnvironmentVariable("DURABLE_TASK_SCHEDULER_CONNECTION_STRING")
-    ?? "Endpoint=http://localhost:8080;TaskHub=default;Authentication=None";
-
-// Use Azure Key Credential if provided, otherwise use Azure CLI Credential.
-string? azureOpenAiKey = Environment.GetEnvironmentVariable("AZURE_OPENAI_API_KEY");
-// WARNING: DefaultAzureCredential is convenient for development but requires careful consideration in production.
-// In production, consider using a specific credential (e.g., ManagedIdentityCredential) to avoid
-// latency issues, unintended credential probing, and potential security risks from fallback mechanisms.
-AzureOpenAIClient client = !string.IsNullOrEmpty(azureOpenAiKey)
-    ? new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(azureOpenAiKey))
-    : new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential());
-
-// Spam detection agent
-const string SpamDetectionAgentName = "SpamDetectionAgent";
-const string SpamDetectionAgentInstructions =
-    """
-    You are an expert email spam detection system. Analyze emails and determine if they are spam.
-    Return your analysis as JSON with 'is_spam' (boolean) and 'reason' (string) fields.
-    """;
-
-// Email assistant agent
-const string EmailAssistantAgentName = "EmailAssistantAgent";
-const string EmailAssistantAgentInstructions =
-    """
-    You are a professional email assistant. Draft professional, courteous, and helpful email responses.
-    Return your response as JSON with a 'response' field containing the reply.
-    """;
-
-AIAgent spamDetectionAgent = client.GetChatClient(deploymentName).AsAIAgent(SpamDetectionAgentInstructions, SpamDetectionAgentName);
-AIAgent emailAssistantAgent = client.GetChatClient(deploymentName).AsAIAgent(EmailAssistantAgentInstructions, EmailAssistantAgentName);
-
-// Orchestrator function
-static async Task<string> RunOrchestratorAsync(TaskOrchestrationContext context, Email email)
-{
-    // Get the spam detection agent
-    DurableAIAgent spamDetectionAgent = context.GetAgent(SpamDetectionAgentName);
-    AgentSession spamSession = await spamDetectionAgent.CreateSessionAsync();
-
-    // Step 1: Check if the email is spam
-    AgentResponse<DetectionResult> spamDetectionResponse = await spamDetectionAgent.RunAsync<DetectionResult>(
-        message:
-            $"""
-            Analyze this email for spam content and return a JSON response with 'is_spam' (boolean) and 'reason' (string) fields:
-            Email ID: {email.EmailId}
-            Content: {email.EmailContent}
-            """,
-        session: spamSession);
-    DetectionResult result = spamDetectionResponse.Result;
-
-    // Step 2: Conditional logic based on spam detection result
-    if (result.IsSpam)
-    {
-        // Handle spam email
-        return await context.CallActivityAsync<string>(nameof(HandleSpamEmail), result.Reason);
-    }
-
-    // Generate and send response for legitimate email
-    DurableAIAgent emailAssistantAgent = context.GetAgent(EmailAssistantAgentName);
-    AgentSession emailSession = await emailAssistantAgent.CreateSessionAsync();
-
-    AgentResponse<EmailResponse> emailAssistantResponse = await emailAssistantAgent.RunAsync<EmailResponse>(
-        message:
-            $"""
-            Draft a professional response to this email. Return a JSON response with a 'response' field containing the reply:
-            
-            Email ID: {email.EmailId}
-            Content: {email.EmailContent}
-            """,
-        session: emailSession);
-
-    EmailResponse emailResponse = emailAssistantResponse.Result;
-
-    return await context.CallActivityAsync<string>(nameof(SendEmail), emailResponse.Response);
-}
-
-// Activity functions
-static void HandleSpamEmail(TaskActivityContext context, string reason)
-{
-    Console.WriteLine($"Email marked as spam: {reason}");
-}
-
-static void SendEmail(TaskActivityContext context, string message)
-{
-    Console.WriteLine($"Email sent: {message}");
-}
-
-// Configure the console app to host the AI agents.
-IHost host = Host.CreateDefaultBuilder(args)
-    .ConfigureLogging(loggingBuilder => loggingBuilder.SetMinimumLevel(LogLevel.Warning))
-    .ConfigureServices(services =>
-    {
-        services.ConfigureDurableAgents(
-            options =>
-            {
-                options
-                    .AddAIAgent(spamDetectionAgent)
-                    .AddAIAgent(emailAssistantAgent);
-            },
-            workerBuilder: builder =>
-            {
-                builder.UseDurableTaskScheduler(dtsConnectionString);
-                builder.AddTasks(registry =>
-                {
-                    registry.AddOrchestratorFunc<Email>(nameof(RunOrchestratorAsync), RunOrchestratorAsync);
-                    registry.AddActivityFunc<string>(nameof(HandleSpamEmail), HandleSpamEmail);
-                    registry.AddActivityFunc<string>(nameof(SendEmail), SendEmail);
-                });
-            },
-            clientBuilder: builder => builder.UseDurableTaskScheduler(dtsConnectionString));
-    })
-    .Build();
-
-await host.StartAsync();
-
-DurableTaskClient durableTaskClient = host.Services.GetRequiredService<DurableTaskClient>();
-
-// Console colors for better UX
-Console.ForegroundColor = ConsoleColor.Cyan;
-Console.WriteLine("=== Multi-Agent Conditional Orchestration Sample ===");
-Console.ResetColor();
-Console.WriteLine("Enter email content:");
-Console.WriteLine();
-
-// Read email content from stdin
-string? emailContent = Console.ReadLine();
-if (string.IsNullOrWhiteSpace(emailContent))
-{
-    Console.ForegroundColor = ConsoleColor.Red;
-    Console.Error.WriteLine("Error: Email content is required.");
-    Console.ResetColor();
-    Environment.Exit(1);
-    return;
-}
-
-// Generate email ID automatically
-Email email = new()
-{
-    EmailId = $"email-{Guid.NewGuid():N}",
-    EmailContent = emailContent
-};
-
-Console.WriteLine();
-Console.ForegroundColor = ConsoleColor.Gray;
-Console.WriteLine("Starting orchestration...");
-Console.ResetColor();
-
-try
-{
-    // Start the orchestration
-    string instanceId = await durableTaskClient.ScheduleNewOrchestrationInstanceAsync(
-        orchestratorName: nameof(RunOrchestratorAsync),
-        input: email);
-
-    Console.ForegroundColor = ConsoleColor.Gray;
-    Console.WriteLine($"Orchestration started with instance ID: {instanceId}");
-    Console.WriteLine("Waiting for completion...");
-    Console.ResetColor();
-
-    // Wait for orchestration to complete
-    OrchestrationMetadata status = await durableTaskClient.WaitForInstanceCompletionAsync(
-        instanceId,
-        getInputsAndOutputs: true,
-        CancellationToken.None);
-
-    Console.WriteLine();
-
-    if (status.RuntimeStatus == OrchestrationRuntimeStatus.Completed)
-    {
-        Console.ForegroundColor = ConsoleColor.Green;
-        Console.WriteLine("✓ Orchestration completed successfully!");
-        Console.ResetColor();
-        Console.WriteLine();
-        Console.ForegroundColor = ConsoleColor.Yellow;
-        Console.Write("Result: ");
-        Console.ResetColor();
-        Console.WriteLine(status.ReadOutputAs<string>());
-    }
-    else if (status.RuntimeStatus == OrchestrationRuntimeStatus.Failed)
-    {
-        Console.ForegroundColor = ConsoleColor.Red;
-        Console.WriteLine("✗ Orchestration failed!");
-        Console.ResetColor();
-        if (status.FailureDetails != null)
-        {
-            Console.WriteLine($"Error: {status.FailureDetails.ErrorMessage}");
-        }
-        Environment.Exit(1);
-    }
-    else
-    {
-        Console.ForegroundColor = ConsoleColor.Yellow;
-        Console.WriteLine($"Orchestration status: {status.RuntimeStatus}");
-        Console.ResetColor();
-    }
-}
-catch (Exception ex)
-{
-    Console.ForegroundColor = ConsoleColor.Red;
-    Console.Error.WriteLine($"Error: {ex.Message}");
-    Console.ResetColor();
-    Environment.Exit(1);
-}
-finally
-{
-    await host.StopAsync();
-}

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/04_AgentOrchestration_Conditionals/README.md

@@ -1,95 +0,0 @@
-# Multi-Agent Conditional Orchestration Sample
-
-This sample demonstrates how to use the durable agents extension to create a console app that orchestrates multiple AI agents with conditional logic based on the results of previous agent interactions.
-
-## Key Concepts Demonstrated
-
-- Multi-agent orchestration with conditional branching
-- Using agent responses to determine workflow paths
-- Activity functions for non-agent operations
-- Waiting for orchestration completion using `WaitForInstanceCompletionAsync`
-
-## Environment Setup
-
-See the [README.md](../README.md) file in the parent directory for more information on how to configure the environment, including how to install and run common sample dependencies.
-
-## Running the Sample
-
-With the environment setup, you can run the sample:
-
-```bash
-cd dotnet/samples/04-hosting/DurableAgents/ConsoleApps/04_AgentOrchestration_Conditionals
-dotnet run --framework net10.0
-```
-
-The app will prompt you for email content. You can test both legitimate emails and spam emails:
-
-### Testing with a Legitimate Email
-
-```text
-=== Multi-Agent Conditional Orchestration Sample ===
-Enter email content:
-
-Hi John, I hope you're doing well. I wanted to follow up on our meeting yesterday about the quarterly report. Could you please send me the updated figures by Friday? Thanks!
-```
-
-The orchestration will analyze the email and display the result:
-
-```text
-Orchestration started with instance ID: 86313f1d45fb42eeb50b1852626bf3ff
-Waiting for completion...
-
-✓ Orchestration completed successfully!
-
-Result: Email sent: Thank you for your email. I'll prepare the updated figures...
-```
-
-### Testing with a Spam Email
-
-```text
-=== Multi-Agent Conditional Orchestration Sample ===
-Enter email content:
-
-URGENT! You've won $1,000,000! Click here now to claim your prize! Limited time offer! Don't miss out!
-```
-
-The orchestration will detect it as spam and display:
-
-```text
-Orchestration started with instance ID: 86313f1d45fb42eeb50b1852626bf3ff
-Waiting for completion...
-
-✓ Orchestration completed successfully!
-
-Result: Email marked as spam: Contains suspicious claims about winning money and urgent action requests...
-```
-
-## Scriptable Usage
-
-You can also pipe email content to the app:
-
-```bash
-# Test with a legitimate email
-echo "Hi John, I hope you're doing well..." | dotnet run
-
-# Test with a spam email
-echo "URGENT! You've won $1,000,000! Click here now!" | dotnet run
-```
-
-The orchestration will proceed as follows:
-
-1. The SpamDetectionAgent analyzes the email to determine if it's spam
-2. Based on the result:
-   - If spam: The orchestration calls the `HandleSpamEmail` activity function
-   - If not spam: The EmailAssistantAgent drafts a response, then the `SendEmail` activity function is called
-
-## Viewing Orchestration State
-
-You can view the state of the orchestration in the Durable Task Scheduler dashboard:
-
-1. Open your browser and navigate to `http://localhost:8082`
-2. In the dashboard, you can see:
-   - **Orchestrations**: View the orchestration instance, including its runtime status, input, output, and execution history
-   - **Agents**: View the state of both the SpamDetectionAgent and EmailAssistantAgent
-
-The orchestration instance ID is displayed in the console output. You can use this ID to find the specific orchestration in the dashboard and inspect the conditional branching logic, including which path was taken based on the spam detection result.

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/05_AgentOrchestration_HITL/05_AgentOrchestration_HITL.csproj

@@ -1,30 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-  <PropertyGroup>
-    <TargetFrameworks>net10.0</TargetFrameworks>
-    <OutputType>Exe</OutputType>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-    <AssemblyName>AgentOrchestration_HITL</AssemblyName>
-    <RootNamespace>AgentOrchestration_HITL</RootNamespace>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <PackageReference Include="Azure.AI.OpenAI" />
-    <PackageReference Include="Azure.Identity" />
-    <PackageReference Include="Microsoft.DurableTask.Client.AzureManaged" />
-    <PackageReference Include="Microsoft.DurableTask.Worker.AzureManaged" />
-    <PackageReference Include="Microsoft.Extensions.Hosting" />
-  </ItemGroup>
-
-  <!-- Local projects that should be switched to package references when using the sample outside of this MAF repo -->
-  <!--
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Agents.AI.DurableTask" />
-    <PackageReference Include="Microsoft.Agents.AI.OpenAI" />
-  </ItemGroup>
-  -->
-  <ItemGroup>
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.DurableTask\Microsoft.Agents.AI.DurableTask.csproj" />
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.OpenAI\Microsoft.Agents.AI.OpenAI.csproj" />
-  </ItemGroup>
-</Project>

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/05_AgentOrchestration_HITL/Models.cs

@@ -1,44 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-using System.Text.Json.Serialization;
-
-namespace AgentOrchestration_HITL;
-
-/// <summary>
-/// Represents the input for the Human-in-the-Loop content generation workflow.
-/// </summary>
-public sealed class ContentGenerationInput
-{
-    [JsonPropertyName("topic")]
-    public string Topic { get; set; } = string.Empty;
-
-    [JsonPropertyName("max_review_attempts")]
-    public int MaxReviewAttempts { get; set; } = 3;
-
-    [JsonPropertyName("approval_timeout_hours")]
-    public float ApprovalTimeoutHours { get; set; } = 72;
-}
-
-/// <summary>
-/// Represents the content generated by the writer agent.
-/// </summary>
-public sealed class GeneratedContent
-{
-    [JsonPropertyName("title")]
-    public string Title { get; set; } = string.Empty;
-
-    [JsonPropertyName("content")]
-    public string Content { get; set; } = string.Empty;
-}
-
-/// <summary>
-/// Represents the human approval response.
-/// </summary>
-public sealed class HumanApprovalResponse
-{
-    [JsonPropertyName("approved")]
-    public bool Approved { get; set; }
-
-    [JsonPropertyName("feedback")]
-    public string Feedback { get; set; } = string.Empty;
-}

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/05_AgentOrchestration_HITL/Program.cs

@@ -1,336 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-using System.Text.Json;
-using AgentOrchestration_HITL;
-using Azure;
-using Azure.AI.OpenAI;
-using Azure.Identity;
-using Microsoft.Agents.AI;
-using Microsoft.Agents.AI.DurableTask;
-using Microsoft.DurableTask;
-using Microsoft.DurableTask.Client;
-using Microsoft.DurableTask.Client.AzureManaged;
-using Microsoft.DurableTask.Worker;
-using Microsoft.DurableTask.Worker.AzureManaged;
-using Microsoft.Extensions.DependencyInjection;
-using Microsoft.Extensions.Hosting;
-using Microsoft.Extensions.Logging;
-using OpenAI.Chat;
-
-// Get the Azure OpenAI endpoint and deployment name from environment variables.
-string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_ENDPOINT is not set.");
-string deploymentName = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT_NAME")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_DEPLOYMENT_NAME is not set.");
-
-// Get DTS connection string from environment variable
-string dtsConnectionString = Environment.GetEnvironmentVariable("DURABLE_TASK_SCHEDULER_CONNECTION_STRING")
-    ?? "Endpoint=http://localhost:8080;TaskHub=default;Authentication=None";
-
-// Use Azure Key Credential if provided, otherwise use Azure CLI Credential.
-string? azureOpenAiKey = Environment.GetEnvironmentVariable("AZURE_OPENAI_API_KEY");
-// WARNING: DefaultAzureCredential is convenient for development but requires careful consideration in production.
-// In production, consider using a specific credential (e.g., ManagedIdentityCredential) to avoid
-// latency issues, unintended credential probing, and potential security risks from fallback mechanisms.
-AzureOpenAIClient client = !string.IsNullOrEmpty(azureOpenAiKey)
-    ? new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(azureOpenAiKey))
-    : new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential());
-
-// Single agent used by the orchestration to demonstrate human-in-the-loop workflow.
-const string WriterName = "WriterAgent";
-const string WriterInstructions =
-    """
-    You are a professional content writer who creates high-quality articles on various topics.
-    You write engaging, informative, and well-structured content that follows best practices for readability and accuracy.
-    """;
-
-AIAgent writerAgent = client.GetChatClient(deploymentName).AsAIAgent(WriterInstructions, WriterName);
-
-// Orchestrator function
-static async Task<object> RunOrchestratorAsync(TaskOrchestrationContext context, ContentGenerationInput input)
-{
-    // Get the writer agent
-    DurableAIAgent writerAgent = context.GetAgent("WriterAgent");
-    AgentSession writerSession = await writerAgent.CreateSessionAsync();
-
-    // Set initial status
-    context.SetCustomStatus($"Starting content generation for topic: {input.Topic}");
-
-    // Step 1: Generate initial content
-    AgentResponse<GeneratedContent> writerResponse = await writerAgent.RunAsync<GeneratedContent>(
-        message: $"Write a short article about '{input.Topic}' in less than 300 words.",
-        session: writerSession);
-    GeneratedContent content = writerResponse.Result;
-
-    // Human-in-the-loop iteration - we set a maximum number of attempts to avoid infinite loops
-    int iterationCount = 0;
-    while (iterationCount++ < input.MaxReviewAttempts)
-    {
-        context.SetCustomStatus(
-            $"Requesting human feedback. Iteration #{iterationCount}. Timeout: {input.ApprovalTimeoutHours} hour(s).");
-
-        // Step 2: Notify user to review the content
-        await context.CallActivityAsync(nameof(NotifyUserForApproval), content);
-
-        // Step 3: Wait for human feedback with configurable timeout
-        HumanApprovalResponse humanResponse;
-        try
-        {
-            humanResponse = await context.WaitForExternalEvent<HumanApprovalResponse>(
-                eventName: "HumanApproval",
-                timeout: TimeSpan.FromHours(input.ApprovalTimeoutHours));
-        }
-        catch (OperationCanceledException)
-        {
-            // Timeout occurred - treat as rejection
-            context.SetCustomStatus(
-                $"Human approval timed out after {input.ApprovalTimeoutHours} hour(s). Treating as rejection.");
-            throw new TimeoutException($"Human approval timed out after {input.ApprovalTimeoutHours} hour(s).");
-        }
-
-        if (humanResponse.Approved)
-        {
-            context.SetCustomStatus("Content approved by human reviewer. Publishing content...");
-
-            // Step 4: Publish the approved content
-            await context.CallActivityAsync(nameof(PublishContent), content);
-
-            context.SetCustomStatus($"Content published successfully at {context.CurrentUtcDateTime:s}");
-            return new { content = content.Content };
-        }
-
-        context.SetCustomStatus("Content rejected by human reviewer. Incorporating feedback and regenerating...");
-
-        // Incorporate human feedback and regenerate
-        writerResponse = await writerAgent.RunAsync<GeneratedContent>(
-            message: $"""
-                The content was rejected by a human reviewer. Please rewrite the article incorporating their feedback.
-                
-                Human Feedback: {humanResponse.Feedback}
-                """,
-            session: writerSession);
-
-        content = writerResponse.Result;
-    }
-
-    // If we reach here, it means we exhausted the maximum number of iterations
-    throw new InvalidOperationException(
-        $"Content could not be approved after {input.MaxReviewAttempts} iterations.");
-}
-
-// Activity functions
-static void NotifyUserForApproval(TaskActivityContext context, GeneratedContent content)
-{
-    // In a real implementation, this would send notifications via email, SMS, etc.
-    Console.WriteLine(
-        $"""
-        NOTIFICATION: Please review the following content for approval:
-        Title: {content.Title}
-        Content: {content.Content}
-        Use the approval endpoint to approve or reject this content.
-        """);
-}
-
-static void PublishContent(TaskActivityContext context, GeneratedContent content)
-{
-    // In a real implementation, this would publish to a CMS, website, etc.
-    Console.WriteLine(
-        $"""
-        PUBLISHING: Content has been published successfully.
-        Title: {content.Title}
-        Content: {content.Content}
-        """);
-}
-
-// Configure the console app to host the AI agent.
-IHost host = Host.CreateDefaultBuilder(args)
-    .ConfigureLogging(loggingBuilder => loggingBuilder.SetMinimumLevel(LogLevel.Warning))
-    .ConfigureServices(services =>
-    {
-        services.ConfigureDurableAgents(
-            options => options.AddAIAgent(writerAgent),
-            workerBuilder: builder =>
-            {
-                builder.UseDurableTaskScheduler(dtsConnectionString);
-                builder.AddTasks(registry =>
-                {
-                    registry.AddOrchestratorFunc<ContentGenerationInput>(nameof(RunOrchestratorAsync), RunOrchestratorAsync);
-                    registry.AddActivityFunc<GeneratedContent>(nameof(NotifyUserForApproval), NotifyUserForApproval);
-                    registry.AddActivityFunc<GeneratedContent>(nameof(PublishContent), PublishContent);
-                });
-            },
-            clientBuilder: builder => builder.UseDurableTaskScheduler(dtsConnectionString));
-    })
-    .Build();
-
-await host.StartAsync();
-
-DurableTaskClient durableTaskClient = host.Services.GetRequiredService<DurableTaskClient>();
-
-// Console colors for better UX
-Console.ForegroundColor = ConsoleColor.Cyan;
-Console.WriteLine("=== Human-in-the-Loop Orchestration Sample ===");
-Console.ResetColor();
-Console.WriteLine("Enter topic for content generation:");
-Console.WriteLine();
-
-// Read topic from stdin
-string? topic = Console.ReadLine();
-if (string.IsNullOrWhiteSpace(topic))
-{
-    Console.ForegroundColor = ConsoleColor.Red;
-    Console.Error.WriteLine("Error: Topic is required.");
-    Console.ResetColor();
-    Environment.Exit(1);
-    return;
-}
-
-// Prompt for optional parameters with defaults
-Console.WriteLine();
-Console.WriteLine("Max review attempts (default: 3):");
-string? maxAttemptsInput = Console.ReadLine();
-int maxReviewAttempts = int.TryParse(maxAttemptsInput, out int maxAttempts) && maxAttempts > 0
-    ? maxAttempts
-    : 3;
-
-Console.WriteLine("Approval timeout in hours (default: 72):");
-string? timeoutInput = Console.ReadLine();
-float approvalTimeoutHours = float.TryParse(timeoutInput, out float timeout) && timeout > 0
-    ? timeout
-    : 72;
-
-ContentGenerationInput input = new()
-{
-    Topic = topic,
-    MaxReviewAttempts = maxReviewAttempts,
-    ApprovalTimeoutHours = approvalTimeoutHours
-};
-
-Console.WriteLine();
-Console.ForegroundColor = ConsoleColor.Gray;
-Console.WriteLine("Starting orchestration...");
-Console.ResetColor();
-
-try
-{
-    // Start the orchestration
-    string instanceId = await durableTaskClient.ScheduleNewOrchestrationInstanceAsync(
-        orchestratorName: nameof(RunOrchestratorAsync),
-        input: input);
-
-    Console.ForegroundColor = ConsoleColor.Gray;
-    Console.WriteLine($"Orchestration started with instance ID: {instanceId}");
-    Console.WriteLine("Waiting for human approval...");
-    Console.ResetColor();
-    Console.WriteLine();
-
-    // Monitor orchestration status and handle approval prompts
-    using CancellationTokenSource cts = new();
-    Task orchestrationTask = Task.Run(async () =>
-    {
-        while (!cts.Token.IsCancellationRequested)
-        {
-            OrchestrationMetadata? status = await durableTaskClient.GetInstanceAsync(
-                instanceId,
-                getInputsAndOutputs: true,
-                cts.Token);
-
-            if (status == null)
-            {
-                await Task.Delay(TimeSpan.FromSeconds(1), cts.Token);
-                continue;
-            }
-
-            // Check if we're waiting for approval
-            if (status.SerializedCustomStatus != null)
-            {
-                string? customStatus = status.ReadCustomStatusAs<string>();
-                if (customStatus?.StartsWith("Requesting human feedback", StringComparison.OrdinalIgnoreCase) == true)
-                {
-                    // Prompt user for approval
-                    Console.ForegroundColor = ConsoleColor.Yellow;
-                    Console.WriteLine("Content is ready for review. Check the logs above for details.");
-                    Console.Write("Approve? (y/n): ");
-                    Console.ResetColor();
-
-                    string? approvalInput = Console.ReadLine();
-                    bool approved = approvalInput?.Trim().Equals("y", StringComparison.OrdinalIgnoreCase) == true;
-
-                    Console.Write("Feedback (optional): ");
-                    string? feedback = Console.ReadLine() ?? "";
-
-                    HumanApprovalResponse approvalResponse = new()
-                    {
-                        Approved = approved,
-                        Feedback = feedback
-                    };
-
-                    await durableTaskClient.RaiseEventAsync(instanceId, "HumanApproval", approvalResponse);
-                }
-            }
-
-            if (status.RuntimeStatus is OrchestrationRuntimeStatus.Completed or OrchestrationRuntimeStatus.Failed or OrchestrationRuntimeStatus.Terminated)
-            {
-                break;
-            }
-
-            await Task.Delay(TimeSpan.FromSeconds(1), cts.Token);
-        }
-    }, cts.Token);
-
-    // Wait for orchestration to complete
-    OrchestrationMetadata finalStatus = await durableTaskClient.WaitForInstanceCompletionAsync(
-        instanceId,
-        getInputsAndOutputs: true,
-        CancellationToken.None);
-
-    cts.Cancel();
-    await orchestrationTask;
-
-    Console.WriteLine();
-
-    if (finalStatus.RuntimeStatus == OrchestrationRuntimeStatus.Completed)
-    {
-        Console.ForegroundColor = ConsoleColor.Green;
-        Console.WriteLine("✓ Orchestration completed successfully!");
-        Console.ResetColor();
-        Console.WriteLine();
-
-        JsonElement output = finalStatus.ReadOutputAs<JsonElement>();
-        if (output.TryGetProperty("content", out JsonElement contentElement))
-        {
-            Console.ForegroundColor = ConsoleColor.Yellow;
-            Console.WriteLine("Published content:");
-            Console.ResetColor();
-            Console.WriteLine(contentElement.GetString());
-        }
-    }
-    else if (finalStatus.RuntimeStatus == OrchestrationRuntimeStatus.Failed)
-    {
-        Console.ForegroundColor = ConsoleColor.Red;
-        Console.WriteLine("✗ Orchestration failed!");
-        Console.ResetColor();
-        if (finalStatus.FailureDetails != null)
-        {
-            Console.WriteLine($"Error: {finalStatus.FailureDetails.ErrorMessage}");
-        }
-        Environment.Exit(1);
-    }
-    else
-    {
-        Console.ForegroundColor = ConsoleColor.Yellow;
-        Console.WriteLine($"Orchestration status: {finalStatus.RuntimeStatus}");
-        Console.ResetColor();
-    }
-}
-catch (Exception ex)
-{
-    Console.ForegroundColor = ConsoleColor.Red;
-    Console.Error.WriteLine($"Error: {ex.Message}");
-    Console.ResetColor();
-    Environment.Exit(1);
-}
-finally
-{
-    await host.StopAsync();
-}

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/05_AgentOrchestration_HITL/README.md

@@ -1,73 +0,0 @@
-# Human-in-the-Loop Orchestration Sample
-
-This sample demonstrates how to use the durable agents extension to create a console app that implements a human-in-the-loop workflow using durable orchestration, including interactive approval prompts.
-
-## Key Concepts Demonstrated
-
-- Human-in-the-loop workflows with durable orchestration
-- External event handling for human approval/rejection
-- Timeout handling for approval requests
-- Iterative content refinement based on human feedback
-
-## Environment Setup
-
-See the [README.md](../README.md) file in the parent directory for more information on how to configure the environment, including how to install and run common sample dependencies.
-
-## Running the Sample
-
-With the environment setup, you can run the sample:
-
-```bash
-cd dotnet/samples/04-hosting/DurableAgents/ConsoleApps/05_AgentOrchestration_HITL
-dotnet run --framework net10.0
-```
-
-The app will prompt you for input:
-
-```text
-=== Human-in-the-Loop Orchestration Sample ===
-Enter topic for content generation:
-
-The Future of Artificial Intelligence
-
-Max review attempts (default: 3):
-3
-Approval timeout in hours (default: 72):
-72
-```
-
-The orchestration will generate content and prompt you for approval:
-
-```text
-Orchestration started with instance ID: 86313f1d45fb42eeb50b1852626bf3ff
-
-=== NOTIFICATION: Content Ready for Review ===
-Title: The Future of Artificial Intelligence
-
-Content:
-[Generated content appears here]
-
-Please review the content above and provide your approval.
-
-Content is ready for review. Check the logs above for details.
-Approve? (y/n): n
-Feedback (optional): Please add more details about the ethical implications.
-```
-
-The orchestration will incorporate your feedback and regenerate the content. Once approved, it will publish and complete.
-
-## Viewing Orchestration State
-
-You can view the state of the orchestration in the Durable Task Scheduler dashboard:
-
-1. Open your browser and navigate to `http://localhost:8082`
-2. In the dashboard, you can see:
-   - **Orchestrations**: View the orchestration instance, including its runtime status, custom status (which shows approval state), input, output, and execution history
-   - **Agents**: View the state of the WriterAgent, including conversation history
-
-The orchestration instance ID is displayed in the console output. You can use this ID to find the specific orchestration in the dashboard and inspect:
-
-- The custom status field, which shows the current state of the approval workflow
-- When the orchestration is waiting for external events
-- The iteration count and feedback history
-- The final published content

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/06_LongRunningTools/06_LongRunningTools.csproj

@@ -1,30 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-  <PropertyGroup>
-    <TargetFrameworks>net10.0</TargetFrameworks>
-    <OutputType>Exe</OutputType>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-    <AssemblyName>LongRunningTools</AssemblyName>
-    <RootNamespace>LongRunningTools</RootNamespace>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <PackageReference Include="Azure.AI.OpenAI" />
-    <PackageReference Include="Azure.Identity" />
-    <PackageReference Include="Microsoft.DurableTask.Client.AzureManaged" />
-    <PackageReference Include="Microsoft.DurableTask.Worker.AzureManaged" />
-    <PackageReference Include="Microsoft.Extensions.Hosting" />
-  </ItemGroup>
-
-  <!-- Local projects that should be switched to package references when using the sample outside of this MAF repo -->
-  <!--
-  <ItemGroup>
-    <PackageReference Include="Microsoft.Agents.AI.DurableTask" />
-    <PackageReference Include="Microsoft.Agents.AI.OpenAI" />
-  </ItemGroup>
-  -->
-  <ItemGroup>
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.DurableTask\Microsoft.Agents.AI.DurableTask.csproj" />
-    <ProjectReference Include="..\..\..\..\..\src\Microsoft.Agents.AI.OpenAI\Microsoft.Agents.AI.OpenAI.csproj" />
-  </ItemGroup>
-</Project>

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/06_LongRunningTools/Models.cs

@@ -1,44 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-using System.Text.Json.Serialization;
-
-namespace LongRunningTools;
-
-/// <summary>
-/// Represents the input for the content generation workflow.
-/// </summary>
-public sealed class ContentGenerationInput
-{
-    [JsonPropertyName("topic")]
-    public string Topic { get; set; } = string.Empty;
-
-    [JsonPropertyName("max_review_attempts")]
-    public int MaxReviewAttempts { get; set; } = 3;
-
-    [JsonPropertyName("approval_timeout_hours")]
-    public float ApprovalTimeoutHours { get; set; } = 72;
-}
-
-/// <summary>
-/// Represents the content generated by the writer agent.
-/// </summary>
-public sealed class GeneratedContent
-{
-    [JsonPropertyName("title")]
-    public string Title { get; set; } = string.Empty;
-
-    [JsonPropertyName("content")]
-    public string Content { get; set; } = string.Empty;
-}
-
-/// <summary>
-/// Represents the human feedback response.
-/// </summary>
-public sealed class HumanFeedbackResponse
-{
-    [JsonPropertyName("approved")]
-    public bool Approved { get; set; }
-
-    [JsonPropertyName("feedback")]
-    public string Feedback { get; set; } = string.Empty;
-}

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/06_LongRunningTools/Program.cs

@@ -1,355 +0,0 @@
-// Copyright (c) Microsoft. All rights reserved.
-
-using System.ComponentModel;
-using Azure;
-using Azure.AI.OpenAI;
-using Azure.Identity;
-using LongRunningTools;
-using Microsoft.Agents.AI;
-using Microsoft.Agents.AI.DurableTask;
-using Microsoft.DurableTask;
-using Microsoft.DurableTask.Client;
-using Microsoft.DurableTask.Client.AzureManaged;
-using Microsoft.DurableTask.Worker;
-using Microsoft.DurableTask.Worker.AzureManaged;
-using Microsoft.Extensions.AI;
-using Microsoft.Extensions.DependencyInjection;
-using Microsoft.Extensions.Hosting;
-using Microsoft.Extensions.Logging;
-using OpenAI.Chat;
-
-// Get the Azure OpenAI endpoint and deployment name from environment variables.
-string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_ENDPOINT is not set.");
-string deploymentName = Environment.GetEnvironmentVariable("AZURE_OPENAI_DEPLOYMENT_NAME")
-    ?? throw new InvalidOperationException("AZURE_OPENAI_DEPLOYMENT_NAME is not set.");
-
-// Get DTS connection string from environment variable
-string dtsConnectionString = Environment.GetEnvironmentVariable("DURABLE_TASK_SCHEDULER_CONNECTION_STRING")
-    ?? "Endpoint=http://localhost:8080;TaskHub=default;Authentication=None";
-
-// Use Azure Key Credential if provided, otherwise use Azure CLI Credential.
-string? azureOpenAiKey = Environment.GetEnvironmentVariable("AZURE_OPENAI_API_KEY");
-// WARNING: DefaultAzureCredential is convenient for development but requires careful consideration in production.
-// In production, consider using a specific credential (e.g., ManagedIdentityCredential) to avoid
-// latency issues, unintended credential probing, and potential security risks from fallback mechanisms.
-AzureOpenAIClient client = !string.IsNullOrEmpty(azureOpenAiKey)
-    ? new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(azureOpenAiKey))
-    : new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential());
-
-// Agent used by the orchestration to write content.
-const string WriterAgentName = "Writer";
-const string WriterAgentInstructions =
-    """
-    You are a professional content writer who creates high-quality articles on various topics.
-    You write engaging, informative, and well-structured content that follows best practices for readability and accuracy.
-    """;
-
-AIAgent writerAgent = client.GetChatClient(deploymentName).AsAIAgent(WriterAgentInstructions, WriterAgentName);
-
-// Agent that can start content generation workflows using tools
-const string PublisherAgentName = "Publisher";
-const string PublisherAgentInstructions =
-    """
-    You are a publishing agent that can manage content generation workflows.
-    You have access to tools to start, monitor, and raise events for content generation workflows.
-    """;
-
-const string HumanFeedbackEventName = "HumanFeedback";
-
-// Orchestrator function
-static async Task<object> RunOrchestratorAsync(TaskOrchestrationContext context, ContentGenerationInput input)
-{
-    // Get the writer agent
-    DurableAIAgent writerAgent = context.GetAgent(WriterAgentName);
-    AgentSession writerSession = await writerAgent.CreateSessionAsync();
-
-    // Set initial status
-    context.SetCustomStatus($"Starting content generation for topic: {input.Topic}");
-
-    // Step 1: Generate initial content
-    AgentResponse<GeneratedContent> writerResponse = await writerAgent.RunAsync<GeneratedContent>(
-        message: $"Write a short article about '{input.Topic}'.",
-        session: writerSession);
-    GeneratedContent content = writerResponse.Result;
-
-    // Human-in-the-loop iteration - we set a maximum number of attempts to avoid infinite loops
-    int iterationCount = 0;
-    while (iterationCount++ < input.MaxReviewAttempts)
-    {
-        // NOTE: CustomStatus has a 16 KB UTF-16 limit in Durable Functions.
-        // Only include short metadata here - the full content is passed via activity inputs/outputs.
-        context.SetCustomStatus(
-            new
-            {
-                message = "Requesting human feedback.",
-                approvalTimeoutHours = input.ApprovalTimeoutHours,
-                iterationCount,
-                contentTitle = content.Title,
-            });
-
-        // Step 2: Notify user to review the content
-        await context.CallActivityAsync(nameof(NotifyUserForApproval), content);
-
-        // Step 3: Wait for human feedback with configurable timeout
-        HumanFeedbackResponse humanResponse;
-        try
-        {
-            humanResponse = await context.WaitForExternalEvent<HumanFeedbackResponse>(
-                eventName: HumanFeedbackEventName,
-                timeout: TimeSpan.FromHours(input.ApprovalTimeoutHours));
-        }
-        catch (OperationCanceledException)
-        {
-            // Timeout occurred - treat as rejection
-            context.SetCustomStatus(
-                new
-                {
-                    message = $"Human approval timed out after {input.ApprovalTimeoutHours} hour(s). Treating as rejection.",
-                    iterationCount,
-                });
-            throw new TimeoutException($"Human approval timed out after {input.ApprovalTimeoutHours} hour(s).");
-        }
-
-        if (humanResponse.Approved)
-        {
-            context.SetCustomStatus(new
-            {
-                message = "Content approved by human reviewer. Publishing content...",
-                contentTitle = content.Title,
-            });
-
-            // Step 4: Publish the approved content
-            await context.CallActivityAsync(nameof(PublishContent), content);
-
-            context.SetCustomStatus(new
-            {
-                message = $"Content published successfully at {context.CurrentUtcDateTime:s}",
-                humanFeedback = humanResponse,
-                contentTitle = content.Title,
-            });
-            return new { content = content.Content };
-        }
-
-        context.SetCustomStatus(new
-        {
-            message = "Content rejected by human reviewer. Incorporating feedback and regenerating...",
-            humanFeedback = humanResponse,
-            contentTitle = content.Title,
-        });
-
-        // Incorporate human feedback and regenerate
-        writerResponse = await writerAgent.RunAsync<GeneratedContent>(
-            message: $"""
-                The content was rejected by a human reviewer. Please rewrite the article incorporating their feedback.
-                
-                Human Feedback: {humanResponse.Feedback}
-                """,
-            session: writerSession);
-
-        content = writerResponse.Result;
-    }
-
-    // If we reach here, it means we exhausted the maximum number of iterations
-    throw new InvalidOperationException(
-        $"Content could not be approved after {input.MaxReviewAttempts} iterations.");
-}
-
-// Activity functions
-static void NotifyUserForApproval(TaskActivityContext context, GeneratedContent content)
-{
-    // In a real implementation, this would send notifications via email, SMS, etc.
-    Console.ForegroundColor = ConsoleColor.DarkMagenta;
-    Console.WriteLine(
-        $"""
-        NOTIFICATION: Please review the following content for approval:
-        Title: {content.Title}
-        Content: {content.Content}
-        """);
-    Console.ResetColor();
-}
-
-static void PublishContent(TaskActivityContext context, GeneratedContent content)
-{
-    // In a real implementation, this would publish to a CMS, website, etc.
-    Console.ForegroundColor = ConsoleColor.DarkMagenta;
-    Console.WriteLine(
-        $"""
-        PUBLISHING: Content has been published successfully.
-        Title: {content.Title}
-        Content: {content.Content}
-        """);
-    Console.ResetColor();
-}
-
-// Tools that demonstrate starting orchestrations from agent tool calls.
-[Description("Starts a content generation workflow and returns the instance ID for tracking.")]
-static string StartContentGenerationWorkflow([Description("The topic for content generation")] string topic)
-{
-    const int MaxReviewAttempts = 3;
-    const float ApprovalTimeoutHours = 72;
-
-    // Schedule the orchestration, which will start running after the tool call completes.
-    string instanceId = DurableAgentContext.Current.ScheduleNewOrchestration(
-        name: nameof(RunOrchestratorAsync),
-        input: new ContentGenerationInput
-        {
-            Topic = topic,
-            MaxReviewAttempts = MaxReviewAttempts,
-            ApprovalTimeoutHours = ApprovalTimeoutHours
-        });
-
-    return $"Workflow started with instance ID: {instanceId}";
-}
-
-[Description("Gets the status of a workflow orchestration and returns a summary of the workflow's current status.")]
-static async Task<object> GetWorkflowStatusAsync(
-    [Description("The instance ID of the workflow to check")] string instanceId,
-    [Description("Whether to include detailed information")] bool includeDetails = true)
-{
-    // Get the current agent context using the session-static property
-    OrchestrationMetadata? status = await DurableAgentContext.Current.GetOrchestrationStatusAsync(
-        instanceId,
-        includeDetails);
-
-    if (status is null)
-    {
-        return new
-        {
-            instanceId,
-            error = $"Workflow instance '{instanceId}' not found.",
-        };
-    }
-
-    return new
-    {
-        instanceId = status.InstanceId,
-        createdAt = status.CreatedAt,
-        executionStatus = status.RuntimeStatus,
-        workflowStatus = status.SerializedCustomStatus,
-        lastUpdatedAt = status.LastUpdatedAt,
-        failureDetails = status.FailureDetails
-    };
-}
-
-[Description(
-    "Raises a feedback event for the content generation workflow. If approved, the workflow will be published. " +
-    "If rejected, the workflow will generate new content.")]
-static async Task SubmitHumanFeedbackAsync(
-    [Description("The instance ID of the workflow to submit feedback for")] string instanceId,
-    [Description("Feedback to submit")] HumanFeedbackResponse feedback)
-{
-    await DurableAgentContext.Current.RaiseOrchestrationEventAsync(instanceId, HumanFeedbackEventName, feedback);
-}
-
-// Configure the console app to host the AI agents.
-IHost host = Host.CreateDefaultBuilder(args)
-    .ConfigureLogging(loggingBuilder => loggingBuilder.SetMinimumLevel(LogLevel.Warning))
-    .ConfigureServices(services =>
-    {
-        services.ConfigureDurableAgents(
-            options =>
-            {
-                // Add the writer agent used by the orchestration
-                options.AddAIAgent(writerAgent);
-
-                // Define the agent that can start orchestrations from tool calls
-                options.AddAIAgentFactory(PublisherAgentName, sp =>
-                {
-                    return client.GetChatClient(deploymentName).AsAIAgent(
-                        instructions: PublisherAgentInstructions,
-                        name: PublisherAgentName,
-                        services: sp,
-                        tools: [
-                            AIFunctionFactory.Create(StartContentGenerationWorkflow),
-                            AIFunctionFactory.Create(GetWorkflowStatusAsync),
-                            AIFunctionFactory.Create(SubmitHumanFeedbackAsync),
-                        ]);
-                });
-            },
-            workerBuilder: builder =>
-            {
-                builder.UseDurableTaskScheduler(dtsConnectionString);
-                builder.AddTasks(registry =>
-                {
-                    registry.AddOrchestratorFunc<ContentGenerationInput>(nameof(RunOrchestratorAsync), RunOrchestratorAsync);
-                    registry.AddActivityFunc<GeneratedContent>(nameof(NotifyUserForApproval), NotifyUserForApproval);
-                    registry.AddActivityFunc<GeneratedContent>(nameof(PublishContent), PublishContent);
-                });
-            },
-            clientBuilder: builder => builder.UseDurableTaskScheduler(dtsConnectionString));
-    })
-    .Build();
-
-await host.StartAsync();
-
-// Get the agent proxy from services
-IServiceProvider services = host.Services;
-AIAgent? agentProxy = services.GetKeyedService<AIAgent>(PublisherAgentName);
-if (agentProxy == null)
-{
-    Console.ForegroundColor = ConsoleColor.Red;
-    Console.Error.WriteLine("Agent 'Publisher' not found.");
-    Console.ResetColor();
-    Environment.Exit(1);
-    return;
-}
-
-// Console colors for better UX
-Console.ForegroundColor = ConsoleColor.Cyan;
-Console.WriteLine("=== Long Running Tools Sample ===");
-Console.ResetColor();
-Console.WriteLine("Enter a topic for the Publisher agent to write about (or 'exit' to quit):");
-Console.WriteLine();
-
-// Create a session for the conversation
-AgentSession session = await agentProxy.CreateSessionAsync();
-
-using CancellationTokenSource cts = new();
-Console.CancelKeyPress += (sender, e) =>
-{
-    e.Cancel = true;
-    cts.Cancel();
-};
-
-while (!cts.Token.IsCancellationRequested)
-{
-    // Read input from stdin
-    Console.ForegroundColor = ConsoleColor.Yellow;
-    Console.Write("You: ");
-    Console.ResetColor();
-
-    string? input = Console.ReadLine();
-    if (string.IsNullOrWhiteSpace(input) || input.Equals("exit", StringComparison.OrdinalIgnoreCase))
-    {
-        break;
-    }
-
-    // Run the agent
-    Console.ForegroundColor = ConsoleColor.Green;
-    Console.Write("Publisher: ");
-    Console.ResetColor();
-
-    try
-    {
-        AgentResponse agentResponse = await agentProxy.RunAsync(
-            message: input,
-            session: session,
-            cancellationToken: cts.Token);
-
-        Console.WriteLine(agentResponse.Text);
-        Console.WriteLine();
-    }
-    catch (Exception ex)
-    {
-        Console.ForegroundColor = ConsoleColor.Red;
-        Console.Error.WriteLine($"Error: {ex.Message}");
-        Console.ResetColor();
-        Console.WriteLine();
-    }
-
-    Console.WriteLine("(Press Enter to prompt the Publisher agent again)");
-    _ = Console.ReadLine();
-}
-
-await host.StopAsync();

dotnet/samples/04-hosting/DurableAgents/ConsoleApps/06_LongRunningTools/README.md

@@ -1,90 +0,0 @@
-# Long Running Tools Sample
-
-This sample demonstrates how to use the durable agents extension to create a console app with agents that have long running tools. This sample builds on the [05_AgentOrchestration_HITL](../05_AgentOrchestration_HITL) sample by adding a publisher agent that can start and manage content generation workflows. A key difference is that the publisher agent knows the IDs of the workflows it starts, so it can check the status of the workflows and approve or reject them without being explicitly given the context (instance IDs, etc).
-
-## Key Concepts Demonstrated
-
-The same key concepts as the [05_AgentOrchestration_HITL](../05_AgentOrchestration_HITL) sample are demonstrated, but with the following additional concepts:
-
-- **Long running tools**: Using `DurableAgentContext.Current` to start orchestrations from tool calls
-- **Multi-agent orchestration**: Agents can start and manage workflows that orchestrate other agents
-- **Human-in-the-loop (with delegation)**: The agent acts as an intermediary between the human and the workflow. The human remains in the loop, but delegates to the agent to start the workflow and approve or reject the content.
-
-## Environment Setup
-
-See the [README.md](../README.md) file in the parent directory for more information on how to configure the environment, including how to install and run common sample dependencies.
-
-## Running the Sample
-
-With the environment setup, you can run the sample:
-
-```bash
-cd dotnet/samples/04-hosting/DurableAgents/ConsoleApps/06_LongRunningTools
-dotnet run --framework net10.0
-```
-
-The app will prompt you for input. You can interact with the Publisher agent:
-
-```text
-=== Long Running Tools Sample ===
-Enter a topic for the Publisher agent to write about (or 'exit' to quit):
-
-You: Start a content generation workflow for the topic 'The Future of Artificial Intelligence'
-Publisher: The content generation workflow for the topic "The Future of Artificial Intelligence" has been successfully started, and the instance ID is **6a04276e8d824d8d941e1dc4142cc254**. If you need any further assistance or updates on the workflow, feel free to ask!
-```
-
-Behind the scenes, the publisher agent will:
-
-1. Start the content generation workflow via a tool call
-2. The workflow will generate initial content using the Writer agent and wait for human approval, which will be visible in the terminal
-
-Once the workflow is waiting for human approval, you can send approval or rejection by prompting the publisher agent accordingly.
-
-> [!NOTE]
-> You must press Enter after each message to continue the conversation. The sample is set up this way because the workflow is running in the background and may write to the console asynchronously.
-
-To tell the agent to rewrite the content with feedback, you can prompt it to reject the content with feedback.
-
-```text
-You: Reject the content with feedback: The article needs more technical depth and better examples.
-Publisher: The content has been successfully rejected with the feedback: "The article needs more technical depth and better examples." The workflow will now generate new content based on this feedback.
-```
-
-Once you're satisfied with the content, you can approve it for publishing.
-
-```text
-You: Approve the content
-Publisher: The content has been successfully approved for publishing. If you need any more assistance or have further requests, feel free to let me know!
-```
-
-Once the workflow has completed, you can get the status by prompting the publisher agent to give you the status.
-
-```text
-You: Get the status of the workflow you previously started
-Publisher: The status of the workflow with instance ID **6a04276e8d824d8d941e1dc4142cc254** is as follows:
-
-- **Execution Status:** Completed
-- **Created At:** December 22, 2025, 23:08:13 UTC
-- **Last Updated At:** December 22, 2025, 23:09:59 UTC
-- **Workflow Status:** 
-  - Message: Content published successfully at December 22, 2025, 23:09:59 UTC
-  - Human Feedback: Approved
-```
-
-## Viewing Agent and Orchestration State
-
-You can view the state of both the agent and the orchestrations it starts in the Durable Task Scheduler dashboard:
-
-1. Open your browser and navigate to `http://localhost:8082`
-2. In the dashboard, you can see:
-   - **Agents**: View the state of the Publisher agent, including its conversation history and tool call history
-   - **Orchestrations**: View the content generation orchestration instances that were started by the agent via tool calls, including their runtime status, custom status, input, output, and execution history
-
-When the publisher agent starts a workflow, the orchestration instance ID is included in the agent's response. You can use this ID to find the specific orchestration in the dashboard and inspect:
-
-- The orchestration's execution progress
-- When it's waiting for human approval (visible in custom status)
-- The content generation workflow state
-- The WriterAgent state within the orchestration
-
-This demonstrates how agents can manage long-running workflows and how you can monitor both the agent's state and the workflows it orchestrates.