@futdevpro/fsm-dynamo 1.15.18 → 1.15.21

package/src/_modules/ai/_models/ai-tool.interface.ts

@@ -1,16 +1,16 @@
-/**
- * Provider-neutral tool (function) definition for native function calling.
- *
- * One agnostic shape, translated per provider by the execution layer:
- *  - OpenAI-wire: → { type:'function', function:{ name, description, parameters } }
- *  - Anthropic:   → { name, description, input_schema: parameters }
- *  - Gemini:      → tools:[{ functionDeclarations:[{ name, description, parameters }] }]
- */
-export interface DyFM_AI_Tool {
-  /** Function name. No spaces / special chars (Gemini constraint). */
-  name: string;
-  /** What the tool does — the model uses this to decide when to call it. */
-  description: string;
-  /** JSON Schema (object schema) describing the arguments. Translated to each provider's param shape. */
-  parameters: object;
-}
+/**
+ * Provider-neutral tool (function) definition for native function calling.
+ *
+ * One agnostic shape, translated per provider by the execution layer:
+ *  - OpenAI-wire: → { type:'function', function:{ name, description, parameters } }
+ *  - Anthropic:   → { name, description, input_schema: parameters }
+ *  - Gemini:      → tools:[{ functionDeclarations:[{ name, description, parameters }] }]
+ */
+export interface DyFM_AI_Tool {
+  /** Function name. No spaces / special chars (Gemini constraint). */
+  name: string;
+  /** What the tool does — the model uses this to decide when to call it. */
+  description: string;
+  /** JSON Schema (object schema) describing the arguments. Translated to each provider's param shape. */
+  parameters: object;
+}

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

