@firebase/ai 2.9.0 → 2.10.0

package/dist/ai-public.d.ts

@@ -960,6 +960,16 @@ export declare interface GenerationConfig {
      * this is limited to `application/json` and `text/x.enum`.
      */
     responseSchema?: TypedSchema | SchemaRequest;
+    /**
+     * Output schema of the generated response. This is an alternative to
+     * `responseSchema` that accepts [JSON Schema](https://json-schema.org/).
+     *
+     * If set, `responseSchema` must be omitted, but `responseMimeType`
+     * is required and must be set to `application/json`.
+     */
+    responseJsonSchema?: {
+        [key: string]: unknown;
+    };
     /**
      * Generation modalities to be returned in generation responses.
      *

package/dist/ai.d.ts

@@ -1045,6 +1045,16 @@ export declare interface GenerationConfig {
      * this is limited to `application/json` and `text/x.enum`.
      */
     responseSchema?: TypedSchema | SchemaRequest;
+    /**
+     * Output schema of the generated response. This is an alternative to
+     * `responseSchema` that accepts [JSON Schema](https://json-schema.org/).
+     *
+     * If set, `responseSchema` must be omitted, but `responseMimeType`
+     * is required and must be set to `application/json`.
+     */
+    responseJsonSchema?: {
+        [key: string]: unknown;
+    };
     /**
      * Generation modalities to be returned in generation responses.
      *

package/dist/esm/index.esm.js

@@ -4,7 +4,7 @@ import { FirebaseError, Deferred, getModularInstance } from '@firebase/util';
 import { Logger } from '@firebase/logger';
 
 var name = "@firebase/ai";
-var version = "2.9.0";
+var version = "2.10.0";
 
 /**
  * @license
@@ -3134,6 +3134,17 @@ function validateGenerationConfig(generationConfig) {
         generationConfig.thinkingConfig?.thinkingLevel) {
         throw new AIError(AIErrorCode.UNSUPPORTED, `Cannot set both thinkingBudget and thinkingLevel in a config.`);
     }
+    if (
+    // != allows for null and undefined.
+    generationConfig.responseSchema != null &&
+        generationConfig.responseJsonSchema != null) {
+        throw new AIError(AIErrorCode.UNSUPPORTED, `Cannot set both responseSchema and responseJsonSchema in a config.`);
+    }
+    if ((generationConfig.responseSchema != null ||
+        generationConfig.responseJsonSchema != null) &&
+        generationConfig.responseMimeType) {
+        throw new AIError(AIErrorCode.UNSUPPORTED, `responseMimeType must be set if responseSchema or responseJsonSchema are set.`);
+    }
 }
 
 /**
@@ -4654,6 +4665,11 @@ function getAI(app = getApp(), options) {
     aiInstance.options = finalOptions;
     return aiInstance;
 }
+const hybridParamKeys = [
+    'mode',
+    'onDeviceParams',
+    'inCloudParams'
+];
 /**
  * Returns a {@link GenerativeModel} class with methods for inference
  * and other functionality.
@@ -4665,6 +4681,16 @@ function getGenerativeModel(ai, modelParams, requestOptions) {
     const hybridParams = modelParams;
     let inCloudParams;
     if (hybridParams.mode) {
+        for (const param of Object.keys(modelParams)) {
+            if (!hybridParamKeys.includes(param)) {
+                logger.warn(`When a hybrid inference mode is specified (mode is currently set` +
+                    ` to ${hybridParams.mode}), "${param}" cannot be ` +
+                    `configured at the top level. Configuration for in-cloud and ` +
+                    `on-device must be done separately in inCloudParams and onDeviceParams. ` +
+                    `Configuration values set outside of inCloudParams and onDeviceParams will` +
+                    ` be ignored.`);
+            }
+        }
         inCloudParams = hybridParams.inCloudParams || {
             model: DEFAULT_HYBRID_IN_CLOUD_MODEL
         };