Skip to content

Commit 4f3f9dc

Browse files
github-actions[bot]speakeasybotspeakeasy-github[bot]
authored
chore: 🐝 Update SDK - Generate 0.17.23 (#137)
* ## Java SDK Changes: * `glean.chat.create()`: * `request.text` **Removed** (Breaking ⚠️) * `response.output[].content[].structuredOutput` **Removed** (Breaking ⚠️) * `glean.chat.createStream()`: * `request.text` **Removed** (Breaking ⚠️) * `response.[].union(RESPONSE_COMPLETED).data.response.output[].content[].structuredOutput` **Removed** (Breaking ⚠️) * `glean.search.enumerate()`: **Added** * `glean.triggers.searchEvents()`: `response.results[].reason` **Changed** * `glean.triggers.searchPresetEvents()`: `response.results[].reason` **Changed** * empty commit to trigger [run-tests] workflow --------- Co-authored-by: speakeasybot <bot@speakeasyapi.dev> Co-authored-by: speakeasy-github[bot] <128539517+speakeasy-github[bot]@users.noreply.github.com>
1 parent 4080978 commit 4f3f9dc

51 files changed

Lines changed: 3001 additions & 1704 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.speakeasy/gen.lock‎

Lines changed: 106 additions & 110 deletions
Large diffs are not rendered by default.

‎.speakeasy/gen.yaml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ generation:
3131
generateNewTests: false
3232
skipResponseBodyAssertions: false
3333
java:
34-
version: 0.17.22
34+
version: 0.17.23
3535
additionalDependencies: []
3636
additionalPlugins: []
3737
artifactID: glean-api-client

‎.speakeasy/glean-merged-spec.yaml‎

Lines changed: 218 additions & 80 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@ openapi: 3.1.0
22
info:
33
version: "0.9.0"
44
title: Glean API
5-
x-source-commit-sha: 77999be6fb7bac7ce1b740a5f554037282298b5d
6-
x-open-api-commit-sha: ea654b06c64649ac0076b89cdcea6e0792daec11
5+
x-source-commit-sha: 74225def94ec0e1d0281e9ed827c93f85ccb2152
6+
x-open-api-commit-sha: d781217a7cfce20ac740646c1b7242f059d850cb
77
description: |
88
# Introduction
99
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.
@@ -1496,6 +1496,63 @@ paths:
14961496
x-speakeasy-name-override: listFilters
14971497
security:
14981498
- APIToken: []
1499+
/api/search/enumeration:
1500+
post:
1501+
tags:
1502+
- Search
1503+
summary: Enumerate matching documents
1504+
description: |
1505+
Walk every indexed document that matches a selection and that the caller is permitted to see. Returns document references with minimal metadata and never bodies; request `SNIPPETS` via `include` for query-relevant excerpts, and hydrate full documents with `POST /api/documents/batch`. Unlike `POST /api/search`, `query` is optional: omit it to enumerate by `datasources`, `filters`, and `time_range` alone. Results are ordered for completeness, not relevance.
1506+
Follow `next_cursor` until `has_more` is `false`, regardless of page size. This is a live scan, not a snapshot: concurrent index changes can cause duplicates or omissions. Deduplicate by `document_id`.
1507+
A page is either complete at its cursor position or an error. A shard or datasource failure returns HTTP 503 and the same cursor stays valid for retry; this endpoint never returns a partial page. A cursor reused with a different selection returns HTTP 400 `invalid_cursor`.
1508+
operationId: platform-search-enumeration
1509+
x-glean-scopes:
1510+
legacy:
1511+
- SEARCH
1512+
platform:
1513+
- search:query
1514+
x-visibility: Public
1515+
x-glean-experimental:
1516+
id: 9ce7bb73-1e30-460a-a917-cae09ac3a3ea
1517+
introduced: "2026-11-02"
1518+
x-codegen-request-body-name: payload
1519+
requestBody:
1520+
required: true
1521+
content:
1522+
application/json:
1523+
schema:
1524+
$ref: "#/components/schemas/PlatformSearchEnumerationRequest"
1525+
responses:
1526+
"200":
1527+
description: Successful response.
1528+
content:
1529+
application/json:
1530+
schema:
1531+
$ref: "#/components/schemas/PlatformSearchEnumerationResponse"
1532+
"400":
1533+
$ref: "#/components/responses/PlatformBadRequest"
1534+
"401":
1535+
$ref: "#/components/responses/PlatformUnauthorized"
1536+
"403":
1537+
$ref: "#/components/responses/PlatformForbidden"
1538+
"404":
1539+
$ref: "#/components/responses/PlatformNotFound"
1540+
"408":
1541+
$ref: "#/components/responses/PlatformRequestTimeout"
1542+
"413":
1543+
$ref: "#/components/responses/PlatformRequestTooLarge"
1544+
"422":
1545+
$ref: "#/components/responses/PlatformUnprocessableEntity"
1546+
"429":
1547+
$ref: "#/components/responses/PlatformTooManyRequests"
1548+
"500":
1549+
$ref: "#/components/responses/PlatformInternalServerError"
1550+
"503":
1551+
$ref: "#/components/responses/PlatformServiceUnavailable"
1552+
x-speakeasy-group: search
1553+
x-speakeasy-name-override: enumerate
1554+
security:
1555+
- APIToken: []
14991556
/api/admin/usage/settings:
15001557
get:
15011558
tags:
@@ -9840,72 +9897,13 @@ components:
98409897
content:
98419898
type: string
98429899
minLength: 1
9843-
PlatformChatTextFormat:
9844-
type: object
9845-
additionalProperties: false
9846-
description: Unconstrained plain-text assistant output.
9847-
required:
9848-
- type
9849-
properties:
9850-
type:
9851-
type: string
9852-
description: Discriminator. Must be TEXT.
9853-
enum:
9854-
- TEXT
9855-
PlatformChatJsonSchemaFormat:
9856-
type: object
9857-
additionalProperties: false
9858-
description: Constrains the assistant response to a caller-supplied JSON Schema.
9859-
required:
9860-
- type
9861-
- name
9862-
- schema
9863-
properties:
9864-
type:
9865-
type: string
9866-
description: Discriminator. Must be JSON_SCHEMA.
9867-
enum:
9868-
- JSON_SCHEMA
9869-
name:
9870-
type: string
9871-
minLength: 1
9872-
maxLength: 64
9873-
description: A stable identifier for the schema.
9874-
description:
9875-
type: string
9876-
maxLength: 1024
9877-
description: An optional human-readable description of the schema.
9878-
schema:
9879-
type: object
9880-
additionalProperties: true
9881-
description: A JSON Schema object describing the desired output shape.
9882-
strict:
9883-
type: boolean
9884-
default: true
9885-
description: |
9886-
When true, the provider validates the response against the schema. Unsupported by some providers; defaults to true.
98879900
PlatformChatCreateRequest:
98889901
type: object
98899902
additionalProperties: false
98909903
required:
98919904
- input
98929905
example:
9893-
input: Summarize our parental leave policy as JSON.
9894-
text:
9895-
format:
9896-
type: JSON_SCHEMA
9897-
name: policy_summary
9898-
schema:
9899-
type: object
9900-
properties:
9901-
eligible_employees:
9902-
type: string
9903-
duration_weeks:
9904-
type: integer
9905-
required:
9906-
- eligible_employees
9907-
- duration_weeks
9908-
strict: true
9906+
input: Summarize our parental leave policy.
99099907
properties:
99109908
input:
99119909
description: |
@@ -9932,18 +9930,6 @@ components:
99329930
minLength: 1
99339931
description: |
99349932
Continue an existing stored conversation. Incompatible with message-array `input` and with `store: false`.
9935-
text:
9936-
type: object
9937-
additionalProperties: false
9938-
description: |
9939-
Optional configuration for the assistant's text response. When `format.type` is `JSON_SCHEMA`, the response is constrained to the supplied JSON schema and returned in `output[*].content[*].structured_output`. Structured output is not supported when `stream` is true.
9940-
properties:
9941-
format:
9942-
description: |
9943-
Output format for the assistant text. TEXT is unconstrained. JSON_SCHEMA constrains the response to the supplied schema.
9944-
oneOf:
9945-
- $ref: "#/components/schemas/PlatformChatTextFormat"
9946-
- $ref: "#/components/schemas/PlatformChatJsonSchemaFormat"
99479933
PlatformChatStreamResponseId:
99489934
type: string
99499935
minLength: 1
@@ -9963,12 +9949,6 @@ components:
99639949
- OUTPUT_TEXT
99649950
text:
99659951
type: string
9966-
structured_output:
9967-
type:
9968-
- object
9969-
- "null"
9970-
description: |
9971-
Parsed and validated JSON object when structured output was requested. Present only when the request included `text.format.type: JSON_SCHEMA`.
99729952
annotations:
99739953
type: array
99749954
items:
@@ -11144,6 +11124,158 @@ components:
1114411124
type: string
1114511125
minLength: 1
1114611126
description: Platform-generated request ID for support correlation.
11127+
PlatformSearchEnumerationInclude:
11128+
type: string
11129+
description: Optional document reference projection.
11130+
enum:
11131+
- SNIPPETS
11132+
x-enumDescriptions:
11133+
SNIPPETS: Add snippets, query-relevant plain-text excerpts from the document body. Only produced when `query` is present; a scope-only scan has nothing to excerpt.
11134+
x-speakeasy-enum-descriptions:
11135+
SNIPPETS: Add snippets, query-relevant plain-text excerpts from the document body. Only produced when `query` is present; a scope-only scan has nothing to excerpt.
11136+
PlatformSearchEnumerationRequest:
11137+
type: object
11138+
additionalProperties: false
11139+
description: |
11140+
Selection to enumerate. At least one of `datasources`, `query`, or `filters` must be set.
11141+
example:
11142+
query: amoxicillin
11143+
datasources:
11144+
- gdrive
11145+
page_size: 500
11146+
properties:
11147+
query:
11148+
type: string
11149+
minLength: 1
11150+
description: |
11151+
The search query string. Supports inline operators such as `from:jane type:document app:confluence`. Inline operators are AND'd with structured `filters`.
11152+
datasources:
11153+
type: array
11154+
minItems: 1
11155+
items:
11156+
type: string
11157+
minLength: 1
11158+
description: |
11159+
Restrict results to specific datasource identifiers returned by `GET /api/search/filters`. Scopes by datasource type and may include results from multiple instances of that type. Omit to enumerate across all visible datasources matching `query` or `filters`.
11160+
filters:
11161+
type: array
11162+
minItems: 1
11163+
items:
11164+
$ref: "#/components/schemas/PlatformFilter"
11165+
description: |
11166+
Structured filters applied to search results. Multiple values within a filter with `EQUALS` are OR'd; separate filters are AND'd. Conflicting constraints on the same field (for example, `type:document` in `query` and `type:spreadsheet` in a filter) return an empty result set. See `Filter.field` for built-in field names and operators. Other nonblank field names are accepted as custom filters without validation; behavior depends on your connected sources.
11167+
time_range:
11168+
$ref: "#/components/schemas/PlatformTimeRange"
11169+
page_size:
11170+
type: integer
11171+
minimum: 1
11172+
maximum: 1000
11173+
default: 100
11174+
description: Number of results to return per page.
11175+
cursor:
11176+
type:
11177+
- string
11178+
- "null"
11179+
description: |
11180+
Opaque pagination token from a previous response's `next_cursor` field. Omit on the first request. Cursors do not expire and are valid only for the original selection.
11181+
include:
11182+
type: array
11183+
minItems: 1
11184+
uniqueItems: true
11185+
items:
11186+
$ref: "#/components/schemas/PlatformSearchEnumerationInclude"
11187+
description: |
11188+
Optional field groups to add to each document reference. Each value only adds fields; it does not change which documents are returned.
11189+
PlatformDocumentReference:
11190+
type: object
11191+
additionalProperties: false
11192+
required:
11193+
- document_id
11194+
- url
11195+
- title
11196+
- datasource
11197+
properties:
11198+
document_id:
11199+
type: string
11200+
minLength: 1
11201+
description: |
11202+
Indexed Glean store ID. Stable identity for deduplication and the selector accepted by `POST /api/documents/batch`.
11203+
example: doc_123
11204+
url:
11205+
type: string
11206+
format: uri
11207+
minLength: 1
11208+
description: Canonical URL of the result.
11209+
example: https://docs.google.com/spreadsheets/d/abc
11210+
title:
11211+
type: string
11212+
minLength: 1
11213+
description: Display title. For a conversation, this is a title built from the participants, such as "Alice and Bob", including when the indexed title is the message body. When the result has no title, the server returns Untitled.
11214+
example: Amoxicillin inventory
11215+
datasource:
11216+
type: string
11217+
minLength: 1
11218+
description: The datasource this result originates from.
11219+
example: gdrive
11220+
document_type:
11221+
type:
11222+
- string
11223+
- "null"
11224+
minLength: 1
11225+
description: The document type within the datasource.
11226+
example: spreadsheet
11227+
creator:
11228+
$ref: "#/components/schemas/PlatformPersonReference"
11229+
owner:
11230+
$ref: "#/components/schemas/PlatformPersonReference"
11231+
updated_at:
11232+
type:
11233+
- string
11234+
- "null"
11235+
format: date-time
11236+
description: When the result was last modified.
11237+
created_at:
11238+
type:
11239+
- string
11240+
- "null"
11241+
format: date-time
11242+
description: When the result was created.
11243+
snippets:
11244+
type: array
11245+
items:
11246+
type: string
11247+
minLength: 1
11248+
description: |
11249+
Query-relevant plain-text excerpts from the document body. Present only when the request's `include` contains `SNIPPETS` and `query` is set.
11250+
example:
11251+
- Amoxicillin 500mg inventory was last counted on...
11252+
PlatformSearchEnumerationResponse:
11253+
type: object
11254+
additionalProperties: false
11255+
required:
11256+
- results
11257+
- has_more
11258+
- next_cursor
11259+
- request_id
11260+
properties:
11261+
results:
11262+
type: array
11263+
items:
11264+
$ref: "#/components/schemas/PlatformDocumentReference"
11265+
description: Document references at this cursor position.
11266+
has_more:
11267+
type: boolean
11268+
description: Indicates whether additional pages of results are available.
11269+
next_cursor:
11270+
type:
11271+
- string
11272+
- "null"
11273+
description: |
11274+
Opaque token to pass as `cursor` in the next request. Null exactly when `has_more` is false.
11275+
request_id:
11276+
type: string
11277+
minLength: 1
11278+
description: Platform-generated request ID for support correlation.
1114711279
PlatformPerMemberSettings:
1114811280
type: object
1114911281
additionalProperties: false
@@ -14288,6 +14420,8 @@ components:
1428814420
- CONVERTED_TO_DRAFT
1428914421
- WEBHOOK_UPDATED
1429014422
- WEBHOOK_CREATED
14423+
- CLOSED
14424+
- COMMENT_ADDED
1429114425
x-enumDescriptions:
1429214426
CREATED: The document was created.
1429314427
UPDATED: The document was updated.
@@ -14303,6 +14437,8 @@ components:
1430314437
CONVERTED_TO_DRAFT: The item was converted back to a draft.
1430414438
WEBHOOK_UPDATED: The source system sent a webhook update.
1430514439
WEBHOOK_CREATED: The source system sent a webhook creation event.
14440+
CLOSED: The item was closed.
14441+
COMMENT_ADDED: A comment was added to the item.
1430614442
x-speakeasy-enum-descriptions:
1430714443
CREATED: The document was created.
1430814444
UPDATED: The document was updated.
@@ -14318,6 +14454,8 @@ components:
1431814454
CONVERTED_TO_DRAFT: The item was converted back to a draft.
1431914455
WEBHOOK_UPDATED: The source system sent a webhook update.
1432014456
WEBHOOK_CREATED: The source system sent a webhook creation event.
14457+
CLOSED: The item was closed.
14458+
COMMENT_ADDED: A comment was added to the item.
1432114459
PlatformTriggerEvent:
1432214460
type: object
1432314461
required:

0 commit comments

Comments
 (0)