ci: regenerated with OpenAPI Doc , Speakeasy CLI 1.557.0

Author: speakeasybot

.speakeasy/gen.lock

@@ -25,12 +25,13 @@ generation:
     generateNewTests: true
     skipResponseBodyAssertions: true
 python:
-  version: 0.6.1
+  version: 0.6.2
   additionalDependencies:
     dev: {}
     main: {}
   authors:
     - Speakeasy
+  baseErrorName: GleanBaseError
   clientServerStatusCodesAsErrors: true
   defaultErrorName: GleanError
   description: Python Client SDK Generated by Speakeasy.

.speakeasy/gen.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/glean-merged-spec.yaml

@@ -1,11 +1,12 @@
-speakeasyVersion: 1.555.1
+speakeasyVersion: 1.557.0
 sources:
     Glean API:
         sourceNamespace: glean-api-specs
-        sourceRevisionDigest: sha256:8e2d79c193d7d522db0b1817c101317269b4303fe62398cd206f47b62bf13aa7
-        sourceBlobDigest: sha256:317f3701feac64292f15f9c705d91ebacd1168fc2b2c29548a67f51b77189824
+        sourceRevisionDigest: sha256:927ebf4c072ddb7d9c4a9501c375fb01ecf9f95a3b50fc73205f2c30e5863107
+        sourceBlobDigest: sha256:552c782f3b9cf6ed461abfbed82233620b573fa3c71fcb6d59dc5a02efd43d35
         tags:
             - latest
+            - speakeasy-sdk-regen-1749237128
     Glean Client API:
         sourceNamespace: glean-client-api
         sourceRevisionDigest: sha256:4edc63ad559e4f2c9fb9ebf5edaaaaa9269f1874d271cfd84b441d6dacac43d2
@@ -16,10 +17,10 @@ targets:
     glean:
         source: Glean API
         sourceNamespace: glean-api-specs
-        sourceRevisionDigest: sha256:8e2d79c193d7d522db0b1817c101317269b4303fe62398cd206f47b62bf13aa7
-        sourceBlobDigest: sha256:317f3701feac64292f15f9c705d91ebacd1168fc2b2c29548a67f51b77189824
+        sourceRevisionDigest: sha256:927ebf4c072ddb7d9c4a9501c375fb01ecf9f95a3b50fc73205f2c30e5863107
+        sourceBlobDigest: sha256:552c782f3b9cf6ed461abfbed82233620b573fa3c71fcb6d59dc5a02efd43d35
         codeSamplesNamespace: glean-api-specs-python-code-samples
-        codeSamplesRevisionDigest: sha256:38daa09fcc08430b42c527a3325478333bf123fbc4e178ec364cddbda1582359
+        codeSamplesRevisionDigest: sha256:a4e3d3787a5f493fb7e73dc7f1a9a0826462cd51e6bc313b50e993958fb0bc7f
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest

.speakeasy/workflow.lock

@@ -135,7 +135,7 @@ Generally, the SDK will work well with most IDEs out of the box. However, when u
 
 ```python
 # Synchronous Example
-from glean.api_client import Glean, models
+from glean import Glean, models
 import os
 
 
@@ -163,7 +163,7 @@ The same SDK client can also be used to make asychronous requests by importing a
 ```python
 # Asynchronous Example
 import asyncio
-from glean.api_client import Glean, models
+from glean import Glean, models
 import os
 
 async def main():
@@ -192,7 +192,7 @@ asyncio.run(main())
 
 ```python
 # Synchronous Example
-from glean.api_client import Glean, models
+from glean import Glean, models
 import os
 
 
@@ -220,7 +220,7 @@ The same SDK client can also be used to make asychronous requests by importing a
 ```python
 # Asynchronous Example
 import asyncio
-from glean.api_client import Glean, models
+from glean import Glean, models
 import os
 
 async def main():
@@ -259,8 +259,8 @@ This SDK supports the following security scheme globally:
 
 To authenticate with the API the `api_token` parameter must be set when initializing the SDK client instance. For example:
 ```python
-from glean.api_client import Glean, models
-from glean.api_client.utils import parse_datetime
+from glean import Glean, models
+from glean.utils import parse_datetime
 import os
 
 
@@ -343,11 +343,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
-* [retrieve_schemas](docs/sdks/agents/README.md#retrieve_schemas) - Get Agent Schemas
-* [list](docs/sdks/agents/README.md#list) - Search Agents
-* [run_stream](docs/sdks/agents/README.md#run_stream) - 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
+* [retrieve_schemas](docs/sdks/agents/README.md#retrieve_schemas) - List an agent's schemas
+* [list](docs/sdks/agents/README.md#list) - Search agents
+* [run_stream](docs/sdks/agents/README.md#run_stream) - 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)
 
@@ -541,8 +541,8 @@ Some of the endpoints in this SDK support retries. If you use the SDK without an
 
 To change the default retry strategy for a single API call, simply provide a `RetryConfig` object to the call:
 ```python
