Skip to content

Make LoggingToolset private and update Experimental notes in common.ai - #74694

Merged
Lee-W merged 20 commits into
apache:mainfrom
astronomer:common-ai-stability-review
Oct 26, 2026
Merged

Lee-W merged 20 commits into
apache:mainfrom
astronomer:common-ai-stability-review

Conversation

@Lee-W

@Lee-W Lee-W commented Oct 14, 2026 •

Copy link
Copy Markdown
Member

LoggingToolset is no longer exported from airflow.providers.common.ai.toolsets;
tool-call logging stays available through enable_tool_logging and
ToolLoggingCapability. The Experimental notes are removed from the parameters
and classes that graduate to stable, and kept, with the concrete reason, on
datasource_config and data_sources.


Was generative AI tooling used to co-author this PR?
  • Yes (please specify the tool below)

Generated-by: [Claude] following the guidelines


  • Read the 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) is needed.
  • When adding dependency, check compliance with the ASF 3rd Party License Policy.
  • For significant user-facing changes create newsfragment: {pr_number}.significant.rst, in airflow-core/newsfragments. You can add this file in a follow-up commit after the PR is created so you know the PR number.

Comment thread providers/common/ai/docs/stability.rst Resolved
Comment thread providers/common/ai/docs/stability.rst Resolved
Comment thread providers/common/ai/docs/changelog.rst Resolved
Comment thread providers/common/ai/docs/stability.rst Resolved
Comment thread providers/common/ai/docs/stability.rst Resolved
Comment thread providers/common/ai/docs/stability.rst Resolved
Comment thread providers/common/ai/docs/stability.rst Resolved
Comment thread providers/common/ai/docs/changelog.rst Resolved
@Lee-W
Lee-W force-pushed the common-ai-stability-review branch 2 times, most recently from 618e2ef to 103f825 Compare October 15, 2026 07:53
@Lee-W
Lee-W requested a review from kaxil October 15, 2026 07:53
Comment thread providers/common/ai/docs/changelog.rst Resolved
@Lee-W
Lee-W force-pushed the common-ai-stability-review branch 3 times, most recently from 1659d13 to dade363 Compare October 21, 2026 15:00
Comment thread providers/common/ai/docs/stability.rst Resolved
Comment thread providers/common/ai/docs/changelog.rst Resolved
@Lee-W
Lee-W force-pushed the common-ai-stability-review branch from dade363 to dccbafc Compare October 22, 2026 03:40

@kaxil kaxil left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thanks. In operators/llm_sql.rst the new pin note sits ten lines above the existing install note about the same datafusion extra, so the pin could be one sentence in that note instead. Also, the last sentence of the PR description still says the Experimental notes stay on datasource_config and data_sources, which no longer matches the change. Neither needs to hold this up.

@Lee-W
Lee-W force-pushed the common-ai-stability-review branch from dccbafc to c54bca2 Compare October 23, 2026 13:13
@kaxil

kaxil commented Oct 23, 2026

Copy link
Copy Markdown
Member

Conflicts !

@Lee-W
Lee-W force-pushed the common-ai-stability-review branch from c54bca2 to 3d7fecf Compare October 25, 2026 02:00
Lee-W added 20 commits October 26, 2026 15:18
LoggingToolset is no longer exported from airflow.providers.common.ai.toolsets;
tool-call logging stays available through enable_tool_logging and
ToolLoggingCapability. The Experimental notes are removed from the parameters
and classes that graduate to stable, and kept, with the concrete reason, on
datasource_config and data_sources.
Moves managed agent toolsets, per-tool approval, ObjectStorageToolset,
DecisionPolicy, pinned_arguments, llm_sql, llm_file_analysis,
llm_schema_compare and the LangChain hook and bridge to the stable list, and
gives every remaining experimental entry a concrete, checkable reason. Fixes
the stale claim that CI does not run the Strands and ADK adapter tests.
Per-tool approval and min_confidence on a branch option are stable, so their
docstrings no longer call them experimental. The toolset Layering section now
describes ToolLoggingCapability as a capability that wraps the agent's toolset,
the CI notes say Python source or test files to match the selective checks, and
a long note in the llm_schema_compare guide is re-wrapped.
The 1.0.0 note says LoggingToolset left the public API, so the Features
bullet for apache#74449 should not list it as exported.
Outside canary runs the job overrides the CI image's packages and installs
the newest framework release inside the exclude-newer window; canary runs
(scheduled, push, manual and canary-labelled PRs) use each framework's own
dependency pins.
1.0.0 is released and still exports LoggingToolset (apache#74449), so the removal note belongs under the next release. Restore LoggingToolset in the 1.0.0 export entry.
Notes for an unreleased version sit directly under the Changelog header; the release manager adds the version heading when cutting the release.
…usion pin as a dependency limit

1.0.0 shipped both parameters as stable, so the stability policy keeps them stable until the next major release. Drop their rows from the Experimental table and the Experimental notes from the operator docs.
The pin sat in its own note ten lines above the note about the datafusion extra it belongs to.
@Lee-W
Lee-W force-pushed the common-ai-stability-review branch from 3d7fecf to 04579a5 Compare October 26, 2026 06:21
@Lee-W
Lee-W merged commit c3e0046 into apache:main Oct 26, 2026
148 checks passed
@Lee-W
Lee-W deleted the common-ai-stability-review branch October 26, 2026 07:59
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.

2 participants