@saulwade/swl-ses 2.6.1 → 2.8.0

package/scripts/lib/eval-self-correct.js

@@ -1,106 +1,106 @@
-'use strict';
-
-/**
- * eval-self-correct.js — Loop de auto-corrección para outputs invalidos.
- *
- * Patrón adoptado de `temp/agentmemory-main/src/eval/self-correct.ts`.
- * Adaptado a swl-ses: en lugar de un MemoryProvider que llama a un LLM, este
- * módulo expone un loop genérico que:
- *
- *   1. Ejecuta una función productora.
- *   2. Valida el output con un validador.
- *   3. Si falla, re-ejecuta con el prompt ampliado con un sufijo más estricto.
- *   4. Repite hasta `maxRetries` o éxito.
- *
- * El productor es agnóstico: puede ser una llamada a Claude (Skill o Bash),
- * o cualquier función async que produzca un output basado en un prompt.
- *
- * No intenta automatizar llamadas LLM — el caller pasa la función concreta.
- * Esto mantiene swl-ses zero-deps.
- *
- * @module scripts/lib/eval-self-correct
- */
-
-const SUFIJO_ESTRICTO = `
-
-IMPORTANTE: Tu respuesta anterior fue inválida. Por favor asegúrate de que tu
-output siga ESTRICTAMENTE el formato requerido. Cada campo obligatorio debe
-estar presente con valores válidos.
-
-Errores detectados en el intento anterior:
-{{ERRORS}}
-`;
-
-/**
- * Ejecuta un loop de auto-corrección sobre una función productora.
- *
- * @param {object} opts
- * @param {function(string, string): Promise<string>} opts.productor - Recibe (sysPrompt, userPrompt) y devuelve output.
- * @param {function(string): {valid: boolean, errors?: string[]}} opts.validador
- * @param {string} opts.sysPrompt
- * @param {string} opts.userPrompt
- * @param {number} [opts.maxRetries=1] - Número máximo de reintentos tras fallo inicial.
- * @returns {Promise<{ output: string, valid: boolean, retried: boolean, intentos: number, errors?: string[] }>}
- */
-async function compresseConReintento(opts) {
-  const { productor, validador, sysPrompt, userPrompt, maxRetries = 1 } = opts;
-
-  if (typeof productor !== 'function') {
-    throw new Error('productor debe ser una función async (sysPrompt, userPrompt) => Promise<string>');
-  }
-  if (typeof validador !== 'function') {
-    throw new Error('validador debe ser una función (output) => {valid, errors?}');
-  }
-
-  // Intento 1
-  const primerOutput = await productor(sysPrompt, userPrompt);
-  const primerResultado = validador(primerOutput);
-  if (primerResultado.valid) {
-    return {
-      output: primerOutput,
-      valid: true,
-      retried: false,
-      intentos: 1,
-    };
-  }
-
-  let ultimoOutput = primerOutput;
-  let ultimosErrores = primerResultado.errors || [];
-
-  for (let i = 0; i < maxRetries; i++) {
-    const erroresFmt = ultimosErrores.length > 0
-      ? ultimosErrores.map(e => `  - ${e}`).join('\n')
-      : '  (sin detalle)';
-    const sysAmpliado = sysPrompt + SUFIJO_ESTRICTO.replace('{{ERRORS}}', erroresFmt);
-
-    const reintentoOutput = await productor(sysAmpliado, userPrompt);
-    const reintentoResultado = validador(reintentoOutput);
-
-    if (reintentoResultado.valid) {
-      return {
-        output: reintentoOutput,
-        valid: true,
-        retried: true,
-        intentos: i + 2,
-      };
-    }
-
-    ultimoOutput = reintentoOutput;
-    ultimosErrores = reintentoResultado.errors || [];
-  }
-
-  return {
-    output: ultimoOutput,
-    valid: false,
-    retried: maxRetries > 0,
-    intentos: maxRetries + 1,
-    errors: ultimosErrores,
-  };
-}
-
-// ── exports ───────────────────────────────────────────────────────────────────
-
-module.exports = {
-  compresseConReintento,
-  SUFIJO_ESTRICTO,
-};
+'use strict';
+
+/**
+ * eval-self-correct.js — Loop de auto-corrección para outputs invalidos.
+ *
+ * Patrón adoptado de `temp/agentmemory-main/src/eval/self-correct.ts`.
+ * Adaptado a swl-ses: en lugar de un MemoryProvider que llama a un LLM, este
+ * módulo expone un loop genérico que:
+ *
+ *   1. Ejecuta una función productora.
+ *   2. Valida el output con un validador.
+ *   3. Si falla, re-ejecuta con el prompt ampliado con un sufijo más estricto.
+ *   4. Repite hasta `maxRetries` o éxito.
+ *
+ * El productor es agnóstico: puede ser una llamada a Claude (Skill o Bash),
+ * o cualquier función async que produzca un output basado en un prompt.
+ *
+ * No intenta automatizar llamadas LLM — el caller pasa la función concreta.
+ * Esto mantiene swl-ses zero-deps.
+ *
+ * @module scripts/lib/eval-self-correct
+ */
+
+const SUFIJO_ESTRICTO = `
+
+IMPORTANTE: Tu respuesta anterior fue inválida. Por favor asegúrate de que tu
+output siga ESTRICTAMENTE el formato requerido. Cada campo obligatorio debe
+estar presente con valores válidos.
+
+Errores detectados en el intento anterior:
+{{ERRORS}}
+`;
+
+/**
+ * Ejecuta un loop de auto-corrección sobre una función productora.
+ *
+ * @param {object} opts
+ * @param {function(string, string): Promise<string>} opts.productor - Recibe (sysPrompt, userPrompt) y devuelve output.
+ * @param {function(string): {valid: boolean, errors?: string[]}} opts.validador
+ * @param {string} opts.sysPrompt
+ * @param {string} opts.userPrompt
+ * @param {number} [opts.maxRetries=1] - Número máximo de reintentos tras fallo inicial.
+ * @returns {Promise<{ output: string, valid: boolean, retried: boolean, intentos: number, errors?: string[] }>}
+ */
+async function compresseConReintento(opts) {
+  const { productor, validador, sysPrompt, userPrompt, maxRetries = 1 } = opts;
+
+  if (typeof productor !== 'function') {
+    throw new Error('productor debe ser una función async (sysPrompt, userPrompt) => Promise<string>');
+  }
+  if (typeof validador !== 'function') {
+    throw new Error('validador debe ser una función (output) => {valid, errors?}');
+  }
+
+  // Intento 1
+  const primerOutput = await productor(sysPrompt, userPrompt);
+  const primerResultado = validador(primerOutput);
+  if (primerResultado.valid) {
+    return {
+      output: primerOutput,
+      valid: true,
+      retried: false,
+      intentos: 1,
+    };
+  }
+
+  let ultimoOutput = primerOutput;
+  let ultimosErrores = primerResultado.errors || [];
+
+  for (let i = 0; i < maxRetries; i++) {
+    const erroresFmt = ultimosErrores.length > 0
+      ? ultimosErrores.map(e => `  - ${e}`).join('\n')
+      : '  (sin detalle)';
+    const sysAmpliado = sysPrompt + SUFIJO_ESTRICTO.replace('{{ERRORS}}', erroresFmt);
+
+    const reintentoOutput = await productor(sysAmpliado, userPrompt);
+    const reintentoResultado = validador(reintentoOutput);
+
+    if (reintentoResultado.valid) {
+      return {
+        output: reintentoOutput,
+        valid: true,
+        retried: true,
+        intentos: i + 2,
+      };
+    }
+
+    ultimoOutput = reintentoOutput;
+    ultimosErrores = reintentoResultado.errors || [];
+  }
+
+  return {
+    output: ultimoOutput,
+    valid: false,
+    retried: maxRetries > 0,
+    intentos: maxRetries + 1,
+    errors: ultimosErrores,
+  };
+}
+
+// ── exports ───────────────────────────────────────────────────────────────────
+
+module.exports = {
+  compresseConReintento,
+  SUFIJO_ESTRICTO,
+};

