@johpaz/hive-agents 0.0.34 → 0.0.36

package/packages/skills/src/bundled/meeting/meeting_transcription/SKILL.md

@@ -0,0 +1,213 @@
+---
+name: meeting_transcription
+description: "Transcribir reuniones en tiempo real y generar informes gerenciales con decisiones, action items y próximos pasos"
+version: 1.0.0
+author: Hive Team
+icon: "🎙️📋"
+category: meeting
+permissions:
+  - meeting_start
+  - meeting_add_segment
+  - meeting_stop
+  - meeting_report
+  - office_escribir_docx
+  - notify
+  - report_progress
+dependencies: []
+tools:
+  - meeting_start
+  - meeting_add_segment
+  - meeting_stop
+  - meeting_report
+  - office_escribir_docx
+  - notify
+  - report_progress
+
+triggers:
+  - "transcribir reunión"
+  - "iniciar transcripción"
+  - "meeting transcription"
+  - "grabar reunión"
+  - "iniciar reunión"
+  - "start meeting"
+  - "detener reunión"
+  - "stop meeting"
+  - "reporte de reunión"
+  - "generar reporte reunión"
+  - "informe de reunión"
+  - "acta de reunión"
+  - "transcripción de reunión"
+  - "meeting report"
+
+preferred_agents: []
+
+steps:
+  - step: 1
+    action: meeting_start
+    instruction: "Preguntar el título de la reunión si no fue indicado. Luego iniciar la sesión con meeting_start y comunicar el session_id al usuario."
+    params:
+      title: "Título indicado por el usuario"
+      stt_model: "whisper-large-v3-turbo"
+    output: session_id
+
+  - step: 2
+    action: meeting_add_segment
+    instruction: "Por cada audio recibido del usuario, llamar meeting_add_segment con el session_id activo. Mostrar la transcripción en tiempo real con notify."
+    params:
+      session_id: "<session_id del paso 1>"
+      audio_base64: "<audio del usuario>"
+    output: transcript_segment
+
+  - step: 3
+    action: meeting_stop
+    instruction: "Cuando el usuario indique que terminó la reunión, llamar meeting_stop con el session_id activo."
+    params:
+      session_id: "<session_id activo>"
+    output: session_stopped
+
+  - step: 4
+    action: meeting_report
+    instruction: "Obtener el transcript completo de la reunión para análisis."
+    params:
+      session_id: "<session_id>"
+    output: transcript_data
+
+  - step: 5
+    action: llm_analysis
+    instruction: |
+      Analiza el transcript recibido y genera un INFORME GERENCIAL estructurado en español.
+      El informe debe tener EXACTAMENTE estas secciones:
+
+      ## Informe de Reunión: [Título]
+      **Fecha:** [fecha actual]
+      **Duración:** [duración]
+      **Segmentos transcritos:** [número]
+
+      ### 1. Resumen Ejecutivo
+      [3-5 oraciones que capturen la esencia y resultado 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 adoptada]
+
+      ### 4. Action Items
+      | Tarea | Responsable | Fecha límite |
+      |-------|-------------|--------------|
+      [Una fila por cada tarea o compromiso asumido]
+
+      ### 5. Próximos Pasos
+      [Lista de acciones inmediatas post-reunión]
+
+      ### 6. Temas de Seguimiento
+      [Puntos que quedaron pendientes o requieren más discusión]
+    output: report_markdown
+
+  - step: 6
+    action: office_escribir_docx
+    instruction: "Guardar el informe como documento Word en el workspace del usuario."
+    params:
+      ruta: "informe_reunion_<session_id>.docx"
+      titulo: "Informe de Reunión"
+      parrafos: "<secciones del reporte>"
+    output: docx_path
+
+  - step: 7
+    action: notify
+    instruction: "Enviar el informe Markdown completo al chat y confirmar que el DOCX fue guardado."
+    output: delivered
+
+rules:
+  - "Siempre confirmar el session_id activo antes de agregar segmentos"
+  - "Usar notify para mostrar cada transcripción en tiempo real al usuario"
+  - "Si no hay sesión activa al pedir un reporte, preguntar el session_id"
+  - "El informe debe estar 100% en español"
+  - "Las tablas de action items deben tener columnas: Tarea, Responsable, Fecha límite"
+  - "Para sesiones con más de 30 segmentos, incluir resumen por bloques de tiempo"
+  - "Si el transcript está vacío, informar al usuario y no generar el reporte"
+  - "Siempre entregar el informe tanto en chat (Markdown) como en archivo DOCX"
+
+output_format:
+  structure: markdown_and_docx
+  sections:
+    - "resumen_ejecutivo"
+    - "participantes"
+    - "decisiones"
+    - "action_items"
+    - "proximos_pasos"
+    - "seguimiento"
+
+examples:
+  - user_input: "transcribir reunión"
+    expected_behavior: "Preguntar título → meeting_start → confirmar sesión iniciada con ID"
+
+  - user_input: "detener reunión"
+    expected_behavior: "meeting_stop → informar cantidad de segmentos → ofrecer generar reporte"
+
+  - user_input: "genera el reporte de la reunión abc123"
+    expected_behavior: "meeting_report → análisis LLM → office_escribir_docx → notify con Markdown completo"
+
+  - user_input: "genera el informe de la reunión"
+    expected_behavior: "Si hay sesión activa o reciente, usar ese ID. Si no, preguntar el session_id."
+---
+
+# Meeting Transcription Skill
+
+## Cuándo se Activa
+
+Esta skill se activa para gestión completa del ciclo de vida de una reunión: inicio, transcripción en tiempo real, detención y generación de informe gerencial.
+
+## Herramientas Disponibles
+
+| Tool | Qué hace | Cuándo usarla |
+|------|----------|---------------|
+| `meeting_start` | Crea una sesión en DB → devuelve session_id | Al iniciar la reunión |
+| `meeting_add_segment` | Transcribe un chunk de audio y lo persiste | Por cada audio recibido |
+| `meeting_stop` | Marca la sesión como detenida | Cuando termina la reunión |
+| `meeting_report` | Lee todos los segmentos y arma el transcript | Para generar el reporte |
+| `office_escribir_docx` | Guarda el reporte como archivo Word | Al finalizar el análisis |
+| `notify` | Envía mensajes en tiempo real al canal | Para mostrar transcripciones y el reporte |
+| `report_progress` | Muestra progreso en barra | Durante transcripción larga |
+
+## Workflow Completo
+
+```
+Usuario: "transcribir reunión"
+  → Agente pregunta título
+  → meeting_start(title) → session_id: "abc123"
+  → Agente: "✅ Sesión abc123 iniciada. Habla cuando quieras."
+
+[Usuario graba audio en la UI]
+  → meeting_add_segment(session_id, audio_base64)
+  → notify: "[Speaker]: Texto transcrito..."
+
+Usuario: "detener reunión"
+  → meeting_stop(session_id)
+  → Agente: "⏹️ 47 segmentos transcritos. ¿Genero el reporte?"
+
+Usuario: "sí"
+  → meeting_report(session_id) → transcript completo
+  → LLM analiza → secciones estructuradas
+  → office_escribir_docx → informe_reunion_abc123.docx
+  → notify: [Markdown del informe completo]
+  → Agente: "✅ DOCX guardado en workspace."
+```
+
+## Formato del Informe Gerencial
+
+El informe generado incluye:
+
+1. **Resumen Ejecutivo** — Captura la esencia en 3-5 oraciones
+2. **Participantes** — Detectados automáticamente del transcript
+3. **Decisiones Tomadas** — Lista numerada de cada decisión
+4. **Action Items** — Tabla con Tarea / Responsable / Fecha
+5. **Próximos Pasos** — Acciones inmediatas
+6. **Temas de Seguimiento** — Pendientes para futuras reuniones
+
+## Consideraciones
+
+- El informe se entrega en dos formatos: **Markdown en chat** + **DOCX descargable**
+- El idioma del informe es siempre **español**
+- La latencia de transcripción es ~4s por chunk de 3s de audio (normal para Whisper)
+- El session_id debe conservarse durante toda la reunión

