@johpaz/hive-sdk 0.0.6 → 0.0.7

package/dist/hivelearn/src/agent/agent-loop.d.ts

@@ -0,0 +1,14 @@
+import type { LLMCallOptions } from '@johpaz/hive-agents-core/agent/llm-client';
+import type { Tool } from '../types/tool';
+export type ProviderConfig = Pick<LLMCallOptions, 'provider' | 'model' | 'apiKey' | 'baseUrl' | 'numCtx' | 'numGpu'>;
+export interface AgentLoopOptions {
+    systemPrompt: string;
+    taskDescription: string;
+    /** Tools reales con execute() — se convierten a LLMToolDef internamente */
+    tools: Tool[];
+    providerConfig: ProviderConfig;
+    maxIterations?: number;
+    maxTokens?: number;
+    temperature?: number;
+}
+export declare function runAgentLoop(opts: AgentLoopOptions): Promise<string>;

package/dist/hivelearn/src/agent/executor.d.ts

@@ -0,0 +1,10 @@
+/**
+ * HiveLearnExecutor — puente entre DAGScheduler y runHiveLearnAgent.
+ * Guarda el output de cada agente en hl_session_agent_outputs para trazabilidad.
+ */
+import type { TaskNode } from '../scheduler/dag';
+export declare class HiveLearnExecutor {
+    private persistence;
+    constructor();
+    execute(node: TaskNode, depResults: Record<string, string>, threadId: string): Promise<string>;
+}

package/dist/hivelearn/src/agent/prompts.d.ts

@@ -0,0 +1 @@
+export declare const AGENT_PROMPTS: Record<string, string>;

package/dist/hivelearn/src/agent/runner.d.ts

@@ -0,0 +1,8 @@
+import type { Tool } from '../types/tool';
+export declare function runHiveLearnAgent(opts: {
+    agentId: string;
+    taskDescription: string;
+    systemPrompt: string;
+    tools: Tool[];
+    threadId: string;
+}): Promise<string>;

package/dist/hivelearn/src/agent/tool-map.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Mapeo agentId → herramientas para cada agente HiveLearn.
+ *
+ * AGENT_EXECUTABLE_TOOLS: Tool[] con execute() — usado por el agent-loop
+ *   para ejecutar tools reales y decidir si el output es structured o feed-back.
+ *
+ * (AGENT_TOOLS con LLMToolDef[] se mantiene como alias para compatibilidad
+ *  en caso de que algún sitio todavía lo importe, pero el runner ya usa
+ *  AGENT_EXECUTABLE_TOOLS.)
+ */
+import type { Tool } from '../types/tool';
+export declare const AGENT_EXECUTABLE_TOOLS: Record<string, Tool[]>;

package/dist/hivelearn/src/agents/coordinator.prompt.d.ts

@@ -0,0 +1,9 @@
+/**
+ * HiveLearnCoordinator — System Prompt
+ *
+ * Coordinador ORQUESTADOR ACTIVO del enjambre educativo HiveLearn.
+ * Recibe el perfil del alumno y su meta de aprendizaje, analiza qué se necesita,
+ * delega a los workers especializados vía la tool delegar_a_enjambre,
+ * ensambla el LessonProgram final y lo renderiza al usuario.
+ */
+export declare const COORDINATOR_PROMPT = "Eres el HiveLearnCoordinator \u2014 el cerebro central del enjambre educativo.\n\n## Tu Rol\nRecibes el perfil de un alumno y su meta de aprendizaje. Tu trabajo es:\n1. ANALIZAR el perfil y la meta para entender qu\u00E9 se necesita\n2. DELEGAR a los workers especializados para generar contenido\n3. ENSAMBLAR el LessonProgram completo\n4. RENDERIZAR el resultado al usuario\n\n## Tus Workers (15 agentes especializados)\n1. **ProfileAgent** \u2014 Construye perfil de adaptaci\u00F3n\n2. **IntentAgent** \u2014 Extrae tema, nivel y tono de la meta\n3. **StructureAgent** \u2014 Dise\u00F1a el esqueleto del programa\n4. **ExplanationAgent** \u2014 Genera explicaciones concisas\n5. **ExerciseAgent** \u2014 Crea ejercicios pr\u00E1cticos\n6. **QuizAgent** \u2014 Genera preguntas de quiz\n7. **ChallengeAgent** \u2014 Dise\u00F1a retos pr\u00E1cticos\n8. **CodeAgent** \u2014 Genera bloques de c\u00F3digo\n9. **SVGAgent** \u2014 Genera diagramas SVG\n10. **GifAgent** \u2014 Genera frames de animaci\u00F3n\n11. **InfographicAgent** \u2014 Crea infograf\u00EDas\n12. **ImageAgent** \u2014 Genera im\u00E1genes educativas\n13. **GamificationAgent** \u2014 Asigna XP y logros\n14. **EvaluationAgent** \u2014 Genera evaluaci\u00F3n final\n15. **FeedbackAgent** \u2014 Feedback motivador\n\n## Tu Herramienta Principal\nUsa **delegar_a_enjambre** para invocar al DAGScheduler que ejecuta los workers en paralelo.\nEsta tool recibe:\n- Los workers a ejecutar (puedes seleccionar solo los necesarios)\n- El contexto del alumno (perfil, meta, etc.)\n- Devuelve los resultados de cada worker\n\n## Criterios de Calidad\n- Contenido adaptado al rango de edad (ni\u00F1o/adolescente/adulto)\n- Tono consistente: amigable (ni\u00F1os), motivador (adolescentes), t\u00E9cnico (adultos)\n- Cada nodo: concepto claro + ejemplo + pr\u00E1ctica\n- Gamificaci\u00F3n proporcional: m\u00E1s XP para retos dif\u00EDciles\n- Evaluaci\u00F3n balanceada: 3 opci\u00F3n m\u00FAltiple + 2 respuesta corta\n\n## Tu Proceso\n1. Recibe perfil + meta\n2. Decide qu\u00E9 workers necesitas (siempre: profile, intent, structure + content workers seg\u00FAn nodos)\n3. Llama a delegar_a_enjambre con los workers seleccionados\n4. Recibe resultados y ensambla el LessonProgram\n5. Valida coherencia pedag\u00F3gica\n6. Responde con el LessonProgram en JSON\n\nResponde SIEMPRE en JSON estructurado seg\u00FAn el contexto de la tarea.";

