@mostajs/aop-providers 0.1.0

package/README.md

@@ -0,0 +1,5 @@
+# @mostajs/aop-providers
+
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+
+Configuration des **fournisseurs IA** (Claude, DeepSeek, ChatGPT, Gemini) et **recherche/sourcing** (Google, **Talordata**, Tavily, Serper, Brave) — pilotée par `.env` + **UI de configuration**. Aucun appel réseau (config seulement). Alimente `@mostajs/llm` (LLM) et les connecteurs de sourcing. Stack `mosta-aop-stack`.

package/llms.txt

@@ -0,0 +1,6 @@
+# @mostajs/aop-providers — fiche LLM
+> Config des fournisseurs IA (Claude/DeepSeek/ChatGPT/Gemini) & recherche/sourcing (Google, Talordata, Tavily, Serper, Brave). Pilotée .env + UI. AUCUN réseau.
+
+## EXPORTS
+PROVIDERS (catalogue) · resolveProvider(key,env) · providersStatus(env) · firstConfigured(kind,env) · llmConfigFromEnv(env)->{dialect,apiKey,baseUrl,key} · searchConfigFromEnv(env) · providersConfigForm({env,action,kinds})->html · parseProvidersForm(form)->{ENVKEY:val}
+Défaut surchargeable : AOP_LLM_PROVIDER / AOP_SEARCH_PROVIDER. Clés masquées dans status/UI. llmConfigFromEnv → à passer à @mostajs/llm. Stack mosta-aop-stack.

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@mostajs/aop-providers",
+  "version": "0.1.0",
+  "description": "Configuration des fournisseurs IA (Claude/DeepSeek/ChatGPT/Gemini) & recherche/sourcing (Google, Talordata, Tavily, Serper, Brave) — pilotée par .env + UI de config. Aucun appel réseau.",
+  "author": "Dr Hamid MADANI <drmdh@msn.com>",
+  "license": "AGPL-3.0-or-later",
+  "type": "module",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "llms.txt"
+  ],
+  "devDependencies": {
+    "@mostajs/mjs-unit": "^0.3.0"
+  },
+  "scripts": {
+    "test": "node test-scripts/unit/aop-providers.test.mjs && node examples/run.mjs"
+  }
+}

package/src/dialects/index.js

