feat: Add caching Claude provider

test/CMakeLists.txt

@@ -3,6 +3,7 @@ add_executable(QodeAssistTest
     ../LLMClientInterface.cpp
     ../LLMSuggestion.cpp
     CodeHandlerTest.cpp
+    ClaudeCacheControlTest.cpp
     DocumentContextReaderTest.cpp
     LLMSuggestionTest.cpp
     # LLMClientInterfaceTests.cpp
@@ -21,6 +22,8 @@ target_link_libraries(QodeAssistTest PRIVATE
     LLMQore
 )
 
+target_include_directories(QodeAssistTest PRIVATE ${CMAKE_SOURCE_DIR})
+
 target_compile_definitions(QodeAssistTest PRIVATE CMAKE_CURRENT_SOURCE_DIR="${CMAKE_CURRENT_SOURCE_DIR}")
 
 add_test(NAME QodeAssistTest COMMAND QodeAssistTest)

test/ClaudeCacheControlTest.cpp

@@ -0,0 +1,181 @@
+// Copyright (C) 2024-2026 Petr Mironychev
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+#include <gtest/gtest.h>
+
+#include <QJsonArray>
+#include <QJsonObject>
+
+#include "providers/ClaudeCacheControl.hpp"
+
+using namespace QodeAssist::Providers::ClaudeCacheControl;
+
+namespace {
+
+QJsonObject expectedEphemeral(bool extendedTtl)
+{
+    QJsonObject obj{{"type", "ephemeral"}};
+    if (extendedTtl)
+        obj["ttl"] = "1h";
+    return obj;
+}
+
+} // namespace
+
+TEST(ClaudeCacheControlTest, BreakpointWithoutExtendedTTL)
+{
+    const QJsonObject cc = buildBreakpoint(false);
+    EXPECT_EQ(cc.value("type").toString(), "ephemeral");
+    EXPECT_FALSE(cc.contains("ttl"));
+}
+
+TEST(ClaudeCacheControlTest, BreakpointWithExtendedTTL)
+{
+    const QJsonObject cc = buildBreakpoint(true);
+    EXPECT_EQ(cc.value("type").toString(), "ephemeral");
+    EXPECT_EQ(cc.value("ttl").toString(), "1h");
+}
+
+TEST(ClaudeCacheControlTest, SystemAsStringWrappedIntoArray)
+{
+    QJsonObject request;
+    request["system"] = "you are a helpful agent";
+
+    apply(request, false);
+
+    ASSERT_TRUE(request.value("system").isArray());
+    const QJsonArray sys = request.value("system").toArray();
+    ASSERT_EQ(sys.size(), 1);
+
+    const QJsonObject block = sys.first().toObject();
+    EXPECT_EQ(block.value("type").toString(), "text");
+    EXPECT_EQ(block.value("text").toString(), "you are a helpful agent");
+    EXPECT_EQ(block.value("cache_control").toObject(), expectedEphemeral(false));
+}
+
+TEST(ClaudeCacheControlTest, EmptySystemStringIsNotWrapped)
+{
+    QJsonObject request;
+    request["system"] = "";
+
+    apply(request, false);
+
+    EXPECT_TRUE(request.value("system").isString());
+}
+
+TEST(ClaudeCacheControlTest, SystemAsArrayMarksLastBlock)
+{
+    QJsonObject request;
+    request["system"] = QJsonArray{
+        QJsonObject{{"type", "text"}, {"text", "a"}},
+        QJsonObject{{"type", "text"}, {"text", "b"}}};
+
+    apply(request, false);
+
+    const QJsonArray sys = request.value("system").toArray();
+    ASSERT_EQ(sys.size(), 2);
+    EXPECT_FALSE(sys[0].toObject().contains("cache_control"));
+    EXPECT_EQ(sys[1].toObject().value("cache_control").toObject(), expectedEphemeral(false));
+}
+
+TEST(ClaudeCacheControlTest, ToolsLastEntryGetsCacheControl)
+{
+    QJsonObject request;
+    request["tools"] = QJsonArray{
+        QJsonObject{{"name", "read_file"}},
+        QJsonObject{{"name", "edit_file"}},
+        QJsonObject{{"name", "search"}}};
+
+    apply(request, true);
+
+    const QJsonArray tools = request.value("tools").toArray();
+    ASSERT_EQ(tools.size(), 3);
+    EXPECT_FALSE(tools[0].toObject().contains("cache_control"));
+    EXPECT_FALSE(tools[1].toObject().contains("cache_control"));
+    EXPECT_EQ(tools[2].toObject().value("cache_control").toObject(), expectedEphemeral(true));
+}
+
+TEST(ClaudeCacheControlTest, SingleMessageHistorySkipped)
+{
+    QJsonObject request;
+    request["messages"]
+        = QJsonArray{QJsonObject{{"role", "user"}, {"content", "first message"}}};
+
+    apply(request, false);
+
+    const QJsonArray msgs = request.value("messages").toArray();
+    ASSERT_EQ(msgs.size(), 1);
+    EXPECT_TRUE(msgs[0].toObject().value("content").isString());
+}
+
+TEST(ClaudeCacheControlTest, HistoryBreakpointOnSecondToLastMessage)
+{
+    QJsonObject request;
+    request["messages"] = QJsonArray{
+        QJsonObject{{"role", "user"}, {"content", "u1"}},
+        QJsonObject{{"role", "assistant"}, {"content", "a1"}},
+        QJsonObject{{"role", "user"}, {"content", "u2-current"}}};
+
+    apply(request, false);
+
+    const QJsonArray msgs = request.value("messages").toArray();
+    ASSERT_EQ(msgs.size(), 3);
+
+    EXPECT_TRUE(msgs[0].toObject().value("content").isString());
+
+    const QJsonArray a1Content = msgs[1].toObject().value("content").toArray();
+    ASSERT_EQ(a1Content.size(), 1);
+    EXPECT_EQ(a1Content.first().toObject().value("text").toString(), "a1");
+    EXPECT_EQ(
+        a1Content.first().toObject().value("cache_control").toObject(),
+        expectedEphemeral(false));
+
+    EXPECT_TRUE(msgs[2].toObject().value("content").isString());
+}
+
+TEST(ClaudeCacheControlTest, HistoryArrayContentMarksLastBlock)
+{
+    QJsonObject request;
+    request["messages"] = QJsonArray{
+        QJsonObject{
+            {"role", "user"},
+            {"content",
+             QJsonArray{
+                 QJsonObject{{"type", "text"}, {"text", "describe this"}},
+                 QJsonObject{{"type", "image"}}}}},
+        QJsonObject{{"role", "assistant"}, {"content", "ok"}}};
+
+    apply(request, false);
+
+    const QJsonArray msgs = request.value("messages").toArray();
+    const QJsonArray content = msgs[0].toObject().value("content").toArray();
+    ASSERT_EQ(content.size(), 2);
+    EXPECT_FALSE(content[0].toObject().contains("cache_control"));
+    EXPECT_EQ(content[1].toObject().value("cache_control").toObject(), expectedEphemeral(false));
+}
+
+TEST(ClaudeCacheControlTest, NoSystemNoToolsNoMessagesIsNoop)
+{
+    QJsonObject request;
+    request["model"] = "claude-sonnet-4-5";
+    request["max_tokens"] = 1024;
+
+    apply(request, false);
+
+    EXPECT_EQ(request.value("model").toString(), "claude-sonnet-4-5");
+    EXPECT_EQ(request.value("max_tokens").toInt(), 1024);
+    EXPECT_FALSE(request.contains("system"));
+    EXPECT_FALSE(request.contains("tools"));
+    EXPECT_FALSE(request.contains("messages"));
+}
+
+TEST(ClaudeCacheControlTest, EmptyToolsArrayIsNoop)
+{
+    QJsonObject request;
+    request["tools"] = QJsonArray{};
+
+    apply(request, false);
+
+    EXPECT_TRUE(request.value("tools").isArray());
+    EXPECT_TRUE(request.value("tools").toArray().isEmpty());
+}