@johpaz/hive-sdk 0.0.15 → 0.0.16

package/CHANGELOG.md

@@ -5,6 +5,32 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.0.16] - 2026-05-28
+
+### Added
+- **Bun Workers individuales**: `createWorker()`, `WorkerPool`, `agent.worker.ts`
+  - Workers especializados con system prompt propio
+  - Ejecución en threads aislados via `Bun.Worker`
+  - Comunicación via `postMessage`/`onmessage`
+- **Gateway simplificado**: HTTP/WebSocket server con `Bun.serve()`
+  - Endpoints: `/status`, `/chat`, `/ws`
+  - Streaming de respuestas en tiempo real
+- **Channels**: Telegram, Discord, WhatsApp, Slack, Webchat
+- **Tool Runtime**: Ejecución paralela de tools via Bun Workers
+- **CLI mejorado**:
+  - `hive create-app <name>` — Generar app harness completa
+  - `hive add-tool <name>` — Generar boilerplate de tool
+  - `hive add-skill <name>` — Generar boilerplate de skill
+  - `hive add-worker <name>` — Generar Bun Worker
+- **Template hive-app**: Proyecto harness completo con Docker, config, gateway
+- **Tests del harness**: 39 tests pasando en 12 archivos
+  - Workers, Gateway, Channels, Canvas, Scheduler, Storage, Swarm, Tool Runtime
+
+### Changed
+- API pública expandida: exports de gateway, channels, canvas, scheduler, tool-runtime, workers
+- `package.json`: versión 0.0.16, descripción actualizada, bin `hive`
+- Documentación actualizada en `docs/`
+
 ## [0.0.10] - 2026-05-02
 
 ### Added
@@ -35,4 +61,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Initial release
 - Agent execution with LLM providers
 - Basic tool and skill system
-- Gateway server
+- Gateway server

package/README.md

@@ -6,27 +6,73 @@
   <img src="https://img.shields.io/badge/License-MIT-green?style=flat">
 </p>
 
