test: add E2E tests for parity sync features

examples/attachments.cpp

@@ -38,7 +38,7 @@ int main()
     try
     {
         copilot::ClientOptions options;
-        options.log_level = "info";
+        options.log_level = copilot::LogLevel::Info;
 
         copilot::Client client(options);
 

examples/basic_chat.cpp

@@ -14,7 +14,7 @@ int main()
     {
         // Create client with default options (uses stdio transport)
         copilot::ClientOptions options;
-        options.log_level = "info";
+        options.log_level = copilot::LogLevel::Info;
 
         copilot::Client client(options);
 

examples/byok.cpp

@@ -76,7 +76,7 @@ int main(int argc, char* argv[])
 
         // Create client
         copilot::ClientOptions options;
-        options.log_level = "info";
+        options.log_level = copilot::LogLevel::Info;
 
         copilot::Client client(options);
 

examples/compaction_events.cpp

@@ -23,7 +23,7 @@ int main()
     try
     {
         copilot::ClientOptions options;
-        options.log_level = "info";
+        options.log_level = copilot::LogLevel::Info;
 
         copilot::Client client(options);
 

examples/custom_agents.cpp

@@ -23,7 +23,7 @@ int main()
     try
     {
         copilot::ClientOptions options;
-        options.log_level = "info";
+        options.log_level = copilot::LogLevel::Info;
 
         copilot::Client client(options);
 

examples/fluent_tools.cpp

@@ -150,7 +150,7 @@ int main()
         std::cout << "=== Starting Copilot Session ===\n\n";
 
         ClientOptions opts;
-        opts.log_level = "info";
+        opts.log_level = LogLevel::Info;
         opts.use_stdio = true;
         Client client(opts);
 

examples/list_models.cpp

@@ -19,7 +19,7 @@ int main()
     try
     {
         copilot::ClientOptions options;
-        options.log_level = "info";
+        options.log_level = copilot::LogLevel::Info;
 
         copilot::Client client(options);
 

examples/mcp/inprocess/mcp_inprocess.cpp

@@ -195,7 +195,7 @@ int main()
         std::cout << "Creating Copilot SDK client...\n";
 
         copilot::ClientOptions client_opts;
-        client_opts.log_level = "info";
+        client_opts.log_level = copilot::LogLevel::Info;
 
         copilot::Client client(client_opts);
         client.start().get();

examples/mcp_servers.cpp

@@ -23,7 +23,7 @@ int main()
     try
     {
         copilot::ClientOptions options;
-        options.log_level = "info";
+        options.log_level = copilot::LogLevel::Info;
 
         copilot::Client client(options);
 

examples/permission_callback.cpp

@@ -62,7 +62,7 @@ int main()
 
         // Create client
         copilot::ClientOptions options;
-        options.log_level = "info";
+        options.log_level = copilot::LogLevel::Info;
 
         copilot::Client client(options);
 

examples/reasoning_effort.cpp

@@ -63,7 +63,7 @@ int main()
 
         // Create session with reasoning effort
         copilot::SessionConfig config;
-        config.reasoning_effort = "medium";
+        config.reasoning_effort = copilot::ReasoningEffort::Medium;
 
         // Permission handler
         config.on_permission_request = [](const copilot::PermissionRequest&)

examples/resume_with_tools.cpp

@@ -39,19 +39,19 @@ copilot::ToolResultObject secret_handler(const copilot::ToolInvocation& invocati
         if (it != secrets.end())
         {
             result.text_result_for_llm = "Secret value for '" + key + "': " + it->second;
-            result.result_type = "success";
+            result.result_type = copilot::ToolResultType::Success;
         }
         else
         {
             result.text_result_for_llm = "No secret found for key: " + key;
-            result.result_type = "failure";
+            result.result_type = copilot::ToolResultType::Failure;
             result.error = "Key not found";
         }
     }
     catch (const std::exception& e)
     {
         result.text_result_for_llm = "Error retrieving secret";
-        result.result_type = "failure";
+        result.result_type = copilot::ToolResultType::Failure;
         result.error = e.what();
     }
 
@@ -64,7 +64,7 @@ int main()
     {
         // Create client
         copilot::ClientOptions options;
-        options.log_level = "info";
+        options.log_level = copilot::LogLevel::Info;
         copilot::Client client(options);
 
         std::cout << "=== Phase 1: Create Initial Session ===\n\n";

examples/streaming.cpp

@@ -23,7 +23,7 @@ int main(int argc, char* argv[])
     {
         // Create client with streaming enabled
         copilot::ClientOptions options;
-        options.log_level = "info";
+        options.log_level = copilot::LogLevel::Info;
 
         copilot::Client client(options);
 

examples/system_prompt.cpp

@@ -72,7 +72,7 @@ int main()
     try
     {
         copilot::ClientOptions options;
-        options.log_level = "info";
+        options.log_level = copilot::LogLevel::Info;
 
         copilot::Client client(options);
 

examples/tool_progress.cpp

@@ -42,7 +42,7 @@ copilot::ToolResultObject word_count_handler(const copilot::ToolInvocation& invo
     }
     catch (const std::exception& e)
     {
-        result.result_type = "failure";
+        result.result_type = copilot::ToolResultType::Failure;
         result.error = e.what();
         result.text_result_for_llm = std::string("Error: ") + e.what();
     }
@@ -70,7 +70,7 @@ copilot::ToolResultObject search_handler(const copilot::ToolInvocation& invocati
     }
     catch (const std::exception& e)
     {
-        result.result_type = "failure";
+        result.result_type = copilot::ToolResultType::Failure;
         result.error = e.what();
         result.text_result_for_llm = std::string("Error: ") + e.what();
     }
@@ -83,7 +83,7 @@ int main()
     try
     {
         copilot::ClientOptions options;
-        options.log_level = "info";
+        options.log_level = copilot::LogLevel::Info;
 
         copilot::Client client(options);
 

examples/tools.cpp

@@ -46,7 +46,7 @@ copilot::ToolResultObject calculate_handler(const copilot::ToolInvocation& invoc
         {
             if (b == 0)
             {
-                result.result_type = "failure";
+                result.result_type = copilot::ToolResultType::Failure;
                 result.error = "Division by zero";
                 result.text_result_for_llm = "Error: Cannot divide by zero";
                 return result;
@@ -59,7 +59,7 @@ copilot::ToolResultObject calculate_handler(const copilot::ToolInvocation& invoc
         }
         else
         {
-            result.result_type = "failure";
+            result.result_type = copilot::ToolResultType::Failure;
             result.error = "Unknown operation: " + operation;
             result.text_result_for_llm = "Error: Unknown operation '" + operation + "'";
             return result;
@@ -72,7 +72,7 @@ copilot::ToolResultObject calculate_handler(const copilot::ToolInvocation& invoc
     }
     catch (const std::exception& e)
     {
-        result.result_type = "failure";
+        result.result_type = copilot::ToolResultType::Failure;
         result.error = e.what();
         result.text_result_for_llm = std::string("Error: ") + e.what();
     }
@@ -105,7 +105,7 @@ copilot::ToolResultObject get_time_handler(const copilot::ToolInvocation& invoca
     }
     catch (const std::exception& e)
     {
-        result.result_type = "failure";
+        result.result_type = copilot::ToolResultType::Failure;
         result.error = e.what();
         result.text_result_for_llm = std::string("Error: ") + e.what();
     }
@@ -132,7 +132,7 @@ int main()
     {
         // Create client
         copilot::ClientOptions options;
-        options.log_level = "info";
+        options.log_level = copilot::LogLevel::Info;
 
         copilot::Client client(options);
 

include/copilot/client.hpp

@@ -29,6 +29,7 @@ namespace copilot
 
 // Forward declaration
 class Session;
+class Subscription;
 
 // =============================================================================
 // Request Builder Helpers (for unit testing request JSON shape)
@@ -57,7 +58,7 @@ json build_session_resume_request(const std::string& session_id, const ResumeSes
 /// Example usage:
 /// @code
 /// ClientOptions opts;
-/// opts.log_level = "debug";
+/// opts.log_level = LogLevel::Debug;
 ///
 /// Client client(opts);
 /// client.start().get();
@@ -95,8 +96,8 @@ class Client
 
     /// Stop the client gracefully
     /// Destroys all sessions and closes the connection
-    /// @return Future that completes when stopped
-    std::future<void> stop();
+    /// @return Future that completes with any errors encountered during cleanup
+    std::future<std::vector<StopError>> stop();
 
     /// Force stop the client immediately
     /// Kills the CLI process without graceful cleanup
@@ -156,6 +157,24 @@ class Client
     /// @throws Error if not authenticated
     std::future<std::vector<ModelInfo>> list_models();
 
+    // =========================================================================
+    // Lifecycle Events
+    // =========================================================================
+
+    /// Subscribe to session lifecycle events (created, deleted, updated, foreground, background)
+    using LifecycleHandler = std::function<void(const SessionLifecycleEvent&)>;
+    Subscription on_lifecycle(LifecycleHandler handler);
+
+    // =========================================================================
+    // Foreground Session
+    // =========================================================================
+
+    /// Get the current foreground session ID
+    std::future<std::optional<std::string>> get_foreground_session_id();
+
+    /// Set the foreground session
+    std::future<void> set_foreground_session_id(const std::string& session_id);
+
     // =========================================================================
     // Internal API (used by Session)
     // =========================================================================
@@ -221,6 +240,10 @@ class Client
     // Models cache
     mutable std::mutex models_cache_mutex_;
     std::optional<std::vector<ModelInfo>> models_cache_;
+
+    // Lifecycle handlers
+    mutable std::mutex lifecycle_mutex_;
+    std::vector<LifecycleHandler> lifecycle_handlers_;
 };
 
 } // namespace copilot