Releases: adrianhihi/helix
v2.7.0 — Agent Payment Intelligence + VialOS Beta
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 —
--betaflag activates VialOS Runtime integrationGET /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 Classification —
nonce-mismatch/nonceseed 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.0Do 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
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 excludefilterCandidates()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 adapterStats
- 514 Helix tests + 27 adapter tests = 541 total
- 53 test files
- Schema v12
v2.5.0 — @vial-agent/core Extracted + Comparison Agent
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 VialPlatformAdapterinterface: 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 frameworkv2.4.0 — Real SDK + viem Errors + E2E Execution on Base Mainnet
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 landedreduce_request: 110% of balance → halved → tx landedspeed_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 inObject.assignauto-detect: removes gas limits < 21000 onspeed_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.0v2.3.0 — 100% Accuracy Across All Adapters
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-low→reduce_request,gas-estimation-failed→speed_up_transaction - Tempo:
gas-spike→speed_up_transaction, session tokeninvalid→renew_session - Privy:
wallet-locked→renew_session,gas-limit-exceeded→speed_up_transaction - Coinbase:
x402 payment required→switch_network(was misclassified as balance) - Coinbase:
network_connection_failed→retry(wasretry_with_receipt)
Engine Improvements
- Fallback retry: Unknown errors always get a
retrystrategy (no more→ none) - Type safety:
gascategory and 7 new error codes added to union types (removedas anycasts) - Seed genes:
server-errorseed corrected fromretry_with_receipttoretry - 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