@futdevpro/nts-dynamo 1.10.77 → 1.11.1

package/src/_modules/open-ai/_collections/oai-chunking.util.ts

@@ -0,0 +1,496 @@
+import { DyFM_AnyError, DyFM_Error, DyFM_Error_Settings, DyFM_Log } from '@futdevpro/fsm-dynamo';
+import { DyNTS_OAI_DocChunk } from '../_models/oai-doc-chunk.data-model';
+import { DyNTS_OAI_DocumentPage } from '../_models/interfaces/oai-document-page.interface';
+import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
+
+/**
+ * ClickUp dokumentum chunking szolgáltatás
+ * @author AI
+ * @description ClickUp dokumentumok intelligens chunking-ja a leghosszabb lehetséges chunk-ok létrehozásához
+ */
+export class DyNTS_OAI_Chunking_Util {
+    
+  protected static readonly defaultErrorUserMsg: string = 
+    `We encountered an unhandled Control Service Error, ` +
+    `\nplease contact the responsible development team.`; 
+
+  /**
+   * Markdown tartalom chunking-ja a leghosszabb lehetséges chunk-ok létrehozásához
+   * @param page - ClickUp dokumentum oldal
+   * @param issuer - Kérés kezdeményezője
+   * @returns Promise<CU_DocChunk[]> - Létrehozott chunk-ok listája
+   */
+  static async chunkMdContent(
+    page: DyNTS_OAI_DocumentPage,
+    issuer: string
+  ): Promise<DyNTS_OAI_DocChunk[]> {
+    try {
+      if (page.content.includes('#####')) {
+        DyFM_Log.warn('lvl5+ headers are not supported yet for page: ' + page.name);
+      }
+
+      /* DyFM_Log.log(`Chunking page: ${page.name}\n\n`, JSON.stringify(page.content, null, 2)); */
+
+      let leftovers = page.content;
+      const maxChunkSize = DyNTS_global_settings.docChunking.maxChunkSize;
+      const maxChunkCount = DyNTS_global_settings.docChunking.maxChunkCount;
+      const chunks: DyNTS_OAI_DocChunk[] = [];
+      let chunkIndex = 0;
+      let currentPosition = 0; // Track current position in original content
+
+      // Parse all headers to build hierarchy
+      const headerHierarchy = this.parseHeaderHierarchy(leftovers);
+      
+      // Debug: Log parsed headers
+      /* console.log('\n=== Parsed Header Hierarchy ===');
+      headerHierarchy.forEach((header, index) => {
+        console.log(`${index}: Level ${header.level} at position ${header.index}: "${header.header}"`);
+      });
+      console.log('=== End Header Hierarchy ===\n'); */
+      
+      // Track the last headers of each level as we progress
+      const lastHeaders: Map<number, string> = new Map();
+
+      while (leftovers.length > 0 && chunkIndex < maxChunkCount) {
+        // Ha a teljes tartalom belefér egy chunk-ba, adjuk vissza az egészet
+        if (leftovers.length <= maxChunkSize) {
+          const chunkContent = leftovers.trim();
+          if (chunkContent.length > 0) {
+            const chunkWithHierarchy = this.addHeaderHierarchy(chunkContent, headerHierarchy, currentPosition, currentPosition + leftovers.length, lastHeaders);
+            const chunkPath = this.buildChunkPath(page.name, headerHierarchy, currentPosition, currentPosition + leftovers.length, lastHeaders);
+            
+            const chunk = new DyNTS_OAI_DocChunk({
+              workspaceId: page.workspaceId,
+              documentId: page.docId,
+              documentPageId: page._id,
+
+              documentName: page.name,
+              documentPath: page.path,
+
+              chunkIndex: chunkIndex,
+              chunkPath: chunkPath,
+              
+              chunkOriginalContent: chunkContent,
+            });
+            chunk.chunkParentedContent = this.assembleChunkWithHeaders(chunk, issuer);
+            chunks.push(chunk);
+          }
+          break;
+        }
+
+        // Keressük meg a legjobb break point-ot a maxChunkSize-n belül
+        const breakPoint = this.findBestBreakPoint(leftovers, maxChunkSize);
+        
+        if (breakPoint.index > 0) {
+          // Ha találtunk break point-ot, vágjunk a marker előtt
+          const chunkContent = leftovers.substring(0, breakPoint.index).trim();
+          
+          // Debug: Log current state
+          /* console.log(`\n--- Creating chunk ${chunkIndex} ---`);
+          console.log(`Current position: ${currentPosition}`);
+          console.log(`Last headers:`, Object.fromEntries(lastHeaders));
+          console.log(`Chunk content preview:`, chunkContent.substring(0, 100) + '...'); */
+          
+          // Check if chunk has headers
+          const hasHeaders = headerHierarchy.some(header => 
+            header.index >= currentPosition && header.index < currentPosition + breakPoint.index
+          );
+          /* console.log(`Chunk has headers: ${hasHeaders}`); */
+          
+          const chunkWithHierarchy = this.addHeaderHierarchy(chunkContent, headerHierarchy, currentPosition, currentPosition + breakPoint.index, lastHeaders);
+          const chunkPath = this.buildChunkPath(page.name, headerHierarchy, currentPosition, currentPosition + breakPoint.index, lastHeaders);
+          
+          /* console.log(`Chunk path:`, chunkPath);
+          console.log(`Chunk with hierarchy preview:`, chunkWithHierarchy.substring(0, 100) + '...'); */
+          
+          const chunk = new DyNTS_OAI_DocChunk({
+            workspaceId: page.workspaceId,
+            documentId: page.docId,
+            documentPageId: page._id,
+            
+            documentName: page.name,
+            documentPath: page.path,
+
+            chunkIndex: chunkIndex,
+            chunkPath: chunkPath,
+                        
+            chunkOriginalContent: chunkContent,
+          });
+          chunk.chunkParentedContent = this.assembleChunkWithHeaders(chunk, issuer);
+          chunks.push(chunk);
+          chunkIndex++;
+          currentPosition += breakPoint.index;
+          leftovers = leftovers.substring(breakPoint.index);
+          
+          // Update last headers after creating the chunk
+          this.updateLastHeaders(headerHierarchy, currentPosition, lastHeaders);
+          
+          /* console.log(`Updated last headers:`, Object.fromEntries(lastHeaders));
+          console.log(`--- End chunk ${chunkIndex - 1} ---\n`); */
+        } else {
+          // Ha nem találtunk break point-ot, használjuk a maxChunkSize-t
+          const chunkContent = leftovers.substring(0, maxChunkSize).trim();
+          const chunkWithHierarchy = this.addHeaderHierarchy(chunkContent, headerHierarchy, currentPosition, currentPosition + maxChunkSize, lastHeaders);
+          const chunkPath = this.buildChunkPath(page.name, headerHierarchy, currentPosition, currentPosition + maxChunkSize, lastHeaders);
+          
+          const chunk = new DyNTS_OAI_DocChunk({
+            workspaceId: page.workspaceId,
+            documentId: page.docId,
+            documentPageId: page._id,
+
+            documentName: page.name,
+            documentPath: page.path,
+
+            chunkIndex: chunkIndex,
+            chunkPath: chunkPath,
+
+            chunkOriginalContent: chunkContent,
+          });
+          chunk.chunkParentedContent = this.assembleChunkWithHeaders(chunk, issuer);
+          chunks.push(chunk);
+          chunkIndex++;
+          currentPosition += maxChunkSize;
+          leftovers = leftovers.substring(maxChunkSize);
+          
+          // Update last headers after creating the chunk
+          this.updateLastHeaders(headerHierarchy, currentPosition, lastHeaders);
+        }
+
+        // Safety check to prevent infinite loops
+        if (leftovers.length > 0 && leftovers.length >= page.content.length) {
+          throw new DyFM_Error({
+            ...this.getDefaultErrorSettings(
+              'chunkMdContent',
+              new Error('Infinite loop detected in chunking'),
+              issuer
+            ),
+            errorCode: 'CCAP-CUC-CC1',
+          });
+        }
+      }
+
+      // Log warning if we hit the chunk count limit
+      if (chunkIndex >= maxChunkCount && leftovers.length > 0) {
+        DyFM_Log.warn(
+          `⚠️ Reached maximum chunk count (${maxChunkCount}). Remaining content: ${leftovers.length} characters`,
+          {
+            pageName: page.name,
+            pageSize: page.content.length,
+          }
+        );
+      }
+
+      /* DyFM_Log.info(`✅ Created ${chunks.length} chunks`); */
+      return chunks;
+    } catch (error) {
+      throw new DyFM_Error({
+        ...this.getDefaultErrorSettings('chunkMdContent', error, issuer),
+        errorCode: 'CCAP-CUC-CP0',
+      });
+    }
+  }
+
+  private static assembleChunkWithHeaders(chunk: DyNTS_OAI_DocChunk, issuer: string): string {
+    try {
+      const fileHeaders = chunk.documentPath.map(
+        (header, index) => `${'>'.repeat(index + 1)} **${header}**`
+      ).join('\n');
+      const headers = chunk.chunkPath.filter(
+        path => !chunk.chunkOriginalContent.includes(path)
+      ).join('\n');
+      return `${fileHeaders}\n\n${headers}\n\n${chunk.chunkOriginalContent}`;
+    } catch (error) {
+      throw new DyFM_Error({
+        ...this.getDefaultErrorSettings('assembleChunkWithHeaders', error, issuer),
+        errorCode: 'CCAP-CUC-ACH0',
+      });
+    }
+  }
+
+  static reassembleChunksToContent(
+    chunks: DyNTS_OAI_DocChunk[],
+    issuer: string
+  ): string {
+    try {
+      let pageContent = '';
+
+      for (const chunk of chunks) {
+        if (!chunk) {
+          throw new DyFM_Error({
+            ...this.getDefaultErrorSettings(
+              'reassembleChunksToContent', 
+              new Error('Chunk is null, you`ve passing null chunks to the function'), 
+              issuer
+            ),
+            errorCode: 'CCAP-CUC-RCTC0',
+
+            additionalContent: {
+              chunks: chunks,
+            },
+          });
+        }
+
+        pageContent += chunk.chunkOriginalContent;
+      }
+
+      return pageContent;
+    } catch (error) {
+      throw new DyFM_Error({
+        ...this.getDefaultErrorSettings('reassembleChunks', error, issuer),
+        errorCode: 'CCAP-CUC-RC0',
+      });
+    }
+  }
+
+  /**
+   * Unified break points configuration
+   */
+  private static readonly breakPoints = [
+    { pattern: '\n# ', level: 1, includeLength: 0 }, // Header 1 - cut before marker
+    { pattern: '\n## ', level: 2, includeLength: 0 }, // Header 2 - cut before marker
+    { pattern: '\n### ', level: 3, includeLength: 0 }, // Header 3 - cut before marker
+    { pattern: '\n#### ', level: 4, includeLength: 0 }, // Header 4 - cut before marker
+    { pattern: '\n\n', level: 0, includeLength: 2 }, // Double line break - include
+    { pattern: '\n', level: 0, includeLength: 1 }, // Single line break - include
+    { pattern: '. ', level: 0, includeLength: 2 }, // Sentence end - include
+    { pattern: ' ', level: 0, includeLength: 1 }, // Word break - include
+  ];
+
+  /**
+   * Find the best break point within the chunk size
+   * @param text - The text to search in
+   * @param maxIndex - Maximum index to search up to
+   * @returns The best break point or null if not found
+   */
+  private static findBestBreakPoint(text: string, maxIndex: number): { index: number, level: number } | null {
+    for (const breakPoint of this.breakPoints) {
+      const index = this.findLastOccurrence(text, breakPoint.pattern, maxIndex);
+      if (index > 0) {
+        return {
+          index: index + breakPoint.includeLength,
+          level: breakPoint.level
+        };
+      }
+    }
+    return null;
+  }
+
+  /**
+   * Parse header hierarchy from the content
+   * @param content - The content to parse
+   * @returns Array of header positions and levels
+   */
+  private static parseHeaderHierarchy(content: string): Array<{index: number, level: number, header: string}> {
+    const headers: Array<{index: number, level: number, header: string}> = [];
+    const lines = content.split('\n');
+    let currentIndex = 0;
+
+    for (const line of lines) {
+      const trimmedLine = line.trim();
+      
+      // Check if line starts with # and determine the level
+      if (trimmedLine.startsWith('#')) {
+        const match = trimmedLine.match(/^(#+)\s+(.+)$/);
+        if (match) {
+          const level = match[1].length; // Count the number of # symbols
+          const headerText = trimmedLine;
+          
+          if (level >= 1 && level <= 4) { // Only support levels 1-4
+            headers.push({
+              index: currentIndex,
+              level: level,
+              header: headerText
+            });
+          }
+        }
+      }
+      
+      currentIndex += line.length + 1; // +1 for the newline
+    }
+
+    return headers;
+  }
+
+  /**
+   * Update the last headers map based on current position
+   * @param headerHierarchy - The parsed header hierarchy
+   * @param currentPosition - Current position in content
+   * @param lastHeaders - Map to store last headers of each level
+   */
+  private static updateLastHeaders(
+    headerHierarchy: Array<{index: number, level: number, header: string}>,
+    currentPosition: number,
+    lastHeaders: Map<number, string>
+  ): void {
+    // Find all headers that come before current position (not including current position)
+    for (const header of headerHierarchy) {
+      if (header.index < currentPosition) {
+        // Set this header as the last header for its level
+        lastHeaders.set(header.level, header.header);
+        
+        // Clear all lower level headers (higher level numbers) when any header comes
+        // For example, if we see a level 2 header, clear levels 3, 4
+        // If we see a level 1 header, clear levels 2, 3, 4
+        for (let level = header.level + 1; level <= 4; level++) {
+          lastHeaders.delete(level);
+        }
+      }
+    }
+  }
+
+  /**
+   * Build hierarchical chunk path based on header structure
+   * @param pageName - The page name
+   * @param headerHierarchy - The parsed header hierarchy
+   * @param startIndex - Start index of the chunk in original content
+   * @param endIndex - End index of the chunk in original content
+   * @param lastHeaders - Map of last headers for each level
+   * @returns Hierarchical path array
+   */
+  private static buildChunkPath(
+    pageName: string,
+    headerHierarchy: Array<{index: number, level: number, header: string}>,
+    startIndex: number,
+    endIndex: number,
+    lastHeaders: Map<number, string>
+  ): string[] {
+    // Find the first header within this chunk
+    const firstHeaderInChunk = headerHierarchy.find(header => 
+      header.index >= startIndex && header.index < endIndex
+    );
+
+    if (!firstHeaderInChunk) {
+      // No header in chunk, use the highest level from lastHeaders as parent
+      const pathParts: string[] = [pageName];
+      
+      // Find the highest level header from lastHeaders
+      let highestLevel = 0;
+      let highestHeader = '';
+      for (const [level, header] of lastHeaders.entries()) {
+        if (level > highestLevel) {
+          highestLevel = level;
+          highestHeader = header;
+        }
+      }
+      
+      if (highestHeader) {
+        pathParts.push(highestHeader);
+      }
+      
+      return pathParts;
+    }
+
+    // Build the path hierarchy
+    const pathParts: string[] = [pageName];
+    
+    // Add parent headers from lastHeaders (these are the actual parent headers)
+    for (let level = 1; level < firstHeaderInChunk.level; level++) {
+      const parentHeader = lastHeaders.get(level);
+      if (parentHeader) {
+        pathParts.push(parentHeader); // Include the full header with markdown symbols
+      }
+    }
+
+    // Add the first header in chunk
+    pathParts.push(firstHeaderInChunk.header); // Include the full header with markdown symbols
+
+    return pathParts;
+  }
+
+  /**
+   * Add header hierarchy to the beginning of a chunk
+   * @param chunkContent - The chunk content
+   * @param headerHierarchy - The parsed header hierarchy
+   * @param startIndex - Start index of the chunk in original content
+   * @param endIndex - End index of the chunk in original content
+   * @param lastHeaders - Map of last headers for each level
+   * @returns Content with header hierarchy added
+   */
+  private static addHeaderHierarchy(
+    chunkContent: string, 
+    headerHierarchy: Array<{index: number, level: number, header: string}>,
+    startIndex: number,
+    endIndex: number,
+    lastHeaders: Map<number, string>
+  ): string {
+    // Find the first header within this chunk to determine its level
+    const firstHeaderInChunk = headerHierarchy.find(header => 
+      header.index >= startIndex && header.index < endIndex
+    );
+
+    if (!firstHeaderInChunk) {
+      // No header in chunk, use the highest level from lastHeaders as parent
+      const relevantHeaders: string[] = [];
+      
+      // Find the highest level header from lastHeaders
+      let highestLevel = 0;
+      let highestHeader = '';
+      for (const [level, header] of lastHeaders.entries()) {
+        if (level > highestLevel) {
+          highestLevel = level;
+          highestHeader = header;
+        }
+      }
+      
+      if (highestHeader) {
+        relevantHeaders.push(highestHeader);
+      }
+
+      if (relevantHeaders.length > 0) {
+        return relevantHeaders.join('\n') + '\n\n' + chunkContent;
+      }
+
+      return chunkContent;
+    }
+
+    // Build hierarchy from stored last headers (only parent headers, not from chunk content)
+    const relevantHeaders: string[] = [];
+    
+    // Add parent headers based on the first header in chunk level
+    for (let level = 1; level < firstHeaderInChunk.level; level++) {
+      const parentHeader = lastHeaders.get(level);
+      if (parentHeader) {
+        relevantHeaders.push(parentHeader);
+      }
+    }
+
+    if (relevantHeaders.length > 0) {
+      return relevantHeaders.join('\n') + '\n\n' + chunkContent;
+    }
+
+    return chunkContent;
+  }
+
+  /**
+   * Helper method to find the last occurrence of a pattern within a specified range
+   * @param text - The text to search in
+   * @param pattern - The pattern to search for
+   * @param maxIndex - Maximum index to search up to
+   * @returns The index of the last occurrence, or -1 if not found
+   */
+  private static findLastOccurrence(text: string, pattern: string, maxIndex: number): number {
+    const searchText = text.substring(0, maxIndex);
+    const lastIndex = searchText.lastIndexOf(pattern);
+    return lastIndex;
+  }
+  
+  protected static getDefaultErrorSettings(
+    fnName: string, 
+    error: DyFM_AnyError,
+    issuer: string,
+    /* errorCode: string, */
+  ): DyFM_Error_Settings {
+    return {
+      status: (error as DyFM_Error)?.___status ?? 500,
+      message: (error as Error)?.message ??
+        (error as DyFM_Error)?._message ??
+        `${fnName} was UNSUCCESSFUL (${DyNTS_global_settings.systemShortCodeName})`,
+      addECToUserMsg: !(error as DyFM_Error)?.__userMessage,
+      userMessage: (error as DyFM_Error)?.__userMessage ?? this.defaultErrorUserMsg,
+      /* errorCode: errorCode, */
+      issuer: issuer,
+      issuerService: this.constructor?.name,
+      error: error,
+    };
+  }
+} 

package/src/_modules/open-ai/_collections/oai-document.util.ts

@@ -0,0 +1,10 @@
+
+
+export class DyNTS_OAI_Document_Util {
+
+  static getClickupPageLink(pageName: string, workspaceId: string, documentId: string, pageId: string): string {
+         // https://app.clickup.com/9012753333/v/dc/8ck7cxn-692/8ck7cxn-1052
+    const link = `https://app.clickup.com/${workspaceId}/v/dc/${documentId}/${pageId}`;
+    return `[${pageName}](${link})`;
+  }
+}

package/src/_modules/open-ai/_collections/oai-global-settings.const.ts

@@ -0,0 +1,9 @@
+import { DyFM_GPTCall_Settings } from '@futdevpro/fsm-dynamo/open-ai';
+import { DyNTS_OAI_Global_Settings } from '../_models/interfaces/oai-global-settings.interface';
+
+
+
+export const DyNTS_OAI_global_settings: DyNTS_OAI_Global_Settings = {
+  defaultSettings: new DyFM_GPTCall_Settings(),
+  maxMessagesStringLength: 120_000,
+}

package/src/_modules/open-ai/_collections/oai-llm-predefined-requests-hu.conts.ts

@@ -0,0 +1,83 @@
+import { DyNTS_OAI_LLM_Predefined_Requests } from '../_models/interfaces/oai-llm-predefined-requests.interface';
+
+
+
+export const DyNTS_OAI_LLMDefaultPredefined_RequestsHU: DyNTS_OAI_LLM_Predefined_Requests = {
+
+  defaultSystemPrompt: 
+    'Te egy határozott, precíz és informatív asszisztens vagy. ' +
+    'Semmi mellébeszélés, vagy fölösleges szócséplés, csak a hatékonyság és a pontosság. ' +
+    'Első sorban egy szoftverfejlesztő asszisztens vagy, ' +
+      'de nem csak a szoftverfejlesztésre vagy képes, ' +
+      'hanem mindenre amiről még nem derült ki, hogy nem. ' +
+    'A felhasználó egy discord csatornán keresztül kommunikál veled, ' +
+      'és a beszélgetésben egyszerre több felhasználó is megjelenhet. ' +
+    'Mindig a legjobb választ adod, és a legjobb megközelítést követed. ' +
+    'Elsődleges célod a világ jobbá tétele, és minden ember boldogsága és fejlődése minden szinten; ' +
+    'Asztrál (érzelmi), Mentál (tudati) és Anyagi (fizikai) szinten. ' +
+    'Igyekszel minden kérdést minél alaposabban körbejárni, és ez alapján a legjobb választ adni. ' +
+    'Strukturáltan, lépésről lépésre, röviden válaszolj. ' +
+    'Ne félj akár egy szavas válaszokat adni! ' +
+    'Egyszerre maximum 5 sorban, de ha lehet inkább csak 3 sorban válaszolj ' +
+    '(Hacsak nem nagyon indokolt a bővebb kifejtés). ' +
+    'Adj kódmintákat, hogy ha az a kérdés, hogy valamit, hogyan kell megcsinálni a fejlesztés során! ' +
+    'Kódminták esetén mindig törekedj a lehető legrövidebb és leghatékonyabb kódot választani! ' +
+    'Csak akkor kérdezz vissza, ha szükséges! Ne hezitálj több infót kérni! ' +
+    'Kerüld a felesleges visszakérdezéseket és automatikus folytatási ajánlásokat. ' +
+    'Kommunikálj hatékonyan és célorientáltan. ' +
+    '(NE legyenek olyan töltelék mondatok és kérdések, ' +
+      'mint a "miben segíthetek még?", "...bármi, csak szólj!", "...szívesen segítek...", ' +
+      '"ha további segítségre van szükséged, jelezd és segítek...", stb.!!!) ' +
+    'Olyan tömören válaszolj, amennyire csak lehetséges! Akár tőszavakban! ',
+
+  yesNo: {
+    request: ' (Csak "Yes" vagy "No" választ adhatsz)',
+    upperCaseYes: 'YES',
+  },
+  percentageOnly: ' (Csak 0 és 1 közötti számot adhatsz vissza, például: 0.65)',
+  selectRequest: ' (Csak a következők közül választhatsz: {{DyNTS_selectOptions}})',
+  multiselect: ' (Csak a következők közül választhatsz: {{DyNTS_selectOptions}})',
+  jsonRequest: ' (A válaszodnak JSON formátumban kell lennie)',
+  jsonRequestWithKeysDescription: ' (A válaszodnak JSON formátumban kell lennie, {{DyNTS_jsonKeysDescription}})',
+  jsonRequestWithExactKeys: ' (A válaszodnak JSON formátumban kell lennie, a kulcsok: {{DyNTS_jsonKeys}})',
+  listRequest: ' (A válaszodnak JSON listában kell lennie)',
+
+  vectorSearch: {
+    systemPrompt: 
+      'Nagy tapasztalatod van a vektor adatbázisokkal, ' +
+        'és a vektor adatbázisokban való kereséssel. ' +
+      'Valamint nagy magabiztossággal tudsz úgy körülírni egy témakört, ' +
+        'hogy az a legtöbb releváns információt adja vissza.',
+    getSearchQuestion: 
+      'A következő lépésben egy vektor adatbázisban fogunk keresni releváns információkat. ' +
+      'Kérlek, írj egy kérdést, hogy mit szeretnénk keresni a vektor adatbázisban. ' +
+      'Minden egyéb információ adott, és minden amire a felhasználó nem kérdez külön rá, az irreleváns. ' +
+      'Ezzel a kérdéssel keresünk a vektor adatbázisban, ' +
+      'Próbáld minél jobban körülírni a kérdést, ' +
+        'hogy minél több releváns információt találhassunk meg! ' +
+      'Fontos, hogy nagyon tömören fogalmazd meg a kérdést! ' +
+      'A válaszodba mindig írd bele a "pageLink"-et is! ',
+    resolveSearchResults: 
+      'A válaszodba írd bele a "pageLink"-et is! ' +
+      'Ha a releváns információk nem találhatók meg a vektor adatbázisban, ' +
+      'akkor azt jelezd a felhasználónak, ' +
+      'hogy nem találtál releváns információt a Documentum gyűjteményben, ' +
+      'vagy valamilyen hiba adódott a vektor keresés során.' +
+      'A releváns információkat használd fel a válaszodhoz. ' +
+      'Ne térj el a vektor keresés eredményeitől! ' +
+      'Minden rendelkezésre álló információ adott. ' +
+      'Ha a válaszhoz szükséges információk a vektor keresési eredményben megtalálhatók, ' +
+      'ne kérdezz vissza, még akkor sem, ha a kérdés nem teljesen pontosan fogalmazott. ' +
+      'Semmilyen olyan információt ne adj meg, ami nem szerepel a vektor keresés eredményeiben! ' +
+      'A válszodat kezdd a "pageLink"-el! ' +
+      'Soha ne változtass a releváns információkban! ' +
+      '(A kész elemeket így jelöljük: "[x]", a todo elemeket így: "[ ]")' +
+      'Ne hagyj ki semmit ami releváns! ' +
+      'Minden releváns és felhasznált oldalt említs meg! ' +
+      'A válaszodhoz keresd ki az információkat a következő keresési eredményekből: ' +
+      '\nA vektor keresés a következő eredményeket adta, mint a releváns információk: \n',
+    doWeNeedVectorSearch: 
+      'Van-e szükség a Documentum gyűjteményből bármilyen információra, ' +
+        'hogy a felhasználó kérdését meg tudjuk válaszolni? ',
+  },
+};

package/src/_modules/open-ai/_collections/oai-llm-predefined-requests.conts.ts

@@ -0,0 +1,76 @@
+import { DyNTS_OAI_LLM_Predefined_Requests } from '../_models/interfaces/oai-llm-predefined-requests.interface';
+
+
+
+export const DyNTS_OAI_LLMDefaultPredefined_Requests: DyNTS_OAI_LLM_Predefined_Requests = {
+
+  defaultSystemPrompt: 
+    'You are a precise, assertive, and informative assistant. ' +
+    'No small talk or unnecessary fluff — only efficiency and accuracy. ' +
+    'Primarily a software development assistant, ' +
+      'but capable of assisting with anything not proven otherwise. ' +
+    'Always deliver the best possible answer and follow the best available approach. ' +
+    'Your goal is to support users on all levels: ' +
+      'Astral (emotional), Mental (cognitive), and Physical (practical). ' +
+    'Thoroughly analyze each request and respond with the most effective answer. ' +
+    'Answer in a structured, step-by-step, and concise manner. ' +
+    'Do not hesitate to give one-word or keyword-style answers if appropriate. ' +
+    'Keep answers within 3 lines if possible, maximum 5 lines. ' +
+    'Provide code snippets when the request involves implementation, ' +
+      'always favoring the shortest and most efficient solutions. ' +
+    'Ask follow-up questions only when necessary. Do not hesitate to ask for missing info. ' +
+    'Avoid redundant questions and auto-suggested continuations. ' +
+    'Communicate in a goal-oriented, effective way. ' +
+    'Avoid filler phrases like "let me know if you need anything else", "happy to help", ' +
+      'or "feel free to reach out", etc. ' +
+    'Be as concise as possible — even terse. ',
+
+  yesNo: {
+    request: ' (Only answer with "Yes" or "No")',
+    upperCaseYes: 'YES',
+  },
+  percentageOnly: ' (Only answer with a number between 0 and 1, e.g.: 0.65)',
+  selectRequest: ' (Only answer with one of the following: {{DyNTS_selectOptions}})',
+  multiselect: ' (Only answer with one or more of the following: {{DyNTS_selectOptions}})',
+  jsonRequest: ' (The answer must be in JSON format)',
+  jsonRequestWithKeysDescription: ' (The answer must be in JSON format, {{DyNTS_jsonKeysDescription}})',
+  jsonRequestWithExactKeys: ' (The answer must be in JSON format, where the keys are: {{DyNTS_jsonKeys}})',
+  listRequest: ' (The answer must be in JSON list format)',
+
+  vectorSearch: {
+    systemPrompt: 
+      'You have a lot of experience with vector databases, ' +
+        'and with searching in vector databases. ' +
+      'You can describe a topic with great confidence, ' +
+        'so that it gives the most relevant informations.',
+    getSearchQuestion: 
+      'In the next step, we will search for relevant information in a vector database. ' +
+      'Please, write a question to search for in the vector database. ' +
+      'All other information is given, and everything that the user does not ask about is irrelevant. ' +
+      'With this question, we will search in the vector database. ' +
+      'Try to describe the question as best as possible, ' +
+        'so that we find as many relevant informations as possible! ' +
+      'Important, you must describe the question very concisely!',
+    resolveSearchResults: 
+      'The answer must always contain the "pageLink" key! ' +
+      'If the relevant information is not found in the vector database, ' +
+        'then you must tell the user that you did not find relevant information in the Documentum collection, ' +
+        'or that an error occurred during the vector search. ' +
+      'Use the relevant information for your answer. ' +
+      'Do not deviate from the vector search results! ' +
+      'All available information is given. ' +
+      'If the information needed for the answer is found in the vector search results, ' +
+        'do not ask again, even if the question is not fully formulated. ' +
+      'Do not give any information that is not in the vector search results! ' +
+      'Start your answer with the "pageLink" key! ' +
+      'Never change the relevant information! ' +
+      '(Mark the completed items like this: "[x]", and the todo items like this: "[ ]")' +
+      'Do not miss anything that is relevant! ' +
+      'Mention every relevant and used page! ' +
+      'Use the information from the following search results: ' +
+      '\nThe vector search gave the following results as relevant information: \n',
+    doWeNeedVectorSearch: 
+      'Is there a need for any information from the Documentum collection, ' +
+        'to answer the user\'s question? ',
+  },
+};

package/src/_modules/open-ai/_enums/oai-compare-result-type.enum.ts

@@ -0,0 +1,7 @@
+
+
+export enum DyNTS_OAI_CompareResult_Type {
+  equal = 'equal',
+  modified = 'modified',
+  new = 'new',
+}