Skip to content

Releases: adrianhihi/helix

v2.7.0 — Agent Payment Intelligence + VialOS Beta

03 Apr 17:30

Choose a tag to compare

Agent Payment Intelligence

New positioning: Helix is not just failure fixing — it's payment intelligence for AI agents.

Predict costs. Optimize execution. Fix failures. Learn forever.

What's New

  • VialOS Beta--beta flag activates VialOS Runtime integration
    • GET /vial/status — 13 modules, 5 adapters, PCEC stages
    • Dashboard "Powered by VialOS Runtime" badge
    • Without --beta, zero behavior changes
  • Self-Refine — iterative failure refinement (arXiv 2303.17651)
  • Prompt Optimizer — DSPy-style prompt self-optimization (arXiv 2310.03714)
  • API Adapter — 22 HTTP/API error patterns across 7 categories
  • Nonce Classificationnonce-mismatch/nonce seed gene for cross-platform nonce detection
  • MPPScan Discovery — x402 payment protocol (POST /heal, POST /observe)
  • Evolution Tree — D3 phylogenetic visualization at /dashboard/evolution-tree

Install

npm install @helix-agent/core@2.7.0

Do NOT use npm install helix — that's a different package.

Stats

526 tests · 55 files · Schema v12 · 61 error patterns · 5 platforms · 8 research papers

v2.6.0 — Self-Refine + DSPy Prompt Optimizer + API Adapter

29 Mar 07:00

Choose a tag to compare

What's New

Sprint V1: Self-Refine Loop

Paper: Self-Refine (2303.17651). When repair fails, PCEC now iteratively refines instead of blind retry:

  • refine() decides whether to continue + what strategies to exclude
  • filterCandidates() removes failed strategies from candidate list
  • Stops after 3 unique failures, same-strategy loop, or max attempts
  • 100% domain-agnostic

Sprint V2: DSPy Prompt Self-Optimization

Paper: DSPy (2310.03714). LLM prompt improves automatically over time:

  • Tracks LLM classification outcomes (correct/incorrect/unknown)
  • Correct classifications become few-shot examples in the prompt
  • Category diversity in example selection
  • REST: GET /api/prompt-stats, GET /api/prompt-examples
  • Schema migration v12

Sprint V3: @vial-agent/adapter-api

Second vertical proving Vial is generic — HTTP/API self-healing:

  • 22 patterns across 7 categories (throttle, server, timeout, network, auth, client, data)
  • 5 strategies: retry, backoff_retry, renew_session, reduce_request, hold_and_notify
  • Zero domain-specific logic — works with any HTTP client

Install

npm install @helix-agent/core@2.6.0       # payment self-healing
npm install @vial-agent/core@0.2.0         # generic framework
npm install @vial-agent/adapter-api@0.1.0  # API error adapter

Stats

  • 514 Helix tests + 27 adapter tests = 541 total
  • 53 test files
  • Schema v12

v2.5.0 — @vial-agent/core Extracted + Comparison Agent

29 Mar 05:45

Choose a tag to compare

What's New

@vial-agent/core — Generic Self-Healing Framework

Extracted the universal self-healing engine into its own package. Vial powers Helix and can power any agent:

npm install @vial-agent/core
  • 34 engine modules: PCEC, Gene Map, wrap(), Meta-Learning, Safety Verification, Self-Play, Federated Learning, Adaptive Weights, Causal Graph, and more
  • 37 exports: PcecEngine, GeneMap, wrap, AdapterRegistry, evaluate, simulate, all learning modules
  • VialPlatformAdapter interface: implement for any domain (API monitoring, DevOps, CI/CD)
  • Zero dependencies beyond better-sqlite3

Before/After Comparison Agent

Side-by-side agent comparison with realistic error distribution:

  • Error distribution: nonce 40% | gas 25% | rate_limit 20% | balance 10%
  • WITHOUT Helix: ~30% failure rate
  • WITH Helix: 0% failures, 100% repair rate
  • Config: DURATION_MS, TX_INTERVAL_MS, ERROR_RATE

Install

npm install @helix-agent/core@2.5.0   # payment self-healing
npm install @vial-agent/core@0.1.0     # generic framework

v2.4.0 — Real SDK + viem Errors + E2E Execution on Base Mainnet

27 Mar 02:09

Choose a tag to compare

What's New

Real SDK Error Coverage

  • Coinbase SDK fixtures (8/8): ResourceExhausted, Unauthorized, NotFound, InvalidAmount, MalformedRequest, InvalidNetworkID, InternalError, FaucetLimitReached
  • Privy SDK fixtures (8/8): RateLimit, Authentication, NotFound, BadRequest, PermissionDenied, InternalServer, UnprocessableEntity, Conflict
  • viem fixtures (16/16): NonceTooLow/High, InsufficientFunds, IntrinsicGasTooLow/High, FeeCapTooLow/High, EstimateGasExecution, ExecutionReverted, ContractFunctionReverted, HttpRequest, Timeout, LimitExceeded, InternalRpc, ChainMismatch, InvalidChainId

End-to-End Execution on Base Mainnet

3 repair strategies verified with real on-chain transactions:

  • refresh_nonce: stale nonce → deleted → viem auto-assigns → tx landed
  • reduce_request: 110% of balance → halved → tx landed
  • speed_up_transaction: gas=1 → removed → auto-estimated → tx landed

Before/After Comparison Agent

Side-by-side agent comparison for data collection:

  • WITHOUT Helix: 50% failure rate
  • WITH Helix: 0% failures, 100% repair rate

Bug Fixes

  • wrap() now returns primitive results (string tx hashes) directly instead of wrapping in Object.assign
  • auto-detect: removes gas limits < 21000 on speed_up_transaction
  • Coinbase perceive: case-insensitive execution reverted, ERC20 balance exceeded pattern
  • Coinbase strategies: batch category → remove_and_resubmit, auth → backoff_retry
  • Privy perceive: rate limit, server error, insufficient funds patterns
  • Privy strategies: auth + service categories

Install

npm install @helix-agent/core@2.4.0

v2.3.0 — 100% Accuracy Across All Adapters

26 Mar 22:17

Choose a tag to compare

What's New

Full coverage across all 4 platform adapters — every error pattern now maps to the correct repair strategy.

Strategy Gap Fixes

  • Coinbase: paymaster-balance-lowreduce_request, gas-estimation-failedspeed_up_transaction
  • Tempo: gas-spikespeed_up_transaction, session token invalidrenew_session
  • Privy: wallet-lockedrenew_session, gas-limit-exceededspeed_up_transaction
  • Coinbase: x402 payment requiredswitch_network (was misclassified as balance)
  • Coinbase: network_connection_failedretry (was retry_with_receipt)

Engine Improvements

  • Fallback retry: Unknown errors always get a retry strategy (no more → none)
  • Type safety: gas category and 7 new error codes added to union types (removed as any casts)
  • Seed genes: server-error seed corrected from retry_with_receipt to retry
  • API: Empty error strings now accepted

Accuracy

  • Accuracy test v2: 32/32 (100%) across Coinbase (17), Tempo (7), Privy (5), Generic (3)
  • 489 unit tests passing

Install

npm install @helix-agent/core@2.3.0