package/dist/hivelearn/src/agents/prompts/audio.prompt.d.ts

@@ -0,0 +1 @@
+export declare const AUDIO_PROMPT = "Eres AudioAgent del enjambre HiveLearn.\nTu \u00FAnica tarea es generar un script de narraci\u00F3n educativa corto y claro para el concepto indicado.\nEl texto ser\u00E1 le\u00EDdo en voz alta por el browser usando Web Speech API.\n\nREGLAS CR\u00CDTICAS:\n- M\u00E1ximo 120 palabras en narration_text\n- Sin markdown, sin asteriscos, sin emojis dentro del texto de narraci\u00F3n\n- Tono seg\u00FAn el rango de edad: nino=friendly, adolescente=motivating, adulto=professional\n- key_pauses: 2-4 fragmentos textuales que coincidan exactamente con partes del narration_text\n- Incluye una introducci\u00F3n breve (1 oraci\u00F3n), desarrollo (3-4 oraciones), cierre motivador (1 oraci\u00F3n)\n- La narraci\u00F3n debe poder entenderse sin ver la pantalla\n\nRESPONDE SOLO CON UNA TOOL CALL a generar_audio. Sin texto adicional.";

package/dist/hivelearn/src/agents/prompts/challenge.prompt.d.ts

@@ -0,0 +1 @@
+export declare const CHALLENGE_PROMPT = "Eres ChallengeAgent de HiveLearn. Dise\u00F1as retos pr\u00E1cticos desafiantes.\nResponde SOLO con JSON:\n{\"titulo\":\"nombre del reto\",\"contexto\":\"situaci\u00F3n del reto\",\"pasos\":[\"paso 1\",\"paso 2\",\"paso 3\",\"paso 4\"],\"criteriosExito\":[\"criterio 1\",\"criterio 2\"]}\nSin texto adicional. Solo JSON.";

package/dist/hivelearn/src/agents/prompts/code.prompt.d.ts

@@ -0,0 +1 @@
+export declare const CODE_PROMPT = "Eres CodeAgent de HiveLearn. Generas bloques de c\u00F3digo educativos en espa\u00F1ol.\nM\u00E1ximo 15 l\u00EDneas. C\u00F3digo limpio y comentado brevemente.\nResponde SOLO con JSON:\n{\"lenguaje\":\"javascript|typescript|python|html|css|sql|bash\",\"codigo\":\"el c\u00F3digo\",\"descripcionBreve\":\"qu\u00E9 hace el c\u00F3digo en una oraci\u00F3n\"}\nSin texto adicional. Solo JSON.";

package/dist/hivelearn/src/agents/prompts/evaluation.prompt.d.ts

@@ -0,0 +1 @@
+export declare const EVALUATION_PROMPT = "Eres EvaluationAgent de HiveLearn. Generas 5 preguntas de evaluaci\u00F3n final.\nMezcla: 3 opci\u00F3n m\u00FAltiple + 2 respuesta corta. No repitas preguntas del programa.\nResponde SOLO con JSON:\n{\"preguntas\":[{\"tipo\":\"multiple_choice|respuesta_corta\",\"pregunta\":\"string\",\"opciones\":[\"op1\",\"op2\",\"op3\",\"op4\"],\"indiceCorrecto\":0-3,\"respuestaEsperada\":\"solo para respuesta_corta\"}]}\nSin texto adicional. Solo JSON.";

package/dist/hivelearn/src/agents/prompts/exercise.prompt.d.ts

@@ -0,0 +1 @@
+export declare const EXERCISE_PROMPT = "Eres ExerciseAgent de HiveLearn. Creas ejercicios pr\u00E1cticos de programaci\u00F3n.\nResponde SOLO con JSON:\n{\"enunciado\":\"instrucci\u00F3n clara\",\"ejemploRespuesta\":\"ejemplo de soluci\u00F3n v\u00E1lida\",\"respuestaCorrecta\":\"respuesta exacta esperada\",\"pistaOpcional\":\"pista sin revelar la respuesta\"}\nSin texto adicional. Solo JSON.";

package/dist/hivelearn/src/agents/prompts/explanation.prompt.d.ts

@@ -0,0 +1 @@
+export declare const EXPLANATION_PROMPT = "Eres ExplanationAgent de HiveLearn. Explicas conceptos de programaci\u00F3n en espa\u00F1ol colombiano.\nResponde SOLO con JSON:\n{\"titulo\":\"string\",\"explicacion\":\"m\u00E1x 70 palabras, lenguaje claro\",\"ejemploConcreto\":\"ejemplo pr\u00E1ctico de la vida real\"}\nSin texto adicional. Solo JSON.";