package/packages/skills/src/bundled/office/office_document_manager/SKILL.md

@@ -0,0 +1,262 @@
+---
+name: office_document_manager
+description: "Leer, crear y manipular archivos Office (PDF, Word, Excel, PowerPoint) desde el workspace"
+version: 1.0.0
+author: Hive Team
+icon: "📄"
+category: office
+permissions:
+  - filesystem_read
+  - filesystem_write
+dependencies: []
+tools:
+  - office_leer_pdf
+  - office_escribir_pdf
+  - office_leer_docx
+  - office_escribir_docx
+  - office_leer_xlsx
+  - office_escribir_xlsx
+  - office_leer_pptx
+  - office_escribir_pptx
+
+triggers:
+  - "leer pdf"
+  - "abrir pdf"
+  - "extraer texto de pdf"
+  - "pdf a texto"
+  - "crear pdf"
+  - "generar pdf"
+  - "exportar a pdf"
+  - "leer word"
+  - "abrir docx"
+  - "extraer texto de word"
+  - "crear word"
+  - "generar docx"
+  - "documento word"
+  - "leer excel"
+  - "abrir xlsx"
+  - "datos de excel"
+  - "crear excel"
+  - "generar xlsx"
+  - "exportar a excel"
+  - "leer powerpoint"
+  - "abrir pptx"
+  - "presentacion"
+  - "diapositivas"
+  - "crear presentacion"
+  - "generar pptx"
+  - "read pdf"
+  - "open pdf"
+  - "create pdf"
+  - "read excel"
+  - "create excel"
+  - "read word"
+  - "create word"
+  - "read powerpoint"
+  - "create presentation"
+
+preferred_agents: []
+
+steps:
+  - step: 1
+    action: office_leer_pdf
+    instruction: "Leer un archivo PDF y extraer su texto e información básica"
+    params:
+      ruta: "path/to/file.pdf"
+    output: pdf_content
+
+  - step: 2
+    action: office_escribir_pdf
+    instruction: "Generar un archivo PDF desde texto o contenido procesado"
+    params:
+      ruta: "path/to/output.pdf"
+      contenido: "texto a escribir"
+      titulo: "Título del documento"
+      tamaño_pagina: "A4"
+    output: pdf_created
+
+  - step: 3
+    action: office_leer_docx
+    instruction: "Leer un documento Word y extraer párrafos y tablas"
+    params:
+      ruta: "path/to/file.docx"
+      incluir_tablas: true
+    output: docx_content
+
+  - step: 4
+    action: office_escribir_docx
+    instruction: "Generar un documento Word con párrafos, títulos y tablas estructuradas"
+    params:
+      ruta: "path/to/output.docx"
+      titulo: "Título"
+      parrafos:
+        - texto: "Introducción"
+          tipo: "titulo1"
+        - texto: "Contenido del documento"
+          tipo: "parrafo"
+    output: docx_created
+
+  - step: 5
+    action: office_leer_xlsx
+    instruction: "Leer un archivo Excel y obtener los datos de cada hoja como JSON"
+    params:
+      ruta: "path/to/file.xlsx"
+      incluir_encabezados: true
+    output: xlsx_data
+
+  - step: 6
+    action: office_escribir_xlsx
+    instruction: "Generar un archivo Excel con múltiples hojas desde datos JSON"
+    params:
+      ruta: "path/to/output.xlsx"
+      hojas:
+        - nombre: "Hoja1"
+          datos:
+            - col1: "valor"
+              col2: "valor"
+    output: xlsx_created
+
+  - step: 7
+    action: office_leer_pptx
+    instruction: "Leer una presentación PowerPoint y extraer el texto de cada diapositiva"
+    params:
+      ruta: "path/to/file.pptx"
+    output: pptx_content
+
+  - step: 8
+    action: office_escribir_pptx
+    instruction: "Generar una presentación PowerPoint con título, viñetas y notas por diapositiva"
+    params:
+      ruta: "path/to/output.pptx"
+      titulo_presentacion: "Mi Presentación"
+      diapositivas:
+        - titulo: "Intro"
+          puntos:
+            - "Punto 1"
+            - "Punto 2"
+    output: pptx_created
+
+rules:
+  - "Usa office_leer_* para extraer contenido antes de generar una versión nueva"
+  - "Siempre confirma la ruta de salida con el usuario antes de sobrescribir un archivo existente"
+  - "Para PDFs grandes, usa pagina_inicio/pagina_fin para leer por secciones"
+  - "Para Excel, especifica el nombre de hoja con el parámetro 'hoja' si solo necesitas una"
+  - "Al escribir DOCX, usa 'tipo: titulo1/titulo2/titulo3' para crear jerarquía de encabezados"
+  - "Para presentaciones, usa 'puntos' en lugar de 'contenido' cuando el texto es una lista"
+  - "Usa fs_read/fs_exists antes de leer un office file para confirmar que la ruta existe"
+
+output_format:
+  structure: markdown
+  sections:
+    - "archivo"
+    - "contenido_extraido"
+    - "resultado"
+  max_length: "Truncar texto extraído a 2000 caracteres si es muy largo, con indicación de páginas/hojas restantes"
+
+examples:
+  - user_input: "lee el PDF en /documentos/informe.pdf y dime de qué trata"
+    expected_behavior: "office_leer_pdf({ ruta: '/documentos/informe.pdf' }) → resume el contenido extraído"
+
+  - user_input: "crea un PDF con el resumen de la reunión"
+    expected_behavior: "office_escribir_pdf({ ruta: 'resumen_reunion.pdf', contenido: '...', titulo: 'Resumen de Reunión' })"
+
+  - user_input: "pasa los datos del Excel a un formato que pueda entender"
+    expected_behavior: "office_leer_xlsx({ ruta: 'datos.xlsx' }) → retorna datos como JSON con estructura de hojas"
+
+  - user_input: "genera una presentación de 5 slides sobre machine learning"
+    expected_behavior: "office_escribir_pptx({ ruta: 'ml_intro.pptx', titulo_presentacion: 'Introducción a ML', diapositivas: [...] })"
+
+  - user_input: "extrae el texto del contrato en Word"
+    expected_behavior: "office_leer_docx({ ruta: 'contrato.docx', incluir_tablas: true }) → retorna texto plano con tablas"
+---
+
+# Office Document Manager Skill
+
+## Cuándo se Activa
+
+Esta skill se activa cuando el usuario necesita:
+- **Leer** archivos PDF, Word (.docx), Excel (.xlsx) o PowerPoint (.pptx)
+- **Generar** nuevos archivos en cualquiera de esos formatos
+- **Convertir** contenido entre formatos (ej: texto → PDF, JSON → Excel)
+- **Extraer** datos estructurados de documentos (tablas de Excel, slides de presentación)
+
+## Herramientas Disponibles
+
+| Tool | Qué hace | Cuándo usarla |
+|------|----------|---------------|
+| `office_leer_pdf` | Extrae texto + metadata de PDF | Leer informes, contratos, libros en PDF |
+| `office_escribir_pdf` | Genera PDF desde texto | Crear reportes, resúmenes, documentación |
+| `office_leer_docx` | Extrae texto y tablas de Word | Leer documentos, contratos, informes Word |
+| `office_escribir_docx` | Genera Word con estructura | Crear documentos formales con títulos/tablas |
+| `office_leer_xlsx` | Lee hojas de Excel como JSON | Procesar datos, tablas, inventarios |
+| `office_escribir_xlsx` | Genera Excel desde JSON | Exportar datos, crear reportes tabulares |
+| `office_leer_pptx` | Extrae texto de cada slide | Resumir presentaciones, extraer contenido |
+| `office_escribir_pptx` | Genera presentación PowerPoint | Crear slides desde datos o resúmenes |
+
+## Workflow por Caso de Uso
+
+### Leer y resumir un documento
+1. `office_leer_pdf/docx/xlsx/pptx` → extraer contenido
+2. Procesar y resumir el texto
+3. `notify` → enviar resumen al usuario
+
+### Transformar datos a Excel
+1. Obtener datos (de memoria, herramienta o cálculo)
+2. Estructurar en `hojas` con `datos` como array de objetos
+3. `office_escribir_xlsx` → generar archivo
+4. Confirmar ruta al usuario
+
+### Crear un informe PDF
+1. Compilar el contenido del informe como texto
+2. `office_escribir_pdf` → generar con título y márgenes
+3. Confirmar que el archivo quedó en la ruta esperada
+
+### Generar una presentación
+1. Definir estructura: título + array de slides (título + puntos)
+2. `office_escribir_pptx` → generar .pptx
+3. Opcional: incluir notas del presentador en cada slide
+
+## Parámetros Clave
+
+### `parrafos` para DOCX
+```json
+[
+  { "texto": "Capítulo 1", "tipo": "titulo1" },
+  { "texto": "Subtítulo", "tipo": "titulo2" },
+  { "texto": "Contenido normal", "tipo": "parrafo" },
+  { "texto": "Ítem de lista", "tipo": "lista" },
+  { "texto": "Texto importante", "tipo": "parrafo", "negrita": true }
+]
+```
+
+### `hojas` para XLSX
+```json
+[
+  {
+    "nombre": "Ventas",
+    "datos": [
+      { "Mes": "Enero", "Total": 5000 },
+      { "Mes": "Febrero", "Total": 6200 }
+    ]
+  }
+]
+```
+
+### `diapositivas` para PPTX
+```json
+[
+  {
+    "titulo": "¿Qué es Machine Learning?",
+    "puntos": ["Subcampo de IA", "Aprende de datos", "Hace predicciones"],
+    "notas": "Mencionar el enfoque supervisado y no supervisado"
+  }
+]
+```
+
+## Errores a Evitar
+
+- ❌ Intentar leer un archivo que no existe (verifica con `fs_exists` primero)
+- ❌ Sobrescribir sin confirmar cuando el archivo destino ya existe
+- ❌ Usar `contenido` y `puntos` a la vez en PPTX — `puntos` tiene prioridad
+- ❌ Pasar un array de arrays como `datos` de XLSX cuando se esperan objetos con claves
+- ❌ Intentar leer PDF de más de 100 páginas sin especificar rango (usar `pagina_inicio`/`pagina_fin`)

