## Python SDK Changes:

* `glean.client.search.retrieve_feed()`: 
  *  `request.categories[].enum(knowledge_gap)` **Added**
  *  `response.results[]` **Changed**

Author: speakeasybot

.speakeasy/gen.lock

@@ -1,19 +1,19 @@
 lockVersion: 2.0.0
 id: 3e3290ca-0ee8-4981-b1bc-14536048fa63
 management:
-  docChecksum: 1d1c4c798b764226bfeeae4268f907c1
+  docChecksum: a8c5d99462d09453ae8436be00f80496
   docVersion: 0.9.0
-  speakeasyVersion: 1.792.0
-  generationVersion: 2.927.0
-  releaseVersion: 0.15.5
-  configChecksum: 2d7eb6b1e296b48ffc7d66cf6e6b21cd
+  speakeasyVersion: 1.793.1
+  generationVersion: 2.928.0
+  releaseVersion: 0.15.6
+  configChecksum: 9daa946e37cb85898ebf91d467b23545
   repoURL: https://github.com/gleanwork/api-client-python.git
   installationURL: https://github.com/gleanwork/api-client-python.git
   published: true
 persistentEdits:
-  generation_id: 2c6b40a9-5bf5-4774-9389-0275aa4de10b
-  pristine_commit_hash: 9d93e89051da150d3c7ed6e5acb2fc862affb253
-  pristine_tree_hash: f94026f8e759a799c60bb7b8c2b8fac16e8400a6
+  generation_id: 04df12a1-e1c1-4d0b-8721-2f221d1a19c5
+  pristine_commit_hash: 9e1d5afb9aea0194630552693bcdf86b72451df0
+  pristine_tree_hash: 21238ef182acacf49f88805960a680b5861983d3
 features:
   python:
     acceptHeaders: 3.0.0
@@ -1403,8 +1403,8 @@ trackedFiles:
     pristine_git_object: a851a7f13eb25d515fa9b9244c5dfdc98fa14e2c
   docs/models/feedrequestcategory.md:
     id: 31a02f3064c7
-    last_write_checksum: sha1:63f6abf5e4f5048535b7767274c8a18176020427
-    pristine_git_object: c3eab96e8f64c7ed1323eaf2c292c044db933f71
+    last_write_checksum: sha1:e377f827763a348ab5dce9ad4b795b4481b8aba9
+    pristine_git_object: 35d5beb1e75476d726e4106beba705ecb46b9228
   docs/models/feedrequestoptions.md:
     id: 58eb26b19e77
     last_write_checksum: sha1:fd2ab08736cef8156169b0cfee8c52e7aed1accf
@@ -1419,12 +1419,12 @@ trackedFiles:
     pristine_git_object: 7f3ded753911005508191be31592746cef1c2781
   docs/models/feedresult.md:
     id: 4b67dc1cea64
-    last_write_checksum: sha1:6781234248531681b38a1394afc7a62438440758
-    pristine_git_object: f14153ca4fc73e08d620714d4ed5ef2c0bad05c5
+    last_write_checksum: sha1:9257ff8b3d935716255b221c801b7e080b31f580
+    pristine_git_object: f6f92abf16b61f88b527e1c906f605e98306878e
   docs/models/feedresultcategory.md:
     id: a5f77f38d0a7
-    last_write_checksum: sha1:2bfa3af25a938fbbc55b12b94d555f4b95517986
-    pristine_git_object: c27f4b3b80f6c54cb0fe407dc9151821aad91a2e
+    last_write_checksum: sha1:141ed36910bee33d07acc055181eeb9a9e25087d
+    pristine_git_object: 3689b4f8adf4ec869de90b6bff497b52b474f877
   docs/models/fieldscope.md:
     id: e6b52bcb22a6
     last_write_checksum: sha1:13a1492ce39d2f89a01d626996a345a1339a1873
@@ -1871,8 +1871,8 @@ trackedFiles:
     pristine_git_object: 647f9bb67a6af30d7fd71c8ddb3c5e1bf40bb938
   docs/models/justificationtype.md:
     id: 8286affacee4
-    last_write_checksum: sha1:02dcd2b35c40d2f4c5435e0724cb13efabbe9a9e
-    pristine_git_object: cff9e6dd34fd05679bdc9629b86bb9b4d9577436
+    last_write_checksum: sha1:b4cd16dcb4faf8eaf3074fcbb9e947543cb2bac6
+    pristine_git_object: ebb1b8b6a5cf0130beeac43fd8ebe646ab3c8b89
   docs/models/knowledgetype.md:
     id: 1e0c90679228
     last_write_checksum: sha1:0030a7539b9362bbb59e0bbd36580676058b3540
