Expose adaptive context APIs for Swift LLM

sdk/runanywhere-commons/exports/RACommons.exports

@@ -534,16 +534,22 @@ _rac_platform_tts_set_callbacks
 # Kotlin bridges during the proto-byte migration (CPP_PROTO_OWNERSHIP.md §2.1).
 _rac_llm_cancel
 _rac_llm_component_cancel
+_rac_llm_component_append_context
 _rac_llm_component_cleanup
+_rac_llm_component_clear_context
 _rac_llm_component_create
 _rac_llm_component_destroy
 _rac_llm_component_generate
+_rac_llm_component_generate_from_context
 _rac_llm_component_generate_stream
 _rac_llm_component_get_model_id
+_rac_llm_component_inject_system_prompt
 _rac_llm_component_is_loaded
 _rac_llm_component_load_model
 _rac_llm_component_supports_streaming
 _rac_llm_component_unload
+_rac_llm_append_context_lifecycle
+_rac_llm_clear_context_lifecycle
 _rac_llm_create
 _rac_llm_generate
 _rac_llm_generate_stream
@@ -949,7 +955,9 @@ _rac_llm_component_load_lora
 _rac_llm_component_remove_lora
 _rac_llm_destroy
 _rac_llm_generate_from_context
+_rac_llm_generate_from_context_proto
 _rac_llm_get_info
+_rac_llm_inject_system_prompt_lifecycle
 _rac_llm_initialize
 _rac_llm_inject_system_prompt
 _rac_llm_platform_create

sdk/runanywhere-commons/include/rac/features/llm/rac_llm_component.h

@@ -226,6 +226,64 @@ RAC_API rac_lifecycle_state_t rac_llm_component_get_state(rac_handle_t handle);
 RAC_API rac_result_t rac_llm_component_get_metrics(rac_handle_t handle,
                                                    rac_lifecycle_metrics_t* out_metrics);
 
+// =============================================================================
+// ADAPTIVE CONTEXT API
+// =============================================================================
+
+/**
+ * @brief Inject a system prompt into the loaded model's adaptive context
+ *
+ * Clears existing KV cache, then seeds it with the given prompt.
+ * Optional - returns RAC_ERROR_NOT_SUPPORTED if backend doesn't support it.
+ *
+ * @param handle Component handle
+ * @param prompt System prompt text
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_llm_component_inject_system_prompt(rac_handle_t handle,
+                                                            const char* prompt);
+
+/**
+ * @brief Append text to the loaded model's adaptive context
+ *
+ * Does not clear existing KV state - accumulates context incrementally.
+ * Optional - returns RAC_ERROR_NOT_SUPPORTED if backend doesn't support it.
+ *
+ * @param handle Component handle
+ * @param text Text to append
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_llm_component_append_context(rac_handle_t handle, const char* text);
+
+/**
+ * @brief Generate a response from accumulated adaptive context
+ *
+ * Unlike rac_llm_component_generate(), this does not clear the KV cache first.
+ * Use after inject_system_prompt + append_context to generate from accumulated state.
+ * Optional - returns RAC_ERROR_NOT_SUPPORTED if backend doesn't support it.
+ *
+ * @param handle Component handle
+ * @param query Query/suffix text to append before generation
+ * @param options Generation options (can be NULL for defaults)
+ * @param out_result Output: Generation result (caller must free with rac_llm_result_free)
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_llm_component_generate_from_context(rac_handle_t handle,
+                                                             const char* query,
+                                                             const rac_llm_options_t* options,
+                                                             rac_llm_result_t* out_result);
+
+/**
+ * @brief Clear all adaptive context state
+ *
+ * Resets the LLM's context for a fresh adaptive query cycle.
+ * Optional - returns RAC_ERROR_NOT_SUPPORTED if backend doesn't support it.
+ *
+ * @param handle Component handle
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_llm_component_clear_context(rac_handle_t handle);
+
 // =============================================================================
 // LORA ADAPTER API
 // =============================================================================

sdk/runanywhere-commons/include/rac/features/llm/rac_llm_service.h

@@ -10,7 +10,8 @@
  *   - rac_llm_service_ops_t and rac_llm_service_t: `internal`. Engine
  *     dispatch contract.
  *   - Proto-byte APIs (rac_llm_generate_proto,
- *     rac_llm_generate_stream_proto, rac_llm_cancel_proto):
+ *     rac_llm_generate_stream_proto, rac_llm_cancel_proto, plus
+ *     lifecycle adaptive-context helpers):
  *     `SDK-facing default` over runanywhere.v1.LLMGenerateRequest /
  *     LLMGenerationResult / LLMStreamEvent / SDKEvent bytes.
  *   - Struct APIs (rac_llm_create, initialize, generate,
@@ -277,6 +278,37 @@ RAC_API rac_result_t rac_llm_generate_stream_proto(const uint8_t* request_proto_
  */
 RAC_API rac_result_t rac_llm_cancel_proto(rac_proto_buffer_t* out_event);
 
+/**
+ * @brief Inject a system prompt into the lifecycle-owned LLM's adaptive context
+ *
+ * Uses the LLM model loaded through rac_model_lifecycle_load_proto().
+ */
+RAC_API rac_result_t rac_llm_inject_system_prompt_lifecycle(const char* prompt);
+
+/**
+ * @brief Append text to the lifecycle-owned LLM's adaptive context
+ *
+ * Uses the LLM model loaded through rac_model_lifecycle_load_proto().
+ */
+RAC_API rac_result_t rac_llm_append_context_lifecycle(const char* text);
+
+/**
+ * @brief Generate from the lifecycle-owned LLM's accumulated adaptive context
+ *
+ * Accepts serialized runanywhere.v1.LLMGenerateRequest bytes and returns a
+ * serialized runanywhere.v1.LLMGenerationResult in out_result.
+ */
+RAC_API rac_result_t rac_llm_generate_from_context_proto(const uint8_t* request_proto_bytes,
+                                                         size_t request_proto_size,
+                                                         rac_proto_buffer_t* out_result);
+
+/**
+ * @brief Clear the lifecycle-owned LLM's adaptive context
+ *
+ * Uses the LLM model loaded through rac_model_lifecycle_load_proto().
+ */
+RAC_API rac_result_t rac_llm_clear_context_lifecycle(void);
+
 // =============================================================================
 // ADAPTIVE CONTEXT API - For RAG and similar pipelines
 // =============================================================================