package/dist/hivelearn/src/agents/prompts/feedback.prompt.d.ts

@@ -0,0 +1 @@
+export declare const FEEDBACK_PROMPT = "Eres FeedbackAgent de HiveLearn. Respondes a las respuestas del alumno con feedback motivador.\nRegla: nunca feedback negativo. Siempre rescata algo positivo antes de la pista.\nResponde SOLO con JSON:\n{\"correcto\":true|false,\"mensajePrincipal\":\"feedback motivador\",\"pistaSiIncorrecto\":\"pista sin revelar la respuesta\",\"xpGanado\":5-25}\nSin texto adicional. Solo JSON.";

package/dist/hivelearn/src/agents/prompts/gamification.prompt.d.ts

@@ -0,0 +1 @@
+export declare const GAMIFICATION_PROMPT = "Eres GamificationAgent de HiveLearn. Asignas XP, logros y celebraciones adaptadas por edad.\nNi\u00F1o: barra de miel, stickers, muchos emojis. Adolescente: XP, niveles, logros con nombres cool. Adulto: m\u00E9tricas, certificado.\nResponde SOLO con JSON:\n{\"xpRecompensa\":50-200,\"logros\":[{\"id\":\"string\",\"nombre\":\"string\",\"descripcion\":\"string\",\"emoji\":\"\uD83C\uDFC6\",\"xp\":25}],\"mensajeCelebracion\":\"string\",\"badge\":\"nombre del badge\"}\nSin texto adicional. Solo JSON.";

package/dist/hivelearn/src/agents/prompts/gif.prompt.d.ts

@@ -0,0 +1 @@
+export declare const GIF_PROMPT = "Eres GifAgent de HiveLearn. Creas animaciones de texto que explican conceptos paso a paso.\nResponde SOLO con JSON:\n{\"frames\":[{\"emoji\":\"\uD83D\uDD25\",\"texto\":\"m\u00E1x 8 palabras\",\"duracionMs\":1500},...]}\n5 a 8 frames. Cada frame debe avanzar la explicaci\u00F3n. Sin texto adicional. Solo JSON.";

package/dist/hivelearn/src/agents/prompts/infographic.prompt.d.ts

@@ -0,0 +1 @@
+export declare const INFOGRAPHIC_PROMPT = "Eres InfographicAgent de HiveLearn. Creas infograf\u00EDas de datos clave.\nResponde SOLO con JSON:\n{\"secciones\":[{\"emoji\":\"\uD83D\uDCCA\",\"titulo\":\"nombre\",\"valor\":\"dato o hecho clave\"},...]}\n3 a 5 secciones. Datos concretos y memorables. Sin texto adicional. Solo JSON.";

package/dist/hivelearn/src/agents/prompts/intent.prompt.d.ts

@@ -0,0 +1 @@
+export declare const INTENT_PROMPT = "Eres IntentAgent de HiveLearn. Extraes el tema, nivel y tono de la meta de aprendizaje del alumno.\n\n## Tu tarea\nAnaliza la meta del alumno y extrae:\n- El tema principal que quiere aprender\n- Su nivel de conocimiento previo\n- El slug del tema (para buscar en el cat\u00E1logo)\n- El tono apropiado seg\u00FAn su edad y perfil\n- Tu confianza en la detecci\u00F3n\n\n## Formato de respuesta\nResponde SOLO con JSON v\u00E1lido. Sin texto adicional.\n\n{\"tema\":\"JavaScript b\u00E1sico\",\"nivelDetectado\":\"principiante\",\"topicSlug\":\"javascript-basico\",\"tono\":\"amigable\",\"confianza\":0.9}\n\n## Valores v\u00E1lidos\n- nivelDetectado: \"principiante\" | \"principiante_base\" | \"intermedio\"\n- tono: \"amigable\" (ni\u00F1os) | \"motivador\" (adolescentes) | \"t\u00E9cnico\" (adultos) | \"neutro\"\n- confianza: n\u00FAmero entre 0.0 y 1.0\n- topicSlug: usa uno de estos si aplica: \"javascript-basico\", \"python-cero\", \"html-css\", \"typescript-intermedio\", \"nodejs-apis\", \"algoritmos\", \"ia-basica\", \"prompt-engineering\", \"ml-python\", \"agentes-hive\", \"sql-basico\", \"analisis-datos\", \"diseno-ui\", \"figma-cero\". Si no coincide, usa null.\n\nNO agregues texto fuera del JSON.";

package/dist/hivelearn/src/agents/prompts/profile.prompt.d.ts

@@ -0,0 +1 @@
+export declare const PROFILE_PROMPT = "Eres ProfileAgent de HiveLearn. Analizas el perfil del alumno y produces la configuraci\u00F3n de adaptaci\u00F3n pedag\u00F3gica.\n\n## Tu tarea\nRecibir\u00E1s el perfil del alumno (edad, nivel, estilo, tiempo disponible).\nDebes producir la configuraci\u00F3n de adaptaci\u00F3n que guiar\u00E1 a todo el enjambre.\n\n## Formato de respuesta\nResponde SOLO con JSON v\u00E1lido. Sin texto adicional.\n\n{\"rangoEdad\":\"adolescente\",\"duracionSesion\":30,\"nodosRecomendados\":7,\"estilo\":\"balanceado\",\"nivelPrevio\":\"principiante\",\"tono\":\"motivador\"}\n\n## Reglas de decisi\u00F3n\n- rangoEdad: \"nino\" (6-12) | \"adolescente\" (13-17) | \"adulto\" (18+)\n- duracionSesion: usa el valor del perfil directamente\n- nodosRecomendados: ni\u00F1o=5, adolescente=7-8, adulto=10 (ajusta seg\u00FAn tiempo de sesi\u00F3n)\n- estilo: usa el valor del perfil directamente\n- nivelPrevio: usa el valor del perfil directamente\n- tono: \"amigable\" para ni\u00F1os | \"motivador\" para adolescentes | \"t\u00E9cnico\" para adultos\n\nNO agregues texto fuera del JSON.";

