feat: Simulation upgrades

[TEJASNARAYANS]

What Changed?

Briefly describe what this PR changes.

Why?

Explain the problem this solves and why this approach was chosen.

How to Test?

List clear steps for reviewers to verify the change.

Release Label

Select one semantic version bump intent for this PR:

• major - breaking change, next release bumps major version
• minor - backward-compatible feature, next release bumps minor version
• fix - backward-compatible bug fix, next release bumps patch version
• No label (defaults to patch release)

If you do not have permission to apply labels, mention the intended release label here and a maintainer will set it.

Checklist

• I have read the CONTRIBUTING.md guide.
• My code follows the project's style guidelines.
• I have added tests that prove my fix is effective or my feature works.
• I have updated documentation where needed.

[TEJASNARAYANS]

@greptile-apps

[greptile-apps]

Greptile Summary

This PR substantially expands voice-agent simulations with structured test-agent templates, persona ambient audio, persona-aware evaluator suites, turn gating, recording alignment, and updated worker scheduling.

• Adds reusable and persona-specific ambient-noise uploads, previews, mixing, and telephony integration.
• Adds structured test-agent prompts and first-message behavior across backend and frontend workflows.
• Expands evaluator suites to support persona/scenario combinations and updates result navigation.
• Revises voice bridges, recording behavior, production-turn gating, and provider/model configuration.
• Moves evaluator cron dispatch onto the usage queue and adds related migrations and tests.

Confidence Score: 3/5

The PR should not merge until ambient uploads reject oversized bodies before loading them completely into API-worker memory.

Both newly added upload handlers apply the 10 MiB limit only after an unbounded read, leaving authenticated requests able to consume excessive process memory.

Files Needing Attention: app/api/v1/routes/personas.py

Security Review

The new ambient-audio upload endpoints enforce their 10 MiB limit only after reading the complete multipart file, allowing an authenticated Enterprise user to cause excessive API-worker memory consumption with an oversized request.

Important Files Changed

Filename	Overview
app/api/v1/routes/personas.py	Adds ambient library and persona-audio APIs, but both upload paths read oversized files fully before enforcing the configured limit.
app/services/audio/ambient_catalog.py	Adds platform and custom ambient resolution with validated API write paths; no reachable tenant or traversal failure was established.
app/services/audio/ambient_mixer.py	Adds decoding, resampling, looping, and volume-controlled ambient mixing used by simulation runtimes.
app/services/evaluators/evaluator_suite_service.py	Expands suite materialization and rotation around persona/scenario combinations.
app/services/testing/test_agent_template.py	Introduces normalized structured test-agent templates and deterministic prompt assembly.
app/services/webrtc_bridge/production_turn_gate.py	Adds production-agent turn buffering and gating behavior with focused test coverage.
app/services/voice_agent/audio_recorder.py	Extends recording and timing behavior for upgraded simulation and telephony audio flows.
app/workers/config.py	Routes evaluator cron dispatch through the usage worker topology with corresponding deployment and scheduling changes.
frontend/src/pages/personas/PersonaAmbientPanel.tsx	Adds persona ambient-source selection, upload, preview, and volume controls.
frontend/src/pages/agents/components/TestAgentTemplateEditor.tsx	Adds structured editing for test-agent prompt sections and opening-message modes.

_{Reviews (1): Last reviewed commit: "feat: updating recording issues" | Re-trigger Greptile}

[greptile-apps]

Upload limit applied late

When an authenticated Enterprise user submits an oversized ambient-audio file, await file.read() loads the complete file before the 10 MiB validation runs, causing excessive API-worker memory consumption or process termination. The same issue occurs in upload_persona_ambient_audio at lines 1255–1258.

How this was verified: Both upload handlers perform an unbounded read before checking the configured maximum, and the repository defines no earlier request-body limit.

[greptile-apps]

Too many files changed for review (140 files, 100 file limit).

Bypass the limit by tagging @greptile-apps to review.