/**
* SYSTÈME D'AIDE INTUITIF POUR creer_embed()
* Pour agents avec perte de mémoire - Tout est documenté et guidé !
*/
import Logger from './logger.js';
// ============================================================================
// MESSAGES D'AIDE ET CONSEILS
// ============================================================================
export const HELP_MESSAGES = {
// Messages d'erreur avec solutions
MISSING_CHANNEL_ID: {
error: '❌ ERREUR: channelId manquant',
solution: "💡 SOLUTION: Ajoutez channelId avec l'ID de votre canal Discord",
example: `Exemple:
creer_embed({
channelId: '1442317829998383235', // ← AJOUTEZ CETTE LIGNE
title: 'Mon titre',
description: 'Ma description'
});`,
},
MISSING_TITLE: {
error: '❌ ERREUR: title manquant',
solution: '💡 SOLUTION: Ajoutez un title (titre) à votre embed',
example: `Exemple:
creer_embed({
channelId: 'VOTRE_ID',
title: '📊 Mon Rapport', // ← AJOUTEZ CETTE LIGNE
description: 'Texte principal'
});`,
},
MISSING_DESCRIPTION: {
error: '❌ ERREUR: description manquante',
solution: '💡 SOLUTION: Ajoutez une description (texte principal)',
example: `Exemple:
creer_embed({
channelId: 'VOTRE_ID',
title: 'Mon titre',
description: 'Voici le contenu principal de l\'embed...', // ← AJOUTEZ CETTE LIGNE
fields: [...]
});`,
},
TOO_MANY_FIELDS: {
error: '⚠️ ATTENTION: Trop de fields détectés',
solution: '💡 CONSEIL: Limitez à 5-10 fields maximum pour la lisibilité',
example: `Correct:
fields: [
{ name: 'Info 1', value: 'Donnée 1', inline: true },
{ name: 'Info 2', value: 'Donnée 2', inline: true },
{ name: 'Info 3', value: 'Donnée 3', inline: true }
]; // ← Maximum recommandé: 10 fields`,
},
INVALID_IMAGE_URL: {
error: "⚠️ URL d'image détectée comme potentiellement invalide",
solution: '✅ SOLUTION: Auto-correction appliquée avec emoji de fallback',
example: `URLs alternatives recommandées:
• https://cdn.simpleicons.org/discord (Logos SimpleIcons)
• https://images.unsplash.com/photo-XXX (Images Unsplash)
• https://cdn.discordapp.com/emojis/ID (Emojis Discord)
• Laissez vide → Emoji automatique appliqué`,
},
// Messages d'encouragement
SUCCESS_WITH_THEME: {
message: '✅ Excellent ! Thème appliqué avec succès',
tip: '💡 Astuce: Les thèmes sont des templates - personnalisez title, description et fields selon vos besoins',
},
SUCCESS_WITHOUT_THEME: {
message: '✅ Embed créé avec succès',
tip: '💡 Astuce: Utilisez un thème pour accélérer la création (basic, data_report, status_update, etc.)',
},
PHASE1_ENHANCEMENT: {
message: '🚀 Phase 1 Enhancement activé !',
features: [
"✅ Cache local d'images automatique",
'✅ Fallback intelligent (URL → Emoji)',
'✅ Validation pré-exécution',
'✅ Optimisation selon positions Discord',
],
},
};
// ============================================================================
// SUGGESTIONS AUTOMATIQUES CONTEXTUELLES
// ============================================================================
export const SUGGESTIONS = {
// Suggestion de thème selon le contexte
suggestTheme: (params: any): string | null => {
const title = (params.title || '').toLowerCase();
const description = (params.description || '').toLowerCase();
if (title.includes('rapport') || title.includes('stat') || description.includes('données')) {
return '💡 Suggestion: Utilisez theme: "data_report" pour un rapport avec indicateurs';
}
if (
title.includes('statut') ||
title.includes('état') ||
description.includes('opérationnel')
) {
return '💡 Suggestion: Utilisez theme: "status_update" pour afficher un statut système';
}
if (
title.includes('produit') ||
title.includes('nouveau') ||
description.includes('fonctionnalité')
) {
return '💡 Suggestion: Utilisez theme: "product_showcase" pour présenter un produit';
}
if (title.includes('classement') || title.includes('top') || description.includes('score')) {
return '💡 Suggestion: Utilisez theme: "leaderboard" pour un classement';
}
if (title.includes('dashboard') || description.includes('métriques')) {
return '💡 Suggestion: Utilisez theme: "dashboard" pour un tableau de bord temps réel';
}
if (
title.includes('tech') ||
title.includes('fonctionnalité') ||
description.includes('update')
) {
return '💡 Suggestion: Utilisez theme: "tech_announcement" pour une annonce technique';
}
if (title.includes('actualités') || title.includes('news') || description.includes('social')) {
return '💡 Suggestion: Utilisez theme: "social_feed" pour un contenu social';
}
return null;
},
// Suggestion d'images selon le contenu
suggestImages: (params: any): string[] => {
const suggestions: string[] = [];
const title = (params.title || '').toLowerCase();
if (title.includes('rapport') || title.includes('stat')) {
suggestions.push(
'💡 Astuce image: Ajoutez thumbnail avec un emoji ou une icône (ex: 📊, 📈)'
);
}
if (title.includes('produit')) {
suggestions.push("💡 Astuce image: Ajoutez image avec une capture d'écran du produit");
}
if (title.includes('classement')) {
suggestions.push('💡 Astuce image: Ajoutez thumbnail avec 🏆 ou 🥇');
}
if (!params.image && !params.thumbnail) {
suggestions.push("💡 Astuce: Ajoutez image ou thumbnail pour rendre l'embed plus visuel");
}
return suggestions;
},
// Suggestion de boutons selon le contexte
suggestButtons: (params: any): string[] => {
const suggestions: string[] = [];
const title = (params.title || '').toLowerCase();
if (title.includes('rapport') || title.includes('dashboard')) {
suggestions.push(
'💡 Suggestion: Ajoutez un bouton "🔄 Actualiser" pour rafraîchir les données'
);
}
if (title.includes('produit')) {
suggestions.push('💡 Suggestion: Ajoutez des boutons "🛒 Acheter" et "📖 En savoir plus"');
}
if (title.includes('sondage') || title.includes('vote')) {
suggestions.push('💡 Suggestion: Ajoutez des boutons de vote (Option A, Option B, Option C)');
}
if (!params.buttons || params.buttons.length === 0) {
suggestions.push("💡 Astuce: Ajoutez des boutons pour rendre l'embed interactif");
}
return suggestions;
},
};
// ============================================================================
// GUIDE INTERACTIF CONTEXTUEL
// ============================================================================
export const INTERACTIVE_GUIDE = {
// Génère un guide selon les paramètres fournis
generateGuide: (params: any): string[] => {
const guide: string[] = [];
guide.push('📚 **GUIDE RAPIDE - creer_embed()**\n');
// Étape 1: Paramètres obligatoires
guide.push('✅ **ÉTAPE 1: Paramètres obligatoires**');
guide.push(`• channelId: ${params.channelId ? '✅ Configuré' : '❌ Manquant - OBLIGATOIRE'}`);
guide.push(`• title: ${params.title ? '✅ Configuré' : '❌ Manquant - OBLIGATOIRE'}`);
guide.push(
`• description: ${params.description ? '✅ Configurée' : '❌ Manquante - OBLIGATOIRE'}\n`
);
// Étape 2: Thème
guide.push('✅ **ÉTAPE 2: Thème (recommandé)**');
if (params.theme) {
guide.push(`• theme: ✅ "${params.theme}" appliqué`);
} else {
guide.push('• theme: ❌ Non défini');
guide.push(' 💡 Utilisez un thème pour accélérer la création:');
guide.push(' → data_report (rapports)');
guide.push(' → status_update (statuts)');
guide.push(' → product_showcase (produits)');
guide.push(' → leaderboard (classements)');
guide.push(' → cyberpunk (futuriste)');
guide.push(' → cyber_code (terminal & code)');
guide.push(' → sentinel_alpha (🚨 trading signals)');
guide.push(' → deep_logic (🧠 reasoning & analysis)');
guide.push(' → matrix_rain (🕶️ hacker styles)');
guide.push(' → trading_master (💰 finance hub)');
guide.push(' → nebula_vision (🌌 AI vision)');
guide.push(' → dashboard (métriques)\n');
}
// Étape 3: Images
guide.push('✅ **ÉTAPE 3: Images (optionnel)**');
guide.push(
`• image: ${params.image ? '✅ Configurée' : '❌ Non définie - Grande image en bas'}`
);
guide.push(
`• thumbnail: ${params.thumbnail ? '✅ Configurée' : '❌ Non définie - Petite image haut-droite'}`
);
guide.push(
`• authorIcon: ${params.authorIcon ? '✅ Configurée' : '❌ Non définie - Icône auteur haut-gauche'}\n`
);
// Étape 4: Interactivité
guide.push('✅ **ÉTAPE 4: Interactivité (optionnel)**');
if (params.buttons && params.buttons.length > 0) {
guide.push(`• buttons: ✅ ${params.buttons.length} bouton(s) configuré(s)`);
} else {
guide.push('• buttons: ❌ Aucun bouton - Embed non interactif');
guide.push(" 💡 Ajoutez des boutons pour l'engagement");
}
if (params.selectMenus && params.selectMenus.length > 0) {
guide.push(`• selectMenus: ✅ ${params.selectMenus.length} menu(s) configuré(s)`);
}
// Étape 5: Fonctionnalités avancées
guide.push('\n✅ **ÉTAPE 5: Fonctionnalités avancées (optionnel)**');
if (params.autoUpdate?.enabled) {
guide.push('• autoUpdate: ✅ Mise à jour automatique activée');
}
if (params.progressBars && params.progressBars.length > 0) {
guide.push(`• progressBars: ✅ ${params.progressBars.length} barre(s) de progression`);
}
if (params.charts && params.charts.length > 0) {
guide.push(`• charts: ✅ ${params.charts.length} graphique(s) ASCII`);
}
// Conseils contextuels
guide.push('\n💡 **CONSEILS CONTEXTUELS:**');
const themeSuggestion = SUGGESTIONS.suggestTheme(params);
if (themeSuggestion) {
guide.push(themeSuggestion);
}
const imageSuggestions = SUGGESTIONS.suggestImages(params);
imageSuggestions.forEach(s => guide.push(s));
const buttonSuggestions = SUGGESTIONS.suggestButtons(params);
buttonSuggestions.forEach(s => guide.push(s));
// Phase 1
guide.push('\n🚀 **PHASE 1 ENHANCEMENT (automatique):**');
guide.push("• Cache local d'images activé");
guide.push('• Fallback intelligent activé');
guide.push('• Validation URL activée');
guide.push('• Optimisation Discord activée');
return guide;
},
// Exemple de code selon le contexte
generateExample: (params: any): string => {
const examples: Record<string, string> = {
minimal: `creer_embed({
channelId: 'VOTRE_ID',
theme: 'minimal',
title: '📝 Mon Titre',
description: 'Description principale ici...',
fields: [
{ name: 'Info 1', value: 'Donnée 1', inline: true },
{ name: 'Info 2', value: 'Donnée 2', inline: true }
]
});`,
data_report: `creer_embed({
channelId: 'VOTRE_ID',
theme: 'data_report',
title: '📊 Rapport de Données',
description: 'Résultats et analyses:',
fields: [
{ name: '📈 Indicateur 1', value: '1,234 (↑ 12%)', inline: true },
{ name: '📉 Indicateur 2', value: '567 (↓ 3%)', inline: true },
{ name: '📋 Détails', value: 'Analyse complète...', inline: false }
]
});`,
status_update: `creer_embed({
channelId: 'VOTRE_ID',
theme: 'status_update',
title: '🔄 Mise à jour de Statut',
description: 'État actuel du système:',
fields: [
{ name: '🟢 Service A', value: 'OPÉRATIONNEL', inline: true },
{ name: '🟢 Service B', value: 'OPÉRATIONNEL', inline: true },
{ name: '📝 Notes', value: 'Dernière MAJ: {timestamp}', inline: false }
],
buttons: [
{ label: '🔄 Actualiser', style: 'Primary', action: 'refresh' }
]
});`,
cyberpunk: `creer_embed({
channelId: 'VOTRE_ID',
theme: 'cyberpunk',
title: '🌆 Terminal Cyberpunk',
description: 'Procotole Alpha-1 activé. Analyse de la matrice...',
charts: [
{ title: 'Signal Stabilité', type: 'sparkline', data: [10, 20, 15, 30, 25, 40] }
],
buttons: [
{ label: '🔮 Décoder', style: 'Primary', action: 'custom', custom_id: 'btn_decode' }
]
});`,
cyber_code: `creer_embed({
channelId: 'VOTRE_ID',
theme: 'cyber_code',
title: '💻 SYSTEM CORE',
themeOptions: {
terminal: true,
code: 'const access = "granted";\\nconsole.log(access);',
language: 'typescript'
}
});`,
};
return examples[params.theme] || examples.minimal;
},
};
// ============================================================================
// VALIDATION INTELLIGENTE AVEC CONSEILS
// ============================================================================
interface ValidationResult {
isValid: boolean;
errors: string[];
warnings: string[];
tips: string[];
}
export const INTELLIGENT_VALIDATION = {
// Valide les paramètres et retourne des conseils
validate: (params: any): ValidationResult => {
const errors: string[] = [];
const warnings: string[] = [];
const tips: string[] = [];
// Vérifications obligatoires
if (!params.channelId) {
errors.push(HELP_MESSAGES.MISSING_CHANNEL_ID.error);
errors.push(HELP_MESSAGES.MISSING_CHANNEL_ID.solution);
}
if (!params.title) {
errors.push(HELP_MESSAGES.MISSING_TITLE.error);
errors.push(HELP_MESSAGES.MISSING_TITLE.solution);
}
if (!params.description) {
errors.push(HELP_MESSAGES.MISSING_DESCRIPTION.error);
errors.push(HELP_MESSAGES.MISSING_DESCRIPTION.solution);
}
// Vérifications recommandées
if (!params.theme) {
warnings.push(
'⚠️ Thème non défini - Considérez utiliser un thème pour accélérer la création'
);
tips.push(
'💡 Thèmes premium: sentinel_alpha (trading), deep_logic (raisonnement), matrix_rain (hacker), trading_master (finance), nebula_vision (IA abstract)'
);
}
// Vérifications d'optimisation
if (params.fields && params.fields.length > 10) {
warnings.push(HELP_MESSAGES.TOO_MANY_FIELDS.error);
warnings.push(HELP_MESSAGES.TOO_MANY_FIELDS.solution);
}
if (!params.image && !params.thumbnail) {
warnings.push("⚠️ Aucune image définie - L'embed sera textuel uniquement");
tips.push('💡 Astuce: Ajoutez image ou thumbnail pour rendre plus visuel');
}
if (!params.buttons || params.buttons.length === 0) {
tips.push("💡 Astuce: Ajoutez des boutons pour l'interactivité (max 5)");
}
// Conseils contextuels
const themeSuggestion = SUGGESTIONS.suggestTheme(params);
if (themeSuggestion) {
tips.push(themeSuggestion);
}
return {
isValid: errors.length === 0,
errors,
warnings,
tips,
};
},
// Affiche les résultats de validation
displayResults: (results: ValidationResult): void => {
if (results.errors.length > 0) {
Logger.error('\n❌ ERREURS À CORRIGER:');
results.errors.forEach((error: string) => Logger.error(` ${error}`));
}
if (results.warnings.length > 0) {
Logger.warn('\n⚠️ AVERTISSEMENTS:');
results.warnings.forEach((warning: string) => Logger.warn(` ${warning}`));
}
if (results.tips.length > 0) {
Logger.info('\n💡 CONSEILS:');
results.tips.forEach((tip: string) => Logger.info(` ${tip}`));
}
if (results.isValid) {
Logger.info('\n✅ Validation réussie !');
Logger.info(HELP_MESSAGES.SUCCESS_WITH_THEME.message);
Logger.info(HELP_MESSAGES.SUCCESS_WITH_THEME.tip);
Logger.info('\n🚀 Phase 1 Enhancement activé:');
HELP_MESSAGES.PHASE1_ENHANCEMENT.features.forEach((feature: string) =>
Logger.info(` ${feature}`)
);
}
},
};
// ============================================================================
// RACCOURCIS ET TEMPLATES PRÊTS
// ============================================================================
export const QUICK_TEMPLATES = {
// Génère un embed simple en une ligne
quickBasic: (channelId: string, title: string, description: string): any => ({
channelId,
theme: 'basic',
title,
description,
fields: [
{ name: 'Info 1', value: 'Donnée 1', inline: true },
{ name: 'Info 2', value: 'Donnée 2', inline: true },
],
}),
// Génère un rapport en une ligne
quickReport: (channelId: string, title: string, metrics: Record<string, string>): any => {
const fields = Object.entries(metrics).map(([key, value]) => ({
name: key,
value,
inline: true,
}));
return {
channelId,
theme: 'data_report',
title,
description: 'Rapport automatique:',
fields,
};
},
// Génère un statut en une ligne
quickStatus: (channelId: string, services: Record<string, string>): any => {
const fields = Object.entries(services).map(([service, status]) => ({
name: `🟢 ${service}`,
value: status,
inline: true,
}));
return {
channelId,
theme: 'status_update',
title: '🔄 État des Services',
description: 'Dernière vérification: {timestamp}',
fields,
};
},
};
export default {
HELP_MESSAGES,
SUGGESTIONS,
INTERACTIVE_GUIDE,
INTELLIGENT_VALIDATION,
QUICK_TEMPLATES,
};
