cline/proto/state.proto

syntax = "proto3";
package cline;
import "common.proto";
option java_package = "bot.cline.proto";
option java_multiple_files = true;

service StateService {
  rpc getLatestState(EmptyRequest) returns (State);
  rpc updateTerminalConnectionTimeout(Int64Request) returns (Int64);
  rpc updateTerminalReuseEnabled(BooleanRequest) returns (Empty);
  rpc updateDefaultTerminalProfile(StringRequest) returns (TerminalProfileUpdateResponse);
  rpc getAvailableTerminalProfiles(EmptyRequest) returns (TerminalProfiles);
  rpc subscribeToState(EmptyRequest) returns (stream State);
  rpc toggleFavoriteModel(StringRequest) returns (Empty);
  rpc resetState(ResetStateRequest) returns (Empty);
  rpc togglePlanActMode(TogglePlanActModeRequest) returns (Boolean);
  rpc updateAutoApprovalSettings(AutoApprovalSettingsRequest) returns (Empty);
  rpc updateSettings(UpdateSettingsRequest) returns (Empty);
  rpc updateTelemetrySetting(TelemetrySettingRequest) returns (Empty);
  rpc setWelcomeViewCompleted(BooleanRequest) returns (Empty);
}

message State {
  string state_json = 1;
}

message TerminalProfiles {
  repeated TerminalProfile profiles = 1;
}

message TerminalProfile {
  string id = 1;
  string name = 2;
  optional string path = 3;
  optional string description = 4;
}

message TerminalProfileUpdateResponse {
  int32 closed_count = 1;
  int32 busy_terminals_count = 2;
  bool has_busy_terminals = 3;
}

message TogglePlanActModeRequest {
  Metadata metadata = 1;
  ChatSettings chat_settings = 2;
  optional ChatContent chat_content = 3;
}

enum PlanActMode {
  PLAN = 0;
  ACT = 1;
}

message ChatSettings {
  PlanActMode mode = 1;
  optional string preferred_language = 2;
  optional string open_ai_reasoning_effort = 3;
}

message ChatContent {
  optional string message = 1;
  repeated string images = 2;
  repeated string files = 3;
}

message ResetStateRequest {
  Metadata metadata = 1;
  optional bool global = 2;
}

message AutoApprovalSettingsRequest {
  Metadata metadata = 1;
  message Actions {
    bool read_files = 1;
    bool read_files_externally = 2;
    bool edit_files = 3;
    bool edit_files_externally = 4;
    bool execute_safe_commands = 5;
    bool execute_all_commands = 6;
    bool use_browser = 7;
    bool use_mcp = 8;
  }
  int32 version = 2;
  bool enabled = 3;
  Actions actions = 4;
  int32 max_requests = 5;
  bool enable_notifications = 6;
  repeated string favorites = 7;
}

enum TelemetrySettingEnum {
  UNSET = 0;
  ENABLED = 1;
  DISABLED = 2;
}

message TelemetrySettingRequest {
  Metadata metadata = 1;
  TelemetrySettingEnum setting = 2;
}

// Message for updating settings
message UpdateSettingsRequest {
  Metadata metadata = 1;
  optional ApiConfiguration api_configuration = 2;
  optional string telemetry_setting = 3;
  optional bool plan_act_separate_models_setting = 4;
  optional bool enable_checkpoints_setting = 5;
  optional bool mcp_marketplace_enabled = 6;
  optional ChatSettings chat_settings = 7;
  optional int64 shell_integration_timeout = 8;
  optional bool terminal_reuse_enabled = 9;
  optional bool mcp_responses_collapsed = 10;
  optional string mcp_display_mode = 11;
  optional int64 terminal_output_line_limit = 12;
}