@@ -2203,8 +2203,8 @@ trackedFiles:
     pristine_git_object: a24b8b95237035cda5ff134a9c0cc3bb601e06d7
   docs/models/placementreason.md:
     id: e3d1cdfcf2b5
-    last_write_checksum: sha1:f4720f3ce89ed29c92e2bd0aa15169ccc428bafd
-    pristine_git_object: 515cd010b7035e35f410e715d18da9c175d18e89
+    last_write_checksum: sha1:20993a6ca9e751a4d3aa46f8f84f03fc00348d53
+    pristine_git_object: f17278f2ff7680bcda387e90fb710196973b281c
   docs/models/platformactionsummary.md:
     id: 66630faec49a
     last_write_checksum: sha1:918357358bb6dd6840b6ef69e9bbfc05620f3eda
@@ -3563,8 +3563,8 @@ trackedFiles:
     pristine_git_object: 79e388be87446ab6a4064b372bad0e8376d0cb5e
   pyproject.toml:
     id: 5d07e7d72637
-    last_write_checksum: sha1:45e124f939485287d52a21c3cef63a7f0d6b7c47
-    pristine_git_object: 0a9c335a9a31ec8fdae149276535421a5ea9865a
+    last_write_checksum: sha1:3807566269aef99f86d2c2a1fa8e983dfc13d829
+    pristine_git_object: ce622856eb04966624b35b572cb6c150763d7629
   scripts/prepare_readme.py:
     id: e0c5957a6035
     last_write_checksum: sha1:c2c83f71dea61eb50c9e05da83b16d18b4da8794
@@ -3591,8 +3591,8 @@ trackedFiles:
     pristine_git_object: 55f23c1feabfedeb7e8cd5bea8b910f0ae0b77d9
   src/glean/api_client/_version.py:
     id: 0ce22b26136b
-    last_write_checksum: sha1:b46c6e4af3f5cb325a715d8f230ab39237903756
-    pristine_git_object: c5dd907a297d4edf9c1839e3cfd484204c8fdac0
+    last_write_checksum: sha1:eb4806b98ee0b74ee502839325124d490471c26f
+    pristine_git_object: a08d3d4ac2d74e92dcdf3d88ffcd1010fbe95703
   src/glean/api_client/agents.py:
     id: b925701a9217
     last_write_checksum: sha1:1d4b152d9d9260d1c97d4983f521f30b5cfa1085
@@ -4819,16 +4819,16 @@ trackedFiles:
     pristine_git_object: 44041cb376d89949c815ea1e7813505940605855
   src/glean/api_client/models/feedentry.py:
     id: 023eb6c10ae1
-    last_write_checksum: sha1:baa7d04a5ae830282e82b19e870788c2b90da464
-    pristine_git_object: 03dd978e2940f2d93f5b9393c84d60c0e36f10b6
+    last_write_checksum: sha1:6635973c660961c22f525cd1faa1af242c137d3b
+    pristine_git_object: 30ea4f0e06463e3b33450cccbf766ad0490a8903
   src/glean/api_client/models/feedop.py:
     id: b8067ac0a127
     last_write_checksum: sha1:c58cb0a3a01925eb14d84176c5c6e9d8f4d84cf1
     pristine_git_object: f39626285f84630e5a9233736d652914b759d44b
   src/glean/api_client/models/feedrequest.py:
     id: 33496b6a5bab
-    last_write_checksum: sha1:e67128cc0d6e17f4bf4f5a33717cd0ef53e68560
-    pristine_git_object: 69d85fb78ee67fc423208f0cb864b5416c5d38f4
+    last_write_checksum: sha1:9e76dc4e42515478e49a66aac44c597544970a04
+    pristine_git_object: d6d5f2d0cdf0519b45b59814f749b9240de850ad
   src/glean/api_client/models/feedrequestoptions.py:
     id: b99003fbf522
     last_write_checksum: sha1:d5ffee29242075cbe6d2dd5ec916b0c3d40acf54
@@ -4839,8 +4839,8 @@ trackedFiles:
     pristine_git_object: 683438c837601f483526ec18756fadc7222edb24
   src/glean/api_client/models/feedresult.py:
     id: ae187332b37a
