docs: add some missing javadocs (#38)

anthropic-java-core/src/main/kotlin/com/anthropic/models/BetaMessageBatchCreateParams.kt

@@ -1309,6 +1309,13 @@ constructor(
                     )
             }
 
+            /**
+             * System prompt.
+             *
+             * A system prompt is a way of providing context and instructions to Claude, such as
+             * specifying a particular goal or role. See our
+             * [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+             */
             @JsonDeserialize(using = System.Deserializer::class)
             @JsonSerialize(using = System.Serializer::class)
             class System

anthropic-java-core/src/main/kotlin/com/anthropic/models/BetaMessageBatchResult.kt

@@ -18,6 +18,12 @@ import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
+/**
+ * Processing result for this request.
+ *
+ * Contains a Message output if processing was successful, an error response if processing failed,
+ * or the reason why processing was not attempted, such as cancellation or expiration.
+ */
 @JsonDeserialize(using = BetaMessageBatchResult.Deserializer::class)
 @JsonSerialize(using = BetaMessageBatchResult.Serializer::class)
 class BetaMessageBatchResult

anthropic-java-core/src/main/kotlin/com/anthropic/models/BetaMessageCountTokensParams.kt

@@ -1522,6 +1522,13 @@ constructor(
             )
     }
 
+    /**
+     * System prompt.
+     *
+     * A system prompt is a way of providing context and instructions to Claude, such as specifying
+     * a particular goal or role. See our
+     * [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+     */
     @JsonDeserialize(using = System.Deserializer::class)
     @JsonSerialize(using = System.Serializer::class)
     class System

anthropic-java-core/src/main/kotlin/com/anthropic/models/BetaMessageCreateParams.kt

@@ -1816,6 +1816,13 @@ constructor(
             )
     }
 
+    /**
+     * System prompt.
+     *
+     * A system prompt is a way of providing context and instructions to Claude, such as specifying
+     * a particular goal or role. See our
+     * [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+     */
     @JsonDeserialize(using = System.Deserializer::class)
     @JsonSerialize(using = System.Serializer::class)
     class System

anthropic-java-core/src/main/kotlin/com/anthropic/models/BetaToolChoice.kt

@@ -18,6 +18,10 @@ import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
+/**
+ * How the model should use the provided tools. The model can use a specific tool, any available
+ * tool, or decide by itself.
+ */
 @JsonDeserialize(using = BetaToolChoice.Deserializer::class)
 @JsonSerialize(using = BetaToolChoice.Serializer::class)
 class BetaToolChoice