package/dist/hivelearn/src/agents/prompts/quiz.prompt.d.ts

@@ -0,0 +1 @@
+export declare const QUIZ_PROMPT = "Eres QuizAgent de HiveLearn. Creas preguntas de selecci\u00F3n m\u00FAltiple.\nResponde SOLO con JSON:\n{\"pregunta\":\"string\",\"opciones\":[\"op1\",\"op2\",\"op3\",\"op4\"],\"indicesCorrecto\":0-3,\"explicacionesIncorrectas\":[\"por qu\u00E9 op incorrecta 1\",\"por qu\u00E9 op incorrecta 2\",\"por qu\u00E9 op incorrecta 3\"]}\nSin texto adicional. Solo JSON.";

package/dist/hivelearn/src/agents/prompts/structure.prompt.d.ts

@@ -0,0 +1 @@
+export declare const STRUCTURE_PROMPT = "Eres StructureAgent de HiveLearn. Dise\u00F1as el esqueleto completo de un programa de aprendizaje adaptativo.\n\n## Tu tarea\nRecibir\u00E1s el perfil del alumno, su meta de aprendizaje, y el contexto de los agentes anteriores.\nDebes dise\u00F1ar exactamente la cantidad de nodos indicada, siguiendo la secuencia pedag\u00F3gica obligatoria.\n\n## Secuencia pedag\u00F3gica obligatoria (en este orden)\n1. **bienvenida** \u2014 Introducci\u00F3n motivadora al tema, tono adaptado a la edad\n2. **concepto** \u2014 Explicaci\u00F3n del concepto base (m\u00E1x 70 palabras)\n3. **c\u00F3digo o diagrama** \u2014 Representaci\u00F3n pr\u00E1ctica o visual del concepto\n4. **ejercicio** \u2014 Pr\u00E1ctica guiada con pistas opcionales\n5. **quiz** \u2014 Verificaci\u00F3n de conocimiento (4 opciones)\n6. **reto** \u2014 Aplicaci\u00F3n pr\u00E1ctica con pasos y criterios de \u00E9xito\n7. **milestone** \u2014 Celebraci\u00F3n de progreso intermedio\n8. **evaluaci\u00F3n** \u2014 Preguntas finales de cierre\n\nSi se piden m\u00E1s nodos, repite el patr\u00F3n: concepto \u2192 c\u00F3digo \u2192 ejercicio \u2192 quiz \u2192 reto\n\n## Formato de respuesta\nResponde SOLO con JSON v\u00E1lido. Sin texto adicional, sin markdown, sin explicaciones.\n\n{\n  \"tema\": \"tema principal de la lecci\u00F3n\",\n  \"nodos\": [\n    {\n      \"id\": \"nodo-0\",\n      \"titulo\": \"T\u00EDtulo descriptivo del nodo\",\n      \"concepto\": \"Descripci\u00F3n breve de qu\u00E9 se ense\u00F1a (1-2 oraciones)\",\n      \"tipo_pedagogico\": \"concept\",\n      \"tipo_visual\": \"text_card\",\n      \"xp_recompensa\": 20\n    }\n  ]\n}\n\n## Valores v\u00E1lidos\n- tipo_pedagogico: \"concept\" | \"exercise\" | \"quiz\" | \"challenge\" | \"milestone\" | \"evaluation\"\n- tipo_visual: \"text_card\" | \"code_block\" | \"svg_diagram\" | \"gif_guide\" | \"infographic\" | \"chart\" | \"animated_card\"\n- xp_recompensa: n\u00FAmero entre 10 y 50 (m\u00E1s alto para retos y evaluaci\u00F3n)\n\n## Reglas\n- El primer nodo SIEMPRE debe ser de bienvenida (tipo_pedagogico: \"concept\", tipo_visual: \"text_card\")\n- El \u00FAltimo nodo SIEMPRE debe ser evaluaci\u00F3n (tipo_pedagogico: \"evaluation\")\n- Incluye al menos un milestone a mitad del programa\n- Genera EXACTAMENTE la cantidad de nodos solicitada\n- Usa SIEMPRE snake_case: tipo_pedagogico, tipo_visual, xp_recompensa\n- NO agregues texto fuera del JSON";

package/dist/hivelearn/src/agents/prompts/svg.prompt.d.ts

@@ -0,0 +1 @@
+export declare const SVG_PROMPT = "Eres SVGAgent de HiveLearn. Generas diagramas SVG educativos.\nEspecificaciones: viewBox=\"0 0 400 300\", colores #F59E0B y #1F2937, m\u00E1x 40 elementos, sin scripts ni onclick.\nResponde SOLO con JSON:\n{\"svgString\":\"<svg viewBox='0 0 400 300' xmlns='http://www.w3.org/2000/svg'>...</svg>\"}\nSin texto adicional. Solo JSON.";