-    last_write_checksum: sha1:fd675d08d2aa02216a2c20748560bf9273e35347
-    pristine_git_object: f5bc568a98732c157152a822c5009544bd4275eb
+    last_write_checksum: sha1:10a4ce7eb8ab59144da0378ef166f99323a83a4c
+    pristine_git_object: 548eedb012383c7dea8ac5649096c876e1794a69
   src/glean/api_client/models/followupaction.py:
     id: e2de5c4c8524
     last_write_checksum: sha1:49e1a826449081fecfcd828c940604db949a8533
@@ -6991,8 +6991,8 @@ trackedFiles:
     pristine_git_object: abb763ddc8504b28c0cb6fdf8d25237d46e21bab
   tests/mockserver/internal/handler/pathpostrestapiv1getchat.go:
     id: a0ec7bafa599
-    last_write_checksum: sha1:b48e2313407814ee4f8ed181b8e5299a84960c44
-    pristine_git_object: 96d4127e0455272a9842e2d1954e5fcefa3278cc
+    last_write_checksum: sha1:2267292ba8173cf8df70ddbc6ac02ff3439cb879
+    pristine_git_object: 8740195860b6c08e036caae19aab8e7374350960
   tests/mockserver/internal/handler/pathpostrestapiv1getchatapplication.go:
     id: 7d101c69d4bc
     last_write_checksum: sha1:7b81898137fdb3a89b4dcfa318b9b5b92e8860c0
@@ -8059,12 +8059,12 @@ trackedFiles:
     pristine_git_object: 04cc3a93272ac70933b0485bee31b335e05ab623
   tests/mockserver/internal/sdk/models/components/feedentry.go:
     id: d25fd66fcf7a
-    last_write_checksum: sha1:7c8546042939c356feeb9846070c23a04edd1a13
-    pristine_git_object: 75c2030f1bf29bd59360b09c62df32f9efee0517
+    last_write_checksum: sha1:ca05066846a6d047343e46a4d545a1402e92b96c
+    pristine_git_object: 90b0237c9a4c54e1aceada9137ee3ff4409b9837
   tests/mockserver/internal/sdk/models/components/feedrequest.go:
     id: b06bc4cef0cf
-    last_write_checksum: sha1:ca761301495e36eaf10fc4fa9086380498e6491a
-    pristine_git_object: 854c8390fa48c1647f0f3c04d19d89f6aae43d6f
+    last_write_checksum: sha1:a1293c6cdc3c294628e854614229c370a5218b71
+    pristine_git_object: 97365efff1b005e6769bb2d5b561de68aadfc221
   tests/mockserver/internal/sdk/models/components/feedrequestoptions.go:
     id: fd9245fe1bf2
     last_write_checksum: sha1:fa30b7fd6ee3e45896d7bbe36e33e7c0cb9000ba
@@ -8075,8 +8075,8 @@ trackedFiles:
     pristine_git_object: 54f9d1a8997983156c84e69f888c59a80d06c2b1
   tests/mockserver/internal/sdk/models/components/feedresult.go:
     id: 47411573e67a
-    last_write_checksum: sha1:1980e5be5848c3aa1e732c680f7472899c9eb19c
-    pristine_git_object: 158c74284653d58bdffbab15a8f23188e092875d
+    last_write_checksum: sha1:973eec9b2d273d721f6310ebb20578c7d4f142d1
+    pristine_git_object: cc69740a57fd002be69b2922812d7497a0778f51
   tests/mockserver/internal/sdk/models/components/followupaction.go:
     id: 38179fec19b1
     last_write_checksum: sha1:32a31f7af77a58ce6f3284e8550d01fcf0d3bddd
@@ -10207,8 +10207,8 @@ trackedFiles:
     pristine_git_object: 6cc8aeec3c52329d389081db0a27f10f53f214b9
   tests/test_messages.py:
     id: be23089b1f8b
-    last_write_checksum: sha1:2404e23964ef6a1f5ddc900402b34e597d2d9617
-    pristine_git_object: 132005ec7d1e35f805b6a8c28e07e043bce22f0a
+    last_write_checksum: sha1:a91c985cd1d11560059dc448b10e0c7b75ed60e5
+    pristine_git_object: dfdc18641f0d6c38d84b4603ad2da71f75f2e13c
   tests/test_people.py:
     id: 37c243940039
     last_write_checksum: sha1:2b78b1c5ea17f267895188b1b48ff9fe2bc19f17
@@ -10235,8 +10235,8 @@ trackedFiles:
     pristine_git_object: 98d7f69d362a6770ee01a6c3d9f3684b01a6cbd6
   tests/test_summarize.py:
     id: a255d8a6f627
