Merge pull request #54 from gleanwork/speakeasy-sdk-regen-1763754358

chore: 🐝 Update SDK - Generate 0.12.6

Author: chris-freeman-glean

.speakeasy/gen.lock

@@ -1,20 +1,20 @@
 lockVersion: 2.0.0
 id: 0359d4fe-2923-46fc-aaca-cf70b48dcfa1
 management:
-  docChecksum: 3e5657019a4816420ae24bbe0aa55deb
+  docChecksum: 41ef1db10b9ee826f7c797f827bf843b
   docVersion: 0.9.0
-  speakeasyVersion: 1.659.0
-  generationVersion: 2.755.9
-  releaseVersion: 0.12.5
-  configChecksum: e8a09cf1b489e694a4b1e3d39c5baf5a
+  speakeasyVersion: 1.660.0
+  generationVersion: 2.760.2
+  releaseVersion: 0.12.6
+  configChecksum: 1e696eaf665ff4cedc7707af622795d5
   repoURL: https://github.com/gleanwork/api-client-java.git
   published: true
 features:
   java:
     additionalDependencies: 0.1.0
     additionalProperties: 0.0.1
     constsAndDefaults: 0.1.1
-    core: 3.55.2
+    core: 3.55.3
     deprecations: 2.81.1
     examples: 2.81.6
     flattening: 2.81.1
@@ -2035,6 +2035,7 @@ generatedFiles:
   - src/main/java/com/glean/api_client/glean_api_client/utils/SerializedBody.java
   - src/main/java/com/glean/api_client/glean_api_client/utils/SessionManager.java
   - src/main/java/com/glean/api_client/glean_api_client/utils/SpeakeasyHTTPClient.java
+  - src/main/java/com/glean/api_client/glean_api_client/utils/SpeakeasyLogger.java
   - src/main/java/com/glean/api_client/glean_api_client/utils/SpeakeasyMetadata.java
   - src/main/java/com/glean/api_client/glean_api_client/utils/StreamingParser.java
   - src/main/java/com/glean/api_client/glean_api_client/utils/TypedObject.java
@@ -2897,6 +2898,3 @@ generatedTests:
   get_/rest/api/v1/tools/list: "2025-06-09T18:03:44Z"
   post_/rest/api/v1/tools/call: "2025-06-09T18:03:44Z"
   listpolicies: "2025-06-09T18:03:44Z"
-releaseNotes: |
-  ## Java SDK Changes Detected:
-  * `glean.client.insights.retrieve()`:  `response` **Changed** **Breaking** :warning:

.speakeasy/gen.yaml

@@ -25,7 +25,7 @@ generation:
     generateNewTests: false
     skipResponseBodyAssertions: false
 java:
-  version: 0.12.5
+  version: 0.12.6
   additionalDependencies: []
   additionalPlugins: []
   artifactID: glean-api-client
@@ -37,8 +37,8 @@ java:
   companyURL: https://www.glean.com
   defaultErrorName: APIException
   enableCustomCodeRegions: false
+  enableSlf4jLogging: false
   enableStreamingUploads: false
-  enhancedUnionMemberResolution: true
   envVarPrefix: GLEAN
   flattenGlobalSecurity: true
   generateOptionalUnionAccessors: false
@@ -62,6 +62,8 @@ java:
   maxMethodParams: 4
   nullFriendlyParameters: false
   openUnions: true
+  operationScopedParams: true
   outputModelSuffix: output
   projectName: glean-api-client
   templateVersion: v2
+  unionStrategy: populated-fields

.speakeasy/glean-merged-spec.yaml

@@ -2,7 +2,7 @@ openapi: 3.0.0
 info:
     version: 0.9.0
     title: Glean API
