Update code samples

Author: github-actions[bot]

.speakeasy/workflow.lock

@@ -1,4 +1,4 @@
-speakeasyVersion: 1.631.5
+speakeasyVersion: 1.625.0
 sources:
     glean-api-specs:
         sourceNamespace: glean-api-specs
@@ -24,8 +24,8 @@ sources:
             - 0.9.0
     glean-client-merged-code-samples-spec:
         sourceNamespace: glean-client-merged-code-samples-spec
-        sourceRevisionDigest: sha256:1420ed690d295a415b66f5f5c0c823251e35c43c5c32f2e5709ebbaf0b410eb9
-        sourceBlobDigest: sha256:07783bb16e23520f5662c31c52e60ecd1042e0539b80d0fe1c420e4a68a47bcd
+        sourceRevisionDigest: sha256:cb37f69544255d57a5b0b0cb20dd8510d786011d534b70f13ddd75c1899967e9
+        sourceBlobDigest: sha256:3fa7d139354aeee5dcfd6a7e3550e7cfaa0bfadbacd40a14db4463bcc64bb301
         tags:
             - latest
             - main
@@ -39,8 +39,8 @@ sources:
             - 0.9.0
     glean-index-merged-code-samples-spec:
         sourceNamespace: glean-index-merged-code-samples-spec
-        sourceRevisionDigest: sha256:390a008f5b2414a141656c92723d96bd5c0e35dd0e71ae325a683139a6bbaaca
-        sourceBlobDigest: sha256:eaec2d89f7dc007f43789b7e09da68594b5923cc73b2ae433e17b86e44d88ee8
+        sourceRevisionDigest: sha256:2e596f3ace1edd1f136fb502d63bd36670bb9d46fa00d1ce7465e71de7e402b4
+        sourceBlobDigest: sha256:61a40b5700a87a64362988e8ad9689ab2a18158d4623b62a628edd016f419262
         tags:
             - latest
             - main

final_specs/client_rest.yaml

@@ -15146,8 +15146,8 @@ paths:
     post:
       tags:
         - Insights
-      summary: Read insights
-      description: Reads the aggregate information for each user, query, and content.
+      summary: Get insights
+      description: Gets the aggregate usage insights data displayed in the Insights Dashboards.
       operationId: insights
       x-visibility: Public
       x-codegen-request-body-name: payload
@@ -15157,7 +15157,7 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/InsightsRequest"
-        description: Includes request params for insights dashboard data.
+        description: Includes request parameters for insights requests.
         required: true
         x-exportParamName: InsightsRequest
       responses:
@@ -15179,7 +15179,7 @@ paths:
         - lang: python
           label: Python (API Client)
           source: |-
-            from glean.api_client import Glean, models
+            from glean.api_client import Glean
             import os
 
 
@@ -15188,9 +15188,7 @@ paths:
                 instance=os.getenv("GLEAN_INSTANCE", ""),
             ) as glean:
 
-                res = glean.client.insights.retrieve(categories=[
-                    models.InsightsRequestCategory.COLLECTIONS,
-                ])
+                res = glean.client.insights.retrieve()
 
                 # Handle response
                 print(res)
