@johpaz/hive-sdk 0.0.12 → 0.0.15

package/.github/CODEOWNERS

@@ -0,0 +1,9 @@
+# Code Owners
+* @anomalyco @johpaz
+
+# Reviewers
+/.github/ @anomalyco
+/docs/ @johpaz
+/packages/agent/ @johpaz
+/packages/scheduler/ @johpaz
+/packages/events/ @johpaz

package/.github/workflows/publish.yml

@@ -0,0 +1,89 @@
+name: Publish to NPM
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version (e.g., 0.0.15)'
+        required: true
+        type: string
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    env:
+      FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.3.13
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Type check
+        run: bun run typecheck
+
+      - name: Run tests
+        run: bun test packages/core/src/ --timeout 30000
+
+      - name: Configure NPM token
+        run: |
+          if [ -z "$NPM_TOKEN" ]; then
+            echo "NPM_TOKEN secret is not set"
+            exit 1
+          fi
+          echo "//registry.npmjs.org/:_authToken=$NPM_TOKEN" > .npmrc
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Publish to NPM
+        run: |
+          VERSION="${{ github.event.inputs.version || github.ref_name }}"
+          VERSION="${VERSION#v}"
+          echo "Publishing version: $VERSION"
+
+          # Sync version to root package.json
+          node -e "
+            const p=require('./package.json');
+            p.version='$VERSION';
+            delete p.private;
+            require('fs').writeFileSync('./package.json', JSON.stringify(p,null,2)+'\n')
+          "
+
+          # Sync version to workspace packages (for local consistency)
+          for dir in packages/core packages/cli; do
+            node -e "
+              const p=require('./$dir/package.json');
+              p.version='$VERSION';
+              require('fs').writeFileSync('./$dir/package.json', JSON.stringify(p,null,2)+'\n')
+            "
+          done
+
+          # Publish only the root package (workspace packages are NOT published separately)
+          npm publish --access public
+
+          # Restore private: true to root
+          node -e "
+            const p=require('./package.json');
+            p.private=true;
+            require('fs').writeFileSync('./package.json', JSON.stringify(p,null,2)+'\n')
+          "
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Create GitHub Release
+        if: startsWith(github.ref, 'refs/tags/v')
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: gh release create "${{ github.ref_name }}" --title "Release ${{ github.ref_name }}" --notes "See CHANGELOG.md for details." --draft=false

package/.github/workflows/version-bump.yml

