Merge pull request #163 from gleanwork/speakeasy-sdk-regen-1787354779

chore: 🐝 Update SDK - Generate 0.16.1

Author: chris-freeman-glean

.speakeasy/gen.lock

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

.speakeasy/gen.yaml

@@ -1,9 +1,9 @@
-openapi: 3.0.0
+openapi: 3.1.0
 info:
   version: "0.9.0"
   title: Glean API
-  x-source-commit-sha: ae20e37cc1d6786192c975f846fbe57527d94d7e
-  x-open-api-commit-sha: 68a8939fe1b80a3a659ea78c778a5ddfdcb8e999
+  x-source-commit-sha: 607c4a4291218dcc0edb79494bf20e6ac3362cf9
+  x-open-api-commit-sha: efc6383f39292ed5941021d5bd19afeca4e04a38
   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.
@@ -2709,7 +2709,15 @@ paths:
                 $ref: '#/components/schemas/ErrorResponse'
         "500":
           description: Internal server error
+      deprecated: true
       x-visibility: Preview
+      x-glean-deprecated:
+        docs: https://developers.glean.com/api/platform-api/agents-overview
+        id: e01a59ea-5de0-481f-97b6-d28dd65379e6
+        introduced: "2026-08-25"
+        message: Use GET /api/agents/{agent_id} instead.
+        removal: "2027-04-15"
+      x-speakeasy-deprecation-message: "Deprecated on 2026-08-25, removal scheduled for 2027-04-15: Use GET /api/agents/{agent_id} instead."
       x-speakeasy-group: client.agents
       x-speakeasy-name-override: retrieve
     post:
@@ -2802,7 +2810,15 @@ paths:
                 $ref: '#/components/schemas/ErrorResponse'
         "500":
           description: Internal server error
+      deprecated: true
       x-visibility: Preview
+      x-glean-deprecated:
+        docs: https://developers.glean.com/api/platform-api/agents-overview
+        id: 9ca398ba-cf22-4523-9d9c-86e5f82d6ec7
+        introduced: "2026-08-25"
+        message: Use GET /api/agents/{agent_id}/schemas instead.
+        removal: "2027-04-15"
+      x-speakeasy-deprecation-message: "Deprecated on 2026-08-25, removal scheduled for 2027-04-15: Use GET /api/agents/{agent_id}/schemas instead."
       x-speakeasy-group: client.agents
       x-speakeasy-name-override: retrieveSchemas
   /rest/api/v1/agents/{agent_id}/import:
@@ -2895,7 +2911,15 @@ paths:
                 $ref: '#/components/schemas/ErrorResponse'
         "500":
           description: Internal server error
+      deprecated: true
       x-visibility: Preview
+      x-glean-deprecated:
+        docs: https://developers.glean.com/api/platform-api/agents-overview
+        id: 3ab6f4c0-0b97-4a0b-b5da-e888e4bb7706
+        introduced: "2026-08-25"
+        message: Use POST /api/agents/search instead.
+        removal: "2027-04-15"
+      x-speakeasy-deprecation-message: "Deprecated on 2026-08-25, removal scheduled for 2027-04-15: Use POST /api/agents/search instead."
       x-speakeasy-group: client.agents
       x-speakeasy-name-override: list
   /rest/api/v1/agents/runs/stream:
@@ -2961,7 +2985,15 @@ paths:
                 $ref: '#/components/schemas/UnauthorizedAgentToolsError'
         "500":
           description: Internal server error
+      deprecated: true
       x-visibility: Preview
+      x-glean-deprecated:
+        docs: https://developers.glean.com/api/platform-api/agents-overview
+        id: db3f42a5-8820-451e-b57a-14bf6ca3915c
+        introduced: "2026-08-25"
+        message: Use POST /api/agents/{agent_id}/runs with stream=true instead.
+        removal: "2027-04-15"
+      x-speakeasy-deprecation-message: "Deprecated on 2026-08-25, removal scheduled for 2027-04-15: Use POST /api/agents/{agent_id}/runs with stream=true instead."
       x-speakeasy-group: client.agents
       x-speakeasy-name-override: runStream
   /rest/api/v1/agents/runs/wait:
@@ -3002,7 +3034,15 @@ paths:
                 $ref: '#/components/schemas/UnauthorizedAgentToolsError'
         "500":
           description: Internal server error
+      deprecated: true
       x-visibility: Preview
+      x-glean-deprecated:
+        docs: https://developers.glean.com/api/platform-api/agents-overview
+        id: 683b90e1-48d3-4d7a-a32d-b48eb194fcf0
+        introduced: "2026-08-25"
+        message: Use POST /api/agents/{agent_id}/runs instead.
+        removal: "2027-04-15"
+      x-speakeasy-deprecation-message: "Deprecated on 2026-08-25, removal scheduled for 2027-04-15: Use POST /api/agents/{agent_id}/runs instead."
       x-speakeasy-group: client.agents
       x-speakeasy-name-override: run
   /rest/api/v1/addcollectionitems:
@@ -6747,6 +6787,8 @@ components:
     PlatformAgentsSearchRequest:
       type: object
       additionalProperties: false
+      example:
+        name: HR Policy Agent
       properties:
         name:
           type: string
@@ -7070,6 +7112,12 @@ components:
       additionalProperties: false
       description: |
         Request to run an agent. A request MUST supply either `messages` (a non-empty conversation) or `input` (for input-form triggered agents).
+      example:
+        messages:
+          - role: USER
+            content:
+              - text: What is our parental leave policy?
+                type: text
       properties:
         input:
           type: object
@@ -7186,6 +7234,8 @@ components:
       additionalProperties: false
       required:
         - input
+      example:
+        input: What is our parental leave policy?
       properties:
         input:
           description: |
@@ -7327,8 +7377,9 @@ components:
           type: string
           minLength: 1
         page_number:
-          type: integer
-          nullable: true
+          type:
+            - integer
+            - "null"
     PlatformChatCitationAnnotation:
       type: object
       additionalProperties: false
@@ -7346,16 +7397,19 @@ components:
           items:
             $ref: "#/components/schemas/PlatformChatCitationSource"
         start_index:
-          type: integer
+          type:
+            - integer
+            - "null"
           minimum: 0
-          nullable: true
         end_index:
-          type: integer
+          type:
+            - integer
+            - "null"
           minimum: 0
-          nullable: true
         snippets:
-          type: array
-          nullable: true
+          type:
+            - array
+            - "null"
           items:
             $ref: "#/components/schemas/PlatformChatCitationSnippet"
     PlatformChatOutputTextContent:
@@ -7432,9 +7486,10 @@ components:
         store:
           type: boolean
         conversation_id:
-          type: string
+          type:
+            - string
+            - "null"
           minLength: 1
-          nullable: true
           description: Present when the interaction was persisted.
         request_id:
           type: string
@@ -7554,8 +7609,9 @@ components:
           type: boolean
           description: Whether additional results are available.
         next_cursor:
-          type: string
-          nullable: true
+          type:
+            - string
+            - "null"
           description: Cursor for the next page, or null when no more results are available.
         request_id:
           type: string
@@ -7586,6 +7642,9 @@ components:
       additionalProperties: false
       required:
         - source_urls
+      example:
+        source_urls:
+          - https://github.com/anthropics/skills/tree/main/skills/skill-creator
       properties:
         source_urls:
           type: array
@@ -7678,6 +7737,8 @@ components:
       additionalProperties: false
       required:
         - source_url
+      example:
+        source_url: https://github.com/anthropics/skills
       properties:
         source_url:
           type: string
@@ -7800,6 +7861,8 @@ components:
       additionalProperties: false
       required:
         - status
