@futdevpro/nts-dynamo 1.15.15 → 1.15.17

package/src/_modules/assistant/_services/ass-main.control-service.ts

@@ -1,107 +1,107 @@
-import { DyFM_AI_Message } from '@futdevpro/fsm-dynamo/ai';
-import { DyFM_Msg_Provider_Type } from '@futdevpro/fsm-dynamo/messaging';
-
-import { DyNTS_Bot_Main_ControlService } from '../../bot/_services/bot-main.control-service';
-import { DyNTS_Bot_MessageWrapper } from '../../bot/_models/bot-message-wrapper.interface';
-import { DyNTS_AI_LLMChat_ServiceBase } from '../../ai/_services/ai-llm-chat.service-base';
-import { DyNTS_Ass_global_settings } from '../_collections/ass-global-settings.const';
-import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
-import { DyNTS_Ass_Util } from '../_collections/ass.util';
-import { DyNTS_Ass_IO_ControlService } from './ass-io.control-service';
-import { DyNTS_Bot_ChannelWrapper } from '../../bot/_models/bot-channel-wrapper.interface';
-
-/**
- * Assistant Service Base
- * Integrates commsProvider (bot) and aiProvider (LLMChat) to create AI-powered assistant
- * USES EXISTING AI ABSTRACTIONS - no duplication
- */
-export abstract class DyNTS_Ass_Main_ControlService<
-  T_MessagingPlatformProvider_Type extends DyFM_Msg_Provider_Type | string = DyFM_Msg_Provider_Type,
-> extends DyNTS_Bot_Main_ControlService<T_MessagingPlatformProvider_Type> {
-
-  // AI Provider - uses EXISTING abstraction
-  aiProvider: DyNTS_AI_LLMChat_ServiceBase;  
-  protected abstract getAIProvider(): DyNTS_AI_LLMChat_ServiceBase;
-    
-  // Override botIO to use assistant IO
-  /* protected abstract override getBotIOControlService(): DyNTS_Ass_IO_ControlService; */
-  
-  declare botIO_CS: DyNTS_Ass_IO_ControlService;
-  protected abstract override getBotIOControlService(): DyNTS_Ass_IO_ControlService;
-  
-  // Assistant-specific settings
-  defaultSystemPrompt: string = DyNTS_Ass_global_settings.defaultSystemPrompt;
-  
-  protected constructor() {
-    super();
-    
-    // Initialize AI provider
-    this.aiProvider = this.getAIProvider();
-    
-    // Apply system prompt
-    if (this.aiProvider.defaultSettings) {
-      this.aiProvider.defaultSettings.systemPrompt = this.defaultSystemPrompt;
-    }
-    
-    // Set global settings
-    DyNTS_global_settings.assistant_settings ??= DyNTS_Ass_global_settings;
-  }
-  
-  /**
-   * Gather messages from comms platform (any platform)
-   * Same as dias.service-base but platform-agnostic
-   * Now uses wrapper's provider to ensure messages from correct platform
-   */
-  async gatherMessagesForMessage<T>(
-    message: DyNTS_Bot_MessageWrapper<T>,
-    limit: number = 100
-  ): Promise<DyNTS_Bot_MessageWrapper<T>[]> {
-    // Use wrapper's provider to fetch messages from the correct platform
-    const messages: DyNTS_Bot_MessageWrapper<T>[] = await message.provider.fetchMessagesForMessage(message, limit);
-    
-    // Filter out messages with skip flags
-    return messages.filter(
-      msg => !DyNTS_Ass_global_settings.skipConversationMessagesFlags.some(
-        flag => msg.content.includes(flag)
-      )
-    ).sort((a, b) => a.timestamp - b.timestamp);
-  }
-
-  async gatherMessagesInChannel(
-    channel: DyNTS_Bot_ChannelWrapper,
-    issuer: string,
-  ): Promise<DyNTS_Bot_MessageWrapper<any>[]> {
-    return channel.provider.fetchMessages(channel, 100);
-  }
-
-  /**
-   * Convert gathered messages to AI conversation using EXISTING DyFM_AI_Message
-   */
-  async gatherMessagesAsAIConversation<T>(
-    message: DyNTS_Bot_MessageWrapper<T>,
-    issuer: string,
-  ): Promise<DyFM_AI_Message[]> {
-    const messages: DyNTS_Bot_MessageWrapper<T>[] = await this.gatherMessagesForMessage<T>(message);
-    
-    return DyNTS_Ass_Util.convertBotMessagesToAIConversation({
-      messages: messages,
-      botClientId: message.provider.botId,
-      botDisplayName: message.provider.botDisplayName,
-      issuer: issuer,
-    });
-  }
-
-  async gatherMessagesAsAIConversationInChannel<T>(
-    channel: DyNTS_Bot_ChannelWrapper,
-    issuer: string,
-  ): Promise<DyFM_AI_Message[]> {
-    const messages: DyNTS_Bot_MessageWrapper<T>[] = await this.gatherMessagesInChannel(channel, issuer);
-    
-    return DyNTS_Ass_Util.convertBotMessagesToAIConversation({
-      messages: messages,
-      botClientId: channel.provider.botId,
-      botDisplayName: channel.provider.botDisplayName,
-      issuer: issuer,
-    });
-  }
-}
+import { DyFM_AI_Message } from '@futdevpro/fsm-dynamo/ai';
+import { DyFM_Msg_Provider_Type } from '@futdevpro/fsm-dynamo/messaging';
+
+import { DyNTS_Bot_Main_ControlService } from '../../bot/_services/bot-main.control-service';
+import { DyNTS_Bot_MessageWrapper } from '../../bot/_models/bot-message-wrapper.interface';
+import { DyNTS_AI_LLMChat_ServiceBase } from '../../ai/_services/ai-llm-chat.service-base';
+import { DyNTS_Ass_global_settings } from '../_collections/ass-global-settings.const';
+import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
+import { DyNTS_Ass_Util } from '../_collections/ass.util';
+import { DyNTS_Ass_IO_ControlService } from './ass-io.control-service';
+import { DyNTS_Bot_ChannelWrapper } from '../../bot/_models/bot-channel-wrapper.interface';
+
+/**
+ * Assistant Service Base
+ * Integrates commsProvider (bot) and aiProvider (LLMChat) to create AI-powered assistant
+ * USES EXISTING AI ABSTRACTIONS - no duplication
+ */
+export abstract class DyNTS_Ass_Main_ControlService<
+  T_MessagingPlatformProvider_Type extends DyFM_Msg_Provider_Type | string = DyFM_Msg_Provider_Type,
+> extends DyNTS_Bot_Main_ControlService<T_MessagingPlatformProvider_Type> {
+
+  // AI Provider - uses EXISTING abstraction
+  aiProvider: DyNTS_AI_LLMChat_ServiceBase;  
+  protected abstract getAIProvider(): DyNTS_AI_LLMChat_ServiceBase;
+    
+  // Override botIO to use assistant IO
+  /* protected abstract override getBotIOControlService(): DyNTS_Ass_IO_ControlService; */
+  
+  declare botIO_CS: DyNTS_Ass_IO_ControlService;
+  protected abstract override getBotIOControlService(): DyNTS_Ass_IO_ControlService;
+  
+  // Assistant-specific settings
+  defaultSystemPrompt: string = DyNTS_Ass_global_settings.defaultSystemPrompt;
+  
+  protected constructor() {
+    super();
+    
+    // Initialize AI provider
+    this.aiProvider = this.getAIProvider();
+    
+    // Apply system prompt
+    if (this.aiProvider.defaultSettings) {
+      this.aiProvider.defaultSettings.systemPrompt = this.defaultSystemPrompt;
+    }
+    
+    // Set global settings
+    DyNTS_global_settings.assistant_settings ??= DyNTS_Ass_global_settings;
+  }
+  
+  /**
+   * Gather messages from comms platform (any platform)
+   * Same as dias.service-base but platform-agnostic
+   * Now uses wrapper's provider to ensure messages from correct platform
+   */
+  async gatherMessagesForMessage<T>(
+    message: DyNTS_Bot_MessageWrapper<T>,
+    limit: number = 100
+  ): Promise<DyNTS_Bot_MessageWrapper<T>[]> {
+    // Use wrapper's provider to fetch messages from the correct platform
+    const messages: DyNTS_Bot_MessageWrapper<T>[] = await message.provider.fetchMessagesForMessage(message, limit);
+    
+    // Filter out messages with skip flags
+    return messages.filter(
+      msg => !DyNTS_Ass_global_settings.skipConversationMessagesFlags.some(
+        flag => msg.content.includes(flag)
+      )
+    ).sort((a, b) => a.timestamp - b.timestamp);
+  }
+
+  async gatherMessagesInChannel(
+    channel: DyNTS_Bot_ChannelWrapper,
+    issuer: string,
+  ): Promise<DyNTS_Bot_MessageWrapper<any>[]> {
+    return channel.provider.fetchMessages(channel, 100);
+  }
+
+  /**
+   * Convert gathered messages to AI conversation using EXISTING DyFM_AI_Message
+   */
+  async gatherMessagesAsAIConversation<T>(
+    message: DyNTS_Bot_MessageWrapper<T>,
+    issuer: string,
+  ): Promise<DyFM_AI_Message[]> {
+    const messages: DyNTS_Bot_MessageWrapper<T>[] = await this.gatherMessagesForMessage<T>(message);
+    
+    return DyNTS_Ass_Util.convertBotMessagesToAIConversation({
+      messages: messages,
+      botClientId: message.provider.botId,
+      botDisplayName: message.provider.botDisplayName,
+      issuer: issuer,
+    });
+  }
+
+  async gatherMessagesAsAIConversationInChannel<T>(
+    channel: DyNTS_Bot_ChannelWrapper,
+    issuer: string,
+  ): Promise<DyFM_AI_Message[]> {
+    const messages: DyNTS_Bot_MessageWrapper<T>[] = await this.gatherMessagesInChannel(channel, issuer);
+    
+    return DyNTS_Ass_Util.convertBotMessagesToAIConversation({
+      messages: messages,
+      botClientId: channel.provider.botId,
+      botDisplayName: channel.provider.botDisplayName,
+      issuer: issuer,
+    });
+  }
+}

