@futdevpro/fsm-dynamo 1.16.4 → 1.16.7

package/src/_modules/ai/_collections/ai-model-registry.util.ts

@@ -1,30 +1,30 @@
-import { DyFM_AI_ModelInfo } from '../_models/ai-model-info.interface';
-
-/**
- * Lookups over a per-provider model registry (`DyFM_OAI_Models`, `DyFM_AAI_Models`, …).
- *
- * The registry array is passed IN — this keeps the agnostic `./ai` core free of
- * any provider-submodule dependency (the execution-layer service supplies its own
- * provider's registry). The lookup is by exact API model `id`.
- */
-export class DyFM_AI_ModelRegistry_Util {
-
-  /**
-   * A modell-descriptor megkeresese id alapjan a megadott registry-ben.
-   * @param models - a provider registry tomb (pl. DyFM_OAI_Models)
-   * @param id - pontos API modell-azonosito (pl. 'gpt-5.5')
-   */
-  static findModelInfo(models: DyFM_AI_ModelInfo[], id: string): DyFM_AI_ModelInfo | undefined {
-    return models.find((model: DyFM_AI_ModelInfo) => model.id === id);
-  }
-
-  /**
-   * Tamogatja-e a modell a function calling-ot (tool use)?
-   * Ismeretlen id eseten `false` (honesty — soha ne feltetelezzunk tool-kepesseget).
-   * @param models - a provider registry tomb
-   * @param id - pontos API modell-azonosito
-   */
-  static modelSupportsTools(models: DyFM_AI_ModelInfo[], id: string): boolean {
-    return DyFM_AI_ModelRegistry_Util.findModelInfo(models, id)?.capabilities?.functionCalling ?? false;
-  }
-}
+import { DyFM_AI_ModelInfo } from '../_models/ai-model-info.interface';
+
+/**
+ * Lookups over a per-provider model registry (`DyFM_OAI_Models`, `DyFM_AAI_Models`, …).
+ *
+ * The registry array is passed IN — this keeps the agnostic `./ai` core free of
+ * any provider-submodule dependency (the execution-layer service supplies its own
+ * provider's registry). The lookup is by exact API model `id`.
+ */
+export class DyFM_AI_ModelRegistry_Util {
+
+  /**
+   * A modell-descriptor megkeresese id alapjan a megadott registry-ben.
+   * @param models - a provider registry tomb (pl. DyFM_OAI_Models)
+   * @param id - pontos API modell-azonosito (pl. 'gpt-5.5')
+   */
+  static findModelInfo(models: DyFM_AI_ModelInfo[], id: string): DyFM_AI_ModelInfo | undefined {
+    return models.find((model: DyFM_AI_ModelInfo) => model.id === id);
+  }
+
+  /**
+   * Tamogatja-e a modell a function calling-ot (tool use)?
+   * Ismeretlen id eseten `false` (honesty — soha ne feltetelezzunk tool-kepesseget).
+   * @param models - a provider registry tomb
+   * @param id - pontos API modell-azonosito
+   */
+  static modelSupportsTools(models: DyFM_AI_ModelInfo[], id: string): boolean {
+    return DyFM_AI_ModelRegistry_Util.findModelInfo(models, id)?.capabilities?.functionCalling ?? false;
+  }
+}

package/src/_modules/ai/_enums/ai-message-role.enum.ts

@@ -1,7 +1,7 @@
-export enum DyFM_AI_MessageRole {
-  system = 'system',
-  user = 'user',
-  assistant = 'assistant',
-  /** Tool-result message (function calling). Provider translators map this to their native shape. */
-  tool = 'tool',
-}
+export enum DyFM_AI_MessageRole {
+  system = 'system',
+  user = 'user',
+  assistant = 'assistant',
+  /** Tool-result message (function calling). Provider translators map this to their native shape. */
+  tool = 'tool',
+}

package/src/_modules/ai/_enums/ai-model-type.enum.ts

@@ -1,7 +1,7 @@
-export enum DyFM_AI_ModelType {
-  LLM = 'llm',
-  Embedding = 'embedding',
-  Chat = 'chat',
-  Image = 'image',
-  Audio = 'audio',
-}
+export enum DyFM_AI_ModelType {
+  LLM = 'llm',
+  Embedding = 'embedding',
+  Chat = 'chat',
+  Image = 'image',
+  Audio = 'audio',
+}

package/src/_modules/ai/_enums/ai-provider.enum.ts

