Skip to content

Releases: mrzdevcore/haira

v0.5.2

12 Mar 03:59

Choose a tag to compare

Agentic Framework

  • Anthropic client — Native Anthropic API client for direct provider integration
  • Agent storage — New storage: true agent field for persistent agent state
  • Agent strategystrategy field support in agent declarations for delegation control
  • Step confirmationsawaiting_confirm step status with StepConfirmPayload for human-in-the-loop approval flows

Compiler & Language

  • Triple-quoted strings"""...""" multi-line string literals in AST, lexer, parser, and formatter
  • Lambda syntax(params) => expr closure syntax replacing fn(params) { ... }
  • Formatter expansion — Significantly expanded expression formatting (~200 lines)
  • Stdlib codegen — New stdlib code generation mappings for storage, excel, and auth modules
  • Checker updatesstorage and strategy recognized as valid agent fields

Runtime & Primitives

  • Array builtins — Expanded array operations (~217 lines of new helpers)
  • Math builtins — New math utility functions
  • Auth improvements — Enhanced auth resolution with credential file and OAuth support
  • Upload enhancements — Expanded file upload handling
  • Workflow improvements — Extended workflow execution capabilities
  • Server updates — Additional server routing and middleware support
  • Store/Memory — Enhanced store and memory management

Stdlib

  • Excel tables — Expanded stdlib/excel with table-based spreadsheet processing
  • Langfuse — Updated Langfuse observability integration
  • Postgres/SQLite — Extended store implementations for both database backends

UI SDK

  • Step component — Expanded haira-step with confirmation UI (~133 lines)
  • Form/Pipeline — Updated form and pipeline components
  • Types — New StepConfirmPayload type export in ARP SDK

Release & Distribution

  • GPG-signed releases — Release archives are now GPG-signed with detached .asc signatures; install script verifies signatures automatically
  • macOS codesign fix — Removed CI ad-hoc codesigning (caused SIGKILL on user machines); install script now performs local ad-hoc codesigning instead
  • Dynamic website version — Website navbar version is now fetched from GitHub Releases API at build time instead of being hardcoded
  • Auto-rebuild on release — Docs workflow now triggers on release: published events so the website updates automatically after each release

Install

curl -fsSL https://haira.dev/install.sh | sh

Full Changelog: v0.4.0...v0.5.2

v0.4.0

08 Mar 15:34

Choose a tag to compare

Changelog

All notable changes to Haira are documented in this file.

[v0.4.0] - 2026-03-08