-    x-source-commit-sha: 31b1e4d8c27047c952fd0380361790a2edfdd676
+    x-source-commit-sha: 1425f20d12ba174f1027dd4c1a2025ea90c478d0
     description: |
         # Introduction
         In addition to the data sources that Glean has built-in support for, Glean also provides a REST API that enables customers to put arbitrary content in the search index. This is useful, for example, for doing permissions-aware search over content in internal tools that reside on-prem as well as for searching over applications that Glean does not currently support first class. In addition these APIs allow the customer to push organization data (people info, organization structure etc) into Glean.
@@ -22,7 +22,7 @@ info:
         These API clients provide type-safe, idiomatic interfaces for working with Glean IndexingAPIs in your language of choice.
     x-logo:
         url: https://app.glean.com/images/glean-text2.svg
-    x-open-api-commit-sha: e4416ec5a5adef38fa93d4fef0557174d402e553
+    x-open-api-commit-sha: d64fddf87afc72563e898e93cb865ec43bb84b9d
     x-speakeasy-name: 'Glean API'
 servers:
     - url: https://{instance}-be.glean.com

.speakeasy/workflow.lock

@@ -1,12 +1,12 @@
-speakeasyVersion: 1.659.0
+speakeasyVersion: 1.660.0
 sources:
     Glean API:
         sourceNamespace: glean-api-specs
-        sourceRevisionDigest: sha256:f069447b3ec0cb20ea0970c07b80ca54a16c3dc5b22628309ef86c46822715bd
-        sourceBlobDigest: sha256:88f92162774c14a5edef7dbbd63efbd68f6e3cf857f9f312a2c98342392829b2
+        sourceRevisionDigest: sha256:1374b687db05b30dae84e389939d51405ba11a62e9244bae3bcde62e240d59ca
+        sourceBlobDigest: sha256:393d42e2c8a875f5cc4225467a90d4b39a4d7db0440d4a50a592fe3f50ff809f
         tags:
             - latest
-            - speakeasy-sdk-regen-1763415086
+            - speakeasy-sdk-regen-1763754358
     Glean-OAS:
         sourceNamespace: glean-oas
         sourceRevisionDigest: sha256:8841834dd58ddd4e2dcf98fc90fbd06fbf3626a29df941503cce55b9548a5317
@@ -18,10 +18,10 @@ targets:
     glean:
         source: Glean API
         sourceNamespace: glean-api-specs
-        sourceRevisionDigest: sha256:f069447b3ec0cb20ea0970c07b80ca54a16c3dc5b22628309ef86c46822715bd
-        sourceBlobDigest: sha256:88f92162774c14a5edef7dbbd63efbd68f6e3cf857f9f312a2c98342392829b2
+        sourceRevisionDigest: sha256:1374b687db05b30dae84e389939d51405ba11a62e9244bae3bcde62e240d59ca
+        sourceBlobDigest: sha256:393d42e2c8a875f5cc4225467a90d4b39a4d7db0440d4a50a592fe3f50ff809f
         codeSamplesNamespace: glean-api-specs-java-code-samples
-        codeSamplesRevisionDigest: sha256:8954db613022b52590245e69522e57d6fc8f9548a899ba0bfb9abbbd88cbbf09
+        codeSamplesRevisionDigest: sha256:ab5557e4e7bc8f0b5e37d493be75162ea642153bc0454820a37953274cafb187
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest

README.md

@@ -65,15 +65,15 @@ The samples below show how a published SDK artifact is used:
 
 Gradle:
 ```groovy
-implementation 'com.glean.api-client:glean-api-client:0.12.5'
+implementation 'com.glean.api-client:glean-api-client:0.12.6'
 ```
 
 Maven:
 ```xml
 <dependency>
     <groupId>com.glean.api-client</groupId>
     <artifactId>glean-api-client</artifactId>
-    <version>0.12.5</version>
+    <version>0.12.6</version>
 </dependency>
 ```
 
