@johpaz/hive-sdk 0.1.4 → 0.1.5

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

@@ -1,342 +0,0 @@
-/**
- * CodeBridge Tools - 3 tools
- *
- * @category codebridge
- */
-
-import type { Tool } from "../types.ts";
-import { logger } from "../../utils/logger.ts";
-import { emitBridgeEvent } from "../bridge-events.ts";
-
-const log = logger.child("codebridge");
-const CODE_BRIDGE_PORT = parseInt(process.env.CODE_BRIDGE_PORT ?? "18791", 10);
-const CODE_BRIDGE_URL = `ws://localhost:${CODE_BRIDGE_PORT}/ws`;
-const CODE_BRIDGE_BASE = `http://localhost:${CODE_BRIDGE_PORT}`;
-
-// ─── codebridge_launch ───────────────────────────────────────────────────────
-
-export const codebridgeLaunchTool: Tool = {
-  name: "codebridge_launch",
-  description: "Launch an external coding CLI subagent (Claude Code, Qwen CLI, Gemini CLI, OpenCode CLI) to execute a coding task locally. Spanish: lanzar agente de código, iniciar Claude Code, Qwen CLI, Gemini CLI, OpenCode, subagente externo de programación",
-  parameters: {
-    type: "object",
-    properties: {
-      cli: {
-        type: "string",
-        enum: ["qwen", "claude", "opencode", "gemini"],
-        description: "CLI command to run (alias: agent)",
-      },
-      agent: {
-        type: "string",
-        enum: ["qwen", "claude", "opencode", "gemini"],
-        description: "Alias for cli (deprecated, use cli instead)",
-      },
-      prompt: {
-        type: "string",
-        description: "The prompt/task for the subagent",
-      },
-      role: {
-        type: "string",
-        enum: ["architecture", "development", "testing", "documentation"],
-        description: "Role of the subagent",
-      },
-      timeoutSeconds: {
-        type: "number",
-        description: "Timeout in seconds (default: 600)",
-      },
-    },
-    required: ["prompt"],
-  },
-  execute: async (params: Record<string, unknown>) => {
-    // Support both 'cli' and 'agent' (deprecated alias)
-    const cli = (params.cli as string) ?? (params.agent as string);
-    const prompt = params.prompt as string;
-    const role = (params.role as string) ?? "development";
-    const timeoutSeconds = (params.timeoutSeconds as number) ?? 600;
-
-    if (!cli) {
-      log.error(`[codebridge_launch] ❌ Error: falta parámetro 'cli' o 'agent'`);
-      return {
-        ok: false,
-        error: "Missing required parameter: 'cli' or 'agent'. Use: codebridge_launch({ cli: 'qwen', prompt: '...' })",
-      };
-    }
-
-    if (!prompt) {
-      log.error(`[codebridge_launch] ❌ Error: falta parámetro 'prompt'`);
-      return {
-        ok: false,
-        error: "Missing required parameter: 'prompt'. Use: codebridge_launch({ cli: 'qwen', prompt: '...' })",
-      };
-    }
-
-    log.info(`[codebridge_launch] Iniciando subagente ${cli} para rol: ${role}`);
-    log.info(`[codebridge_launch] Code Bridge URL: ${CODE_BRIDGE_URL}`);
-    log.info(`[codebridge_launch] Code Bridge Base: ${CODE_BRIDGE_BASE}`);
-
-    try {
-      // Check if Code Bridge is available
-      log.info(`[codebridge_launch] Verificando disponibilidad de Code Bridge...`);
-      const controller = new AbortController();
-      const timeout = setTimeout(() => controller.abort(), 1000);
-      const response = await fetch(`${CODE_BRIDGE_BASE}/health`, { signal: controller.signal });
-      clearTimeout(timeout);
-
-      if (!response.ok) {
-        log.error(`[codebridge_launch] Code Bridge respondió con estado ${response.status}`);
-        return {
-          ok: false,
-          error: "Code Bridge not available. Start with: bun run packages/code-bridge/src/index.ts",
-        };
-      }
-
-      log.info(`[codebridge_launch] ✅ Code Bridge disponible`);
-
-      // Launch via WebSocket
-      log.info(`[codebridge_launch] Conectando WebSocket a ${CODE_BRIDGE_URL}...`);
-      const ws = new WebSocket(CODE_BRIDGE_URL);
-      const taskId = `task_${Date.now()}`;
-      log.info(`[codebridge_launch] Task ID generado: ${taskId}`);
-
-      return new Promise((resolve) => {
-        let resolved = false;
-        let timeoutHandle: ReturnType<typeof setTimeout>;
-
-        const done = () => {
-          clearTimeout(timeoutHandle);
-          ws.close();
-        };
-
-        ws.onopen = () => {
-          log.info(`[codebridge_launch] ✅ WebSocket conectado`);
-          log.info(`[codebridge_launch] Enviando comando launch para task ${taskId}...`);
-          log.info(`[codebridge_launch] Parámetros: cli=${cli}, prompt=${prompt?.substring(0, 50)}..., role=${role}, timeout=${timeoutSeconds}`);
-          
-          const launchCmd = {
-            cmd: "launch",
-            taskId,
-            config: { role, cli, timeoutSeconds },
-            prompt,
-          };
-          
-          log.info(`[codebridge_launch] Comando JSON: ${JSON.stringify(launchCmd, null, 2).substring(0, 200)}...`);
-          ws.send(JSON.stringify(launchCmd));
-        };
-
-        ws.onmessage = (event) => {
-          let data: any;
-          try { data = JSON.parse(event.data as string); } catch { return; }
-
-          log.info(`[codebridge_launch] 📩 WebSocket message: ${data.type}`, data.taskId ? `task: ${data.taskId}` : "");
-
-          if (data.type === "ack" && !resolved) {
-            resolved = true;
-            clearTimeout(timeoutHandle);
-            log.info(`[codebridge_launch] ✅ Launch ACK recibido - PID: ${data.pid}`);
-            emitBridgeEvent({ type: "bridge:cmd_start", data: { processId: taskId, command: cli, name: role } });
-            resolve({
-              ok: true,
-              taskId,
-              pid: data.pid,
-              message: `Launched ${cli} with PID ${data.pid}`,
-            });
-            // Keep WS open to relay subsequent events
-            return;
-          }
-
-          if (data.taskId !== taskId) return;
-
-          if (data.type === "agent:output") {
-            emitBridgeEvent({ type: "bridge:cmd_output", data: { processId: taskId, chunk: data.chunk, stream: data.stream ?? "stdout" } });
-          } else if (data.type === "agent:finished") {
-            log.info(`[codebridge_launch] ✅ Agente finalizado - Exit code: ${data.exitCode ?? 0}`);
-            emitBridgeEvent({ type: "bridge:cmd_done", data: { processId: taskId, exitCode: data.exitCode ?? 0, success: true } });
-            done();
-          } else if (data.type === "agent:error") {
-            log.error(`[codebridge_launch] ❌ Error del agente: ${data.message}`);
-            emitBridgeEvent({ type: "bridge:cmd_error", data: { processId: taskId, message: data.message } });
-            done();
-          } else if (data.type === "agent:cancelled") {
-            log.warn(`[codebridge_launch] ⚠️ Agente cancelado`);
-            emitBridgeEvent({ type: "bridge:cmd_done", data: { processId: taskId, exitCode: -1, success: false } });
-            done();
-          }
-        };
-
-        ws.onerror = () => {
-          log.error(`[codebridge_launch] ❌ Error de WebSocket`);
-          if (!resolved) {
-            resolved = true;
-            clearTimeout(timeoutHandle);
-            resolve({ ok: false, error: "Failed to connect to Code Bridge" });
-          }
-        };
-
-        timeoutHandle = setTimeout(() => {
-          if (!resolved) {
-            log.error(`[codebridge_launch] ⏱️ Timeout esperando respuesta de Code Bridge`);
-            resolved = true;
-            ws.close();
-            resolve({ ok: false, error: "Timeout connecting to Code Bridge" });
-          }
-        }, 5000);
-      });
-    } catch (error) {
-      log.error(`[codebridge_launch] ❌ Error fatal: ${(error as Error).message}`);
-      return {
-        ok: false,
-        error: `Failed to launch: ${(error as Error).message}`,
-      };
-    }
-  },
-};
-
-// ─── codebridge_status ───────────────────────────────────────────────────────
-
-export const codebridgeStatusTool: Tool = {
-  name: "codebridge_status",
-  description: "Check the status and output of a running CodeBridge subagent. Spanish: estado agente de código, verificar Claude Code, progreso subagente externo",
-  parameters: {
-    type: "object",
-    properties: {
-      taskId: {
-        type: "string",
-        description: "Task ID to check status for",
-      },
-    },
-    required: ["taskId"],
-  },
-  execute: async (params: Record<string, unknown>) => {
-    const taskId = params.taskId as string;
-
-    try {
-      const response = await fetch(`${CODE_BRIDGE_BASE}/status/${taskId}`);
-
-      if (!response.ok) {
-        return { ok: false, error: `Task not found: ${taskId}` };
-      }
-
-      const data = await response.json();
-      return { ok: true, ...data };
-    } catch (error) {
-      return {
-        ok: false,
-        error: `Failed to get status: ${(error as Error).message}`,
-      };
-    }
-  },
-};
-
-// ─── codebridge_cancel ───────────────────────────────────────────────────────
-
-export const codebridgeCancelTool: Tool = {
-  name: "codebridge_cancel",
-  description: "Cancel and terminate a running CodeBridge subagent process. Spanish: cancelar agente de código, detener Claude Code, terminar subagente externo",
-  parameters: {
-    type: "object",
-    properties: {
-      taskId: {
-        type: "string",
-        description: "Task ID to cancel",
-      },
-    },
-    required: ["taskId"],
-  },
-  execute: async (params: Record<string, unknown>) => {
-    const taskId = params.taskId as string;
-
-    try {
-      const response = await fetch(`${CODE_BRIDGE_BASE}/cancel/${taskId}`, { method: "POST" });
-
-      if (!response.ok) {
-        return { ok: false, error: `Failed to cancel: ${taskId}` };
-      }
-
-      return { ok: true, taskId, message: "Task cancelled." };
-    } catch (error) {
-      return {
-        ok: false,
-        error: `Failed to cancel: ${(error as Error).message}`,
-      };
-    }
-  },
-};
-
-// ─── codebridge_feedback ───────────────────────────────────────────────────────
-
-export const codebridgeFeedbackTool: Tool = {
-  name: "codebridge_feedback",
-  description: "Send feedback or additional instructions to a running CodeBridge subagent. Use for course correction, clarifications, or iterative improvements during long-running code tasks. Spanish: enviar feedback, corregir rumbo, aclaraciones, mejoras iterativas",
-  parameters: {
-    type: "object",
-    properties: {
-      taskId: {
-        type: "string",
-        description: "Task ID to send feedback to",
-      },
-      feedback: {
-        type: "string",
-        description: "Feedback message or additional instructions for the running agent",
-      },
-    },
-    required: ["taskId", "feedback"],
-  },
-  execute: async (params: Record<string, unknown>) => {
-    const taskId = params.taskId as string;
-    const feedback = params.feedback as string;
-
-    try {
-      const ws = new WebSocket(CODE_BRIDGE_URL);
-      
-      return new Promise((resolve) => {
-        ws.onopen = () => {
-          ws.send(JSON.stringify({
-            cmd: "feedback",
-            taskId,
-            feedback,
-          }));
-        };
-
-        ws.onmessage = (event) => {
-          try {
-            const data = JSON.parse(event.data);
-            if (data.type === "feedback:ack") {
-              resolve({
-                ok: data.delivered,
-                taskId,
-                delivered: data.delivered,
-                reason: data.reason,
-                message: data.delivered 
-                  ? "Feedback delivered to running agent" 
-                  : `Feedback not delivered: ${data.reason}`,
-              });
-            }
-          } catch {
-            resolve({ ok: false, error: "Failed to parse feedback response" });
-          }
-          ws.close();
-        };
-
-        ws.onerror = () => {
-          resolve({ ok: false, error: "WebSocket error" });
-          ws.close();
-        };
-
-        // Timeout after 5 seconds
-        setTimeout(() => {
-          resolve({ ok: false, error: "Feedback timeout" });
-          ws.close();
-        }, 5000);
-      });
-    } catch (error) {
-      return {
-        ok: false,
-        error: `Failed to send feedback: ${(error as Error).message}`,
-      };
-    }
-  },
-};
-
-export function createTools(): Tool[] {
-  return [codebridgeLaunchTool, codebridgeStatusTool, codebridgeCancelTool, codebridgeFeedbackTool];
-}

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

