## Python SDK Changes:

* `glean.client.chat.create()`: 
  *  `request.messages[].fragments[]` **Changed**
  *  `response.messages[].fragments[]` **Changed**
* `glean.client.chat.retrieve()`:  `response.chat_result.chat.messages[].fragments[]` **Changed**
* `glean.client.chat.create_stream()`: 
  *  `request.messages[].fragments[]` **Changed**

Author: speakeasybot

.speakeasy/gen.lock

@@ -34,7 +34,7 @@ generation:
     generateNewTests: true
     skipResponseBodyAssertions: true
 python:
-  version: 0.15.2
+  version: 0.15.3
   additionalDependencies:
     dev: {}
     main: {}

.speakeasy/gen.yaml

@@ -2,8 +2,8 @@ openapi: 3.0.0
 info:
   version: "0.9.0"
   title: Glean API
-  x-source-commit-sha: 1ccc408fdb2c210e136239b5b42a53c7b9b4abe5
-  x-open-api-commit-sha: 1bf9887187c8200b2881b1768fc50ae4fae41796
+  x-source-commit-sha: 270b693d49bac2f68e751b2345bac0c267741119
+  x-open-api-commit-sha: 592aec2b4913505edb8161645eaf9a72b5286f20
   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.
@@ -5533,12 +5533,21 @@ components:
       additionalProperties: false
       required:
         - query
+      example:
+        query: quarterly planning 2026
+        datasources:
+          - confluence
+          - google_drive
+        filters:
+          - field: type
+            values:
+              - spreadsheet
+              - presentation
       properties:
         query:
           type: string
           description: |
             The search query string. Supports inline operators such as `from:jane type:document app:confluence`. Inline operators are AND'd with structured `filters`.
-          example: quarterly planning 2026
         page_size:
           type: integer
           minimum: 1
@@ -5556,18 +5565,12 @@ components:
             type: string
           description: |
             Restrict results to specific datasources. Requests must not specify both `datasources` and `datasource_instances`.
-          example:
-            - confluence
-            - google_drive
         datasource_instances:
           type: array
           items:
             type: string
           description: |
             Restrict results to specific datasource instances. Values are datasource instance identifiers returned by `GET /api/search/filters`. Requests must not specify both `datasources` and `datasource_instances`.
-          example:
-            - slack_acme
-            - slack_eu
         filters:
           type: array
           items:
@@ -9713,6 +9716,127 @@ components:
           additionalProperties:
             $ref: '#/components/schemas/WriteActionParameter'
           description: Parameters supported by the tool.