+      example:
+        status: ENABLED
       properties:
         status:
           $ref: "#/components/schemas/PlatformSkillUpdateStatus"
@@ -7891,8 +7954,9 @@ components:
           type: boolean
           description: Whether additional results are available.
         next_cursor:
-          type: string
-          nullable: true
+          type:
+            - string
+            - "null"
           description: Cursor for the next page, or null when no more results are available.
         request_id:
           type: string
@@ -8011,11 +8075,11 @@ components:
           default: 10
           description: Number of results to return per page.
         cursor:
-          type: string
-          nullable: true
+          type:
+            - string
+            - "null"
           description: |
             Opaque pagination token from a previous response's `next_cursor` field. Omit on the first request.
-          example: ""
         datasources:
           type: array
           minItems: 1
@@ -8066,8 +8130,9 @@ components:
           description: The datasource this result originates from.
           example: confluence
         document_type:
-          type: string
-          nullable: true
+          type:
+            - string
+            - "null"
           minLength: 1
           description: The document type within the datasource.
           example: page
@@ -8076,14 +8141,16 @@ components:
         owner:
           $ref: "#/components/schemas/PlatformPersonReference"
         updated_at:
-          type: string
+          type:
+            - string
+            - "null"
           format: date-time
-          nullable: true
           description: When the result was last modified.
         created_at:
-          type: string
+          type:
+            - string
+            - "null"
           format: date-time
-          nullable: true
           description: When the result was created.
     PlatformSearchResponse:
       type: object
@@ -8105,8 +8172,9 @@ components:
           type: boolean
           description: Indicates whether additional pages of results are available.
         next_cursor:
-          type: string
-          nullable: true
+          type:
+            - string
+            - "null"
           description: Opaque token to pass as `cursor` in the next request.
         request_id:
           type: string
@@ -8283,8 +8351,9 @@ components:
           type: boolean
           description: Whether additional results are available.
         next_cursor:
-          type: string
-          nullable: true
+          type:
+            - string
+            - "null"
           description: Cursor for the next page, or null when no more results are available.
         request_id:
           type: string
@@ -8644,8 +8713,9 @@ components:
           type: boolean
           description: Whether additional results are available.
         next_cursor:
-          type: string
-          nullable: true
+          type:
+            - string
+            - "null"
           description: Cursor for the next page, or null when no more results are available.
         request_id:
           type: string
@@ -12896,15 +12966,18 @@ components:
             - EXECUTION
             - AUTHENTICATION_SUGGESTION
             - VOTE_SUGGESTION
+            - SANDBOX_EGRESS
           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.
+            SANDBOX_EGRESS: Request to approve an outbound/egress call from the sandbox.
           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.
+            SANDBOX_EGRESS: Request to approve an outbound/egress call from the sandbox.
         requestId:
           type: string
           description: Unique identifier for this request.
@@ -13004,6 +13077,9 @@ components:
 
         For VOTE_SUGGESTION requests:
         - voted: whether the user voted for this tool
+
+        For SANDBOX_EGRESS requests:
+        - isGranted: whether the sandbox egress call is approved
       x-visibility: Preview
       x-glean-experimental:
         id: 3eae3ee7-2c06-4027-be14-98260a3ce608
@@ -13590,7 +13666,7 @@ components:
         isDraft:
           type: boolean
           description: |
-            When true, validates and stores a draft preview without publishing (used for PR preview links). Takes precedence over `syncMode`: when `isDraft` is true, `syncMode` is ignored.
+            Deprecated. Draft mutation semantics are not supported for transient previews. Use transient and parentWorkflowId instead.
       required:
         - bundle
     ImportAgentStatus:
@@ -18075,6 +18151,7 @@ components:
           type: array
           items:
             $ref: '#/components/schemas/DebugDocumentRequest'
+          maxItems: 100
           description: Documents to fetch debug information for
       required:
         - debugDocuments