@johpaz/hive-agents 0.0.34 → 0.0.36

package/packages/skills/src/bundled/cron_manager/SKILL.md

@@ -0,0 +1,188 @@
+---
+name: cron_manager
+description: "Complete management of cron jobs with cron expressions. Create, list, update, pause, resume, delete, trigger, and view history. Use for reminders, automated reports, periodic checks."
+version: 2.0.0
+author: Hive Team
+icon: "⏰"
+category: cron
+permissions:
+  - cron_manage
+dependencies: []
+tools: [cron.create, cron.list, cron.update, cron.delete, cron.pause, cron.resume, cron.trigger, cron.history]
+
+# Structured skill fields
+triggers:
+  - "programá una tarea"
+  - "schedule task"
+  - "creá un cron"
+  - "create cron"
+  - "editá el cron"
+  - "edit cron"
+  - "eliminá el cron"
+  - "remove cron"
+  - "lista las tareas"
+  - "list cron jobs"
+  - "modificá el cron"
+  - "modify cron"
+  - "tarea recurrente"
+  - "recurring task"
+  - "todos los días"
+  - "daily"
+  - "cada semana"
+  - "weekly"
+
+preferred_agents: []
+
+steps:
+  - step: 1
+    action: clarify_task
+    instruction: "Ask if task is one_shot (single execution) or recurring (repeats). Get specific time and task instruction."
+    output: task_type
+
+  - step: 2
+    action: build_cron_expression
+    instruction: "For recurring: construct cron expression (minute hour day month weekday). For one_shot: get ISO datetime."
+    output: cron_expression or fire_at
+
+  - step: 3
+    action: cron.create
+    instruction: "Create new cron job with required 'task' field (instruction for the agent)"
+    params:
+      name: "Short identifier (e.g., 'daily-report')"
+      task: "REQUIRED - Natural language instruction the agent reads when triggered (e.g., 'Generate sales report and send to Telegram')"
+      task_type: "'recurring' or 'one_shot'"
+      cron_expression: "Cron expression for recurring (e.g., '0 9 * * *')"
+      fire_at: "ISO datetime for one_shot (e.g., '2026-04-20T09:00:00')"
+      channel: "Notification channel (telegram, discord, webchat)"
+      start_at: "Optional ISO datetime - start of execution window (Croner startAt)"
+      stop_at: "Optional ISO datetime - end of execution window (Croner stopAt)"
+      dom_and_dow: "0 = OR logic (default), 1 = AND logic for day-of-month + day-of-week"
+      max_runs: "Optional max executions"
+    output: cron_id
+
+  - step: 4
+    action: cron.list
+    instruction: "List all cron jobs with next execution times"
+    output: cron_jobs
+
+rules:
+  - "ALWAYS use cron.* tools — never exec/terminal"
+  - "The 'task' field is REQUIRED and contains the instruction the agent reads when triggered"
+  - "Ask if one_shot or recurring before creating"
+  - "For one_shot: use fire_at with ISO datetime"
+  - "For daily: 'MM HH * * *'"
+  - "For weekly: 'MM HH * * N' (N=0-6, 0=Sun)"
+  - "For monthly: 'MM HH D * *' (D=1-31)"
+  - "Always show next 3 execution times after creating"
+  - "Use start_at/stop_at to limit execution time window"
+  - "Use dom_and_dow=1 to require BOTH day-of-month AND day-of-week"
+  - "To edit: ALWAYS call cron.update with task_id (get from cron.list first)"
+
+output_format:
+  structure: markdown
+  sections:
+    - "job_name"
+    - "task_instruction"
+    - "cron_expression"
+    - "next_executions"
+  max_length: "List all jobs"
+
+examples:
+  - user_input: "programá un recordatorio diario a las 9am"
+    expected_behavior: "cron.create({ name: 'daily-reminder', task: 'Send reminder message', task_type: 'recurring', cron_expression: '0 9 * * *', channel: 'telegram' })"
+
+  - user_input: "lista las tareas programadas"
+    expected_behavior: "cron.list({})"
+
+  - user_input: "editá el cron para que sea a las 10am"
+    expected_behavior: "cron.list() → get task_id → cron.update({ task_id: '<id>', cron_expression: '0 10 * * *' })"
+
+  - user_input: "actualizá la instrucción del cron"
+    expected_behavior: "cron.list() → get task_id → cron.update({ task_id: '<id>', task: 'New instruction for agent' })"
+
+  - user_input: "elimina el cron"
+    expected_behavior: "cron.list() → get task_id → cron.delete({ task_id: '<id>' })"
+---
+
+# Cron Manager Skill
+
+## Cuándo se Activa
+
+Para gestionar tareas programadas (cron jobs): crear, listar, actualizar, pausar, reanudar, eliminar, ejecutar y ver historial.
+
+## Herramientas Disponibles
+
+| Tool | Qué hace | Cuándo usarla |
+|------|----------|---------------|
+| `cron.create` | Crear cron job | Nueva tarea |
+| `cron.list` | Listar todos | Ver existentes |
+| `cron.update` | Actualizar existente | Cambiar horario/instrucción |
+| `cron.pause` | Pausar temporalmente | Sin eliminar |
+| `cron.resume` | Reanudar pausado | Continuar ejecución |
+| `cron.delete` | Eliminar permanentemente | Cancelar para siempre |
+| `cron.trigger` | Ejecutar ahora | Forzar ejecución |
+| `cron.history` | Ver historial | Ver logs de ejecuciones |
+
+## Campos Principales
+
+| Campo | Tipo | Descripción |
+|-------|------|-------------|
+| `name` | string | Identificador corto (e.g., 'daily-report') |
+| `task` | string | **REQUERIDO** - Instrucciones para el agente al ejecutarse |
+| `task_type` | string | 'recurring' (repite) o 'one_shot' (una vez) |
+| `cron_expression` | string | Expresión cron (solo para recurring) |
+| `fire_at` | string | Datetime ISO (solo para one_shot) |
+| `channel` | string | Canal de notificación |
+| `start_at` | string | Inicio de ventana opcional (Croner startAt) |
+| `stop_at` | string | Fin de ventana opcional (Croner stopAt) |
+| `dom_and_dow` | number | 0=OR (default), 1=AND (día mes + día semana) |
+
+## Cron Expression Format
+
+```
+* * * * *
+│ │ │ │ │
+│ │ │ │ └── Día semana (0-6, 0=Domingo)
+│ │ │ └──── Mes (1-12)
+│ │ └────── Día del mes (1-31)
+│ └──────── Hora (0-23)
+└────────── Minuto (0-59)
+```
+
+## Ejemplos Comunes
+
+| Expresión | Significado |
+|-----------|-------------|
+| `0 9 * * *` | Diario 9:00 AM |
+| `0 7 * * 1-5` | Lun-Vie 7:00 AM |
+| `0 */2 * * *` | Cada 2 horas |
+| `0 0 * * 0` | Domingos medianoche |
+| `0 0 1 * *` | Día 1 de cada mes |
+
+## Cómo Usar start_at / stop_at
+
+- `start_at`: La tarea no ejecuta antes de esta fecha
+- `stop_at`: La tarea no ejecuta después de esta fecha
+- Formato ISO: `'2026-04-01T00:00:00'`
+
+## Cómo Usar dom_and_dow
+
+- `0` (default): Se ejecuta si es el día del mes O el día de semana
+- `1`: Se ejecuta solo si es EL MISMO día del mes Y el día de semana
+
+Ejemplo: `0 9 15 * *` con dom_and_dow=1 significa "los 15 de cada mes QUE SEA domingo"
+
+## Workflow para Crear
+
+1. **Preguntar** → ¿one_shot o recurring?
+2. **Obtener** → Hora y canal de notificación
+3. **Crear** → `cron.create` con campo `task` obligatorio
+4. **Confirmar** → `cron.list` mostrar next runs
+
+## Errores a Evitar
+
+- ❌ Olvidar el campo `task` — es obligatorio
+- ❌ Usar exec para tareas programadas
+- ❌ No preguntar si es one_shot o recurring
+- ❌ No mostrar próximos horarios al crear
+- ❌ Llamar `cron.update` sin `task_id` — siempre hacer `cron.list` primero

