@futdevpro/nts-dynamo 1.12.15 → 1.14.1

package/src/_modules/{open-ai → ai/_modules/open-ai}/_services/oai-llm.service-base.ts

@@ -1,9 +1,9 @@
 import { OpenAI } from 'openai';
 
-import { DyFM_OpenAI_Settings, DyFM_OpenAIModel, DyFM_GPTCall_Settings } from '@futdevpro/fsm-dynamo/open-ai';
+import { DyFM_OAI_Settings, DyFM_OAI_Model, DyFM_OAI_CallSettings } from '@futdevpro/fsm-dynamo/ai/open-ai';
 import { DyFM_AnyError, DyFM_Error, DyFM_Error_Settings, DyFM_Log, DyFM_notNull, DyFM_Object } from '@futdevpro/fsm-dynamo';
 
-import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
+import { DyNTS_global_settings } from '../../../../../_collections/global-settings.const';
 import { DyNTS_OAI_GPT_Message } from '../_models/interfaces/oai-gpt-message.interface';
 import { ChatCompletion } from 'openai/resources';
 import { ChatCompletionCreateParamsBase, ChatCompletionMessageParam } from 'openai/resources/chat/completions';
@@ -32,8 +32,8 @@ export class DyNTS_OAI_LLM_ServiceBase {
   readonly openai: OpenAI;
 
   /* readonly defaultSystemPrompt: string;
-  readonly defaultModel: DyFM_OpenAIModel | string; */
-  readonly defaultSettings: DyFM_GPTCall_Settings;
+  readonly defaultModel: DyFM_OAI_Model | string; */
+  readonly defaultSettings: DyFM_OAI_CallSettings;
 
   get debugLog(): boolean {
     return this.defaultSettings.debugLog;
@@ -43,7 +43,7 @@ export class DyNTS_OAI_LLM_ServiceBase {
     return this.defaultSettings.systemPrompt;
   }
 
-  get defaultModel(): DyFM_OpenAIModel | string {
+  get defaultModel(): DyFM_OAI_Model | string {
     return this.defaultSettings.useModel;
   }
 
@@ -51,12 +51,12 @@ export class DyNTS_OAI_LLM_ServiceBase {
     DyNTS_OAI_LLMDefaultPredefined_Requests;
 
   constructor(
-    set?: DyFM_OpenAI_Settings
+    set?: DyFM_OAI_Settings
   ) {
     DyNTS_global_settings.openAi_settings ??= DyNTS_OAI_global_settings;
     
     this.openai = new OpenAI(
-      set?.openAIConfig ?? 
+      set?.config ?? 
       {
         organization: DyNTS_global_settings.env_settings.openAi.organization,
         apiKey: DyNTS_global_settings.env_settings.openAi.apiKey,
@@ -66,7 +66,7 @@ export class DyNTS_OAI_LLM_ServiceBase {
 
     this.defaultSettings = set?.defaultSettings ?? 
       DyNTS_OAI_global_settings.defaultSettings ?? 
-      new DyFM_GPTCall_Settings();
+      new DyFM_OAI_CallSettings();
   }
   
   readonly defaultLogReplacer: string = '...long-context...';
@@ -83,7 +83,7 @@ export class DyNTS_OAI_LLM_ServiceBase {
     set: {
       question: string, 
       issuer: string,
-      settings?: DyFM_GPTCall_Settings,
+      settings?: DyFM_OAI_CallSettings,
       debugLog?: boolean,
       /** this is used to readably replace too long contents to eg '...' in logs */
       replaceThisInLog?: string
@@ -107,7 +107,7 @@ export class DyNTS_OAI_LLM_ServiceBase {
     set: {
       question: string, 
       issuer: string,
-      settings?: DyFM_GPTCall_Settings,
+      settings?: DyFM_OAI_CallSettings,
       debugLog?: boolean,
       /** this is used to readably replace too long contents to eg '...' in logs */
       replaceThisInLog?: string,
@@ -141,7 +141,7 @@ export class DyNTS_OAI_LLM_ServiceBase {
       question: string, 
       selectFrom: string[], 
       issuer: string,
-      settings?: DyFM_GPTCall_Settings,
+      settings?: DyFM_OAI_CallSettings,
       debugLog?: boolean,
       /** this is used to readably replace too long contents to eg '...' in logs */
       replaceThisInLog?: string,
@@ -179,7 +179,7 @@ export class DyNTS_OAI_LLM_ServiceBase {
       question: string,
       selectFrom: T[],
       issuer: string,
-      settings?: DyFM_GPTCall_Settings,
+      settings?: DyFM_OAI_CallSettings,
       debugLog?: boolean,
       /** this is used to readably replace too long contents to eg '...' in logs */
       replaceThisInLog?: string,
@@ -208,7 +208,7 @@ export class DyNTS_OAI_LLM_ServiceBase {
       question: string, 
       options: string[], 
       issuer: string,
-      settings?: DyFM_GPTCall_Settings,
+      settings?: DyFM_OAI_CallSettings,
       debugLog?: boolean,
       /** this is used to readably replace too long contents to eg '...' in logs */
       replaceThisInLog?: string,
@@ -249,7 +249,7 @@ export class DyNTS_OAI_LLM_ServiceBase {
       question: string,
       options: T[],
       issuer: string,
-      settings?: DyFM_GPTCall_Settings,
+      settings?: DyFM_OAI_CallSettings,
       debugLog?: boolean,
       /** this is used to readably replace too long contents to eg '...' in logs */
       replaceThisInLog?: string,
@@ -281,7 +281,7 @@ export class DyNTS_OAI_LLM_ServiceBase {
     set: {
       question: string, 
       issuer: string,
-      settings?: DyFM_GPTCall_Settings,
+      settings?: DyFM_OAI_CallSettings,
       debugLog?: boolean,
       /** this is used to readably replace too long contents to eg '...' in logs */
       replaceThisInLog?: string,
@@ -310,7 +310,7 @@ export class DyNTS_OAI_LLM_ServiceBase {
       question: string, 
       keysDescription: string,
       issuer: string,
-      settings?: DyFM_GPTCall_Settings,
+      settings?: DyFM_OAI_CallSettings,
       debugLog?: boolean,
       /** this is used to readably replace too long contents to eg '...' in logs */
       replaceThisInLog?: string,
@@ -343,7 +343,7 @@ export class DyNTS_OAI_LLM_ServiceBase {
       question: string, 
       keys: string[],
       issuer: string,
-      settings?: DyFM_GPTCall_Settings,
+      settings?: DyFM_OAI_CallSettings,
       debugLog?: boolean,
       /** this is used to readably replace too long contents to eg '...' in logs */
       replaceThisInLog?: string,
@@ -375,7 +375,7 @@ export class DyNTS_OAI_LLM_ServiceBase {
     set: {
       question: string, 
       issuer: string,
-      settings?: DyFM_GPTCall_Settings,
+      settings?: DyFM_OAI_CallSettings,
       debugLog?: boolean,
       /** this is used to readably replace too long contents to eg '...' in logs */
       replaceThisInLog?: string,
@@ -401,7 +401,7 @@ export class DyNTS_OAI_LLM_ServiceBase {
     set: {
       question: string, 
       issuer: string,
-      settings?: DyFM_GPTCall_Settings,
+      settings?: DyFM_OAI_CallSettings,
       debugLog?: boolean,
       /** this is used to readably replace too long contents to eg '...' in logs */
       replaceThisInLog?: string,
@@ -433,7 +433,7 @@ export class DyNTS_OAI_LLM_ServiceBase {
 //  async askJSONListQuestion(
 //    question: string,
 //    issuer: string,
-//    settings?: DyFM_GPTCall_Settings,
+//    settings?: DyFM_OAI_CallSettings,
 //    debugLog?: boolean,
 //    /** this is used to readably replace too long contents to eg '...' in logs */
 //    replaceThisInLog?: string,
@@ -454,7 +454,7 @@ export class DyNTS_OAI_LLM_ServiceBase {
     set: {
       message: string,
       issuer: string,
-      settings?: DyFM_GPTCall_Settings
+      settings?: DyFM_OAI_CallSettings
     }
   ): Promise<string> {
     return this.resolveMessage({
@@ -478,7 +478,7 @@ export class DyNTS_OAI_LLM_ServiceBase {
     set: {
       conversation: DyNTS_OAI_GPT_Message[],
       issuer: string,
-      settings?: DyFM_GPTCall_Settings,
+      settings?: DyFM_OAI_CallSettings,
       getFullResponse?: boolean
     }
   ): Promise<string | ChatCompletion> {
@@ -547,7 +547,7 @@ export class DyNTS_OAI_LLM_ServiceBase {
     set: {
       conversation: DyNTS_OAI_GPT_Message[],
       issuer: string,
-      settings?: DyFM_GPTCall_Settings
+      settings?: DyFM_OAI_CallSettings
     }
   ): ChatCompletionCreateParamsBase {
     try {
@@ -591,7 +591,7 @@ export class DyNTS_OAI_LLM_ServiceBase {
     }
   }
 
-  protected getDefaultSystemMessage(settings: DyFM_GPTCall_Settings): DyNTS_OAI_GPT_Message {
+  protected getDefaultSystemMessage(settings: DyFM_OAI_CallSettings): DyNTS_OAI_GPT_Message {
     return {
       role: DyNTS_OAI_GPT_Message_Role.system,
       content: settings?.systemPrompt || this.defaultSystemPrompt,

package/src/_modules/{open-ai → ai/_modules/open-ai}/_services/oai-vector-data.service.ts

@@ -8,10 +8,10 @@ import {
   DyFM_Metadata,
   DyFM_Object,
 } from '@futdevpro/fsm-dynamo';
-import { DyFM_OpenAI_Settings, DyFM_OpenAIEmbeddingModel, DyFM_OpenAIModel } from '@futdevpro/fsm-dynamo/open-ai';
+import { DyFM_OAI_Settings, DyFM_OAI_EmbeddingModel, DyFM_OAI_Model } from '@futdevpro/fsm-dynamo/ai/open-ai';
 
-import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
-import { DyNTS_DataService } from '../../../_services/base/data.service';
+import { DyNTS_global_settings } from '../../../../../_collections/global-settings.const';
+import { DyNTS_DataService } from '../../../../../_services/base/data.service';
 import { DyNTS_OAI_Embedding_ControlService } from './oai-embedding.control-service';
 import { DyNTS_OAI_global_settings } from '../_collections/oai-global-settings.const';
 
@@ -39,7 +39,7 @@ import { DyNTS_OAI_global_settings } from '../_collections/oai-global-settings.c
  *   constructor(
  *     set: {
  *       data?: UserMatchStatistics,
- *       openAISettings?: DyFM_OpenAI_Settings,
+ *       openAISettings?: DyFM_OAI_Settings,
  *       issuer: string,
  *     }
  *   ) {
@@ -79,7 +79,7 @@ export class DyNTS_OAI_VectorDataService<T extends DyFM_Metadata> extends DyNTS_
     /**
      * OpenAI settings
      */
-    public readonly openAISettings: DyFM_OpenAI_Settings,
+    public readonly openAISettings: DyFM_OAI_Settings,
     /**
      * Initial set for issuer to be able to follow the issuer's activity
      */
@@ -106,7 +106,7 @@ export class DyNTS_OAI_VectorDataService<T extends DyFM_Metadata> extends DyNTS_
         (dataParams.properties[key] as DyFM_DataProperty_Params<any>).vectorizedFrom !== key
     ); */
 
-    if (!openAISettings.openAIConfig.apiKey) {
+    if (!openAISettings.config.apiKey) {
       throw new DyFM_Error({
         ...this.getDefaultErrorSettings(
           'constructor', 
@@ -115,8 +115,8 @@ export class DyNTS_OAI_VectorDataService<T extends DyFM_Metadata> extends DyNTS_
       });
     }
 
-    const model: DyFM_OpenAIEmbeddingModel = openAISettings.defaultSettings.useModel as DyFM_OpenAIEmbeddingModel ?? 
-      DyFM_OpenAIModel.textEmbedding_3Large;
+    const model: DyFM_OAI_EmbeddingModel = openAISettings.defaultSettings.useModel as DyFM_OAI_EmbeddingModel ?? 
+      DyFM_OAI_Model.textEmbedding_3Large;
 
     /* if (
       !DyFM_allOpenAIEmbeddingModels.includes(model)
@@ -294,7 +294,7 @@ export class DyNTS_OAI_VectorDataService<T extends DyFM_Metadata> extends DyNTS_
    */
   async vectorize(
     input: string, 
-    useModel: DyFM_OpenAIModel | string = this.openAISettings.defaultSettings.useModel
+    useModel: DyFM_OAI_Model | string = this.openAISettings.defaultSettings.useModel
   ): Promise<number[]> {
     try {
       if (!input) {
@@ -469,3 +469,139 @@ export class DyNTS_OAI_VectorDataService<T extends DyFM_Metadata> extends DyNTS_
     }
   }
 }
+
+
+
+
+//import {
+//  DyFM_DataModel_Params,
+//  DyFM_DataProperty_Params,
+//  DyFM_Metadata,
+//} from '@futdevpro/fsm-dynamo';
+//import { DyFM_OAI_Settings, DyFM_OAI_EmbeddingModel, DyFM_OAI_Model } from '@futdevpro/fsm-dynamo/open-ai';
+//
+//import { DyNTS_DAI_VectorDataService } from '../../_modules/document-ai/_services/dai-vector-data.service-base';
+//import { DyNTS_OAI_Embedding_Service } from './oai-embedding.service';
+//import { DyNTS_global_settings } from '../../../../_collections/global-settings.const';
+//import { DyNTS_OAI_global_settings } from '../_collections/oai-global-settings.const';
+//
+///**
+// * OpenAI implementation of the generic Vector Data Service
+// * Extends the generic DAI VectorDataService with OpenAI-specific functionality
+// */
+//export class DyNTS_OAI_VectorDataService<T extends DyFM_Metadata> extends DyNTS_DAI_VectorDataService<T> {
+//
+//  debugLog: boolean = true;
+//  swallowVectorizedProperties: boolean = true;
+//
+//  constructor(
+//    /** Initial data */
+//    data: T,
+//    /** DB data params */
+//    dataParams: DyFM_DataModel_Params<T>,
+//    /** OpenAI settings */
+//    public readonly openAISettings: DyFM_OAI_Settings,
+//    /** Issuer */
+//    issuer: string
+//  ) {
+//    // Create OpenAI embedding service
+//    const embeddingService = new DyNTS_OAI_Embedding_Service(openAISettings);
+//    
+//    super(data, dataParams, embeddingService, issuer);
+//
+//    if (!openAISettings.openAIConfig.apiKey) {
+//      throw new Error('openAIConfig.apiKey is required');
+//    }
+//
+//    const model: DyFM_OAI_EmbeddingModel = openAISettings.defaultSettings.useModel as DyFM_OAI_EmbeddingModel ?? 
+//      DyFM_OAI_Model.textEmbedding_3Large;
+//
+//    // Configure vectorized properties with OpenAI-specific settings
+//    this.configureVectorizedProperties(model);
+//  }
+//
+//  /**
+//   * Configure vectorized properties with OpenAI-specific settings
+//   */
+//  private configureVectorizedProperties(model: DyFM_OAI_EmbeddingModel): void {
+//    // Update vectorized properties with OpenAI model info
+//    this.vectorizedProperties.forEach(property => {
+//      if (property.vectorizedFrom) {
+//        // Set the embedding model for this property
+//        (property as any).embeddingModel = model;
+//      }
+//    });
+//  }
+//
+//  /**
+//   * Perform vector search with OpenAI-specific implementation
+//   */
+//  protected override async performVectorSearch(
+//    query: string,
+//    model: string,
+//    issuer: string,
+//    options: any
+//  ): Promise<T[]> {
+//    try {
+//      // Create embedding for the query
+//      const queryEmbedding = await this.embeddingService.createEmbedding(query, model, issuer);
+//      
+//      // Get all data
+//      const allData = await this.getAllData();
+//      
+//      // Calculate similarities (simplified implementation)
+//      const results = allData.map(item => {
+//        const itemEmbedding = (item as any).chunkParentedContentVectorized;
+//        if (!itemEmbedding) return { item, similarity: 0 };
+//        
+//        const similarity = this.calculateCosineSimilarity(queryEmbedding, itemEmbedding);
+//        return { item, similarity };
+//      })
+//      .filter(result => result.similarity >= (options.minSimilarity || 0))
+//      .sort((a, b) => b.similarity - a.similarity)
+//      .slice(0, options.limit || 10)
+//      .map(result => result.item);
+//
+//      return results;
+//    } catch (error) {
+//      throw new Error(`Vector search failed: ${error.message}`);
+//    }
+//  }
+//
+//  /**
+//   * Calculate cosine similarity between two vectors
+//   */
+//  private calculateCosineSimilarity(vecA: number[], vecB: number[]): number {
+//    if (vecA.length !== vecB.length) return 0;
+//    
+//    let dotProduct = 0;
+//    let normA = 0;
+//    let normB = 0;
+//    
+//    for (let i = 0; i < vecA.length; i++) {
+//      dotProduct += vecA[i] * vecB[i];
+//      normA += vecA[i] * vecA[i];
+//      normB += vecB[i] * vecB[i];
+//    }
+//    
+//    if (normA === 0 || normB === 0) return 0;
+//    
+//    return dotProduct / (Math.sqrt(normA) * Math.sqrt(normB));
+//  }
+//
+//  /**
+//   * Get default error settings
+//   */
+//  protected getDefaultErrorSettings(
+//    method: string,
+//    error: any,
+//    issuer?: string
+//  ): any {
+//    return {
+//      method,
+//      error,
+//      issuer: issuer || this.issuer,
+//      userMsg: this.defaultErrorUserMsg,
+//    };
+//  }
+//}

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

@@ -0,0 +1,72 @@
+
+
+
+
+
+
+
+
+/* try {
+  require.resolve('open-ai');
+} catch {
+  console.log(
+    '❌ OpenAI package not found, please install it with: pnpm add open-ai'
+  );
+} */
+
+//
+// OpenAI module
+//
+// This module is created to simplify the usage of OpenAI API
+// It creates universal solutions for the most common use cases
+//
+
+
+// Re-export from FSM
+export * from '@futdevpro/fsm-dynamo/ai/open-ai';
+
+// Re-export from document-ai
+/* export * from '../../_modules/document-ai'; */
+
+
+// COLLECTIONS
+/* export * from './_collections/oai-chunking.util';
+export * from './_collections/oai-document.util'; */
+export * from './_collections/oai-global-settings.const';
+export * from './_collections/oai-llm-predefined-requests.conts';
+export * from './_collections/oai-llm-predefined-requests-hu.conts';
+
+
+// ENUMS
+//export * from './_enums/oai-compare-result-type.enum';
+export * from './_enums/oai-gpt-message-role.enum';
+
+
+// MODELS
+/* export * from '../document-ai/_models/oai-doc-chunk.data-model'; */
+
+// models/INTERFACES
+/* export * from '../document-ai/_models/interfaces/dai-doc-chunk-compare-result.interface';
+export * from '../document-ai/_models/interfaces/dai-doc-page-compare-result.interface'; */
+/* export * from '../document-ai/_models/interfaces/oai-document-page.interface'; */
+export * from './_models/interfaces/oai-global-settings.interface';
+export * from './_models/interfaces/oai-gpt-message.interface';
+export * from './_models/interfaces/oai-llm-predefined-requests.interface';
+/* export * from '../document-ai/_models/interfaces/dai-doc-page-compare-result.interface'; */
+
+
+// SERVICES - New implementations
+/* export * from './_services/oai-llm.service';
+export * from './_services/oai-llm-chat.service';
+export * from './_services/oai-embedding.service'; */
+/* export * from './_services/oai-doc-chunk.service'; */
+
+// Legacy (for backward compatibility)
+export * from './_services/oai-doc-chunk-data.service';
+export * from './_services/oai-doc-page.data-service';
+export * from './_services/oai-document.data-service';
+export * from './_services/oai-embedding.control-service';
+export * from './_services/oai-llm-chat.service-base';
+export * from './_services/oai-llm.service-base';
+export * from './_services/oai-vector-data.service';
+/* export * from './_services/oai-doc-chunk.service-base'; */

package/src/_modules/ai/_services/ai-embedding.service-base.ts

@@ -0,0 +1,41 @@
+import { DyNTS_AI_Provider_ServiceBase } from './ai-provider.service-base';
+import { DyFM_DAI_EmbeddingInfo } from '@futdevpro/fsm-dynamo/ai/document-ai';
+
+/**
+ * Abstract base class for embedding services
+ * Defines the interface for AI providers that support embeddings
+ */
+export abstract class DyNTS_AI_Embedding_ServiceBase extends DyNTS_AI_Provider_ServiceBase {
+  /**
+   * Create an embedding for a single text
+   * @param text - The text to embed
+   * @param model - The embedding model to use
+   * @param issuer - The issuer making the request
+   * @returns Promise<number[]> - The embedding vector
+   */
+  abstract createEmbedding(
+    text: string,
+    model: string,
+    issuer: string
+  ): Promise<number[]>;
+  
+  /**
+   * Create embeddings for multiple texts
+   * @param texts - Array of texts to embed
+   * @param model - The embedding model to use
+   * @param issuer - The issuer making the request
+   * @returns Promise<number[][]> - Array of embedding vectors
+   */
+  abstract createEmbeddings(
+    texts: string[],
+    model: string,
+    issuer: string
+  ): Promise<number[][]>;
+  
+  /**
+   * Get embedding information for a model
+   * @param model - The model name
+   * @returns DyFM_DAI_EmbeddingInfo - Information about the model
+   */
+  abstract getEmbeddingInfo(model: string): DyFM_DAI_EmbeddingInfo;
+}

package/src/_modules/ai/_services/ai-llm-chat.service-base.ts

@@ -0,0 +1,48 @@
+import { DyNTS_AI_LLM_ServiceBase } from './ai-llm.service-base';
+import { DyFM_AI_Message } from '@futdevpro/fsm-dynamo/ai';
+import {
+  DyFM_AI_ConversationQuestion_Input,
+  DyFM_AI_ConversationSelect_Input,
+  DyFM_AI_ConversationGenericSelect_Input,
+  DyFM_AI_ConversationMultiSelect_Input,
+  DyFM_AI_ConversationGenericMultiSelect_Input,
+  DyFM_AI_ConversationJSONKeysDescription_Input,
+  DyFM_AI_ConversationJSONExactKeys_Input,
+  DyFM_AI_ConversationGetAnswer_Input
+} from '../_models/ai-input-interfaces';
+
+/**
+ * Abstract base class for LLM Chat services
+ * Extends LLM service with conversation management capabilities
+ */
+export abstract class DyNTS_AI_LLMChat_ServiceBase extends DyNTS_AI_LLM_ServiceBase {
+  // History management
+  /**
+   * Add a message to the conversation history
+   */
+  abstract addMessageToHistory(message: DyFM_AI_Message, issuer: string): void;
+  
+  /**
+   * Clear the conversation history for an issuer
+   */
+  abstract clearHistory(issuer: string): void;
+  
+  /**
+   * Get the conversation history for an issuer
+   */
+  abstract getHistory(issuer: string): DyFM_AI_Message[];
+  
+  // Conversation methods (from OAI_LLMChat_ServiceBase)
+  abstract yesNoQuestionInConversation(set: DyFM_AI_ConversationQuestion_Input): Promise<boolean>;
+  abstract simpleQuestionInConversation(set: DyFM_AI_ConversationQuestion_Input): Promise<string>;
+  abstract percentageQuestionInConversation(set: DyFM_AI_ConversationQuestion_Input): Promise<number>;
+  abstract selectQuestionInConversation(set: DyFM_AI_ConversationSelect_Input): Promise<string>;
+  abstract requestSelectInConversation<T>(set: DyFM_AI_ConversationGenericSelect_Input<T>): Promise<T | { unparsableResult: string }>;
+  abstract multipleSelectQuestionInConversationWithOptions(set: DyFM_AI_ConversationMultiSelect_Input): Promise<string[]>;
+  abstract requestMultiselectInConversation<T>(set: DyFM_AI_ConversationGenericMultiSelect_Input<T>): Promise<T[]>;
+  abstract JSONQuestionInConversationWithKeysDescription(set: DyFM_AI_ConversationJSONKeysDescription_Input): Promise<object>;
+  abstract JSONQuestionInConversationWithExactKeys(set: DyFM_AI_ConversationJSONExactKeys_Input): Promise<object>;
+  abstract requestJSONInConversationWithExactKeys<T>(set: DyFM_AI_ConversationJSONExactKeys_Input): Promise<T>;
+  abstract getQuestionAnswerInConversation(set: DyFM_AI_ConversationQuestion_Input): Promise<string>;
+  abstract getAnswerInConversation(set: DyFM_AI_ConversationGetAnswer_Input): Promise<string>;
+}

package/src/_modules/ai/_services/ai-llm.service-base.ts

@@ -0,0 +1,81 @@
+import { DyNTS_AI_Provider_ServiceBase } from './ai-provider.service-base';
+import { DyFM_AI_CallSettings, DyFM_AI_Message, DyFM_AI_LLM_Response } from '@futdevpro/fsm-dynamo/ai';
+import { DyFM_Error_Settings } from '@futdevpro/fsm-dynamo';
+import {
+  DyFM_AI_Question_Input,
+  DyFM_AI_ListSelect_Input,
+  DyFM_AI_GenericSelect_Input,
+  DyFM_AI_MultiSelect_Input,
+  DyFM_AI_GenericMultiSelect_Input,
+  DyFM_AI_JSONKeysDescription_Input,
+  DyFM_AI_JSONExactKeys_Input,
+  DyFM_AI_SimpleMessage_Input
+} from '../_models/ai-input-interfaces';
+
+/**
+ * Abstract base class for LLM services
+ * Defines all methods that must be implemented by AI providers
+ */
+export abstract class DyNTS_AI_LLM_ServiceBase extends DyNTS_AI_Provider_ServiceBase {
+  /** Default settings for LLM calls */
+  abstract readonly defaultSettings: DyFM_AI_CallSettings;
+  
+  /** Default model to use for LLM calls */
+  abstract readonly defaultModel: string;
+  
+  /** Provider-specific predefined requests */
+  abstract readonly predefinedRequests: any;
+  
+  // Core abstract methods
+  /**
+   * Call LLM with system and user messages
+   */
+  abstract callLLM(
+    systemMessage: string,
+    userMessage: string,
+    settings?: DyFM_AI_CallSettings,
+    issuer?: string
+  ): Promise<string>;
+  
+  /**
+   * Call LLM with message history
+   */
+  abstract callLLMWithHistory(
+    messages: DyFM_AI_Message[],
+    settings?: DyFM_AI_CallSettings,
+    issuer?: string
+  ): Promise<string>;
+  
+  /**
+   * Call LLM and return raw response
+   */
+  abstract callLLMRaw(
+    messages: DyFM_AI_Message[],
+    settings?: DyFM_AI_CallSettings,
+    issuer?: string
+  ): Promise<DyFM_AI_LLM_Response>;
+  
+  // Question methods (from OAI_LLM_ServiceBase)
+  abstract askQuestion(set: DyFM_AI_Question_Input): Promise<string>;
+  abstract askYesNoQuestion(set: DyFM_AI_Question_Input): Promise<boolean>;
+  abstract askPercentageQuestion(set: DyFM_AI_Question_Input): Promise<number>;
+  abstract askSelectQuestion(set: DyFM_AI_ListSelect_Input): Promise<string>;
+  abstract requestSelect<T>(set: DyFM_AI_GenericSelect_Input<T>): Promise<T | { unparsableResult: string }>;
+  abstract askMultipleSelectQuestionWithOptions(set: DyFM_AI_MultiSelect_Input): Promise<string[]>;
+  abstract requestMultiselect<T>(set: DyFM_AI_GenericMultiSelect_Input<T>): Promise<T[]>;
+  abstract askJSONQuestionWithKeysDescription(set: DyFM_AI_JSONKeysDescription_Input): Promise<object>;
+  abstract askJSONQuestionWithExactKeys(set: DyFM_AI_JSONExactKeys_Input): Promise<object>;
+  abstract requestJSONWithExactKeys<T>(set: DyFM_AI_JSONExactKeys_Input): Promise<T>;
+  abstract sendMessage(set: DyFM_AI_SimpleMessage_Input): Promise<string>;
+  
+  // Helper methods
+  protected abstract getDefaultErrorSettings(
+    method: string,
+    error: any,
+    issuer?: string
+  ): DyFM_Error_Settings;
+  
+  protected abstract getTextListAsText(list: string[]): string;
+  
+  protected abstract logQuestion(set: any): void;
+}

package/src/_modules/ai/_services/ai-provider.service-base.ts

@@ -0,0 +1,28 @@
+import { DyFM_AI_Provider } from '@futdevpro/fsm-dynamo/ai';
+import { DyFM_AI_ProviderCapabilities } from '@futdevpro/fsm-dynamo/ai';
+import { DyFM_AI_Config } from '@futdevpro/fsm-dynamo/ai';
+
+/**
+ * Abstract base class for all AI providers
+ * Defines the common interface that all AI providers must implement
+ */
+export abstract class DyNTS_AI_Provider_ServiceBase {
+  /** The AI provider this service represents */
+  abstract readonly provider: DyFM_AI_Provider;
+  
+  /** The capabilities supported by this provider */
+  abstract readonly capabilities: DyFM_AI_ProviderCapabilities;
+  
+  /**
+   * Initialize the provider with configuration
+   * @param config - Provider-specific configuration
+   */
+  abstract initialize(config: DyFM_AI_Config): void;
+  
+  /**
+   * Test the connection to the AI provider
+   * @param issuer - The issuer making the request
+   * @returns Promise<boolean> - True if connection is successful
+   */
+  abstract testConnection(issuer: string): Promise<boolean>;
+}

package/src/_modules/ai/index.ts

@@ -0,0 +1,11 @@
+// Re-export from FSM
+export * from '@futdevpro/fsm-dynamo/ai';
+
+// AI Input Interfaces (moved from FSM)
+export * from './_models/ai-input-interfaces';
+
+// 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';