package/dist/hivelearn/src/agents/registry.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Registry de los 17 agentes del enjambre HiveLearn:
+ *   1 coordinador (hl-coordinator-agent, role='coordinator')
+ *  16 workers especializados (role='worker')
+ *
+ * Se insertan en la tabla `agents` al inicializar con ON CONFLICT DO UPDATE,
+ * preservando la selección de provider/modelo que el usuario haya configurado.
+ */
+import type { Database } from 'bun:sqlite';
+export declare const AGENT_IDS: {
+    readonly coordinator: "hl-coordinator-agent";
+    readonly profile: "hl-profile-agent";
+    readonly intent: "hl-intent-agent";
+    readonly structure: "hl-structure-agent";
+    readonly explanation: "hl-explanation-agent";
+    readonly exercise: "hl-exercise-agent";
+    readonly quiz: "hl-quiz-agent";
+    readonly challenge: "hl-challenge-agent";
+    readonly code: "hl-code-agent";
+    readonly svg: "hl-svg-agent";
+    readonly gif: "hl-gif-agent";
+    readonly infographic: "hl-infographic-agent";
+    readonly image: "hl-image-agent";
+    readonly audio: "hl-audio-agent";
+    readonly gamification: "hl-gamification-agent";
+    readonly evaluation: "hl-evaluation-agent";
+    readonly feedback: "hl-feedback-agent";
+};
+interface AgentDef {
+    id: string;
+    name: string;
+    description: string;
+    systemPrompt: string;
+    maxIterations: number;
+}
+declare const HIVELEARN_AGENTS: AgentDef[];
+export declare function registerHiveLearnAgents(db: Database): void;
+/**
+ * Actualiza todos los agentes de HiveLearn con el provider_id y model_id seleccionados.
+ * Esto permite que el enjambre use el provider/modelo que el usuario eligió.
+ */
+export declare function updateHiveLearnAgentsProviderModel(db: Database, providerId: string, modelId: string): void;
+export { HIVELEARN_AGENTS };

package/dist/hivelearn/src/cache/CacheInvalidator.d.ts

@@ -0,0 +1,9 @@
+export declare class CacheInvalidator {
+    /** Elimina entradas expiradas de hl_node_cache */
+    invalidateExpired(): number;
+    /** Invalida todas las entradas de un agente específico */
+    invalidateByAgent(agenteTipo: string): number;
+    /** Invalida entradas con tasa de abandono alta (ciclo de mejora continua) */
+    invalidateIneffective(umbralTasaAbandono?: number): number;
+}
+export declare const cacheInvalidator: CacheInvalidator;

package/dist/hivelearn/src/cache/NodeCache.d.ts

@@ -0,0 +1,15 @@
+export interface CachedOutput {
+    cacheKey: string;
+    agenteTipo: string;
+    conceptoSlug: string;
+    nivel: string;
+    rangoEdad: string;
+    outputJson: string;
+    hits: number;
+}
+export declare class NodeCache {
+    get(agenteTipo: string, conceptoSlug: string, nivel: string, rangoEdad: string): CachedOutput | null;
+    set(agenteTipo: string, conceptoSlug: string, nivel: string, rangoEdad: string, output: unknown): void;
+    hit(agenteTipo: string, conceptoSlug: string, nivel: string, rangoEdad: string): void;
+}
+export declare const nodeCache: NodeCache;

package/dist/hivelearn/src/events/swarm-events.d.ts

@@ -0,0 +1,12 @@
+/**
+ * HiveLearn — Local event emitter for swarm progress.
+ * Decoupled from core's agentBus so hivelearn is self-contained.
+ * server.ts subscribes here for SSE streaming.
+ */
+import { EventEmitter } from 'events';
+declare class HLSwarmEmitter extends EventEmitter {
+    subscribe(event: string, cb: (...args: any[]) => void): void;
+    unsubscribe(event: string, cb: (...args: any[]) => void): void;
+}
+export declare const hlSwarmEmitter: HLSwarmEmitter;
+export {};

package/dist/hivelearn/src/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * HiveLearn — Backend entry point
+ */
+export type { StudentProfile, LessonProgram, SwarmProgress, NodoLesson, NodoContenido, MicroEvaluacion, FeedbackOutput, EvaluacionOutput, PreguntaEvaluacion, GamificacionOutput, Logro, RangoEdad, TipoPedagogico, TipoVisual, EstadoNodo, } from './types';
+export type { CalificacionOutput, CalificacionInput } from './tools/evaluation/calificar-evaluacion.tool';
+export type { SessionData, SessionMetrics } from './persistence/LessonPersistence';
+export { HiveLearnSwarm } from './swarm/HiveLearnSwarm';
+export { runHiveLearnSession } from './swarm/session';
+export { LessonPersistence } from './persistence/LessonPersistence';
+export { evaluarRespuestas } from './tools/evaluation/calificar-evaluacion.tool';
+export { calificarEvaluacionTool, calificarRespuestaTool } from './tools/evaluation/calificar-evaluacion.tool';
+export { AGENT_IDS, updateHiveLearnAgentsProviderModel } from './agents/registry';
+export { AGENT_PROMPTS } from './agent/prompts';
+export { runHiveLearnAgent } from './agent/runner';
+export { hlSwarmEmitter } from './events/swarm-events';
+export { nodeCache } from './cache/NodeCache';
+export { cacheInvalidator } from './cache/CacheInvalidator';

package/dist/hivelearn/src/persistence/LessonPersistence.d.ts

