Initial commit: C++ Agent Architecture

Author: Rayed-Hasan

.gitignore

@@ -0,0 +1,61 @@
+# Prerequisites
+*.d
+
+# Compiled Object files
+*.slo
+*.lo
+*.o
+*.obj
+
+# Precompiled Headers
+*.gch
+*.pch
+
+# Compiled Dynamic libraries
+*.so
+*.dylib
+*.dll
+
+# Fortran module files
+*.mod
+*.smod
+
+# Compiled Static libraries
+*.lai
+*.la
+*.a
+*.lib
+
+# Executables
+*.exe
+*.out
+*.app
+
+# CMake
+CMakeCache.txt
+CMakeFiles
+CMakeScripts
+Testing
+Makefile
+cmake_install.cmake
+install_manifest.txt
+compile_commands.json
+CTestTestfile.cmake
+_deps
+build/
+bin/
+out/
+
+# Visual Studio
+.vs/
+*.sln
+*.vcxproj
+*.vcxproj.user
+*.vcxproj.filters
+
+# CLion
+.idea/
+cmake-build-*/
+
+# VS Code
+.vscode/

CMakeLists.txt

@@ -0,0 +1,95 @@
+cmake_minimum_required(VERSION 3.20)
+project(claw-cpp VERSION 0.1.0 LANGUAGES CXX)
+
+set(CMAKE_CXX_STANDARD 20)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+
+# ── Dependencies via FetchContent ─────────────────────────────────────────
+
+include(FetchContent)
+
+# nlohmann/json — industry standard JSON library
+FetchContent_Declare(json
+    GIT_REPOSITORY https://github.com/nlohmann/json.git
+    GIT_TAG        v3.11.3
+    GIT_SHALLOW    TRUE
+)
+
+# cpp-httplib — lightweight HTTP/HTTPS client
+FetchContent_Declare(httplib
+    GIT_REPOSITORY https://github.com/yhirose/cpp-httplib.git
+    GIT_TAG        v0.15.3
+    GIT_SHALLOW    TRUE
+)
+
+# CLI11 — modern CLI argument parser
+FetchContent_Declare(cli11
+    GIT_REPOSITORY https://github.com/CLIUtils/CLI11.git
+    GIT_TAG        v2.4.1
+    GIT_SHALLOW    TRUE
+)
+
+# fmt — type-safe formatting (with color support)
+FetchContent_Declare(fmt
+    GIT_REPOSITORY https://github.com/fmtlib/fmt.git
+    GIT_TAG        10.2.1
+    GIT_SHALLOW    TRUE
+)
+
+FetchContent_MakeAvailable(json httplib cli11 fmt)
+
+# ── OpenSSL for HTTPS support ─────────────────────────────────────────────
+
+find_package(OpenSSL QUIET)
+if(OPENSSL_FOUND)
+    message(STATUS "OpenSSL found — HTTPS enabled")
+else()
+    message(WARNING
+        "OpenSSL NOT found — HTTPS will NOT work.\n"
+        "Install OpenSSL and re-run cmake, or set OPENSSL_ROOT_DIR.\n"
+        "On Windows: winget install ShiningLight.OpenSSL"
+    )
+endif()
+
+# ── Core static library ──────────────────────────────────────────────────
+
+add_library(claw_core STATIC
+    src/api/client.cpp
+    src/runtime/session.cpp
+    src/tools/bash_tool.cpp
+    src/tools/file_read_tool.cpp
+    src/tools/file_write_tool.cpp
+)
+
+target_include_directories(claw_core PUBLIC
+    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/src>
+)
+
+target_link_libraries(claw_core PUBLIC
+    nlohmann_json::nlohmann_json
+    httplib::httplib
+    fmt::fmt
+)
+
+# Link OpenSSL if available and enable HTTPS in cpp-httplib
+if(OPENSSL_FOUND)
+    target_compile_definitions(claw_core PUBLIC CPPHTTPLIB_OPENSSL_SUPPORT)
+    target_link_libraries(claw_core PUBLIC OpenSSL::SSL OpenSSL::Crypto)
+endif()
+
+# Platform-specific networking libraries
+if(WIN32)
+    target_link_libraries(claw_core PUBLIC ws2_32 crypt32)
+endif()
+
+# ── Main executable ──────────────────────────────────────────────────────
+
+add_executable(claw-cpp
+    src/cli/main.cpp
+)
+
+target_link_libraries(claw-cpp PRIVATE
+    claw_core
+    CLI11::CLI11
+)

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,113 @@
+# Claw Code (C++ Edition) 🚀
+
+![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)
+![C++20](https://img.shields.io/badge/C++-20-blue.svg)
+![Build](https://img.shields.io/badge/build-CMake-green.svg)
+
+A clean-room, highly-performant C++20 reimplementation of the **Claw Code AI Agent Harness**. 
+
+Rather than being a simple chatbot that stops after a single reply, this is an **agentic loop architecture**. It integrates deeply with the Anthropic Messages API, sending explicit tool schemas to the model, and recursively executing local tools (like Bash and File I/O) on behalf of the AI until a task is completed.
+
+---
+
+## ⚡ Features
+
+- **True Agentic Tool Loop:** Context-aware routing and recursive API calls.
+- **Interactive REPL & One-Shot:** Native slash commands (`/quit`, `/clear`, `/usage`) and one-shot prompt scripts.
+- **Built-in Tooling Layer:**
+  - `BashTool`: Execute local shell scripts with configurable timeouts and output truncation guards.
+  - `FileReadTool`: Read files up to 512KB to inspect codebases safely.
+  - `FileWriteTool`: Write strings to files with automatic parent-directory creation.
+- **Native Static Binary:** Builds to a fast, statically linked binary. Zero python/npm dependencies.
+- **Context Compaction:** Auto-trims history past a certain turn limit to keep token window budgets low.
+
+## 🏗️ Architecture Design
+
+```mermaid
+graph TD
+    User["User Input"] --> CLI["CLI Layer<br/>main.cpp"]
+    CLI --> |"REPL or one-shot"| Session["Runtime Session<br/>session.cpp"]
+    Session --> |"messages + tool defs"| API["API Client<br/>client.cpp"]
+    API --> |"HTTP POST"| Anthropic["Anthropic API"]
+    Anthropic --> |"stop=end_turn"| Session
+    Anthropic --> |"stop=tool_use"| ToolLoop["Agentic Tool Loop"]
+    ToolLoop --> Registry["Tool Registry"]
+    Registry --> Bash["BashTool"]
+    Registry --> FileRead["FileReadTool"]
+    Registry --> FileWrite["FileWriteTool"]
+    Bash --> |"result"| ToolLoop
+    FileRead --> |"result"| ToolLoop
+    FileWrite --> |"result"| ToolLoop
+    ToolLoop --> |"tool_result message"| Session
+    Session --> |"final text"| CLI
+    CLI --> |"display"| User
+```
+
+## 📁 Workspace Layout
+
+```
+claw-cpp-public/
+├── CMakeLists.txt                    # Modern CMake build instructions
+├── LICENSE                           # MIT License
+├── README.md                         # This file
+└── src/
+    ├── api/                          
+    │   ├── client.cpp/hpp            # HTTPS logic via cpp-httplib
+    │   └── types.hpp                 # Rich API content block modeling (Variant)
+    ├── cli/                          
+    │   └── main.cpp                  # REPL CLI Interface & entrypoint
+    ├── runtime/                      
+    │   └── session.cpp/hpp           # Core agentic recursion loop
+    └── tools/                        
+        ├── itool.hpp                 # Modular Plugin interface
+        ├── tool_registry.hpp         # Maps plugin names to logic
+        ├── bash_tool.cpp/hpp         # Safe shell execution
+        ├── file_read_tool.cpp/hpp    
+        └── file_write_tool.cpp/hpp   
+```
+
+## 🚀 Getting Started
+
+### Prerequisites
+
+You need a C++20 compatible compiler and CMake.
+For Windows users, you can use Winget:
+```powershell
+winget install Kitware.CMake
+winget install Microsoft.VisualStudio.2022.BuildTools --override "--wait --quiet --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended"
+winget install ShiningLight.OpenSSL # Needed for HTTPS network calls
+```
+
+### Build Instructions
+
+```bash
+mkdir build
+cd build
+
+# Configure CMake (it will auto-download cpp-httplib, nlohmann-json, fmt, and CLI11)
+cmake .. 
+
+# Build the release binary
+cmake --build . --config Release
+```
+
+### Usage
+
+Export your API Key to the environment:
+```powershell
+# Windows
+$env:ANTHROPIC_API_KEY="sk-ant-..."
+
+# macOS/Linux
+export ANTHROPIC_API_KEY="sk-ant-..."
+```
+
+Run the REPL:
+```bash
+./Release/claw-cpp
+```
+
+Run a one-shot query:
+```bash
+./Release/claw-cpp prompt "List the files in this directory and tell me what they are."
+```

src/api/client.cpp

@@ -0,0 +1,72 @@
+#include "client.hpp"
+#include <httplib.h>
+#include <fmt/core.h>
+
+namespace claw::api {
+
+    Client::Client(ClientConfig config) : m_config(std::move(config)) {}
+
+    std::optional<TurnResponse> Client::send_request(
+        const std::string& system_prompt,
+        const std::vector<Message>& messages,
+        const nlohmann::json& tools_json
+    ) {
+        // ── Build the HTTP client ────────────────────────────────────────
+        httplib::Client http(m_config.base_url);
+        http.set_read_timeout(m_config.timeout_sec, 0);
+        http.set_connection_timeout(10, 0);
+
+        httplib::Headers headers = {
+            {"x-api-key",         m_config.api_key},
+            {"anthropic-version", m_config.api_version},
+            {"content-type",      "application/json"}
+        };
+
+        // ── Build the JSON payload ───────────────────────────────────────
+        nlohmann::json payload;
+        payload["model"]      = m_config.model;
+        payload["max_tokens"] = m_config.max_tokens;
+
+        if (!system_prompt.empty()) {
+            payload["system"] = system_prompt;
+        }
+
+        // Serialize our rich Message objects
+        nlohmann::json messages_json = nlohmann::json::array();
+        for (const auto& msg : messages) {
+            messages_json.push_back(msg.to_json());
+        }
+        payload["messages"] = messages_json;
+
+        // Include tool definitions if we have any registered tools
+        if (!tools_json.empty()) {
+            payload["tools"] = tools_json;
+        }
+
+        // ── Execute the POST request ─────────────────────────────────────
+        std::string body = payload.dump();
+        auto res = http.Post("/v1/messages", headers, body, "application/json");
+
+        if (!res) {
+            fmt::print(stderr, "[API Error] Request failed: {}\n",
+                       httplib::to_string(res.error()));
+            return std::nullopt;
+        }
+
+        if (res->status != 200) {
+            fmt::print(stderr, "[API Error] Status {}: {}\n",
+                       res->status, res->body);
+            return std::nullopt;
+        }
+
+        // ── Parse the response ───────────────────────────────────────────
+        try {
+            auto response_json = nlohmann::json::parse(res->body);
+            return TurnResponse::from_json(response_json);
+        } catch (const nlohmann::json::exception& e) {
+            fmt::print(stderr, "[API Error] JSON parse failure: {}\n", e.what());
+            return std::nullopt;
+        }
+    }
+
+} // namespace claw::api