Skip to content

Graduate durable agent execution to stable in Common AI - #74704

Merged
kaxil merged 1 commit into
mainfrom
commonai-durable-stable
Oct 14, 2026
Merged

kaxil merged 1 commit into
mainfrom
commonai-durable-stable

Conversation

@kaxil

@kaxil kaxil commented Oct 14, 2026 •

Copy link
Copy Markdown
Member

#74679 left durable=True experimental because a tool would soon be able to declare whether its result may be reused, and promised to graduate it once that landed. #74385 merged AirflowDurability, which ships that: a toolset can opt out of replay, as ManagedAgentToolset does by default. So the reason no longer holds.

This moves durable=True on AgentOperator and @task.agent, and AirflowDurability used directly in a plain @task, into the stable table. The promise covers what the code does today. A retry runs the agent from the start and replays each recorded model request and tool call that matches the step at the same point, and every step after the first mismatch runs live. The journal lives in the task state store on Airflow 3.3+ and under [common.ai] durable_cache_path before that. With durable=True, replayed steps count nothing against usage_limits or the usage XCom, the agent's run_id stays the first attempt's, and the journal is deleted when the task succeeds. The experimental notes come off durable_execution.rst, the durable parameter docstring and the two durable mentions on the Why Common AI page.

Combinations that stay unsupported keep their own caveats: SandboxToolset's experimental row still says it cannot be used with durable=True, and per-tool approval still does not work with it. Strands checkpoint resume stays experimental.

AirflowDurability (#74385) let a toolset declare whether its calls may be
replayed, which was the reason durable=True stayed experimental in #74679.
@kaxil
kaxil force-pushed the commonai-durable-stable branch from 871b187 to ca5900f Compare October 14, 2026 08:49
@kaxil
kaxil merged commit 2002ba5 into main Oct 14, 2026
3 checks passed
@kaxil
kaxil deleted the commonai-durable-stable branch October 14, 2026 08:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants