On branch edburns/1682-java-tool-ergonomics-review-draft-01

modified:   java/src/main/java/com/github/copilot/tool/CopilotToolProcessor.java
modified:   java/src/main/java/com/github/copilot/tool/Param.java
modified:   java/src/main/java/com/github/copilot/tool/SchemaGenerator.java

- Add `CopilotExperimental` more liberally

Author: edburns

java/src/main/java/com/github/copilot/tool/CopilotToolProcessor.java

@@ -29,6 +29,8 @@
 import javax.tools.Diagnostic;
 import javax.tools.JavaFileObject;
 
+import com.github.copilot.CopilotExperimental;
+
 /**
  * JSR 269 annotation processor that finds {@link CopilotTool}-annotated methods
  * and generates {@code $$CopilotToolMeta} companion classes containing tool
@@ -43,6 +45,7 @@
  */
 @SupportedAnnotationTypes("com.github.copilot.tool.CopilotTool")
 @SupportedSourceVersion(SourceVersion.RELEASE_17)
+@CopilotExperimental
 public class CopilotToolProcessor extends AbstractProcessor {
 
     private final SchemaGenerator schemaGenerator = new SchemaGenerator();

java/src/main/java/com/github/copilot/tool/Param.java

@@ -10,6 +10,8 @@
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
 
+import com.github.copilot.CopilotExperimental;
+
 /**
  * Annotates a parameter of a {@link CopilotTool}-annotated method to provide
  * metadata about the parameter that is sent to the model.
@@ -30,6 +32,7 @@
 @Documented
 @Retention(RetentionPolicy.RUNTIME)
 @Target(ElementType.PARAMETER)
+@CopilotExperimental
 public @interface Param {
 
     /** Parameter description (sent to the model). */

java/src/main/java/com/github/copilot/tool/SchemaGenerator.java

@@ -20,6 +20,8 @@
 import javax.lang.model.util.Elements;
 import javax.lang.model.util.Types;
 
+import com.github.copilot.CopilotExperimental;
+
 /**
  * Compile-time utility that maps {@code javax.lang.model} types to JSON Schema
  * represented as Java source code literals ({@code Map.of(...)} expressions).
@@ -31,6 +33,7 @@
  *
  * @since 1.0.2
  */
+@CopilotExperimental
 public class SchemaGenerator {
 
     /**