package/src/_modules/bot/_collections/bot-default-commands.const.ts

@@ -1,12 +1,12 @@
-import { DyNTS_Bot_Command } from '../_models/bot-command.interface';
-
-export const DyNTS_Bot_defaultCommands: DyNTS_Bot_Command[] = [
-  {
-    command: '!ping',
-    description: 'Ping the bot',
-    commandHandler: async (message) => {
-      // This will be handled by the provider's replyToMessage method
-      // The actual implementation will be in the provider
-    },
-  },
-]
+import { DyNTS_Bot_Command } from '../_models/bot-command.interface';
+
+export const DyNTS_Bot_defaultCommands: DyNTS_Bot_Command[] = [
+  {
+    command: '!ping',
+    description: 'Ping the bot',
+    commandHandler: async (message) => {
+      // This will be handled by the provider's replyToMessage method
+      // The actual implementation will be in the provider
+    },
+  },
+]

package/src/_modules/bot/_collections/bot-global-settings.const.ts

@@ -1,39 +1,39 @@
-import { DyNTS_Bot_Global_Settings } from '../_models/bot-global-settings.interface';
-import { minute, week } from '@futdevpro/fsm-dynamo';
-import { DyNTS_Bot_defaultCommands } from './bot-default-commands.const';
-
-export const DyNTS_Bot_global_settings: DyNTS_Bot_Global_Settings = {
-  debugLevel: 3,
-
-  allowedUsers: 'all',
-
-  messageSettings: {
-    messageFetchTimeLimit: 3 * week,
-    messageFetchCountLimit: 1000,
-    messageSendDelay: minute / 3,
-
-    skipFlags: [
-      '[BOT-SKIP]',
-      '[SYSTEM|REFUSE|BOT]',
-    ],
-  },
-
-  channelSettings: {
-    reportChannelName: 'bot-reports',
-
-    defaultChannels: [
-      'bot-help',
-    ],
-
-    allowedChannels: [],
-    dmIsAllowed: false,
-  },
-
-  commandSettings: {
-    commandOperator: '',
-
-    commands: DyNTS_Bot_defaultCommands,
-  },
-
-  allowBotsInteractEachOther: false,
-};
+import { DyNTS_Bot_Global_Settings } from '../_models/bot-global-settings.interface';
+import { minute, week } from '@futdevpro/fsm-dynamo';
+import { DyNTS_Bot_defaultCommands } from './bot-default-commands.const';
+
+export const DyNTS_Bot_global_settings: DyNTS_Bot_Global_Settings = {
+  debugLevel: 3,
+
+  allowedUsers: 'all',
+
+  messageSettings: {
+    messageFetchTimeLimit: 3 * week,
+    messageFetchCountLimit: 1000,
+    messageSendDelay: minute / 3,
+
+    skipFlags: [
+      '[BOT-SKIP]',
+      '[SYSTEM|REFUSE|BOT]',
+    ],
+  },
+
+  channelSettings: {
+    reportChannelName: 'bot-reports',
+
+    defaultChannels: [
+      'bot-help',
+    ],
+
+    allowedChannels: [],
+    dmIsAllowed: false,
+  },
+
+  commandSettings: {
+    commandOperator: '',
+
+    commands: DyNTS_Bot_defaultCommands,
+  },
+
+  allowBotsInteractEachOther: false,
+};

