fix(hosting): wire the session history flags into compose and the env examples

[mmabrouk]

The problem

The runner service deliberately has no env_file, so it only receives the environment variables compose lists by name. AGENTA_SESSIONS_RECONSTRUCT and AGENTA_RECORDS_DURABLE were not listed in any of the four compose files.

The practical effect is that the feature this stack sits on could not be turned on anywhere. Not in the dev stack, not in a self-hosted deployment. The only place the flags took effect was a unit test that sets them in-process. I found this while trying to stand up a deployment to QA #5486, which could not be done until this was fixed.

The fix

List both flags on the runner service in all four compose files (EE and OSS, dev and gh), and document all four session flags together in the env examples, including the constraint that the runner flag and the web flag have to be flipped together.

Testing

Deployed an EE dev stack from this branch and confirmed both variables arrive inside the runner container. All the QA in this stack depends on it.

Base of the fix stack for #5486.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
agenta-documentation	Ready	Preview, Comment	Jul 24, 2026 10:00pm

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: c8dc02a1-d381-461c-b8eb-813e857d4320

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix/sessions-flags-wiring

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}