package/packages/skills/src/bundled/cron_reminder/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: cron_reminder
+description: "Schedule a reminder for yourself at a specific time. Creates a one_shot cron job that sends a notification message via your preferred channel."
+version: 2.0.0
+author: Hive Team
+icon: "⏰"
+category: cron
+permissions:
+  - cron_manage
+dependencies: []
+tools: [cron.create, notify]
+
+# Structured skill fields
+triggers:
+  - "recordame"
+  - "remind me"
+  - "recordatorio"
+  - "reminder"
+  - "alerta"
+  - "alert"
+  - "avísame"
+  - "notify me"
+  - "programá"
+  - "schedule"
+  - "para mañana"
+  - "for tomorrow"
+  - "en 30 minutos"
+  - "in 30 minutes"
+
+preferred_agents: []
+
+steps:
+  - step: 1
+    action: clarify_reminder
+    instruction: "Ask: What do you want to be reminded about? At what time? Via which channel?"
+    output: reminder_message, reminder_time, channel
+
+  - step: 2
+    action: build_reminder_payload
+    instruction: "Build the task payload with message and channel"
+    output: payload
+
+  - step: 3
+    action: cron.create
+    instruction: "Create one_shot cron job"
+    params:
+      name: "Short name (e.g., 'meeting-reminder')"
+      task: "REQUIRED - The reminder message (e.g., 'Meeting starts in 5 minutes')"
+      task_type: "one_shot"
+      fire_at: "ISO datetime (e.g., '2026-04-20T14:00:00')"
+      channel: "telegram, discord, webchat, whatsapp"
+    output: cron_id
+
+rules:
+  - "ALWAYS use cron.create with task_type='one_shot' for reminders"
+  - "The 'task' field is REQUIRED and contains the reminder message"
+  - "fire_at must be in the future"
+  - "Use notify tool as fallback if cron fails"
+  - "Default channel is user's preferred, ask if not specified"
+
+output_format:
+  structure: markdown
+  sections:
+    - "reminder_message"
+    - "scheduled_time"
+    - "channel"
+  max_length: "Short confirmation"
+
+examples:
+  - user_input: "recordame la reunion a las 3pm"
+    expected_behavior: "cron.create({ name: 'meeting-reminder', task: 'La reunión empieza en 5 minutos', task_type: 'one_shot', fire_at: '2026-04-20T15:00:00', channel: 'telegram' })"
+
+  - user_input: "avísame en 30 minutos"
+    expected_behavior: "cron.create({ name: 'quick-reminder', task: 'Revisa el email', task_type: 'one_shot', fire_at: '<30-min-from-now>', channel: 'telegram' })"
+
+  - user_input: "recordame mañana a las 9am"
+    expected_behavior: "cron.create({ name: 'morning-reminder', task: 'Buenos días! Revisa tu agenda', task_type: 'one_shot', fire_at: '<tomorrow-9am>', channel: 'telegram' })"
+---
+
+# Cron Reminder Skill
+
+## Cuándo se Activa
+
+Para crear recordatorios de una sola ejecución (one_shot): "recuerdame a las 3pm", "avísame en 30 minutos", etc.
+
+## Herramientas
+
+| Tool | Qué hace |
+|------|----------|
+| `cron.create` | Crear recordatorio one_shot |
+| `notify` | Enviar notificación directa |
+
+## Cómo Funciona
+
+1. **Preguntar** → ¿De qué te aviso? ¿A qué hora? ¿Por qué canal?
+2. **Crear** → `cron.create` con `task_type: 'one_shot'` y `fire_at` en formato ISO
+3. **Confirmar** → Mostrar hora programada
+
+## Parámetros
+
+| Campo | Descripción |
+|-------|-------------|
+| `task` | **REQUERIDO** - Mensaje del recordatorio |
+| `task_type` | Siempre `'one_shot'` |
+| `fire_at` | Fecha/hora ISO (ej: `'2026-04-20T15:00:00'`) |
+| `channel` | Canal (telegram, discord, whatsapp, webchat) |
+
+## Errores Comunes
+
+- ❌ Olvidar el campo `task` — obligatorio para que el agente sepa qué enviar
+- ❌ Usar expresiones cron para recordatorios (usar `fire_at` en vez de `cron_expression`)
+- ❌ Poner `fire_at` en el pasado