package/src/_modules/bot/_models/bot-channel-wrapper.interface.ts

@@ -1,62 +1,62 @@
-import { DyNTS_Bot_MessagingProvider_ServiceBase } from '../_services/bot-messaging-provider.service-base';
-import { DyNTS_Bot_MessageWrapper } from './bot-message-wrapper.interface';
-
-
-
-/**
- * Wraps a bot channel with provider context
- * This ensures channels include the provider information needed for platform-specific operations
- */
-export class DyNTS_Bot_ChannelWrapper_Base<
-  T_MessagingPlatformChannel extends any = any,
-  T_MessagingPlatformMessage extends any = any,
-> {
-  id: string;
-  name: string;
-  isTextBased: boolean;
-  isVoiceBased: boolean;
-  isDM: boolean;
-
-  rawPlatformChannel: T_MessagingPlatformChannel;
-  
-  /** Reference to the provider instance for platform-specific operations */
-  provider: DyNTS_Bot_MessagingProvider_ServiceBase<
-    T_MessagingPlatformChannel, 
-    T_MessagingPlatformMessage, //DyNTS_Bot_MessageWrapper<any>, 
-    any, //DyNTS_Bot_UserWrapper<any>, 
-    any
-  >;
-}
-
-export class DyNTS_Bot_ChannelWrapper<
-  T_MessagingPlatformChannel extends any = any,
-  T_MessagingPlatformMessage extends any = any,
-> extends DyNTS_Bot_ChannelWrapper_Base<T_MessagingPlatformChannel, T_MessagingPlatformMessage> {
-
-  constructor(
-    set: DyNTS_Bot_ChannelWrapper_Base<T_MessagingPlatformChannel, T_MessagingPlatformMessage>
-  ) {
-    super();
-    
-    Object.assign(this, set);
-  }
-
-  async sendMessage(content: string, issuer: string): Promise<DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>> {
-    return await this.provider.sendMessageToChannel(this, content, issuer);
-  }
-
-  async sendTyping(): Promise<void> {
-    await this.provider.sendTyping(this);
-  }
-
-  async fetchMessages(limit: number): Promise<DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>[]> {
-    return await this.provider.fetchMessages(this, limit);
-  }
-
-  /* async fetchAllMessagesWi */
-
-  async clear(): Promise<void> {
-    await this.provider.clearChannel(this);
-  }
-}
-
+import { DyNTS_Bot_MessagingProvider_ServiceBase } from '../_services/bot-messaging-provider.service-base';
+import { DyNTS_Bot_MessageWrapper } from './bot-message-wrapper.interface';
+
+
+
+/**
+ * Wraps a bot channel with provider context
+ * This ensures channels include the provider information needed for platform-specific operations
+ */
+export class DyNTS_Bot_ChannelWrapper_Base<
+  T_MessagingPlatformChannel extends any = any,
+  T_MessagingPlatformMessage extends any = any,
+> {
+  id: string;
+  name: string;
+  isTextBased: boolean;
+  isVoiceBased: boolean;
+  isDM: boolean;
+
+  rawPlatformChannel: T_MessagingPlatformChannel;
+  
+  /** Reference to the provider instance for platform-specific operations */
+  provider: DyNTS_Bot_MessagingProvider_ServiceBase<
+    T_MessagingPlatformChannel, 
+    T_MessagingPlatformMessage, //DyNTS_Bot_MessageWrapper<any>, 
+    any, //DyNTS_Bot_UserWrapper<any>, 
+    any
+  >;
+}
+
+export class DyNTS_Bot_ChannelWrapper<
+  T_MessagingPlatformChannel extends any = any,
+  T_MessagingPlatformMessage extends any = any,
+> extends DyNTS_Bot_ChannelWrapper_Base<T_MessagingPlatformChannel, T_MessagingPlatformMessage> {
+
+  constructor(
+    set: DyNTS_Bot_ChannelWrapper_Base<T_MessagingPlatformChannel, T_MessagingPlatformMessage>
+  ) {
+    super();
+    
+    Object.assign(this, set);
+  }
+
+  async sendMessage(content: string, issuer: string): Promise<DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>> {
+    return await this.provider.sendMessageToChannel(this, content, issuer);
+  }
+
+  async sendTyping(): Promise<void> {
+    await this.provider.sendTyping(this);
+  }
+
+  async fetchMessages(limit: number): Promise<DyNTS_Bot_MessageWrapper<T_MessagingPlatformMessage>[]> {
+    return await this.provider.fetchMessages(this, limit);
+  }
+
+  /* async fetchAllMessagesWi */
+
+  async clear(): Promise<void> {
+    await this.provider.clearChannel(this);
+  }
+}
+

