@johpaz/hive-sdk 0.1.5 → 0.2.0

package/docs/TEMPLATE-HIVE-APP.md

@@ -1,360 +0,0 @@
-# Template `hive-app` — Documentación Completa
-
-El template `hive-app` genera una **aplicación harness completa** lista para ejecutar. Incluye gateway HTTP/WebSocket, agente coordinador, configuración de canales, base de datos HiveDB, y deployment con Docker.
-
----
-
-## Generar una app
-
-```bash
-hives create-app my-hive
-```
-
-Esto crea el directorio `my-hive/` con la estructura completa.
-
----
-
-## Estructura generada
-
-```
-my-hive/
-├── package.json              # Dependencias y scripts
-├── hive.config.ts            # Configuración del harness
-├── docker-compose.yml        # Deployment con Docker
-├── .env.example              # Variables de entorno de ejemplo
-├── .gitignore                # Archivos ignorados por git
-└── src/
-    ├── main.ts               # Entry point — arranca gateway + agente
-    └── agents/
-        └── coordinator.ts    # Definición del agente coordinador
-```
-
----
-
-## Archivos y opciones
-
-### `package.json`
-
-```json
-{
-  "name": "my-hive",
-  "version": "0.1.0",
-  "type": "module",
-  "scripts": {
-    "dev": "bun run src/main.ts",
-    "start": "bun run src/main.ts",
-    "build": "bun build src/main.ts --outdir dist --target bun"
-  },
-  "dependencies": {
-    "@johpaz/hive-sdk": "latest"
-  }
-}
-```
-
-| Script | Comando | Descripción |
-|--------|---------|-------------|
-| `dev` | `bun run src/main.ts` | Ejecutar en desarrollo |
-| `start` | `bun run src/main.ts` | Ejecutar en producción |
-| `build` | `bun build ...` | Compilar a `dist/` |
-
----
-
-### `hive.config.ts`
-
-Configuración central del harness.
-
-```typescript
-import type { Config } from "@johpaz/hive-sdk";
-
-export default {
-  name: "my-hive",
-  gateway: {
-    host: process.env.HIVE_HOST ?? "127.0.0.1",
-    port: Number(process.env.HIVE_PORT ?? 18790),
-  },
-  channels: {
-    webchat: { enabled: true },    // Siempre habilitado
-    telegram: { enabled: false },  // Requiere TELEGRAM_BOT_TOKEN
-    discord: { enabled: false },   // Requiere DISCORD_BOT_TOKEN
-    whatsapp: { enabled: false },  // Requiere configuración adicional
-    slack: { enabled: false },     // Requiere SLACK_BOT_TOKEN
-  },
-  database: {
-    path: process.env.HIVE_DATA_DIR ?? "./data/hive.db",
-  },
-} satisfies Config;
-```
-
-#### Opciones de configuración
-
-| Opción | Tipo | Default | Descripción |
-|--------|------|---------|-------------|
-| `name` | `string` | `"my-hive"` | Nombre de la aplicación |
-| `gateway.host` | `string` | `"127.0.0.1"` | Host del gateway |
-| `gateway.port` | `number` | `18790` | Puerto del gateway |
-| `channels.webchat.enabled` | `boolean` | `true` | Canal webchat integrado |
-| `channels.telegram.enabled` | `boolean` | `false` | Bot de Telegram |
-| `channels.discord.enabled` | `boolean` | `false` | Bot de Discord |
-| `channels.whatsapp.enabled` | `boolean` | `false` | Bot de WhatsApp |
-| `channels.slack.enabled` | `boolean` | `false` | Bot de Slack |
-| `database.path` | `string` | `"./data/hive"` | Ruta de la base de datos HiveDB |
-
----
-
-### `src/main.ts`
-
-Entry point de la aplicación. Realiza:
-
-1. Inicializa la base de datos (`ensureHiveDb`, que además siembra el catálogo)
-2. Crea el agente coordinador (`createAgent`)
-3. Inicializa el ChannelManager
-4. Arranca el gateway (`startGateway`)
-5. Maneja shutdown graceful (`SIGINT`)
-
-```typescript
-import {
-  createAgent,
-  startGateway,
-  ensureHiveDb,
-  ChannelManager,
-  logger,
-} from "@johpaz/hive-sdk";
-import config from "../hive.config.ts";
-
-const log = logger.child("app");
-
-async function main() {
-  log.info(`Starting my-hive...`);
-
-  await ensureHiveDb();
-
-  const agent = await createAgent({
-    name: "coordinator",
-    provider: "openai",
-    model: "gpt-5.6-luna",
-    systemPrompt: "You are a helpful AI assistant...",
-  });
-
-  const channelManager = new ChannelManager();
-  // TODO: configure channels from hive.config.ts
-
-  const gateway = await startGateway({
-    host: config.gateway?.host,
-    port: config.gateway?.port,
-    agentId: "coordinator",
-  });
-
-  log.info(`my-hive is running at http://${gateway.hostname}:${gateway.port}`);
-}
-
-main().catch((err) => {
-  log.error("Fatal error:", err);
-  process.exit(1);
-});
-```
-
-#### Personalizar el agente
-
-Puedes cambiar el `provider`, `model`, y `systemPrompt`:
-
-```typescript
-const agent = await createAgent({
-  name: "coordinator",
-  provider: "anthropic",        // cualquiera de los 16 del catálogo
-  model: "claude-3-5-sonnet-20241022",
-  systemPrompt: "Tu system prompt personalizado...",
-});
-```
-
-#### Añadir tools al agente
-
-```typescript
-import { defineTool } from "@johpaz/hive-sdk";
-
-const searchTool = defineTool({
-  name: "search",
-  description: "Search the web",
-  execute: async (args: { query: string }) => {
-    // Implementation
-    return { results: [] };
-  },
-});
-
-const agent = await createAgent({
-  name: "coordinator",
-  provider: "openai",
-  model: "gpt-5.6-luna",
-  tools: [searchTool],
-});
-```
-
----
-
-### `src/agents/coordinator.ts`
-
-Definición standalone del agente coordinador. Puedes importarlo desde `main.ts` o usarlo directamente.
-
-```typescript
-import { createAgent } from "@johpaz/hive-sdk";
-
-export const coordinatorAgent = await createAgent({
-  name: "coordinator",
-  provider: "openai",
-  model: "gpt-5.6-luna",
-  systemPrompt: "You are the coordinator agent...",
-});
-```
-
----
-
-### `docker-compose.yml`
-
-Deployment containerizado.
-
-```yaml
-services:
-  app:
-    image: oven/bun:latest
-    working_dir: /app
-    volumes:
-      - .:/app
-      - hive-data:/app/data
-    ports:
-      - "${HIVE_PORT:-18790}:18790"
-    environment:
-      - HIVE_HOST=0.0.0.0
-      - HIVE_PORT=18790
-      - HIVE_DATA_DIR=/app/data
-      - OPENAI_API_KEY=${OPENAI_API_KEY}
-      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
-    command: ["bun", "run", "src/main.ts"]
-    restart: unless-stopped
-
-volumes:
-  hive-data:
-```
-
-#### Deployment
-
-```bash
-# Copiar variables de entorno
-cp .env.example .env
-# Editar .env con tus API keys
-
-# Levantar con Docker
-docker compose up -d
-
-# Ver logs
-docker compose logs -f
-```
-
----
-
-### `.env.example`
-
-Variables de entorno disponibles:
-
-```bash
-# Hive Harness Configuration
-HIVE_HOST=127.0.0.1
-HIVE_PORT=18790
-HIVE_DATA_DIR=./data
-
-# LLM Providers
-OPENAI_API_KEY=sk-...
-ANTHROPIC_API_KEY=sk-ant-...
-GOOGLE_API_KEY=...
-
-# Channels (enable as needed)
-TELEGRAM_BOT_TOKEN=
-DISCORD_BOT_TOKEN=
-SLACK_BOT_TOKEN=
-
-# Logging
-LOG_LEVEL=info
-```
-
-| Variable | Requerida | Descripción |
-|----------|-----------|-------------|
-| `HIVE_HOST` | No | Host del gateway |
-| `HIVE_PORT` | No | Puerto del gateway |
-| `HIVE_HOME` | No | Directorio de datos (HiveDB en `<HIVE_HOME>/data`) |
-| `OPENAI_API_KEY` | Sí* | API key de OpenAI |
-| `ANTHROPIC_API_KEY` | Sí* | API key de Anthropic |
-| `GOOGLE_API_KEY` | Sí* | API key de Gemini |
-| `TELEGRAM_BOT_TOKEN` | No | Token del bot de Telegram |
-| `DISCORD_BOT_TOKEN` | No | Token del bot de Discord |
-| `SLACK_BOT_TOKEN` | No | Token del bot de Slack |
-| `LOG_LEVEL` | No | `debug` \| `info` \| `warn` \| `error` |
-
-\* Al menos una API key de LLM es requerida.
-
----
-
-## Personalización avanzada
-
-### Añadir canales
-
-```typescript
-// src/main.ts
-import { TelegramChannel, DiscordChannel } from "@johpaz/hive-sdk";
-
-const channelManager = new ChannelManager(config);
-
-if (config.channels.telegram.enabled) {
-  channelManager.register("telegram", new TelegramChannel({
-    botToken: process.env.TELEGRAM_BOT_TOKEN!,
-  }));
-}
-
-if (config.channels.discord.enabled) {
-  channelManager.register("discord", new DiscordChannel({
-    botToken: process.env.DISCORD_BOT_TOKEN!,
-  }));
-}
-
-await channelManager.initialize();
-```
-
-### Añadir workers especializados
-
-```bash
-cd my-hive
-hives add-worker researcher
-hives add-worker coder
-```
-
-Esto genera `src/workers/researcher.worker.ts` y `src/workers/coder.worker.ts`.
-
-### Añadir tools
-
-```bash
-cd my-hive
-hives add-tool search-docs
-```
-
-Genera `src/tools/search-docs.ts`.
-
-### Añadir skills
-
-```bash
-cd my-hive
-hives add-skill onboarding
-```
-
-Genera `src/skills/onboarding.ts`.
-
----
-
-## Tests del template
-
-El template incluye tests para verificar que la estructura se genera correctamente.
-
-```bash
-cd my-hive
-bun test
-```
-
----
-
-*Documentación Hive SDK v0.0.17*

package/packages/cli/package.json

@@ -1,17 +0,0 @@
-{
-  "name": "@hive/cli",
-  "version": "0.1.5",
-  "description": "Hive CLI — init, run, test, trace",
-  "license": "MIT",
-  "type": "module",
-  "bin": {
-    "hives": "./src/index.ts"
-  },
-  "main": "./src/index.ts",
-  "exports": {
-    ".": "./src/index.ts"
-  },
-  "dependencies": {
-    "@hive/core": "workspace:*"
-  }
-}

package/packages/cli/src/commands/create-app.test.ts

@@ -1,180 +0,0 @@
-import { describe, expect, it, beforeEach, afterEach } from "bun:test";
-import { existsSync, rmSync, readFileSync } from "node:fs";
-import { join } from "node:path";
-import * as process from "node:process";
-
-const TEST_DIR = join(process.cwd(), "test-create-app-output");
-
-describe("hive create-app", () => {
-  beforeEach(() => {
-    // Clean up before each test
-    if (existsSync(TEST_DIR)) {
-      rmSync(TEST_DIR, { recursive: true });
-    }
-  });
-
-  afterEach(() => {
-    // Clean up after each test
-    if (existsSync(TEST_DIR)) {
-      rmSync(TEST_DIR, { recursive: true });
-    }
-  });
-
-  it("generates a hive-app template with correct structure", async () => {
-    const { copyTemplate } = await import("./create-app-utils.ts");
-
-    copyTemplate(TEST_DIR, { "{{APP_NAME}}": "my-test-app" });
-
-    // Check all expected files exist
-    expect(existsSync(join(TEST_DIR, "package.json"))).toBe(true);
-    expect(existsSync(join(TEST_DIR, "hive.config.ts"))).toBe(true);
-    expect(existsSync(join(TEST_DIR, "docker-compose.yml"))).toBe(true);
-    expect(existsSync(join(TEST_DIR, ".env.example"))).toBe(true);
-    expect(existsSync(join(TEST_DIR, ".gitignore"))).toBe(true);
-    // Sin README el que corre `hives create-app` queda sin una sola instrucción.
-    expect(existsSync(join(TEST_DIR, "README.md"))).toBe(true);
-    expect(existsSync(join(TEST_DIR, "src", "main.ts"))).toBe(true);
-    expect(existsSync(join(TEST_DIR, "src", "agents", "coordinator.ts"))).toBe(true);
-  });
-
-  it("el README del scaffold lleva el nombre de la app y arranca con los pasos", async () => {
-    const { copyTemplate } = await import("./create-app-utils.ts");
-
-    copyTemplate(TEST_DIR, { "{{APP_NAME}}": "mi-app" });
-
-    const readme = readFileSync(join(TEST_DIR, "README.md"), "utf-8");
-    expect(readme).toContain("# mi-app");
-    expect(readme).not.toContain("{{APP_NAME}}");
-    expect(readme).toContain("bun install");
-    expect(readme).toContain("bun run dev");
-  });
-
-  it("replaces {{APP_NAME}} placeholder in all files", async () => {
-    const { copyTemplate } = await import("./create-app-utils.ts");
-
-    copyTemplate(TEST_DIR, { "{{APP_NAME}}": "my-awesome-app" });
-
-    const packageJson = readFileSync(join(TEST_DIR, "package.json"), "utf-8");
-    expect(packageJson).toContain('"name": "my-awesome-app"');
-
-    // `Config` no tiene una clave `name`, así que el nombre de la app sólo se
-    // sustituye en el comentario de cabecera y en package.json.
-    const config = readFileSync(join(TEST_DIR, "hive.config.ts"), "utf-8");
-    expect(config).toContain("my-awesome-app");
-
-    const main = readFileSync(join(TEST_DIR, "src", "main.ts"), "utf-8");
-    expect(main).toContain("Starting my-awesome-app...");
-    expect(main).toContain("my-awesome-app is running at");
-  });
-
-  it("generates valid package.json", async () => {
-    const { copyTemplate } = await import("./create-app-utils.ts");
-
-    copyTemplate(TEST_DIR, { "{{APP_NAME}}": "test-app" });
-
-    const packageJson = JSON.parse(readFileSync(join(TEST_DIR, "package.json"), "utf-8"));
-
-    expect(packageJson.name).toBe("test-app");
-    expect(packageJson.version).toBe("0.1.0");
-    expect(packageJson.type).toBe("module");
-    expect(packageJson.scripts.dev).toBe("bun run src/main.ts");
-    expect(packageJson.scripts.build).toBeDefined();
-    expect(packageJson.dependencies["@johpaz/hive-sdk"]).toBe("latest");
-  });
-
-  it("generates hive.config.ts with correct defaults", async () => {
-    const { copyTemplate } = await import("./create-app-utils.ts");
-
-    copyTemplate(TEST_DIR, { "{{APP_NAME}}": "config-test" });
-
-    const config = readFileSync(join(TEST_DIR, "hive.config.ts"), "utf-8");
-
-    expect(config).toContain('host: process.env.HIVE_HOST ?? "127.0.0.1"');
-    expect(config).toContain('port: Number(process.env.HIVE_PORT ?? 18790)');
-    expect(config).toContain("webchat: { enabled: true }");
-    expect(config).toContain("telegram: { enabled: false }");
-    expect(config).toContain("discord: { enabled: false }");
-    expect(config).toContain("whatsapp: { enabled: false }");
-    expect(config).toContain("slack: { enabled: false }");
-    // HiveDB no se configura por `hive.config.ts`: la ruta sale de HIVE_HOME /
-    // HIVE_DB_PATH. Una clave `database` acá rompería el `satisfies Config`.
-    expect(config).not.toContain("database:");
-    expect(config).not.toContain("hive.db");
-    expect(config).toContain("satisfies Config");
-  });
-
-  it("generates main.ts with all required imports", async () => {
-    const { copyTemplate } = await import("./create-app-utils.ts");
-
-    copyTemplate(TEST_DIR, { "{{APP_NAME}}": "main-test" });
-
-    const main = readFileSync(join(TEST_DIR, "src", "main.ts"), "utf-8");
-
-    expect(main).toContain('from "@johpaz/hive-sdk"');
-    expect(main).toContain("startGateway");
-    // `initializeDatabase()` desapareció con la capa SQLite: `ensureHiveDb()`
-    // abre HiveDB, crea los índices y siembra el catálogo en un solo paso.
-    expect(main).toContain("ensureHiveDb");
-    expect(main).not.toContain("initializeDatabase");
-    expect(main).toContain("ChannelManager");
-    expect(main).toContain("logger");
-    expect(main).toContain('import config from "../hive.config.ts"');
-    expect(main).toContain("await ensureHiveDb()");
-    expect(main).toContain('await startGateway({');
-    expect(main).toContain('process.on("SIGINT"');
-    // El coordinador se define una sola vez, en su módulo, y main.ts lo usa —
-    // antes el template creaba uno propio y dejaba coordinator.ts huérfano.
-    expect(main).toContain('from "./agents/coordinator.ts"');
-    expect(main).toContain("agentId: coordinatorAgent.id");
-  });
-
-  it("generates coordinator agent with correct config", async () => {
-    const { copyTemplate } = await import("./create-app-utils.ts");
-
-    copyTemplate(TEST_DIR, { "{{APP_NAME}}": "agent-test" });
-
-    const agent = readFileSync(join(TEST_DIR, "src", "agents", "coordinator.ts"), "utf-8");
-
-    expect(agent).toContain('import { createAgent } from "@johpaz/hive-sdk"');
-    expect(agent).toContain('name: "coordinator"');
-    expect(agent).toContain('provider: "openai"');
-    // El modelo del scaffold tiene que existir en SEED_DATA.models, o el primer
-    // `bun run dev` de un usuario nuevo muere con "no está en el catálogo".
-    expect(agent).toContain('model: "gpt-5.6-luna"');
-    expect(agent).toContain("export const coordinatorAgent");
-  });
-
-  it("generates docker-compose.yml with correct ports", async () => {
-    const { copyTemplate } = await import("./create-app-utils.ts");
-
-    copyTemplate(TEST_DIR, { "{{APP_NAME}}": "docker-test" });
-
-    const docker = readFileSync(join(TEST_DIR, "docker-compose.yml"), "utf-8");
-
-    expect(docker).toContain('image: oven/bun:latest');
-    expect(docker).toContain('"${HIVE_PORT:-18790}:18790"');
-    expect(docker).toContain('HIVE_HOST=0.0.0.0');
-    expect(docker).toContain('HIVE_PORT=18790');
-    expect(docker).toContain('command: ["bun", "run", "src/main.ts"]');
-    expect(docker).toContain('restart: unless-stopped');
-  });
-
-  it("generates .env.example with all required variables", async () => {
-    const { copyTemplate } = await import("./create-app-utils.ts");
-
-    copyTemplate(TEST_DIR, { "{{APP_NAME}}": "env-test" });
-
-    const env = readFileSync(join(TEST_DIR, ".env.example"), "utf-8");
-
-    expect(env).toContain("HIVE_HOST=");
-    expect(env).toContain("HIVE_PORT=");
-    expect(env).toContain("HIVE_HOME=");
-    expect(env).toContain("OPENAI_API_KEY=");
-    expect(env).toContain("ANTHROPIC_API_KEY=");
-    expect(env).toContain("GOOGLE_API_KEY=");
-    expect(env).toContain("TELEGRAM_BOT_TOKEN=");
-    expect(env).toContain("DISCORD_BOT_TOKEN=");
-    expect(env).toContain("SLACK_BOT_TOKEN=");
-    expect(env).toContain("LOG_LEVEL=");
-  });
-});

package/packages/core/package.json

@@ -1,70 +0,0 @@
-{
-  "name": "@hive/core",
-  "version": "0.1.5",
-  "description": "Hive Core — runtime de agentes con context engineering, catálogo de modelos y HiveDB",
-  "license": "MIT",
-  "type": "module",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
-  "exports": {
-    ".": "./src/index.ts",
-    "./agent": "./src/agent/index.ts",
-    "./agent/providers": "./src/agent/providers/index.ts",
-    "./tools": "./src/tools/index.ts",
-    "./skills": "./src/skills/index.ts",
-    "./storage": "./src/storage/index.ts",
-    "./swarm": "./src/swarm/index.ts",
-    "./swarm/strategies": "./src/swarm/strategies/index.ts",
-    "./swarm/presets": "./src/swarm/presets/index.ts",
-    "./scheduler": "./src/scheduler/index.ts",
-    "./workers": "./src/workers/index.ts",
-    "./events": "./src/events/event-bus.ts",
-    "./ethics": "./src/ethics/index.ts",
-    "./canvas": "./src/canvas/index.ts",
-    "./config": "./src/config/index.ts",
-    "./mcp": "./src/mcp/index.ts",
-    "./mcp/transports": "./src/mcp/transports/index.ts",
-    "./memory": "./src/memory/index.ts",
-    "./multimodal": "./src/multimodal/index.ts",
-    "./security": "./src/security/index.ts",
-    "./state": "./src/state/index.ts",
-    "./utils": "./src/utils/index.ts",
-    "./gateway": "./src/gateway/index.ts",
-    "./api": "./src/api/index.ts",
-    "./harness": "./src/harness/index.ts"
-  },
-  "dependencies": {
-    "@johpaz/hive-db": "^0.4.0",
-    "@anthropic-ai/sdk": "^0.74.0",
-    "@google/genai": "^1.43.0",
-    "@modelcontextprotocol/sdk": "latest",
-    "@sapphire/snowflake": "latest",
-    "@slack/bolt": "latest",
-    "@whiskeysockets/baileys": "latest",
-    "async-mutex": "^0.5.0",
-    "cron-parser": "^5.5.0",
-    "croner": "^10.0.1",
-    "discord.js": "latest",
-    "docx": "^9.6.1",
-    "grammy": "latest",
-    "groq-sdk": "^0.37.0",
-    "jsonwebtoken": "^9.0.3",
-    "jszip": "^3.10.1",
-    "pdf-lib": "^1.17.1",
-    "mammoth": "^1.12.0",
-    "ollama": "^0.6.3",
-    "openai": "^6.18.0",
-    "pdfjs-dist": "^5.6.205",
-    "pptxgenjs": "^4.0.1",
-    "qrcode-terminal": "latest",
-    "toon-format-parser": "^1.1.0",
-    "xlsx": "^0.18.5",
-    "zod": "latest"
-  },
-  "devDependencies": {
-    "@types/jsonwebtoken": "^9.0.10"
-  },
-  "peerDependencies": {
-    "typescript": "^5.0.0"
-  }
-}