Merge pull request #21 from gleanwork/speakeasy-sdk-regen-1749237143

chore: 🐝 Update SDK - Generate 0.5.2

Author: rwjblue-glean

.speakeasy/gen.lock

@@ -1,20 +1,20 @@
 lockVersion: 2.0.0
 id: 0359d4fe-2923-46fc-aaca-cf70b48dcfa1
 management:
-  docChecksum: 2c7958d4387029e26995250cfa9844b1
+  docChecksum: a0748babeea2c91be038da9e477a97f3
   docVersion: 0.9.0
-  speakeasyVersion: 1.555.3
-  generationVersion: 2.620.2
-  releaseVersion: 0.5.1
-  configChecksum: ea3568caa832103b95578e36daa71ce8
+  speakeasyVersion: 1.557.0
+  generationVersion: 2.623.0
+  releaseVersion: 0.5.2
+  configChecksum: 5e138df16879e9b012d699506c95c899
   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.37.3
+    core: 3.37.4
     deprecations: 2.81.1
     examples: 2.81.5
     flattening: 2.81.1
@@ -1773,7 +1773,7 @@ examples:
         query: {}
       responses:
         "200":
-          application/json: {"agent_id": "<id>", "name": "<value>", "capabilities": {}}
+          application/json: {"agent_id": "mho4lwzylcozgoc2", "name": "HR Policy Agent", "description": "This agent answers questions about the current company HR policies.", "capabilities": {}}
   getAgentSchemas:
     speakeasy-default-get-agent-schemas:
       parameters:
@@ -1782,14 +1782,14 @@ examples:
         query: {}
       responses:
         "200":
-          application/json: {"agent_id": "<id>", "input_schema": {}, "output_schema": {}}
+          application/json: {"agent_id": "mho4lwzylcozgoc2", "input_schema": {}, "output_schema": {}}
   searchAgents:
     speakeasy-default-search-agents:
       requestBody:
-        application/json: {}
+        application/json: {"name": "HR Policy Agent"}
       responses:
         "200":
-          application/json: {}
+          application/json: {"agents": [{"agent_id": "mho4lwzylcozgoc2", "name": "HR Policy Agent", "description": "This agent answers questions about the current company HR policies.", "capabilities": {}}]}
   createAndStreamRun:
     speakeasy-default-create-and-stream-run:
       requestBody:

.speakeasy/gen.yaml

@@ -17,10 +17,11 @@ generation:
     oAuth2ClientCredentialsEnabled: true
     oAuth2PasswordEnabled: true
 java:
-  version: 0.5.1
+  version: 0.5.2
   additionalDependencies: []
   additionalPlugins: []
   artifactID: glean-api-client
+  baseErrorName: GleanError
   clientServerStatusCodesAsErrors: true
   companyEmail: support@glean.com
   companyName: Glean

.speakeasy/glean-merged-spec.yaml

@@ -756,8 +756,8 @@ paths:
         get:
             tags:
                 - Agents