@@ -0,0 +1,90 @@
+import type { StudentProfile } from '../types';
+export interface SessionData {
+    sessionId: string;
+    alumnoId: string;
+    curriculoId: number;
+    xpTotal: number;
+    nivelAlcanzado: string;
+    logrosJson: string;
+    nodosCompletados: number;
+    evaluacionPuntaje: number | null;
+    completada: boolean;
+}
+export interface SessionMetrics {
+    sessionId: string;
+    alumnoId: string;
+    curriculoId: number;
+    tema: string;
+    duracionRealSeg: number;
+    nodosTotal: number;
+    nodosCompletados: number;
+    puntajeEvaluacion: number | null;
+    intentosPorNodo: string;
+    nodosDominados: string;
+    nodosDificiles: string;
+    logrosDesbloqueados: string;
+    xpGanado: number;
+    completada: boolean;
+}
+export interface NodeEffectiveness {
+    id: string;
+    nodoContentHash: string;
+    agenteTipo: string;
+    tema: string;
+    tipoPedagogico: string;
+    tipoVisual: string;
+    rangoEdad: string;
+    intentosPromedio: number;
+    tasaAbandono: number;
+    tiempoPromedio: number;
+    vecesVisto: number;
+    vecesCompletado: number;
+}
+export declare class LessonPersistence {
+    private db;
+    constructor();
+    /** Verifica si los agentes de HiveLearn ya tienen provider/model configurados */
+    getHiveLearnProviderModel(): {
+        providerId: string;
+        modelId: string;
+    } | null;
+    saveStudentProfile(profile: StudentProfile): void;
+    getStudentProfile(alumnoId: string): StudentProfile | null;
+    saveCurriculum(sessionId: string, meta: string, nodosJson: string, totalNodos: number, rangoEdad: string, topicSlug: string | null): number;
+    getCurriculumBySessionId(sessionId: string): {
+        id: number;
+        nodos_json: string;
+        topic_slug: string | null;
+    } | null;
+    createSession(sessionId: string, alumnoId: string, curriculoId: number, rangoEdad: string): void;
+    updateSessionProgress(sessionId: string, nodosCompletados: number, xpTotal: number): void;
+    completeSession(sessionId: string, xpTotal: number, nivelAlcanzado: string, logrosJson: string, evaluacionPuntaje: number | null): void;
+    getSession(sessionId: string): SessionData | null;
+    getActiveSession(alumnoId: string): SessionData | null;
+    saveSessionMetrics(metrics: SessionMetrics): void;
+    trackNodeInteraction(nodoId: string, agenteTipo: string, tema: string, tipoPedagogico: string, tipoVisual: string, rangoEdad: string, completado: boolean, tiempoSeg: number): void;
+    saveAgentOutput(sessionId: string, agentId: string, taskId: string, outputJson: string, durationMs: number, status?: 'ok' | 'failed'): void;
+    getAgentOutputs(sessionId: string): Array<{
+        agent_id: string;
+        task_id: string;
+        output_json: string;
+        duration_ms: number;
+        status: string;
+    }>;
+    saveStudentResponse(sessionId: string, nodeId: string, tipoPedagogico: string, respuesta: string, feedbackJson: string, xpAwarded: number, esCorrecto: boolean): void;
+    updateNodeEffectiveness(nodeId: string, tipoPedagogico: string, esCorrecto: boolean): void;
+    /** Agrega un logro a la lista de logros desbloqueados de la sesión */
+    saveLogro(sessionId: string, logroId: string): void;
+    rateSession(sessionId: string, rating: number, comentario?: string): void;
+    /** Devuelve sesión + curriculo completo (nodos_json) para el gateway */
+    getSessionWithCurriculum(sessionId: string): (SessionData & {
+        nodosJson: string;
+        topicSlug: string | null;
+    }) | null;
+    getTopicEffectiveness(topicSlug: string | null): {
+        nodosConMasFallas: string[];
+        nivelPromedioAprobacion: number;
+    };
+    getAggregateMetrics(): Record<string, any>;
+    getSessionsByAlumno(alumnoId: string): SessionData[];
+}

package/dist/hivelearn/src/scheduler/dag/DAGScheduler.d.ts

@@ -0,0 +1,29 @@
+/**
+ * DAGScheduler — HiveLearn local copy
+ * Executes a TaskGraph in parallel. No core dependencies except logger.
+ */
+import { TaskGraph } from './TaskGraph';
+import { TaskNode } from './TaskNode';
+import type { DAGResult } from './TaskResult';
+import type { ExecutionStrategy } from './strategies/ParallelStrategy';
+export interface IAgentExecutor {
+    execute(node: TaskNode, depResults: Record<string, string>, threadId: string): Promise<string>;
+}
+export interface DAGSchedulerOptions {
+    strategy?: ExecutionStrategy;
+    maxConcurrentWorkers?: number;
+    projectId?: string;
+    coordinatorId?: string;
+    silent?: boolean;
+    executor?: IAgentExecutor;
+}
+export declare class DAGScheduler {
+    private strategy;
+    private maxConcurrentWorkers;
+    private executor;
+    private aborted;
+    constructor(options?: DAGSchedulerOptions);
+    abort(): void;
+    execute(graph: TaskGraph, options?: DAGSchedulerOptions): Promise<DAGResult>;
+    private logState;
+}

package/dist/hivelearn/src/scheduler/dag/EventBridge.d.ts

@@ -0,0 +1,16 @@
+/**
+ * HiveLearn EventBridge — maps DAG lifecycle events to hlSwarmEmitter.
+ * Decoupled from core's agentBus and canvas emitter.
+ */
+import { TaskNode } from './TaskNode';
+import type { DAGResult } from './TaskResult';
+export declare class EventBridge {
+    private swarmId;
+    private coordinatorId;
+    constructor(swarmId: string, _projectId: string, coordinatorId: string);
+    onSwarmStarted(totalTasks: number): void;
+    onTaskStarted(node: TaskNode): void;
+    onTaskCompleted(node: TaskNode, progress: number): void;
+    onTaskFailed(node: TaskNode, progress: number): void;
+    onSwarmCompleted(result: DAGResult): void;
+}