@@ -1,29 +1,29 @@
-import { DyFM_AI_Provider } from '../_enums/ai-provider.enum';
-
-/**
- * User szintu AI provider konfiguracio base class
- *
- * Tartalmazz a provider API kulcs titkositott valtozatat, annak suffix-et a megjeleníteshez,
- * es az alap beallitasokat. Provider-specifikus leszarmazottak bovitik sajat mezoikkel.
- */
-export class DyFM_AI_UserProviderConfig {
-  provider?: DyFM_AI_Provider;
-  /** titkositott API kulcs (csak szerver oldalon tarolva, kliensre sosem kerul) */
-  encryptedApiKey?: string;
-  /** az API kulcs utolso ~4 karaktere megjeleníteshez (pl. "...xR7q") */
-  keySuffix?: string;
-  isActive?: boolean;
-  label?: string;
-  lastTestedAt?: Date;
-  lastUsedAt?: Date;
-  /** a user altal kivalasztott modellek (providerrol lekerdezett listabol) */
-  selectedModels?: string[];
-
-  constructor(
-    set?: DyFM_AI_UserProviderConfig
-  ) {
-    if (set) {
-      Object.assign(this, set);
-    }
-  }
-}
+import { DyFM_AI_Provider } from '../_enums/ai-provider.enum';
+
+/**
+ * User szintu AI provider konfiguracio base class
+ *
+ * Tartalmazz a provider API kulcs titkositott valtozatat, annak suffix-et a megjeleníteshez,
+ * es az alap beallitasokat. Provider-specifikus leszarmazottak bovitik sajat mezoikkel.
+ */
+export class DyFM_AI_UserProviderConfig {
+  provider?: DyFM_AI_Provider;
+  /** titkositott API kulcs (csak szerver oldalon tarolva, kliensre sosem kerul) */
+  encryptedApiKey?: string;
+  /** az API kulcs utolso ~4 karaktere megjeleníteshez (pl. "...xR7q") */
+  keySuffix?: string;
+  isActive?: boolean;
+  label?: string;
+  lastTestedAt?: Date;
+  lastUsedAt?: Date;
+  /** a user altal kivalasztott modellek (providerrol lekerdezett listabol) */
+  selectedModels?: string[];
+
+  constructor(
+    set?: DyFM_AI_UserProviderConfig
+  ) {
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}

package/src/_modules/ai/_modules/anthropic/_collections/aai-models.const.ts

@@ -1,81 +1,81 @@
-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_AAI_Model } from '../_enums/aai-model.enum';
-
-/**
- * Anthropic Claude model registry — verified 2026-06-01 against platform.claude.com docs.
- *
- * All Claude models are chat (Messages API) models — Anthropic has NO embeddings API.
- * Tool use is universal (content-block `tool_use` / `tool_result` wire format).
- * Anthropic has no dedicated JSON-mode flag (structured output is done via tools),
- * so `jsonMode` is false across the board.
- *
- * Param note (translator): Opus 4.7+ reject `temperature`/`top_p`/`top_k` with 400 —
- * not modelled here, handled in the Anthropic call translator.
- */
-export const DyFM_AAI_Models: DyFM_AI_ModelInfo[] = [
-  {
-    id: DyFM_AAI_Model.claude_opus_4_8,
-    provider: DyFM_AI_Provider.Anthropic,
-    modelType: DyFM_AI_ModelType.Chat,
-    displayName: 'Claude Opus 4.8',
-    tier: 'Opus',
-    status: 'ga',
-    contextWindow: 1_000_000,
-    maxOutputTokens: 128_000,
-    capabilities: {
-      functionCalling: true,
-      vision: true,
-      streaming: true,
-      jsonMode: false,
-      audioInput: false,
-      audioOutput: false,
-      imageGeneration: false,
-      embeddings: false,
-      adultContent: false,
-    },
-  },
-  {
-    id: DyFM_AAI_Model.claude_sonnet_4_6,
-    provider: DyFM_AI_Provider.Anthropic,
-    modelType: DyFM_AI_ModelType.Chat,
-    displayName: 'Claude Sonnet 4.6',
-    tier: 'Sonnet',
-    status: 'ga',
-    contextWindow: 1_000_000,
-    maxOutputTokens: 64_000,
-    capabilities: {
-      functionCalling: true,
-      vision: true,
-      streaming: true,
-      jsonMode: false,
-      audioInput: false,
-      audioOutput: false,
-      imageGeneration: false,
-      embeddings: false,
-      adultContent: false,
-    },
-  },
-  {
-    id: DyFM_AAI_Model.claude_haiku_4_5,
-    provider: DyFM_AI_Provider.Anthropic,
-    modelType: DyFM_AI_ModelType.Chat,
-    displayName: 'Claude Haiku 4.5',
-    tier: 'Haiku',
-    status: 'ga',
-    contextWindow: 200_000,
-    maxOutputTokens: 64_000,
-    capabilities: {
-      functionCalling: true,
-      vision: true,
-      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_AAI_Model } from '../_enums/aai-model.enum';
+
+/**
+ * Anthropic Claude model registry — verified 2026-06-01 against platform.claude.com docs.
+ *
+ * All Claude models are chat (Messages API) models — Anthropic has NO embeddings API.
+ * Tool use is universal (content-block `tool_use` / `tool_result` wire format).
+ * Anthropic has no dedicated JSON-mode flag (structured output is done via tools),
+ * so `jsonMode` is false across the board.
+ *
+ * Param note (translator): Opus 4.7+ reject `temperature`/`top_p`/`top_k` with 400 —
+ * not modelled here, handled in the Anthropic call translator.
+ */
+export const DyFM_AAI_Models: DyFM_AI_ModelInfo[] = [
+  {
+    id: DyFM_AAI_Model.claude_opus_4_8,
+    provider: DyFM_AI_Provider.Anthropic,
+    modelType: DyFM_AI_ModelType.Chat,
+    displayName: 'Claude Opus 4.8',
+    tier: 'Opus',
+    status: 'ga',
+    contextWindow: 1_000_000,
+    maxOutputTokens: 128_000,
+    capabilities: {
+      functionCalling: true,
+      vision: true,
+      streaming: true,
+      jsonMode: false,
+      audioInput: false,
+      audioOutput: false,
+      imageGeneration: false,
+      embeddings: false,
+      adultContent: false,
+    },
+  },
+  {
+    id: DyFM_AAI_Model.claude_sonnet_4_6,
+    provider: DyFM_AI_Provider.Anthropic,
+    modelType: DyFM_AI_ModelType.Chat,
+    displayName: 'Claude Sonnet 4.6',
+    tier: 'Sonnet',
+    status: 'ga',
+    contextWindow: 1_000_000,
+    maxOutputTokens: 64_000,
+    capabilities: {
+      functionCalling: true,
+      vision: true,
+      streaming: true,
+      jsonMode: false,
+      audioInput: false,
+      audioOutput: false,
+      imageGeneration: false,
+      embeddings: false,
+      adultContent: false,
+    },
+  },
+  {
+    id: DyFM_AAI_Model.claude_haiku_4_5,
+    provider: DyFM_AI_Provider.Anthropic,
+    modelType: DyFM_AI_ModelType.Chat,
+    displayName: 'Claude Haiku 4.5',
+    tier: 'Haiku',
+    status: 'ga',
+    contextWindow: 200_000,
+    maxOutputTokens: 64_000,
+    capabilities: {
+      functionCalling: true,
+      vision: true,
+      streaming: true,
+      jsonMode: false,
+      audioInput: false,
+      audioOutput: false,
+      imageGeneration: false,
+      embeddings: false,
+      adultContent: false,
+    },
+  },
+];

package/src/_modules/ai/_modules/anthropic/_enums/aai-model.enum.ts

@@ -1,19 +1,19 @@
-// Based on @anthropic-ai/sdk model identifiers
-export enum DyFM_AAI_Model {
-  // Current GA (verified 2026-06). From the 4.6 generation the ids are
-  // dateless-but-pinned snapshots — there is NO `-latest` alias for these.
-  claude_opus_4_8 = 'claude-opus-4-8',
-  claude_sonnet_4_6 = 'claude-sonnet-4-6',
-  claude_haiku_4_5 = 'claude-haiku-4-5',
-  claude_haiku_4_5_20251001 = 'claude-haiku-4-5-20251001',
-
-  // Legacy / retired (kept for back-compat; NOT in the active registry)
-  claude_3_5_sonnet_latest = 'claude-3-5-sonnet-latest',
-  claude_3_5_sonnet_20241022 = 'claude-3-5-sonnet-20241022',
-  claude_3_5_haiku_latest = 'claude-3-5-haiku-latest',
-  claude_3_opus_latest = 'claude-3-opus-latest',
-  claude_3_sonnet_latest = 'claude-3-sonnet-latest',
-  claude_3_haiku_latest = 'claude-3-haiku-latest',
-}
-
-
+// Based on @anthropic-ai/sdk model identifiers
+export enum DyFM_AAI_Model {
+  // Current GA (verified 2026-06). From the 4.6 generation the ids are
+  // dateless-but-pinned snapshots — there is NO `-latest` alias for these.
+  claude_opus_4_8 = 'claude-opus-4-8',
+  claude_sonnet_4_6 = 'claude-sonnet-4-6',
+  claude_haiku_4_5 = 'claude-haiku-4-5',
+  claude_haiku_4_5_20251001 = 'claude-haiku-4-5-20251001',
+
+  // Legacy / retired (kept for back-compat; NOT in the active registry)
+  claude_3_5_sonnet_latest = 'claude-3-5-sonnet-latest',
+  claude_3_5_sonnet_20241022 = 'claude-3-5-sonnet-20241022',
+  claude_3_5_haiku_latest = 'claude-3-5-haiku-latest',
+  claude_3_opus_latest = 'claude-3-opus-latest',
+  claude_3_sonnet_latest = 'claude-3-sonnet-latest',
+  claude_3_haiku_latest = 'claude-3-haiku-latest',
+}
+
+

package/src/_modules/ai/_modules/anthropic/_models/aai-call-settings.control-model.spec.ts

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

package/src/_modules/ai/_modules/anthropic/_models/aai-call-settings.control-model.ts

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

package/src/_modules/ai/_modules/anthropic/_models/aai-client-options.interface.ts

@@ -1,10 +1,10 @@
-export interface DyFM_AAI_ClientOptions {
-  /** Defaults to process.env['ANTHROPIC_API_KEY'] */
-  apiKey?: string;
-  /** Optional base URL override */
-  baseURL?: string;
-  /** Optional timeout in ms */
-  timeout?: number;
-}
-
-
+export interface DyFM_AAI_ClientOptions {
+  /** Defaults to process.env['ANTHROPIC_API_KEY'] */
+  apiKey?: string;
+  /** Optional base URL override */
+  baseURL?: string;
+  /** Optional timeout in ms */
+  timeout?: number;
+}
+
+

package/src/_modules/ai/_modules/anthropic/_models/aai-settings.control-model.spec.ts

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

package/src/_modules/ai/_modules/anthropic/_models/aai-settings.control-model.ts

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

package/src/_modules/ai/_modules/anthropic/_models/aai-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';
-
-/**
- * Anthropic-specifikus user provider konfiguracio
- */
-export class DyFM_AAI_UserProviderConfig extends DyFM_AI_UserProviderConfig {
-  override provider?: DyFM_AI_Provider = DyFM_AI_Provider.Anthropic;
-  baseURL?: string;
-
-  constructor(
-    set?: DyFM_AAI_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';
+
+/**
+ * Anthropic-specifikus user provider konfiguracio
+ */
+export class DyFM_AAI_UserProviderConfig extends DyFM_AI_UserProviderConfig {
+  override provider?: DyFM_AI_Provider = DyFM_AI_Provider.Anthropic;
+  baseURL?: string;
+
+  constructor(
+    set?: DyFM_AAI_UserProviderConfig
+  ) {
+    super(set);
+
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}

package/src/_modules/ai/_modules/anthropic/index.ts

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

package/src/_modules/ai/_modules/document-ai/_models/dai-embedding-info.interface.ts

@@ -1,12 +1,12 @@
-import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
-
-/**
- * Information about the embedding model used for vectorization
- * Stores model details to ensure consistency between document creation and search
- */
-export interface DyFM_DAI_EmbeddingInfo {
-  /** The AI provider that generated the embedding */
-  provider: DyFM_AI_Provider;
-  /** The specific model name used */
-  model: string;
-}
+import { DyFM_AI_Provider } from '../../../_enums/ai-provider.enum';
+
+/**
+ * Information about the embedding model used for vectorization
+ * Stores model details to ensure consistency between document creation and search
+ */
+export interface DyFM_DAI_EmbeddingInfo {
+  /** The AI provider that generated the embedding */
+  provider: DyFM_AI_Provider;
+  /** The specific model name used */
+  model: string;
+}