gleanwork
diff --git a/‎.speakeasy/gen.lock
Lines changed: 319 additions & 48 deletions b/‎.speakeasy/gen.lock
Lines changed: 319 additions & 48 deletions
diff --git a/‎.speakeasy/gen.yaml
Lines changed: 3 additions & 2 deletions b/‎.speakeasy/gen.yaml
Lines changed: 3 additions & 2 deletions
diff --git a/‎.speakeasy/glean-merged-spec.yaml
Lines changed: 33 additions & 5 deletions b/‎.speakeasy/glean-merged-spec.yaml
Lines changed: 33 additions & 5 deletions
diff --git a/‎.speakeasy/workflow.lock
Lines changed: 7 additions & 7 deletions b/‎.speakeasy/workflow.lock
Lines changed: 7 additions & 7 deletions
diff --git a/‎README.md
Lines changed: 127 additions & 4 deletions b/‎README.md
Lines changed: 127 additions & 4 deletions
diff --git a/‎RELEASES.md
Lines changed: 11 additions & 1 deletion b/‎RELEASES.md
Lines changed: 11 additions & 1 deletion
@@ -21,18 +21,19 @@ generation:
     generateNewTests: false
     skipResponseBodyAssertions: false
 java:
-  version: 0.8.0
+  version: 0.9.0
   additionalDependencies: []
   additionalPlugins: []
   artifactID: glean-api-client
+  asyncMode: enabled
   baseErrorName: GleanError
   clientServerStatusCodesAsErrors: true
   companyEmail: [email protected]
   companyName: Glean
   companyURL: https://www.glean.com
   defaultErrorName: APIException
-  enableAsync: false
   enableCustomCodeRegions: false
+  enableStreamingUploads: false
   envVarPrefix: GLEAN
   flattenGlobalSecurity: true
   githubURL: github.com/gleanwork/api-client-java
 
@@ -3774,6 +3774,7 @@ components:
                 email:
                     type: string
                     description: The email address of the user who submitted the Feedback.event.MANUAL_FEEDBACK event.
+                    deprecated: true
                 source:
                     type: string
                     description: The source associated with the Feedback.event.MANUAL_FEEDBACK event.
@@ -4366,7 +4367,7 @@ components:
                     description: Disables automatic adjustment of the input query for spelling corrections or other reasons.
                 returnLlmContentOverSnippets:
                     type: boolean
-                    description: "[beta] Enables expanded content to be returned for LLM usage. The size of content per result returned should be modified using maxSnippetSize. Server may return less or more than what is specified in maxSnippetSize. For more details, https://docs.google.com/document/d/1CTOLSxWWT9WDEnHVLoCUaxbGYyXYP8kctPRF-RluSQY/edit. Requires sufficient permissions."
+                    description: Enables expanded content to be returned for LLM usage. The size of content per result returned should be modified using maxSnippetSize. Server may return less or more than what is specified in maxSnippetSize. For more details, see https://developers.glean.com/guides/search/llm-content.
                 inclusions:
                     $ref: "#/components/schemas/RestrictionFilters"
                     description: A list of filters which restrict the search results to only the specified content.
@@ -4864,6 +4865,9 @@ components:
                 name:
                     type: string
                     description: Name of the group.
+                datasourceInstance:
+                    type: string
+                    description: Datasource instance if the group belongs to one e.g. external groups.
         UserRole:
             type: string
             description: A user's role with respect to a specific document.
@@ -5841,9 +5845,6 @@ components:
             required:
                 - snippet
             properties:
-                snippet:
-                    type: string
-                    description: A matching snippet from the document. Query term matches are marked by the unicode characters uE006 and uE007.
                 mimeType:
                     type: string
                     description: The mime type of the snippets, currently either text/plain or text/html.
@@ -5861,6 +5862,10 @@ components:
                 url:
                     type: string
                     description: A URL, generated based on availability, that links to the position of the snippet text or to the nearest header above the snippet text.
+                snippet:
+                    type: string
+                    deprecated: true
+                    description: A matching snippet from the document. Query term matches are marked by the unicode characters uE006 and uE007. Use 'text' field instead.
             example:
                 snippet: snippet
                 mimeType: mimeType
@@ -5954,6 +5959,8 @@ components:
                 - THREAD_ROOT
                 - PREFIX
                 - SUFFIX
+                - AUTHOR_PREFIX
+                - AUTHOR_SUFFIX
         ClusterGroup:
             required:
                 - visibleCountHint
@@ -7306,7 +7313,7 @@ components:
                     $ref: "#/components/schemas/AgentConfig"
                     description: Describes the agent config that generated this message. Populated on responses and not required on requests.
                 author:
-                    default: GLEAN_AI
+                    default: USER
                     enum:
                         - USER
                         - GLEAN_AI