@@ -1561,9 +1561,11 @@ public class Application {
 ## Debugging
 
 ### Debug
+
 You can setup your SDK to emit debug logs for SDK requests and responses.
 
 For request and response logging (especially json bodies), call `enableHTTPDebugLogging(boolean)` on the SDK builder like so:
+
 ```java
 SDK.builder()
     .enableHTTPDebugLogging(true)
@@ -1581,10 +1583,11 @@ Response body:
   "token": "global"
 }
 ```
-__WARNING__: This should only used for temporary debugging purposes. Leaving this option on in a production system could expose credentials/secrets in logs. <i>Authorization</i> headers are redacted by default and there is the ability to specify redacted header names via `SpeakeasyHTTPClient.setRedactedHeaders`.
+__WARNING__: This logging should only be used for temporary debugging purposes. Leaving this option on in a production system could expose credentials/secrets in logs. <i>Authorization</i> headers are redacted by default and there is the ability to specify redacted header names via `SpeakeasyHTTPClient.setRedactedHeaders`.
 
 __NOTE__: This is a convenience method that calls `HTTPClient.enableDebugLogging()`. The `SpeakeasyHTTPClient` honors this setting. If you are using a custom HTTP client, it is up to the custom client to honor this setting.
 
+
 Another option is to set the System property `-Djdk.httpclient.HttpClient.log=all`. However, this second option does not log bodies.
 <!-- End Debugging [debug] -->
 

RELEASES.md

@@ -398,4 +398,14 @@ Based on:
 ### Generated
 - [java v0.12.5] .
 ### Releases
-- [Maven Central v0.12.5] https://central.sonatype.com/artifact/com.glean.api-client/glean-api-client/0.12.5 - .
+- [Maven Central v0.12.5] https://central.sonatype.com/artifact/com.glean.api-client/glean-api-client/0.12.5 - .
+
+## 2025-11-21 19:45:30
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.660.0 (2.760.2) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [java v0.12.6] .
+### Releases
+- [Maven Central v0.12.6] https://central.sonatype.com/artifact/com.glean.api-client/glean-api-client/0.12.6 - .

gradle.properties

@@ -1,4 +1,4 @@
 groupId=com.glean.api-client
 artifactId=glean-api-client
-version=0.12.5
+version=0.12.6
 org.gradle.jvmargs=-Xmx4g -XX:MaxMetaspaceSize=1g

spring/glean-api-client-spring-boot-autoconfigure/src/main/java/com/glean/api_client/glean_api_client/GleanApiClientAutoConfig.java

@@ -72,7 +72,6 @@ public RetryConfig retryConfig(GleanApiClientAutoConfigProperties properties) {
         // Default retry config for other strategies
         return RetryConfig.builder().build();
     }
-
     /**
      * Creates a {@code Consumer<String>} bean for HTTP debug logging if none exists.
      * This logger is used by the SpeakeasyHTTPClient for debug output when debug logging is enabled.
@@ -85,7 +84,6 @@ public RetryConfig retryConfig(GleanApiClientAutoConfigProperties properties) {
     public Consumer<String> httpLogger() {
         return System.out::println;
     }
-
     /**
      * Creates an HTTPClient bean if none exists.
      *

src/main/java/com/glean/api_client/glean_api_client/SDKConfiguration.java

@@ -24,8 +24,8 @@ public class SDKConfiguration {
 
     private static final String LANGUAGE = "java";
     public static final String OPENAPI_DOC_VERSION = "0.9.0";
-    public static final String SDK_VERSION = "0.12.5";
-    public static final String GEN_VERSION = "2.755.9";
+    public static final String SDK_VERSION = "0.12.6";
+    public static final String GEN_VERSION = "2.760.2";
     private static final String BASE_PACKAGE = "com.glean.api_client.glean_api_client";
     public static final String USER_AGENT = 
             String.format("speakeasy-sdk/%s %s %s %s %s",

src/main/java/com/glean/api_client/glean_api_client/utils/AsyncHooks.java

@@ -34,6 +34,8 @@
 // ThreadSafe
 public class AsyncHooks implements BeforeRequest, AfterSuccess, AfterError {
 
+    private static final SpeakeasyLogger logger = SpeakeasyLogger.getLogger(AsyncHooks.class);
+
     // we use CopyOnWriteArrayList for thread safety
     private final List<BeforeRequest> beforeRequestHooks = new CopyOnWriteArrayList<>();
     private final List<AfterSuccess> afterSuccessHooks = new CopyOnWriteArrayList<>();
@@ -51,6 +53,7 @@ public AsyncHooks() {
     public AsyncHooks registerBeforeRequest(BeforeRequest beforeRequest) {
         Utils.checkNotNull(beforeRequest, "beforeRequest");
         this.beforeRequestHooks.add(beforeRequest);
+        logger.debug("Registered async BeforeRequest hook: {} (total: {})", beforeRequest.getClass().getSimpleName(), beforeRequestHooks.size());
         return this;
     }
 
@@ -63,6 +66,7 @@ public AsyncHooks registerBeforeRequest(BeforeRequest beforeRequest) {
     public AsyncHooks registerAfterSuccess(AfterSuccess afterSuccess) {
         Utils.checkNotNull(afterSuccess, "afterSuccess");
         this.afterSuccessHooks.add(afterSuccess);
+        logger.debug("Registered async AfterSuccess hook: {} (total: {})", afterSuccess.getClass().getSimpleName(), afterSuccessHooks.size());
         return this;
     }
 
@@ -75,6 +79,7 @@ public AsyncHooks registerAfterSuccess(AfterSuccess afterSuccess) {
     public AsyncHooks registerAfterError(AfterError afterError) {
         Utils.checkNotNull(afterError, "afterError");
         this.afterErrorHooks.add(afterError);
+        logger.debug("Registered async AfterError hook: {} (total: {})", afterError.getClass().getSimpleName(), afterErrorHooks.size());
         return this;
     }
 
@@ -83,6 +88,10 @@ public CompletableFuture<HttpRequest> beforeRequest(BeforeRequestContext context
         Utils.checkNotNull(context, "context");
         Utils.checkNotNull(request, "request");
 
+        if (logger.isTraceEnabled() && !beforeRequestHooks.isEmpty()) {
+            logger.trace("Executing {} async beforeRequest hook(s) for operation: {}", beforeRequestHooks.size(), context.operationId());
+        }
+
         CompletableFuture<HttpRequest> result = CompletableFuture.completedFuture(request);
 
         for (BeforeRequest hook : beforeRequestHooks) {
@@ -99,6 +108,10 @@ public CompletableFuture<HttpResponse<Blob>> afterSuccess(
         Utils.checkNotNull(context, "context");
         Utils.checkNotNull(response, "response");
 
+        if (logger.isTraceEnabled() && !afterSuccessHooks.isEmpty()) {
+            logger.trace("Executing {} async afterSuccess hook(s) for operation: {}", afterSuccessHooks.size(), context.operationId());
+        }
+
         CompletableFuture<HttpResponse<Blob>> result = CompletableFuture.completedFuture(response);
 
         for (AfterSuccess hook : afterSuccessHooks) {
@@ -127,6 +140,10 @@ public CompletableFuture<HttpResponse<Blob>> afterError(
                 (response != null) ^ (error != null),
                 "one and only one of response or error must be present");
 
+        if (logger.isTraceEnabled() && !afterErrorHooks.isEmpty()) {
+            logger.trace("Executing {} async afterError hook(s) for operation: {}", afterErrorHooks.size(), context.operationId());
+        }
+
         CompletableFuture<HttpResponse<Blob>> result;
         if (response != null) {
             result = CompletableFuture.completedFuture(response);
@@ -147,6 +164,7 @@ public CompletableFuture<HttpResponse<Blob>> afterError(
                                             failedEarly.set(true);
                                             throw (FailEarlyException) hookErr;
                                         }
+                                        logger.debug("Async hook threw exception: {}", hookErr.getClass().getSimpleName());
                                         throw  Exceptions.unchecked(hookErr);
                                     }
                                     if (hookResp == null) {