-Framework de agentes AI con Context Engineering, FTS5, ACE y Swarm — construido nativamente para Bun.
+**The Hive Agent Harness SDK** — Build, deploy, and scale AI agent applications with multi-channel support, context engineering, and swarm orchestration.
+
+> This Hive SDK powers the [Hive Harness](https://github.com/johpaz/hive). Use it to create your own harness instances without building everything from scratch.
+
+---
 
 ## Paquetes
 
 | Paquete | Descripción |
 |---------|-------------|
-| `@hive/core` | Core del framework: agente, tools, skills, MCP, storage, swarm, canvas, ACE |
-| `@hive/cli` | CLI: `hive init`, `hive run`, `hive test`, `hive trace` |
+| `@johpaz/hive-sdk` | Core SDK + CLI — agents, tools, skills, MCP, storage, swarm, gateway, channels |
 
 ## Instalación
 
 ```bash
-git clone https://github.com/anomalyco/hive-sdk.git
-cd hive-sdk
-bun install
+# Install globally for the CLI
+bun install -g @johpaz/hive-sdk
+
+# Or in a project
+bun add @johpaz/hive-sdk
+```
+
+## CLI Commands
+
+### Create a full harness application
+
+```bash
+hive create-app my-hive
+```
+
+Generates a complete Hive harness with gateway, channels, and agent configuration.
+
+### Create a lightweight agent project
+
+```bash
+hive init my-agent
+```
+
+### Add a tool to your project
+
+```bash
+cd my-hive
+hive add-tool search-docs
+```
+
+### Add a skill to your project
+
+```bash
+cd my-hive
+hive add-skill onboarding
+```
+
+### Run your agent
+
+```bash
+cd my-agent
+hive run
 ```
 
-## Inicio Rápido
+---
+
+## Inicio Rápido — Programmatic API
+
+### Create an Agent
 
 ```typescript
-import { createAgent, defineTool } from "@hive/core";
+import { createAgent, defineTool } from "@johpaz/hive-sdk";
 
 const myTool = defineTool({
   name: "saludar",
@@ -45,10 +91,32 @@ const respuesta = await agent.run("Saluda a Juan");
 console.log(respuesta);
 ```
 
-## Crear un Swarm (DAG)
+### Start a Gateway
 
 ```typescript
-import { DAGScheduler, TaskGraph } from "@hive/core";
+import { startGateway, createAgent, initializeDatabase } from "@johpaz/hive-sdk";
+
+await initializeDatabase();
+
+const agent = await createAgent({
+  name: "coordinator",
+  provider: "openai",
+  model: "gpt-4o-mini",
+});
+
+const server = await startGateway({
+  host: "127.0.0.1",
+  port: 18790,
+  agentId: "coordinator",
+});
+
+console.log(`Gateway running at http://127.0.0.1:18790`);
+```
+
+### Create a Swarm (DAG)
+
+```typescript
+import { DAGScheduler, TaskGraph } from "@johpaz/hive-sdk";
 
 const graph = new TaskGraph([
   { id: "fetch", agentId: "fetcher", taskDescription: "Obtener datos", deps: [] },
@@ -59,100 +127,154 @@ const graph = new TaskGraph([
 const result = await new DAGScheduler().execute(graph);
 ```
 
-## Estructura del Proyecto
+### Multi-Channel Bot
+
+```typescript
+import { ChannelManager, TelegramChannel, DiscordChannel } from "@johpaz/hive-sdk";
+
+const manager = new ChannelManager();
+
+manager.register("telegram", new TelegramChannel({ botToken: process.env.TELEGRAM_BOT_TOKEN! }));
+manager.register("discord", new DiscordChannel({ botToken: process.env.DISCORD_BOT_TOKEN! }));
+
+await manager.startAll();
+```
+
+---
+
+## Estructura del Proyecto (SDK)
 
 ```
 hive-sdk/
 ├── packages/
-│   ├── core/                   # @hive/core
+│   ├── core/                   # @johpaz/hive-sdk core
 │   │   └── src/
+│   │       ├── api/            # createAgent(), Agent interface
 │   │       ├── agent/          # AgentLoop, ContextCompiler, ConversationStore
 │   │       │   ├── providers/  # LLM: OpenAI, Anthropic, Gemini, Ollama
 │   │       │   └── selectors/  # FTS5: ToolSelector, SkillSelector, PlaybookSelector
-│   │       ├── tools/          # ToolRegistry + 66 built-in tools
-│   │       │   ├── filesystem/ web/ projects/ cron/ cli/ agents/
-│   │       │   ├── canvas/ codebridge/ voice/ core/ office/ meeting/
-│   │       │   ├── ToolRegistry.ts   # defineTool()
-│   │       │   └── ToolExecutor.ts
+│   │       ├── tools/          # ToolRegistry + 70+ built-in tools
 │   │       ├── skills/         # SkillLoader, defineSkill()
 │   │       ├── swarm/          # DAGScheduler, TaskGraph, WorkerPool
-│   │       │   ├── strategies/ # ParallelStrategy, PriorityStrategy
-│   │       │   └── presets/    # HiveLearnPreset, ResearchPreset
+│   │       ├── gateway/        # HTTP/WebSocket server (Bun.serve)
+│   │       ├── channels/       # Telegram, Discord, WhatsApp, Slack, Webchat
 │   │       ├── mcp/            # MCPClientManager, transports (SSE, WS)
 │   │       ├── storage/        # SQLite (bun:sqlite) + FTS5
-│   │       ├── ace/            # Tracer, Reflector, Curator
-│   │       ├── canvas/         # CanvasManager + A2UI tools
-│   │       ├── memory/         # Scratchpad
+│   │       ├── canvas/         # CanvasManager + A2UI emitter
+│   │       ├── scheduler/      # CronScheduler + DAG execution
 │   │       ├── ethics/         # EthicsGuard
+│   │       ├── memory/         # Scratchpad
 │   │       ├── config/         # loadConfig, loadEnv
 │   │       ├── utils/          # logger, toon, crypto, retry
-│   │       ├── api/            # createAgent()
 │   │       └── index.ts        # Public API barrel
 │   │
-│   └── cli/                    # @hive/cli
+│   └── cli/                    # Hive CLI
 │       └── src/
-│           ├── index.ts        # Entry: hive {init,run,test,trace}
-│           └── commands/
-│               ├── init.ts     # hive init
-│               ├── run.ts      # hive run
-│               ├── test.ts     # hive test
-│               └── trace.ts    # hive trace
+│           ├── index.ts        # Entry: hive {init,create-app,add-tool,add-skill,run,test,trace}
+│           ├── commands/
+│           │   ├── init.ts
+│           │   ├── create-app.ts
+│           │   ├── add-tool.ts
+│           │   ├── add-skill.ts
+│           │   ├── run.ts
+│           │   ├── test.ts
+│           │   └── trace.ts
+│           └── templates/
+│               └── hive-app/   # Full harness template
+│                   ├── package.json
+│                   ├── hive.config.ts
+│                   ├── docker-compose.yml
+│                   ├── .env.example
+│                   └── src/
+│                       ├── main.ts
+│                       └── agents/
+│                           └── coordinator.ts
 │
 ├── test/                       # Test helpers
-│   └── setup-db.ts             # DB preload for tests
-│
-├── docs/                       # Documentación
+├── docs/                       # Documentation
 ├── tsconfig.json
 └── package.json
 ```
 
+---
+
 ## API Pública
 
 ```typescript
 import {
-  createAgent,           // Crear agente con configuración
-  defineTool,            // Definir herramienta
-  defineSkill,           // Definir skill
-  ToolRegistry,          // Registro de herramientas
-  ToolExecutor,          // Ejecutor de herramientas
-  AgentLoop,             // Bucle principal del agente
-  runAgent,              // Ejecutar agente (streaming)
-  runAgentIsolated,      // Ejecutar agente aislado (workers)
-  DAGScheduler,          // Orquestador DAG
-  TaskGraph,             // Grafo de tareas
-  TaskNode,              // Nodo del grafo
-  MCPClientManager,      // Cliente MCP
-  EthicsGuard,           // Guardián ético
-  Scratchpad,            // Memoria temporal
-  SkillLoader,           // Cargador de skills
-  initializeDatabase,    // Inicializar BD
-  loadConfig,            // Cargar configuración
-  logger,                // Logger
-} from "@hive/core";
+  // Agent
+  createAgent,
+  defineTool,
+  defineSkill,
+  runAgent,
+  runAgentIsolated,
+
+  // Gateway
+  startGateway,
+
+  // Channels
+  ChannelManager,
+  TelegramChannel,
+  DiscordChannel,
+  WhatsAppChannel,
+  SlackChannel,
+  WebChatChannel,
+
+  // Swarm
+  DAGScheduler,
+  TaskGraph,
+  TaskNode,
+
+  // MCP
+  MCPClientManager,
+
+  // Tools
+  ToolRegistry,
+  ToolExecutor,
+  executeToolBatch,
+
+  // Storage
+  initializeDatabase,
+
+  // Config
+  loadConfig,
+
+  // Utils
+  logger,
+  retry,
+} from "@johpaz/hive-sdk";
 ```
 
+---
+
 ## Testing
 
 ```bash
-# Todos los tests
+# All tests
 bun test packages/core/src/
 
-# Tests con timeout
+# Tests with timeout
 bun test --timeout 30000
 
-# Tests específicos
+# Specific tests
 bun test packages/core/src/tools/ToolRegistry.test.ts
 ```
 
+---
+
 ## Variables de Entorno
 
 ```bash
 HIVE_DATA_DIR=./data          # Directorio de datos
+HIVE_HOST=127.0.0.1           # Gateway host
+HIVE_PORT=18790               # Gateway port
 OPENAI_API_KEY=sk-...         # OpenAI
 ANTHROPIC_API_KEY=sk-ant-...  # Anthropic
-LOG_LEVEL=info                 # debug | info | warn | error
+LOG_LEVEL=info                # debug | info | warn | error
 ```
 
+---
+
 ## Licencia
 
-MIT © 2024 Anomaly Co.
+MIT © 2024-2025 Anomaly Co. / @Johpaz

package/docs/API-AGENTS.md

@@ -17,7 +17,7 @@ Función de alto nivel para crear y ejecutar agentes.
 ### Firma
 
 ```typescript
-import { createAgent } from "@hive/core";
+import { createAgent } from "@johpaz/hive-sdk";
 
 const agent = await createAgent(config: AgentConfig): Promise<Agent>
 ```
@@ -77,7 +77,7 @@ type AgentEvent =
 ### Ejemplo
 
 ```typescript
-import { createAgent, defineTool } from "@hive/core";
+import { createAgent, defineTool } from "@johpaz/hive-sdk";
 
 const agent = await createAgent({
   name: "asistente",
@@ -102,7 +102,7 @@ const respuesta = await agent.run("Analiza las ventas del mes");
 Define una herramienta que el agente puede invocar.
 
 ```typescript
-import { defineTool } from "@hive/core";
+import { defineTool } from "@johpaz/hive-sdk";
 
 const tool = defineTool({
   name: "saludar",
@@ -132,7 +132,7 @@ interface ToolDefinition {
 Define una composición de herramientas con triggers semánticos.
 
 ```typescript
-import { defineSkill } from "@hive/core";
+import { defineSkill } from "@johpaz/hive-sdk";
 
 const skill = defineSkill({
   name: "analisis-datos",
@@ -153,7 +153,7 @@ const skill = defineSkill({
 Clase de bajo nivel para control directo del bucle del agente.
 
 ```typescript
-import { AgentLoop, buildAgentLoop } from "@hive/core";
+import { AgentLoop, buildAgentLoop } from "@johpaz/hive-sdk";
 
 const loop = buildAgentLoop({ mcpManager });
 
@@ -185,7 +185,7 @@ interface StreamChunk {
 ### runAgent (bajo nivel)
 
 ```typescript
-import { runAgent, runAgentIsolated } from "@hive/core";
+import { runAgent, runAgentIsolated } from "@johpaz/hive-sdk";
 
 // Streaming
 for await (const chunk of runAgent({
@@ -211,7 +211,7 @@ const result = await runAgentIsolated({
 Selección automática de tools basada en FTS5.
 
 ```typescript
-import { selectTools, CORE_TOOL_CATALOG } from "@hive/core";
+import { selectTools, CORE_TOOL_CATALOG } from "@johpaz/hive-sdk";
 
 // Seleccionar tools relevantes
 const tools = selectTools("Buscar archivos en el proyecto");
@@ -251,7 +251,7 @@ const MIN_RELEVANCE_THRESHOLD = -30;
 ## Skill Selector
 
 ```typescript
-import { selectSkills, getMinimalSkills } from "@hive/core";
+import { selectSkills, getMinimalSkills } from "@johpaz/hive-sdk";
 
 // Skills según mensaje
 const skills = selectSkills("Analyze the sales data");
@@ -276,7 +276,7 @@ const minimal = getMinimalSkills();
 ### callLLM
 
 ```typescript
-import { callLLM, resolveProviderConfig } from "@hive/core";
+import { callLLM, resolveProviderConfig } from "@johpaz/hive-sdk";
 
 const config = await resolveProviderConfig("openai", "gpt-4o-mini");
 

package/docs/API-CONTEXT-COMPILER.md

@@ -18,7 +18,7 @@ Compila todo el contexto necesario para cada ejecución del agente.
 ### compileContext
 
 ```typescript
-import { compileContext } from "@hive/core";
+import { compileContext } from "@johpaz/hive-sdk";
 
 const ctx = await compileContext({
   agentId: "analyst",
@@ -52,7 +52,7 @@ El Context Compiler implementa 4 estrategias de Context Engineering:
 ### addMessage
 
 ```typescript
-import { addMessage } from "@hive/core";
+import { addMessage } from "@johpaz/hive-sdk";
 
 await addMessage(
   threadId: string,
@@ -68,7 +68,7 @@ await addMessage(
 ### getRecentMessages
 
 ```typescript
-import { getRecentMessages } from "@hive/core";
+import { getRecentMessages } from "@johpaz/hive-sdk";
 
 const messages = await getRecentMessages(threadId, {
   maxTokens: 32000,
@@ -81,7 +81,7 @@ const messages = await getRecentMessages(threadId, {
 Reduce el historial cuando excede el límite de tokens.
 
 ```typescript
-import { maybeCompact } from "@hive/core";
+import { maybeCompact } from "@johpaz/hive-sdk";
 
 await maybeCompact(threadId, { channel: "slack", userId: "U123" });
 ```
@@ -89,7 +89,7 @@ await maybeCompact(threadId, { channel: "slack", userId: "U123" });
 ### clearOldToolResults
 
 ```typescript
-import { clearOldToolResults } from "@hive/core";
+import { clearOldToolResults } from "@johpaz/hive-sdk";
 
 const clean = clearOldToolResults(messages);
 ```
@@ -97,7 +97,7 @@ const clean = clearOldToolResults(messages);
 ### ConversationStore
 
 ```typescript
-import { getSummary, saveSummary, getScratchpad, saveScratchpadNote } from "@hive/core";
+import { getSummary, saveSummary, getScratchpad, saveScratchpadNote } from "@johpaz/hive-sdk";
 
 // Resumen de conversación
 const summary = getSummary(threadId);
@@ -113,8 +113,8 @@ const notes = getScratchpad(threadId, "worker-1");
 Memoria temporal por hilo de conversación.
 
 ```typescript
-import { Scratchpad } from "@hive/core";
-import { getDb } from "@hive/core";
+import { Scratchpad } from "@johpaz/hive-sdk";
+import { getDb } from "@johpaz/hive-sdk";
 
 const db = getDb();
 const pad = new Scratchpad(db);
@@ -142,8 +142,8 @@ pad.clear("thread-1");
 Guardián de reglas de calidad de respuesta desde la base de datos.
 
 ```typescript
-import { EthicsGuard } from "@hive/core";
-import { getDb } from "@hive/core";
+import { EthicsGuard } from "@johpaz/hive-sdk";
+import { getDb } from "@johpaz/hive-sdk";
 
 const db = getDb();
 const guard = new EthicsGuard(db);
@@ -214,7 +214,7 @@ await runCurator();
 ### Config
 
 ```typescript
-import type { MCPConfig, MCPServerConfig } from "@hive/core";
+import type { MCPConfig, MCPServerConfig } from "@johpaz/hive-sdk";
 
 const config: MCPConfig = {
   servers: {
@@ -232,7 +232,7 @@ const config: MCPConfig = {
 ### Singleton
 
 ```typescript
-import { setMCPManager, getMCPManager, hasMCPManager } from "@hive/core";
+import { setMCPManager, getMCPManager, hasMCPManager } from "@johpaz/hive-sdk";
 
 setMCPManager(mcpManager);
 const mcp = getMCPManager();     // MCPClientManager | undefined
@@ -242,7 +242,7 @@ const exists = hasMCPManager();   // boolean
 ### Hot Reload
 
 ```typescript
-import { startMCPHotReload, stopMCPHotReload } from "@hive/core";
+import { startMCPHotReload, stopMCPHotReload } from "@johpaz/hive-sdk";
 
 // Watch de configuración MCP
 startMCPHotReload();

package/docs/API-DAG-SCHEDULER.md

@@ -35,7 +35,7 @@ Representa una tarea individual en el grafo.
 ### TaskNodeConfig
 
 ```typescript
-import { TaskNode } from "@hive/core";
+import { TaskNode } from "@johpaz/hive-sdk";
 
 interface TaskNodeConfig {
   id: string;
@@ -76,7 +76,7 @@ node.markCompleted("datos obtenidos");
 Grafo acíclico dirigido de tareas.
 
 ```typescript
-import { TaskGraph } from "@hive/core";
+import { TaskGraph } from "@johpaz/hive-sdk";
 
 const graph = new TaskGraph([
   { id: "a", agentId: "worker", taskDescription: "Tarea A", deps: [] },
@@ -109,7 +109,7 @@ const progress = graph.getProgress();
 Orquestador principal de la ejecución.
 
 ```typescript
-import { DAGScheduler, TaskGraph } from "@hive/core";
+import { DAGScheduler, TaskGraph } from "@johpaz/hive-sdk";
 
 const graph = new TaskGraph([
   { id: "fetch", agentId: "fetcher", taskDescription: "Fetch data", deps: [] },
@@ -162,7 +162,7 @@ scheduler.abort();    // Abortar ejecución en curso
 ### ParallelStrategy (FIFO)
 
 ```typescript
-import { ParallelStrategy } from "@hive/core";
+import { ParallelStrategy } from "@johpaz/hive-sdk";
 
 const strategy = new ParallelStrategy();  // Orden de llegada
 ```
@@ -170,7 +170,7 @@ const strategy = new ParallelStrategy();  // Orden de llegada
 ### PriorityStrategy
 
 ```typescript
-import { PriorityStrategy } from "@hive/core";
+import { PriorityStrategy } from "@johpaz/hive-sdk";
 
 const strategy = new PriorityStrategy();  // Por prioridad + path crítico
 ```
@@ -178,7 +178,7 @@ const strategy = new PriorityStrategy();  // Por prioridad + path crítico
 ### Custom Strategy
 
 ```typescript
-import type { ExecutionStrategy } from "@hive/core";
+import type { ExecutionStrategy } from "@johpaz/hive-sdk";
 
 const myStrategy: ExecutionStrategy = {
   initialize(nodes) { /* precomputar */ },
@@ -221,7 +221,7 @@ const graph = createHiveLearnGraph({
 Puente de eventos entre el scheduler y el resto del sistema.
 
 ```typescript
-import { EventBridge } from "@hive/core";
+import { EventBridge } from "@johpaz/hive-sdk";
 
 const bridge = new EventBridge("swarm-123", "project-1", "coordinator-1");
 
@@ -239,7 +239,7 @@ bridge.onSwarmCompleted = (result) => {
 ## IAgentExecutor
 
 ```typescript
-import type { IAgentExecutor } from "@hive/core";
+import type { IAgentExecutor } from "@johpaz/hive-sdk";
 
 const myExecutor: IAgentExecutor = {
   async execute(node, depResults, threadId) {