@futdevpro/fsm-dynamo 1.16.31 → 1.16.34

package/src/_modules/ai/_modules/document-ai/_models/dai-vector-search-params.interface.ts

@@ -1,22 +1,22 @@
-import { DyFM_DAI_EmbeddingInfo } from './dai-embedding-info.interface';
-
-/**
- * Parameters for vector search operations
- * Used to configure similarity search with validation
- */
-export interface DyFM_DAI_VectorSearchParams {
-  /** The query text to search for */
-  query: string;
-  /** The embedding model info to use for the search */
-  embeddingInfo: DyFM_DAI_EmbeddingInfo;
-  /** Maximum number of results to return */
-  limit?: number;
-  /** Minimum similarity score threshold (0-1) */
-  minSimilarity?: number;
-  /** Maximum similarity score threshold (0-1) */
-  maxSimilarity?: number;
-  /** Optional filter criteria */
-  filters?: Record<string, any>;
-  /** Whether to validate embedding model compatibility */
-  validateModel?: boolean;
-}
+import { DyFM_DAI_EmbeddingInfo } from './dai-embedding-info.interface';
+
+/**
+ * Parameters for vector search operations
+ * Used to configure similarity search with validation
+ */
+export interface DyFM_DAI_VectorSearchParams {
+  /** The query text to search for */
+  query: string;
+  /** The embedding model info to use for the search */
+  embeddingInfo: DyFM_DAI_EmbeddingInfo;
+  /** Maximum number of results to return */
+  limit?: number;
+  /** Minimum similarity score threshold (0-1) */
+  minSimilarity?: number;
+  /** Maximum similarity score threshold (0-1) */
+  maxSimilarity?: number;
+  /** Optional filter criteria */
+  filters?: Record<string, any>;
+  /** Whether to validate embedding model compatibility */
+  validateModel?: boolean;
+}

package/src/_modules/ai/_modules/document-ai/index.ts

@@ -1,4 +1,4 @@
-
-// MODELS
-export * from './_models/dai-embedding-info.interface';
-export * from './_models/dai-vector-search-params.interface';
+
+// MODELS
+export * from './_models/dai-embedding-info.interface';
+export * from './_models/dai-vector-search-params.interface';

package/src/_modules/ai/_modules/fdp-ai/_collections/fdpai-models.const.ts