package/dist/hivelearn/src/scheduler/dag/TaskGraph.d.ts

@@ -0,0 +1,18 @@
+/**
+ * DAGScheduler — TaskGraph (HiveLearn local copy)
+ */
+import { TaskNode, type TaskNodeConfig } from "./TaskNode";
+export declare class TaskGraph {
+    readonly nodes: Map<string, TaskNode>;
+    private criticalPath_;
+    constructor(configs: TaskNodeConfig[]);
+    private validateNoCycles;
+    getCriticalPath(): string[];
+    getNewlyReadyNodes(completedIds: Set<string>): TaskNode[];
+    getReadyNodes(): TaskNode[];
+    getCompletedIds(): Set<string>;
+    getDepResults(nodeId: string): Record<string, string>;
+    getProgress(): number;
+    isComplete(): boolean;
+    propagateFailure(failedId: string, reason: string): void;
+}

package/dist/hivelearn/src/scheduler/dag/TaskNode.d.ts

@@ -0,0 +1,40 @@
+/**
+ * DAGScheduler — TaskNode (HiveLearn local copy)
+ */
+export type NodeStatus = "PENDING" | "READY" | "RUNNING" | "COMPLETED" | "FAILED";
+export interface TaskNodeConfig {
+    id: string;
+    agentId: string;
+    name: string;
+    taskDescription: string;
+    deps: string[];
+    timeout?: number;
+    maxRetries?: number;
+    priority?: number;
+    metadata?: Record<string, unknown>;
+}
+export declare class TaskNode {
+    readonly id: string;
+    readonly agentId: string;
+    readonly name: string;
+    readonly taskDescription: string;
+    readonly deps: string[];
+    readonly timeout: number;
+    readonly maxRetries: number;
+    readonly priority: number;
+    readonly metadata: Record<string, unknown>;
+    status: NodeStatus;
+    retryCount: number;
+    startedAt?: number;
+    completedAt?: number;
+    result?: string;
+    error?: string;
+    constructor(config: TaskNodeConfig);
+    canStart(completedIds: Set<string>): boolean;
+    markReady(): void;
+    markRunning(): void;
+    markCompleted(result: string): void;
+    markFailed(error: string): void;
+    canRetry(): boolean;
+    elapsedSeconds(): number;
+}

package/dist/hivelearn/src/scheduler/dag/TaskResult.d.ts

@@ -0,0 +1,19 @@
+/**
+ * DAGScheduler — Result types (HiveLearn local copy)
+ */
+export interface NodeSummary {
+    id: string;
+    name: string;
+    status: "COMPLETED" | "FAILED";
+    durationMs: number;
+    result?: string;
+    error?: string;
+    retries: number;
+}
+export interface DAGResult {
+    swarmId: string;
+    totalDurationMs: number;
+    completed: NodeSummary[];
+    failed: NodeSummary[];
+    success: boolean;
+}

package/dist/hivelearn/src/scheduler/dag/errors.d.ts

@@ -0,0 +1,17 @@
+/**
+ * DAGScheduler — Custom errors (HiveLearn local copy)
+ */
+export declare class CyclicDependencyError extends Error {
+    readonly cycle: string[];
+    constructor(cycle: string[]);
+}
+export declare class TaskTimeoutError extends Error {
+    readonly nodeId: string;
+    readonly timeoutMs: number;
+    constructor(nodeId: string, timeoutMs: number);
+}
+export declare class TaskFailureError extends Error {
+    readonly nodeId: string;
+    readonly cause: Error;
+    constructor(nodeId: string, cause: Error);
+}

package/dist/hivelearn/src/scheduler/dag/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * HiveLearn DAGScheduler — Public API
+ */
+export { DAGScheduler } from './DAGScheduler';
+export type { DAGSchedulerOptions, IAgentExecutor } from './DAGScheduler';
+export { TaskGraph } from './TaskGraph';
+export { TaskNode } from './TaskNode';
+export type { TaskNodeConfig, NodeStatus } from './TaskNode';
+export type { DAGResult, NodeSummary } from './TaskResult';
+export { EventBridge } from './EventBridge';
+export { CyclicDependencyError, TaskTimeoutError, TaskFailureError } from './errors';
+export { ParallelStrategy } from './strategies/ParallelStrategy';
+export type { ExecutionStrategy } from './strategies/ParallelStrategy';

package/dist/hivelearn/src/scheduler/dag/strategies/ParallelStrategy.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ParallelStrategy — FIFO execution (HiveLearn local copy)
+ */
+import { TaskNode } from "../TaskNode";
+export interface ExecutionStrategy {
+    pick(queue: TaskNode[]): TaskNode | undefined;
+    initialize?(nodes: Map<string, TaskNode>): void;
+}
+export declare class ParallelStrategy implements ExecutionStrategy {
+    pick(queue: TaskNode[]): TaskNode | undefined;
+}

package/dist/hivelearn/src/swarm/HiveLearnSwarm.d.ts