package/packages/skills/src/bundled/filesystem/file_manager/SKILL.md

@@ -0,0 +1,118 @@
+---
+name: file_manager
+description: "Explore project structure and locate files using glob patterns and directory listing"
+version: 1.0.0
+author: Hive Team
+icon: "📁"
+category: filesystem
+permissions:
+  - filesystem_read
+dependencies: []
+tools: [fs_list, fs_glob, fs_exists]
+
+# Structured skill fields
+triggers:
+  - "lista los archivos"
+  - "list files"
+  - "buscá archivos"
+  - "find files"
+  - "explorá el proyecto"
+  - "explore project"
+  - "qué archivos hay"
+  - "what files exist"
+  - "buscá por patrón"
+  - "search by pattern"
+  - "existe este archivo"
+  - "file exists"
+  - "dónde está"
+  - "where is"
+
+preferred_agents: []
+
+steps:
+  - step: 1
+    action: fs_list
+    instruction: "List directory contents to understand project structure"
+    params:
+      path: "."
+    output: directory_tree
+
+  - step: 2
+    action: fs_glob
+    instruction: "Find files matching specific pattern (e.g., **/*.ts, **/*.md)"
+    params:
+      pattern: "**/*.ts"
+    output: matching_files
+
+  - step: 3
+    action: fs_exists
+    instruction: "Verify specific file or directory exists"
+    params:
+      path: "specific/path"
+    output: exists_boolean
+
+rules:
+  - "Use fs_list for initial exploration of unknown directories"
+  - "Use fs_glob when user specifies file type or pattern"
+  - "Always verify with fs_exists before read/edit operations"
+  - "Stay within workspace directory unless explicitly requested otherwise"
+  - "For recursive search, use ** pattern (e.g., **/*.ts finds all .ts files)"
+
+output_format:
+  structure: markdown
+  sections:
+    - "search_type"
+    - "results"
+    - "file_count"
+  max_length: "List up to 20 files, summarize if more"
+
+examples:
+  - user_input: "lista los archivos del proyecto"
+    expected_behavior: "fs_list({ path: '.' }) → return root directory structure"
+
+  - user_input: "buscá todos los archivos TypeScript"
+    expected_behavior: "fs_glob({ pattern: '**/*.ts' }) → return list of .ts files"
+
+  - user_input: "existe el archivo src/config.ts"
+    expected_behavior: "fs_exists({ path: 'src/config.ts' }) → return true/false"
+---
+
+# File Manager Skill
+
+## Cuándo se Activa
+
+Esta skill se activa cuando el usuario necesita:
+- Explorar la estructura del proyecto
+- Buscar archivos por extensión o patrón
+- Verificar si existe un archivo o directorio
+- Encontrar la ubicación de un archivo
+
+## Herramientas Disponibles
+
+| Tool | Qué hace | Cuándo usarla |
+|------|----------|---------------|
+| `fs_list` | Lista directorios y archivos | Exploración inicial |
+| `fs_glob` | Busca archivos por patrón wildcard | Búsqueda por extensión/patrón |
+| `fs_exists` | Verifica existencia | Pre-check antes de operaciones |
+
+## Workflow
+
+1. **Explorar** → `fs_list({ path })` para estructura general
+2. **Buscar por patrón** → `fs_glob({ pattern })` para tipos específicos
+3. **Verificar** → `fs_exists({ path })` para confirmación
+
+## Patrones Glob Comunes
+
+| Patrón | Encuentra |
+|--------|-----------|
+| `**/*.ts` | Todos los TypeScript |
+| `**/*.test.ts` | Solo tests |
+| `**/*.md` | Documentación |
+| `**/package.json` | Todos los package.json |
+| `src/**/*.tsx` | React components en src |
+
+## Errores a Evitar
+
+- ❌ No verificar existencia antes de leer/editar
+- ❌ Usar fs_list cuando se conoce el patrón (usar glob)
+- ❌ Patrones muy amplios sin filtrado

