kaxil opened a new pull request, #73896: URL: https://github.com/apache/airflow/pull/73896
Before common.ai reaches 1.0, someone building a production Dag needs to know which features keep their behaviour across minor releases. This adds a **Stable and experimental features** page. It lists each stable feature with what stays the same about it, and names every experimental feature with the reason it is experimental. The guarantees start at 1.0.0. Experimental features follow Airflow's experimental feature policy: they can change or be removed in a minor release, and the changelog says so. The pages of experimental features, and their main classes and functions, carry a note that links to the page. Parameters of stable operators that take an experimental value are marked one by one: `durable`, `code_mode` and the per-tool approval parameters on `AgentOperator`, and `decision_policy` on `LLMOperator` and `LLMBranchOperator`. **Stability covers behaviour, not wording.** Log lines, error messages, tool descriptions and the prompt text sent to a model can change in any release, and so can the Pydantic AI class the toolsets inherit from. Freezing those would block routine fixes without protecting anyone's Dag. **The line is drawn at the parameter where a stable operator takes an experimental type.** `LLMBranchOperator` turns every plain-string branch description into a `BranchOption`, so the descriptions stay stable while `BranchOption.min_confidence` and `decision_policy` are experimental. This is the bottom of a stack for the native agent framework work. Each PR above it adds its own row to this page. --- * Read the **[Pull Request Guidelines](https://github.com/apache/airflow/blob/main/contributing-docs/05_pull_requests.rst#pull-request-guidelines)** for more information. Note: commit author/co-author name and email in commits become permanently public when merged. * For fundamental code changes, an Airflow Improvement Proposal ([AIP](https://cwiki.apache.org/confluence/display/AIRFLOW/Airflow+Improvement+Proposals)) is needed. * When adding dependency, check compliance with the [ASF 3rd Party License Policy](https://www.apache.org/legal/resolved.html#category-x). * For significant user-facing changes create newsfragment: `{pr_number}.significant.rst`, in [airflow-core/newsfragments](https://github.com/apache/airflow/tree/main/airflow-core/newsfragments). You can add this file in a follow-up commit after the PR is created so you know the PR number. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
