Skip to content
Open
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
142 changes: 101 additions & 41 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 @@ -34,7 +34,7 @@ generation:
generateNewTests: true
skipResponseBodyAssertions: true
python:
version: 0.15.2
version: 0.15.3
additionalDependencies:
dev: {}
main: {}
Expand Down
131 changes: 129 additions & 2 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: 1ccc408fdb2c210e136239b5b42a53c7b9b4abe5
x-open-api-commit-sha: 1bf9887187c8200b2881b1768fc50ae4fae41796
x-source-commit-sha: fd51f322986505d36d473efdfbad36ea6d22ce4c
x-open-api-commit-sha: a2c64d9bc434d05f1cc0e0ae0522a9b968e99a20
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 @@ -9713,6 +9713,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 +9853,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
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.1
sources:
Glean API:
sourceNamespace: glean-api-specs
sourceRevisionDigest: sha256:38135f10206267ef24935fe6f997edba535c1d95313a1bfd30066f791e2f692b
sourceBlobDigest: sha256:cabd9d3d8eb34d9f7324632354255e5b224c05443dd6f8f27094c47cd4839d01
sourceRevisionDigest: sha256:2f127189ab6d415266cc0873c7e4158b6a3c467bafae808f258c476396ef2e6e
sourceBlobDigest: sha256:27fd341b0356e9639e96d41be4241c84f546199a326345d9ae4e39b98600dae5
tags:
- latest
Glean Client API:
Expand All @@ -16,10 +16,10 @@ targets:
glean:
source: Glean API
sourceNamespace: glean-api-specs
sourceRevisionDigest: sha256:38135f10206267ef24935fe6f997edba535c1d95313a1bfd30066f791e2f692b
sourceBlobDigest: sha256:cabd9d3d8eb34d9f7324632354255e5b224c05443dd6f8f27094c47cd4839d01
sourceRevisionDigest: sha256:2f127189ab6d415266cc0873c7e4158b6a3c467bafae808f258c476396ef2e6e
sourceBlobDigest: sha256:27fd341b0356e9639e96d41be4241c84f546199a326345d9ae4e39b98600dae5
codeSamplesNamespace: glean-api-specs-python-code-samples
codeSamplesRevisionDigest: sha256:0c2ffb1bbb551c0718176c53dd5fdd322c6c78ec6ab0979f9469cfef459b051e
codeSamplesRevisionDigest: sha256:8726ce28b72322240104d29333947a14ebd3c1b5963dbe4816cf74d9bbc21875
workflow:
workflowVersion: 1.0.0
speakeasyVersion: latest
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
- [python v0.15.2] .
### Releases
- [PyPI v0.15.2] https://pypi.org/project/glean-api-client/0.15.2 - .
- [PyPI v0.15.2] https://pypi.org/project/glean-api-client/0.15.2 - .

## 2026-07-10 03:24:27
### Changes
Based on:
- OpenAPI Doc
- Speakeasy CLI 1.789.1 (2.916.4) https://github.com/speakeasy-api/speakeasy
### Generated
- [python v0.15.3] .
### Releases
- [PyPI v0.15.3] https://pypi.org/project/glean-api-client/0.15.3 - .
11 changes: 11 additions & 0 deletions docs/models/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` | *Optional[str]* | :heavy_minus_sign: | Markdown preview describing what the action will do. |
| `description` | *Optional[str]* | :heavy_minus_sign: | Short summary of what this specific tool invocation will do. |
11 changes: 11 additions & 0 deletions docs/models/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 |
| ------------------------------------------------------ | ------------------------------------------------------ | ------------------------------------------------------ | ------------------------------------------------------ |
| `server_id` | *Optional[str]* | :heavy_minus_sign: | ID of the MCP server (populated when toolType is MCP). |
Loading
Loading