​

GAIA v0.16.0 Release Notes

• New: C++17 Agent Framework — Full native agent framework with MCP support, tool registry, and state machine — no Python needed
• New: Health Agent & WiFi Agent — Two production-ready C++ example agents for Windows system diagnostics
• New: CleanConsole — Polished terminal UI for C++ agents with ANSI colors and word-wrap
• New: C++ CI/CD Pipeline — Cross-platform build + STX hardware integration tests
• Security: 37 alerts resolved — 15 Dependabot + 22 code scanning alerts fixed across Python and JavaScript
• Docs: Site reorganization — C++ Framework gets dedicated top-level section, SDK accuracy fixes, sidebar icons, 17+ broken links repaired

​

What’s New

​

C++17 Agent Framework

• Agent state machine — PLANNING -> EXECUTING_PLAN -> DIRECT_EXECUTION -> ERROR_RECOVERY -> COMPLETION
• ToolRegistry with tool name resolution (unprefixed MCP name suffix match, case-insensitive fallback)
• MCP client with cross-platform stdio transport (Win32 CreateProcess + POSIX fork/exec), JSON-RPC 2.0, mcp_<server>_<tool> naming convention
• JSON parsing with 4-strategy fallback: direct parse, code-block extraction, bracket-matching, regex field extraction
• Parameter substitution — $PREV.field / $STEP_N.field across plan steps
• OpenAI-compatible HTTP client via cpp-httplib

#include <gaia/agent.h>

int main() {
    gaia::AgentConfig config;
    config.baseUrl = "http://localhost:8000/api/v1";
    config.modelId = "Qwen3-4B-Instruct-2507-GGUF";

    gaia::Agent agent(config);
    agent.processQuery("Check system health");
    return 0;
}

cd cpp
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release

​

Health Agent (C++)

​

WiFi Agent (C++)

​

CleanConsole (C++)

​

C++ CI/CD Pipeline

• Cloud CI: Ubuntu + Windows builds with mock unit tests, install verification, shared library builds
• STX hardware integration tests: LLM, MCP, WiFi, and Health agent tests on real AMD hardware
• Uses Qwen3-4B-Instruct-2507-GGUF model for integration testing
• Sequential test execution (-j 1) to prevent LLM server contention

​

Security

​

Dependabot & Code Scanning Fixes

​

Documentation

​

Site Reorganization

• C++ Framework promoted — Dedicated top-level “C++ Framework” section in the Documentation tab with setup, quickstart, overview, integration guides, user guides, and API reference
• SDK Reference reorganized — Split hybrid Chat guide into User Guide and SDK Reference; merged MCP Client guide into SDK Reference
• Welcome page improved — Get Started section before Capabilities; Python/C++ tabs with distinct feature cards
• Sidebar icons — 48 documentation pages now have Font Awesome sidebar icons
• SDK accuracy — Fixed 13 code examples to match actual source code (quick_chat() return type, create_client() factory pattern, process_query() method name, execution_state attribute, max_steps default, @tool decorator behavior)
• Broken links — 17+ broken internal links repaired; redirects added for all moved pages
• Copyright updated — 2024-2026 across all pages

​

C++ Documentation

• docs/cpp/setup.mdx — Build requirements and installation
• docs/cpp/quickstart.mdx — Build your first C++ agent
• docs/cpp/overview.mdx — Architecture and components
• docs/cpp/integration.mdx — Integrating gaia_core into your project
• docs/cpp/custom-agent.mdx — Building custom agents
• docs/cpp/health-agent.mdx — Windows system health monitoring
• docs/cpp/wifi-agent.mdx — Network diagnostic agent
• docs/cpp/api-reference.mdx — Complete API reference

​

Bug Fixes

• C++ agent loop detection — Compare both tool name AND arguments to prevent false positives on consecutive mcp_windows_Shell calls with different args
• C++ tool result truncation — Reduce from 20K to 4K chars to prevent context overflow with small models
• C++ CI integration tests — Run with -j 1 to prevent tests from competing for the single LLM server; increase timeout from 20 to 30 minutes
• PowerShell API — Fix Get-WmiObject to Get-CimInstance in health agent

​

Upgrade

# Install/upgrade GAIA (Python)
pip install --upgrade amd-gaia

# Build C++ framework
cd cpp
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release

​

Full Changelog

• 99394d3 - Add C++17 agent framework port (#351)
• fdaa0cb - Fix Dependabot and code scanning security alerts (#352)
• 1ed7c00 - C++ framework: docs, CI integration tests, health agent improvements (#425)
• 5fac5a9 - Reorganize documentation site and fix SDK accuracy issues (#427)