@@ -0,0 +1,17 @@
+// Dialectes fournisseur builtin — enregistrés par EFFET DE BORD (import). + meta de BENCHMARK
+// (caractéristiques de référence : hébergement, vitesse, qualité, contexte, coût indicatif $/1M tokens
+// ou $/req). @author Dr Hamid MADANI <drmdh@msn.com>
+import { registerProviderDialect as R } from '../registry.js';
+// ── IA / LLM ── meta:{ hosting, speed, quality, contextK, costIn, costOut } (coûts $/1M tokens, indicatifs)
+R({ key: 'anthropic', kind: 'llm', label: 'Claude (Anthropic)', env: ['ANTHROPIC_API_KEY'], baseUrlEnv: 'ANTHROPIC_BASE_URL', baseUrl: 'https://api.anthropic.com', dashboard: 'https://console.anthropic.com', dialect: 'anthropic', meta: { hosting: 'cloud', speed: 'moyen', quality: 'très élevée', contextK: 200, costIn: 3, costOut: 15 } });
+R({ key: 'deepseek', kind: 'llm', label: 'DeepSeek', env: ['DEEPSEEK_API_KEY'], baseUrlEnv: 'DEEPSEEK_BASE_URL', baseUrl: 'https://api.deepseek.com', dashboard: 'https://platform.deepseek.com', dialect: 'deepseek', meta: { hosting: 'cloud', speed: 'rapide', quality: 'élevée', contextK: 64, costIn: 0.27, costOut: 1.1 } });
+R({ key: 'openai', kind: 'llm', label: 'ChatGPT (OpenAI)', env: ['OPENAI_API_KEY'], baseUrlEnv: 'OPENAI_BASE_URL', baseUrl: 'https://api.openai.com', dashboard: 'https://platform.openai.com', dialect: 'openai', meta: { hosting: 'cloud', speed: 'moyen', quality: 'très élevée', contextK: 128, costIn: 2.5, costOut: 10 } });
+R({ key: 'google-gemini', kind: 'llm', label: 'Gemini (Google)', env: ['GOOGLE_API_KEY'], baseUrl: 'https://generativelanguage.googleapis.com', dashboard: 'https://aistudio.google.com', dialect: 'openai', meta: { hosting: 'cloud', speed: 'rapide', quality: 'élevée', contextK: 1000, costIn: 0.075, costOut: 0.3 } });
+R({ key: 'ollama', kind: 'llm', label: 'Llama (Ollama, local)', env: [], baseUrlEnv: 'OLLAMA_BASE_URL', baseUrl: 'http://localhost:11434/v1', dashboard: 'https://ollama.com/library/llama3.1', dialect: 'ollama', model: 'llama3.1', local: true, meta: { hosting: 'local', speed: 'variable', quality: 'moyenne', contextK: 128, costIn: 0, costOut: 0 } });
+R({ key: 'groq', kind: 'llm', label: 'Llama (Groq)', env: ['GROQ_API_KEY'], baseUrl: 'https://api.groq.com/openai/v1', dashboard: 'https://console.groq.com', dialect: 'openai', model: 'llama-3.3-70b-versatile', meta: { hosting: 'cloud', speed: 'très rapide', quality: 'élevée', contextK: 128, costIn: 0.59, costOut: 0.79 } });
+// ── Recherche / sourcing ── meta:{ coverage, costPerK ($/1000 req indicatif), realtime }
+R({ key: 'google-cse', kind: 'search', label: 'Google Programmable Search', env: ['GOOGLE_CSE_KEY', 'GOOGLE_CSE_CX'], baseUrl: 'https://www.googleapis.com/customsearch/v1', dashboard: 'https://programmablesearchengine.google.com', meta: { coverage: 'Google', costPerK: 5, realtime: true } });
+R({ key: 'talordata', kind: 'search', label: 'TalorData (SerpAPI)', env: ['TALORDATA_API_KEY'], baseUrlEnv: 'TALORDATA_BASE_URL', baseUrl: 'https://serpapi.talordata.net', endpoint: '/serp/v1/request', auth: 'bearer', engine: 'google', dashboard: 'https://dashboard.talordata.com/login', meta: { coverage: 'Google SERP', costPerK: 3, realtime: true } });
+R({ key: 'tavily', kind: 'search', label: 'Tavily', env: ['TAVILY_API_KEY'], baseUrl: 'https://api.tavily.com', dashboard: 'https://app.tavily.com', meta: { coverage: 'web (IA)', costPerK: 8, realtime: true } });
+R({ key: 'serper', kind: 'search', label: 'Serper (Google API)', env: ['SERPER_API_KEY'], baseUrl: 'https://google.serper.dev', dashboard: 'https://serper.dev', meta: { coverage: 'Google SERP', costPerK: 1, realtime: true } });
+R({ key: 'brave', kind: 'search', label: 'Brave Search', env: ['BRAVE_API_KEY'], baseUrl: 'https://api.search.brave.com', dashboard: 'https://brave.com/search/api', meta: { coverage: 'Brave (indépendant)', costPerK: 3, realtime: true } });

package/src/index.js

