@maxim_mazurok/gapi.client.chat-v1 0.3.20261019 → 0.3.20261025

package/index.d.ts

@@ -9,7 +9,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 // Generated from: https://chat.googleapis.com/$discovery/rest?version=v1
-// Revision: 20261019
+// Revision: 20261025
 
 /// <reference types="gapi.client" />
 
@@ -234,6 +234,22 @@ declare namespace gapi.client {
       /** The thread of the linked Chat space resource. Format: `spaces/{space}/threads/{thread}` */
       thread?: string;
     }
+    interface Citation {
+      /** Optional. A list of sources that are relevant to the citation. Sources are displayed in the citation hover card. */
+      citedSources?: CitedSource[];
+      /** Required. The ID of the citation. This ID is defined by the app creating the citation and must match the `data-id` attribute of the `` tag in the message text. Must contain only ASCII letters and numbers, and less than 63 characters. */
+      id?: string;
+    }
+    interface CitedSource {
+      /** Optional. Additional information to show alongside the snippet in the form of a footer. */
+      footer?: Footer;
+      /** Optional. Snippet containing information directly from the source. */
+      snippet?: Snippet;
+      /** Required. The plaintext title of the `CitedSource`. Does not support markdown format. */
+      title?: string;
+      /** Required. The URI pointing to the resource referenced by this `CitedSource`. */
+      uri?: string;
+    }
     interface Color {
       /** The fraction of this color that should be applied to the pixel. That is, the final pixel color is defined by the equation: `pixel color = alpha * (this color) + (1.0 - alpha) * (background color)` This means that a value of 1.0 corresponds to a solid color, whereas a value of 0.0 corresponds to a completely transparent color. This uses a wrapper message rather than a simple float scalar so that it is possible to distinguish between a default value and the value being unset. If omitted, this color object is rendered as a solid color (as if the alpha value had been explicitly given a value of 1.0). */
       alpha?: number;
@@ -374,7 +390,7 @@ declare namespace gapi.client {
       user?: User;
     }
     interface Dialog {
-      /** Input only. Body of the dialog, which is rendered in a modal. Google Chat apps don't support the following card entities: `DateTimePicker`, `OnChangeAction`. */
+      /** Input only. Body of the dialog, which is rendered in a modal. */
       body?: GoogleAppsCardV1Card;
     }
     interface DialogAction {
@@ -397,6 +413,16 @@ declare namespace gapi.client {
       /** The mime type of the linked Google Drive resource. */
       mimeType?: string;
     }
+    interface Elements {
+      /** Optional. A list of inline citations referenced within the message text (via `` tags) that render as interactive hover cards. */
+      citations?: Citation[];
+      /** Optional. A list of sources to be displayed under the message as footer links. These are not referenced inline. For inline references, use `citations`. */
+      citedSources?: CitedSource[];
+    }
+    interface ElementsImage {
+      /** Required. The URI of the image. Must be a publicly accessible URI so that Chat can fetch and display it. */
+      imageUri?: string;
+    }
     interface Emoji {
       /** A custom emoji. */
       customEmoji?: CustomEmoji;
@@ -416,6 +442,10 @@ declare namespace gapi.client {
       /** List of spaces in the requested (or first) page. */
       spaces?: Space[];
     }
+    interface Footer {
+      /** Optional. The plaintext to display in the footer. Does not support markdown format. */
+      text?: string;
+    }
     interface FormAction {
       /** The method name is used to identify which part of the form triggered the form submission. This information is echoed back to the Chat app as part of the card click event. You can use the same method name for several elements that trigger a common behavior. */
       actionMethodName?: string;
@@ -543,9 +573,9 @@ declare namespace gapi.client {
       altText?: string;
       /** Whether the chip is in an inactive state and ignores user actions. Defaults to `false`. */
       disabled?: boolean;
-      /** Whether the chip is in an active state and responds to user actions. Defaults to `true`. Deprecated. Use `disabled` instead. */
+      /** Deprecated: Use `disabled` instead. Whether the chip is in an active state and responds to user actions. */
       enabled?: boolean;
-      /** The icon image. If both `icon` and `text` are set, then the icon appears before the text. */
+      /** The icon image. If both `icon` and `label` are set, then the icon appears before the label. */
       icon?: GoogleAppsCardV1Icon;
       /** The text displayed inside the chip. */
       label?: string;
@@ -613,7 +643,7 @@ declare namespace gapi.client {
       name?: string;
       /** Triggered when the user clicks **Save** or **Clear** from the `DateTimePicker` interface. */
       onChangeAction?: GoogleAppsCardV1Action;
-      /** The number representing the time zone offset from UTC, in minutes. If set, the `value_ms_epoch` is displayed in the specified time zone. If unset, the value defaults to the user's time zone setting. */
+      /** The number representing the time zone offset from UTC, in minutes. If set, the `value_ms_epoch` is displayed in the specified time zone. If unset, the value defaults to the user's time zone setting. Note: This field is in minutes, whereas user interaction event payloads typically provide time zone offsets in milliseconds (divide by `60000` to convert). */
       timezoneOffsetDate?: number;
       /** Whether the widget supports inputting a date, a time, or the date and time. */
       type?: 'DATE_AND_TIME' | 'DATE_ONLY' | 'TIME_ONLY';
@@ -633,7 +663,7 @@ declare namespace gapi.client {
       endIcon?: GoogleAppsCardV1Icon;
       /** Deprecated in favor of `startIcon`. */
       icon?: GoogleAppsCardV1Icon;
-      /** This action is triggered when users click `topLabel` or `bottomLabel`. */
+      /** This action is triggered when users click anywhere on the `DecoratedText` widget (including `text`, `top_label`, `bottom_label`, and icons), except when clicking a separate interactive control (`button` or `switch_control`). */
       onClick?: GoogleAppsCardV1OnClick;
       /** The icon displayed in front of the text. */
       startIcon?: GoogleAppsCardV1Icon;
@@ -684,7 +714,7 @@ declare namespace gapi.client {
       columnCount?: number;
       /** The items to display in the grid. */
       items?: GoogleAppsCardV1GridItem[];
-      /** This callback is reused by each individual grid item, but with the item's identifier and index in the items list added to the callback's parameters. */
+      /** This callback is reused by each individual grid item, but with the item's identifier added to the callback's parameters (under the key `"grid_item_identifier"`). */
       onClick?: GoogleAppsCardV1OnClick;
       /** The text that displays in the grid header. */
       title?: string;
@@ -925,9 +955,9 @@ declare namespace gapi.client {
     interface GoogleAppsCardV1Widget {
       /** A list of buttons. For example, the following JSON creates two buttons. The first is a blue text button and the second is an image button that opens a link: ``` "buttonList": { "buttons": [ { "text": "Edit", "color": { "red": 0, "green": 0, "blue": 1, }, "disabled": true, }, { "icon": { "knownIcon": "INVITE", "altText": "check calendar" }, "onClick": { "openLink": { "url": "https://example.com/calendar" } } } ] } ``` */
       buttonList?: GoogleAppsCardV1ButtonList;
-      /** A carousel contains a collection of nested widgets. For example, this is a JSON representation of a carousel that contains two text paragraphs. ``` { "widgets": [ { "textParagraph": { "text": "First text paragraph in the carousel." } }, { "textParagraph": { "text": "Second text paragraph in the carousel." } } ] } ``` */
+      /** Contains a collection of `CarouselCard` items, each of which contains nested widgets. For example, this is a JSON representation of a carousel that contains two carousel cards, each with a text paragraph: ``` { "carouselCards": [ { "widgets": [ { "textParagraph": { "text": "First text paragraph in the carousel." } } ] }, { "widgets": [ { "textParagraph": { "text": "Second text paragraph in the carousel." } } ] } ] } ``` */
       carousel?: GoogleAppsCardV1Carousel;
-      /** A list of chips. For example, the following JSON creates two chips. The first is a text chip and the second is an icon chip that opens a link: ``` "chipList": { "chips": [ { "text": "Edit", "disabled": true, }, { "icon": { "knownIcon": "INVITE", "altText": "check calendar" }, "onClick": { "openLink": { "url": "https://example.com/calendar" } } } ] } ``` */
+      /** A list of chips. For example, the following JSON creates two chips. The first is a text chip and the second is an icon chip that opens a link: ``` "chipList": { "chips": [ { "label": "Edit", "disabled": true }, { "icon": { "knownIcon": "INVITE", "altText": "check calendar" }, "onClick": { "openLink": { "url": "https://example.com/calendar" } } } ] } ``` */
       chipList?: GoogleAppsCardV1ChipList;
       /** Displays up to 2 columns. To include more than 2 columns, or to use rows, use the `Grid` widget. For example, the following JSON creates 2 columns that each contain text paragraphs: ``` "columns": { "columnItems": [ { "horizontalSizeStyle": "FILL_AVAILABLE_SPACE", "horizontalAlignment": "CENTER", "verticalAlignment": "CENTER", "widgets": [ { "textParagraph": { "text": "First column text paragraph" } } ] }, { "horizontalSizeStyle": "FILL_AVAILABLE_SPACE", "horizontalAlignment": "CENTER", "verticalAlignment": "CENTER", "widgets": [ { "textParagraph": { "text": "Second column text paragraph" } } ] } ] } ``` */
       columns?: GoogleAppsCardV1Columns;
@@ -1274,6 +1304,8 @@ declare namespace gapi.client {
       deleteTime?: string;
       /** Output only. Information about a deleted message. A message is deleted when `delete_time` is set. */
       deletionMetadata?: DeletionMetadata;
+      /** Optional. Additional message components, including inline `citations` (where each citation is associated with a specific portion of the message text) and `cited_sources` (which are general references used to generate the response and are not directly linked to specific segments of the text). On input, provide `elements` when creating or updating a message. On output, both `citations` and `cited_sources` are populated when reading a message that contains them. Callers can read structured citation metadata from `elements`, while `formatted_text` also includes inline citation tags or source links depending on `markup_syntax`. These differ from `annotations`, which are output-only and offer supplementary information tied to message fragments or the entire message text. */
+      elements?: Elements;
       /** Output only. The list of emoji reaction summaries on the message. */
       emojiReactionSummaries?: EmojiReactionSummary[];
       /** Optional. A plain-text description of the message's cards, used when the actual cards can't be displayed—for example, mobile notifications. */
@@ -1561,6 +1593,12 @@ declare namespace gapi.client {
       /** The type of slash command. */
       type?: 'TYPE_UNSPECIFIED' | 'ADD' | 'INVOKE';
     }
+    interface Snippet {
+      /** Optional. Image preview of the snippet provided as an input when creating the citation. */
+      imagePreview?: ElementsImage;
+      /** Optional. A short plaintext excerpt directly from the corpus that is rendered in the citation hover card or source preview. When footer sources are automatically populated from inline `citations` (because `Elements.cited_sources` is not set), snippets are omitted from the deduplicated footer sources. Does not support markdown format, and must not exceed 1,000 characters. */
+      text?: string;
+    }
     interface Space {
       /** Optional. Specifies the [access setting](https://support.google.com/chat/answer/11971020) of the space. Only populated when the `space_type` is `SPACE`. */
       accessSettings?: AccessSettings;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxim_mazurok/gapi.client.chat-v1",
-  "version": "0.3.20261019",
+  "version": "0.3.20261025",
   "description": "TypeScript typings for Google Chat API v1",
   "repository": {
     "type": "git",