-from glean.api_client import Glean, models
-from glean.api_client.utils import BackoffStrategy, RetryConfig, parse_datetime
+from glean import Glean, models
+from glean.utils import BackoffStrategy, RetryConfig, parse_datetime
 import os
 
 
@@ -582,8 +582,8 @@ with Glean(
 
 If you'd like to override the default retry strategy for all operations that support retries, you can use the `retry_config` optional parameter when initializing the SDK:
 ```python
-from glean.api_client import Glean, models
-from glean.api_client.utils import BackoffStrategy, RetryConfig, parse_datetime
+from glean import Glean, models
+from glean.utils import BackoffStrategy, RetryConfig, parse_datetime
 import os
 
 
@@ -720,8 +720,8 @@ The default server `https://{instance}-be.glean.com` contains variables and is s
 #### Example
 
 ```python
-from glean.api_client import Glean, models
-from glean.api_client.utils import parse_datetime
+from glean import Glean, models
+from glean.utils import parse_datetime
 import os
 
 
@@ -763,8 +763,8 @@ with Glean(
 
 The default server can be overridden globally by passing a URL to the `server_url: str` optional parameter when initializing the SDK client instance. For example:
 ```python
-from glean.api_client import Glean, models
-from glean.api_client.utils import parse_datetime
+from glean import Glean, models
+from glean.utils import parse_datetime
 import os
 
 
@@ -812,7 +812,7 @@ This allows you to wrap the client with your own custom logic, such as adding cu
 
 For example, you could specify a header for every request that this sdk makes as follows:
 ```python
-from glean.api_client import Glean
+from glean import Glean
 import httpx
 
 http_client = httpx.Client(headers={"x-custom-header": "someValue"})
@@ -821,8 +821,8 @@ s = Glean(client=http_client)
 
 or you could wrap the client with your own custom logic:
 ```python
-from glean.api_client import Glean
-from glean.api_client.httpclient import AsyncHttpClient
+from glean import Glean
+from glean.httpclient import AsyncHttpClient
 import httpx
 
 class CustomClient(AsyncHttpClient):
@@ -892,7 +892,7 @@ The `Glean` class implements the context manager protocol and registers a finali
 [context-manager]: https://docs.python.org/3/reference/datamodel.html#context-managers
 
 ```python
-from glean.api_client import Glean
+from glean import Glean
 import os
 def main():
 
@@ -919,7 +919,7 @@ You can setup your SDK to emit debug logs for SDK requests and responses.
 
 You can pass your own logger class directly into your SDK.
 ```python
-from glean.api_client import Glean
+from glean import Glean
 import logging
 
 logging.basicConfig(level=logging.DEBUG)

README.md

@@ -118,4 +118,14 @@ Based on:
 ### Generated
 - [python v0.6.1] .
 ### Releases
-- [PyPI v0.6.1] https://pypi.org/project/glean/0.6.1 - .
+- [PyPI v0.6.1] https://pypi.org/project/glean/0.6.1 - .
+
+## 2025-06-06 19:11:45
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.557.0 (2.623.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.6.2] .
+### Releases
+- [PyPI v0.6.2] https://pypi.org/project/glean/0.6.2 - .

RELEASES.md

@@ -1,7 +1,7 @@
 <!-- Start SDK Example Usage [usage] -->
 ```python
 # Synchronous Example
-from glean.api_client import Glean, models
+from glean import Glean, models
 import os
 
 
@@ -29,7 +29,7 @@ The same SDK client can also be used to make asychronous requests by importing a
 ```python
 # Asynchronous Example
 import asyncio
-from glean.api_client import Glean, models
+from glean import Glean, models
 import os
 
 async def main():
@@ -56,7 +56,7 @@ asyncio.run(main())
 
 ```python
 # Synchronous Example
-from glean.api_client import Glean, models
+from glean import Glean, models
 import os
 
 
@@ -84,7 +84,7 @@ The same SDK client can also be used to make asychronous requests by importing a
 ```python
 # Asynchronous Example
 import asyncio
-from glean.api_client import Glean, models
+from glean import Glean, models
 import os
 
 async def main():