feat(client): add close method (#87)

anthropic-java-core/src/main/kotlin/com/anthropic/client/AnthropicClient.kt

@@ -18,4 +18,17 @@ interface AnthropicClient {
     fun models(): ModelService
 
     fun beta(): BetaService
+
+    /**
+     * Closes this client, relinquishing any underlying resources.
+     *
+     * This is purposefully not inherited from [AutoCloseable] because the client is long-lived and
+     * usually should not be synchronously closed via try-with-resources.
+     *
+     * It's also usually not necessary to call this method at all. the default HTTP client
+     * automatically releases threads and connections if they remain idle, but if you are writing an
+     * application that needs to aggressively release unused resources, then you may call this
+     * method.
+     */
+    fun close()
 }

anthropic-java-core/src/main/kotlin/com/anthropic/client/AnthropicClientAsync.kt

@@ -18,4 +18,17 @@ interface AnthropicClientAsync {
     fun models(): ModelServiceAsync
 
     fun beta(): BetaServiceAsync
+
+    /**
+     * Closes this client, relinquishing any underlying resources.
+     *
+     * This is purposefully not inherited from [AutoCloseable] because the client is long-lived and
+     * usually should not be synchronously closed via try-with-resources.
+     *
+     * It's also usually not necessary to call this method at all. the default HTTP client
+     * automatically releases threads and connections if they remain idle, but if you are writing an
+     * application that needs to aggressively release unused resources, then you may call this
+     * method.
+     */
+    fun close()
 }

anthropic-java-core/src/main/kotlin/com/anthropic/client/AnthropicClientAsyncImpl.kt

@@ -52,4 +52,6 @@ constructor(
     override fun models(): ModelServiceAsync = models
 
     override fun beta(): BetaServiceAsync = beta
+
+    override fun close() = clientOptions.httpClient.close()
 }

anthropic-java-core/src/main/kotlin/com/anthropic/client/AnthropicClientImpl.kt

@@ -48,4 +48,6 @@ constructor(
     override fun models(): ModelService = models
 
     override fun beta(): BetaService = beta
+
+    override fun close() = clientOptions.httpClient.close()
 }