diff --git a/CHANGELOG.md b/CHANGELOG.md index 369c599be..27fb9a8d3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,31 @@ All notable changes to the Copilot SDK are documented in this file. This changelog is automatically generated by an AI agent when stable releases are published. See [GitHub Releases](https://github.com/github/copilot-sdk/releases) for the full list. +## [java/v1.0.1](https://github.com/github/copilot-sdk/releases/tag/java/v1.0.1) (2026-06-10) + +### Feature: `@CopilotExperimental` compile-time gate for experimental APIs + +Experimental SDK APIs are now guarded by the `@CopilotExperimental` annotation. Using them causes a compile error by default; opt in by annotating the consuming class or method with `@AllowCopilotExperimental`, or pass `-Acopilot.experimental.allowed=true` to the Java compiler. ([#1601](https://github.com/github/copilot-sdk/pull/1601)) + +```java +@AllowCopilotExperimental +public class MyHandler { + // may use @CopilotExperimental APIs here +} +``` + +### Feature: open-canvases snapshot on `CopilotSession` + +`CopilotSession.getOpenCanvases()` now returns the live set of canvas instances open for the session, bringing the Java SDK to parity with the other SDK languages. The snapshot is seeded from the session create/resume response and kept current via `session.canvas.opened` and `session.canvas.closed` events. ([#1606](https://github.com/github/copilot-sdk/pull/1606)) + +```java +List open = session.getOpenCanvases(); +``` + +### Other changes + +- improvement: propagate `@Deprecated` and experimental `@apiNote` Javadoc annotations from the schema into generated Java types ([#1591](https://github.com/github/copilot-sdk/pull/1591)) + ## [v0.2.2](https://github.com/github/copilot-sdk/releases/tag/v0.2.2) (2026-04-10) ### Feature: `enableConfigDiscovery` for automatic MCP and skill config loading