-    last_write_checksum: sha1:f6642c3c0f1fb75b4f7bb80025d98eb45a89d51f
-    pristine_git_object: 2cfa3243af32eacf74865c581c8ad2ddf0b0f551
+    last_write_checksum: sha1:445549b480d19b12cb8c087acd66b99124b90e63
+    pristine_git_object: bdd2aad5eb1953d4d77dd2afeb9eaa6dee7e9cbe
   tests/test_tools.py:
     id: 70889bdf7321
     last_write_checksum: sha1:e9e37efd6a65d805c02d70d548df9c87dd062b0e
@@ -11677,6 +11677,7 @@ generatedTests:
   post_/api/index/v1/debug/{datasource}/documents: "2026-08-07T21:21:16Z"
   post_/api/index/v1/debug/{datasource}/document/events: "2026-08-07T21:21:16Z"
   post_/api/index/v1/debug/{datasource}/user: "2026-08-07T21:21:16Z"
+releaseNotes: "## Python SDK Changes:\n* `glean.client.search.retrieve_feed()`: \n  *  `request.categories[].enum(knowledge_gap)` **Added**\n  *  `response.results[]` **Changed**\n"
 generatedFiles:
   - .devcontainer/README.md
   - .devcontainer/devcontainer.json

.speakeasy/gen.yaml

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

.speakeasy/glean-merged-spec.yaml

@@ -2,8 +2,8 @@ openapi: 3.0.0
 info:
   version: "0.9.0"
   title: Glean API
-  x-source-commit-sha: 7a82cb818d032eca9f42d56706dd9e0a65418d45
-  x-open-api-commit-sha: 987c3f6458420f6a99420d808bdccea74ab84dad
+  x-source-commit-sha: 490cb4fb47804dfb45ef06490f96f662704ed913
+  x-open-api-commit-sha: 99b6a2e459684888ecb1484200b9113eb2eb0cb7
   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.
@@ -205,7 +205,8 @@ paths:
             text/event-stream:
               schema:
                 type: string
-                description: Server-sent events emitted by the running agent.
+                description: |
+                  Server-sent events emitted by the running agent. Successful runs emit `message` events. A terminal failure after the stream has started emits exactly one `run.failed` event whose `data` is an `AgentRunFailedEventData` payload, then closes.
                 example: |
                   id: 1
                   event: message
@@ -214,6 +215,10 @@ paths:
                   id: 2
                   event: message
                   data: {"messages":[{"role":"GLEAN_AI","content":[{"text":", I can help with HR policy questions.","type":"text"}]}]}
+
+                  id: 3
+                  event: run.failed
+                  data: {"error":{"type":"https://developers.glean.com/errors/spend-limit-exceeded","title":"Spend Limit Exceeded","status":403,"detail":"You've reached the monthly limit set by your admin.","code":"spend_limit_exceeded","request_id":"req_123","documentation_url":"https://developers.glean.com/errors/spend-limit-exceeded"}}
         "400":
           $ref: "#/components/responses/PlatformBadRequest"
         "401":
@@ -281,14 +286,18 @@ paths:
                   data: {"type":"response.created","response_id":"resp_e65a0a77-97a2-4c91-be60-eae7f6238015"}
 
                   id: 2
+                  event: response.progress
+                  data: {"type":"response.progress","response_id":"resp_e65a0a77-97a2-4c91-be60-eae7f6238015","text":"**Searching:** foo"}
+
+                  id: 3
                   event: response.output_text.delta
                   data: {"type":"response.output_text.delta","response_id":"resp_e65a0a77-97a2-4c91-be60-eae7f6238015","delta":"Hello"}
 
-                  id: 3
+                  id: 4
                   event: response.output_text.done
                   data: {"type":"response.output_text.done","response_id":"resp_e65a0a77-97a2-4c91-be60-eae7f6238015","text":"Hello"}
 
-                  id: 4
+                  id: 5
                   event: response.completed
                   data: {"type":"response.completed","response_id":"resp_e65a0a77-97a2-4c91-be60-eae7f6238015","response":{"id":"resp_e65a0a77-97a2-4c91-be60-eae7f6238015","object":"response","status":"completed","output":[{"type":"message","role":"assistant","content":[{"type":"output_text","text":"Hello"}]}],"store":true,"request_id":"req_123","created_at":"2026-07-14T20:00:00Z"}}
         "400":
@@ -14344,6 +14353,7 @@ components:
               - OOO_PLANNER
               - OOO_CATCH_UP
               - ADMIN_HEALTH_CENTER
+              - KNOWLEDGE_GAP
           description: Categories of content requested. An allowlist gives flexibility to request content separately or together.
         requestOptions:
           $ref: '#/components/schemas/FeedRequestOptions'
