Class RCLIEngine

src/api/rcli_api.cpp:49–128

Internal engine state behind the opaque handle

// Internal engine state behind the opaque handle
struct RCLIEngine {
    Orchestrator     pipeline;
    std::string      models_dir;

    rcli::ActionRegistry actions;

    // Config overrides from rcli_create() config_json
    std::string config_system_prompt;
    std::string config_engine_override;  // "metalrt", "llamacpp", or "" (use preference file)
    int config_gpu_layers = -1;
    int config_ctx_size   = -1;

    // Personality
    std::string personality_key = "default";

    // Which offline STT backend is active
    bool using_parakeet = false;
    std::string llm_model_name = "Qwen3 0.6B";
    std::string tts_model_name = "Piper Lessac";
    std::string stt_model_name = "Whisper base.en";

    // RAG subsystem
    std::unique_ptr<EmbeddingEngine> rag_embedding;
    std::unique_ptr<HybridRetriever> rag_retriever;
    std::string rag_index_path;
    bool rag_ready = false;
    std::string last_rag_result;

    // TTS playback PID (for interruption via afplay)
    std::atomic<pid_t> tts_pid{0};

    // Streaming TTS cancellation flag
    std::atomic<bool> streaming_cancelled{false};

    // Response buffers (owned by engine, returned to callers)
    std::string last_transcript;
    std::string last_response;
    std::string last_action_result;
    std::string last_action_list;
    std::string last_info;

    // Callbacks
    RCLITranscriptCallback transcript_cb = nullptr;
    void* transcript_ud = nullptr;
    RCLIStateCallback state_cb = nullptr;
    void* state_ud = nullptr;
    RCLIActionCallback action_cb = nullptr;
    void* action_ud = nullptr;
    // Tool trace callback — separate from action_cb because action_cb only fires
    // for ActionRegistry actions, while trace covers both actions and built-in tools
    // (get_current_time, calculate), giving a complete picture of tool dispatch.
    RCLIToolTraceCallback tool_trace_cb = nullptr;
    void* tool_trace_ud = nullptr;

    std::atomic<float> audio_rms{0.0f};

    // Conversation memory (session-scoped, for multi-turn chat)
    std::vector<std::pair<std::string, std::string>> conversation_history;