You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .speakeasy/glean-merged-spec.yaml
+140-4Lines changed: 140 additions & 4 deletions
Original file line number
Diff line number
Diff line change
@@ -4261,18 +4261,28 @@ components:
4261
4261
tokenType: Bearer
4262
4262
authUser: "1"
4263
4263
DocumentSpec:
4264
+
x-multiple-discriminators: true
4264
4265
oneOf:
4265
4266
- type: object
4267
+
required:
4268
+
- url
4266
4269
properties:
4267
4270
url:
4268
4271
type: string
4272
+
x-discriminator: true
4269
4273
description: The URL of the document.
4270
4274
- type: object
4275
+
required:
4276
+
- id
4271
4277
properties:
4272
4278
id:
4273
4279
type: string
4280
+
x-discriminator: true
4274
4281
description: The ID of the document.
4275
4282
- type: object
4283
+
required:
4284
+
- contentId
4285
+
- ugcType
4276
4286
properties:
4277
4287
ugcType:
4278
4288
type: string
@@ -4281,10 +4291,33 @@ components:
4281
4291
- ANSWERS
4282
4292
- COLLECTIONS
4283
4293
- SHORTCUTS
4294
+
- CHATS
4284
4295
description: The type of the user generated content (UGC datasource).
4285
4296
contentId:
4286
4297
type: integer
4287
-
description: The id for user generated content.
4298
+
x-discriminator: true
4299
+
description: The numeric id for user generated content. Used for ANNOUNCEMENTS, ANSWERS, COLLECTIONS, SHORTCUTS.
4300
+
docType:
4301
+
type: string
4302
+
description: The specific type of the user generated content type.
4303
+
- type: object
4304
+
required:
4305
+
- ugcType
4306
+
- ugcId
4307
+
properties:
4308
+
ugcType:
4309
+
type: string
4310
+
enum:
4311
+
- ANNOUNCEMENTS
4312
+
- ANSWERS
4313
+
- COLLECTIONS
4314
+
- SHORTCUTS
4315
+
- CHATS
4316
+
description: The type of the user generated content (UGC datasource).
4317
+
ugcId:
4318
+
type: string
4319
+
x-discriminator: true
4320
+
description: The string id for user generated content. Used for CHATS.
4288
4321
docType:
4289
4322
type: string
4290
4323
description: The specific type of the user generated content type.
@@ -7287,7 +7320,7 @@ components:
7287
7320
additionalProperties:
7288
7321
$ref: "#/components/schemas/WriteActionParameter"
7289
7322
ChatMessageFragment:
7290
-
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, or file.
7323
+
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 or file.
7291
7324
allOf:
7292
7325
- $ref: "#/components/schemas/Result"
7293
7326
- type: object
@@ -7354,6 +7387,7 @@ components:
7354
7387
ERROR: A message that describes an error while processing the request.
7355
7388
HEADING: A heading message used to distinguish different sections of the holistic response.
7356
7389
WARNING: A warning message to be shown to the user.
7390
+
SERVER_TOOL: A message used to for server-side tool auth/use, for request and response.
7357
7391
enum:
7358
7392
- UPDATE
7359
7393
- CONTENT
@@ -7363,6 +7397,7 @@ components:
7363
7397
- ERROR
7364
7398
- HEADING
7365
7399
- WARNING
7400
+
- SERVER_TOOL
7366
7401
hasMoreFragments:
7367
7402
deprecated: true
7368
7403
type: boolean
@@ -7489,12 +7524,18 @@ components:
7489
7524
description: A historical representation of a series of chat messages a user had with Glean Assistant.
description: Categories of content requested. An allowlist gives flexibility to request content separately or together.
9157
9202
requestOptions:
9158
9203
$ref: "#/components/schemas/FeedRequestOptions"
@@ -9308,6 +9353,91 @@ components:
9308
9353
type: array
9309
9354
items:
9310
9355
$ref: "#/components/schemas/GeneratedAttachment"
9356
+
SectionType:
9357
+
type: string
9358
+
description: Type of the section. This defines how the section should be interpreted and rendered in the digest.
9359
+
x-enumDescriptions:
9360
+
CHANNEL: A standard section for channel-based digests (e.g. from Slack, Teams).
9361
+
MENTIONS: A dedicated section that surfaces user mentions (actionable, informative, or all).
9362
+
TOPIC: A section driven by a generic topic, not tied to any specific channel or instance.
9363
+
enum:
9364
+
- CHANNEL
9365
+
- MENTIONS
9366
+
- TOPIC
9367
+
UpdateType:
9368
+
type: string
9369
+
description: Optional type classification for the update.
9370
+
x-enumDescriptions:
9371
+
ACTIONABLE: Updates that require user attention or action
9372
+
INFORMATIVE: Updates that are purely informational
9373
+
enum:
9374
+
- ACTIONABLE
9375
+
- INFORMATIVE
9376
+
DigestUpdate:
9377
+
type: object
9378
+
properties:
9379
+
url:
9380
+
type: string
9381
+
description: URL link to the content or document.
9382
+
title:
9383
+
type: string
9384
+
description: Title or headline of the update.
9385
+
datasource:
9386
+
type: string
9387
+
description: Name or identifier of the data source (e.g., slack, confluence, etc.).
9388
+
summary:
9389
+
type: string
9390
+
description: Brief summary or description of the update content.
9391
+
type:
9392
+
$ref: "#/components/schemas/UpdateType"
9393
+
DigestSection:
9394
+
type: object
9395
+
required:
9396
+
- id
9397
+
- type
9398
+
- updates
9399
+
properties:
9400
+
id:
9401
+
type: string
9402
+
description: Unique identifier for the digest section.
9403
+
type:
9404
+
$ref: "#/components/schemas/SectionType"
9405
+
displayName:
9406
+
type: string
9407
+
description: Human-readable name for the digest section.
9408
+
channelName:
9409
+
type: string
9410
+
description: Name of the channel (applicable for CHANNEL type sections). Used to display in the frontend.
9411
+
instanceId:
9412
+
type: string
9413
+
description: Instance identifier for the channel or workspace. Used for constructing channel URLs to display in the frontend.
9414
+
url:
9415
+
type: string
9416
+
description: Optional URL for the digest section. Should be populated only if the section is a CHANNEL type section.
9417
+
updates:
9418
+
type: array
9419
+
items:
9420
+
$ref: "#/components/schemas/DigestUpdate"
9421
+
description: List of updates within this digest section.
9422
+
Digest:
9423
+
type: object
9424
+
properties:
9425
+
podcastFileId:
9426
+
type: string
9427
+
description: Identifier for the podcast file generated from this digest content.
9428
+
podcastDuration:
9429
+
type: number
9430
+
format: float
9431
+
description: Duration of the podcast file in seconds.
9432
+
digestDate:
9433
+
type: string
9434
+
description: The date this digest covers, in YYYY-MM-DD format. Represents the specific day for which the digest content and updates were compiled. This can be empty if the digest is not yet available.
9435
+
example: "2025-09-03"
9436
+
sections:
9437
+
type: array
9438
+
items:
9439
+
$ref: "#/components/schemas/DigestSection"
9440
+
description: Array of digest sections from which the podcast was created.
9311
9441
ChatSuggestion:
9312
9442
properties:
9313
9443
query:
@@ -9530,6 +9660,7 @@ components:
9530
9660
- ZERO_STATE_STATIC_WORKFLOW_SUGGESTION
9531
9661
- ZERO_STATE_AGENT_SUGGESTION
9532
9662
- PERSONALIZED_CHAT_SUGGESTION
9663
+
- DAILY_DIGEST
9533
9664
description: Type of the justification.
9534
9665
justification:
9535
9666
type: string
@@ -9546,6 +9677,8 @@ components:
9546
9677
$ref: "#/components/schemas/CalendarEvent"
9547
9678
announcement:
9548
9679
$ref: "#/components/schemas/Announcement"
9680
+
digest:
9681
+
$ref: "#/components/schemas/Digest"
9549
9682
collection:
9550
9683
$ref: "#/components/schemas/Collection"
9551
9684
collectionItem:
@@ -9598,6 +9731,7 @@ components:
9598
9731
- ZERO_STATE_WORKFLOW_POPULAR
9599
9732
- ZERO_STATE_WORKFLOW_SUGGESTION
9600
9733
- PERSONALIZED_CHAT_SUGGESTION
9734
+
- DAILY_DIGEST
9601
9735
description: Category of the result, one of the requested categories in incoming request.
9602
9736
primaryEntry:
9603
9737
$ref: "#/components/schemas/FeedEntry"
@@ -11595,6 +11729,7 @@ components:
11595
11729
- EXTERNAL_SHORTCUT
11596
11730
- ENTITY
11597
11731
- CALENDAR
11732
+
- AGENTS
11598
11733
description: The document category of this object type.
11599
11734
propertyDefinitions:
11600
11735
type: array
@@ -11649,6 +11784,7 @@ components:
11649
11784
- EXTERNAL_SHORTCUT
11650
11785
- ENTITY
11651
11786
- CALENDAR
11787
+
- AGENTS
11652
11788
default: UNCATEGORIZED
11653
11789
description: The type of this datasource. It is an important signal for relevance and must be specified and cannot be UNCATEGORIZED. Please refer to [this](https://developers.glean.com/docs/indexing_api_datasource_category/) for more details.
Copy file name to clipboardExpand all lines: docs/models/chat.md
+3-1Lines changed: 3 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,4 +15,6 @@ A historical representation of a series of chat messages a user had with Glean A
15
15
|`application_id`|*Optional[str]*|:heavy_minus_sign:| The ID of the AI App that this Chat is associated to. ||
16
16
|`application_name`|*Optional[str]*|:heavy_minus_sign:| The display name of the AI App that this Chat is associated to. ||
17
17
|`icon`|[Optional[models.IconConfig]](../models/iconconfig.md)|:heavy_minus_sign:| Defines how to render an icon | {<br/>"color": "#343CED",<br/>"key": "person_icon",<br/>"iconType": "GLYPH",<br/>"name": "user"<br/>} |
18
-
|`messages`| List[[models.ChatMessage](../models/chatmessage.md)]|:heavy_minus_sign:| The chat messages within a Chat. ||
Copy file name to clipboardExpand all lines: docs/models/chatmessagefragment.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
# ChatMessageFragment
2
2
3
-
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, or file.
3
+
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 or file.
0 commit comments