@@ -7482,12 +7489,18 @@ components:
             description: A historical representation of a series of chat messages a user had with Glean Assistant.
             allOf:
                 - $ref: "#/components/schemas/ChatMetadata"
+                - $ref: "#/components/schemas/PermissionedObject"
             properties:
                 messages:
                     type: array
                     items:
                         $ref: "#/components/schemas/ChatMessage"
                     description: The chat messages within a Chat.
+                roles:
+                    type: array
+                    items:
+                        $ref: "#/components/schemas/UserRoleSpecification"
+                    description: A list of roles for this Chat.
         ChatResult:
             properties:
                 chat:
@@ -9145,6 +9158,7 @@ components:
                             - ZERO_STATE_WORKFLOW_FAVORITES
                             - ZERO_STATE_WORKFLOW_POPULAR
                             - ZERO_STATE_WORKFLOW_SUGGESTION
+                            - PERSONALIZED_CHAT_SUGGESTION
                     description: Categories of content requested. An allowlist gives flexibility to request content separately or together.
                 requestOptions:
                     $ref: "#/components/schemas/FeedRequestOptions"
@@ -9300,6 +9314,14 @@ components:
                         type: array
                         items:
                             $ref: "#/components/schemas/GeneratedAttachment"
+        ChatSuggestion:
+            properties:
+                query:
+                    type: string
+                    description: The actionable chat query to run when the user selects this suggestion.
+                feature:
+                    type: string
+                    description: Targeted Glean Chat feature for the suggestion.
         PromptTemplateMutableProperties:
             required:
                 - template
@@ -9513,6 +9535,7 @@ components:
                         - ZERO_STATE_PROMPT_TEMPLATE_SUGGESTION
                         - ZERO_STATE_STATIC_WORKFLOW_SUGGESTION
                         - ZERO_STATE_AGENT_SUGGESTION
+                        - PERSONALIZED_CHAT_SUGGESTION
                     description: Type of the justification.
                 justification:
                     type: string
@@ -9537,6 +9560,8 @@ components:
                     $ref: "#/components/schemas/Person"
                 app:
                     $ref: "#/components/schemas/AppResult"
+                chatSuggestion:
+                    $ref: "#/components/schemas/ChatSuggestion"
                 promptTemplate:
                     $ref: "#/components/schemas/PromptTemplateResult"
                 workflow:
@@ -9578,6 +9603,7 @@ components:
                         - ZERO_STATE_WORKFLOW_FAVORITES
                         - ZERO_STATE_WORKFLOW_POPULAR
                         - ZERO_STATE_WORKFLOW_SUGGESTION
+                        - PERSONALIZED_CHAT_SUGGESTION
                     description: Category of the result, one of the requested categories in incoming request.
                 primaryEntry:
                     $ref: "#/components/schemas/FeedEntry"
@@ -11575,6 +11601,7 @@ components:
                         - EXTERNAL_SHORTCUT
                         - ENTITY
                         - CALENDAR
+                        - AGENTS
                     description: The document category of this object type.
                 propertyDefinitions:
                     type: array
@@ -11629,6 +11656,7 @@ components:
                         - EXTERNAL_SHORTCUT
                         - ENTITY
                         - CALENDAR
