Skip to content

v2.30.0 — Headless API-First Agentic Engine

Choose a tag to compare

View all tags
@HomenShum HomenShum released this 05 Mar 02:24
· 1193 commits to main since this release
v2.30.0
e6d820a

Headless API-First Agentic Engine

New: Engine API (--engine flag)

  • HTTP server on port 6276 with 12 REST endpoints
  • Execute any tool via POST /api/tools/:name
  • Run any of 32 workflow chains via POST /api/workflows/:name
  • SSE streaming for real-time step-by-step progress
  • Session management with preset-scoped tool gating
  • Conformance Reports: deterministic A-F grades on workflow quality
  • Bearer token auth via --engine-secret or ENGINE_SECRET env var

New: Engine Demo View (/engine-demo)

  • Ultra minimal one-page CRUD interface
  • 5 panels: Spec (CRUD), Trace (live events), Scoreboard (grades), Timeline (execution bars), Publish (curl + reports)
  • Pure JetBrains Mono typography, thin dividers, maximum whitespace

Quick Start

# Install and start engine
npx nodebench-mcp --engine

# Execute a tool
curl -X POST http://127.0.0.1:6276/api/tools/discover_tools \
  -H "Content-Type: application/json" \
  -d '{"args": {"query": "security audit"}, "preset": "full"}'

# Run a workflow with streaming
curl -N -X POST http://127.0.0.1:6276/api/workflows/fix_bug \
  -H "Content-Type: application/json" \
  -d '{"preset": "web_dev", "streaming": true}'

# Get conformance report
curl http://127.0.0.1:6276/api/sessions/{id}/report

Conformance Report Grades

Every workflow execution scores 8 checks: step completeness, quality gate, test layers, flywheel, learnings, recon, verification, and error-free execution.

A (90+) / B (75+) / C (60+) / D (40+) / F (<40)

Files Added

  • packages/mcp-local/src/engine/session.ts
  • packages/mcp-local/src/engine/conformance.ts
  • packages/mcp-local/src/engine/server.ts
  • src/features/engine/views/EngineDemoView.tsx

npm: nodebench-mcp@2.30.0

Assets 2
Loading