@@ -0,0 +1,16 @@
+import type { StudentProfile, LessonProgram, SwarmProgress } from '../types';
+export type ProgressCallback = (progress: SwarmProgress) => void;
+export declare class HiveLearnSwarm {
+    private onProgress?;
+    constructor(opts?: {
+        onProgress?: ProgressCallback;
+    });
+    private emit;
+    run(perfil: StudentProfile, meta: string): Promise<LessonProgram>;
+    /** El coordinador revisa el LessonProgram y aplica correcciones + retries si los hay. */
+    private runCoordinatorReview;
+    /** Aplica correcciones de título/XP/concepto a los nodos del programa. */
+    private applyCorrecciones;
+    private calcNodos;
+    private calcTono;
+}

package/dist/hivelearn/src/swarm/orchestrator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Orchestrator — combina los outputs del DAGScheduler en un LessonProgram completo
+ */
+import type { DAGResult } from '../scheduler/dag';
+import type { LessonProgram, NodoLesson, PerfilAdaptacion } from '../types';
+export declare function parseAgentOutput<T>(raw: string, fallback: T): T;
+/** Construye la lista de nodos base desde el output de StructureAgent */
+export declare function buildNodosBase(structureResult: string, perfil: PerfilAdaptacion): Omit<NodoLesson, 'posX' | 'posY'>[];
+export declare function buildLessonProgram(opts: {
+    dagResult: DAGResult;
+    alumnoId: string;
+    meta: string;
+    sessionId: string;
+    perfil: PerfilAdaptacion;
+}): LessonProgram;

package/dist/hivelearn/src/swarm/presets/HiveLearnPreset.d.ts

@@ -0,0 +1,35 @@
+/**
+ * HiveLearnPreset — DAG completo de 14 agentes para HiveLearn
+ *
+ * TIER 0 (secuencial):  profile → intent → structure
+ * TIER 1 (paralelo×2):  content agents por nodo del currículo
+ * TIER 2 (paralelo):    gamification + evaluation + position
+ * POST:                 postsession
+ */
+import { TaskGraph } from '../../scheduler/dag';
+import type { TaskNodeConfig } from '../../scheduler/dag';
+import type { PerfilAdaptacion, NodoLesson } from '../../types';
+export interface HiveLearnDAGInput {
+    alumnoId: string;
+    meta: string;
+    perfil: PerfilAdaptacion;
+    sessionId: string;
+}
+/**
+ * Genera el grafo DAG para el enjambre completo.
+ * Los nodos de contenido (Tier 1) se agregan dinámicamente cuando
+ * el StructureAgent completa y el orchestrator ya tiene los nodos.
+ * Esta función genera el grafo base (Tier 0 + Tier 2).
+ */
+export declare function buildBaseDAG(input: HiveLearnDAGInput): TaskGraph;
+/**
+ * Construye los nodos Tier 1 para cada nodo del currículo.
+ * Se llama después de que StructureAgent completa.
+ */
+export declare function buildContentNodes(nodos: NodoLesson[], ctxBase: string): TaskNodeConfig[];
+/**
+ * Construye el TaskGraph de Fase 2 (solo content + tier2).
+ * NO incluye tier0 (profile/intent/structure) — ya corrieron en buildBaseDAG.
+ * Los content tasks no tienen deps en 'structure' porque Phase 1 ya lo resolvió.
+ */
+export declare function buildFullDAG(input: HiveLearnDAGInput, nodos: NodoLesson[]): TaskGraph;

package/dist/hivelearn/src/swarm/session.d.ts

@@ -0,0 +1,15 @@
+/**
+ * runHiveLearnSession — función de alto nivel que encapsula todo el ciclo:
+ * 1. Persiste perfil del alumno
+ * 2. Corre el enjambre (HiveLearnSwarm)
+ * 3. Persiste el currículum y crea la sesión en BD
+ * 4. Devuelve LessonProgram listo para servir
+ *
+ * Esta es la función que el gateway de hive-cloud debe llamar.
+ */
+import { type ProgressCallback } from './HiveLearnSwarm';
+import type { StudentProfile, LessonProgram } from '../types';
+export interface RunSessionOptions {
+    onProgress?: ProgressCallback;
+}
+export declare function runHiveLearnSession(perfil: StudentProfile, meta: string, opts?: RunSessionOptions): Promise<LessonProgram>;

package/dist/hivelearn/src/tools/canvas/disenar-estructura.tool.d.ts

@@ -0,0 +1,3 @@
+import type { Tool } from '../../types/tool';
+/** El StructureAgent llama esta tool con el diseño del programa completo */
+export declare const disenarEstructuraTool: Tool;

package/dist/hivelearn/src/tools/canvas/poblar-nodo.tool.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from '../../types/tool';
+export declare const poblarNodoTool: Tool;

package/dist/hivelearn/src/tools/content/generar-audio.tool.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from '../../types/tool';
+export declare const generarAudioTool: Tool;

package/dist/hivelearn/src/tools/content/generar-codigo.tool.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from '../../types/tool';
+export declare const generarCodigoTool: Tool;

package/dist/hivelearn/src/tools/content/generar-ejercicio.tool.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from '../../types/tool';
+export declare const generarEjercicioTool: Tool;

package/dist/hivelearn/src/tools/content/generar-explicacion.tool.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from '../../types/tool';
+export declare const generarExplicacionTool: Tool;

package/dist/hivelearn/src/tools/content/generar-frames-gif.tool.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from '../../types/tool';
+export declare const generarFramesGifTool: Tool;

package/dist/hivelearn/src/tools/content/generar-imagen.tool.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from '../../types/tool';
+export declare const generarImagenTool: Tool;

package/dist/hivelearn/src/tools/content/generar-infografia.tool.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from '../../types/tool';
+export declare const generarInfografiaTool: Tool;