@@ -14789,6 +14799,7 @@ components:
             - OOO_PLANNER
             - OOO_CATCH_UP
             - ADMIN_HEALTH_CENTER
+            - KNOWLEDGE_GAP
           description: Type of the justification.
         justification:
           type: string
@@ -14880,6 +14891,7 @@ components:
             - OOO_PLANNER
             - OOO_CATCH_UP
             - ADMIN_HEALTH_CENTER
+            - KNOWLEDGE_GAP
           description: Category of the result, one of the requested categories in incoming request.
         primaryEntry:
           $ref: '#/components/schemas/FeedEntry'
@@ -14896,7 +14908,8 @@ components:
           enum:
             - ORGANIC
             - PROMO
-          description: Placement source for ranked feed results. ORGANIC means the card was emitted by normal feed ranking. PROMO means the card was inserted by the homepage cards promo framework.
+            - PINNED
+          description: Placement source for ranked feed results. ORGANIC means the card was emitted by normal feed ranking. PROMO means the card was inserted by the homepage cards promo framework. PINNED means the card was moved to the head of the ranked stack (e.g. knowledge-gap pilot cards).
       required:
         - category
         - primaryEntry

.speakeasy/workflow.lock

@@ -1,9 +1,9 @@
-speakeasyVersion: 1.792.0
+speakeasyVersion: 1.793.1
 sources:
     Glean API:
         sourceNamespace: glean-api-specs
-        sourceRevisionDigest: sha256:ca77ef4550d695da210e8f0d32f3422d29e9d09f7aa66f7b13d248c6ec8c7941
-        sourceBlobDigest: sha256:469de4cd2c8ab4928c3989656bf63cc265a8ceea5a8b3e3498734137b19723f8
+        sourceRevisionDigest: sha256:802f61fb03e7ef1362e9cdbf9b9f4d3c5568dcc9b7096ea8c996e0a2357823f2
+        sourceBlobDigest: sha256:90e54bb0150d7299edd88023432fed6cd5f94bf4033b2b17ff43ad8439c5d217
         tags:
             - latest
     Glean Client API:
@@ -16,10 +16,10 @@ targets:
     glean:
         source: Glean API
         sourceNamespace: glean-api-specs
-        sourceRevisionDigest: sha256:ca77ef4550d695da210e8f0d32f3422d29e9d09f7aa66f7b13d248c6ec8c7941
-        sourceBlobDigest: sha256:469de4cd2c8ab4928c3989656bf63cc265a8ceea5a8b3e3498734137b19723f8
+        sourceRevisionDigest: sha256:802f61fb03e7ef1362e9cdbf9b9f4d3c5568dcc9b7096ea8c996e0a2357823f2
+        sourceBlobDigest: sha256:90e54bb0150d7299edd88023432fed6cd5f94bf4033b2b17ff43ad8439c5d217
         codeSamplesNamespace: glean-api-specs-python-code-samples
-        codeSamplesRevisionDigest: sha256:2c3560eb6c6ea1afdbbf7fd64c9e27673ca3ae028fb784f30ecd9151553898f8
+        codeSamplesRevisionDigest: sha256:1426503cf43714290faf1a9a9a0d94f83a6638e69dd2fa02ede4f4be83ab7fab
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest

RELEASES.md

@@ -818,4 +818,14 @@ Based on:
 ### Generated
 - [python v0.15.5] .
 ### Releases
-- [PyPI v0.15.5] https://pypi.org/project/glean-api-client/0.15.5 - .
+- [PyPI v0.15.5] https://pypi.org/project/glean-api-client/0.15.5 - .
+
+## 2026-08-12 01:59:00
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.793.1 (2.928.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.15.6] .
+### Releases
+- [PyPI v0.15.6] https://pypi.org/project/glean-api-client/0.15.6 - .

docs/models/feedrequestcategory.md

@@ -57,4 +57,5 @@ value = FeedRequestCategory.DOCUMENT_SUGGESTION
 | `DEMO_CARD`                         | DEMO_CARD                           |
 | `OOO_PLANNER`                       | OOO_PLANNER                         |
 | `OOO_CATCH_UP`                      | OOO_CATCH_UP                        |
-| `ADMIN_HEALTH_CENTER`               | ADMIN_HEALTH_CENTER                 |
+| `ADMIN_HEALTH_CENTER`               | ADMIN_HEALTH_CENTER                 |
+| `KNOWLEDGE_GAP`                     | KNOWLEDGE_GAP                       |