@johpaz/hive-sdk 0.0.5 → 0.0.7

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

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

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

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

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

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

package/dist/hivelearn/src/tools/coordinator/delegar-enjambre.tool.d.ts

@@ -0,0 +1,6 @@
+import type { Tool } from '../../types/tool';
+/**
+ * Tool del Coordinador para delegar al enjambre de workers.
+ * Ejecuta el DAGScheduler con los workers seleccionados y devuelve el LessonProgram.
+ */
+export declare const delegarEnjambreTool: Tool;

package/dist/hivelearn/src/tools/coordinator/revisar-programa.tool.d.ts

@@ -0,0 +1,6 @@
+import type { Tool } from '../../types/tool';
+/**
+ * Tool del Coordinador para registrar su revisión pedagógica del LessonProgram.
+ * Es una structured-output tool — los args son el resultado final.
+ */
+export declare const revisarProgramaTool: Tool;

package/dist/hivelearn/src/tools/evaluation/calificar-evaluacion.tool.d.ts

@@ -0,0 +1,20 @@
+import type { Tool } from '../../types/tool';
+import type { FeedbackOutput, PreguntaEvaluacion } from '../../types';
+export interface CalificacionInput {
+    preguntas: PreguntaEvaluacion[];
+    respuestasAlumno: Array<string | number>;
+}
+export interface CalificacionOutput {
+    puntaje: number;
+    correctas: number;
+    total: number;
+    feedback: FeedbackOutput[];
+}
+/**
+ * Evalúa directamente las respuestas del alumno sin necesitar un agente LLM.
+ * - multiple_choice: compara índice seleccionado con indiceCorrecto
+ * - respuesta_corta: similitud de palabras clave (umbral 0.5)
+ */
+export declare function evaluarRespuestas(input: CalificacionInput): CalificacionOutput;
+export declare const calificarEvaluacionTool: Tool;
+export declare const calificarRespuestaTool: Tool;

package/dist/hivelearn/src/tools/evaluation/generar-evaluacion.tool.d.ts

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

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

@@ -0,0 +1,26 @@
+export { disenarEstructuraTool } from './canvas/disenar-estructura.tool';
+export { poblarNodoTool } from './canvas/poblar-nodo.tool';
+export { generarExplicacionTool } from './content/generar-explicacion.tool';
+export { generarEjercicioTool } from './content/generar-ejercicio.tool';
+export { generarQuizTool } from './content/generar-quiz.tool';
+export { generarRetoTool } from './content/generar-reto.tool';
+export { generarCodigoTool } from './content/generar-codigo.tool';
+export { generarSvgTool } from './content/generar-svg.tool';
+export { generarFramesGifTool } from './content/generar-frames-gif.tool';
+export { generarInfografiaTool } from './content/generar-infografia.tool';
+export { generarEvaluacionTool } from './evaluation/generar-evaluacion.tool';
+export { calificarEvaluacionTool, calificarRespuestaTool } from './evaluation/calificar-evaluacion.tool';
+export { generarImagenTool } from './content/generar-imagen.tool';
+export { clasificarIntencionTool } from './profile/clasificar-intencion.tool';
+export { buscarCurriculoExistenteTool } from './search/buscar-curriculo-existente.tool';
+export { buscarEnHiveLearnTool } from './search/buscar-en-hivelearn.tool';
+export { revisarProgramaTool } from './coordinator/revisar-programa.tool';
+export { delegarEnjambreTool } from './coordinator/delegar-enjambre.tool';
+import type { LLMToolDef } from '../types/tool';
+export declare const PROFILE_TOOLS: LLMToolDef[];
+export declare const INTENT_TOOLS: LLMToolDef[];
+export declare const STRUCTURE_TOOLS: LLMToolDef[];
+export declare const CONTENT_TOOLS: LLMToolDef[];
+export declare const VISUAL_TOOLS: LLMToolDef[];
+export declare const EVALUATION_TOOLS: LLMToolDef[];
+export declare const GAMIFICATION_TOOLS: LLMToolDef[];