@@ -0,0 +1,140 @@
+// @mostajs/aop-providers — config des fournisseurs IA & recherche, PATRON DIALECTE (registre, comme
+// @mostajs/llm). Pilotée par .env + UI. AUCUN appel réseau. @author Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0
+import './dialects/index.js'; // enregistre les dialectes builtin (effet de bord, comme @mostajs/llm/dialects)
+import { registerProviderDialect, getProviderDialect, listProviderDialects, clearProviderDialects } from './registry.js';
+export { registerProviderDialect, getProviderDialect, listProviderDialects, clearProviderDialects };
+
+const esc = (s) => String(s ?? '').replace(/[&<>"]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c]));
+const mask = (v) => (v ? `${String(v).slice(0, 3)}••••${String(v).slice(-2)}` : '');
+
+/** Liste des dialectes (back-compat : PROVIDERS reste un tableau). */
+export const PROVIDERS = listProviderDialects();
+export const providerByKey = (key) => getProviderDialect(key);
+
+/** Résout la config d'un fournisseur depuis l'env (null si non configuré). */
+export function resolveProvider(key, env = {}) {
+  const p = getProviderDialect(key); if (!p) return null;
+  if (!p.env.every((k) => !!env[k])) return null;
+  const out = { key: p.key, kind: p.kind, label: p.label, baseUrl: (p.baseUrlEnv && env[p.baseUrlEnv]) || p.baseUrl, dialect: p.dialect, local: !!p.local, endpoint: p.endpoint, engine: p.engine, meta: p.meta || {} };
+  for (const k of p.env) out[k.toLowerCase().replace(/_/g, '')] = env[k];
+  out.apiKey = p.env[0] ? env[p.env[0]] : undefined;
+  out.model = env.AOP_LLM_MODEL || env.LLAMA_MODEL || p.model;
+  return out;
+}
+/** État de tous les fournisseurs (clés masquées). */
+export function providersStatus(env = {}) {
+  return listProviderDialects().map((p) => ({
+    key: p.key, kind: p.kind, label: p.label, dashboard: p.dashboard,
+    baseUrl: (p.baseUrlEnv && env[p.baseUrlEnv]) || p.baseUrl,
+    configured: p.env.every((k) => !!env[k]),
+    env: p.env.map((k) => ({ name: k, set: !!env[k], masked: mask(env[k]) })),
+  }));
+}
+export function firstConfigured(kind, env = {}) {
+  const p = listProviderDialects(kind).find((x) => x.env.every((k) => !!env[k]));
+  return p ? resolveProvider(p.key, env) : null;
+}
+export function llmConfigFromEnv(env = {}) {
+  const picked = String(env.AOP_LLM_PROVIDERS || '').split(',').map((s) => s.trim()).filter(Boolean); // sélection (cases cochées)
+  const order = (env.AOP_LLM_PROVIDER ? [env.AOP_LLM_PROVIDER] : []).concat(picked, ['deepseek', 'anthropic', 'openai', 'groq', 'google-gemini']);
+  for (const k of order) { const r = resolveProvider(k, env); if (r) return { dialect: r.dialect, apiKey: r.apiKey, baseUrl: r.baseUrl, model: r.model, key: r.key, local: r.local }; }
+  return null;
+}
+export function searchConfigFromEnv(env = {}) {
+  const order = (env.AOP_SEARCH_PROVIDER ? [env.AOP_SEARCH_PROVIDER] : []).concat(['talordata', 'serper', 'tavily', 'google-cse', 'brave']);
+  for (const k of order) { const r = resolveProvider(k, env); if (r) return r; }
+  return null;
+}
+export function providersConfigForm({ env = {}, action = '/settings/providers', kinds = ['llm', 'search'] } = {}) {
+  const st = providersStatus(env).filter((p) => kinds.includes(p.kind));
+  const group = (kind, title) => { const items = st.filter((p) => p.kind === kind); if (!items.length) return '';
+    return `<h2>${title}</h2>${items.map((p) => `<fieldset style="border:1px solid #e5e7eb;border-radius:8px;padding:8px 12px;margin:8px 0">
+      <legend>${esc(p.label)} ${p.configured ? '✅' : '⚪'} <a href="${esc(p.dashboard)}" target=_blank rel=noopener style="font-size:12px">dashboard ↗</a></legend>
+      ${p.env.map((e) => `<label style="display:block;margin:4px 0">${esc(e.name)} ${e.set ? `<span style="color:#16a34a;font-size:12px">(défini ${esc(e.masked)})</span>` : ''}
+        <input name="${esc(e.name)}" type="password" placeholder="${e.set ? '•••• (laisser vide pour garder)' : 'coller la clé…'}" style="width:100%"></label>`).join('')}
+      <p style="font-size:12px;color:#6b7280">endpoint : <code>${esc(p.baseUrl)}</code></p></fieldset>`).join('')}`; };
+  return `<form method="post" action="${esc(action)}">
+    <h1 id="keys">🔌 Fournisseurs IA &amp; recherche</h1>
+    <p class=muted>Clés stockées côté serveur (jamais exposées au client). Pilotées par <code>.env</code> ; <code>AOP_LLM_PROVIDER</code>/<code>AOP_SEARCH_PROVIDER</code> forcent le défaut.</p>
+    ${group('llm', '🤖 IA / LLM (scoring, go/no-go)')}${group('search', '🔎 Recherche / sourcing (veille)')}
+    <button>💾 Enregistrer</button></form>`;
+}
+export function parseProvidersForm(form = {}) {
+  const out = {}; for (const p of listProviderDialects()) for (const k of p.env) if (form[k] && String(form[k]).trim()) out[k] = String(form[k]).trim();
+  return out;
+}
+
+// ── Sélection multi-fournisseurs de recherche, triée par COÛT (moindre/nul d'abord) ──
+/** [{ key, label, costPerK, free, configured, selected }] triés par coût croissant. */
+export function searchSelection(env = {}) {
+  const sel = new Set(String(env.AOP_SEARCH_PROVIDERS || '').split(',').map((s) => s.trim()).filter(Boolean));
+  return listProviderDialects('search').map((d) => ({
+    key: d.key, label: d.label, costPerK: d.meta?.costPerK ?? null, free: (d.meta?.costPerK ?? 99) === 0,
+    configured: d.env.every((k) => !!env[k]), selected: sel.has(d.key),
+  })).sort((a, b) => (a.costPerK ?? 1e9) - (b.costPerK ?? 1e9));
+}
+/** Formulaire à CASES À COCHER (un ou plusieurs), coût affiché, gratuit mis en avant. */
+export function searchSelectionForm({ env = {}, action = '/settings/providers', keysHref = '#keys' } = {}) {
+  const sel = searchSelection(env);
+  const ready = sel.filter((s) => s.configured).length;
+  const rows = sel.map((s) => `<label style="display:flex;gap:8px;align-items:center;padding:5px 0;${s.configured ? '' : 'opacity:.55'}">
+    <input type="checkbox" name="search_use" value="${esc(s.key)}"${s.selected ? ' checked' : ''}${s.configured ? '' : ' disabled'}>
+    <strong>${esc(s.label)}</strong>
+    <span style="font-size:12px;color:${s.free ? '#16a34a' : '#6b7280'}">${s.costPerK != null ? `${s.costPerK} $/1k req` : '—'}${s.free ? ' · GRATUIT' : ''}</span>
+    ${s.configured ? '<span style="font-size:12px;color:#16a34a">✓ clé OK</span>' : `<a href="${esc(keysHref)}" style="font-size:12px;color:#b45309">🔑 clé manquante — l'ajouter</a>`}</label>`).join('');
+  return `<form method="post" action="${esc(action)}"><h2>🔎 Fournisseurs de recherche actifs — ${ready}/${sel.length} prêts</h2>
+    <p class=muted>Les <strong>${sel.length}</strong> fournisseurs sont listés (triés par coût croissant). Ceux <strong>grisés</strong> n'ont pas de clé API — renseignez-la dans <em>Fournisseurs IA &amp; recherche</em> ci-dessus pour les activer. Cochez ceux à utiliser ; la découverte prend le <strong>moins cher coché</strong>.</p>
+    ${rows}<input type="hidden" name="_search_selection" value="1"><p><button>💾 Enregistrer la sélection</button></p></form>`;
+}
+/** Construit { AOP_SEARCH_PROVIDERS } depuis les clés cochées. */
+export function parseSearchSelection(checkedKeys = []) {
+  return { AOP_SEARCH_PROVIDERS: (Array.isArray(checkedKeys) ? checkedKeys : [checkedKeys]).filter(Boolean).join(',') };
+}
+/** Fournisseurs de recherche sélectionnés ET configurés, triés par coût (moindre d'abord). */
+export function selectedSearchProviders(env = {}) {
+  const keys = String(env.AOP_SEARCH_PROVIDERS || '').split(',').map((s) => s.trim()).filter(Boolean);
+  return keys.map((k) => resolveProvider(k, env)).filter(Boolean)
+    .sort((a, b) => ((getProviderDialect(a.key)?.meta?.costPerK) ?? 1e9) - ((getProviderDialect(b.key)?.meta?.costPerK) ?? 1e9));
+}
+
+// ── Sélection GÉNÉRIQUE par cases à cocher (LLM ou recherche) ──
+const SEL_VAR = { search: 'AOP_SEARCH_PROVIDERS', llm: 'AOP_LLM_PROVIDERS' };
+/** [{ key, label, costPerK, free, hosting, quality, configured, selected }] d'un genre, trié par coût. */
+export function providerSelection(kind, env = {}) {
+  const sel = new Set(String(env[SEL_VAR[kind]] || '').split(',').map((s) => s.trim()).filter(Boolean));
+  return listProviderDialects(kind).map((d) => ({
+    key: d.key, label: d.label, costPerK: d.meta?.costPerK ?? null, free: (d.meta?.costPerK ?? 99) === 0,
+    hosting: d.meta?.hosting || (d.local ? 'local' : ''), quality: d.meta?.quality || '',
+    configured: d.env.every((k) => !!env[k]), selected: sel.has(d.key),
+  })).sort((a, b) => (a.costPerK ?? 1e9) - (b.costPerK ?? 1e9));
+}
+/** Formulaire CASES À COCHER pour un genre (kind='llm'|'search'). Coché = activé ; 1er coché configuré = actif. */
+export function providerSelectionForm({ kind = 'search', env = {}, action = '/settings/providers', keysHref = '#keys' } = {}) {
+  const sel = providerSelection(kind, env); const ready = sel.filter((s) => s.configured).length;
+  const title = kind === 'llm' ? '🤖 Modèles IA actifs (cocher pour utiliser)' : '🔎 Fournisseurs de recherche actifs';
+  const note = kind === 'llm'
+    ? "Cochez le(s) modèle(s) à utiliser pour le scoring ; le <strong>1er coché configuré</strong> est actif (les suivants servent de repli). Décochez tout = ordre par défaut. Ex. : ne cochez que DeepSeek pour n'utiliser que lui."
+    : "Cochez un ou plusieurs fournisseurs ; la découverte prend le <strong>moins cher coché</strong>.";
+  const metaOf = (s) => kind === 'search'
+    ? `${s.costPerK != null ? `${s.costPerK} $/1k req` : '—'}${s.free ? ' · GRATUIT' : ''}`
+    : `${esc(s.hosting)}${s.quality ? ` · ${esc(s.quality)}` : ''}${s.costPerK != null ? ` · ~${s.costPerK} $/Mtok` : ''}`;
+  const rows = sel.map((s) => `<label style="display:flex;gap:8px;align-items:center;padding:5px 0;${s.configured ? '' : 'opacity:.55'}">
+    <input type="checkbox" name="${kind}_use" value="${esc(s.key)}"${s.selected ? ' checked' : ''}${s.configured ? '' : ' disabled'}>
+    <strong>${esc(s.label)}</strong>
+    <span style="font-size:12px;color:${s.free ? '#16a34a' : '#6b7280'}">${metaOf(s)}</span>
+    ${s.configured ? '<span style="font-size:12px;color:#16a34a">✓ clé OK</span>' : `<a href="${esc(keysHref)}" style="font-size:12px;color:#b45309">🔑 clé manquante — l'ajouter</a>`}</label>`).join('');
+  return `<form method="post" action="${esc(action)}"><h2>${title} — ${ready}/${sel.length} prêts</h2>
+    <p class=muted>${note}</p>${rows}<input type="hidden" name="_selection" value="${esc(kind)}"><p><button>💾 Enregistrer la sélection</button></p></form>`;
+}
+/** { AOP_<KIND>_PROVIDERS: csv } depuis les clés cochées. */
+export function parseProviderSelection(kind, checkedKeys = []) {
+  return { [SEL_VAR[kind]]: (Array.isArray(checkedKeys) ? checkedKeys : [checkedKeys]).filter(Boolean).join(',') };
+}
+/** Fournisseurs d'un genre sélectionnés ET configurés, triés par coût (moindre d'abord). */
+export function selectedProviders(kind, env = {}) {
+  const keys = String(env[SEL_VAR[kind]] || '').split(',').map((s) => s.trim()).filter(Boolean);
+  return keys.map((k) => resolveProvider(k, env)).filter(Boolean)
+    .sort((a, b) => ((getProviderDialect(a.key)?.meta?.costPerK) ?? 1e9) - ((getProviderDialect(b.key)?.meta?.costPerK) ?? 1e9));
+}
+
+export default { PROVIDERS, providerByKey, resolveProvider, providersStatus, firstConfigured, llmConfigFromEnv, searchConfigFromEnv, providersConfigForm, parseProvidersForm, searchSelection, searchSelectionForm, parseSearchSelection, selectedSearchProviders, providerSelection, providerSelectionForm, parseProviderSelection, selectedProviders, registerProviderDialect, getProviderDialect, listProviderDialects };

package/src/registry.js

@@ -0,0 +1,12 @@
+// @mostajs/aop-providers — registre de DIALECTES fournisseur (patron @mostajs/llm : un dialecte par
+// fournisseur, enregistré par effet de bord, extensible). @author Dr Hamid MADANI <drmdh@msn.com>
+const REGISTRY = new Map();
+/** Enregistre un dialecte fournisseur. d = { key, kind:'llm'|'search', label, env[], baseUrl, baseUrlEnv?, endpoint?, auth?, dashboard, dialect?, model?, local?, engine? } */
+export function registerProviderDialect(d) {
+  if (!d?.key || !d?.kind) throw new Error('provider dialect: { key, kind } requis');
+  REGISTRY.set(d.key, { env: [], ...d });
+  return d;
+}
+export function getProviderDialect(key) { return REGISTRY.get(key) || null; }
+export function listProviderDialects(kind = null) { const all = [...REGISTRY.values()]; return kind ? all.filter((d) => d.kind === kind) : all; }
+export function clearProviderDialects() { REGISTRY.clear(); }