@@ -1,7 +1,7 @@
-export enum DyFM_AI_Provider {
-  OpenAI = 'open-ai',
-  Anthropic = 'anthropic',
-  Google = 'google',
-  LocalAI = 'local-ai',
-  FdpAI = 'fdp-ai',
-}
+export enum DyFM_AI_Provider {
+  OpenAI = 'open-ai',
+  Anthropic = 'anthropic',
+  Google = 'google',
+  LocalAI = 'local-ai',
+  FdpAI = 'fdp-ai',
+}

package/src/_modules/ai/_models/ai-call-settings.interface.ts

@@ -1,84 +1,84 @@
-/**
- * Agnostic LLM call settings — the provider-neutral tuning bag.
- *
- * The typed fields below are the common, broadly-supported knobs. The
- * `[key: string]: any` escape hatch carries provider/model-specific params
- * until they are first-classed.
- *
- * IMPORTANT — per-model variance (FR-048, reserved): NOT every model accepts
- * every field here, and sending an unsupported param can hard-fail the call
- * (e.g. Anthropic Opus 4.7+ rejects `temperature`/`topP`/`topK` with HTTP 400;
- * reasoning models take an extra `reasoningEffort`; pro models drop streaming).
- * This flat bag intentionally does NOT encode those constraints — the future
- * per-model settings system ({@link DyFM_AI_ModelSettingsSchema} on the model
- * registry + a reconciler in `DyNTS_AI_LLM_ServiceBase`) will validate, clamp,
- * and drop params against what each model actually accepts. Until then,
- * provider translators drop model-rejected params locally (see FR-047 Phase 4
- * Anthropic). Do not assume a field here is universally accepted.
- *
- * See: `__agent/feature-requests/FR-048-per-model-agnostic-settings.md`
- *      `documentations/guidelines/development/ai-per-model-settings.md`
- */
-export class DyFM_AI_CallSettings {
-  systemPrompt?: string = '';
-  useModel?: string;
-  project?: string;
-  debugLog?: boolean;
-  
-  /**
-   * This parameter controls the randomness and creativity of the generated output.   
-   *   
-   * Lower values (e.g., 0.2) produce more focused, predictable results,   
-   * while higher values (e.g., 0.8) introduce more variation and unexpected outputs,   
-   * making the model more creative and exploratory.     
-   *   
-   * Adjust this setting to balance between creativity and consistency.  
-   */
-  temperature?: number = 0;
-  /**
-   * Defines the upper limit of tokens (words or parts of words)   
-   * the model can generate in a single response.   
-   *   
-   * The total token count includes both the input (prompt) and the output (response).   
-   *   
-   * You can allocate up to 4096 tokens per request, but be mindful of prompt length,   
-   * as it affects how many tokens remain for the response.
-   */
-  maxTokens?: number = 2000;
-  /**
-   * This parameter adjusts the diversity of the output using nucleus sampling,   
-   * where the model considers tokens based on cumulative probability.   
-   *   
-   * A value of 0.5 ensures that only the most likely half of all possible tokens   
-   * are considered, while increasing the value (up to 1)   
-   * allows for a broader range of token options, leading to more varied responses.
-   */
-  topP?: number = 0.75;
-  /**
-   * This setting penalizes tokens that have already appeared frequently in the generated text,   
-   * discouraging repetition and encouraging the model to introduce new content.    
-   *   
-   * Higher values result in less repetition, making the output more diverse.   
-   */
-  frequencyPenalty?: number = 0;
-  /**
-   * This parameter influences the model by penalizing tokens based on   
-   * their presence in the text so far.   
-   *   
-   * It encourages the introduction of new topics or ideas by reducing the likelihood of   
-   * generating tokens that have already appeared,   
-   * helping to keep the conversation or text more varied and engaging.
-   */
-  presencePenalty?: number = 0;
-
-  // Allow provider-specific fields
-  [key: string]: any;
-
-  constructor(
-    set?: DyFM_AI_CallSettings
-  ) {
-    if (set) {
-      Object.assign(this, set);
-    }
-  }
-}
+/**
+ * Agnostic LLM call settings — the provider-neutral tuning bag.
+ *
+ * The typed fields below are the common, broadly-supported knobs. The
+ * `[key: string]: any` escape hatch carries provider/model-specific params
+ * until they are first-classed.
+ *
+ * IMPORTANT — per-model variance (FR-048, reserved): NOT every model accepts
+ * every field here, and sending an unsupported param can hard-fail the call
+ * (e.g. Anthropic Opus 4.7+ rejects `temperature`/`topP`/`topK` with HTTP 400;
+ * reasoning models take an extra `reasoningEffort`; pro models drop streaming).
+ * This flat bag intentionally does NOT encode those constraints — the future
+ * per-model settings system ({@link DyFM_AI_ModelSettingsSchema} on the model
+ * registry + a reconciler in `DyNTS_AI_LLM_ServiceBase`) will validate, clamp,
+ * and drop params against what each model actually accepts. Until then,
+ * provider translators drop model-rejected params locally (see FR-047 Phase 4
+ * Anthropic). Do not assume a field here is universally accepted.
+ *
+ * See: `__agent/feature-requests/FR-048-per-model-agnostic-settings.md`
+ *      `documentations/guidelines/development/ai-per-model-settings.md`
+ */
+export class DyFM_AI_CallSettings {
+  systemPrompt?: string = '';
+  useModel?: string;
+  project?: string;
+  debugLog?: boolean;
+  
+  /**
+   * This parameter controls the randomness and creativity of the generated output.   
+   *   
+   * Lower values (e.g., 0.2) produce more focused, predictable results,   
+   * while higher values (e.g., 0.8) introduce more variation and unexpected outputs,   
+   * making the model more creative and exploratory.     
+   *   
+   * Adjust this setting to balance between creativity and consistency.  
+   */
+  temperature?: number = 0;
+  /**
+   * Defines the upper limit of tokens (words or parts of words)   
+   * the model can generate in a single response.   
+   *   
+   * The total token count includes both the input (prompt) and the output (response).   
+   *   
+   * You can allocate up to 4096 tokens per request, but be mindful of prompt length,   
+   * as it affects how many tokens remain for the response.
+   */
+  maxTokens?: number = 2000;
+  /**
+   * This parameter adjusts the diversity of the output using nucleus sampling,   
+   * where the model considers tokens based on cumulative probability.   
+   *   
+   * A value of 0.5 ensures that only the most likely half of all possible tokens   
+   * are considered, while increasing the value (up to 1)   
+   * allows for a broader range of token options, leading to more varied responses.
+   */
+  topP?: number = 0.75;
+  /**
+   * This setting penalizes tokens that have already appeared frequently in the generated text,   
+   * discouraging repetition and encouraging the model to introduce new content.    
+   *   
+   * Higher values result in less repetition, making the output more diverse.   
+   */
+  frequencyPenalty?: number = 0;
+  /**
+   * This parameter influences the model by penalizing tokens based on   
+   * their presence in the text so far.   
+   *   
+   * It encourages the introduction of new topics or ideas by reducing the likelihood of   
+   * generating tokens that have already appeared,   
+   * helping to keep the conversation or text more varied and engaging.
+   */
+  presencePenalty?: number = 0;
+
+  // Allow provider-specific fields
+  [key: string]: any;
+
+  constructor(
+    set?: DyFM_AI_CallSettings
+  ) {
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}

package/src/_modules/ai/_models/ai-embedding-request.interface.ts

@@ -1,20 +1,20 @@
-/**
- * Generic embedding request structure
- * Used by all AI providers for embedding operations
- */
-export interface DyFM_AI_Embedding_Request {
-  text: string;
-  model: string;
-  issuer: string;
-  debugLog?: boolean;
-}
-
-/**
- * Batch embedding request for multiple texts
- */
-export interface DyFM_AI_Embedding_Batch_Request {
-  texts: string[];
-  model: string;
-  issuer: string;
-  debugLog?: boolean;
-}
+/**
+ * Generic embedding request structure
+ * Used by all AI providers for embedding operations
+ */
+export interface DyFM_AI_Embedding_Request {
+  text: string;
+  model: string;
+  issuer: string;
+  debugLog?: boolean;
+}
+
+/**
+ * Batch embedding request for multiple texts
+ */
+export interface DyFM_AI_Embedding_Batch_Request {
+  texts: string[];
+  model: string;
+  issuer: string;
+  debugLog?: boolean;
+}

package/src/_modules/ai/_models/ai-embedding-response.interface.ts

@@ -1,26 +1,26 @@
-/**
- * Generic embedding response structure
- * Used by all AI providers for embedding operations
- */
-export interface DyFM_AI_Embedding_Response {
-  embedding: number[];
-  model: string;
-  usage?: {
-    promptTokens: number;
-    totalTokens: number;
-  };
-  rawResponse?: any; // Provider-specific raw response
-}
-
-/**
- * Batch embedding response for multiple texts
- */
-export interface DyFM_AI_Embedding_Batch_Response {
-  embeddings: number[][];
-  model: string;
-  usage?: {
-    promptTokens: number;
-    totalTokens: number;
-  };
-  rawResponse?: any; // Provider-specific raw response
-}
+/**
+ * Generic embedding response structure
+ * Used by all AI providers for embedding operations
+ */
+export interface DyFM_AI_Embedding_Response {
+  embedding: number[];
+  model: string;
+  usage?: {
+    promptTokens: number;
+    totalTokens: number;
+  };
+  rawResponse?: any; // Provider-specific raw response
+}
+
+/**
+ * Batch embedding response for multiple texts
+ */
+export interface DyFM_AI_Embedding_Batch_Response {
+  embeddings: number[][];
+  model: string;
+  usage?: {
+    promptTokens: number;
+    totalTokens: number;
+  };
+  rawResponse?: any; // Provider-specific raw response
+}

package/src/_modules/ai/_models/ai-llm-request.interface.ts

@@ -1,24 +1,24 @@
-import { DyFM_AI_Message } from './ai-message.interface';
-import { DyFM_AI_CallSettings } from './ai-call-settings.interface';
-
-/**
- * Generic LLM request structure
- * Used by all AI providers for LLM operations
- */
-export interface DyFM_AI_LLM_Request {
-  messages: DyFM_AI_Message[];
-  settings?: DyFM_AI_CallSettings;
-  issuer: string;
-  debugLog?: boolean;
-}
-
-/**
- * Simple LLM request with system and user messages
- */
-export interface DyFM_AI_LLM_Simple_Request {
-  systemMessage: string;
-  userMessage: string;
-  settings?: DyFM_AI_CallSettings;
-  issuer: string;
-  debugLog?: boolean;
-}
+import { DyFM_AI_Message } from './ai-message.interface';
+import { DyFM_AI_CallSettings } from './ai-call-settings.interface';
+
+/**
+ * Generic LLM request structure
+ * Used by all AI providers for LLM operations
+ */
+export interface DyFM_AI_LLM_Request {
+  messages: DyFM_AI_Message[];
+  settings?: DyFM_AI_CallSettings;
+  issuer: string;
+  debugLog?: boolean;
+}
+
+/**
+ * Simple LLM request with system and user messages
+ */
+export interface DyFM_AI_LLM_Simple_Request {
+  systemMessage: string;
+  userMessage: string;
+  settings?: DyFM_AI_CallSettings;
+  issuer: string;
+  debugLog?: boolean;
+}

package/src/_modules/ai/_models/ai-llm-response.interface.ts

@@ -1,30 +1,30 @@
-import { DyFM_AI_Message } from './ai-message.interface';
-import { DyFM_AI_ToolCall } from './ai-tool-call.interface';
-
-/**
- * Generic LLM response structure
- * Used by all AI providers for LLM operations
- */
-export interface DyFM_AI_LLM_Response {
-  content: string;
-  usage?: {
-    promptTokens: number;
-    completionTokens: number;
-    totalTokens: number;
-  };
-  model?: string;
-  finishReason?: string;
-  /** Present when the model requested tool calls (function calling); normalized across providers. */
-  toolCalls?: DyFM_AI_ToolCall[];
-  /** Normalized stop reason (e.g. 'tool_use', 'stop', 'length'). */
-  stopReason?: string;
-  rawResponse?: any; // Provider-specific raw response
-}
-
-/**
- * Raw LLM response with full provider details
- */
-export interface DyFM_AI_LLM_Raw_Response extends DyFM_AI_LLM_Response {
-  messages: DyFM_AI_Message[];
-  rawResponse: any;
-}
+import { DyFM_AI_Message } from './ai-message.interface';
+import { DyFM_AI_ToolCall } from './ai-tool-call.interface';
+
+/**
+ * Generic LLM response structure
+ * Used by all AI providers for LLM operations
+ */
+export interface DyFM_AI_LLM_Response {
+  content: string;
+  usage?: {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+  };
+  model?: string;
+  finishReason?: string;
+  /** Present when the model requested tool calls (function calling); normalized across providers. */
+  toolCalls?: DyFM_AI_ToolCall[];
+  /** Normalized stop reason (e.g. 'tool_use', 'stop', 'length'). */
+  stopReason?: string;
+  rawResponse?: any; // Provider-specific raw response
+}
+
+/**
+ * Raw LLM response with full provider details
+ */
+export interface DyFM_AI_LLM_Raw_Response extends DyFM_AI_LLM_Response {
+  messages: DyFM_AI_Message[];
+  rawResponse: any;
+}

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

@@ -1,12 +1,12 @@
-import { DyFM_AI_MessageRole } from '../_enums/ai-message-role.enum';
-import { DyFM_AI_ToolCall } from './ai-tool-call.interface';
-
-export interface DyFM_AI_Message {
-  role: DyFM_AI_MessageRole;
-  content: string;
-  /** Present on an assistant turn that requested tool calls (function calling). */
-  toolCalls?: DyFM_AI_ToolCall[];
-  /** Present on a `tool`-role message — which {@link DyFM_AI_ToolCall.id} this result answers. */
-  toolCallId?: string;
-}
-
+import { DyFM_AI_MessageRole } from '../_enums/ai-message-role.enum';
+import { DyFM_AI_ToolCall } from './ai-tool-call.interface';
+
+export interface DyFM_AI_Message {
+  role: DyFM_AI_MessageRole;
+  content: string;
+  /** Present on an assistant turn that requested tool calls (function calling). */
+  toolCalls?: DyFM_AI_ToolCall[];
+  /** Present on a `tool`-role message — which {@link DyFM_AI_ToolCall.id} this result answers. */
+  toolCallId?: string;
+}
+

package/src/_modules/ai/_models/ai-model-capabilities.interface.ts

@@ -1,35 +1,35 @@
-/**
- * Per-model capability flags.
- *
- * Where {@link DyFM_AI_ProviderCapabilities} describes what a PROVIDER can do
- * in aggregate, this describes what a single concrete MODEL supports. This is
- * the honest source of truth for feature-gating: e.g. an embedding model has
- * functionCalling=false, a reasoning chat model has functionCalling=true, a
- * local generic model may have functionCalling decided at runtime.
- */
-export interface DyFM_AI_ModelCapabilities {
-  /** Native function calling / tool use. The driver for the tool-calling feature. */
-  functionCalling: boolean;
-  /** Image input (vision). */
-  vision: boolean;
-  /** Streaming responses. */
-  streaming: boolean;
-  /** Structured output / JSON mode (OpenAI structured outputs, Gemini responseSchema, etc.). */
-  jsonMode: boolean;
-  /** Audio input (speech-to-text / audio understanding). */
-  audioInput: boolean;
-  /** Audio output (text-to-speech / speech generation). */
-  audioOutput: boolean;
-  /** Image generation (the model produces images). */
-  imageGeneration: boolean;
-  /** Embedding generation (vector output). */
-  embeddings: boolean;
-  /**
-   * Can generate adult / uncensored / NSFW content (no content-policy refusal on
-   * mature themes). Mainstream cloud models (OpenAI, Anthropic, Google) are filtered
-   * → false. Uncensored / local models may set true. Used for content-routing and
-   * age-gating (e.g. Adventor mature mode). For generic local models this is
-   * model-dependent — confirm per loaded model rather than assume.
-   */
-  adultContent: boolean;
-}
+/**
+ * Per-model capability flags.
+ *
+ * Where {@link DyFM_AI_ProviderCapabilities} describes what a PROVIDER can do
+ * in aggregate, this describes what a single concrete MODEL supports. This is
+ * the honest source of truth for feature-gating: e.g. an embedding model has
+ * functionCalling=false, a reasoning chat model has functionCalling=true, a
+ * local generic model may have functionCalling decided at runtime.
+ */
+export interface DyFM_AI_ModelCapabilities {
+  /** Native function calling / tool use. The driver for the tool-calling feature. */
+  functionCalling: boolean;
+  /** Image input (vision). */
+  vision: boolean;
+  /** Streaming responses. */
+  streaming: boolean;
+  /** Structured output / JSON mode (OpenAI structured outputs, Gemini responseSchema, etc.). */
+  jsonMode: boolean;
+  /** Audio input (speech-to-text / audio understanding). */
+  audioInput: boolean;
+  /** Audio output (text-to-speech / speech generation). */
+  audioOutput: boolean;
+  /** Image generation (the model produces images). */
+  imageGeneration: boolean;
+  /** Embedding generation (vector output). */
+  embeddings: boolean;
+  /**
+   * Can generate adult / uncensored / NSFW content (no content-policy refusal on
+   * mature themes). Mainstream cloud models (OpenAI, Anthropic, Google) are filtered
+   * → false. Uncensored / local models may set true. Used for content-routing and
+   * age-gating (e.g. Adventor mature mode). For generic local models this is
+   * model-dependent — confirm per loaded model rather than assume.
+   */
+  adultContent: boolean;
+}