@@ -43,11 +47,12 @@ private constructor(
 
     fun isBetaToolChoiceTool(): Boolean = betaToolChoiceTool != null
 
+    /** The model will automatically decide whether to use tools. */
     fun asBetaToolChoiceAuto(): BetaToolChoiceAuto =
         betaToolChoiceAuto.getOrThrow("betaToolChoiceAuto")
-
+    /** The model will use any available tools. */
     fun asBetaToolChoiceAny(): BetaToolChoiceAny = betaToolChoiceAny.getOrThrow("betaToolChoiceAny")
-
+    /** The model will use the specified tool with `tool_choice.name`. */
     fun asBetaToolChoiceTool(): BetaToolChoiceTool =
         betaToolChoiceTool.getOrThrow("betaToolChoiceTool")
 
@@ -99,14 +104,17 @@ private constructor(
 
     companion object {
 
+        /** The model will automatically decide whether to use tools. */
         @JvmStatic
         fun ofBetaToolChoiceAuto(betaToolChoiceAuto: BetaToolChoiceAuto) =
             BetaToolChoice(betaToolChoiceAuto = betaToolChoiceAuto)
 
+        /** The model will use any available tools. */
         @JvmStatic
         fun ofBetaToolChoiceAny(betaToolChoiceAny: BetaToolChoiceAny) =
             BetaToolChoice(betaToolChoiceAny = betaToolChoiceAny)
 
+        /** The model will use the specified tool with `tool_choice.name`. */
         @JvmStatic
         fun ofBetaToolChoiceTool(betaToolChoiceTool: BetaToolChoiceTool) =
             BetaToolChoice(betaToolChoiceTool = betaToolChoiceTool)

anthropic-java-core/src/main/kotlin/com/anthropic/models/MessageBatchCreateParams.kt

@@ -1285,6 +1285,13 @@ constructor(
                     )
             }
 
+            /**
+             * System prompt.
+             *
+             * A system prompt is a way of providing context and instructions to Claude, such as
+             * specifying a particular goal or role. See our
+             * [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+             */
             @JsonDeserialize(using = System.Deserializer::class)
             @JsonSerialize(using = System.Serializer::class)
             class System

anthropic-java-core/src/main/kotlin/com/anthropic/models/MessageBatchResult.kt

@@ -18,6 +18,12 @@ import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
+/**
+ * Processing result for this request.
+ *
+ * Contains a Message output if processing was successful, an error response if processing failed,
+ * or the reason why processing was not attempted, such as cancellation or expiration.
+ */
 @JsonDeserialize(using = MessageBatchResult.Deserializer::class)
 @JsonSerialize(using = MessageBatchResult.Serializer::class)
 class MessageBatchResult

anthropic-java-core/src/main/kotlin/com/anthropic/models/MessageCountTokensParams.kt

@@ -1494,6 +1494,13 @@ constructor(
             )
     }
 
+    /**
+     * System prompt.
+     *
+     * A system prompt is a way of providing context and instructions to Claude, such as specifying
+     * a particular goal or role. See our
+     * [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+     */
     @JsonDeserialize(using = System.Deserializer::class)
     @JsonSerialize(using = System.Serializer::class)
     class System

anthropic-java-core/src/main/kotlin/com/anthropic/models/MessageCreateParams.kt

@@ -1787,6 +1787,13 @@ constructor(
             )
     }
 
+    /**
+     * System prompt.
+     *
+     * A system prompt is a way of providing context and instructions to Claude, such as specifying
+     * a particular goal or role. See our
+     * [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+     */
     @JsonDeserialize(using = System.Deserializer::class)
     @JsonSerialize(using = System.Serializer::class)
     class System

anthropic-java-core/src/main/kotlin/com/anthropic/models/ToolChoice.kt

@@ -18,6 +18,10 @@ import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
+/**
+ * How the model should use the provided tools. The model can use a specific tool, any available
+ * tool, or decide by itself.
+ */
 @JsonDeserialize(using = ToolChoice.Deserializer::class)
 @JsonSerialize(using = ToolChoice.Serializer::class)
 class ToolChoice
@@ -43,10 +47,11 @@ private constructor(
 
     fun isToolChoiceTool(): Boolean = toolChoiceTool != null
 
+    /** The model will automatically decide whether to use tools. */
     fun asToolChoiceAuto(): ToolChoiceAuto = toolChoiceAuto.getOrThrow("toolChoiceAuto")
-
+    /** The model will use any available tools. */
     fun asToolChoiceAny(): ToolChoiceAny = toolChoiceAny.getOrThrow("toolChoiceAny")
-
+    /** The model will use the specified tool with `tool_choice.name`. */
     fun asToolChoiceTool(): ToolChoiceTool = toolChoiceTool.getOrThrow("toolChoiceTool")
 
     fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
@@ -93,14 +98,17 @@ private constructor(
 
     companion object {
 
+        /** The model will automatically decide whether to use tools. */
         @JvmStatic
         fun ofToolChoiceAuto(toolChoiceAuto: ToolChoiceAuto) =
             ToolChoice(toolChoiceAuto = toolChoiceAuto)
 
+        /** The model will use any available tools. */
         @JvmStatic
         fun ofToolChoiceAny(toolChoiceAny: ToolChoiceAny) =
             ToolChoice(toolChoiceAny = toolChoiceAny)
 
+        /** The model will use the specified tool with `tool_choice.name`. */
         @JvmStatic
         fun ofToolChoiceTool(toolChoiceTool: ToolChoiceTool) =
             ToolChoice(toolChoiceTool = toolChoiceTool)