package/dist/hivelearn/src/tools/profile/clasificar-intencion.tool.d.ts

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

package/dist/hivelearn/src/tools/search/buscar-curriculo-existente.tool.d.ts

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

package/dist/hivelearn/src/tools/search/buscar-en-hivelearn.tool.d.ts

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

package/dist/hivelearn/src/types/tool.d.ts

@@ -0,0 +1,17 @@
+/**
+ * HiveLearn — Tool types (local copy, no core dependency)
+ */
+export interface Tool {
+    name: string;
+    description: string;
+    parameters: Record<string, any>;
+    execute?: (params: Record<string, unknown>, config?: any) => Promise<string | object>;
+}
+export interface LLMToolDef {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, any>;
+    };
+}

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

@@ -0,0 +1,187 @@
+/** Tipos compartidos entre backend y UI de HiveLearn */
+export type RangoEdad = 'nino' | 'adolescente' | 'adulto';
+export type TipoPedagogico = 'concept' | 'exercise' | 'quiz' | 'challenge' | 'milestone' | 'evaluation';
+export type TipoVisual = 'text_card' | 'code_block' | 'svg_diagram' | 'gif_guide' | 'infographic' | 'chart' | 'animated_card' | 'image_ai' | 'audio_ai';
+export type TipoPregunta = 'verdadero_falso' | 'multiple_choice' | 'respuesta_corta' | 'completar_codigo';
+export type NivelPrevio = 'principiante' | 'principiante_base' | 'intermedio';
+export type EstiloAprendizaje = 'visual' | 'lectura' | 'retos' | 'balanceado' | 'mis_retos';
+export type EstadoNodo = 'bloqueado' | 'disponible' | 'completado';
+export type AgentStatus = 'idle' | 'pending' | 'running' | 'thinking' | 'tool_call' | 'completed' | 'failed';
+export type CoordinatorStatus = 'idle' | 'analyzing' | 'delegating' | 'assembling' | 'rendering' | 'completed' | 'error';
+export interface CoordinatorState {
+    status: CoordinatorStatus;
+    currentWorker: string | null;
+    activeWorkers: string[];
+    totalWorkers: number;
+}
+export interface StudentProfile {
+    alumnoId: string;
+    nombre: string;
+    edad: number;
+    rangoEdad: RangoEdad;
+    tiempoSesion: 15 | 30 | 45;
+    nivelPrevio: NivelPrevio;
+    estilo: EstiloAprendizaje;
+    sesionesTotal: number;
+    xpAcumulado: number;
+    nivelActual: string;
+}
+export interface PerfilAdaptacion {
+    rangoEdad: RangoEdad;
+    duracionSesion: number;
+    nodosRecomendados: number;
+    estilo: EstiloAprendizaje;
+    nivelPrevio: NivelPrevio;
+    tono: string;
+}
+export interface IntentResult {
+    tema: string;
+    nivelDetectado: NivelPrevio;
+    topicSlug: string | null;
+    tono: string;
+    confianza: number;
+}
+export interface NodoLesson {
+    id: string;
+    tipoPedagogico: TipoPedagogico;
+    tipoVisual: TipoVisual;
+    titulo: string;
+    concepto: string;
+    nivel: NivelPrevio;
+    rangoEdad: RangoEdad;
+    posX: number;
+    posY: number;
+    estado: EstadoNodo;
+    xpRecompensa: number;
+    contenido?: NodoContenido;
+}
+export interface MicroEvaluacion {
+    tipo: TipoPregunta;
+    pregunta: string;
+    opciones?: string[];
+    respuestaCorrecta: string;
+    pista?: string;
+}
+export interface NodoContenido {
+    explicacion?: ExplicacionOutput;
+    ejercicio?: EjercicioOutput;
+    quiz?: QuizOutput;
+    reto?: RetoOutput;
+    codigo?: CodigoOutput;
+    svg?: SvgOutput;
+    gifFrames?: GifOutput;
+    infografia?: InfografiaOutput;
+    evaluacion?: EvaluacionOutput;
+    microEval?: MicroEvaluacion;
+    imagen?: ImagenOutput;
+    audio?: AudioOutput;
+}
+export interface ImagenOutput {
+    prompt: string;
+    estilo: 'diagram' | 'illustration' | 'chart';
+    alt_text: string;
+    caption: string;
+    svg_fallback: string;
+    url?: string;
+}
+export interface AudioOutput {
+    narration_text: string;
+    voice_tone: 'friendly' | 'professional' | 'motivating';
+    key_pauses: string[];
+    speed: 'slow' | 'normal' | 'fast';
+    title: string;
+}
+export interface ExplicacionOutput {
+    titulo: string;
+    explicacion: string;
+    ejemploConcreto: string;
+}
+export interface EjercicioOutput {
+    enunciado: string;
+    ejemploRespuesta: string;
+    respuestaCorrecta: string;
+    pistaOpcional?: string;
+}
+export interface QuizOutput {
+    pregunta: string;
+    opciones: string[];
+    indicesCorrecto: number;
+    explicacionesIncorrectas: string[];
+}
+export interface RetoOutput {
+    titulo: string;
+    contexto: string;
+    pasos: string[];
+    criteriosExito: string[];
+}
+export interface CodigoOutput {
+    lenguaje: string;
+    codigo: string;
+    descripcionBreve: string;
+}
+export interface SvgOutput {
+    svgString: string;
+}
+export interface GifFrame {
+    emoji: string;
+    texto: string;
+    duracionMs: number;
+}
+export interface GifOutput {
+    frames: GifFrame[];
+}
+export interface InfografiaSeccion {
+    emoji: string;
+    titulo: string;
+    valor: string;
+}
+export interface InfografiaOutput {
+    secciones: InfografiaSeccion[];
+}
+export interface GamificacionOutput {
+    xpRecompensa: number;
+    logros: Logro[];
+    mensajeCelebracion: string;
+    badge?: string;
+}
+export interface Logro {
+    id: string;
+    nombre: string;
+    descripcion: string;
+    emoji: string;
+    xp: number;
+}
+export interface EvaluacionOutput {
+    preguntas: PreguntaEvaluacion[];
+}
+export interface PreguntaEvaluacion {
+    tipo: 'multiple_choice' | 'respuesta_corta';
+    pregunta: string;
+    opciones?: string[];
+    indiceCorrecto?: number;
+    respuestaEsperada?: string;
+}
+export interface FeedbackOutput {
+    correcto: boolean;
+    mensajePrincipal: string;
+    pistaSiIncorrecto?: string;
+    xpGanado: number;
+    razonamiento?: string;
+}
+export interface LessonProgram {
+    sessionId: string;
+    alumnoId: string;
+    tema: string;
+    topicSlug: string | null;
+    rangoEdad: RangoEdad;
+    nodos: NodoLesson[];
+    gamificacion: GamificacionOutput;
+    evaluacion: EvaluacionOutput;
+    perfilAdaptacion: PerfilAdaptacion;
+}
+export interface SwarmProgress {
+    etapa: string;
+    agenteActivo: string;
+    porcentaje: number;
+    mensaje: string;
+}

package/dist/hivelearn/src/utils/logger.d.ts

@@ -0,0 +1,21 @@
+/**
+ * HiveLearn — Logger simple (no depende de core)
+ */
+declare class ChildLogger {
+    private context;
+    constructor(context: string);
+    debug(msg: string): void;
+    info(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+    child(sub: string): ChildLogger;
+}
+declare class RootLogger {
+    debug(msg: string): void;
+    info(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+    child(context: string): ChildLogger;
+}
+export declare const logger: RootLogger;
+export {};