@futdevpro/nts-dynamo 1.15.104 → 1.15.107

package/src/_modules/ai/index.ts

@@ -1,23 +1,33 @@
-// Re-export from FSM
-export * from '@futdevpro/fsm-dynamo/ai';
-
-// AI Input Interfaces (moved from FSM)
-export * from './_models/ai-input-interfaces';
-export * from './_models/ai-test-generation-result.interface';
-
-// Cost-event interfaces (BFR-AM-007) — a consumer (CCAP / FAM) ezekkel típusozza az `onCostEvent`
-// callback-jét; ezért barrel-export kell (M3, FAM-REV bedrock-fix).
-export * from './_models/interfaces/dynts-ai-cost-event.interface';
-export * from './_models/interfaces/dynts-ai-cost-event-callback.interface';
-
-// Abstract Services
-export * from './_services/ai-provider.service-base';
-export * from './_services/ai-llm.service-base';
-export * from './_services/ai-llm-chat.service-base';
-export * from './_services/ai-embedding.service-base';
-export * from './_services/ai-user-key.service-base';
-
-// Concrete Embedding Services + provider-dispatch (BFR-AM-002 / 007 / 008)
-export * from './_services/lmstudio-embedding.control-service';
-export * from './_services/ai-embedding-mock.service';
-export * from './_services/ai-embedding-provider.registry';
+// Re-export from FSM
+export * from '@futdevpro/fsm-dynamo/ai';
+
+// AI Input Interfaces (moved from FSM)
+export * from './_models/ai-input-interfaces';
+export * from './_models/ai-test-generation-result.interface';
+
+// Cost-event interfaces (BFR-AM-007) — a consumer (CCAP / FAM) ezekkel típusozza az `onCostEvent`
+// callback-jét; ezért barrel-export kell (M3, FAM-REV bedrock-fix).
+export * from './_models/interfaces/dynts-ai-cost-event.interface';
+export * from './_models/interfaces/dynts-ai-cost-event-callback.interface';
+
+// FR-048 per-model settings — provider-faithful hiba-alak + validate-mode (production pre-validation).
+// A reconciler (`DyNTS_AI_LLM_ServiceBase.reconcileCallSettings`) testvére: UGYANAZ a `settingsSchema` forrás.
+export * from './_models/interfaces/dynts-ai-provider-error.interface';
+export * from './_collections/ai-provider-error.util';
+export * from './_collections/ai-model-config-validator.util';
+
+// Abstract Services
+export * from './_services/ai-provider.service-base';
+export * from './_services/ai-llm.service-base';
+export * from './_services/ai-llm-chat.service-base';
+export * from './_services/ai-embedding.service-base';
+export * from './_services/ai-user-key.service-base';
+
+// Concrete Embedding Services + provider-dispatch (BFR-AM-002 / 007 / 008)
+export * from './_services/lmstudio-embedding.control-service';
+export * from './_services/ai-embedding-provider.registry';
+
+// BACKWARD-COMPAT (MP-5 SP-5.1): a determinisztikus embedding-mock FIZIKAILAG az `ai-mock` submodulba
+// koltozott (`./_modules/ai-mock/_services/`), de a `@futdevpro/nts-dynamo/ai` import-utvonal VALTOZATLAN —
+// a meglevo consumer (FAM `EMBEDDING_PROVIDER=mock`) nem torik. Uj kod inkabb `@futdevpro/nts-dynamo/ai/ai-mock`.
+export * from './_modules/ai-mock/_services/ai-embedding-mock.service';

package/src/_modules/assistant/_collections/ass-global-settings.const.ts

@@ -1,13 +1,13 @@
-import { DyNTS_Ass_Global_Settings } from '../_models/ass-global-settings.interface';
-
-export const DyNTS_Ass_global_settings: DyNTS_Ass_Global_Settings = {
-  defaultSystemPrompt: 'You are a helpful assistant.',
-  skipConversationMessagesFlags: [ 
-    '[NOISE]', 
-    '[VOICE|USER|OUTOFCONTEXT]', 
-    '[DEBUG|' 
-  ],
-  userTranslationFlags: [ 
-    '[VOICE|USER' 
-  ],
-};
+import { DyNTS_Ass_Global_Settings } from '../_models/ass-global-settings.interface';
+
+export const DyNTS_Ass_global_settings: DyNTS_Ass_Global_Settings = {
+  defaultSystemPrompt: 'You are a helpful assistant.',
+  skipConversationMessagesFlags: [ 
+    '[NOISE]', 
+    '[VOICE|USER|OUTOFCONTEXT]', 
+    '[DEBUG|' 
+  ],
+  userTranslationFlags: [ 
+    '[VOICE|USER' 
+  ],
+};