// Complete API Configuration message
message ApiConfiguration {
  // Core API fields
  optional string api_provider = 1;
  optional string api_model_id = 2;
  optional string api_key = 3; // anthropic
  optional string api_base_url = 4;
  
  // Provider-specific API keys
  optional string cline_account_id = 5;
  optional string openrouter_api_key = 6;
  optional string anthropic_base_url = 7;
  optional string openai_api_key = 8;
  optional string openai_native_api_key = 9;
  optional string gemini_api_key = 10;
  optional string deepseek_api_key = 11;
  optional string requesty_api_key = 12;
  optional string together_api_key = 13;
  optional string fireworks_api_key = 14;
  optional string qwen_api_key = 15;
  optional string doubao_api_key = 16;
  optional string mistral_api_key = 17;
  optional string nebius_api_key = 18;
  optional string asksage_api_key = 19;
  optional string xai_api_key = 20;
  optional string sambanova_api_key = 21;
  optional string cerebras_api_key = 22;
  
  // Model IDs
  optional string openrouter_model_id = 23;
  optional string openai_model_id = 24;
  optional string anthropic_model_id = 25;
  optional string bedrock_model_id = 26;
  optional string vertex_model_id = 27;
  optional string gemini_model_id = 28;
  optional string ollama_model_id = 29;
  optional string lm_studio_model_id = 30;
  optional string litellm_model_id = 31;
  optional string requesty_model_id = 32;
  optional string together_model_id = 33;
  optional string fireworks_model_id = 34;
  
  // AWS Bedrock fields
  optional bool aws_bedrock_custom_selected = 35;
  optional string aws_bedrock_custom_model_base_id = 36;
  optional string aws_access_key = 37;
  optional string aws_secret_key = 38;
  optional string aws_session_token = 39;
  optional string aws_region = 40;
  optional bool aws_use_cross_region_inference = 41;
  optional bool aws_bedrock_use_prompt_cache = 42;
  optional bool aws_use_profile = 43;
  optional string aws_profile = 44;
  optional string aws_bedrock_endpoint = 45;
  
  // Vertex AI fields
  optional string vertex_project_id = 46;
  optional string vertex_region = 47;
  
  // Base URLs and endpoints
  optional string openai_base_url = 48;
  optional string ollama_base_url = 49;
  optional string lm_studio_base_url = 50;
  optional string gemini_base_url = 51;
  optional string litellm_base_url = 52;
  optional string asksage_api_url = 53;
  
  // LiteLLM specific fields
  optional string litellm_api_key = 54;
  optional bool litellm_use_prompt_cache = 55;
  
  // Model configuration
  optional int64 thinking_budget_tokens = 56;
  optional string reasoning_effort = 57;
  optional int64 request_timeout_ms = 58;
  
  // Fireworks specific
  optional int64 fireworks_model_max_completion_tokens = 59;
  optional int64 fireworks_model_max_tokens = 60;
  
  // Azure specific
  optional string azure_api_version = 61;
  
  // Ollama specific
  optional string ollama_api_options_ctx_num = 62;
  
  // Qwen specific
  optional string qwen_api_line = 63;
  
  // OpenRouter specific
  optional string openrouter_provider_sorting = 64;
  
  // VSCode LM (stored as JSON string due to complex type)
  optional string vscode_lm_model_selector = 65;
  
  // Model info objects (stored as JSON strings)
  optional string openrouter_model_info = 66;
  optional string openai_model_info = 67;
  optional string requesty_model_info = 68;
  optional string litellm_model_info = 69;
  
  // OpenAI headers (stored as JSON string)
  optional string openai_headers = 70;
  
  // Favorited model IDs
  repeated string favorited_model_ids = 71;

  // SAP AI Core specific
  optional string sap_ai_core_client_id = 72;
  optional string sap_ai_core_client_secret = 73;
  optional string sap_ai_core_base_url = 74;
  optional string sap_ai_core_token_url = 75;
  optional string sap_ai_resource_group = 76;

  // Claude Code specific
  optional string claude_code_path = 77;

  // Extension fields for Bedrock Api Keys
  optional string aws_authentication = 78;
  optional string aws_bedrock_api_key = 79;

  // Moonshot
  optional string moonshot_api_key = 80;
  optional string moonshot_api_line = 81;
}