+    ServerToolBase:
+      type: object
+      properties:
+        requestType:
+          type: string
+          enum:
+            - EXECUTION
+            - AUTHENTICATION_SUGGESTION
+            - VOTE_SUGGESTION
+          description: The type of request made to the user.
+          x-enumDescriptions:
+            EXECUTION: Request for approving execution of the tool.
+            AUTHENTICATION_SUGGESTION: Request for authenticating to a tool, provided as a (tool) suggestion.
+            VOTE_SUGGESTION: Suggestion to vote for enabling an available-but-not-enabled tool.
+          x-speakeasy-enum-descriptions:
+            EXECUTION: Request for approving execution of the tool.
+            AUTHENTICATION_SUGGESTION: Request for authenticating to a tool, provided as a (tool) suggestion.
+            VOTE_SUGGESTION: Suggestion to vote for enabling an available-but-not-enabled tool.
+        requestId:
+          type: string
+          description: Unique identifier for this request.
+      required:
+        - toolType
+        - requestType
+        - requestId
+      x-visibility: Preview
+      x-glean-experimental:
+        id: 4e3ee791-45e0-4125-845f-4b7701aa983c
+        introduced: "2026-07-02"
+    ActionPreview:
+      properties:
+        markdown:
+          type: string
+          description: Markdown preview describing what the action will do.
+        description:
+          type: string
+          description: Short summary of what this specific tool invocation will do.
+      description: Preview information for an action being executed.
+    ServerToolRequest:
+      allOf:
+        - $ref: '#/components/schemas/ServerToolBase'
+        - type: object
+          properties:
+            toolDisplayName:
+              type: string
+              description: Human-readable display name for the tool.
+            serverId:
+              type: string
+              description: |
+                Unique identifier of the tool server. Use with GET /tool-servers/{serverId}/auth
+                to resolve display information and authentication status.
+            toolCta:
+              type: string
+              description: Custom call-to-action (CTA) verb for the approval button (e.g., "Create", "Update", "Send").
+            actionPreview:
+              $ref: '#/components/schemas/ActionPreview'
+              description: Preview information for this tool request.
+          required:
+            - toolName
+      x-visibility: Preview
+      x-glean-experimental:
+        id: 8544e887-4569-4b14-bde0-d1be9e90dbc3
+        introduced: "2026-07-02"
+    AuthContext:
+      type: object
+      properties:
+        serverId:
+          type: string
+          description: ID of the MCP server (populated when toolType is MCP).
+      description: |
+        Context for authentication responses, containing identifiers for the entity being authenticated.
+      x-visibility: Preview
+      x-glean-experimental:
+        id: a7c1d3e5-9f42-4b8a-b6e0-2d4f8a1c3e5b
+        introduced: "2026-07-09"
+    ServerToolResponse:
+      allOf:
+        - $ref: '#/components/schemas/ServerToolBase'
+        - type: object
+          properties:
+            isGranted:
+              type: boolean
+              description: Whether tool request is granted (indicates approval for execution, or completion for auth).
+            grantScope:
+              type: string
+              enum:
+                - CURRENT_REQUEST
+                - CURRENT_SESSION
+                - ALWAYS
+              description: |
+                Scope of the approval grant. Only applicable when isGranted is true and requestType is EXECUTION.
+              default: CURRENT_REQUEST
+              x-enumDescriptions:
+                CURRENT_REQUEST: Approve only the current tool request. Future tool execution requests still require approval.
+                CURRENT_SESSION: Approve the current tool request and auto-approve all future same tool requests in this chat session.
+                ALWAYS: Approve the current tool request and auto-approve all future same tool requests across all chat sessions.
+              x-speakeasy-enum-descriptions:
+                CURRENT_REQUEST: Approve only the current tool request. Future tool execution requests still require approval.
+                CURRENT_SESSION: Approve the current tool request and auto-approve all future same tool requests in this chat session.
+                ALWAYS: Approve the current tool request and auto-approve all future same tool requests across all chat sessions.
+            authContext:
+              $ref: '#/components/schemas/AuthContext'
+              description: Context for AUTHENTICATION_SUGGESTION responses. Required when requestType is AUTHENTICATION_SUGGESTION.
+      description: |
+        Response to a server tool request. The applicable fields depend on requestType:
+
+        For EXECUTION requests:
+        - isGranted: whether tool execution is approved
+        - reason: optional explanation
+
+        For AUTHENTICATION_SUGGESTION requests:
+        - isGranted: whether auth completed successfully (true=connected, false=skipped)
+        - authContext: contains serverId or actionPackId for identifying the authenticated entity
+        - reason: optional explanation for skip
+
+        For VOTE_SUGGESTION requests:
+        - voted: whether the user voted for this tool
+      x-visibility: Preview
+      x-glean-experimental:
+        id: 3eae3ee7-2c06-4027-be14-98260a3ce608
+        introduced: "2026-07-02"
     ChatMessageFragment:
       allOf:
         - $ref: '#/components/schemas/Result'
@@ -9732,6 +9856,12 @@ components:
             citation:
               $ref: '#/components/schemas/ChatMessageCitation'
               description: Inline citation.
+            serverToolRequest:
+              $ref: '#/components/schemas/ServerToolRequest'
+              description: request to run a tool on server.
+            serverToolResponse:
+              $ref: '#/components/schemas/ServerToolResponse'
+              description: response corresponding to the server tool request.
       description: Represents a part of a ChatMessage that originates from a single action/tool. It is designed to support rich data formats beyond simple text, allowing for a more dynamic and interactive chat experience. Each fragment can include various types of content, such as text, search queries, action information, and more. Also, each ChatMessageFragment should only have one of structuredResults, querySuggestion, writeAction, followupAction, agentRecommendation, followupRoutingSuggestion or file.
     ChatMessage:
       properties:

.speakeasy/glean-merged-spec.yaml

@@ -158806,9 +158806,6 @@ workflows:
           requestBody:
             contentType: application/json
             payload:
-                datasource_instances:
-                    - slack_acme
-                    - slack_eu
                 datasources:
                     - confluence
                     - google_drive

.speakeasy/tests.arazzo.yaml

@@ -1,9 +1,9 @@
-speakeasyVersion: 1.789.0
+speakeasyVersion: 1.789.2
 sources:
     Glean API:
         sourceNamespace: glean-api-specs
-        sourceRevisionDigest: sha256:38135f10206267ef24935fe6f997edba535c1d95313a1bfd30066f791e2f692b
-        sourceBlobDigest: sha256:cabd9d3d8eb34d9f7324632354255e5b224c05443dd6f8f27094c47cd4839d01
+        sourceRevisionDigest: sha256:145236c33451e6e87cf1507a4d8829678b0df02af59afc9341330627e33ed760
+        sourceBlobDigest: sha256:862b1370a65d146eac83f86c6fbd2d787f04ea93c2cf28259af5ded934f9fb3b
         tags:
             - latest
     Glean Client API:
@@ -16,10 +16,10 @@ targets:
     glean:
         source: Glean API
         sourceNamespace: glean-api-specs
-        sourceRevisionDigest: sha256:38135f10206267ef24935fe6f997edba535c1d95313a1bfd30066f791e2f692b
-        sourceBlobDigest: sha256:cabd9d3d8eb34d9f7324632354255e5b224c05443dd6f8f27094c47cd4839d01
+        sourceRevisionDigest: sha256:145236c33451e6e87cf1507a4d8829678b0df02af59afc9341330627e33ed760
+        sourceBlobDigest: sha256:862b1370a65d146eac83f86c6fbd2d787f04ea93c2cf28259af5ded934f9fb3b
         codeSamplesNamespace: glean-api-specs-python-code-samples
-        codeSamplesRevisionDigest: sha256:0c2ffb1bbb551c0718176c53dd5fdd322c6c78ec6ab0979f9469cfef459b051e
+        codeSamplesRevisionDigest: sha256:4a0a1ec3489f36483dc6080dacec4d40157b2e8d34be15e06417ddfc2e4f090a
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest

.speakeasy/workflow.lock

@@ -788,4 +788,14 @@ Based on:
 ### Generated
 - [python v0.15.2] .
 ### Releases
-- [PyPI v0.15.2] https://pypi.org/project/glean-api-client/0.15.2 - .
+- [PyPI v0.15.2] https://pypi.org/project/glean-api-client/0.15.2 - .
+
+## 2026-07-10 16:28:47
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.789.2 (2.916.4) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.15.3] .
+### Releases
+- [PyPI v0.15.3] https://pypi.org/project/glean-api-client/0.15.3 - .

RELEASES.md

@@ -0,0 +1,11 @@
+# ActionPreview
+
+Preview information for an action being executed.
+
+
+## Fields
+
+| Field                                                        | Type                                                         | Required                                                     | Description                                                  |
+| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
+| `markdown`                                                   | *Optional[str]*                                              | :heavy_minus_sign:                                           | Markdown preview describing what the action will do.         |
+| `description`                                                | *Optional[str]*                                              | :heavy_minus_sign:                                           | Short summary of what this specific tool invocation will do. |

docs/models/actionpreview.md

@@ -0,0 +1,11 @@
+# AuthContext
+
+Context for authentication responses, containing identifiers for the entity being authenticated.
+
+
+
+## Fields
+
+| Field                                                  | Type                                                   | Required                                               | Description                                            |
+| ------------------------------------------------------ | ------------------------------------------------------ | ------------------------------------------------------ | ------------------------------------------------------ |
+| `server_id`                                            | *Optional[str]*                                        | :heavy_minus_sign:                                     | ID of the MCP server (populated when toolType is MCP). |