@johpaz/hive-sdk 0.1.3 → 0.1.5

package/packages/core/src/skills/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/core/src/skills/bundled/search_knowledge/capability_discovery/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: capability_discovery
+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
+
+---
+
+# capability_discovery — Sistema de Discovery
+
+Arrancás con 7 herramientas esenciales. 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".
+
+**Evitá esto:** `search_knowledge(type="tools", query="enviar correo electrónico")` — el motor rankea por relevancia (BM25), así que una frase larga no falla, pero diluye el resultado: cada palabra de más sesga el ranking hacia coincidencias parciales y mezcla resultados menos relevantes.
+
+**Preferí esto:** `search_knowledge(query="email")` — una palabra precisa da el resultado más ajustado y 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. Cada resultado MCP incluye `server_id`; usalo para identificar la integración y buscar un especialista existente
+4. Antes del primer uso de un servidor sin especialista, seguí el flujo de consentimiento del system prompt
+5. Las tools encontradas se inyectan automáticamente en tu contexto para una ejecución directa solo cuando corresponda
+
+---
+
+## 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="A2UI")      → skills del panel interactivo
+search_knowledge(query="slack")     → tools de Slack si están configuradas
+```

package/packages/core/src/skills/bundled/web/browser_automate/SKILL.md

@@ -0,0 +1,120 @@
+---
+name: browser_automate
+description: "Automate web workflows with navigation, clicks, form filling, and visual verification"
+version: 1.0.0
+author: Hive Team
+icon: "🤖"
+category: web
+permissions:
+  - browser_control
+dependencies: []
+tools: [browser_navigate, browser_click, browser_type, browser_screenshot]
+
+# Structured skill fields
+triggers:
+  - "automatizá el navegador"
+  - "automate browser"
+  - "completá el formulario"
+  - "fill form"
+  - "hacé clic en"
+  - "click on"
+  - "iniciá sesión"
+  - "login"
+  - "registrate"
+  - "sign up"
+  - "interactuá con la web"
+  - "interact with website"
+  - "flujo web"
+  - "web workflow"
+
+preferred_agents: []
+
+steps:
+  - step: 1
+    action: browser_navigate
+    instruction: "Navigate to target URL and wait for page to fully load"
+    params:
+      url: "target URL"
+    output: page_loaded
+
+  - step: 2
+    action: browser_click
+    instruction: "Click on elements (buttons, links) to navigate or trigger actions"
+    params:
+      selector: "CSS selector for element"
+    output: click_result
+
+  - step: 3
+    action: browser_type
+    instruction: "Type text into form fields (inputs, textareas)"
+    params:
+      selector: "CSS selector for input"
+      text: "text to type"
+    output: type_result
+
+  - step: 4
+    action: browser_screenshot
+    instruction: "Take screenshot to verify state after interactions"
+    output: verification_screenshot
+
+rules:
+  - "Wait for page to fully load after each navigation or significant interaction"
+  - "Use specific, stable CSS selectors (IDs preferred over classes)"
+  - "Take screenshots after critical steps for verification"
+  - "Handle errors gracefully — element may not exist or be interactable"
+  - "For multi-step flows, verify state after each step before proceeding"
+
+output_format:
+  structure: markdown
+  sections:
+    - "workflow_steps"
+    - "final_state"
+    - "screenshot_path"
+  max_length: "Summary of automation flow"
+
+examples:
+  - user_input: "automatizá el login en example.com"
+    expected_behavior: "Navigate → type credentials → click submit → screenshot verification"
+
+  - user_input: "completá el formulario de contacto"
+    expected_behavior: "Navigate → type name/email/message → click submit → verify submission"
+
+  - user_input: "hacé clic en todos los enlaces del menú"
+    expected_behavior: "Navigate → click each menu item → screenshot each page"
+---
+
+# Browser Automate Skill
+
+## Cuándo se Activa
+
+Esta skill se activa para automatizar flujos de interacción con aplicaciones web: logins, formularios, navegación programática.
+
+## Herramientas Disponibles
+
+| Tool | Qué hace | Cuándo usarla |
+|------|----------|---------------|
+| `browser_navigate` | Navega a URL | Inicio de flujo |
+| `browser_click` | Click en elementos | Botones, enlaces, triggers |
+| `browser_type` | Escribe en inputs | Formularios, búsquedas |
+| `browser_screenshot` | Captura estado | Verificación visual |
+
+## Workflow Típico
+
+1. **Navegar** → URL inicial
+2. **Interactuar** → click/type según flujo
+3. **Verificar** → screenshot después de acciones críticas
+4. **Repetir** → para flujos multi-paso
+
+## Mejores Prácticas
+
+- Selectores estables (IDs > classes > XPath)
+- Esperar carga después de navegación
+- Verificar estado visual con screenshots
+- Manejar errores de elementos no encontrados
+
+## Errores a Evitar
+
+- ❌ Selectores frágiles que cambian
+- ❌ No esperar carga de página
+- ❌ Ignorar errores de elementos
+- ❌ No verificar estado después de acciones

package/packages/core/src/skills/bundled/web/browser_scrape/SKILL.md

@@ -0,0 +1,109 @@
+---
+name: browser_scrape
+description: "Navigate to web pages and capture rendered content including screenshots for dynamic sites"
+version: 1.0.0
+author: Hive Team
+icon: "📸"
+category: web
+permissions:
+  - browser_control
+dependencies: []
+tools: [browser_navigate, browser_screenshot, web_fetch]
+
+# Structured skill fields
+triggers:
+  - "capturá el contenido"
+  - "scrape content"
+  - "obtené la página renderizada"
+  - "get rendered page"
+  - "sitios dinámicos"
+  - "dynamic sites"
+  - "web con javascript"
+  - "javascript websites"
+  - "tomá screenshot y contenido"
+  - "screenshot and content"
+
+preferred_agents: []
+
+steps:
+  - step: 1
+    action: browser_navigate
+    instruction: "Navigate to URL and wait for full page load including JavaScript rendering"
+    params:
+      url: "target URL"
+    output: page_loaded
+
+  - step: 2
+    action: browser_screenshot
+    instruction: "Take screenshot to capture visual state of rendered page"
+    output: screenshot
+
+  - step: 3
+    action: web_fetch
+    instruction: "Extract text content from rendered page as markdown"
+    output: extracted_content
+
+  - step: 4
+    action: synthesize
+    instruction: "Combine screenshot and text content for comprehensive capture"
+    output: scraped_data
+
+rules:
+  - "Wait for full page load including JavaScript-rendered content"
+  - "Take screenshot before extracting text to capture initial state"
+  - "For infinite scroll pages, scroll down and capture multiple screenshots"
+  - "Respect website terms of service — no aggressive scraping"
+  - "Store both screenshot and text for complete record"
+
+output_format:
+  structure: markdown
+  sections:
+    - "url"
+    - "screenshot_path"
+    - "extracted_content"
+    - "timestamp"
+  max_length: "Full content extraction"
+
+examples:
+  - user_input: "capturá el contenido de https://example.com/dashboard"
+    expected_behavior: "browser_navigate → wait for JS render → browser_screenshot → browser_fetch → return both"
+
+  - user_input: "obtené la página renderizada de la app"
+    expected_behavior: "Navigate → wait for SPA to load → screenshot + fetch content"
+
+  - user_input: "scrapeá este sitio con javascript"
+    expected_behavior: "Full browser render → capture visual and text content"
+---
+
+# Browser Scrape Skill
+
+## Cuándo se Activa
+
+Esta skill se activa para sitios web dinámicos que requieren JavaScript rendering, donde el contenido no está disponible en HTML estático.
+
+## Herramientas Disponibles
+
+| Tool | Qué hace | Cuándo usarla |
+|------|----------|---------------|
+| `browser_navigate` | Navega y renderiza página completa | Sitios con JavaScript/SPA |
+| `browser_screenshot` | Captura estado visual | Evidencia de contenido renderizado |
+| `web_fetch` | Extrae texto como markdown | Contenido textual de página renderizada |
+
+## Workflow
+
+1. **Navegar** → `browser_navigate({ url })` + esperar renderizado JS
+2. **Capturar visual** → `browser_screenshot()`
+3. **Extraer texto** → `web_fetch()`
+4. **Combinar** → screenshot + texto para scrape completo
+
+## Mejores Prácticas
+
+- Esperar renderizado completo de JavaScript
+- Para infinite scroll: hacer scroll y múltiples screenshots
+- Capturar antes y después de interacciones si es dinámico
+
+## Errores a Evitar
+
+- ❌ No esperar renderizado JavaScript
+- ❌ Solo capturar HTML estático para sitios SPA
+- ❌ Ignorar términos de servicio del sitio

package/packages/core/src/skills/bundled/web/web_monitor/SKILL.md

@@ -0,0 +1,127 @@
+---
+name: web_monitor
+description: "Monitor changes in web sources and track updates over time with persistent memory"
+version: 1.0.0
+author: Hive Team
+icon: "📡"
+category: web
+permissions:
+  - internet_access
+  - memory_write
+  - memory_read
+dependencies: []
+tools: [web_search, web_fetch, memory_write, memory_read]
+
+# Structured skill fields
+triggers:
+  - "monitoreá"
+  - "monitor"
+  - "seguí los cambios"
+  - "track changes"
+  - "avisame si cambia"
+  - "notify if changes"
+  - "actualización de"
+  - "update on"
+  - "novedades de"
+  - "news about"
+  - "cambios en"
+  - "changes in"
+
+preferred_agents: []
+
+steps:
+  - step: 1
+    action: memory_read
+    instruction: "Read previously stored content for this URL/topic to compare"
+    params:
+      title: "monitor_{url_or_topic}"
+    output: previous_content
+
+  - step: 2
+    action: web_fetch
+    instruction: "Fetch current content from monitored URL"
+    params:
+      url: "monitored URL"
+    output: current_content
+
+  - step: 3
+    action: compare
+    instruction: "Compare current content with previous version to identify changes"
+    output: changes_detected
+
+  - step: 4
+    action: memory_write
+    instruction: "Store current content as new baseline for future comparisons"
+    params:
+      title: "monitor_{url_or_topic}"
+      content: "current content + timestamp"
+    output: stored
+
+  - step: 5
+    action: notify
+    instruction: "If changes detected, notify user with summary of what changed"
+    output: notification_sent
+
+rules:
+  - "Always store baseline on first monitor request"
+  - "Compare content systematically — identify additions, removals, modifications"
+  - "Notify only if meaningful changes detected (ignore timestamps, ads)"
+  - "Store timestamp with each baseline for tracking frequency"
+  - "For recurring monitors, use cron.create to schedule automatic checks"
+
+output_format:
+  structure: markdown
+  sections:
+    - "url"
+    - "change_detected"
+    - "summary_of_changes"
+    - "timestamp"
+  max_length: "Brief summary of changes"
+
+examples:
+  - user_input: "monitoreá cambios en https://example.com/pricing"
+    expected_behavior: "Fetch current pricing → store as baseline → on next check, compare and notify if changed"
+
+  - user_input: "avisame si hay novedades sobre IA"
+    expected_behavior: "web_search('IA news') → compare with stored results → notify if new significant news"
+
+  - user_input: "seguí los cambios en la documentación de React"
+    expected_behavior: "Fetch React docs → store baseline → periodic checks → notify on content changes"
+---
+
+# Web Monitor Skill
+
+## Cuándo se Activa
+
+Esta skill se activa cuando el usuario necesita:
+- Monitorear cambios en una URL específica
+- Recibir notificaciones de actualizaciones
+- Seguir novedades sobre un tema
+- Trackear evolución de contenido
+
+## Herramientas Disponibles
+
+| Tool | Qué hace | Cuándo usarla |
+|------|----------|---------------|
+| `web_fetch` | Descarga contenido de URL | Obtener contenido actual |
+| `web_search` | Busca novedades | Monitoreo por tema (no URL fija) |
+| `memory_write` | Guarda baseline | Almacenar contenido para comparación |
+| `memory_read` | Recupera baseline anterior | Comparar con contenido actual |
+
+## Workflow
+
+1. **Primera ejecución**: `web_fetch` → `memory_write` (baseline)
+2. **Chequeos siguientes**: `memory_read` → `web_fetch` → comparar → `notify` si cambia
+3. **Actualizar baseline**: `memory_write` con nuevo contenido
+
+## Mejores Prácticas
+
+- Ignorar cambios menores (timestamps, ads, contenido dinámico irrelevante)
+- Notificar solo cambios significativos
+- Para monitoreo periódico, combinar con `cron.create`
+
+## Errores a Evitar
+
+- ❌ No almacenar baseline inicial
+- ❌ Notificar por cambios triviales
+- ❌ No actualizar timestamp de baseline