chore: Dev to Main

[AjitPadhi-Microsoft]

Purpose

• This pull request introduces improvements to the deployment flexibility, documentation, and chat session management. The main focus is to allow customization of the Jumpbox VM size, provide better guidance and troubleshooting for VM SKU selection, and enhance the reliability of chat session handling in the frontend.

Does this introduce a breaking change?

• Yes
• No

How to Test

• Get the code

git clone [repo-address]
cd [repo-name]
git checkout [branch-name]
npm install

• Test the code

What to Check

Verify that the following are valid

• ...

Other Information

[Copilot]

Pull request overview

This PR expands Azure deployment configurability (notably around AI Foundry/Azure AI Service locations and WAF/jumpbox parameters), adds Voice Live support utilities plus frontend audio/text helpers, and introduces more robust automation/validation across infra parameters and CI workflows.

Changes:

• Added Voice Live backend utilities (voice config/credential/endpoint helpers, Foundry agent helper) and frontend audio/text helpers, plus related tests and config/env updates.
• Added Application Insights custom-event tracking hooks across multiple API routers and improved OpenTelemetry/FastAPI instrumentation setup.
• Refactored/standardized infra parameters + scripts (including a new Bicep↔parameters validator) and updated deployment/docs/CI workflows accordingly.

Reviewed changes

