Merge branch 'ch-session-resumption' of https://github.com/firebase/firebase-js-sdk into ch-session-resumption

hsubox76 · hsubox76 · commit b2b8460acfaa · 2026-04-23T11:32:29.000-07:00
diff --git a/docs-devsite/ai.livesession.md b/docs-devsite/ai.livesession.md
@@ -29,7 +29,7 @@ export declare class LiveSession
 
 |  Property | Modifiers | Type | Description |
 |  --- | --- | --- | --- |
-|  [connectionPromise](./ai.livesession.md#livesessionconnectionpromise) |  | Promise&lt;void&gt; | <b><i>(Public Preview)</i></b> Allows external code to await the opening of the websocket connection. |
+|  [connectionPromise](./ai.livesession.md#livesessionconnectionpromise) |  | Promise&lt;void&gt; | <b><i>(Public Preview)</i></b> Allows external code to await the opening of the WebSocket connection. |
 |  [inConversation](./ai.livesession.md#livesessioninconversation) |  | boolean | <b><i>(Public Preview)</i></b> Indicates whether this Live session is being controlled by an <code>AudioConversationController</code>. |
 |  [isClosed](./ai.livesession.md#livesessionisclosed) |  | boolean | <b><i>(Public Preview)</i></b> Indicates whether this Live session is closed. |
 
@@ -53,7 +53,7 @@ export declare class LiveSession
 > This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
 > 
 
-Allows external code to await the opening of the websocket connection.
+Allows external code to await the opening of the WebSocket connection.
 
 <b>Signature:</b>
 
diff --git a/docs-devsite/ai.segment.md b/docs-devsite/ai.segment.md
@@ -24,7 +24,7 @@ export interface Segment
 |  --- | --- | --- |
 |  [endIndex](./ai.segment.md#segmentendindex) | number | The zero-based end index of the segment within the specified <code>Part</code>, measured in UTF-8 bytes. This offset is exclusive, meaning the character at this index is not included in the segment. |
 |  [partIndex](./ai.segment.md#segmentpartindex) | number | The zero-based index of the [Part](./ai.md#part) object within the <code>parts</code> array of its parent [Content](./ai.content.md#content_interface) object. This identifies which part of the content the segment belongs to. |
-|  [startIndex](./ai.segment.md#segmentstartindex) | number | The zero-based start index of the segment within the specified <code>Part</code>, measured in UTF-8 bytes. This offset is inclusive, starting from 0 at the beginning of the part's content (e.g., <code>Part.text</code>). |
+|  [startIndex](./ai.segment.md#segmentstartindex) | number | The zero-based start index of the segment within the specified <code>Part</code>, measured in UTF-8 bytes. This offset is inclusive, starting from 0 at the beginning of the part's content (for example, <code>Part.text</code>). |
 |  [text](./ai.segment.md#segmenttext) | string | The text corresponding to the segment from the response. |
 
 ## Segment.endIndex
@@ -49,7 +49,7 @@ partIndex: number;
 
 ## Segment.startIndex
 
-The zero-based start index of the segment within the specified `Part`<!-- -->, measured in UTF-8 bytes. This offset is inclusive, starting from 0 at the beginning of the part's content (e.g., `Part.text`<!-- -->).
+The zero-based start index of the segment within the specified `Part`<!-- -->, measured in UTF-8 bytes. This offset is inclusive, starting from 0 at the beginning of the part's content (for example, `Part.text`<!-- -->).
 
 <b>Signature:</b>
 
diff --git a/docs-devsite/ai.slidingwindow.md b/docs-devsite/ai.slidingwindow.md
@@ -15,7 +15,7 @@ https://github.com/firebase/firebase-js-sdk
 
 Configures the sliding window context compression mechanism.
 
-The context window will be truncated by keeping only a suffix of it.
+The sliding window discards content at the beginning of the context window. The resulting context will always begin at the start of a `user` role turn. System instructions will always remain at the start of the result.
 
 <b>Signature:</b>
 
@@ -27,14 +27,14 @@ export interface SlidingWindow
 
 |  Property | Type | Description |
 |  --- | --- | --- |
-|  [targetTokens](./ai.slidingwindow.md#slidingwindowtargettokens) | number | <b><i>(Public Preview)</i></b> The session reduction target, i.e., how many tokens we should keep. |
+|  [targetTokens](./ai.slidingwindow.md#slidingwindowtargettokens) | number | <b><i>(Public Preview)</i></b> The session reduction target, for example, how many tokens the model should keep. |
 
 ## SlidingWindow.targetTokens
 
 > This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
 > 
 
-The session reduction target, i.e., how many tokens we should keep.
+The session reduction target, for example, how many tokens the model should keep.
 
 <b>Signature:</b>
 
diff --git a/packages/ai/src/methods/live-session.ts b/packages/ai/src/methods/live-session.ts
@@ -62,15 +62,15 @@ export class LiveSession {
    */
   inConversation = false;
   /**
-   * Allows external code to await the opening of the websocket connection.
+   * Allows external code to await the opening of the WebSocket connection.
    */
   connectionPromise: Promise<void>;
   /**
-   * Generator yielding websocket messages from the server.
+   * Generator yielding WebSocket messages from the server.
    */
   private _serverMessages: AsyncGenerator<unknown> | null = null;
   /**
-   * Websocket handler. Injectable for testing.
+   * WebSocket handler. Injectable for testing.
    */
   private _webSocketHandler: WebSocketHandler;
 
@@ -88,7 +88,7 @@ export class LiveSession {
   }
 
   /**
-   * Initializes connection to the websocket. Should be called immediately
+   * Initializes connection to the WebSocket. Should be called immediately
    * after instantiation.
    *
    * @internal
diff --git a/packages/ai/src/types/requests.ts b/packages/ai/src/types/requests.ts
@@ -215,13 +215,17 @@ export interface LiveGenerationConfig {
  * Configures the sliding window context compression mechanism.
  *
  * @remarks
- * The context window will be truncated by keeping only a suffix of it.
+ * The sliding window discards content at the beginning of the
+ * context window. The resulting context will always begin at
+ * the start of a `user` role turn. System instructions
+ * will always remain at the start of the result.
  *
  * @beta
  */
 export interface SlidingWindow {
   /**
-   * The session reduction target, i.e., how many tokens we should keep.
+   * The session reduction target, for example, how many tokens the model
+   * should keep.
    */
   targetTokens?: number;
 }
diff --git a/packages/ai/src/types/responses.ts b/packages/ai/src/types/responses.ts
@@ -362,7 +362,7 @@ export interface Segment {
   /**
    * The zero-based start index of the segment within the specified `Part`,
    * measured in UTF-8 bytes. This offset is inclusive, starting from 0 at the
-   * beginning of the part's content (e.g., `Part.text`).
+   * beginning of the part's content (for example, `Part.text`).
    */
   startIndex: number;
   /**