package/src/_modules/assistant/_collections/ass.util.spec.ts

@@ -1,176 +1,176 @@
-
-import { DyFM_AI_Message, DyFM_AI_MessageRole } from '@futdevpro/fsm-dynamo/ai';
-import { DyNTS_Ass_Util } from './ass.util';
-import { DyNTS_Bot_MessageWrapper } from '../../bot/_models/bot-message-wrapper.interface';
-import { DyNTS_Ass_global_settings } from './ass-global-settings.const';
-
-describe('| DyNTS_Ass_Util', () => {
-  describe('| convertBotMessagesToAIConversation', () => {
-    it('| should convert bot messages to AI conversation format', () => {
-      const messages: DyNTS_Bot_MessageWrapper<any>[] = [
-        {
-          id: 'msg-1',
-          content: 'User message',
-          authorId: 'user-123',
-          authorName: 'user',
-          isBot: false,
-        } as any,
-        {
-          id: 'msg-2',
-          content: 'Bot response',
-          authorId: 'bot-123',
-          authorName: 'bot',
-          isBot: true,
-        } as any,
-      ];
-
-      const result = DyNTS_Ass_Util.convertBotMessagesToAIConversation({
-        messages: messages,
-        botClientId: 'bot-123',
-        botDisplayName: 'Bot',
-        issuer: 'issuer-123',
-      });
-
-      expect(result.length).toBe(2);
-      expect(result[0].role).toBe(DyFM_AI_MessageRole.user);
-      expect(result[0].content).toBe('User message');
-      expect(result[1].role).toBe(DyFM_AI_MessageRole.assistant);
-      expect(result[1].content).toBe('Bot response');
-    });
-
-    it('| should identify bot messages by isBot flag', () => {
-      const messages: DyNTS_Bot_MessageWrapper<any>[] = [
-        {
-          id: 'msg-1',
-          content: 'Message',
-          authorId: 'bot-123',
-          isBot: true,
-        } as any,
-      ];
-
-      const result = DyNTS_Ass_Util.convertBotMessagesToAIConversation({
-        messages: messages,
-        botClientId: 'bot-123',
-        botDisplayName: 'Bot',
-        issuer: 'issuer-123',
-      });
-
-      expect(result[0].role).toBe(DyFM_AI_MessageRole.assistant);
-    });
-
-    it('| should identify bot messages by authorId match', () => {
-      const messages: DyNTS_Bot_MessageWrapper<any>[] = [
-        {
-          id: 'msg-1',
-          content: 'Message',
-          authorId: 'bot-123',
-          isBot: false,
-        } as any,
-      ];
-
-      const result = DyNTS_Ass_Util.convertBotMessagesToAIConversation({
-        messages: messages,
-        botClientId: 'bot-123',
-        botDisplayName: 'Bot',
-        issuer: 'issuer-123',
-      });
-
-      expect(result[0].role).toBe(DyFM_AI_MessageRole.assistant);
-    });
-
-    it('| should identify bot messages by authorName match', () => {
-      const messages: DyNTS_Bot_MessageWrapper<any>[] = [
-        {
-          id: 'msg-1',
-          content: 'Message',
-          authorId: 'other-123',
-          authorName: 'Bot',
-          isBot: false,
-        } as any,
-      ];
-
-      const result = DyNTS_Ass_Util.convertBotMessagesToAIConversation({
-        messages: messages,
-        botClientId: 'bot-123',
-        botDisplayName: 'Bot',
-        issuer: 'issuer-123',
-      });
-
-      expect(result[0].role).toBe(DyFM_AI_MessageRole.assistant);
-    });
-
-    it('| should identify bot messages by authorDisplayName match', () => {
-      const messages: DyNTS_Bot_MessageWrapper<any>[] = [
-        {
-          id: 'msg-1',
-          content: 'Message',
-          authorId: 'other-123',
-          authorDisplayName: 'Bot',
-          isBot: false,
-        } as any,
-      ];
-
-      const result = DyNTS_Ass_Util.convertBotMessagesToAIConversation({
-        messages: messages,
-        botClientId: 'bot-123',
-        botDisplayName: 'Bot',
-        issuer: 'issuer-123',
-      });
-
-      expect(result[0].role).toBe(DyFM_AI_MessageRole.assistant);
-    });
-
-    it('| should convert bot messages with user translation flags to user role', () => {
-      const userTranslationFlag = DyNTS_Ass_global_settings.userTranslationFlags[0];
-      const messages: DyNTS_Bot_MessageWrapper<any>[] = [
-        {
-          id: 'msg-1',
-          content: `Message with ${userTranslationFlag} flag`,
-          authorId: 'bot-123',
-          isBot: true,
-        } as any,
-      ];
-
-      const result = DyNTS_Ass_Util.convertBotMessagesToAIConversation({
-        messages: messages,
-        botClientId: 'bot-123',
-        botDisplayName: 'Bot',
-        issuer: 'issuer-123',
-      });
-
-      expect(result[0].role).toBe(DyFM_AI_MessageRole.user);
-    });
-
-    it('| should handle empty messages array', () => {
-      const result = DyNTS_Ass_Util.convertBotMessagesToAIConversation({
-        messages: [],
-        botClientId: 'bot-123',
-        botDisplayName: 'Bot',
-        issuer: 'issuer-123',
-      });
-
-      expect(result).toEqual([]);
-    });
-
-    it('| should convert user messages to user role', () => {
-      const messages: DyNTS_Bot_MessageWrapper<any>[] = [
-        {
-          id: 'msg-1',
-          content: 'User message',
-          authorId: 'user-123',
-          isBot: false,
-        } as any,
-      ];
-
-      const result = DyNTS_Ass_Util.convertBotMessagesToAIConversation({
-        messages: messages,
-        botClientId: 'bot-123',
-        botDisplayName: 'Bot',
-        issuer: 'issuer-123',
-      });
-
-      expect(result[0].role).toBe(DyFM_AI_MessageRole.user);
-    });
-  });
-});
-
+
+import { DyFM_AI_Message, DyFM_AI_MessageRole } from '@futdevpro/fsm-dynamo/ai';
+import { DyNTS_Ass_Util } from './ass.util';
+import { DyNTS_Bot_MessageWrapper } from '../../bot/_models/bot-message-wrapper.interface';
+import { DyNTS_Ass_global_settings } from './ass-global-settings.const';
+
+describe('| DyNTS_Ass_Util', () => {
+  describe('| convertBotMessagesToAIConversation', () => {
+    it('| should convert bot messages to AI conversation format', () => {
+      const messages: DyNTS_Bot_MessageWrapper<any>[] = [
+        {
+          id: 'msg-1',
+          content: 'User message',
+          authorId: 'user-123',
+          authorName: 'user',
+          isBot: false,
+        } as any,
+        {
+          id: 'msg-2',
+          content: 'Bot response',
+          authorId: 'bot-123',
+          authorName: 'bot',
+          isBot: true,
+        } as any,
+      ];
+
+      const result = DyNTS_Ass_Util.convertBotMessagesToAIConversation({
+        messages: messages,
+        botClientId: 'bot-123',
+        botDisplayName: 'Bot',
+        issuer: 'issuer-123',
+      });
+
+      expect(result.length).toBe(2);
+      expect(result[0].role).toBe(DyFM_AI_MessageRole.user);
+      expect(result[0].content).toBe('User message');
+      expect(result[1].role).toBe(DyFM_AI_MessageRole.assistant);
+      expect(result[1].content).toBe('Bot response');
+    });
+
+    it('| should identify bot messages by isBot flag', () => {
+      const messages: DyNTS_Bot_MessageWrapper<any>[] = [
+        {
+          id: 'msg-1',
+          content: 'Message',
+          authorId: 'bot-123',
+          isBot: true,
+        } as any,
+      ];
+
+      const result = DyNTS_Ass_Util.convertBotMessagesToAIConversation({
+        messages: messages,
+        botClientId: 'bot-123',
+        botDisplayName: 'Bot',
+        issuer: 'issuer-123',
+      });
+
+      expect(result[0].role).toBe(DyFM_AI_MessageRole.assistant);
+    });
+
+    it('| should identify bot messages by authorId match', () => {
+      const messages: DyNTS_Bot_MessageWrapper<any>[] = [
+        {
+          id: 'msg-1',
+          content: 'Message',
+          authorId: 'bot-123',
+          isBot: false,
+        } as any,
+      ];
+
+      const result = DyNTS_Ass_Util.convertBotMessagesToAIConversation({
+        messages: messages,
+        botClientId: 'bot-123',
+        botDisplayName: 'Bot',
+        issuer: 'issuer-123',
+      });
+
+      expect(result[0].role).toBe(DyFM_AI_MessageRole.assistant);
+    });
+
+    it('| should identify bot messages by authorName match', () => {
+      const messages: DyNTS_Bot_MessageWrapper<any>[] = [
+        {
+          id: 'msg-1',
+          content: 'Message',
+          authorId: 'other-123',
+          authorName: 'Bot',
+          isBot: false,
+        } as any,
+      ];
+
+      const result = DyNTS_Ass_Util.convertBotMessagesToAIConversation({
+        messages: messages,
+        botClientId: 'bot-123',
+        botDisplayName: 'Bot',
+        issuer: 'issuer-123',
+      });
+
+      expect(result[0].role).toBe(DyFM_AI_MessageRole.assistant);
+    });
+
+    it('| should identify bot messages by authorDisplayName match', () => {
+      const messages: DyNTS_Bot_MessageWrapper<any>[] = [
+        {
+          id: 'msg-1',
+          content: 'Message',
+          authorId: 'other-123',
+          authorDisplayName: 'Bot',
+          isBot: false,
+        } as any,
+      ];
+
+      const result = DyNTS_Ass_Util.convertBotMessagesToAIConversation({
+        messages: messages,
+        botClientId: 'bot-123',
+        botDisplayName: 'Bot',
+        issuer: 'issuer-123',
+      });
+
+      expect(result[0].role).toBe(DyFM_AI_MessageRole.assistant);
+    });
+
+    it('| should convert bot messages with user translation flags to user role', () => {
+      const userTranslationFlag = DyNTS_Ass_global_settings.userTranslationFlags[0];
+      const messages: DyNTS_Bot_MessageWrapper<any>[] = [
+        {
+          id: 'msg-1',
+          content: `Message with ${userTranslationFlag} flag`,
+          authorId: 'bot-123',
+          isBot: true,
+        } as any,
+      ];
+
+      const result = DyNTS_Ass_Util.convertBotMessagesToAIConversation({
+        messages: messages,
+        botClientId: 'bot-123',
+        botDisplayName: 'Bot',
+        issuer: 'issuer-123',
+      });
+
+      expect(result[0].role).toBe(DyFM_AI_MessageRole.user);
+    });
+
+    it('| should handle empty messages array', () => {
+      const result = DyNTS_Ass_Util.convertBotMessagesToAIConversation({
+        messages: [],
+        botClientId: 'bot-123',
+        botDisplayName: 'Bot',
+        issuer: 'issuer-123',
+      });
+
+      expect(result).toEqual([]);
+    });
+
+    it('| should convert user messages to user role', () => {
+      const messages: DyNTS_Bot_MessageWrapper<any>[] = [
+        {
+          id: 'msg-1',
+          content: 'User message',
+          authorId: 'user-123',
+          isBot: false,
+        } as any,
+      ];
+
+      const result = DyNTS_Ass_Util.convertBotMessagesToAIConversation({
+        messages: messages,
+        botClientId: 'bot-123',
+        botDisplayName: 'Bot',
+        issuer: 'issuer-123',
+      });
+
+      expect(result[0].role).toBe(DyFM_AI_MessageRole.user);
+    });
+  });
+});
+