@@ -1,353 +0,0 @@
-/**
- * Meeting Tools - 4 tools para transcripción de reuniones
- *
- * @category meeting
- */
-
-import type { Tool } from "../types.ts";
-import { getHiveDB } from "../../storage/HiveDBStorage.ts";
-import { voiceService, type AudioInput } from "../../voice/index.ts";
-import { logger } from "../../utils/logger.ts";
-
-const log = logger.child("meeting");
-
-interface MeetingSession {
-  id: string;
-  title: string;
-  status: string;
-  sttModel: string;
-  startedAt: number;
-  stoppedAt?: number;
-}
-
-interface MeetingSegment {
-  sessionId: string;
-  seq: number;
-  speaker?: string;
-  text: string;
-  durationMs?: number;
-  createdAt: number;
-}
-
-// ─── 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 = await getHiveDB();
-      const sessionsCol = db.collection<MeetingSession>("meeting_sessions");
-      const id = crypto.randomUUID();
-      const session: MeetingSession = {
-        id,
-        title,
-        status: "active",
-        sttModel,
-        startedAt: Math.floor(Date.now() / 1000),
-      };
-      await sessionsCol.put(id, session);
-
-      log.info(`Meeting session started: ${id} — "${title}"`);
-
-      return {
-        ok: true,
-        session_id: id,
-        title,
-        status: session.status,
-        stt_model: sttModel,
-        message: `✅ Sesión de reunión iniciada. ID: ${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) || undefined;
-    const mimeType = (params.mime_type as string) || "audio/webm";
-
-    try {
-      const db = await getHiveDB();
-      const sessionsCol = db.collection<MeetingSession>("meeting_sessions");
-      const segmentsCol = db.collection<MeetingSegment>("meeting_segments");
-
-      const sessionEntry = await sessionsCol.get(sessionId);
-      if (!sessionEntry) {
-        return { ok: false, error: `Sesión ${sessionId} no encontrada.` };
-      }
-      const session = sessionEntry.doc;
-      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.sttModel);
-      } catch (transcribeError) {
-        return {
-          ok: false,
-          error: `Error de transcripción: ${(transcribeError as Error).message}`,
-        };
-      }
-
-      const entries = await segmentsCol.scan();
-      const seq = entries
-        .filter(e => e.doc.sessionId === sessionId)
-        .reduce((max, e) => Math.max(max, e.doc.seq), -1) + 1;
-
-      const segmentId = `${sessionId}:${seq}`;
-      await segmentsCol.put(segmentId, {
-        sessionId,
-        seq,
-        speaker,
-        text: transcription,
-        createdAt: Math.floor(Date.now() / 1000),
-      });
-
-      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 = await getHiveDB();
-      const sessionsCol = db.collection<MeetingSession>("meeting_sessions");
-      const segmentsCol = db.collection<MeetingSegment>("meeting_segments");
-
-      const sessionEntry = await sessionsCol.get(sessionId);
-      if (!sessionEntry) {
-        return { ok: false, error: `Sesión ${sessionId} no encontrada.` };
-      }
-      const session = sessionEntry.doc;
-      if (session.status === "stopped" || session.status === "report_ready") {
-        return {
-          ok: true,
-          session_id: sessionId,
-          message: `La sesión ya estaba detenida (status: ${session.status}).`,
-        };
-      }
-
-      const stoppedAt = Math.floor(Date.now() / 1000);
-      await sessionsCol.put(sessionId, { ...session, status: "stopped", stoppedAt });
-
-      const entries = await segmentsCol.scan();
-      const count = entries.filter(e => e.doc.sessionId === sessionId).length;
-
-      log.info(`Meeting session stopped: ${sessionId} — ${count} segments`);
-
-      return {
-        ok: true,
-        session_id: sessionId,
-        title: session.title,
-        segment_count: count,
-        message: `⏹️ Sesión "${session.title}" detenida.\n${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 = await getHiveDB();
-      const sessionsCol = db.collection<MeetingSession>("meeting_sessions");
-      const segmentsCol = db.collection<MeetingSegment>("meeting_segments");
-
-      const sessionEntry = await sessionsCol.get(sessionId);
-      if (!sessionEntry) {
-        return { ok: false, error: `Sesión ${sessionId} no encontrada.` };
-      }
-      const session = sessionEntry.doc;
-
-      const entries = await segmentsCol.scan();
-      const segments = entries
-        .filter(e => e.doc.sessionId === sessionId)
-        .map(e => e.doc)
-        .sort((a, b) => a.seq - b.seq);
-
-      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.stoppedAt
-        ? session.stoppedAt - session.startedAt
-        : Math.floor(Date.now() / 1000) - session.startedAt;
-      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,
-  ];
-}