@johpaz/hive-sdk 0.0.9 → 0.0.11

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

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

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

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

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

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

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

@@ -1,6 +0,0 @@
-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

@@ -1,6 +0,0 @@
-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

@@ -1,20 +0,0 @@
-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

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

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

@@ -1,26 +0,0 @@
-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

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

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

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

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

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

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

@@ -1,17 +0,0 @@
-/**
- * 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

@@ -1,187 +0,0 @@
-/** 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

@@ -1,21 +0,0 @@
-/**
- * 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 {};

package/dist/index.d.ts

@@ -1,35 +0,0 @@
-/**
- * @johpaz/hive-agents-sdk
- *
- * Hive SDK - Build on top of Hive for enterprise and custom integrations.
- *
- * This package exposes all internal Hive functionality as a clean, organized API
- * for developers who want to build on top of Hive, including hive-cloud Enterprise.
- *
- * @example
- * import { runAgent, AgentService } from "@johpaz/hive-agents-sdk/agents";
- * import { createAllTools } from "@johpaz/hive-agents-sdk/tools";
- * import { SkillLoader } from "@johpaz/hive-agents-sdk/skills";
- * import { MCPClientManager } from "@johpaz/hive-agents-sdk/mcp";
- * import { ChannelManager } from "@johpaz/hive-agents-sdk/channels";
- * import { getDb, initDatabase } from "@johpaz/hive-agents-sdk/database";
- *
- * // Or import everything
- * import * as HiveSDK from "@johpaz/hive-agents-sdk";
- */
-export { AgentService, getAgentService, createAgentService, runAgent, runAgentIsolated, rebuildAgentLoop, getAgentLoop, compileContext, buildSystemPromptWithProjects, addMessage, getHistory, getRecentMessages, getMessageCount, getTotalTokens, getMessagesAfter, selectTools, selectSkills, selectPlaybookRules, callLLM, resolveProviderConfig, resolveAgentId, resolveUserId, memoryWriteTool as agentMemoryWriteTool, memoryReadTool as agentMemoryReadTool, memoryListTool as agentMemoryListTool, memorySearchTool as agentMemorySearchTool, memoryDeleteTool as agentMemoryDeleteTool, agentCreateTool, agentFindTool, agentArchiveTool, taskDelegateTool, taskDelegateCodeTool, taskStatusTool, busPublishTool, busReadTool, projectUpdatesTool, createAgentTools, } from "./agents/index";
-export type { AgentServiceConfig, AgentDBRecord, AgentLoopOptions, StepEvent, StreamChunk, LLMMessage, LLMResponse, LLMCallOptions, LLMToolCall, StoredMessage, } from "./agents/index";
-export { createAllTools, createToolsByCategory, fsEditTool, fsReadTool, fsWriteTool, fsDeleteTool, fsListTool, fsGlobTool, fsExistsTool, webSearchTool, webFetchTool, browserNavigateTool, browserScreenshotTool, browserClickTool, browserTypeTool, projectCreateTool, projectListTool, projectUpdateTool, projectDoneTool, projectFailTool, taskCreateTool, taskUpdateTool, taskEvaluateTool, cronCreateTool, cronListTool, cronPauseTool, cronResumeTool, cronDeleteTool, cronTriggerTool, cronHistoryTool, resolveBestChannel, cliExecTool, canvasRenderTool, canvasAskTool, canvasConfirmTool, canvasShowCardTool, canvasShowProgressTool, canvasShowListTool, canvasClearTool, codebridgeLaunchTool, codebridgeStatusTool, codebridgeCancelTool, codebridgeFeedbackTool, voiceTranscribeTool, voiceSpeakTool, searchKnowledgeTool, notifyTool, saveNoteTool, reportProgressTool, } from "./tools/index";
-export type { Tool, ToolResult } from "./tools/index";
-export { SkillLoader, createSkillLoader } from "./skills/index";
-export type { SkillsConfig, Config, SkillStep, OutputFormat, SkillExample, SkillMetadata, Skill, } from "./skills/index";
-export { MCPClientManager, logger } from "./mcp/index";
-export type { MCPTool, MCPResource, MCPPrompt, MCPConfig, MCPServerConfig, } from "./mcp/index";
-export { ChannelManager, TelegramChannel, DiscordChannel, WhatsAppChannel, SlackChannel, WebChatChannel, } from "./channels/index";
-export type { OutboundMessage, IncomingMessage, ChannelConfig, IChannel, MessageHandler, TelegramConfig, DiscordConfig, WhatsAppConfig, WhatsAppConnectionState, SlackConfig, SlackConnectionState, WebChatConfig, } from "./channels/index";
-export { scheduleCreateTool, scheduleListTool, schedulePauseTool, scheduleResumeTool, scheduleDeleteTool, scheduleTriggerTool, scheduleHistoryTool, createScheduleTools, setSchedulerInstance, createCronTools, } from "./cron/index";
-export { getAllEthics, activateEthics } from "./ethics/index";
-export { getDb, initializeDatabase, getDbPathLazy, dbService, seedAllData, seedToolsAndSkills, getAllElements, getActiveElements, encrypt, decrypt, encryptApiKey, decryptApiKey, encryptConfig, decryptConfig, hashPassword, verifyPassword, maskApiKey, getAllProviders, getAllModels, getAllCodeBridge, getAllSkills, getAllDbTools, getAllMcpServers, getAllChannels, getActiveTools, getUserAgents, getSingleUserId, getCoordinatorAgentId, getDefaultAgentId, getAgentConfig, } from "./database/index";
-export type { SCHEMA, PROJECTS_SCHEMA, CONTEXT_ENGINE_SCHEMA, } from "./database/index";
-export type { AgentDBRecord as AgentDBRecordType, AgentServiceConfig as AgentServiceConfigType, AgentLoopOptions as AgentLoopOptionsType, StepEvent as StepEventType, StreamChunk as StreamChunkType, LLMMessage as LLMMessageType, LLMResponse as LLMResponseType, LLMCallOptions as LLMCallOptionsType, LLMToolCall as LLMToolCallType, OutboundMessage as OutboundMessageType, IncomingMessage as IncomingMessageType, ChannelConfig as ChannelConfigType, IChannel as IChannelType, MCPTool as MCPToolType, MCPResource as MCPResourceType, MCPPrompt as MCPPromptType, MCPConfig as MCPConfigType, MCPServerConfig as MCPServerConfigType, Skill as SkillType, SkillMetadata as SkillMetadataType, SkillStep as SkillStepType, SkillExample as SkillExampleType, OutputFormat as OutputFormatType, SkillsConfig as SkillsConfigType, StoredMessage as StoredMessageType, } from "./types/index";
-export declare const SDK_VERSION = "1.0.0";