*** Settings ***
Documentation     Integration tests for context manager (persistence API)
Library           OperatingSystem
Library           CleverActorsLib.py

*** Test Cases ***
Context Can Be Created
    [Documentation]    Verify ContextManager initialises and has a temp dir
    Create Context    test_session
    Context Exists Should Be    true
    [Teardown]    Cleanup Temp Dir

Context Saves And Persists Messages
    [Documentation]    Verify add_message + save retains messages across reload
    Create Context    persist_test
    Add Context Message    user    Hello
    Add Context Message    assistant    Hi there
    Context History Count Equals    2
    Context Save And Reload
    Context History Count Equals    2
    [Teardown]    Cleanup Temp Dir

Context State Persists Across Save
    [Documentation]    Verify key-value state is saved and restored
    Create Context    state_test
    Context Update State    topic    physics
    Context Save And Reload
    Context State Equals    topic    physics
    [Teardown]    Cleanup Temp Dir

Context Get Last N Messages
    [Documentation]    Verify get_last_n_messages limits correctly
    Create Context    last_n_test
    Add Context Message    user    1
    Add Context Message    assistant    2
    Add Context Message    user    3
    Add Context Message    assistant    4
    Context Last N Count Equals    2    2
    [Teardown]    Cleanup Temp Dir

Context Clear Removes Messages
    [Documentation]    Verify clear() empties conversation history
    Create Context    clear_test
    Add Context Message    user    data
    Context Clear
    Context History Count Equals    0
    [Teardown]    Cleanup Temp Dir

Context Delete Removes Persistence
    [Documentation]    Verify delete() removes file and exists() returns false
    Create Context    delete_test
    Add Context Message    user    data
    Context Save And Reload
    Context Exists Should Be    true
    Context Delete
    Context Exists Should Be    false
    [Teardown]    Cleanup Temp Dir

Context Export And Import
    [Documentation]    Verify export/import round-trips state correctly
    Create Context    export_test
    Context Export Import    foo    bar
    [Teardown]    Cleanup Temp Dir

Context Global Context Persists
    [Documentation]    Verify save_global_context and get_global_context
    Create Context    global_test
    Context Save Global    app_version    2.0.0
    Context Save And Reload
    Context Should Have Global Key    app_version    2.0.0
    [Teardown]    Cleanup Temp Dir

Context Appears In List
    [Documentation]    Verify list_contexts includes saved contexts
    Create Context    listable_ctx
    Context Save And Reload
    Context List Contains    listable_ctx
    [Teardown]    Cleanup Temp Dir