package/packages/skills/src/bundled/filesystem/file_read_and_summarize/SKILL.md

@@ -0,0 +1,108 @@
+---
+name: file_read_and_summarize
+description: "Read and understand file content with automatic summarization for large files"
+version: 1.0.0
+author: Hive Team
+icon: "📄"
+category: filesystem
+permissions:
+  - filesystem_read
+dependencies: []
+tools: [project_read]
+
+# Structured skill fields
+triggers:
+  - "leé este archivo"
+  - "read this file"
+  - "mostrame el contenido"
+  - "show content"
+  - "qué dice este archivo"
+  - "resumí este archivo"
+  - "summarize this file"
+  - "entendé este código"
+  - "understand this code"
+
+preferred_agents: []
+
+steps:
+  - step: 1
+    action: project_exists
+    instruction: "Verify file exists before attempting to read"
+    output: exists_boolean
+
+  - step: 2
+    action: project_read
+    instruction: "Read file content. Use offset/limit for large files (>1000 lines)"
+    params:
+      path: "file path"
+      offset: 0
+      limit: 100
+    output: file_content
+
+  - step: 3
+    action: synthesize
+    instruction: "Summarize content if file is large. Extract key information relevant to user request"
+    output: summary
+
+rules:
+  - "Always check file exists with project_exists before reading"
+  - "Use offset and limit for files >1000 lines to avoid context saturation"
+  - "Read in chunks for very large files — iterate with offset"
+  - "Summarize automatically for files >500 lines unless user requests full content"
+  - "Identify file type by extension and adapt summary format (code vs text vs config)"
+
+output_format:
+  structure: markdown
+  sections:
+    - "file_path"
+    - "file_type"
+    - "line_count"
+    - "summary"
+    - "key_points"
+  max_length: "500 words for summary, full content if requested"
+
+examples:
+  - user_input: "leé el archivo package.json"
+    expected_behavior: "Check exists → project_read({ path: 'package.json' }) → return full content (small file)"
+
+  - user_input: "resumí el archivo src/main.ts"
+    expected_behavior: "project_read with offset/limit → identify main exports and functions → summarize structure"
+
+  - user_input: "qué dice este archivo de configuración"
+    expected_behavior: "project_read → parse config format → explain key settings in plain language"
+---
+
+# File Read and Summarize Skill
+
+## Cuándo se Activa
+
+Esta skill se activa cuando el usuario necesita leer y entender el contenido de un archivo, especialmente cuando:
+- El archivo es grande y necesita resumen
+- Se requiere comprensión del contenido (no solo lectura)
+- El usuario pide "qué dice", "resumí", "entendé"
+
+## Herramientas Disponibles
+
+| Tool | Qué hace | Cuándo usarla |
+|------|----------|---------------|
+| `project_read` | Lee contenido de archivo del workspace | Lectura de cualquier archivo |
+
+## Workflow
+
+1. **Verificar existencia** → `project_exists({ path })`
+2. **Leer contenido** → `project_read({ path, offset, limit })`
+3. **Sintetizar** → Resumir si es grande, extraer puntos clave
+
+## Mejores Prácticas
+
+- Para archivos >1000 líneas, usar `offset` y `limit`
+- Identificar tipo de archivo por extensión y adaptar formato de resumen
+- Para código: identificar funciones, clases, exports principales
+- Para config: explicar settings clave en lenguaje simple
+- Para texto: extraer ideas principales
+
+## Errores a Evitar
+
+- ❌ Leer sin verificar existencia
+- ❌ Retornar archivo completo sin resumir si es muy grande
+- ❌ No identificar tipo de archivo para adaptar resumen

