@futdevpro/fsm-dynamo 1.16.28 → 1.16.29

package/src/_modules/ai/_modules/google-ai/_enums/gai-model.enum.ts

@@ -1,16 +1,16 @@
-// Based on the @google/genai SDK model identifiers
-// (the older @google/generative-ai SDK was sunset 2025-11-30).
-export enum DyFM_GAI_Model {
-  // Current (verified 2026-06)
-  gemini_3_5_flash = 'gemini-3.5-flash',
-  gemini_3_1_pro_preview = 'gemini-3.1-pro-preview',
-  gemini_3_1_flash_lite = 'gemini-3.1-flash-lite',
-  gemini_embedding_2 = 'gemini-embedding-2',
-
-  // Legacy (deprecated / removed from the active line-up)
-  gemini_1_5_pro_latest = 'gemini-1.5-pro-latest',
-  gemini_1_5_flash_latest = 'gemini-1.5-flash-latest',
-  text_embedding_004 = 'text-embedding-004',
-}
-
-
+// Based on the @google/genai SDK model identifiers
+// (the older @google/generative-ai SDK was sunset 2025-11-30).
+export enum DyFM_GAI_Model {
+  // Current (verified 2026-06)
+  gemini_3_5_flash = 'gemini-3.5-flash',
+  gemini_3_1_pro_preview = 'gemini-3.1-pro-preview',
+  gemini_3_1_flash_lite = 'gemini-3.1-flash-lite',
+  gemini_embedding_2 = 'gemini-embedding-2',
+
+  // Legacy (deprecated / removed from the active line-up)
+  gemini_1_5_pro_latest = 'gemini-1.5-pro-latest',
+  gemini_1_5_flash_latest = 'gemini-1.5-flash-latest',
+  text_embedding_004 = 'text-embedding-004',
+}
+
+

package/src/_modules/ai/_modules/google-ai/_models/gai-call-settings.control-model.spec.ts

@@ -1,28 +1,28 @@
-import { DyFM_GAI_CallSettings } from './gai-call-settings.control-model';
-import { DyFM_GAI_Model } from '../_enums/gai-model.enum';
-
-describe('| DyFM_GAI_CallSettings', (): void => {
-  it('| should create an instance with default model', (): void => {
-    const settings = new DyFM_GAI_CallSettings();
-
-    expect(settings).toBeTruthy();
-    expect(settings.useModel).toBe(DyFM_GAI_Model.gemini_1_5_pro_latest);
-  });
-
-  it('| should create an instance with custom model', (): void => {
-    const settings = new DyFM_GAI_CallSettings({
-      useModel: DyFM_GAI_Model.gemini_1_5_pro_latest,
-    });
-
-    expect(settings.useModel).toBe(DyFM_GAI_Model.gemini_1_5_pro_latest);
-  });
-
-  it('| should create an instance with string model', (): void => {
-    const settings = new DyFM_GAI_CallSettings({
-      useModel: 'custom-model',
-    });
-
-    expect(settings.useModel).toBe('custom-model');
-  });
-});
-
+import { DyFM_GAI_CallSettings } from './gai-call-settings.control-model';
+import { DyFM_GAI_Model } from '../_enums/gai-model.enum';
+
+describe('| DyFM_GAI_CallSettings', (): void => {
+  it('| should create an instance with default model', (): void => {
+    const settings = new DyFM_GAI_CallSettings();
+
+    expect(settings).toBeTruthy();
+    expect(settings.useModel).toBe(DyFM_GAI_Model.gemini_1_5_pro_latest);
+  });
+
+  it('| should create an instance with custom model', (): void => {
+    const settings = new DyFM_GAI_CallSettings({
+      useModel: DyFM_GAI_Model.gemini_1_5_pro_latest,
+    });
+
+    expect(settings.useModel).toBe(DyFM_GAI_Model.gemini_1_5_pro_latest);
+  });
+
+  it('| should create an instance with string model', (): void => {
+    const settings = new DyFM_GAI_CallSettings({
+      useModel: 'custom-model',
+    });
+
+    expect(settings.useModel).toBe('custom-model');
+  });
+});
+

package/src/_modules/ai/_modules/google-ai/_models/gai-call-settings.control-model.ts