-            summary: Get Agent
-            description: Get an agent by ID. This endpoint implements the LangChain Agent Protocol, specifically part of the Agents stage (https://langchain-ai.github.io/agent-protocol/api.html#tag/agents/GET/agents/{agent_id}). It adheres to the standard contract defined for agent interoperability and can be used by agent runtimes that support the Agent Protocol.
+            summary: Retrieve an agent
+            description: Returns details of an [agent](https://developers.glean.com/agents/agents-api) created in the Agent Builder.
             operationId: getAgent
             x-visibility: Preview
             parameters:
@@ -795,8 +795,8 @@ paths:
         get:
             tags:
                 - Agents
-            summary: Get Agent Schemas
-            description: Get an agent's schemas by ID. This endpoint implements the LangChain Agent Protocol, specifically part of the Agents stage (https://langchain-ai.github.io/agent-protocol/api.html#tag/agents/GET/agents/{agent_id}/schemas). It adheres to the standard contract defined for agent interoperability and can be used by agent runtimes that support the Agent Protocol.
+            summary: List an agent's schemas
+            description: Return [agent](https://developers.glean.com/agents/agents-api)'s input and output schemas. You can use these schemas to detect changes to an agent's input or output structure.
             operationId: getAgentSchemas
             x-visibility: Preview
             parameters:
@@ -840,8 +840,8 @@ paths:
         post:
             tags:
                 - Agents
-            summary: Search Agents
-            description: List Agents available in this service. This endpoint implements the LangChain Agent Protocol, specifically part of the Agents stage (https://langchain-ai.github.io/agent-protocol/api.html#tag/agents/POST/agents/search). It adheres to the standard contract defined for agent interoperability and can be used by agent runtimes that support the Agent Protocol.
+            summary: Search agents
+            description: "Search for [agents](https://developers.glean.com/agents/agents-api) by agent name. "
             operationId: searchAgents
             x-visibility: Preview
             requestBody:
@@ -881,8 +881,8 @@ paths:
         post:
             tags:
                 - Agents
-            summary: Create Run, Stream Output
-            description: Creates and triggers a run of an agent. Streams the output in SSE format. This endpoint implements the LangChain Agent Protocol, specifically part of the Runs stage (https://langchain-ai.github.io/agent-protocol/api.html#tag/runs/POST/runs/stream). It adheres to the standard contract defined for agent interoperability and can be used by agent runtimes that support the Agent Protocol. Note that running agents that reference third party platform write actions is unsupported as it requires user confirmation.
+            summary: Create an agent run and stream the response
+            description: Executes an [agent](https://developers.glean.com/agents/agents-api) run and returns the result as a stream of server-sent events (SSE).
             operationId: createAndStreamRun
             x-visibility: Preview
             requestBody:
@@ -898,12 +898,23 @@ paths:
                         text/event-stream:
                             schema:
                                 type: string
-                                description: |-
-                                    The server will send a stream of events in SSE format.
-                                    **Example event**:
+                                description: The server will send a stream of events in server-sent events (SSE) format.
+                                example: |
                                     id: 1
                                     event: message
-                                    data: {}
+                                    data: {"messages":[{"role":"GLEAN_AI","content":[{"text":"Hello","type":"text"}]}]}
+
+                                    id: 2
+                                    event: message
+                                    data: {"messages":[{"role":"GLEAN_AI","content":[{"text":",","type":"text"}]}]}
+
+                                    id: 3
+                                    event: message
+                                    data: {"messages":[{"role":"GLEAN_AI","content":[{"text":" I'm","type":"text"}]}]}
+
+                                    id: 4
+                                    event: message
+                                    data: {"messages":[{"role":"GLEAN_AI","content":[{"text":" your","type":"text"}]}]}
                 "400":
                     description: Bad request
                 "403":
@@ -934,8 +945,8 @@ paths:
         post:
             tags:
                 - Agents
-            summary: Create Run, Wait for Output
-            description: Creates and triggers a run of an agent. Waits for final output and then returns it. This endpoint implements the LangChain Agent Protocol, specifically part of the Runs stage (https://langchain-ai.github.io/agent-protocol/api.html#tag/runs/POST/runs/wait). It adheres to the standard contract defined for agent interoperability and can be used by agent runtimes that support the Agent Protocol. Note that running agents that reference third party platform write actions is unsupported as it requires user confirmation.
+            summary: Create an [agent](https://developers.glean.com/agents/agents-api) run and wait for the response
+            description: Executes an agent run and returns the final response.
             operationId: createAndWaitRun
             x-visibility: Preview
             requestBody:
@@ -7417,31 +7428,38 @@ components:
                     type: string
                     title: Agent Id
                     description: The ID of the agent.
+                    example: mho4lwzylcozgoc2
                 name:
                     type: string
                     title: Agent Name
                     description: The name of the agent
+                    example: HR Policy Agent
                 description:
                     type: string
                     title: Description
                     description: The description of the agent.
+                    example: This agent answers questions about the current company HR policies.
                 metadata:
                     type: object
                     title: Metadata
-                    description: The agent metadata.
+                    description: The agent metadata. Currently not implemented.
                 capabilities:
                     type: object
                     title: Agent Capabilities
-                    description: Describes which protocol features the agent supports. In addition to the standard capabilities (prefixed with ap.), implementations can declare custom capabilities, named in reverse domain notation (eg. com.example.some.capability).
+                    description: |-
+                        Describes features that the agent supports. example: {
+                          "ap.io.messages": true,
+                          "ap.io.streaming": true
+                        }
                     properties:
                         ap.io.messages:
                             type: boolean
                             title: Messages
-                            description: Whether the agent supports Messages as input/output/state. If true, the agent uses the `messages` key in threads/runs endpoints.
+                            description: Whether the agent supports messages as an input. If true, you'll pass `messages` as an input when running the agent.
                         ap.io.streaming:
                             type: boolean
                             title: Streaming
-                            description: Whether the agent supports streaming output.
+                            description: Whether the agent supports streaming output. If true, you you can stream agent ouput. All agents currently support streaming.
                     additionalProperties: true
         ErrorResponse:
             type: string
@@ -7453,14 +7471,15 @@ components:
                     type: string
                     title: Agent Id
                     description: The ID of the agent.
+                    example: mho4lwzylcozgoc2
                 input_schema:
                     type: object
                     title: Input Schema
-                    description: The schema for the agent input. In JSON Schema format.
+                    description: The schema for the agent input. In JSON schema format.
                 output_schema:
                     type: object
                     title: Output Schema
-                    description: The schema for the agent output. In JSON Schema format.
+                    description: The schema for the agent output. In JSON schema format.
             type: object
             required:
                 - agent_id
@@ -7473,7 +7492,8 @@ components:
             properties:
                 name:
                     type: string
-                    description: Filters on the name of the agent. If empty, acts as no filter.
+                    description: Filters on the name of the agent. The keyword search is case-insensitive. If search string is ommited or empty, acts as no filter.
+                    example: HR Policy Agent
         SearchAgentsResponse:
             type: object
             title: Response Search Agents

.speakeasy/workflow.lock

@@ -1,12 +1,12 @@
-speakeasyVersion: 1.555.3
+speakeasyVersion: 1.557.0
 sources:
     Glean API:
         sourceNamespace: glean-api-specs
-        sourceRevisionDigest: sha256:31f82ab8b1f1831ad2f8bae58f4e1a7fb0d760de701c43ca0868c9fc0c2dea42
-        sourceBlobDigest: sha256:317f3701feac64292f15f9c705d91ebacd1168fc2b2c29548a67f51b77189824
+        sourceRevisionDigest: sha256:927ebf4c072ddb7d9c4a9501c375fb01ecf9f95a3b50fc73205f2c30e5863107
+        sourceBlobDigest: sha256:552c782f3b9cf6ed461abfbed82233620b573fa3c71fcb6d59dc5a02efd43d35
         tags:
             - latest
-            - speakeasy-sdk-regen-1749088970
+            - speakeasy-sdk-regen-1749237143
     Glean-OAS:
         sourceNamespace: glean-oas
         sourceRevisionDigest: sha256:8841834dd58ddd4e2dcf98fc90fbd06fbf3626a29df941503cce55b9548a5317
@@ -18,10 +18,10 @@ targets:
     glean:
         source: Glean API
         sourceNamespace: glean-api-specs
-        sourceRevisionDigest: sha256:31f82ab8b1f1831ad2f8bae58f4e1a7fb0d760de701c43ca0868c9fc0c2dea42
-        sourceBlobDigest: sha256:317f3701feac64292f15f9c705d91ebacd1168fc2b2c29548a67f51b77189824
+        sourceRevisionDigest: sha256:927ebf4c072ddb7d9c4a9501c375fb01ecf9f95a3b50fc73205f2c30e5863107
+        sourceBlobDigest: sha256:552c782f3b9cf6ed461abfbed82233620b573fa3c71fcb6d59dc5a02efd43d35
         codeSamplesNamespace: glean-api-specs-java-code-samples
-        codeSamplesRevisionDigest: sha256:21636f866ad31e6a517d5f9e84ce43576ac0853ff4528a5c13701ca53f305bba
+        codeSamplesRevisionDigest: sha256:c9f715798008c16113c896595f00c3261f5547514bef4a27e3cc0e8929608700
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest

README.md

@@ -62,15 +62,15 @@ The samples below show how a published SDK artifact is used:
 
 Gradle:
 ```groovy
-implementation 'com.glean.api-client:glean-api-client:0.5.1'
+implementation 'com.glean.api-client:glean-api-client:0.5.2'
 ```
 
 Maven:
 ```xml
 <dependency>
     <groupId>com.glean.api-client</groupId>
     <artifactId>glean-api-client</artifactId>
-    <version>0.5.1</version>
+    <version>0.5.2</version>
 </dependency>
 ```
 
@@ -303,11 +303,11 @@ For more information on obtaining the appropriate token type, please contact you
 
 #### [client().agents()](docs/sdks/agents/README.md)
 
-* [retrieve](docs/sdks/agents/README.md#retrieve) - Get Agent
-* [retrieveSchemas](docs/sdks/agents/README.md#retrieveschemas) - Get Agent Schemas
-* [list](docs/sdks/agents/README.md#list) - Search Agents
-* [runStream](docs/sdks/agents/README.md#runstream) - Create Run, Stream Output
-* [run](docs/sdks/agents/README.md#run) - Create Run, Wait for Output
+* [retrieve](docs/sdks/agents/README.md#retrieve) - Retrieve an agent
+* [retrieveSchemas](docs/sdks/agents/README.md#retrieveschemas) - List an agent's schemas
+* [list](docs/sdks/agents/README.md#list) - Search agents
+* [runStream](docs/sdks/agents/README.md#runstream) - Create an agent run and stream the response
+* [run](docs/sdks/agents/README.md#run) - Create an [agent](https://developers.glean.com/agents/agents-api) run and wait for the response
 
 #### [client().announcements()](docs/sdks/announcements/README.md)
 

RELEASES.md

@@ -108,4 +108,14 @@ Based on:
 ### Generated
 - [java v0.5.1] .
 ### Releases
-- [Maven Central v0.5.1] https://central.sonatype.com/artifact/com.glean.api-client/glean-api-client/0.5.1 - .
+- [Maven Central v0.5.1] https://central.sonatype.com/artifact/com.glean.api-client/glean-api-client/0.5.1 - .
+
+## 2025-06-06 19:12:03
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.557.0 (2.623.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [java v0.5.2] .
+### Releases
+- [Maven Central v0.5.2] https://central.sonatype.com/artifact/com.glean.api-client/glean-api-client/0.5.2 - .

build.gradle

@@ -103,7 +103,7 @@ publishing {
             // https://github.com/gradle/gradle/issues/18619
             groupId = "com.glean.api-client"
             artifactId = "glean-api-client"
-            version = "0.5.1"
+            version = "0.5.2"
 
             from components.java