ci: Build and run examples.

Author: daavoo

.github/workflows/cmake-multi-platform.yml

@@ -74,13 +74,20 @@ jobs:
     - name: Configure CMake
       # Configure CMake in a 'build' subdirectory. `CMAKE_BUILD_TYPE` is only required if you are using a single-configuration generator such as make.
       # See https://cmake.org/cmake/help/latest/variable/CMAKE_BUILD_TYPE.html?highlight=cmake_build_type
-      run: >
-        cmake -B ${{ steps.strings.outputs.build-output-dir }}
-        -DCMAKE_CXX_COMPILER=${{ matrix.cpp_compiler }}
-        -DCMAKE_C_COMPILER=${{ matrix.c_compiler }}
-        -DCMAKE_BUILD_TYPE=${{ matrix.build_type }}
-        -DAGENT_CPP_BUILD_TESTS=ON
-        -S ${{ github.workspace }}
+      # Examples use POSIX headers (unistd.h) and are only built on non-Windows platforms.
+      shell: bash
+      run: |
+        BUILD_EXAMPLES="OFF"
+        if [ "${{ matrix.os }}" != "windows-latest" ]; then
+          BUILD_EXAMPLES="ON"
+        fi
+        cmake -B ${{ steps.strings.outputs.build-output-dir }} \
+          -DCMAKE_CXX_COMPILER=${{ matrix.cpp_compiler }} \
+          -DCMAKE_C_COMPILER=${{ matrix.c_compiler }} \
+          -DCMAKE_BUILD_TYPE=${{ matrix.build_type }} \
+          -DAGENT_CPP_BUILD_TESTS=ON \
+          -DAGENT_CPP_BUILD_EXAMPLES=$BUILD_EXAMPLES \
+          -S ${{ github.workspace }}
 
     - name: Build
       # Build your program with the given configuration. Note that --config is needed because the default Windows generator is a multi-config generator (Visual Studio generator).
@@ -91,3 +98,16 @@ jobs:
       # Execute tests defined by the CMake configuration. Note that --build-config is needed because the default Windows generator is a multi-config generator (Visual Studio generator).
       # See https://cmake.org/cmake/help/latest/manual/ctest.1.html for more detail
       run: ctest --build-config ${{ matrix.build_type }}
+
+    - name: Verify examples run
+      # Examples use POSIX headers (unistd.h) and are not available on Windows
+      if: matrix.os != 'windows-latest'
+      working-directory: ${{ steps.strings.outputs.build-output-dir }}
+      shell: bash
+      run: |
+        # Verify each example runs (they exit with code 1 when no model is provided, which is expected)
+        for example in shell-example memory-example multi-agent-example context-engineering-example; do
+          echo "Testing $example..."
+          ./$example || test $? -eq 1
+          echo "$example executed successfully (printed usage as expected)"
+        done

CMakeLists.txt

@@ -6,6 +6,7 @@ set(CMAKE_CXX_STANDARD_REQUIRED ON)
 set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
 
 option(AGENT_CPP_BUILD_TESTS "Build agent.cpp tests" OFF)
+option(AGENT_CPP_BUILD_EXAMPLES "Build agent.cpp examples" OFF)
 option(AGENT_CPP_BUNDLED_LLAMA "Bundle llama.cpp (vs. find installed)" ON)
 
 set(LLAMA_CPP_DIR "" CACHE PATH "Path to existing llama.cpp directory (leave empty to use submodule)")
@@ -108,6 +109,66 @@ if(AGENT_CPP_BUILD_TESTS)
     message(STATUS "Tests enabled. Run with: ctest or ./test_tool")
 endif()
 
+if(AGENT_CPP_BUILD_EXAMPLES)
+    # Shell example
+    add_executable(shell-example examples/shell/shell.cpp)
+    target_include_directories(shell-example PRIVATE
+        ${CMAKE_CURRENT_SOURCE_DIR}/src
+        ${CMAKE_CURRENT_SOURCE_DIR}/examples/shared
+        ${LLAMA_SOURCE_DIR}/common
+        ${LLAMA_SOURCE_DIR}/ggml/include
+        ${LLAMA_SOURCE_DIR}/include
+        ${LLAMA_SOURCE_DIR}/vendor
+    )
+    target_link_libraries(shell-example PRIVATE agent model common llama)
+    target_compile_features(shell-example PRIVATE cxx_std_17)
+
+    # Memory example
+    add_executable(memory-example examples/memory/memory.cpp)
+    target_include_directories(memory-example PRIVATE
+        ${CMAKE_CURRENT_SOURCE_DIR}/src
+        ${CMAKE_CURRENT_SOURCE_DIR}/examples/shared
+        ${LLAMA_SOURCE_DIR}/common
+        ${LLAMA_SOURCE_DIR}/ggml/include
+        ${LLAMA_SOURCE_DIR}/include
+        ${LLAMA_SOURCE_DIR}/vendor
+    )
+    target_link_libraries(memory-example PRIVATE agent model common llama)
+    target_compile_features(memory-example PRIVATE cxx_std_17)
+
+    # Multi-agent example
+    add_executable(multi-agent-example examples/multi-agent/multi-agent.cpp)
+    target_include_directories(multi-agent-example PRIVATE
+        ${CMAKE_CURRENT_SOURCE_DIR}/src
+        ${CMAKE_CURRENT_SOURCE_DIR}/examples/shared
+        ${LLAMA_SOURCE_DIR}/common
+        ${LLAMA_SOURCE_DIR}/ggml/include
+        ${LLAMA_SOURCE_DIR}/include
+        ${LLAMA_SOURCE_DIR}/vendor
+    )
+    target_link_libraries(multi-agent-example PRIVATE agent model common llama)
+    target_compile_features(multi-agent-example PRIVATE cxx_std_17)
+
+    # Context engineering example
+    add_executable(context-engineering-example examples/context-engineering/context-engineering.cpp)
+    target_include_directories(context-engineering-example PRIVATE
+        ${CMAKE_CURRENT_SOURCE_DIR}/src
+        ${CMAKE_CURRENT_SOURCE_DIR}/examples/shared
+        ${LLAMA_SOURCE_DIR}/common
+        ${LLAMA_SOURCE_DIR}/ggml/include
+        ${LLAMA_SOURCE_DIR}/include
+        ${LLAMA_SOURCE_DIR}/vendor
+    )
+    target_link_libraries(context-engineering-example PRIVATE agent model common llama)
+    target_compile_features(context-engineering-example PRIVATE cxx_std_17)
+
+    # Note: tracing-example is not included here as it requires additional
+    # dependencies (OpenTelemetry, protobuf, curl). Build it separately from
+    # examples/tracing/
+
+    message(STATUS "Examples enabled.")
+endif()
+
 option(AGENT_CPP_INSTALL "Generate install target" OFF)
 
 if(AGENT_CPP_INSTALL)