Agentic Framework

  • Eval framework — New eval top-level declaration and haira eval CLI command for automated agent evaluation with test cases, scoring, and pass/fail thresholds
  • Cross-harness exporthaira build --target claude-code generates .claude/agents/*.md, .claude/commands/*.md, mcp-servers.json, and an MCP server binary for custom tools
  • Tool lifecycle hooks@before { } and @after { } blocks inside tool declarations for pre/post-processing logic
  • Verification loopsverify { assert ... } blocks inside workflow steps that integrate with @retry for automatic assertion-driven retries
  • Agent delegation strategystrategy: "parallel" (fan-out) and strategy: "sequential" (chain) fields on agents with handoffs
  • Pre-built agent templatesstdlib/agents package with 8 reusable templates: CodeReviewer, Planner, SecurityReviewer, Summarizer, DataAnalyst, CustomerSupport, TDDGuide, DocWriter
  • Dynamic agentscreate_agent() runtime support for programmatically creating agents from config maps
  • Auth modulestdlib/auth for API key resolution (env var, credentials file, Claude Code OAuth)

Compiler & Language

  • Stdlib expansion — OS primitives, web search, healthcheck modules, and new UI components
  • Type alias codegentype Name = Type now correctly emits Go type aliases with typed list coercion in struct literals
  • Checker improvements — Deeper type checking, spec alignment, enum exhaustiveness, and websearch/healthcheck module recognition
  • Return value enforcement — Compiler enforces return values in functions
  • LSP improvements — Better IDE support, formatting integration, and tree-sitter grammar fixes
  • Formatterhaira fmt command for in-place source formatting
  • Tree-sitter — Grammar fixes for editor syntax highlighting

Runtime & Infrastructure

  • Built-in providers — Default provider configurations
  • UI theming — Theme support with embedded UI bundle
  • Workflow enhancements — Improved workflow execution, form display, and table rendering
  • ARP/SSE fixes — Proper event: headers for delta and done events in Server-Sent Events
  • Spawn capturespawn { } blocks correctly capture concurrent results

Documentation & Tooling

  • Website — Landing page, multilang docs, SEO, and analytics
  • Spec updates — Language specification aligned with current compiler state
  • Due diligence — Comprehensive code quality review (phases 1-5)
  • New examples — 35 example programs covering all language features
  • POCs — Coding agent, Cloudflare agent, data explorer, DevOps incident, and pipeline form proof-of-concepts

Bug Fixes

  • Fixed driver error handling and CLI decode errors
  • Fixed XSS removal in UI rendering
  • Fixed fmt import detection for tool declarations
  • Fixed cropped text in UI components
  • Fixed umami script type annotation

[v0.3.0] - 2026-02-23

Initial public release with core language, agentic primitives, and Cloudflare Workers target.

Full Changelog: v0.3.0...v0.4.0

v0.3.0

23 Feb 19:35

Choose a tag to compare

v0.3.0 — ARP SDK & Console

Highlights

ARP (Agentic Rendering Protocol) SDK — The protocol that connects agent backends to frontend renderers is now a standalone, reusable monorepo:

  • @haira/arp — Transport-agnostic TypeScript client (WebSocket + SSE), zero DOM dependencies
  • @haira/arp-react — React hooks (useArpChat) and drop-in <ArpChat> component
  • @haira/arp-vue — Vue composables (useArpChat) and <ArpChat> component
  • arp/go/arp — Go server library (bridge, transports, session, middleware)

Interactive Console — New haira console command with a rich terminal UI for managing Haira applications locally (readline, spinners, terminal rendering).

Orchestrator — Process orchestrator for running, monitoring, and proxying multiple Haira services (haira deploy, haira ps, haira logs).

Web UI Overhaulhaira webui serves a dev dashboard with deployment management, workbench, and observe pages. UI SDK refactored to consume @haira/arp instead of bundling its own protocol client.

Changes

  • feat: ARP SDK monorepo — @haira/arp, @haira/arp-react, @haira/arp-vue, arp/go/arp
  • feat: Interactive console (haira console) with readline, rendering, and spinner support
  • feat: Process orchestrator with deploy, proxy, and store
  • feat: Web UI dashboard with deployments page and micro-loader architecture
  • fix: Windows build support — platform-specific terminal stubs for console package
  • fix: CI pipeline — bundle runtime before vet/test (go:embed dependency)
  • chore: Production build pipeline (make publish) with stripped binaries (-s -w)
  • chore: Split UI and server — compiled programs get a micro-loader HTML, full SDK is CLI-only

Breaking Changes

  • UI HTML templates (chat.html, form.html, index.html) removed in favor of loader.html micro-loader
  • ui_chat.go and ui_form.go removed from primitive — UI now rendered client-side via ARP

Install

# macOS (Apple Silicon)
curl -sL https://github.com/mrzdevcore/haira/releases/download/v0.3.0/haira-v0.3.0-darwin-arm64.tar.gz | tar xz
sudo mv haira-v0.3.0-darwin-arm64/bin/haira /usr/local/bin/

# macOS (Intel)
curl -sL https://github.com/mrzdevcore/haira/releases/download/v0.3.0/haira-v0.3.0-darwin-amd64.tar.gz | tar xz
sudo mv haira-v0.3.0-darwin-amd64/bin/haira /usr/local/bin/

# Linux (x86_64)
curl -sL https://github.com/mrzdevcore/haira/releases/download/v0.3.0/haira-v0.3.0-linux-amd64.tar.gz | tar xz
sudo mv haira-v0.3.0-linux-amd64/bin/haira /usr/local/bin/

# Linux (ARM64)
curl -sL https://github.com/mrzdevcore/haira/releases/download/v0.3.0/haira-v0.3.0-linux-arm64.tar.gz | tar xz
sudo mv haira-v0.3.0-linux-arm64/bin/haira /usr/local/bin/

Full Changelog: v0.2.0...v0.3.0

v0.2.0

22 Feb 13:30

Choose a tag to compare

What's New in v0.2.0

This is a major release introducing the Agentic Rendering Protocol (ARP), a complete UI SDK rewrite, and significant runtime enhancements.

Agentic Rendering Protocol (ARP)

  • New transport-agnostic protocol for agent-to-renderer communication
  • WebSocket transport (/_arp/v1) with capability negotiation and auto-reconnect
  • SSE transport preserved for backward compatibility — existing clients work unchanged
  • ArpBridge() — single translation point from StreamChunk to ArpMessage
  • ARP spec defined in spec/arp/ (protocol + component catalog)

New UI SDK (Lit Web Components)

  • Complete rewrite from vanilla JS to Lit web components
  • 12 built-in components: table, status-card, code-block, diff, key-value, progress, form, confirm, choices, chart, product-cards, group
  • <haira-ui-renderer> — universal component renderer with fallback
  • <haira-chat> — full chat interface with WebSocket + SSE dual transport
  • Chat session persistence with history sidebar and session switching

Generative UI

  • Agents render rich UI components via ui.* helpers in tool @render blocks
  • ui.table(), ui.chart(), ui.status_card(), ui.key_value(), ui.progress(), ui.form(), ui.confirm(), ui.choices(), ui.code_block(), ui.diff(), ui.product_cards(), ui.group()
  • Components automatically streamed to connected clients

MCP Support

  • MCP Client: Connect to external MCP servers as tool providers
  • MCP Server: Expose Haira tools via MCP protocol
  • MCP over SSE: Server-Sent Events transport for MCP

Observability

  • observe.langfuse() integration for LLM generation tracing
  • Exporter interface for custom observability backends
  • Auto-detection and tree-shaking of observability providers

New Standard Library Packages

  • vector — Vector database operations (with local and Postgres backends)
  • sqlite — SQLite store backend (auto-included for workflows/servers)
  • langfuse — Langfuse observability exporter

Compiler & Language Enhancements

  • Unit testing support with @test decorator
  • Code formatter
  • Enhanced type checker with better diagnostics
  • Multi-file project support improvements
  • LSP updates for better editor integration
  • Workflow retry mechanism
  • Environment variable enhancements

New Examples

  • 25-embeddings.haira — Vector embeddings
  • 26-rag.haira — Retrieval-Augmented Generation
  • 27-structured-output.haira — Structured agent output
  • 28-observe.haira — Observability with Langfuse
  • 29-testing.haira — Unit testing

Proof of Concepts

  • poc/data-explorer/ — Multi-source data explorer with Postgres, Algolia, Meilisearch

Infrastructure

  • Project restructured: primitive/haira/ (core runtime), stdlib/ (tree-shaken packages)
  • Tree-sitter grammar updates
  • Makefile improvements

Full Changelog: v0.1.1...v0.2.0

v0.1.1

16 Feb 22:30

Choose a tag to compare

Full Changelog: v0.1.0...v0.1.1

v0.1.0

16 Feb 22:18

Choose a tag to compare