@firebase/ai 2.2.1-20250829000033 → 2.2.1-canary.06ab5c4f9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1717,17 +1717,36 @@ export declare interface ImagenSafetySettings {
1717
1717
  /**
1718
1718
  * <b>(EXPERIMENTAL)</b>
1719
1719
  * Determines whether inference happens on-device or in-cloud.
1720
+ *
1721
+ * @remarks
1722
+ * <b>PREFER_ON_DEVICE:</b> Attempt to make inference calls using an
1723
+ * on-device model. If on-device inference is not available, the SDK
1724
+ * will fall back to using a cloud-hosted model.
1725
+ * <br/>
1726
+ * <b>ONLY_ON_DEVICE:</b> Only attempt to make inference calls using an
1727
+ * on-device model. The SDK will not fall back to a cloud-hosted model.
1728
+ * If on-device inference is not available, inference methods will throw.
1729
+ * <br/>
1730
+ * <b>ONLY_IN_CLOUD:</b> Only attempt to make inference calls using a
1731
+ * cloud-hosted model. The SDK will not fall back to an on-device model.
1732
+ * <br/>
1733
+ * <b>PREFER_IN_CLOUD:</b> Attempt to make inference calls to a
1734
+ * cloud-hosted model. If not available, the SDK will fall back to an
1735
+ * on-device model.
1736
+ *
1720
1737
  * @public
1721
1738
  */
1722
1739
  export declare const InferenceMode: {
1723
1740
  readonly PREFER_ON_DEVICE: "prefer_on_device";
1724
1741
  readonly ONLY_ON_DEVICE: "only_on_device";
1725
1742
  readonly ONLY_IN_CLOUD: "only_in_cloud";
1743
+ readonly PREFER_IN_CLOUD: "prefer_in_cloud";
1726
1744
  };
1727
1745
 
1728
1746
  /**
1729
1747
  * <b>(EXPERIMENTAL)</b>
1730
1748
  * Determines whether inference happens on-device or in-cloud.
1749
+ *
1731
1750
  * @public
1732
1751
  */
1733
1752
  export declare type InferenceMode = (typeof InferenceMode)[keyof typeof InferenceMode];
package/dist/ai.d.ts CHANGED
@@ -1822,17 +1822,36 @@ export declare interface ImagenSafetySettings {
1822
1822
  /**
1823
1823
  * <b>(EXPERIMENTAL)</b>
1824
1824
  * Determines whether inference happens on-device or in-cloud.
1825
+ *
1826
+ * @remarks
1827
+ * <b>PREFER_ON_DEVICE:</b> Attempt to make inference calls using an
1828
+ * on-device model. If on-device inference is not available, the SDK
1829
+ * will fall back to using a cloud-hosted model.
1830
+ * <br/>
1831
+ * <b>ONLY_ON_DEVICE:</b> Only attempt to make inference calls using an
1832
+ * on-device model. The SDK will not fall back to a cloud-hosted model.
1833
+ * If on-device inference is not available, inference methods will throw.
1834
+ * <br/>
1835
+ * <b>ONLY_IN_CLOUD:</b> Only attempt to make inference calls using a
1836
+ * cloud-hosted model. The SDK will not fall back to an on-device model.
1837
+ * <br/>
1838
+ * <b>PREFER_IN_CLOUD:</b> Attempt to make inference calls to a
1839
+ * cloud-hosted model. If not available, the SDK will fall back to an
1840
+ * on-device model.
1841
+ *
1825
1842
  * @public
1826
1843
  */
1827
1844
  export declare const InferenceMode: {
1828
1845
  readonly PREFER_ON_DEVICE: "prefer_on_device";
1829
1846
  readonly ONLY_ON_DEVICE: "only_on_device";
1830
1847
  readonly ONLY_IN_CLOUD: "only_in_cloud";
1848
+ readonly PREFER_IN_CLOUD: "prefer_in_cloud";
1831
1849
  };
1832
1850
 
1833
1851
  /**
1834
1852
  * <b>(EXPERIMENTAL)</b>
1835
1853
  * Determines whether inference happens on-device or in-cloud.
1854
+ *
1836
1855
  * @public
1837
1856
  */
1838
1857
  export declare type InferenceMode = (typeof InferenceMode)[keyof typeof InferenceMode];