package/packages/skills/src/bundled/filesystem/file_writer/SKILL.md

@@ -0,0 +1,135 @@
+---
+name: file_writer
+description: "Create, modify, and delete files with safe edit operations and confirmation for large changes"
+version: 1.0.0
+author: Hive Team
+icon: "✍️"
+category: filesystem
+permissions:
+  - filesystem_read
+  - filesystem_write
+dependencies: []
+tools: [project_read, project_write, project_edit, project_exists]
+
+# Structured skill fields
+triggers:
+  - "creá un archivo"
+  - "create a file"
+  - "escribí en"
+  - "write to"
+  - "editá este archivo"
+  - "edit this file"
+  - "modificá"
+  - "modify"
+  - "eliminá el archivo"
+  - "delete file"
+  - "guardá esto"
+  - "save this"
+  - "actualizá el archivo"
+  - "update file"
+
+preferred_agents: []
+
+steps:
+  - step: 1
+    action: project_exists
+    instruction: "Check if file exists to determine if creating or editing"
+    output: exists_boolean
+
+  - step: 2
+    action: project_read (if editing)
+    instruction: "Read existing file to understand current structure before modifying"
+    output: current_content
+
+  - step: 3
+    action: decision_write_or_edit
+    instruction: "Choose project_write for new files or complete rewrite, project_edit for targeted changes"
+    output: operation_type
+
+  - step: 4
+    action: canvas_confirm (if large changes)
+    instruction: "Confirm with user before overwriting files with >50 lines of changes"
+    output: user_approval
+
+  - step: 5
+    action: project_write or project_edit
+    instruction: "Execute the write operation with appropriate method"
+    output: result
+
+rules:
+  - "Always read file before editing to understand structure"
+  - "Use project_edit for small, targeted changes (find/replace)"
+  - "Use project_write for new files or complete rewrites"
+  - "Confirm with canvas_confirm before changes >50 lines"
+  - "Verify file path is within workspace unless explicitly requested otherwise"
+  - "For delete operations, confirm explicitly with user"
+
+output_format:
+  structure: markdown
+  sections:
+    - "operation"
+    - "file_path"
+    - "lines_changed"
+    - "summary"
+  max_length: "Brief summary of changes"
+
+examples:
+  - user_input: "creá un archivo README.md con la descripción del proyecto"
+    expected_behavior: "project_exists (false) → project_write({ path: 'README.md', content: '...' })"
+
+  - user_input: "editá el package.json para agregar la dependencia lodash"
+    expected_behavior: "project_read → project_edit with old_string/new_string for dependencies → confirm"
+
+  - user_input: "eliminá el archivo temporal.log"
+    expected_behavior: "project_exists → canvas_confirm('¿Eliminar archivo?') → if approved, delete operation"
+---
+
+# File Writer Skill
+
+## Cuándo se Activa
+
+Esta skill se activa cuando el usuario necesita:
+- Crear nuevos archivos
+- Modificar contenido existente
+- Eliminar archivos
+- Guardar cambios
+
+## Herramientas Disponibles
+
+| Tool | Qué hace | Cuándo usarla |
+|------|----------|---------------|
+| `project_read` | Lee archivo existente | Antes de editar para entender estructura |
+| `project_write` | Crea o sobreescribe archivo | Archivos nuevos o reescritura completa |
+| `project_edit` | Edita secciones específicas | Cambios puntuales (find/replace) |
+| `project_exists` | Verifica existencia | Para decidir crear vs editar |
+
+## Workflow
+
+### Crear Archivo Nuevo
+1. `project_exists({ path })` → verificar no existe
+2. `project_write({ path, content })` → crear
+
+### Editar Archivo Existente
+1. `project_exists({ path })` → verificar existe
+2. `project_read({ path })` → entender estructura
+3. `project_edit({ path, old_string, new_string })` → modificar
+4. `canvas_confirm()` si cambios >50 líneas
+
+### Eliminar Archivo
+1. `project_exists({ path })` → verificar existe
+2. `canvas_confirm({ message: '¿Eliminar archivo?' })` → confirmar
+3. Operación de delete
+
+## Mejores Prácticas
+
+- **Leer antes de editar**: Nunca modificar sin entender estructura
+- **Edit vs Write**: Usar edit para cambios pequeños, write para nuevos archivos
+- **Confirmar cambios grandes**: >50 líneas requiere confirmación explícita
+- **Paths seguros**: Trabajar dentro del workspace por defecto
+
+## Errores a Evitar
+
+- ❌ Editar sin leer primero
+- ❌ Sobreescribir sin confirmar si es cambio grande
+- ❌ Eliminar sin confirmación explícita
+- ❌ Usar write cuando edit es suficiente