@@ -1,40 +1,40 @@
-import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
-import { DyFM_AI_ModelType } from '../../../_enums/ai-model-type.enum';
-import { DyFM_AI_ModelInfo } from '../../../_models/ai-model-info.interface';
-import { DyFM_FdpAI_Model } from '../_enums/fdpai-model.enum';
-
-/**
- * FDP-AI model registry.
- *
- * FDP-AI is an internal, OpenAI-wire-compatible HTTP gateway (`/chat/completions`),
- * so tool calling follows the OpenAI format. Capabilities ultimately depend on the
- * backing gateway/model — `functionCalling` is declared true on the assumption the
- * gateway forwards OpenAI-style tools; confirm against the live FDP-AI deployment.
- * Context window is gateway-defined and therefore left unset.
- *
- * Settings note (FR-048) — `settingsSchema` is DELIBERATELY left unset. Which tuning params the gateway
- * actually accepts depends on the backing model it proxies to, and there is no verified record of that
- * yet; encoding a guess could make the reconciler drop params the gateway does accept. With no schema the
- * reconciler stays permissive (debug-logged). Populate once measured against the live gateway.
- * See `fdp-documentations/plans/ai-mocking-system/FR-048-LAYER-A.md`.
- */
-export const DyFM_FdpAI_Models: DyFM_AI_ModelInfo[] = [
-  {
-    id: DyFM_FdpAI_Model.fdpBase1,
-    provider: DyFM_AI_Provider.FdpAI,
-    modelType: DyFM_AI_ModelType.Chat,
-    displayName: 'FDP Base 1',
-    status: 'ga',
-    capabilities: {
-      functionCalling: true, // OpenAI-wire compatible — verify against the live gateway
-      vision: false,
-      streaming: true,
-      jsonMode: false,
-      audioInput: false,
-      audioOutput: false,
-      imageGeneration: false,
-      embeddings: false,
-      adultContent: false,
-    },
-  },
-];
+import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
+import { DyFM_AI_ModelType } from '../../../_enums/ai-model-type.enum';
+import { DyFM_AI_ModelInfo } from '../../../_models/ai-model-info.interface';
+import { DyFM_FdpAI_Model } from '../_enums/fdpai-model.enum';
+
+/**
+ * FDP-AI model registry.
+ *
+ * FDP-AI is an internal, OpenAI-wire-compatible HTTP gateway (`/chat/completions`),
+ * so tool calling follows the OpenAI format. Capabilities ultimately depend on the
+ * backing gateway/model — `functionCalling` is declared true on the assumption the
+ * gateway forwards OpenAI-style tools; confirm against the live FDP-AI deployment.
+ * Context window is gateway-defined and therefore left unset.
+ *
+ * Settings note (FR-048) — `settingsSchema` is DELIBERATELY left unset. Which tuning params the gateway
+ * actually accepts depends on the backing model it proxies to, and there is no verified record of that
+ * yet; encoding a guess could make the reconciler drop params the gateway does accept. With no schema the
+ * reconciler stays permissive (debug-logged). Populate once measured against the live gateway.
+ * See `fdp-documentations/plans/ai-mocking-system/FR-048-LAYER-A.md`.
+ */
+export const DyFM_FdpAI_Models: DyFM_AI_ModelInfo[] = [
+  {
+    id: DyFM_FdpAI_Model.fdpBase1,
+    provider: DyFM_AI_Provider.FdpAI,
+    modelType: DyFM_AI_ModelType.Chat,
+    displayName: 'FDP Base 1',
+    status: 'ga',
+    capabilities: {
+      functionCalling: true, // OpenAI-wire compatible — verify against the live gateway
+      vision: false,
+      streaming: true,
+      jsonMode: false,
+      audioInput: false,
+      audioOutput: false,
+      imageGeneration: false,
+      embeddings: false,
+      adultContent: false,
+    },
+  },
+];

package/src/_modules/ai/_modules/fdp-ai/_enums/fdpai-model.enum.ts

@@ -1,6 +1,6 @@
-/**
- * FDP-AI rendszeren elerheto modellek
- */
-export enum DyFM_FdpAI_Model {
-  fdpBase1 = 'fdp-base-1',
-}
+/**
+ * FDP-AI rendszeren elerheto modellek
+ */
+export enum DyFM_FdpAI_Model {
+  fdpBase1 = 'fdp-base-1',
+}

package/src/_modules/ai/_modules/fdp-ai/_models/fdpai-call-settings.control-model.ts