package/scripts/lib/eval-validator.js

@@ -1,185 +1,185 @@
-'use strict';
-
-/**
- * eval-validator.js — Validador JSON Schema-lite para outputs SWL.
- *
- * Patrón adoptado de `temp/agentmemory-main/src/eval/validator.ts`. Adaptado a
- * swl-ses: sin Zod (mantiene principio zero-deps). Implementación propia que
- * cubre el subset de JSON Schema usado por `eval-schemas.js`:
- *   - type: object | array | string | number | integer | boolean
- *   - required, properties (object)
- *   - items, minItems (array)
- *   - minLength, maxLength (string)
- *   - minimum, maximum (number)
- *   - enum
- *
- * Funciones puras zero-deps. Backward compatible: schemas pueden agregar
- * keywords nuevos en el futuro sin romper validaciones existentes.
- *
- * @module scripts/lib/eval-validator
- */
-
-// ── helpers ───────────────────────────────────────────────────────────────────
-
-function obtenerTipo(value) {
-  if (value === null) return 'null';
-  if (Array.isArray(value)) return 'array';
-  return typeof value;
-}
-
-function esEntero(value) {
-  return typeof value === 'number' && Number.isInteger(value);
-}
-
-// ── validadores por tipo ──────────────────────────────────────────────────────
-
-function validarString(value, schema, errors, ruta) {
-  if (typeof value !== 'string') {
-    errors.push(`${ruta}: esperado string, recibido ${obtenerTipo(value)}`);
-    return;
-  }
-  if (typeof schema.minLength === 'number' && value.length < schema.minLength) {
-    errors.push(`${ruta}: longitud ${value.length} < minLength ${schema.minLength}`);
-  }
-  if (typeof schema.maxLength === 'number' && value.length > schema.maxLength) {
-    errors.push(`${ruta}: longitud ${value.length} > maxLength ${schema.maxLength}`);
-  }
-  if (Array.isArray(schema.enum) && !schema.enum.includes(value)) {
-    errors.push(`${ruta}: valor "${value}" no en enum [${schema.enum.join(', ')}]`);
-  }
-}
-
-function validarNumber(value, schema, errors, ruta) {
-  if (schema.type === 'integer') {
-    if (!esEntero(value)) {
-      errors.push(`${ruta}: esperado integer, recibido ${obtenerTipo(value)}`);
-      return;
-    }
-  } else if (typeof value !== 'number') {
-    errors.push(`${ruta}: esperado number, recibido ${obtenerTipo(value)}`);
-    return;
-  }
-  if (typeof schema.minimum === 'number' && value < schema.minimum) {
-    errors.push(`${ruta}: valor ${value} < minimum ${schema.minimum}`);
-  }
-  if (typeof schema.maximum === 'number' && value > schema.maximum) {
-    errors.push(`${ruta}: valor ${value} > maximum ${schema.maximum}`);
-  }
-  if (Array.isArray(schema.enum) && !schema.enum.includes(value)) {
-    errors.push(`${ruta}: valor ${value} no en enum`);
-  }
-}
-
-function validarBoolean(value, schema, errors, ruta) {
-  if (typeof value !== 'boolean') {
-    errors.push(`${ruta}: esperado boolean, recibido ${obtenerTipo(value)}`);
-  }
-}
-
-function validarArray(value, schema, errors, ruta) {
-  if (!Array.isArray(value)) {
-    errors.push(`${ruta}: esperado array, recibido ${obtenerTipo(value)}`);
-    return;
-  }
-  if (typeof schema.minItems === 'number' && value.length < schema.minItems) {
-    errors.push(`${ruta}: ${value.length} items < minItems ${schema.minItems}`);
-  }
-  if (typeof schema.maxItems === 'number' && value.length > schema.maxItems) {
-    errors.push(`${ruta}: ${value.length} items > maxItems ${schema.maxItems}`);
-  }
-  if (schema.items) {
-    for (let i = 0; i < value.length; i++) {
-      validarValor(value[i], schema.items, errors, `${ruta}[${i}]`);
-    }
-  }
-}
-
-function validarObject(value, schema, errors, ruta) {
-  if (value === null || typeof value !== 'object' || Array.isArray(value)) {
-    errors.push(`${ruta}: esperado object, recibido ${obtenerTipo(value)}`);
-    return;
-  }
-  if (Array.isArray(schema.required)) {
-    for (const key of schema.required) {
-      if (!(key in value)) {
-        errors.push(`${ruta}: campo requerido faltante: "${key}"`);
-      }
-    }
-  }
-  if (schema.properties && typeof schema.properties === 'object') {
-    for (const [key, subSchema] of Object.entries(schema.properties)) {
-      if (key in value) {
-        validarValor(value[key], subSchema, errors, `${ruta}.${key}`);
-      }
-    }
-  }
-}
-
-function validarValor(value, schema, errors, ruta) {
-  if (!schema || typeof schema !== 'object') return;
-
-  switch (schema.type) {
-    case 'string':  validarString(value, schema, errors, ruta); break;
-    case 'number':
-    case 'integer': validarNumber(value, schema, errors, ruta); break;
-    case 'boolean': validarBoolean(value, schema, errors, ruta); break;
-    case 'array':   validarArray(value, schema, errors, ruta); break;
-    case 'object':  validarObject(value, schema, errors, ruta); break;
-    default:
-      // Sin type explícito: validar enum si aplica, sino aceptar
-      if (Array.isArray(schema.enum) && !schema.enum.includes(value)) {
-        errors.push(`${ruta}: valor no en enum`);
-      }
-  }
-}
-
-// ── API pública ───────────────────────────────────────────────────────────────
-
-/**
- * Valida un valor contra un schema JSON-lite.
- * @param {*} value
- * @param {object} schema
- * @returns {{ valid: boolean, errors: string[] }}
- */
-function validar(value, schema) {
-  const errors = [];
-  validarValor(value, schema, errors, '$');
-  return { valid: errors.length === 0, errors };
-}
-
-/**
- * Valida input contra schema, devolviendo formato compatible con eval results.
- * @param {object} schema
- * @param {*} data
- * @param {string} functionId
- * @returns {object} { valid, data?, result? }
- */
-function validarInput(schema, data, functionId) {
-  const result = validar(data, schema);
-  if (result.valid) {
-    return { valid: true, data };
-  }
-  return {
-    valid: false,
-    result: {
-      valid: false,
-      errors: result.errors,
-      qualityScore: 0,
-      latencyMs: 0,
-      functionId: functionId || 'unknown',
-    },
-  };
-}
-
-/**
- * Conveniencia: valida output (alias de validarInput).
- */
-const validarOutput = validarInput;
-
-// ── exports ───────────────────────────────────────────────────────────────────
-
-module.exports = {
-  validar,
-  validarInput,
-  validarOutput,
-};
+'use strict';
+
+/**
+ * eval-validator.js — Validador JSON Schema-lite para outputs SWL.
+ *
+ * Patrón adoptado de `temp/agentmemory-main/src/eval/validator.ts`. Adaptado a
+ * swl-ses: sin Zod (mantiene principio zero-deps). Implementación propia que
+ * cubre el subset de JSON Schema usado por `eval-schemas.js`:
+ *   - type: object | array | string | number | integer | boolean
+ *   - required, properties (object)
+ *   - items, minItems (array)
+ *   - minLength, maxLength (string)
+ *   - minimum, maximum (number)
+ *   - enum
+ *
+ * Funciones puras zero-deps. Backward compatible: schemas pueden agregar
+ * keywords nuevos en el futuro sin romper validaciones existentes.
+ *
+ * @module scripts/lib/eval-validator
+ */
+
+// ── helpers ───────────────────────────────────────────────────────────────────
+
+function obtenerTipo(value) {
+  if (value === null) return 'null';
+  if (Array.isArray(value)) return 'array';
+  return typeof value;
+}
+
+function esEntero(value) {
+  return typeof value === 'number' && Number.isInteger(value);
+}
+
+// ── validadores por tipo ──────────────────────────────────────────────────────
+
+function validarString(value, schema, errors, ruta) {
+  if (typeof value !== 'string') {
+    errors.push(`${ruta}: esperado string, recibido ${obtenerTipo(value)}`);
+    return;
+  }
+  if (typeof schema.minLength === 'number' && value.length < schema.minLength) {
+    errors.push(`${ruta}: longitud ${value.length} < minLength ${schema.minLength}`);
+  }
+  if (typeof schema.maxLength === 'number' && value.length > schema.maxLength) {
+    errors.push(`${ruta}: longitud ${value.length} > maxLength ${schema.maxLength}`);
+  }
+  if (Array.isArray(schema.enum) && !schema.enum.includes(value)) {
+    errors.push(`${ruta}: valor "${value}" no en enum [${schema.enum.join(', ')}]`);
+  }
+}
+
+function validarNumber(value, schema, errors, ruta) {
+  if (schema.type === 'integer') {
+    if (!esEntero(value)) {
+      errors.push(`${ruta}: esperado integer, recibido ${obtenerTipo(value)}`);
+      return;
+    }
+  } else if (typeof value !== 'number') {
+    errors.push(`${ruta}: esperado number, recibido ${obtenerTipo(value)}`);
+    return;
+  }
+  if (typeof schema.minimum === 'number' && value < schema.minimum) {
+    errors.push(`${ruta}: valor ${value} < minimum ${schema.minimum}`);
+  }
+  if (typeof schema.maximum === 'number' && value > schema.maximum) {
+    errors.push(`${ruta}: valor ${value} > maximum ${schema.maximum}`);
+  }
+  if (Array.isArray(schema.enum) && !schema.enum.includes(value)) {
+    errors.push(`${ruta}: valor ${value} no en enum`);
+  }
+}
+
+function validarBoolean(value, schema, errors, ruta) {
+  if (typeof value !== 'boolean') {
+    errors.push(`${ruta}: esperado boolean, recibido ${obtenerTipo(value)}`);
+  }
+}
+
+function validarArray(value, schema, errors, ruta) {
+  if (!Array.isArray(value)) {
+    errors.push(`${ruta}: esperado array, recibido ${obtenerTipo(value)}`);
+    return;
+  }
+  if (typeof schema.minItems === 'number' && value.length < schema.minItems) {
+    errors.push(`${ruta}: ${value.length} items < minItems ${schema.minItems}`);
+  }
+  if (typeof schema.maxItems === 'number' && value.length > schema.maxItems) {
+    errors.push(`${ruta}: ${value.length} items > maxItems ${schema.maxItems}`);
+  }
+  if (schema.items) {
+    for (let i = 0; i < value.length; i++) {
+      validarValor(value[i], schema.items, errors, `${ruta}[${i}]`);
+    }
+  }
+}
+
+function validarObject(value, schema, errors, ruta) {
+  if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+    errors.push(`${ruta}: esperado object, recibido ${obtenerTipo(value)}`);
+    return;
+  }
+  if (Array.isArray(schema.required)) {
+    for (const key of schema.required) {
+      if (!(key in value)) {
+        errors.push(`${ruta}: campo requerido faltante: "${key}"`);
+      }
+    }
+  }
+  if (schema.properties && typeof schema.properties === 'object') {
+    for (const [key, subSchema] of Object.entries(schema.properties)) {
+      if (key in value) {
+        validarValor(value[key], subSchema, errors, `${ruta}.${key}`);
+      }
+    }
+  }
+}
+
+function validarValor(value, schema, errors, ruta) {
+  if (!schema || typeof schema !== 'object') return;
+
+  switch (schema.type) {
+    case 'string':  validarString(value, schema, errors, ruta); break;
+    case 'number':
+    case 'integer': validarNumber(value, schema, errors, ruta); break;
+    case 'boolean': validarBoolean(value, schema, errors, ruta); break;
+    case 'array':   validarArray(value, schema, errors, ruta); break;
+    case 'object':  validarObject(value, schema, errors, ruta); break;
+    default:
+      // Sin type explícito: validar enum si aplica, sino aceptar
+      if (Array.isArray(schema.enum) && !schema.enum.includes(value)) {
+        errors.push(`${ruta}: valor no en enum`);
+      }
+  }
+}
+
+// ── API pública ───────────────────────────────────────────────────────────────
+
+/**
+ * Valida un valor contra un schema JSON-lite.
+ * @param {*} value
+ * @param {object} schema
+ * @returns {{ valid: boolean, errors: string[] }}
+ */
+function validar(value, schema) {
+  const errors = [];
+  validarValor(value, schema, errors, '$');
+  return { valid: errors.length === 0, errors };
+}
+
+/**
+ * Valida input contra schema, devolviendo formato compatible con eval results.
+ * @param {object} schema
+ * @param {*} data
+ * @param {string} functionId
+ * @returns {object} { valid, data?, result? }
+ */
+function validarInput(schema, data, functionId) {
+  const result = validar(data, schema);
+  if (result.valid) {
+    return { valid: true, data };
+  }
+  return {
+    valid: false,
+    result: {
+      valid: false,
+      errors: result.errors,
+      qualityScore: 0,
+      latencyMs: 0,
+      functionId: functionId || 'unknown',
+    },
+  };
+}
+
+/**
+ * Conveniencia: valida output (alias de validarInput).
+ */
+const validarOutput = validarInput;
+
+// ── exports ───────────────────────────────────────────────────────────────────
+
+module.exports = {
+  validar,
+  validarInput,
+  validarOutput,
+};