@@ -15205,13 +15203,7 @@ paths:
             });
 
             async function run() {
-              const result = await glean.client.insights.retrieve({
-                categories: [
-                  "COLLECTIONS",
-                  "SHORTCUTS",
-                  "ANNOUNCEMENTS",
-                ],
-              });
+              const result = await glean.client.insights.retrieve({});
 
               // Handle the result
               console.log(result);
@@ -15220,17 +15212,15 @@ paths:
             run();
         - lang: go
           label: Go (API Client)
-          source: "package main\n\nimport(\n\t\"context\"\n\t\"os\"\n\tapiclientgo \"github.com/gleanwork/api-client-go\"\n\t\"github.com/gleanwork/api-client-go/models/components\"\n\t\"log\"\n)\n\nfunc main() {\n    ctx := context.Background()\n\n    s := apiclientgo.New(\n        apiclientgo.WithSecurity(os.Getenv(\"GLEAN_API_TOKEN\")),\n        apiclientgo.WithInstance(os.Getenv(\"GLEAN_INSTANCE\")),\n    )\n\n    res, err := s.Client.Insights.Retrieve(ctx, components.InsightsRequest{\n        Categories: []components.InsightsRequestCategory{\n            components.InsightsRequestCategoryCollections,\n        },\n    })\n    if err != nil {\n        log.Fatal(err)\n    }\n    if res.InsightsResponse != nil {\n        // handle response\n    }\n}"
+          source: "package main\n\nimport(\n\t\"context\"\n\t\"os\"\n\tapiclientgo \"github.com/gleanwork/api-client-go\"\n\t\"github.com/gleanwork/api-client-go/models/components\"\n\t\"log\"\n)\n\nfunc main() {\n    ctx := context.Background()\n\n    s := apiclientgo.New(\n        apiclientgo.WithSecurity(os.Getenv(\"GLEAN_API_TOKEN\")),\n        apiclientgo.WithInstance(os.Getenv(\"GLEAN_INSTANCE\")),\n    )\n\n    res, err := s.Client.Insights.Retrieve(ctx, components.InsightsRequest{})\n    if err != nil {\n        log.Fatal(err)\n    }\n    if res.InsightsResponse != nil {\n        // handle response\n    }\n}"
         - lang: java
           label: Java (API Client)
           source: |-
             package hello.world;
 
             import java.lang.Exception;
-            import java.util.List;
             import org.openapis.openapi.Glean;
             import org.openapis.openapi.models.components.InsightsRequest;
-            import org.openapis.openapi.models.components.InsightsRequestCategory;
             import org.openapis.openapi.models.operations.InsightsResponse;
 
             public class Application {
@@ -15242,8 +15232,6 @@ paths:
                         .build();
 
                     InsightsRequest req = InsightsRequest.builder()
-                            .categories(List.of(
-                                InsightsRequestCategory.COLLECTIONS))
                             .build();
 
                     InsightsResponse res = sdk.client().insights().retrieve()
@@ -20189,6 +20177,7 @@ components:
             - SEARCH
             - SIDEBAR
             - SUMMARY
+            - TASKS
         issue:
           type: string
           description: The issue the user indicated in the feedback.
@@ -24472,6 +24461,41 @@ components:
         cursor:
           type: string
           description: Cursor that indicates the start of the next page of results. To be passed in "more" requests for this query.
+    InsightsOverviewRequest:
+      properties:
+        departments:
+          type: array
+          items:
+            type: string
+          description: Departments for which Insights are requested.
+        dayRange:
+          $ref: "#/components/schemas/Period"
+          description: Time period for which Insights are requested.
+    InsightsAssistantRequest:
+      properties:
+        departments:
+          type: array
+          items:
+            type: string
+          description: Departments for which Insights are requested.
+        dayRange:
+          $ref: "#/components/schemas/Period"
+          description: Time period for which Insights are requested.
+    AgentsInsightsV2Request:
+      properties:
+        agentIds:
+          type: array
+          items:
+            type: string
+          description: IDs of the Agents for which Insights should be returned. An empty array signifies all.
+        departments:
+          type: array
+          items:
+            type: string
+          description: Departments for which Insights are requested.
+        dayRange:
+          $ref: "#/components/schemas/Period"
+          description: Time period for which Insights are requested.
     InsightsAiAppRequestOptions:
       type: object
       properties:
@@ -24488,16 +24512,33 @@ components:
           items:
             type: string
           description: IDs of the Agents for which Insights should be returned. An empty array signifies all.
-    DownloadInsightsRequest:
-      required:
-        - categories
+    InsightsRequest:
       properties:
+        overviewRequest:
+          $ref: "#/components/schemas/InsightsOverviewRequest"
+          x-visibility: Public
+          description: If specified, will return data for the Overview section of the Insights Dashboard.
+        assistantRequest:
+          $ref: "#/components/schemas/InsightsAssistantRequest"
+          x-visibility: Public
+          description: If specified, will return data for the Assistant section of the Insights Dashboard.
+        agentsRequest:
+          $ref: "#/components/schemas/AgentsInsightsV2Request"
+          x-visibility: Public
+          description: If specified, will return data for the Agents section of the Insights Dashboard.
+        disablePerUserInsights:
+          type: boolean
+          description: If true, suppresses the generation of per-user Insights in the response. Default is false.
         categories:
+          deprecated: true
           type: array
           items:
             type: string
             enum:
               - AGENTS
+              - AGENT_USERS
+              - TOP_AGENTS
+              - AGENTS_USAGE_BY_DEPARTMENT
               - AI
               - AI_APPS
               - ANNOUNCEMENTS
@@ -24510,34 +24551,31 @@ components:
               - USERS
           description: Categories of data requested. Request can include single or multiple types.
         departments:
+          deprecated: true
           type: array
           items:
             type: string
           description: Departments that the data is requested for. If this is empty, corresponds to whole company.
         dayRange:
+          deprecated: true
           $ref: "#/components/schemas/Period"
         aiAppRequestOptions:
+          deprecated: true
           $ref: "#/components/schemas/InsightsAiAppRequestOptions"
         agentsRequestOptions:
+          deprecated: true
           $ref: "#/components/schemas/InsightsAgentsRequestOptions"
-    InsightsRequest:
-      allOf:
-        - $ref: "#/components/schemas/DownloadInsightsRequest"
-        - type: object
-          properties:
-            assistantActivityTypes:
-              type: array
-              items:
-                type: string
-                enum:
-                  - GLEAN_CHAT
-                  - AI_SUMMARY
-                  - AI_ANSWER
-                  - GLEANBOT_RESPONSE
-              description: Types of activity that should count in the definition of an Assistant Active User. Affects only insights for AI category.
-            disablePerUserInsights:
-              type: boolean
-              description: If true, suppresses the generation of per-user Insights in the response. Default is false.
+        assistantActivityTypes:
+          deprecated: true
+          type: array
+          items:
+            type: string
+            enum:
+              - GLEAN_CHAT
+              - AI_SUMMARY
+              - AI_ANSWER
+              - GLEANBOT_RESPONSE
+          description: Types of activity that should count in the definition of an Assistant Active User. Affects only insights for AI category.
     LabeledCountInfo:
       required:
         - label
@@ -25823,6 +25861,11 @@ components:
         channelName:
           type: string
           description: Name of the channel (applicable for CHANNEL type sections). Used to display in the frontend.
+        channelType:
+          type: string
+          description: |
+            Channel visibility/type for CHANNEL sections. For Slack this is typically one of
+            PublicChannel, PrivateChannel. Omit if not applicable or unknown.
         instanceId:
           type: string
           description: Instance identifier for the channel or workspace. Used for constructing channel URLs to display in the frontend.

final_specs/indexing.yaml

@@ -3736,6 +3736,7 @@ paths:
         - lang: go
           label: Go (API Client)
           source: "package main\n\nimport(\n\t\"context\"\n\t\"os\"\n\tapiclientgo \"github.com/gleanwork/api-client-go\"\n\t\"github.com/gleanwork/api-client-go/models/components\"\n\t\"log\"\n)\n\nfunc main() {\n    ctx := context.Background()\n\n    s := apiclientgo.New(\n        apiclientgo.WithSecurity(os.Getenv(\"GLEAN_API_TOKEN\")),\n        apiclientgo.WithInstance(os.Getenv(\"GLEAN_INSTANCE\")),\n    )\n\n    res, err := s.Indexing.Shortcuts.Upload(ctx, components.UploadShortcutsRequest{\n        UploadID: \"<id>\",\n        Shortcuts: []components.IndexingShortcut{\n            components.IndexingShortcut{\n                InputAlias: \"<value>\",\n                DestinationURL: \"https://majestic-pharmacopoeia.info/\",\n                CreatedBy: \"<value>\",\n            },\n        },\n    })\n    if err != nil {\n        log.Fatal(err)\n    }\n    if res != nil {\n        // handle response\n    }\n}"
+  /api/index/v1/debug/{datasource}/document/events: {}
 components:
   securitySchemes:
     APIToken:
@@ -5142,6 +5143,38 @@ components:
         - NOT_UPLOADED
         - STATUS_UNKNOWN
       example: UPLOADED
+    DebugDocumentLifecycleRequest:
+      type: object
+      description: Describes the request body of the /debug/{datasource}/document/events API call.
+      properties:
+        objectType:
+          type: string
+          description: Object type of the document to get lifecycle events for.
+          example: Article
+        docId:
+          type: string
+          description: Glean Document ID within the datasource to get lifecycle events for.
+          example: art123
+        startDate:
+          type: string
+          description: The start date for events to be fetched. Cannot be more than 30 days (default 7 days) in the past.
+          example: "2025-05-01"
+        maxEvents:
+          type: integer
+          description: Max number of events to be fetched. Cannot be more than 100 (default 20).
+          example: 50
+      required:
+        - objectType
+        - docId
+    DebugDocumentLifecycleResponse:
+      type: object
+      description: Describes the response body of the /debug/{datasource}/document/events API call
+      properties:
+        lifeCycleEvents:
+          type: array
+          description: List of lifecycle events corresponding to the document
+          items:
+            $ref: "#/components/schemas/LifeCycleEvent"
     PropertyDefinition:
       properties:
         name: