@johpaz/hive-sdk 0.0.12 → 0.0.15

package/packages/core/src/tools/index.ts

@@ -0,0 +1,231 @@
+/**
+ * Tools Registry - Exports all 66 tools
+ * 
+ * Import this to get all tools:
+ * import { createAllTools } from "./tools";
+ */
+
+import type { Tool } from "./types.ts";
+import type { Config } from "../config/loader.ts";
+
+// Filesystem (7)
+import * as filesystem from "./filesystem/index.ts";
+
+// Web (9)
+import * as web from "./web/index.ts";
+
+// Projects (8)
+import * as projects from "./projects/index.ts";
+
+// Cron (7) - Croner-based scheduler tools
+import * as cron from "./cron/index.ts";
+
+// CLI (1)
+import * as cli from "./cli/index.ts";
+
+// Agents (14)
+import * as agents from "./agents/index.ts";
+
+// Canvas (7)
+import * as canvas from "./canvas/index.ts";
+
+// Codebridge (3)
+import * as codebridge from "./codebridge/index.ts";
+
+// Voice (2)
+import * as voice from "./voice/index.ts";
+
+// Core (4)
+import * as core from "./core/index.ts";
+
+// Office (8)
+import * as office from "./office/index.ts";
+
+// Meeting (4)
+import * as meeting from "./meeting/index.ts";
+
+/**
+ * Creates all 70 tools with proper configuration
+ */
+export function createAllTools(config: Config): Tool[] {
+  return [
+    // FILESYSTEM (7)
+    ...filesystem.createTools(),
+
+    // WEB (9)
+    ...web.createTools(),
+
+    // PROJECTS (8)
+    ...projects.createTools(),
+
+    // CRON (7)
+    ...cron.createTools(),
+
+    // CLI (1)
+    ...cli.createTools(),
+
+    // AGENTS (14)
+    ...agents.createTools(),
+
+    // CANVAS (7 + A2UI 4)
+    ...canvas.createTools(config),
+
+    // CODEBRIDGE (3)
+    ...codebridge.createTools(),
+
+    // VOICE (2)
+    ...voice.createTools(),
+
+    // CORE (4)
+    ...core.createTools(),
+
+    // OFFICE (8)
+    ...office.createTools(),
+
+    // MEETING (4)
+    ...meeting.createTools(),
+  ];
+}
+
+/**
+ * Creates tools by category (for selective loading)
+ */
+export function createToolsByCategory(category: string, config: Config): Tool[] {
+  switch (category) {
+    case "filesystem":
+      return filesystem.createTools();
+    case "web":
+      return web.createTools();
+    case "projects":
+      return projects.createTools();
+    case "cron":
+      return cron.createTools();
+    case "cli":
+      return cli.createTools();
+    case "agents":
+      return agents.createTools();
+    case "canvas":
+      return canvas.createTools(config);
+    case "codebridge":
+      return codebridge.createTools();
+    case "voice":
+      return voice.createTools();
+    case "core":
+      return core.createTools();
+    case "office":
+      return office.createTools();
+    case "meeting":
+      return meeting.createTools();
+    default:
+      return [];
+  }
+}
+
+// Export types
+export * from "./types.ts";
+
+// Export tools by category (avoiding createTools name collisions)
+// Use category-specific imports or createAllTools/createToolsByCategory
+export {
+  fsEditTool,
+  fsReadTool,
+  fsWriteTool,
+  fsDeleteTool,
+  fsListTool,
+  fsGlobTool,
+  fsExistsTool,
+} from "./filesystem/index.ts";
+
+export {
+  webSearchTool,
+  webFetchTool,
+  browserNavigateTool,
+  browserScreenshotTool,
+  browserClickTool,
+  browserTypeTool,
+  browserExtractTool,
+  browserScriptTool,
+  browserWaitTool,
+} from "./web/index.ts";
+
+export {
+  projectCreateTool,
+  projectListTool,
+  projectUpdateTool,
+  projectDoneTool,
+  projectFailTool,
+  taskCreateTool,
+  taskUpdateTool,
+  taskEvaluateTool,
+} from "./projects/index.ts";
+
+export {
+  cronCreateTool,
+  cronListTool,
+  cronUpdateTool,
+  cronPauseTool,
+  cronResumeTool,
+  cronDeleteTool,
+  cronTriggerTool,
+  cronHistoryTool,
+  setSchedulerInstance,
+  resolveBestChannel,
+} from "./cron/index.ts";
+
+export { cliExecTool } from "./cli/index.ts";
+
+export {
+  memoryWriteTool,
+  memoryReadTool,
+  memoryListTool,
+  memorySearchTool,
+  memoryDeleteTool,
+  agentCreateTool,
+  agentFindTool,
+  agentArchiveTool,
+  taskDelegateTool,
+  taskDelegateCodeTool,
+  taskStatusTool,
+  busPublishTool,
+  busReadTool,
+  projectUpdatesTool,
+} from "./agents/index.ts";
+
+export {
+  canvasRenderTool,
+  canvasAskTool,
+  canvasConfirmTool,
+  canvasShowCardTool,
+  canvasShowProgressTool,
+  canvasShowListTool,
+  canvasClearTool,
+} from "./canvas/index.ts";
+
+export {
+  codebridgeLaunchTool,
+  codebridgeStatusTool,
+  codebridgeCancelTool,
+} from "./codebridge/index.ts";
+
+export {
+  voiceTranscribeTool,
+  voiceSpeakTool,
+} from "./voice/index.ts";
+
+export {
+  searchKnowledgeTool,
+  notifyTool,
+  saveNoteTool,
+  reportProgressTool,
+} from "./core/index.ts";
+
+export {
+  officeLeerPdfTool,
+  officeEscribirPdfTool,
+  officeLeerDocxTool,
+  officeEscribirDocxTool,
+  officeLeerXlsxTool,
+  officeEscribirXlsxTool,
+  officeLeerPptxTool,
+  officeEscribirPptxTool,
+} from "./office/index.ts";

package/packages/core/src/tools/meeting/index.ts

@@ -0,0 +1,363 @@
+/**
+ * Meeting Tools - 4 tools para transcripción de reuniones
+ *
+ * @category meeting
+ *
+ * - meeting_start       — Inicia una sesión de transcripción
+ * - meeting_add_segment — Transcribe un chunk de audio y lo agrega a la sesión
+ * - meeting_stop        — Detiene la sesión de transcripción
+ * - meeting_report      — Obtiene el transcript completo para que el agente genere el reporte
+ */
+
+import type { Tool } from "../types.ts";
+import { getDb } from "../../storage/SQLiteStorage.ts";
+import { voiceService, type AudioInput } from "../../voice/index.ts";
+import { logger } from "../../utils/logger.ts";
+
+const log = logger.child("meeting");
+
+// ─── meeting_start ───────────────────────────────────────────────────────────
+
+export const meetingStartTool: Tool = {
+  name: "meeting_start",
+  description:
+    "Inicia una sesión de transcripción de reunión en tiempo real. | Start a real-time meeting transcription session.",
+  parameters: {
+    type: "object",
+    properties: {
+      title: {
+        type: "string",
+        description: "Título de la reunión (default: 'Reunión sin título')",
+      },
+      stt_model: {
+        type: "string",
+        description:
+          "Modelo STT a usar: 'whisper-large-v3-turbo' (default), 'whisper-large-v3', 'whisper-1'",
+      },
+    },
+    required: [],
+  },
+  execute: async (params) => {
+    const title = (params.title as string) || "Reunión sin título";
+    const sttModel =
+      (params.stt_model as string) || "whisper-large-v3-turbo";
+
+    try {
+      const db = getDb();
+      const result = db
+        .query(
+          `INSERT INTO meeting_sessions (title, stt_model)
+           VALUES (?, ?)
+           RETURNING id, title, status, stt_model, started_at`
+        )
+        .get(title, sttModel) as {
+        id: string;
+        title: string;
+        status: string;
+        stt_model: string;
+        started_at: number;
+      };
+
+      log.info(`Meeting session started: ${result.id} — "${title}"`);
+
+      return {
+        ok: true,
+        session_id: result.id,
+        title: result.title,
+        status: result.status,
+        stt_model: result.stt_model,
+        message: `✅ Sesión de reunión iniciada. ID: ${result.id}\nTítulo: "${title}"\nModelo STT: ${sttModel}`,
+      };
+    } catch (error) {
+      log.error(`meeting_start error: ${(error as Error).message}`);
+      return { ok: false, error: `Error al iniciar la sesión: ${(error as Error).message}` };
+    }
+  },
+};
+
+// ─── meeting_add_segment ─────────────────────────────────────────────────────
+
+export const meetingAddSegmentTool: Tool = {
+  name: "meeting_add_segment",
+  description:
+    "Transcribe un chunk de audio y lo agrega a la sesión de reunión activa. | Transcribe an audio chunk and add it to the active meeting session.",
+  parameters: {
+    type: "object",
+    properties: {
+      session_id: {
+        type: "string",
+        description: "ID de la sesión de reunión activa",
+      },
+      audio_base64: {
+        type: "string",
+        description: "Audio codificado en base64 (webm, ogg, mp3)",
+      },
+      speaker: {
+        type: "string",
+        description: "Etiqueta del hablante (opcional, ej: 'Ana', 'Speaker 1')",
+      },
+      mime_type: {
+        type: "string",
+        description: "Tipo MIME del audio (default: 'audio/webm')",
+      },
+    },
+    required: ["session_id", "audio_base64"],
+  },
+  execute: async (params) => {
+    const sessionId = params.session_id as string;
+    const audioBase64 = params.audio_base64 as string;
+    const speaker = (params.speaker as string) || null;
+    const mimeType = (params.mime_type as string) || "audio/webm";
+
+    try {
+      const db = getDb();
+
+      const session = db
+        .query(
+          `SELECT id, stt_model, status FROM meeting_sessions WHERE id = ?`
+        )
+        .get(sessionId) as { id: string; stt_model: string; status: string } | undefined;
+
+      if (!session) {
+        return { ok: false, error: `Sesión ${sessionId} no encontrada.` };
+      }
+      if (session.status !== "active") {
+        return {
+          ok: false,
+          error: `La sesión está ${session.status}. Solo se pueden agregar segmentos a sesiones activas.`,
+        };
+      }
+
+      const audioInput: AudioInput = {
+        type: "base64",
+        data: audioBase64,
+        mimeType,
+      };
+
+      let transcription: string;
+      try {
+        transcription = await voiceService.transcribe(audioInput, session.stt_model);
+      } catch (transcribeError) {
+        return {
+          ok: false,
+          error: `Error de transcripción: ${(transcribeError as Error).message}`,
+        };
+      }
+
+      const seqResult = db
+        .query(
+          `SELECT COALESCE(MAX(seq) + 1, 0) as next_seq FROM meeting_segments WHERE session_id = ?`
+        )
+        .get(sessionId) as { next_seq: number };
+
+      const seq = seqResult.next_seq;
+
+      db.query(
+        `INSERT INTO meeting_segments (session_id, seq, speaker, text, duration_ms)
+         VALUES (?, ?, ?, ?, NULL)`
+      ).run(sessionId, seq, speaker, transcription);
+
+      log.info(`Segment ${seq} added to session ${sessionId}: "${transcription.substring(0, 60)}..."`);
+
+      return {
+        ok: true,
+        seq,
+        speaker: speaker || null,
+        text: transcription,
+        message: speaker ? `[${speaker}]: ${transcription}` : transcription,
+      };
+    } catch (error) {
+      log.error(`meeting_add_segment error: ${(error as Error).message}`);
+      return {
+        ok: false,
+        error: `Error al agregar segmento: ${(error as Error).message}`,
+      };
+    }
+  },
+};
+
+// ─── meeting_stop ────────────────────────────────────────────────────────────
+
+export const meetingStopTool: Tool = {
+  name: "meeting_stop",
+  description:
+    "Detiene una sesión de transcripción de reunión. | Stop an active meeting transcription session.",
+  parameters: {
+    type: "object",
+    properties: {
+      session_id: {
+        type: "string",
+        description: "ID de la sesión de reunión a detener",
+      },
+    },
+    required: ["session_id"],
+  },
+  execute: async (params) => {
+    const sessionId = params.session_id as string;
+
+    try {
+      const db = getDb();
+
+      const session = db
+        .query(`SELECT id, title, status FROM meeting_sessions WHERE id = ?`)
+        .get(sessionId) as { id: string; title: string; status: string } | undefined;
+
+      if (!session) {
+        return { ok: false, error: `Sesión ${sessionId} no encontrada.` };
+      }
+      if (session.status === "stopped" || session.status === "report_ready") {
+        return {
+          ok: true,
+          session_id: sessionId,
+          message: `La sesión ya estaba detenida (status: ${session.status}).`,
+        };
+      }
+
+      db.query(
+        `UPDATE meeting_sessions SET status = 'stopped', stopped_at = unixepoch() WHERE id = ?`
+      ).run(sessionId);
+
+      const countResult = db
+        .query(`SELECT COUNT(*) as count FROM meeting_segments WHERE session_id = ?`)
+        .get(sessionId) as { count: number };
+
+      log.info(`Meeting session stopped: ${sessionId} — ${countResult.count} segments`);
+
+      return {
+        ok: true,
+        session_id: sessionId,
+        title: session.title,
+        segment_count: countResult.count,
+        message: `⏹️ Sesión "${session.title}" detenida.\n${countResult.count} segmentos transcritos.\n\nPuedes pedir el reporte con: "Genera el reporte de la reunión ${sessionId}"`,
+      };
+    } catch (error) {
+      log.error(`meeting_stop error: ${(error as Error).message}`);
+      return { ok: false, error: `Error al detener la sesión: ${(error as Error).message}` };
+    }
+  },
+};
+
+// ─── meeting_report ──────────────────────────────────────────────────────────
+
+export const meetingReportTool: Tool = {
+  name: "meeting_report",
+  description:
+    "Obtiene el transcript completo de una sesión de reunión para que el agente genere el informe gerencial. | Get the full transcript of a meeting session so the agent can generate the managerial report.",
+  parameters: {
+    type: "object",
+    properties: {
+      session_id: {
+        type: "string",
+        description: "ID de la sesión de reunión",
+      },
+    },
+    required: ["session_id"],
+  },
+  execute: async (params) => {
+    const sessionId = params.session_id as string;
+
+    try {
+      const db = getDb();
+
+      const session = db
+        .query(
+          `SELECT id, title, status, stt_model, started_at, stopped_at
+           FROM meeting_sessions WHERE id = ?`
+        )
+        .get(sessionId) as {
+        id: string;
+        title: string;
+        status: string;
+        stt_model: string;
+        started_at: number;
+        stopped_at: number | null;
+      } | undefined;
+
+      if (!session) {
+        return { ok: false, error: `Sesión ${sessionId} no encontrada.` };
+      }
+
+      const segments = db
+        .query(
+          `SELECT seq, speaker, text, created_at
+           FROM meeting_segments WHERE session_id = ?
+           ORDER BY seq ASC`
+        )
+        .all(sessionId) as {
+        seq: number;
+        speaker: string | null;
+        text: string;
+        created_at: number;
+      }[];
+
+      if (segments.length === 0) {
+        return {
+          ok: false,
+          error: "La sesión no tiene segmentos transcritos. No se puede generar el reporte.",
+        };
+      }
+
+      const transcript = segments
+        .map((s) => (s.speaker ? `[${s.speaker}]: ${s.text}` : s.text))
+        .join("\n");
+
+      const durationSec = session.stopped_at
+        ? session.stopped_at - session.started_at
+        : Math.floor(Date.now() / 1000) - session.started_at;
+      const durationMin = Math.floor(durationSec / 60);
+      const durationSecRem = durationSec % 60;
+
+      return {
+        ok: true,
+        session_id: session.id,
+        title: session.title,
+        status: session.status,
+        duration: `${durationMin}m ${durationSecRem}s`,
+        segment_count: segments.length,
+        transcript,
+        instructions: `Con el transcript anterior, genera un INFORME GERENCIAL en español con estas secciones:
+
+## Informe de Reunión: ${session.title}
+
+### 1. Resumen Ejecutivo
+(3-5 oraciones que capturen la esencia de la reunión)
+
+### 2. Participantes Detectados
+(Lista de nombres o roles mencionados en el transcript)
+
+### 3. Decisiones Tomadas
+(Lista numerada de cada decisión concreta)
+
+### 4. Action Items
+| Qué | Quién | Cuándo |
+|-----|-------|--------|
+(Tabla con todas las tareas asignadas)
+
+### 5. Próximos Pasos
+(Lista de acciones inmediatas)
+
+### 6. Temas de Seguimiento
+(Puntos que quedaron pendientes o requieren más discusión)
+
+Luego llama a office_escribir_docx para guardar el reporte como documento Word.`,
+      };
+    } catch (error) {
+      log.error(`meeting_report error: ${(error as Error).message}`);
+      return {
+        ok: false,
+        error: `Error al obtener el reporte: ${(error as Error).message}`,
+      };
+    }
+  },
+};
+
+// ─── Registry ────────────────────────────────────────────────────────────────
+
+export function createTools(): Tool[] {
+  return [
+    meetingStartTool,
+    meetingAddSegmentTool,
+    meetingStopTool,
+    meetingReportTool,
+  ];
+}

package/packages/core/src/tools/office/index.ts

@@ -0,0 +1,47 @@
+/**
+ * Office Tools - 8 tools para manejo de archivos Office
+ *
+ * @category office
+ *
+ * Herramientas:
+ * - office_leer_pdf     — Leer PDF y extraer texto + metadata
+ * - office_escribir_pdf — Generar PDF desde texto
+ * - office_leer_docx    — Leer Word (.docx) y extraer texto
+ * - office_escribir_docx — Generar Word (.docx) con párrafos y tablas
+ * - office_leer_xlsx    — Leer Excel (.xlsx) como JSON
+ * - office_escribir_xlsx — Generar Excel (.xlsx) desde JSON
+ * - office_leer_pptx    — Leer PowerPoint (.pptx) y extraer texto por slide
+ * - office_escribir_pptx — Generar PowerPoint (.pptx) desde array de slides
+ */
+
+import type { Tool } from "../types.ts";
+import { officeLeerPdfTool } from "./office-leer-pdf.ts";
+import { officeEscribirPdfTool } from "./office-escribir-pdf.ts";
+import { officeLeerDocxTool } from "./office-leer-docx.ts";
+import { officeEscribirDocxTool } from "./office-escribir-docx.ts";
+import { officeLeerXlsxTool } from "./office-leer-xlsx.ts";
+import { officeEscribirXlsxTool } from "./office-escribir-xlsx.ts";
+import { officeLeerPptxTool } from "./office-leer-pptx.ts";
+import { officeEscribirPptxTool } from "./office-escribir-pptx.ts";
+
+export function createTools(): Tool[] {
+  return [
+    officeLeerPdfTool,
+    officeEscribirPdfTool,
+    officeLeerDocxTool,
+    officeEscribirDocxTool,
+    officeLeerXlsxTool,
+    officeEscribirXlsxTool,
+    officeLeerPptxTool,
+    officeEscribirPptxTool,
+  ];
+}
+
+export * from "./office-leer-pdf.ts";
+export * from "./office-escribir-pdf.ts";
+export * from "./office-leer-docx.ts";
+export * from "./office-escribir-docx.ts";
+export * from "./office-leer-xlsx.ts";
+export * from "./office-escribir-xlsx.ts";
+export * from "./office-leer-pptx.ts";
+export * from "./office-escribir-pptx.ts";