package/src/_modules/bot/_models/bot-command.interface.ts

@@ -1,8 +1,8 @@
-import { DyNTS_Bot_MessageWrapper } from './bot-message-wrapper.interface';
-
-export interface DyNTS_Bot_Command<T_MessagingPlatformMessage extends DyNTS_Bot_MessageWrapper<any> = DyNTS_Bot_MessageWrapper<any>> {
-  command: string;
-  description: string;
-  commandHandler: (message: T_MessagingPlatformMessage) => Promise<void>;
-  permissionNeeded?: (message: T_MessagingPlatformMessage) => Promise<boolean>;
-}
+import { DyNTS_Bot_MessageWrapper } from './bot-message-wrapper.interface';
+
+export interface DyNTS_Bot_Command<T_MessagingPlatformMessage extends DyNTS_Bot_MessageWrapper<any> = DyNTS_Bot_MessageWrapper<any>> {
+  command: string;
+  description: string;
+  commandHandler: (message: T_MessagingPlatformMessage) => Promise<void>;
+  permissionNeeded?: (message: T_MessagingPlatformMessage) => Promise<boolean>;
+}

package/src/_modules/bot/_models/bot-global-settings.interface.ts

@@ -1,96 +1,96 @@
-import { DyNTS_Bot_Command } from './bot-command.interface';
-import { DyNTS_Bot_MessagingProvider_Config } from '../_services/bot-messaging-provider.service-base';
-
-export interface DyNTS_Bot_Global_Settings {
-  /**
-   * this setting will set the debug level for the bot
-   * 
-   * 0 - no logs  
-   * 1 - errors sending to report channel  
-   * 2 - errors sending as response, will log events in console   
-   * 3 - errors sending as response, creating reports to report channel, debug events are in console (default)  
-   * 4 - errors and debug events are sending as response  
-   * 5 - all events are sending as response (that are set to send)  
-   * 6 - all debug logs are enabled  
-   *   
-   *   _
-   */
-  debugLevel: number;
-
-  allowedUsers: 'all' | string[];
-
-  messageSettings: {
-    /**
-     * this setting will set the time limit for message fetching
-     * so we will stop fetching messages sent later than this time
-     */
-    messageFetchTimeLimit: number;
-    /**
-     * this setting will set the count limit for message fetching
-     * so we will stop fetching messages after this count
-     */
-    messageFetchCountLimit: number;
-    /**
-     * this setting will set the delay for message sending,
-     * so we won't flood the channel too fast
-     */
-    messageSendDelay: number;
-
-    /**
-     * this setting will be used to skip answering to messages
-     * if the message contains any of these flags, the bot will not answer
-     * 
-     * @default [ '[BOT-SKIP]' ]
-     */
-    skipFlags: string[];
-  };
-
-  /**
-   * this setting will set the channel settings for the bot
-   */
-  channelSettings: {
-    /**
-     * this setting will set the name of the channel where the bot will send the reports
-     * 
-     * @default 'bot-report'
-     */
-    reportChannelName: string;
-
-    /**
-     * this setting will set the channels where the bot will answer automatically
-     * whenever a message is sent in one of these channels, that is not from the bot
-     * 
-     * it will be populated automatically from the default channels
-     */
-    allowedChannels: string[];
-    /**
-     * this setting will set if the bot can answer in Direct Messages Channels
-     * 
-     * @default false
-     */
-    dmIsAllowed: boolean;
-
-    /**
-     * this setting will set the default channels where the bot will answer automatically
-     * whenever a message is sent in one of these channels, that is not from the bot
-     * 
-     * @default [ 'bot-report' ]
-     */
-    defaultChannels: string[];
-  };
-
-  commandSettings: {
-    commandOperator: string;
-    commands: DyNTS_Bot_Command[];
-  };
-
-  allowBotsInteractEachOther: boolean;
-}
-
-export interface DyNTS_Bot_MultiMessageProvider_Settings {
-  /** Array of provider configurations (use for multiple providers) */
-  providers: DyNTS_Bot_MessagingProvider_Config[];
-}
-
-/** Union type supporting both single and multi-provider configurations */
-export type DyNTS_Bot_Settings = DyNTS_Bot_MessagingProvider_Config | (DyNTS_Bot_Global_Settings & DyNTS_Bot_MultiMessageProvider_Settings);
+import { DyNTS_Bot_Command } from './bot-command.interface';
+import { DyNTS_Bot_MessagingProvider_Config } from '../_services/bot-messaging-provider.service-base';
+
+export interface DyNTS_Bot_Global_Settings {
+  /**
+   * this setting will set the debug level for the bot
+   * 
+   * 0 - no logs  
+   * 1 - errors sending to report channel  
+   * 2 - errors sending as response, will log events in console   
+   * 3 - errors sending as response, creating reports to report channel, debug events are in console (default)  
+   * 4 - errors and debug events are sending as response  
+   * 5 - all events are sending as response (that are set to send)  
+   * 6 - all debug logs are enabled  
+   *   
+   *   _
+   */
+  debugLevel: number;
+
+  allowedUsers: 'all' | string[];
+
+  messageSettings: {
+    /**
+     * this setting will set the time limit for message fetching
+     * so we will stop fetching messages sent later than this time
+     */
+    messageFetchTimeLimit: number;
+    /**
+     * this setting will set the count limit for message fetching
+     * so we will stop fetching messages after this count
+     */
+    messageFetchCountLimit: number;
+    /**
+     * this setting will set the delay for message sending,
+     * so we won't flood the channel too fast
+     */
+    messageSendDelay: number;
+
+    /**
+     * this setting will be used to skip answering to messages
+     * if the message contains any of these flags, the bot will not answer
+     * 
+     * @default [ '[BOT-SKIP]' ]
+     */
+    skipFlags: string[];
+  };
+
+  /**
+   * this setting will set the channel settings for the bot
+   */
+  channelSettings: {
+    /**
+     * this setting will set the name of the channel where the bot will send the reports
+     * 
+     * @default 'bot-report'
+     */
+    reportChannelName: string;
+
+    /**
+     * this setting will set the channels where the bot will answer automatically
+     * whenever a message is sent in one of these channels, that is not from the bot
+     * 
+     * it will be populated automatically from the default channels
+     */
+    allowedChannels: string[];
+    /**
+     * this setting will set if the bot can answer in Direct Messages Channels
+     * 
+     * @default false
+     */
+    dmIsAllowed: boolean;
+
+    /**
+     * this setting will set the default channels where the bot will answer automatically
+     * whenever a message is sent in one of these channels, that is not from the bot
+     * 
+     * @default [ 'bot-report' ]
+     */
+    defaultChannels: string[];
+  };
+
+  commandSettings: {
+    commandOperator: string;
+    commands: DyNTS_Bot_Command[];
+  };
+
+  allowBotsInteractEachOther: boolean;
+}
+
+export interface DyNTS_Bot_MultiMessageProvider_Settings {
+  /** Array of provider configurations (use for multiple providers) */
+  providers: DyNTS_Bot_MessagingProvider_Config[];
+}
+
+/** Union type supporting both single and multi-provider configurations */
+export type DyNTS_Bot_Settings = DyNTS_Bot_MessagingProvider_Config | (DyNTS_Bot_Global_Settings & DyNTS_Bot_MultiMessageProvider_Settings);