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
+143-4Lines changed: 143 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: The ID of the chat that contains the chat file.
7561
7605
GetChatFilesResponse:
7562
7606
properties:
7563
7607
files:
@@ -7808,9 +7852,12 @@ components:
7808
7852
- NO_PERMISSIONS
7809
7853
CreateCollectionResponse:
7810
7854
allOf:
7811
-
- $ref: "#/components/schemas/Collection"
7812
-
- $ref: "#/components/schemas/CollectionError"
7813
7855
- type: object
7856
+
anyOf:
7857
+
- required:
7858
+
- collection
7859
+
- required:
7860
+
- error
7814
7861
properties:
7815
7862
collection:
7816
7863
$ref: "#/components/schemas/Collection"
@@ -9153,6 +9200,7 @@ components:
9153
9200
- ZERO_STATE_WORKFLOW_POPULAR
9154
9201
- ZERO_STATE_WORKFLOW_SUGGESTION
9155
9202
- PERSONALIZED_CHAT_SUGGESTION
9203
+
- DAILY_DIGEST
9156
9204
description: Categories of content requested. An allowlist gives flexibility to request content separately or together.
9157
9205
requestOptions:
9158
9206
$ref: "#/components/schemas/FeedRequestOptions"
@@ -9308,6 +9356,91 @@ components:
9308
9356
type: array
9309
9357
items:
9310
9358
$ref: "#/components/schemas/GeneratedAttachment"
9359
+
SectionType:
9360
+
type: string
9361
+
description: Type of the section. This defines how the section should be interpreted and rendered in the digest.
9362
+
x-enumDescriptions:
9363
+
CHANNEL: A standard section for channel-based digests (e.g. from Slack, Teams).
9364
+
MENTIONS: A dedicated section that surfaces user mentions (actionable, informative, or all).
9365
+
TOPIC: A section driven by a generic topic, not tied to any specific channel or instance.
9366
+
enum:
9367
+
- CHANNEL
9368
+
- MENTIONS
9369
+
- TOPIC
9370
+
UpdateType:
9371
+
type: string
9372
+
description: Optional type classification for the update.
9373
+
x-enumDescriptions:
9374
+
ACTIONABLE: Updates that require user attention or action
9375
+
INFORMATIVE: Updates that are purely informational
9376
+
enum:
9377
+
- ACTIONABLE
9378
+
- INFORMATIVE
9379
+
DigestUpdate:
9380
+
type: object
9381
+
properties:
9382
+
url:
9383
+
type: string
9384
+
description: URL link to the content or document.
9385
+
title:
9386
+
type: string
9387
+
description: Title or headline of the update.
9388
+
datasource:
9389
+
type: string
9390
+
description: Name or identifier of the data source (e.g., slack, confluence, etc.).
9391
+
summary:
9392
+
type: string
9393
+
description: Brief summary or description of the update content.
9394
+
type:
9395
+
$ref: "#/components/schemas/UpdateType"
9396
+
DigestSection:
9397
+
type: object
9398
+
required:
9399
+
- id
9400
+
- type
9401
+
- updates
9402
+
properties:
9403
+
id:
9404
+
type: string
9405
+
description: Unique identifier for the digest section.
9406
+
type:
9407
+
$ref: "#/components/schemas/SectionType"
9408
+
displayName:
9409
+
type: string
9410
+
description: Human-readable name for the digest section.
9411
+
channelName:
9412
+
type: string
9413
+
description: Name of the channel (applicable for CHANNEL type sections). Used to display in the frontend.
9414
+
instanceId:
9415
+
type: string
9416
+
description: Instance identifier for the channel or workspace. Used for constructing channel URLs to display in the frontend.
9417
+
url:
9418
+
type: string
9419
+
description: Optional URL for the digest section. Should be populated only if the section is a CHANNEL type section.
9420
+
updates:
9421
+
type: array
9422
+
items:
9423
+
$ref: "#/components/schemas/DigestUpdate"
9424
+
description: List of updates within this digest section.
9425
+
Digest:
9426
+
type: object
9427
+
properties:
9428
+
podcastFileId:
9429
+
type: string
9430
+
description: Identifier for the podcast file generated from this digest content.
9431
+
podcastDuration:
9432
+
type: number
9433
+
format: float
9434
+
description: Duration of the podcast file in seconds.
9435
+
digestDate:
9436
+
type: string
9437
+
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.
9438
+
example: "2025-09-03"
9439
+
sections:
9440
+
type: array
9441
+
items:
9442
+
$ref: "#/components/schemas/DigestSection"
9443
+
description: Array of digest sections from which the podcast was created.
9311
9444
ChatSuggestion:
9312
9445
properties:
9313
9446
query:
@@ -9530,6 +9663,7 @@ components:
9530
9663
- ZERO_STATE_STATIC_WORKFLOW_SUGGESTION
9531
9664
- ZERO_STATE_AGENT_SUGGESTION
9532
9665
- PERSONALIZED_CHAT_SUGGESTION
9666
+
- DAILY_DIGEST
9533
9667
description: Type of the justification.
9534
9668
justification:
9535
9669
type: string
@@ -9546,6 +9680,8 @@ components:
9546
9680
$ref: "#/components/schemas/CalendarEvent"
9547
9681
announcement:
9548
9682
$ref: "#/components/schemas/Announcement"
9683
+
digest:
9684
+
$ref: "#/components/schemas/Digest"
9549
9685
collection:
9550
9686
$ref: "#/components/schemas/Collection"
9551
9687
collectionItem:
@@ -9598,6 +9734,7 @@ components:
9598
9734
- ZERO_STATE_WORKFLOW_POPULAR
9599
9735
- ZERO_STATE_WORKFLOW_SUGGESTION
9600
9736
- PERSONALIZED_CHAT_SUGGESTION
9737
+
- DAILY_DIGEST
9601
9738
description: Category of the result, one of the requested categories in incoming request.
9602
9739
primaryEntry:
9603
9740
$ref: "#/components/schemas/FeedEntry"
@@ -11595,6 +11732,7 @@ components:
11595
11732
- EXTERNAL_SHORTCUT
11596
11733
- ENTITY
11597
11734
- CALENDAR
11735
+
- AGENTS
11598
11736
description: The document category of this object type.
11599
11737
propertyDefinitions:
11600
11738
type: array
@@ -11649,6 +11787,7 @@ components:
11649
11787
- EXTERNAL_SHORTCUT
11650
11788
- ENTITY
11651
11789
- CALENDAR
11790
+
- AGENTS
11652
11791
default: UNCATEGORIZED
11653
11792
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