Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
136 changes: 98 additions & 38 deletions .speakeasy/gen.lock

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion .speakeasy/gen.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ generation:
generateNewTests: true
skipResponseBodyAssertions: true
go:
version: 0.13.2
version: 0.13.3
additionalDependencies: {}
allowUnknownFieldsInWeakUnions: false
baseErrorName: GleanError
Expand Down
148 changes: 139 additions & 9 deletions .speakeasy/glean-merged-spec.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@ openapi: 3.0.0
info:
version: "0.9.0"
title: Glean API
x-source-commit-sha: 07b3632b09de332d35eeedd6280e30a1edf95243
x-open-api-commit-sha: 4bc8dc442566ab2952b8e3c7a86fafff9c042aa9
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.
Expand Down Expand Up @@ -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
Expand All @@ -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:
Expand Down Expand Up @@ -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'
Expand All @@ -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:
Expand Down
3 changes: 0 additions & 3 deletions .speakeasy/tests.arazzo.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -164657,9 +164657,6 @@ workflows:
requestBody:
contentType: application/json
payload:
datasource_instances:
- slack_acme
- slack_eu
datasources:
- confluence
- google_drive
Expand Down
12 changes: 6 additions & 6 deletions .speakeasy/workflow.lock
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
speakeasyVersion: 1.789.0
speakeasyVersion: 1.789.2
sources:
Glean API:
sourceNamespace: glean-api-specs
sourceRevisionDigest: sha256:eaebe7be5b8f0f68b1331b223088ad140bf7caa28b87534a807a902b82f0e715
sourceBlobDigest: sha256:fdd2d2ee23d11786186f25ae9270c19355398694eb3aedbfe02e7687c9e8c2e3
sourceRevisionDigest: sha256:145236c33451e6e87cf1507a4d8829678b0df02af59afc9341330627e33ed760
sourceBlobDigest: sha256:862b1370a65d146eac83f86c6fbd2d787f04ea93c2cf28259af5ded934f9fb3b
tags:
- latest
petstore-oas:
Expand All @@ -17,10 +17,10 @@ targets:
glean:
source: Glean API
sourceNamespace: glean-api-specs
sourceRevisionDigest: sha256:eaebe7be5b8f0f68b1331b223088ad140bf7caa28b87534a807a902b82f0e715
sourceBlobDigest: sha256:fdd2d2ee23d11786186f25ae9270c19355398694eb3aedbfe02e7687c9e8c2e3
sourceRevisionDigest: sha256:145236c33451e6e87cf1507a4d8829678b0df02af59afc9341330627e33ed760
sourceBlobDigest: sha256:862b1370a65d146eac83f86c6fbd2d787f04ea93c2cf28259af5ded934f9fb3b
codeSamplesNamespace: glean-api-specs-go-code-samples
codeSamplesRevisionDigest: sha256:e33e590a1c2fd20f43edf50e39adc6217f26e1627bcc7a06f4907c77a120c261
codeSamplesRevisionDigest: sha256:90941ca05c5c8e8a7acfa165b3674411f1c712692e4e071afecb72791b282a07
petstore:
source: petstore-oas
sourceNamespace: petstore-oas
Expand Down
12 changes: 11 additions & 1 deletion RELEASES.md
Original file line number Diff line number Diff line change
Expand Up @@ -788,4 +788,14 @@ Based on:
### Generated
- [go v0.13.2] .
### Releases
- [Go v0.13.2] https://github.com/gleanwork/api-client-go/releases/tag/v0.13.2 - .
- [Go v0.13.2] https://github.com/gleanwork/api-client-go/releases/tag/v0.13.2 - .

## 2026-07-10 16:28:59
### Changes
Based on:
- OpenAPI Doc
- Speakeasy CLI 1.789.2 (2.916.4) https://github.com/speakeasy-api/speakeasy
### Generated
- [go v0.13.3] .
### Releases
- [Go v0.13.3] https://github.com/gleanwork/api-client-go/releases/tag/v0.13.3 - .
11 changes: 11 additions & 0 deletions docs/models/components/actionpreview.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
# ActionPreview

Preview information for an action being executed.


## Fields

| Field | Type | Required | Description |
| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
| `Markdown` | `*string` | :heavy_minus_sign: | Markdown preview describing what the action will do. |
| `Description` | `*string` | :heavy_minus_sign: | Short summary of what this specific tool invocation will do. |
11 changes: 11 additions & 0 deletions docs/models/components/authcontext.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
# AuthContext

Context for authentication responses, containing identifiers for the entity being authenticated.



## Fields

| Field | Type | Required | Description |
| ------------------------------------------------------ | ------------------------------------------------------ | ------------------------------------------------------ | ------------------------------------------------------ |
| `ServerID` | `*string` | :heavy_minus_sign: | ID of the MCP server (populated when toolType is MCP). |
Loading
Loading