package/src/_modules/assistant/_collections/ass.util.ts

@@ -1,50 +1,50 @@
-import { DyNTS_Bot_MessageWrapper } from '../../bot/_models/bot-message-wrapper.interface';
-import { DyFM_AI_Message, DyFM_AI_MessageRole } from '@futdevpro/fsm-dynamo/ai';
-import { DyNTS_Ass_global_settings } from './ass-global-settings.const';
-
-export class DyNTS_Ass_Util {
-  /**
-   * Convert bot messages (from any comms platform) to AI conversation format
-   * Uses EXISTING DyFM_AI_Message type from fsm-dynamo
-   * Same logic as DiAs_Util.convertDiscordMessagesToOAIConversation but platform-agnostic
-   */
-  static convertBotMessagesToAIConversation<T_BotMessage extends DyNTS_Bot_MessageWrapper<any>>(
-    set: {
-      messages: T_BotMessage[],
-      botClientId: string,
-      botDisplayName: string,
-      issuer: string,
-    }
-  ): DyFM_AI_Message[] {
-    return set.messages.map(message => {
-      const isBot = (
-        message.isBot ||
-        message.authorId === set.botClientId ||
-        message.authorName === set.botDisplayName ||
-        message.authorDisplayName === set.botDisplayName
-      );
-      
-      if (isBot) {
-        // Check if bot message should be treated as user message
-        if (DyNTS_Ass_global_settings.userTranslationFlags.some(
-          flag => message.content.includes(flag)
-        )) {
-          return {
-            role: DyFM_AI_MessageRole.user,
-            content: message.content,
-          };
-        } else {
-          return {
-            role: DyFM_AI_MessageRole.assistant,
-            content: message.content,
-          };
-        }
-      } else {
-        return {
-          role: DyFM_AI_MessageRole.user,
-          content: message.content,
-        };
-      }
-    });
-  }
-}
+import { DyNTS_Bot_MessageWrapper } from '../../bot/_models/bot-message-wrapper.interface';
+import { DyFM_AI_Message, DyFM_AI_MessageRole } from '@futdevpro/fsm-dynamo/ai';
+import { DyNTS_Ass_global_settings } from './ass-global-settings.const';
+
+export class DyNTS_Ass_Util {
+  /**
+   * Convert bot messages (from any comms platform) to AI conversation format
+   * Uses EXISTING DyFM_AI_Message type from fsm-dynamo
+   * Same logic as DiAs_Util.convertDiscordMessagesToOAIConversation but platform-agnostic
+   */
+  static convertBotMessagesToAIConversation<T_BotMessage extends DyNTS_Bot_MessageWrapper<any>>(
+    set: {
+      messages: T_BotMessage[],
+      botClientId: string,
+      botDisplayName: string,
+      issuer: string,
+    }
+  ): DyFM_AI_Message[] {
+    return set.messages.map(message => {
+      const isBot = (
+        message.isBot ||
+        message.authorId === set.botClientId ||
+        message.authorName === set.botDisplayName ||
+        message.authorDisplayName === set.botDisplayName
+      );
+      
+      if (isBot) {
+        // Check if bot message should be treated as user message
+        if (DyNTS_Ass_global_settings.userTranslationFlags.some(
+          flag => message.content.includes(flag)
+        )) {
+          return {
+            role: DyFM_AI_MessageRole.user,
+            content: message.content,
+          };
+        } else {
+          return {
+            role: DyFM_AI_MessageRole.assistant,
+            content: message.content,
+          };
+        }
+      } else {
+        return {
+          role: DyFM_AI_MessageRole.user,
+          content: message.content,
+        };
+      }
+    });
+  }
+}

package/src/_modules/assistant/_models/ass-global-settings.interface.ts

@@ -1,15 +1,15 @@
-export interface DyNTS_Ass_Global_Settings {
-  defaultSystemPrompt: string;
-  
-  /**
-   * These flags are used to skip messages from the conversation
-   * Default: [ '[NOISE]', '[VOICE|USER|OUTOFCONTEXT]', '[DEBUG|' ]
-   */
-  skipConversationMessagesFlags: string[];
-  
-  /**
-   * These flags identify bot messages that should be treated as user messages
-   * Default: [ '[VOICE|USER' ]
-   */
-  userTranslationFlags: string[];
-}
+export interface DyNTS_Ass_Global_Settings {
+  defaultSystemPrompt: string;
+  
+  /**
+   * These flags are used to skip messages from the conversation
+   * Default: [ '[NOISE]', '[VOICE|USER|OUTOFCONTEXT]', '[DEBUG|' ]
+   */
+  skipConversationMessagesFlags: string[];
+  
+  /**
+   * These flags identify bot messages that should be treated as user messages
+   * Default: [ '[VOICE|USER' ]
+   */
+  userTranslationFlags: string[];
+}