@@ -0,0 +1,102 @@
+name: Version Bump
+
+on:
+  workflow_dispatch:
+    inputs:
+      bump:
+        description: 'Type of bump (patch, minor, major)'
+        required: true
+        default: 'patch'
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+
+jobs:
+  bump:
+    runs-on: ubuntu-latest
+    outputs:
+      new_version: ${{ steps.version.outputs.new_version }}
+      tag: ${{ steps.version.outputs.tag }}
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: Calculate new version
+        id: version
+        run: |
+          current=$(node -p "require('./package.json').version")
+          echo "Current version: $current"
+          IFS='.' read -ra parts <<< "$current"
+          major=${parts[0]}; minor=${parts[1]}; patch=${parts[2]}
+          case "${{ github.event.inputs.bump }}" in
+            major) major=$((major + 1)); minor=0; patch=0 ;;
+            minor) minor=$((minor + 1)); patch=0 ;;
+            patch) patch=$((patch + 1)) ;;
+          esac
+          new_version="$major.$minor.$patch"
+          echo "New version: $new_version"
+          echo "new_version=$new_version" >> $GITHUB_OUTPUT
+          echo "tag=v$new_version" >> $GITHUB_OUTPUT
+
+      - name: Sync version to all workspace packages
+        run: |
+          VERSION="${{ steps.version.outputs.new_version }}"
+
+          # Update root
+          node -e "
+            const p = require('./package.json');
+            p.version = '$VERSION';
+            require('fs').writeFileSync('./package.json', JSON.stringify(p, null, 2) + '\n');
+          "
+
+          # Update each workspace package
+          for pkg in packages/*/package.json; do
+            dir=$(dirname "$pkg")
+            node -e "
+              const p = require('./$dir/package.json');
+              p.version = '$VERSION';
+              require('fs').writeFileSync('./$dir/package.json', JSON.stringify(p, null, 2) + '\n');
+            "
+          done
+
+      - name: Update CHANGELOG
+        run: |
+          date=$(date +%Y-%m-%d)
+          echo "# ${{ steps.version.outputs.new_version }} ($date)" >> CHANGELOG.md
+          echo "" >> CHANGELOG.md
+          echo "## Changes" >> CHANGELOG.md
+          echo "- Version bump" >> CHANGELOG.md
+          echo "" >> CHANGELOG.md
+
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v6
+        with:
+          commit-message: "chore: bump version to ${{ steps.version.outputs.new_version }}"
+          branch: bump-version
+          delete-branch: true
+          title: "Bump version to ${{ steps.version.outputs.new_version }}"
+          body: |
+            Version bump to ${{ steps.version.outputs.new_version }} for all workspace packages.
+          labels: version-bump
+
+  tag:
+    needs: bump
+    runs-on: ubuntu-latest
+    if: github.event.inputs.bump == ''
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: bump-version
+
+      - name: Create Git Tag
+        run: |
+          git tag ${{ needs.bump.outputs.tag }}
+          git push origin ${{ needs.bump.outputs.tag }}

package/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+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.10] - 2026-05-02
+
+### Added
+- DAG Scheduler with parallel worker execution
+- Tool selector with FTS5 full-text search
+- Skill selector with semantic triggers
+- Context compiler for agent execution
+- Canvas (ACE) real-time visualization
+- Multi-channel support (Slack, Discord, Telegram, WhatsApp)
+- AgentBus for inter-agent communication
+- SQLite storage with FTS5 built-in
+- 130+ passing tests
+
+### Performance
+- 3x faster than LangChain (Bun runtime)
+- Parallel DAG execution (15x faster than sequential)
+- Streaming TTFT benchmarks
+- Worker metrics (12 tasks/sec throughput)
+
+### Documentation
+- Complete API documentation in docs/
+- README comparison with LangChain
+- Benchmark documentation
+
+## [0.0.9] - 2026-01-01
+
+### Added
+- Initial release
+- Agent execution with LLM providers
+- Basic tool and skill system
+- Gateway server

package/README.md

@@ -0,0 +1,158 @@
+# Hive SDK
+
+<p align="center">
+  <img src="https://img.shields.io/badge/Bun-v1.3.13-000000?style=flat&logo=bun" alt="Bun">
+  <img src="https://img.shields.io/badge/TypeScript-6.0-blue?style=flat&logo=typescript">
+  <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.
+
+## 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` |
+
+## Instalación
+
+```bash
+git clone https://github.com/anomalyco/hive-sdk.git
+cd hive-sdk
+bun install
+```
+
+## Inicio Rápido
+
+```typescript
+import { createAgent, defineTool } from "@hive/core";
+
+const myTool = defineTool({
+  name: "saludar",
+  description: "Saluda a alguien",
+  execute: async (args: { nombre: string }) => `¡Hola ${args.nombre}!`,
+});
+
+const agent = await createAgent({
+  name: "asistente",
+  provider: "openai",
+  model: "gpt-4o-mini",
+  tools: [myTool],
+});
+
+const respuesta = await agent.run("Saluda a Juan");
+console.log(respuesta);
+```
+
+## Crear un Swarm (DAG)
+
+```typescript
+import { DAGScheduler, TaskGraph } from "@hive/core";
+
+const graph = new TaskGraph([
+  { id: "fetch", agentId: "fetcher", taskDescription: "Obtener datos", deps: [] },
+  { id: "process", agentId: "processor", taskDescription: "Procesar", deps: ["fetch"] },
+  { id: "report", agentId: "reporter", taskDescription: "Reportar", deps: ["process"] },
+]);
+
+const result = await new DAGScheduler().execute(graph);
+```
+
+## Estructura del Proyecto
+
+```
+hive-sdk/
+├── packages/
+│   ├── core/                   # @hive/core
+│   │   └── src/
+│   │       ├── 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
+│   │       ├── skills/         # SkillLoader, defineSkill()
+│   │       ├── swarm/          # DAGScheduler, TaskGraph, WorkerPool
+│   │       │   ├── strategies/ # ParallelStrategy, PriorityStrategy
+│   │       │   └── presets/    # HiveLearnPreset, ResearchPreset
+│   │       ├── mcp/            # MCPClientManager, transports (SSE, WS)
+│   │       ├── storage/        # SQLite (bun:sqlite) + FTS5
+│   │       ├── ace/            # Tracer, Reflector, Curator
+│   │       ├── canvas/         # CanvasManager + A2UI tools
+│   │       ├── memory/         # Scratchpad
+│   │       ├── ethics/         # EthicsGuard
+│   │       ├── config/         # loadConfig, loadEnv
+│   │       ├── utils/          # logger, toon, crypto, retry
+│   │       ├── api/            # createAgent()
+│   │       └── index.ts        # Public API barrel
+│   │
+│   └── 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
+│
+├── test/                       # Test helpers
+│   └── setup-db.ts             # DB preload for tests
+│
+├── docs/                       # Documentación
+├── 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";
+```
+
+## Testing
+
+```bash
+# Todos los tests
+bun test packages/core/src/
+
+# Tests con timeout
+bun test --timeout 30000
+
+# Tests específicos
+bun test packages/core/src/tools/ToolRegistry.test.ts
+```
+
+## Variables de Entorno
+
+```bash
+HIVE_DATA_DIR=./data          # Directorio de datos
+OPENAI_API_KEY=sk-...         # OpenAI
+ANTHROPIC_API_KEY=sk-ant-...  # Anthropic
+LOG_LEVEL=info                 # debug | info | warn | error
+```
+
+## Licencia
+
+MIT © 2024 Anomaly Co.