+                        - AGENTS
                     default: UNCATEGORIZED
                     description: The type of this datasource. It is an important signal for relevance and must be specified and cannot be UNCATEGORIZED. Please refer to [this](https://developers.glean.com/docs/indexing_api_datasource_category/) for more details.
                 urlRegex:
 
@@ -1,12 +1,12 @@
-speakeasyVersion: 1.603.0
+speakeasyVersion: 1.609.0
 sources:
     Glean API:
         sourceNamespace: glean-api-specs
-        sourceRevisionDigest: sha256:8f18d79a0a7d8f51de7edd5bc8ca3ccc569b81832ffc44ce95a27a12e67b9b7d
-        sourceBlobDigest: sha256:bb3e5a453f03cbdecf3fb3925768ef4cb0b3119083d9d36c341e1ecd721cde8b
+        sourceRevisionDigest: sha256:1d65c7ec86c2282d859444620e38022be13cffabe2ddc114882663760b81e128
+        sourceBlobDigest: sha256:c47ee96b91dc6e9704fb7bfbd1bad3ed46aa3d350c599840c831129f35fe8f84
         tags:
             - latest
-            - speakeasy-sdk-regen-1752597383
+            - speakeasy-sdk-regen-1755200997
     Glean-OAS:
         sourceNamespace: glean-oas
         sourceRevisionDigest: sha256:8841834dd58ddd4e2dcf98fc90fbd06fbf3626a29df941503cce55b9548a5317
@@ -18,10 +18,10 @@ targets:
     glean:
         source: Glean API
         sourceNamespace: glean-api-specs
-        sourceRevisionDigest: sha256:8f18d79a0a7d8f51de7edd5bc8ca3ccc569b81832ffc44ce95a27a12e67b9b7d
-        sourceBlobDigest: sha256:bb3e5a453f03cbdecf3fb3925768ef4cb0b3119083d9d36c341e1ecd721cde8b
+        sourceRevisionDigest: sha256:1d65c7ec86c2282d859444620e38022be13cffabe2ddc114882663760b81e128
+        sourceBlobDigest: sha256:c47ee96b91dc6e9704fb7bfbd1bad3ed46aa3d350c599840c831129f35fe8f84
         codeSamplesNamespace: glean-api-specs-java-code-samples
-        codeSamplesRevisionDigest: sha256:e2f179bd27ebe8ef2e5db4899dbce44b41be5a1a46f7d62f7df45af109b6df27
+        codeSamplesRevisionDigest: sha256:276f3a59565b0ade33ae1975fdc364b3be2bd131a351c2a11bec0c2172862272
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest
 
@@ -41,6 +41,7 @@ Remember that each namespace requires its own authentication token type as descr
   * [Unified SDK Architecture](#unified-sdk-architecture)
   * [SDK Installation](#sdk-installation)
   * [SDK Example Usage](#sdk-example-usage)
+  * [Asynchronous Support](#asynchronous-support)
   * [Authentication](#authentication)
   * [Available Resources and Operations](#available-resources-and-operations)
   * [Error Handling](#error-handling)
@@ -63,15 +64,15 @@ The samples below show how a published SDK artifact is used:
 
 Gradle:
 ```groovy
-implementation 'com.glean.api-client:glean-api-client:0.8.0'
+implementation 'com.glean.api-client:glean-api-client:0.9.0'
 ```
 
 Maven:
 ```xml
 <dependency>
     <groupId>com.glean.api-client</groupId>
     <artifactId>glean-api-client</artifactId>
-    <version>0.8.0</version>
+    <version>0.9.0</version>
 </dependency>
 ```
 
@@ -116,7 +117,6 @@ public class Application {
                 .chatRequest(ChatRequest.builder()
                     .messages(List.of(
                         ChatMessage.builder()
-                            .author(Author.USER)
                             .fragments(List.of(
                                 ChatMessageFragment.builder()
                                     .text("What are the company holidays this year?")
@@ -155,7 +155,6 @@ public class Application {
                 .chatRequest(ChatRequest.builder()
                     .messages(List.of(
                         ChatMessage.builder()
-                            .author(Author.USER)
                             .fragments(List.of(
                                 ChatMessageFragment.builder()
                                     .text("What are the company holidays this year?")
@@ -170,8 +169,132 @@ public class Application {
     }
 }
 ```
+#### Asynchronous Call
+An asynchronous SDK client is also available that returns a [`CompletableFuture<T>`][comp-fut]. See [Asynchronous Support](#asynchronous-support) for more details on async benefits and reactive library integration.
+```java
+package hello.world;
+
+import com.glean.api_client.glean_api_client.AsyncGlean;
+import com.glean.api_client.glean_api_client.Glean;
+import com.glean.api_client.glean_api_client.models.components.*;
+import com.glean.api_client.glean_api_client.models.operations.async.ActivityResponse;
+import java.time.OffsetDateTime;
+import java.util.List;
+import java.util.concurrent.CompletableFuture;
+
+public class Application {
+
+    public static void main(String[] args) {
+
+        AsyncGlean sdk = Glean.builder()
+                .apiToken(System.getenv().getOrDefault("GLEAN_API_TOKEN", ""))
+            .build()
+            .async();
+
+        Activity req = Activity.builder()
+                .events(List.of(
+                    ActivityEvent.builder()
+                        .action(ActivityEventAction.HISTORICAL_VIEW)
+                        .timestamp(OffsetDateTime.parse("2000-01-23T04:56:07.000Z"))
+                        .url("https://example.com/")
+                        .build(),
+                    ActivityEvent.builder()
+                        .action(ActivityEventAction.SEARCH)
+                        .timestamp(OffsetDateTime.parse("2000-01-23T04:56:07.000Z"))
+                        .url("https://example.com/search?q=query")
+                        .params(ActivityEventParams.builder()
+                            .query("query")
+                            .build())
+                        .build(),
+                    ActivityEvent.builder()
+                        .action(ActivityEventAction.VIEW)
+                        .timestamp(OffsetDateTime.parse("2000-01-23T04:56:07.000Z"))
+                        .url("https://example.com/")
+                        .params(ActivityEventParams.builder()
+                            .duration(20L)
+                            .referrer("https://example.com/document")
+                            .build())
+                        .build()))
+                .build();
+
+        CompletableFuture<ActivityResponse> resFut = sdk.client().activity().report()
+                .request(req)
+                .call();
+
+        // handle response
+    }
+}
+```
+
+[comp-fut]: https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/CompletableFuture.html
 <!-- End SDK Example Usage [usage] -->
 
+<!-- Start Asynchronous Support [async-support] -->
+## Asynchronous Support
+
+The SDK provides comprehensive asynchronous support using Java's [`CompletableFuture<T>`][comp-fut] and [Reactive Streams `Publisher<T>`][reactive-streams] APIs. This design makes no assumptions about your choice of reactive toolkit, allowing seamless integration with any reactive library.
+
+<details>
+<summary>Why Use Async?</summary>
+
+Asynchronous operations provide several key benefits:
+
+- **Non-blocking I/O**: Your threads stay free for other work while operations are in flight
+- **Better resource utilization**: Handle more concurrent operations with fewer threads
+- **Improved scalability**: Build highly responsive applications that can handle thousands of concurrent requests
+- **Reactive integration**: Works seamlessly with reactive streams and backpressure handling
+
+</details>
+
+<details>
+<summary>Reactive Library Integration</summary>
+
+The SDK returns [Reactive Streams `Publisher<T>`][reactive-streams] instances for operations dealing with streams involving multiple I/O interactions. We use Reactive Streams instead of JDK Flow API to provide broader compatibility with the reactive ecosystem, as most reactive libraries natively support Reactive Streams.
+
+**Why Reactive Streams over JDK Flow?**
+- **Broader ecosystem compatibility**: Most reactive libraries (Project Reactor, RxJava, Akka Streams, etc.) natively support Reactive Streams
+- **Industry standard**: Reactive Streams is the de facto standard for reactive programming in Java
+- **Better interoperability**: Seamless integration without additional adapters for most use cases
+
+**Integration with Popular Libraries:**
+- **Project Reactor**: Use `Flux.from(publisher)` to convert to Reactor types
+- **RxJava**: Use `Flowable.fromPublisher(publisher)` for RxJava integration
+- **Akka Streams**: Use `Source.fromPublisher(publisher)` for Akka Streams integration
+- **Vert.x**: Use `ReadStream.fromPublisher(vertx, publisher)` for Vert.x reactive streams
+- **Mutiny**: Use `Multi.createFrom().publisher(publisher)` for Quarkus Mutiny integration
+
+**For JDK Flow API Integration:**
+If you need JDK Flow API compatibility (e.g., for Quarkus/Mutiny 2), you can use adapters:
+```java
+// Convert Reactive Streams Publisher to Flow Publisher
+Flow.Publisher<T> flowPublisher = FlowAdapters.toFlowPublisher(reactiveStreamsPublisher);
+
+// Convert Flow Publisher to Reactive Streams Publisher
+Publisher<T> reactiveStreamsPublisher = FlowAdapters.toPublisher(flowPublisher);
+```
+
+For standard single-response operations, the SDK returns `CompletableFuture<T>` for straightforward async execution.
+
+</details>
+
+<details>
+<summary>Supported Operations</summary>
+
+Async support is available for:
+
+- **[Server-sent Events](#server-sent-event-streaming)**: Stream real-time events with Reactive Streams `Publisher<T>`
+- **[JSONL Streaming](#jsonl-streaming)**: Process streaming JSON lines asynchronously
+- **[Pagination](#pagination)**: Iterate through paginated results using `callAsPublisher()` and `callAsPublisherUnwrapped()`
+- **[File Uploads](#file-uploads)**: Upload files asynchronously with progress tracking
+- **[File Downloads](#file-downloads)**: Download files asynchronously with streaming support
+- **[Standard Operations](#example)**: All regular API calls return `CompletableFuture<T>` for async execution
+
+</details>
+
+[comp-fut]: https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/CompletableFuture.html
+[reactive-streams]: https://www.reactive-streams.org/
+<!-- End Asynchronous Support [async-support] -->
+
 <!-- Start Authentication [security] -->
 ## Authentication
 
 
@@ -188,4 +188,14 @@ Based on:
 ### Generated
 - [java v0.8.0] .
 ### Releases
-- [Maven Central v0.8.0] https://central.sonatype.com/artifact/com.glean.api-client/glean-api-client/0.8.0 - .
+- [Maven Central v0.8.0] https://central.sonatype.com/artifact/com.glean.api-client/glean-api-client/0.8.0 - .
+
+## 2025-09-05 00:45:36
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.609.0 (2.692.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [java v0.9.0] .
+### Releases
+- [Maven Central v0.9.0] https://central.sonatype.com/artifact/com.glean.api-client/glean-api-client/0.9.0 - .