Skip to content

Missing Documentation for Removal of CallAroundAdvisor and StreamAroundAdvisor in v1.0.0-RC1 #3426

Open
@manilireb

Description

@manilireb

Description:

The documentation and upgrade notes for Spring AI do not mention that the CallAroundAdvisor and StreamAroundAdvisor interfaces have been deleted in the transition from v1.0.0-M8 to v1.0.0-RC1 [Commit]. This is a critical breaking change that affects users who rely on these advisors for intercepting and enhancing AI interactions.

Details:

  • The [Upgrade Notes] and release blog posts detail several breaking changes and deprecations, but do not explicitly mention the removal of CallAroundAdvisor and StreamAroundAdvisor[(https://docs.spring.io/spring-ai/reference/upgrade-notes.html)][(https://spring.io/blog/2025/04/30/spring-ai-1-0-0-m8-released)].
  • The [Advisors API documentation] describes the introduction of these interfaces in earlier milestones, but there is no clear guidance or migration path for their removal in RC1[(https://docs.spring.io/spring-ai/reference/api/advisors.html)].
  • The [GitHub issue #2861]confirms that all deprecated code was removed in RC1, but does not list these specific interfaces[(https://github.com/EPIC - Removing deprecated code #2861)].

Impact:

Developers upgrading from M8 to RC1 may encounter compilation errors or runtime issues due to the missing advisor interfaces, with no documentation to guide them on alternatives or migration strategies.

Request:

  • Please update the upgrade notes and reference documentation to explicitly mention the removal of CallAroundAdvisor and StreamAroundAdvisor in RC1.
  • Provide guidance or recommended alternatives for users who previously implemented these advisors.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions