@firebase/ai 2.7.0-canary.817151ee9 → 2.7.0-canary.b10a296fa

package/dist/src/constants.d.ts

@@ -21,6 +21,7 @@ export declare const STAGING_URL = "https://staging-firebasevertexai.sandbox.goo
 export declare const DEFAULT_API_VERSION = "v1beta";
 export declare const PACKAGE_VERSION: string;
 export declare const LANGUAGE_TAG = "gl-js";
+export declare const HYBRID_TAG = "hybrid";
 export declare const DEFAULT_FETCH_TIMEOUT_MS: number;
 /**
  * Defines the name of the default in-cloud model to use for hybrid inference.

package/dist/src/methods/live-session.d.ts

@@ -14,7 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { FunctionResponse, GenerativeContentBlob, LiveServerContent, LiveServerToolCall, LiveServerToolCallCancellation, Part } from '../public-types';
+import { FunctionResponse, GenerativeContentBlob, LiveServerContent, LiveServerGoingAwayNotice, LiveServerToolCall, LiveServerToolCallCancellation, Part } from '../public-types';
 import { WebSocketHandler } from '../websocket';
 /**
  * Represents an active, real-time, bidirectional conversation with the model.
@@ -121,7 +121,7 @@ export declare class LiveSession {
      *
      * @beta
      */
-    receive(): AsyncGenerator<LiveServerContent | LiveServerToolCall | LiveServerToolCallCancellation>;
+    receive(): AsyncGenerator<LiveServerContent | LiveServerToolCall | LiveServerToolCallCancellation | LiveServerGoingAwayNotice>;
     /**
      * Closes this session.
      * All methods on this session will throw an error once this resolves.

package/dist/src/types/content.d.ts

@@ -138,7 +138,7 @@ export interface FileDataPart {
 /**
  * Represents the code that is executed by the model.
  *
- * @beta
+ * @public
  */
 export interface ExecutableCodePart {
     text?: never;
@@ -157,7 +157,7 @@ export interface ExecutableCodePart {
 /**
  * Represents the code execution result from the model.
  *
- * @beta
+ * @public
  */
 export interface CodeExecutionResultPart {
     text?: never;
@@ -176,7 +176,7 @@ export interface CodeExecutionResultPart {
 /**
  * An interface for executable code returned by the model.
  *
- * @beta
+ * @public
  */
 export interface ExecutableCode {
     /**
@@ -191,7 +191,7 @@ export interface ExecutableCode {
 /**
  * The results of code execution run by the model.
  *
- * @beta
+ * @public
  */
 export interface CodeExecutionResult {
     /**

package/dist/src/types/enums.d.ts

@@ -367,7 +367,7 @@ export type InferenceSource = (typeof InferenceSource)[keyof typeof InferenceSou
 /**
  * Represents the result of the code execution.
  *
- * @beta
+ * @public
  */
 export declare const Outcome: {
     UNSPECIFIED: string;
@@ -378,13 +378,13 @@ export declare const Outcome: {
 /**
  * Represents the result of the code execution.
  *
- * @beta
+ * @public
  */
 export type Outcome = (typeof Outcome)[keyof typeof Outcome];
 /**
  * The programming language of the code.
  *
- * @beta
+ * @public
  */
 export declare const Language: {
     UNSPECIFIED: string;
@@ -393,7 +393,7 @@ export declare const Language: {
 /**
  * The programming language of the code.
  *
- * @beta
+ * @public
  */
 export type Language = (typeof Language)[keyof typeof Language];
 /**

package/dist/src/types/internal.d.ts

@@ -17,6 +17,7 @@
 import { AppCheckTokenResult } from '@firebase/app-check-interop-types';
 import { FirebaseAuthTokenData } from '@firebase/auth-interop-types';
 import { Backend } from '../backend';
+import { InferenceMode } from './enums';
 export * from './imagen/internal';
 export interface ApiSettings {
     apiKey: string;
@@ -30,4 +31,5 @@ export interface ApiSettings {
     backend: Backend;
     getAuthToken?: () => Promise<FirebaseAuthTokenData | null>;
     getAppCheckToken?: () => Promise<AppCheckTokenResult>;
+    inferenceMode?: InferenceMode;
 }

package/dist/src/types/responses.d.ts

@@ -118,6 +118,18 @@ export interface UsageMetadata {
      * A list of tokens used by tools, broken down by modality.
      */
     toolUsePromptTokensDetails?: ModalityTokenCount[];
+    /**
+     * The number of tokens in the prompt that were served from the cache.
+     * If implicit caching is not active or no content was cached,
+     * this will be 0.
+     */
+    cachedContentTokenCount?: number;
+    /**
+     * Detailed breakdown of the cached tokens by modality (for example, text or
+     * image). This list provides granular insight into which parts of
+     * the content were cached.
+     */
+    cacheTokensDetails?: ModalityTokenCount[];
 }
 /**
  * Represents token counting info for a single modality.
@@ -341,7 +353,7 @@ export interface Segment {
 /**
  * Metadata related to {@link URLContextTool}.
  *
- * @beta
+ * @public
  */
 export interface URLContextMetadata {
     /**
@@ -352,7 +364,7 @@ export interface URLContextMetadata {
 /**
  * Metadata for a single URL retrieved by the {@link URLContextTool} tool.
  *
- * @beta
+ * @public
  */
 export interface URLMetadata {
     /**
@@ -379,7 +391,7 @@ export interface URLMetadata {
  * <b>URL_RETRIEVAL_STATUS_UNSAFE:</b> The URL retrieval failed because the content is unsafe.
  * <br/>
  *
- * @beta
+ * @public
  */
 export declare const URLRetrievalStatus: {
     /**
@@ -418,7 +430,7 @@ export declare const URLRetrievalStatus: {
  * <b>URL_RETRIEVAL_STATUS_UNSAFE:</b> The URL retrieval failed because the content is unsafe.
  * <br/>
  *
- * @beta
+ * @public
  */
 export type URLRetrievalStatus = (typeof URLRetrievalStatus)[keyof typeof URLRetrievalStatus];
 /**
@@ -562,6 +574,18 @@ export interface LiveServerToolCallCancellation {
      */
     functionIds: string[];
 }
+/**
+ * Notification that the server will not be able to service the client soon.
+ *
+ * @beta
+ */
+export interface LiveServerGoingAwayNotice {
+    type: 'goingAwayNotice';
+    /**
+     * The remaining time (in seconds) before the connection will be terminated.
+     */
+    timeLeft: number;
+}
 /**
  * The types of responses that can be returned by {@link LiveSession.receive}.
  *
@@ -571,6 +595,7 @@ export declare const LiveResponseType: {
     SERVER_CONTENT: string;
     TOOL_CALL: string;
     TOOL_CALL_CANCELLATION: string;
+    GOING_AWAY_NOTICE: string;
 };
 /**
  * The types of responses that can be returned by {@link LiveSession.receive}.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@firebase/ai",
-  "version": "2.7.0-canary.817151ee9",
+  "version": "2.7.0-canary.b10a296fa",
   "description": "The Firebase AI SDK",
   "author": "Firebase <firebase-support@google.com> (https://firebase.google.com/)",
   "engines": {
@@ -48,19 +48,19 @@
     "trusted-type-check": "tsec -p tsconfig.json --noEmit"
   },
   "peerDependencies": {
-    "@firebase/app": "0.14.7-canary.817151ee9",
-    "@firebase/app-types": "0.9.3-canary.817151ee9"
+    "@firebase/app": "0.14.7-canary.b10a296fa",
+    "@firebase/app-types": "0.9.3-canary.b10a296fa"
   },
   "dependencies": {
-    "@firebase/app-check-interop-types": "0.3.3-canary.817151ee9",
-    "@firebase/component": "0.7.0-canary.817151ee9",
-    "@firebase/logger": "0.5.0-canary.817151ee9",
-    "@firebase/util": "1.13.0-canary.817151ee9",
+    "@firebase/app-check-interop-types": "0.3.3-canary.b10a296fa",
+    "@firebase/component": "0.7.0-canary.b10a296fa",
+    "@firebase/logger": "0.5.0-canary.b10a296fa",
+    "@firebase/util": "1.13.0-canary.b10a296fa",
     "tslib": "^2.1.0"
   },
   "license": "Apache-2.0",
   "devDependencies": {
-    "@firebase/app": "0.14.7-canary.817151ee9",
+    "@firebase/app": "0.14.7-canary.b10a296fa",
     "@rollup/plugin-json": "6.1.0",
     "rollup": "2.79.2",
     "rollup-plugin-replace": "2.2.0",