Copilot reviewed 92 out of 94 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/tests/utils/test_voice_utils.py	Adds unit tests for new voice utility helpers (voice/endpoint/credential/text cleaning).
src/tests/utils/test_foundry_agent_utils.py	Adds async unit tests for Foundry multi-agent caller helper.
src/tests/test_config.py	Adds coverage for new Voice Live settings defaults.
src/api/requirements.txt	Updates backend dependency versions and adds Voice Live + FastAPI OTel instrumentation deps.
src/api/env.sample	Adds telemetry/logging and Voice Live-related env variables to sample env.
src/api/app/utils/voice_utils.py	Introduces Voice Live helper functions (voice/credential/endpoint validation + TTS text cleaning).
src/api/app/utils/foundry_agent_utils.py	Adds helper to call Foundry multi-agent pipeline with robust import behavior.
src/api/app/utils/event_utils.py	Adds helper wrapper for emitting custom Application Insights events.
src/api/app/routers/products.py	Emits custom events for product CRUD/list operations.
src/api/app/routers/chat.py	Emits chat telemetry and adds /save-voice-message endpoint to persist voice messages.
src/api/app/routers/cart.py	Removes debug prints and adds cart/checkout telemetry events.
src/api/app/routers/auth.py	Adds auth-related telemetry events.
src/api/app/main.py	Adds .env loading, configurable logging suppression, Azure Monitor OTel setup, and span attribute middleware; includes Voice Live router.
src/api/app/database.py	Removes noisy print on Cosmos init failure.
src/api/app/config.py	Adds OpenAI API key field and a full set of Voice Live settings defaults.
src/App/src/lib/textCleaners.ts	Adds frontend TTS text cleaning helper mirroring backend behavior.
src/App/src/lib/audioUtils.ts	Adds PCM16 conversion/resampling/base64 and playback utilities for Voice Live.
src/App/src/lib/api.ts	Exposes API base URL getter and adds Voice Live config + voice-message persistence API calls.
src/App/src/components/Layout/ChatSidebar.tsx	Adds “new chat” button and voice-processing state wiring for the chat sidebar.
src/App/src/components/EnhancedChatMessageBubble.tsx	Switches default message rendering to react-markdown with basic link/image rendering.
src/App/src/App.tsx	Serializes voice message persistence to avoid session/message ordering races; improves new chat behavior.
src/App/public/pcm-processor.js	Adds AudioWorklet processor to capture microphone PCM samples.
src/App/package.json	Updates frontend dependencies/devDependencies (including major tooling bumps).
src/App/env.example	Removes frontend env example file.
src/App/Dockerfile	Updates frontend build image to Node 20 Alpine.
infra_basic/main.parameters.json	Aligns parameter names/values with updated bicep parameters and new env var naming.
infra_basic/main.bicep	Renames/standardizes params (solutionName/location/etc.), updates outputs, and adds Voice Live app settings.
infra_basic/existing_foundry_project.bicep	Updates Cognitive Services API versions; adjusts outputs.
infra_basic/deploy_managed_identity.bicep	Updates managed identity + role definition API versions.
infra_basic/deploy_foundry_role_assignment.bicep	Updates AI Services/Project/Deployment API versions and related resources.
infra_basic/deploy_enable_srch_managed_identity.bicep	Updates Search API version and hostingMode casing.
infra_basic/deploy_cosmos_db.bicep	Updates Cosmos API version and serverless configuration fields.
infra_basic/deploy_container_registry.bicep	Updates ACR API version.
infra_basic/deploy_backend_docker.bicep	Updates API versions and role definition versions for Cosmos/Search/AI Services references.
infra_basic/deploy_appservice-appsettings.bicep	Updates App Service API versions for app settings.
infra_basic/deploy_app_service_plan.bicep	Updates App Service plan API version.
infra_basic/deploy_app_service.bicep	Updates App Service API versions and logs config resource version.
infra_basic/deploy_aifp_aisearch_connection.bicep	Updates AI Foundry project connection API version.
infra_basic/deploy_ai_foundry.bicep	Updates AI Services/Search/Insights/Law API versions; adjusts project resource properties.
infra/vscode_web/requirements.txt	Updates VS Code Web infra python deps to newer Azure SDK versions.
infra/vscode_web/endpoint-requirements.txt	Updates endpoint requirements to match newer Azure SDK versions.
infra/scripts/validate_bicep_params.py	Adds validator script to ensure parameters JSON keys match Bicep params and env-var naming conventions.
infra/scripts/data_scripts/run_upload_data_scripts.sh	Adds network toggle guards + NETWORK_TOGGLE_ONLY mode and restore fallbacks for CI splitting.
infra/scripts/data_scripts/requirements.txt	Updates data script python deps (OpenAI/Azure SDK/pandas/python-dotenv).
infra/scripts/checkquota_agentic_application.sh	Adds realtime model quota check capability.
infra/scripts/checkquota.sh	Adds realtime model quota check capability.
infra/scripts/agent_scripts/run_create_agents_scripts.sh	Adds network toggle guards + NETWORK_TOGGLE_ONLY; switches agent MI principal lookup to ARM-based query.
infra/scripts/agent_scripts/requirements.txt	Updates agent script python deps (agent framework + Azure SDK).
infra/modules/web-sites.config.bicep	Updates API versions for storage/app/config resources.
infra/modules/web-sites.bicep	Updates AVM types versions, App Service API versions, and replaces multiple vnet flags with outboundVnetRouting.
infra/modules/virtualNetwork.bicep	Updates AVM module versions and expands jumpbox VM size guidance.
infra/modules/role-assignment.bicep	Updates AI Services/Project API versions used for project-scoped role assignment.
infra/modules/aifp-connections.bicep	Updates AI Foundry project connections API version.
infra/modules/ai-services-deployments.bicep	Updates AVM types + Cognitive Services API versions for deployments.
infra/modules/ai-project.bicep	Updates AI Services/Project API versions for project creation.
infra/main.waf.parameters.json	Updates WAF parameter mappings, adds VM sizing param, and aligns env var names.
infra/main.parameters.json	Updates core parameter mappings and env var naming (AI service location, ACR endpoint, capacities).
documents/TroubleShootingSteps.md	Expands SKU-not-available troubleshooting with jumpbox VM size override guidance.
documents/ReuseLogAnalytics.md	Updates env var name for reusing Log Analytics workspace resource ID.
documents/ReuseFoundryProject.md	Updates env var name for reusing Foundry project resource ID.
documents/LocalDevelopmentSetup.md	Adds note about manually populating Foundry agent names after running creation script.
documents/DeploymentGuide.md	Improves environment activation instructions and adds note about tenant security restrictions/WAF option.
documents/CustomizingAzdParameters.md	Updates parameter list and naming; adds VM size/admin credentials params; corrects env name length guidance.
azure.yaml	Adds postprovision hooks to print next-step instructions for data + agent setup scripts.
README.md	Adds note about tenant security restrictions and pointing to WAF deployment option.
.github/workflows/validate-bicep-params.yml	Adds scheduled/PR validation workflow for Bicep vs parameters mapping using new script.
.github/workflows/tests.yaml	Expands triggers and adds coverage commenting to PRs; updates action versions.
.github/workflows/test-automation-v2.yml	Updates actions versions (checkout/login/upload).
.github/workflows/stale-bot.yml	Updates stale action and other action versions.
.github/workflows/pylint.yml	Restricts trigger paths and updates action versions.
.github/workflows/pr-title-checker.yml	Updates semantic PR title checker action version.
.github/workflows/job-docker-build.yml	Updates actions versions for checkout/login/build.
.github/workflows/job-deploy.yml	Renames AI service location + EXP vars, adds realtime quota var, adds network toggle orchestration and tagging support.
.github/workflows/job-deploy-windows.yml	Aligns inputs/env var names; adds network enable/restore steps; updates actions versions.
.github/workflows/job-deploy-linux.yml	Aligns inputs/env var names; adds network enable/restore steps; updates actions versions.
.github/workflows/job-cleanup-deployment.yml	Renames AI service location input and updates azure/login action version.
.github/workflows/docker-build.yml	Adds path filters and updates actions versions.
.github/workflows/deploy.yml	Adds path filters, updates actions versions, and includes realtime model quota in failure email.
.github/workflows/deploy-v2.yml	Aligns EXP input naming for Log Analytics + Foundry project resource IDs.
.github/workflows/deploy-orchestrator.yml	Aligns downstream workflow inputs (AI service location, EXP vars).
.github/workflows/create-release.yml	Updates checkout and semantic-release action versions.
.github/workflows/codeql.yml	Adds path filters and updates CodeQL/checkout action versions.
.github/workflows/broken-links-checker.yml	Updates changed-files and lychee actions; adjusts link exclusion args.
.github/workflows/azure-dev.yml	Replaces template validation flow with an azd up deployment workflow and adds path filtering.
.github/workflows/azd-template-validation.yml	Adds scheduled azd template validation workflow.
.devcontainer/devcontainer.json	Reformats JSON and adds explicit bicepVersion in azure-cli feature config.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[github-actions]

🎉 This PR is included in version 1.2.6 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