@@ -1,19 +1,19 @@
-import { DyFM_AI_CallSettings } from '../../../_models/ai-call-settings.interface';
-import { DyFM_FdpAI_Model } from '../_enums/fdpai-model.enum';
-
-/**
- * FDP-AI implementacioja a generikus AI Call Settings-nek
- */
-export class DyFM_FdpAI_CallSettings extends DyFM_AI_CallSettings {
-  override useModel?: DyFM_FdpAI_Model | string = DyFM_FdpAI_Model.fdpBase1;
-
-  constructor(
-    set?: DyFM_FdpAI_CallSettings
-  ) {
-    super(set);
-
-    if (set) {
-      Object.assign(this, set);
-    }
-  }
-}
+import { DyFM_AI_CallSettings } from '../../../_models/ai-call-settings.interface';
+import { DyFM_FdpAI_Model } from '../_enums/fdpai-model.enum';
+
+/**
+ * FDP-AI implementacioja a generikus AI Call Settings-nek
+ */
+export class DyFM_FdpAI_CallSettings extends DyFM_AI_CallSettings {
+  override useModel?: DyFM_FdpAI_Model | string = DyFM_FdpAI_Model.fdpBase1;
+
+  constructor(
+    set?: DyFM_FdpAI_CallSettings
+  ) {
+    super(set);
+
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}

package/src/_modules/ai/_modules/fdp-ai/_models/fdpai-client-options.interface.ts

@@ -1,11 +1,11 @@
-/**
- * FDP-AI provider kliens konfiguracio
- */
-export interface DyFM_FdpAI_ClientOptions {
-  /** FDP-AI API kulcs */
-  apiKey?: string;
-  /** FDP-AI szerver base URL */
-  baseURL?: string;
-  /** Timeout milliszekundumban */
-  timeout?: number;
-}
+/**
+ * FDP-AI provider kliens konfiguracio
+ */
+export interface DyFM_FdpAI_ClientOptions {
+  /** FDP-AI API kulcs */
+  apiKey?: string;
+  /** FDP-AI szerver base URL */
+  baseURL?: string;
+  /** Timeout milliszekundumban */
+  timeout?: number;
+}

package/src/_modules/ai/_modules/fdp-ai/_models/fdpai-settings.control-model.ts

@@ -1,24 +1,24 @@
-import { DyFM_AI_Settings } from '../../../_models/ai-settings.interface';
-import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
-import { DyFM_FdpAI_ClientOptions } from './fdpai-client-options.interface';
-import { DyFM_FdpAI_CallSettings } from './fdpai-call-settings.control-model';
-
-/**
- * FDP-AI implementacioja a generikus AI Settings-nek
- */
-export class DyFM_FdpAI_Settings extends DyFM_AI_Settings {
-
-  override provider?: DyFM_AI_Provider = DyFM_AI_Provider.FdpAI;
-  override defaultSettings?: DyFM_FdpAI_CallSettings = new DyFM_FdpAI_CallSettings();
-  override config?: DyFM_FdpAI_ClientOptions = {};
-
-  constructor(
-    set?: DyFM_FdpAI_Settings
-  ) {
-    super(set);
-
-    if (set) {
-      Object.assign(this, set);
-    }
-  }
-}
+import { DyFM_AI_Settings } from '../../../_models/ai-settings.interface';
+import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
+import { DyFM_FdpAI_ClientOptions } from './fdpai-client-options.interface';
+import { DyFM_FdpAI_CallSettings } from './fdpai-call-settings.control-model';
+
+/**
+ * FDP-AI implementacioja a generikus AI Settings-nek
+ */
+export class DyFM_FdpAI_Settings extends DyFM_AI_Settings {
+
+  override provider?: DyFM_AI_Provider = DyFM_AI_Provider.FdpAI;
+  override defaultSettings?: DyFM_FdpAI_CallSettings = new DyFM_FdpAI_CallSettings();
+  override config?: DyFM_FdpAI_ClientOptions = {};
+
+  constructor(
+    set?: DyFM_FdpAI_Settings
+  ) {
+    super(set);
+
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}

package/src/_modules/ai/_modules/fdp-ai/_models/fdpai-user-provider-config.control-model.ts

@@ -1,20 +1,20 @@
-import { DyFM_AI_UserProviderConfig } from '../../../_models/ai-user-provider-config.control-model';
-import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
-
-/**
- * FDP-AI-specifikus user provider konfiguracio
- */
-export class DyFM_FdpAI_UserProviderConfig extends DyFM_AI_UserProviderConfig {
-  override provider?: DyFM_AI_Provider = DyFM_AI_Provider.FdpAI;
-  baseURL?: string;
-
-  constructor(
-    set?: DyFM_FdpAI_UserProviderConfig
-  ) {
-    super(set);
-
-    if (set) {
-      Object.assign(this, set);
-    }
-  }
-}
+import { DyFM_AI_UserProviderConfig } from '../../../_models/ai-user-provider-config.control-model';
+import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
+
+/**
+ * FDP-AI-specifikus user provider konfiguracio
+ */
+export class DyFM_FdpAI_UserProviderConfig extends DyFM_AI_UserProviderConfig {
+  override provider?: DyFM_AI_Provider = DyFM_AI_Provider.FdpAI;
+  baseURL?: string;
+
+  constructor(
+    set?: DyFM_FdpAI_UserProviderConfig
+  ) {
+    super(set);
+
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}

package/src/_modules/ai/_modules/fdp-ai/index.ts

@@ -1,11 +1,11 @@
-// COLLECTIONS
-export * from './_collections/fdpai-models.const';
-
-// ENUMS
-export * from './_enums/fdpai-model.enum';
-
-// MODELS
-export * from './_models/fdpai-client-options.interface';
-export * from './_models/fdpai-call-settings.control-model';
-export * from './_models/fdpai-settings.control-model';
-export * from './_models/fdpai-user-provider-config.control-model';
+// COLLECTIONS
+export * from './_collections/fdpai-models.const';
+
+// ENUMS
+export * from './_enums/fdpai-model.enum';
+
+// MODELS
+export * from './_models/fdpai-client-options.interface';
+export * from './_models/fdpai-call-settings.control-model';
+export * from './_models/fdpai-settings.control-model';
+export * from './_models/fdpai-user-provider-config.control-model';

package/src/_modules/ai/_modules/google-ai/_collections/gai-models.const.ts

@@ -1,161 +1,161 @@
-import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
-import { DyFM_AI_ModelType } from '../../../_enums/ai-model-type.enum';
-import { DyFM_AI_ModelInfo } from '../../../_models/ai-model-info.interface';
-import { DyFM_AI_ModelSettingsSchema } from '../../../_models/ai-model-settings-schema.interface';
-import { DyFM_GAI_Model } from '../_enums/gai-model.enum';
-
-/**
- * Google Gemini model registry — verified 2026-06-01 against ai.google.dev docs.
- *
- * SDK note: depend on `@google/genai` (the old `@google/generative-ai` was sunset
- * 2025-11-30). Tool use via `functionDeclarations`; tool results are returned under
- * a `user`-role `functionResponse` part (no dedicated tool role).
- *
- * Video input is a real Gemini capability but is not yet modelled in
- * {@link DyFM_AI_ModelCapabilities} — `vision` covers image input only.
- */
-/**
- * Gemini chat — a param-vokabular MAS, mint az OpenAI-e (FR-048 §Problem).
- *
- * Az agnosztikus `frequencyPenalty`/`presencePenalty` NEM resze a Gemini feluletnek, ezert `unsupported`:
- * a reconciler eldobja oket. (A dropolas mindig biztonsagos — a Gemini ugysem ertelmezne oket.) A
- * Gemini-specifikus knobok `extraParams`-kent utaznak; a nativ kepzes a provider-translator dolga.
- * Forras: FR-048 §Problem + `ai-per-model-settings.md` tabla; verified 2026-06-01.
- */
-const GAI_CHAT_SETTINGS: DyFM_AI_ModelSettingsSchema = {
-  supported: [ 'temperature', 'maxTokens', 'topP' ],
-  unsupported: [ 'frequencyPenalty', 'presencePenalty' ],
-  extraParams: [ 'topK', 'candidateCount', 'responseSchema', 'thinkingConfig', 'toolConfig' ],
-  // A Gemini-doksi NEM publikal szamhatarokat — az alabbiakat SZANDEKOSAN kivaltott hibauzenetekbol
-  // mertuk ki (live capture 2026-07-21). Ez volt az EGYETLEN mod verifikalt bound-okhoz jutni.
-  constraints: {
-    temperature: {
-      min: 0,
-      max: 2,
-      note: 'Capture 2026-07-21: "temperature must be in the range [0.0, 2.0]." — azonos az OpenAI-jal, ' +
-        'és NEM az Anthropic 1.0-s plafonjával.',
-    },
-    topP: {
-      min: 0,
-      max: 1,
-      note: 'Capture 2026-07-21: "top_p must be in the range [0.0, 1.0]."',
-    },
-    topK: {
-      min: 0,
-      note: 'Capture 2026-07-21: "top_k must be nonnegative." — felso hatart a szerver NEM kozolt, ezert nincs max.',
-    },
-    candidateCount: {
-      min: 1,
-      max: 8,
-      note: 'Capture 2026-07-21: "candidate_count must be in the range [1, 8]."',
-    },
-  },
-};
-
-/**
- * Mint {@link GAI_CHAT_SETTINGS}, de rogziti a Pro-preview NEM-nyilvanvalo default-jat: ha a hivas nem ad
- * `maxOutputTokens`-t, a szerver **8192**-re defaultol (NEM a 65536-os maximumra). Forras: FR-048 §Problem.
- */
-const GAI_PRO_PREVIEW_SETTINGS: DyFM_AI_ModelSettingsSchema = {
-  ...GAI_CHAT_SETTINGS,
-  constraints: {
-    maxTokens: {
-      default: 8192,
-      note: 'Gemini 3.1 Pro preview: omitted maxOutputTokens → server default 8192 (not the 65536 max). FR-048, verified 2026-06-01.',
-    },
-  },
-};
-
-/** Embedding-modell: chat-sampling paramok nem ertelmezettek → a reconciler eldobja oket. */
-const GAI_EMBEDDING_SETTINGS: DyFM_AI_ModelSettingsSchema = {
-  unsupported: [ 'temperature', 'topP', 'frequencyPenalty', 'presencePenalty', 'maxTokens' ],
-};
-
-export const DyFM_GAI_Models: DyFM_AI_ModelInfo[] = [
-  {
-    id: DyFM_GAI_Model.gemini_3_5_flash,
-    provider: DyFM_AI_Provider.Google,
-    modelType: DyFM_AI_ModelType.Chat,
-    displayName: 'Gemini 3.5 Flash',
-    tier: 'flash',
-    settingsSchema: GAI_CHAT_SETTINGS,
-    status: 'ga',
-    contextWindow: 1_048_576,
-    maxOutputTokens: 65_536,
-    capabilities: {
-      functionCalling: true,
-      vision: true,
-      streaming: true,
-      jsonMode: true,
-      audioInput: true,
-      audioOutput: false,
-      imageGeneration: false,
-      embeddings: false,
-      adultContent: false,
-    },
-  },
-  {
-    id: DyFM_GAI_Model.gemini_3_1_pro_preview,
-    provider: DyFM_AI_Provider.Google,
-    modelType: DyFM_AI_ModelType.Chat,
-    displayName: 'Gemini 3.1 Pro (preview)',
-    tier: 'pro',
-    settingsSchema: GAI_PRO_PREVIEW_SETTINGS,
-    status: 'preview',
-    contextWindow: 1_048_576,
-    maxOutputTokens: 65_536,
-    capabilities: {
-      functionCalling: true,
-      vision: true,
-      streaming: true,
-      jsonMode: true,
-      audioInput: true,
-      audioOutput: false,
-      imageGeneration: false,
-      embeddings: false,
-      adultContent: false,
-    },
-  },
-  {
-    id: DyFM_GAI_Model.gemini_3_1_flash_lite,
-    provider: DyFM_AI_Provider.Google,
-    modelType: DyFM_AI_ModelType.Chat,
-    displayName: 'Gemini 3.1 Flash-Lite',
-    tier: 'flash-lite',
-    settingsSchema: GAI_CHAT_SETTINGS,
-    status: 'ga',
-    contextWindow: 1_048_576,
-    maxOutputTokens: 65_536,
-    capabilities: {
-      functionCalling: true,
-      vision: true,
-      streaming: true,
-      jsonMode: true,
-      audioInput: true,
-      audioOutput: false,
-      imageGeneration: false,
-      embeddings: false,
-      adultContent: false,
-    },
-  },
-  {
-    id: DyFM_GAI_Model.gemini_embedding_2,
-    provider: DyFM_AI_Provider.Google,
-    modelType: DyFM_AI_ModelType.Embedding,
-    displayName: 'Gemini Embedding 2',
-    status: 'ga',
-    settingsSchema: GAI_EMBEDDING_SETTINGS,
-    contextWindow: 8_192,
-    capabilities: {
-      functionCalling: false,
-      vision: true, // multimodal embedding (text / image / audio)
-      streaming: false,
-      jsonMode: false,
-      audioInput: true,
-      audioOutput: false,
-      imageGeneration: false,
-      embeddings: true,
-      adultContent: false,
-    },
-  },
-];
+import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
+import { DyFM_AI_ModelType } from '../../../_enums/ai-model-type.enum';
+import { DyFM_AI_ModelInfo } from '../../../_models/ai-model-info.interface';
+import { DyFM_AI_ModelSettingsSchema } from '../../../_models/ai-model-settings-schema.interface';
+import { DyFM_GAI_Model } from '../_enums/gai-model.enum';
+
+/**
+ * Google Gemini model registry — verified 2026-06-01 against ai.google.dev docs.
+ *
+ * SDK note: depend on `@google/genai` (the old `@google/generative-ai` was sunset
+ * 2025-11-30). Tool use via `functionDeclarations`; tool results are returned under
+ * a `user`-role `functionResponse` part (no dedicated tool role).
+ *
+ * Video input is a real Gemini capability but is not yet modelled in
+ * {@link DyFM_AI_ModelCapabilities} — `vision` covers image input only.
+ */
+/**
+ * Gemini chat — a param-vokabular MAS, mint az OpenAI-e (FR-048 §Problem).
+ *
+ * Az agnosztikus `frequencyPenalty`/`presencePenalty` NEM resze a Gemini feluletnek, ezert `unsupported`:
+ * a reconciler eldobja oket. (A dropolas mindig biztonsagos — a Gemini ugysem ertelmezne oket.) A
+ * Gemini-specifikus knobok `extraParams`-kent utaznak; a nativ kepzes a provider-translator dolga.
+ * Forras: FR-048 §Problem + `ai-per-model-settings.md` tabla; verified 2026-06-01.
+ */
+const GAI_CHAT_SETTINGS: DyFM_AI_ModelSettingsSchema = {
+  supported: [ 'temperature', 'maxTokens', 'topP' ],
+  unsupported: [ 'frequencyPenalty', 'presencePenalty' ],
+  extraParams: [ 'topK', 'candidateCount', 'responseSchema', 'thinkingConfig', 'toolConfig' ],
+  // A Gemini-doksi NEM publikal szamhatarokat — az alabbiakat SZANDEKOSAN kivaltott hibauzenetekbol
+  // mertuk ki (live capture 2026-07-21). Ez volt az EGYETLEN mod verifikalt bound-okhoz jutni.
+  constraints: {
+    temperature: {
+      min: 0,
+      max: 2,
+      note: 'Capture 2026-07-21: "temperature must be in the range [0.0, 2.0]." — azonos az OpenAI-jal, ' +
+        'és NEM az Anthropic 1.0-s plafonjával.',
+    },
+    topP: {
+      min: 0,
+      max: 1,
+      note: 'Capture 2026-07-21: "top_p must be in the range [0.0, 1.0]."',
+    },
+    topK: {
+      min: 0,
+      note: 'Capture 2026-07-21: "top_k must be nonnegative." — felso hatart a szerver NEM kozolt, ezert nincs max.',
+    },
+    candidateCount: {
+      min: 1,
+      max: 8,
+      note: 'Capture 2026-07-21: "candidate_count must be in the range [1, 8]."',
+    },
+  },
+};
+
+/**
+ * Mint {@link GAI_CHAT_SETTINGS}, de rogziti a Pro-preview NEM-nyilvanvalo default-jat: ha a hivas nem ad
+ * `maxOutputTokens`-t, a szerver **8192**-re defaultol (NEM a 65536-os maximumra). Forras: FR-048 §Problem.
+ */
+const GAI_PRO_PREVIEW_SETTINGS: DyFM_AI_ModelSettingsSchema = {
+  ...GAI_CHAT_SETTINGS,
+  constraints: {
+    maxTokens: {
+      default: 8192,
+      note: 'Gemini 3.1 Pro preview: omitted maxOutputTokens → server default 8192 (not the 65536 max). FR-048, verified 2026-06-01.',
+    },
+  },
+};
+
+/** Embedding-modell: chat-sampling paramok nem ertelmezettek → a reconciler eldobja oket. */
+const GAI_EMBEDDING_SETTINGS: DyFM_AI_ModelSettingsSchema = {
+  unsupported: [ 'temperature', 'topP', 'frequencyPenalty', 'presencePenalty', 'maxTokens' ],
+};
+
+export const DyFM_GAI_Models: DyFM_AI_ModelInfo[] = [
+  {
+    id: DyFM_GAI_Model.gemini_3_5_flash,
+    provider: DyFM_AI_Provider.Google,
+    modelType: DyFM_AI_ModelType.Chat,
+    displayName: 'Gemini 3.5 Flash',
+    tier: 'flash',
+    settingsSchema: GAI_CHAT_SETTINGS,
+    status: 'ga',
+    contextWindow: 1_048_576,
+    maxOutputTokens: 65_536,
+    capabilities: {
+      functionCalling: true,
+      vision: true,
+      streaming: true,
+      jsonMode: true,
+      audioInput: true,
+      audioOutput: false,
+      imageGeneration: false,
+      embeddings: false,
+      adultContent: false,
+    },
+  },
+  {
+    id: DyFM_GAI_Model.gemini_3_1_pro_preview,
+    provider: DyFM_AI_Provider.Google,
+    modelType: DyFM_AI_ModelType.Chat,
+    displayName: 'Gemini 3.1 Pro (preview)',
+    tier: 'pro',
+    settingsSchema: GAI_PRO_PREVIEW_SETTINGS,
+    status: 'preview',
+    contextWindow: 1_048_576,
+    maxOutputTokens: 65_536,
+    capabilities: {
+      functionCalling: true,
+      vision: true,
+      streaming: true,
+      jsonMode: true,
+      audioInput: true,
+      audioOutput: false,
+      imageGeneration: false,
+      embeddings: false,
+      adultContent: false,
+    },
+  },
+  {
+    id: DyFM_GAI_Model.gemini_3_1_flash_lite,
+    provider: DyFM_AI_Provider.Google,
+    modelType: DyFM_AI_ModelType.Chat,
+    displayName: 'Gemini 3.1 Flash-Lite',
+    tier: 'flash-lite',
+    settingsSchema: GAI_CHAT_SETTINGS,
+    status: 'ga',
+    contextWindow: 1_048_576,
+    maxOutputTokens: 65_536,
+    capabilities: {
+      functionCalling: true,
+      vision: true,
+      streaming: true,
+      jsonMode: true,
+      audioInput: true,
+      audioOutput: false,
+      imageGeneration: false,
+      embeddings: false,
+      adultContent: false,
+    },
+  },
+  {
+    id: DyFM_GAI_Model.gemini_embedding_2,
+    provider: DyFM_AI_Provider.Google,
+    modelType: DyFM_AI_ModelType.Embedding,
+    displayName: 'Gemini Embedding 2',
+    status: 'ga',
+    settingsSchema: GAI_EMBEDDING_SETTINGS,
+    contextWindow: 8_192,
+    capabilities: {
+      functionCalling: false,
+      vision: true, // multimodal embedding (text / image / audio)
+      streaming: false,
+      jsonMode: false,
+      audioInput: true,
+      audioOutput: false,
+      imageGeneration: false,
+      embeddings: true,
+      adultContent: false,
+    },
+  },
+];