package/packages/skills/src/bundled/search_knowledge/busqueda_fts5/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: busqueda_fts5
+description: "Core discovery skill - find any capability with a single keyword"
+version: 1.2.0
+author: Hive Team
+icon: "🔍"
+category: core
+permissions: []
+dependencies: []
+tools: [search_knowledge]
+
+triggers:
+  - cómo busco herramientas
+  - cómo encuentro skills
+  - how to find tools
+  - search knowledge
+  - discovery
+  - buscar en la base
+  - encontrar herramientas
+
+---
+
+# busqueda_fts5 — Sistema de Discovery
+
+Arrancás con solo 4 herramientas. Todo lo demás se descubre con **search_knowledge**.
+
+## Regla de oro: UNA PALABRA, busca TODO
+
+```
+search_knowledge(query="email")
+```
+
+Eso solo — sin type, sin frases largas — devuelve tools, skills, MCP y playbook relacionados con "email".
+
+**NO hagas esto:** `search_knowledge(type="tools", query="enviar correo electrónico")` — AND entre palabras no encuentra nada.
+
+**SÍ hagas esto:** `search_knowledge(query="email")` — encuentra todo lo relacionado.
+
+## Cuándo especificar type
+
+Solo si querés filtrar resultados que ya son muchos:
+
+```
+search_knowledge(query="email", type="mcp")   → solo herramientas externas de email
+search_knowledge(query="email", type="tools") → solo herramientas nativas de email
+```
+
+Por defecto type="all" — no hace falta especificarlo.
+
+## Regla de prioridad
+
+**Preferí herramientas nativas sobre MCP** cuando ambas sirven.
+- Nativas: más rápidas, sin red, siempre disponibles
+- MCP: cuando no hay equivalente nativo
+
+## Flujo de uso
+
+1. Identificá la palabra clave de lo que necesitás
+2. `search_knowledge(query="<palabra>")` → resultados de todos los tipos
+3. Las tools encontradas se inyectan automáticamente en tu contexto
+4. Usás las tools en el siguiente paso
+
+---
+
+## Ejemplos
+
+```
+search_knowledge(query="pdf")       → tools para leer/escribir PDFs
+search_knowledge(query="browser")   → tools de navegación web
+search_knowledge(query="github")    → tools MCP de GitHub si están configuradas
+search_knowledge(query="calendar")  → tools de Google Calendar
+search_knowledge(query="canvas")    → skills de visualización
+search_knowledge(query="slack")     → tools de Slack si están configuradas
+```