@@ -1,21 +1,21 @@
-import { DyFM_AI_CallSettings } from '../../../_models/ai-call-settings.interface';
-import { DyFM_GAI_Model } from '../_enums/gai-model.enum';
-
-/**
- * Google AI implementation of the generic AI Call Settings
- * Extends the generic AI_CallSettings with Google AI-specific functionality
- */
-export class DyFM_GAI_CallSettings extends DyFM_AI_CallSettings {
-  // Google AI-specific model type
-  override useModel?: DyFM_GAI_Model | string = DyFM_GAI_Model.gemini_1_5_pro_latest;
-  
-  constructor(
-    set?: DyFM_GAI_CallSettings
-  ) {
-    super(set);
-
-    if (set) {
-      Object.assign(this, set);
-    }
-  }
-}
+import { DyFM_AI_CallSettings } from '../../../_models/ai-call-settings.interface';
+import { DyFM_GAI_Model } from '../_enums/gai-model.enum';
+
+/**
+ * Google AI implementation of the generic AI Call Settings
+ * Extends the generic AI_CallSettings with Google AI-specific functionality
+ */
+export class DyFM_GAI_CallSettings extends DyFM_AI_CallSettings {
+  // Google AI-specific model type
+  override useModel?: DyFM_GAI_Model | string = DyFM_GAI_Model.gemini_1_5_pro_latest;
+  
+  constructor(
+    set?: DyFM_GAI_CallSettings
+  ) {
+    super(set);
+
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}

package/src/_modules/ai/_modules/google-ai/_models/gai-client-options.interface.ts

@@ -1,8 +1,8 @@
-export interface DyFM_GoogleAIClientOptions {
-  /** Defaults to process.env['GOOGLE_API_KEY'] */
-  apiKey?: string;
-  baseURL?: string;
-  timeout?: number;
-}
-
-
+export interface DyFM_GoogleAIClientOptions {
+  /** Defaults to process.env['GOOGLE_API_KEY'] */
+  apiKey?: string;
+  baseURL?: string;
+  timeout?: number;
+}
+
+

package/src/_modules/ai/_modules/google-ai/_models/gai-settings.control-model.spec.ts

@@ -1,22 +1,22 @@
-import { DyFM_GAI_Settings } from './gai-settings.control-model';
-import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
-
-describe('| DyFM_GAI_Settings', (): void => {
-  it('| should create an instance with default values', (): void => {
-    const settings = new DyFM_GAI_Settings();
-
-    expect(settings).toBeTruthy();
-    expect(settings.provider).toBe(DyFM_AI_Provider.Google);
-    expect(settings.defaultSettings).toBeTruthy();
-    expect(settings.config).toBeTruthy();
-  });
-
-  it('| should create an instance with custom values', (): void => {
-    const settings = new DyFM_GAI_Settings({
-      provider: DyFM_AI_Provider.Google,
-    });
-
-    expect(settings.provider).toBe(DyFM_AI_Provider.Google);
-  });
-});
-
+import { DyFM_GAI_Settings } from './gai-settings.control-model';
+import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
+
+describe('| DyFM_GAI_Settings', (): void => {
+  it('| should create an instance with default values', (): void => {
+    const settings = new DyFM_GAI_Settings();
+
+    expect(settings).toBeTruthy();
+    expect(settings.provider).toBe(DyFM_AI_Provider.Google);
+    expect(settings.defaultSettings).toBeTruthy();
+    expect(settings.config).toBeTruthy();
+  });
+
+  it('| should create an instance with custom values', (): void => {
+    const settings = new DyFM_GAI_Settings({
+      provider: DyFM_AI_Provider.Google,
+    });
+
+    expect(settings.provider).toBe(DyFM_AI_Provider.Google);
+  });
+});
+

package/src/_modules/ai/_modules/google-ai/_models/gai-settings.control-model.ts

@@ -1,25 +1,25 @@
-import { DyFM_AI_Settings } from '../../../_models/ai-settings.interface';
-import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
-import { DyFM_GoogleAIClientOptions } from './gai-client-options.interface';
-import { DyFM_GAI_CallSettings } from './gai-call-settings.control-model';
-
-/**
- * Google AI implementation of the generic AI Settings
- * Extends the generic AI_Settings with Google AI-specific functionality
- */
-export class DyFM_GAI_Settings extends DyFM_AI_Settings {
-
-  override provider?: DyFM_AI_Provider = DyFM_AI_Provider.Google;
-  override defaultSettings?: DyFM_GAI_CallSettings = new DyFM_GAI_CallSettings();
-  override config?: DyFM_GoogleAIClientOptions = {};
-
-  constructor(set?: DyFM_GAI_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_GoogleAIClientOptions } from './gai-client-options.interface';
+import { DyFM_GAI_CallSettings } from './gai-call-settings.control-model';
+
+/**
+ * Google AI implementation of the generic AI Settings
+ * Extends the generic AI_Settings with Google AI-specific functionality
+ */
+export class DyFM_GAI_Settings extends DyFM_AI_Settings {
+
+  override provider?: DyFM_AI_Provider = DyFM_AI_Provider.Google;
+  override defaultSettings?: DyFM_GAI_CallSettings = new DyFM_GAI_CallSettings();
+  override config?: DyFM_GoogleAIClientOptions = {};
+
+  constructor(set?: DyFM_GAI_Settings) {
+    super(set);
+
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}
+
+

package/src/_modules/ai/_modules/google-ai/_models/gai-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';
-
-/**
- * Google AI-specifikus user provider konfiguracio
- */
-export class DyFM_GAI_UserProviderConfig extends DyFM_AI_UserProviderConfig {
-  override provider?: DyFM_AI_Provider = DyFM_AI_Provider.Google;
-  project?: string;
-
-  constructor(
-    set?: DyFM_GAI_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';
+
+/**
+ * Google AI-specifikus user provider konfiguracio
+ */
+export class DyFM_GAI_UserProviderConfig extends DyFM_AI_UserProviderConfig {
+  override provider?: DyFM_AI_Provider = DyFM_AI_Provider.Google;
+  project?: string;
+
+  constructor(
+    set?: DyFM_GAI_UserProviderConfig
+  ) {
+    super(set);
+
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}

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

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

package/src/_modules/ai/_modules/local-ai/_collections/lai-models.const.ts

@@ -1,59 +1,59 @@
-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_LAI_Model } from '../_enums/lai-model.enum';
-
-/**
- * Local-AI model registry.
- *
- * Local models are served by a self-hosted, OpenAI-wire-compatible server
- * (lm-studio / ollama / vllm). These are GENERIC descriptors — the real
- * capabilities depend entirely on the model the user has loaded at runtime.
- * In particular `functionCalling` is left FALSE here because many local models
- * do not support tool calling; it must be confirmed per loaded model rather than
- * assumed. Context window is model-defined and therefore left unset.
- *
- * Settings note (FR-048) — `settingsSchema` is DELIBERATELY left unset here. The accepted tuning-param
- * surface of a local model is decided by whatever the user loaded into the backend at runtime, so it is
- * not knowable ahead of time; inventing one would be a guess. With no schema the reconciler stays
- * permissive (passes settings through, with a debug log) — the honest best-effort behaviour.
- * See `documentations/plans/ai-mocking-system/FR-048-LAYER-A.md`.
- */
-export const DyFM_LAI_Models: DyFM_AI_ModelInfo[] = [
-  {
-    id: DyFM_LAI_Model.generic_llm,
-    provider: DyFM_AI_Provider.LocalAI,
-    modelType: DyFM_AI_ModelType.Chat,
-    displayName: 'Local generic LLM',
-    status: 'ga',
-    capabilities: {
-      functionCalling: false, // runtime/model-dependent — confirm per loaded model
-      vision: false,
-      streaming: true,
-      jsonMode: false,
-      audioInput: false,
-      audioOutput: false,
-      imageGeneration: false,
-      embeddings: false,
-      adultContent: false,
-    },
-  },
-  {
-    id: DyFM_LAI_Model.text_embedding,
-    provider: DyFM_AI_Provider.LocalAI,
-    modelType: DyFM_AI_ModelType.Embedding,
-    displayName: 'Local text embedding',
-    status: 'ga',
-    capabilities: {
-      functionCalling: false,
-      vision: false,
-      streaming: false,
-      jsonMode: false,
-      audioInput: false,
-      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_LAI_Model } from '../_enums/lai-model.enum';
+
+/**
+ * Local-AI model registry.
+ *
+ * Local models are served by a self-hosted, OpenAI-wire-compatible server
+ * (lm-studio / ollama / vllm). These are GENERIC descriptors — the real
+ * capabilities depend entirely on the model the user has loaded at runtime.
+ * In particular `functionCalling` is left FALSE here because many local models
+ * do not support tool calling; it must be confirmed per loaded model rather than
+ * assumed. Context window is model-defined and therefore left unset.
+ *
+ * Settings note (FR-048) — `settingsSchema` is DELIBERATELY left unset here. The accepted tuning-param
+ * surface of a local model is decided by whatever the user loaded into the backend at runtime, so it is
+ * not knowable ahead of time; inventing one would be a guess. With no schema the reconciler stays
+ * permissive (passes settings through, with a debug log) — the honest best-effort behaviour.
+ * See `fdp-documentations/plans/ai-mocking-system/FR-048-LAYER-A.md`.
+ */
+export const DyFM_LAI_Models: DyFM_AI_ModelInfo[] = [
+  {
+    id: DyFM_LAI_Model.generic_llm,
+    provider: DyFM_AI_Provider.LocalAI,
+    modelType: DyFM_AI_ModelType.Chat,
+    displayName: 'Local generic LLM',
+    status: 'ga',
+    capabilities: {
+      functionCalling: false, // runtime/model-dependent — confirm per loaded model
+      vision: false,
+      streaming: true,
+      jsonMode: false,
+      audioInput: false,
+      audioOutput: false,
+      imageGeneration: false,
+      embeddings: false,
+      adultContent: false,
+    },
+  },
+  {
+    id: DyFM_LAI_Model.text_embedding,
+    provider: DyFM_AI_Provider.LocalAI,
+    modelType: DyFM_AI_ModelType.Embedding,
+    displayName: 'Local text embedding',
+    status: 'ga',
+    capabilities: {
+      functionCalling: false,
+      vision: false,
+      streaming: false,
+      jsonMode: false,
+      audioInput: false,
+      audioOutput: false,
+      imageGeneration: false,
+      embeddings: true,
+      adultContent: false,
+    },
+  },
+];

package/src/_modules/ai/_modules/local-ai/_enums/lai-model.enum.ts

@@ -1,6 +1,6 @@
-export enum DyFM_LAI_Model {
-  generic_llm = 'local-generic-llm',
-  text_embedding = 'local-text-embedding',
-}
-
-
+export enum DyFM_LAI_Model {
+  generic_llm = 'local-generic-llm',
+  text_embedding = 'local-text-embedding',
+}
+
+

package/src/_modules/ai/_modules/local-ai/_models/lai-call-settings.control-model.spec.ts

@@ -1,28 +1,28 @@
-import { DyFM_LAI_CallSettings } from './lai-call-settings.control-model';
-import { DyFM_LAI_Model } from '../_enums/lai-model.enum';
-
-describe('| DyFM_LAI_CallSettings', (): void => {
-  it('| should create an instance with default model', (): void => {
-    const settings = new DyFM_LAI_CallSettings();
-
-    expect(settings).toBeTruthy();
-    expect(settings.useModel).toBe(DyFM_LAI_Model.generic_llm);
-  });
-
-  it('| should create an instance with custom model', (): void => {
-    const settings = new DyFM_LAI_CallSettings({
-      useModel: DyFM_LAI_Model.generic_llm,
-    });
-
-    expect(settings.useModel).toBe(DyFM_LAI_Model.generic_llm);
-  });
-
-  it('| should create an instance with string model', (): void => {
-    const settings = new DyFM_LAI_CallSettings({
-      useModel: 'custom-model',
-    });
-
-    expect(settings.useModel).toBe('custom-model');
-  });
-});
-
+import { DyFM_LAI_CallSettings } from './lai-call-settings.control-model';
+import { DyFM_LAI_Model } from '../_enums/lai-model.enum';
+
+describe('| DyFM_LAI_CallSettings', (): void => {
+  it('| should create an instance with default model', (): void => {
+    const settings = new DyFM_LAI_CallSettings();
+
+    expect(settings).toBeTruthy();
+    expect(settings.useModel).toBe(DyFM_LAI_Model.generic_llm);
+  });
+
+  it('| should create an instance with custom model', (): void => {
+    const settings = new DyFM_LAI_CallSettings({
+      useModel: DyFM_LAI_Model.generic_llm,
+    });
+
+    expect(settings.useModel).toBe(DyFM_LAI_Model.generic_llm);
+  });
+
+  it('| should create an instance with string model', (): void => {
+    const settings = new DyFM_LAI_CallSettings({
+      useModel: 'custom-model',
+    });
+
+    expect(settings.useModel).toBe('custom-model');
+  });
+});
+

package/src/_modules/ai/_modules/local-ai/_models/lai-call-settings.control-model.ts

@@ -1,18 +1,18 @@
-import { DyFM_AI_CallSettings } from '../../../_models/ai-call-settings.interface';
-import { DyFM_LAI_Model } from '../_enums/lai-model.enum';
-
-export class DyFM_LAI_CallSettings extends DyFM_AI_CallSettings {
-  override useModel?: DyFM_LAI_Model | string = DyFM_LAI_Model.generic_llm;
-
-  constructor(
-    set?: DyFM_LAI_CallSettings
-  ) {
-    super(set);
-
-    if (set) {
-      Object.assign(this, set);
-    }
-  }
-}
-
-
+import { DyFM_AI_CallSettings } from '../../../_models/ai-call-settings.interface';
+import { DyFM_LAI_Model } from '../_enums/lai-model.enum';
+
+export class DyFM_LAI_CallSettings extends DyFM_AI_CallSettings {
+  override useModel?: DyFM_LAI_Model | string = DyFM_LAI_Model.generic_llm;
+
+  constructor(
+    set?: DyFM_LAI_CallSettings
+  ) {
+    super(set);
+
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}
+
+

package/src/_modules/ai/_modules/local-ai/_models/lai-client-options.interface.ts

@@ -1,9 +1,9 @@
-export interface DyFM_LAI_ClientOptions {
-  /** Optional local server base URL */
-  baseURL?: string;
-  /** Optional auth token for local server */
-  token?: string;
-  timeout?: number;
-}
-
-
+export interface DyFM_LAI_ClientOptions {
+  /** Optional local server base URL */
+  baseURL?: string;
+  /** Optional auth token for local server */
+  token?: string;
+  timeout?: number;
+}
+
+

package/src/_modules/ai/_modules/local-ai/_models/lai-settings.control-model.spec.ts

@@ -1,22 +1,22 @@
-import { DyFM_LAI_Settings } from './lai-settings.control-model';
-import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
-
-describe('| DyFM_LAI_Settings', (): void => {
-  it('| should create an instance with default values', (): void => {
-    const settings = new DyFM_LAI_Settings();
-
-    expect(settings).toBeTruthy();
-    expect(settings.provider).toBe(DyFM_AI_Provider.LocalAI);
-    expect(settings.defaultSettings).toBeTruthy();
-    expect(settings.config).toBeTruthy();
-  });
-
-  it('| should create an instance with custom values', (): void => {
-    const settings = new DyFM_LAI_Settings({
-      provider: DyFM_AI_Provider.LocalAI,
-    });
-
-    expect(settings.provider).toBe(DyFM_AI_Provider.LocalAI);
-  });
-});
-
+import { DyFM_LAI_Settings } from './lai-settings.control-model';
+import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
+
+describe('| DyFM_LAI_Settings', (): void => {
+  it('| should create an instance with default values', (): void => {
+    const settings = new DyFM_LAI_Settings();
+
+    expect(settings).toBeTruthy();
+    expect(settings.provider).toBe(DyFM_AI_Provider.LocalAI);
+    expect(settings.defaultSettings).toBeTruthy();
+    expect(settings.config).toBeTruthy();
+  });
+
+  it('| should create an instance with custom values', (): void => {
+    const settings = new DyFM_LAI_Settings({
+      provider: DyFM_AI_Provider.LocalAI,
+    });
+
+    expect(settings.provider).toBe(DyFM_AI_Provider.LocalAI);
+  });
+});
+