local api = vim.api local curl = require("plenary.curl") local Utils = require("avante.utils") local Config = require("avante.config") local Tiktoken = require("avante.tiktoken") local Dressing = require("avante.ui.dressing") ---@class avante.LLM local M = {} M.CANCEL_PATTERN = "AvanteLLMEscape" ---@class CopilotToken ---@field annotations_enabled boolean ---@field chat_enabled boolean ---@field chat_jetbrains_enabled boolean ---@field code_quote_enabled boolean ---@field codesearch boolean ---@field copilotignore_enabled boolean ---@field endpoints {api: string, ["origin-tracker"]: string, proxy: string, telemetry: string} ---@field expires_at integer ---@field individual boolean ---@field nes_enabled boolean ---@field prompt_8k boolean ---@field public_suggestions string ---@field refresh_in integer ---@field sku string ---@field snippy_load_test_enabled boolean ---@field telemetry string ---@field token string ---@field tracking_id string ---@field vsc_electron_fetcher boolean ---@field xcode boolean ---@field xcode_chat boolean --- ---@private ---@class AvanteCopilot: table ---@field proxy string ---@field allow_insecure boolean ---@field token? CopilotToken ---@field github_token? string ---@field sessionid? string ---@field machineid? string M.copilot = nil ---@class EnvironmentHandler: table<[Provider], string> local E = { ---@type table env = { openai = "OPENAI_API_KEY", claude = "ANTHROPIC_API_KEY", azure = "AZURE_OPENAI_API_KEY", deepseek = "DEEPSEEK_API_KEY", groq = "GROQ_API_KEY", copilot = function() if Utils.has("copilot.lua") or Utils.has("copilot.vim") or Utils.copilot.find_config_path() then return true end Utils.warn("copilot is not setup correctly. Please use copilot.lua or copilot.vim for authentication.") return false end, }, } setmetatable(E, { ---@param k Provider __index = function(_, k) if E.is_local(k) then return true end local builtins = E.env[k] if builtins then if type(builtins) == "function" then return builtins() end return os.getenv(builtins) and true or false end ---@type AvanteProvider | nil local external = Config.vendors[k] if external then return os.getenv(external.api_key_name) and true or false end end, }) ---@private E._once = false ---@param provider Provider E.is_default = function(provider) return E.env[provider] and true or false end local AVANTE_INTERNAL_KEY = "__avante_internal" --- return the environment variable name for the given provider ---@param provider? Provider ---@return string the envvar key E.key = function(provider) provider = provider or Config.provider if E.is_default(provider) then local result = E.env[provider] return type(result) == "function" and AVANTE_INTERNAL_KEY or result end ---@type AvanteProvider | nil local external = Config.vendors[provider] if external then return external.api_key_name end error("Failed to find provider: " .. provider, 2) end ---@param provider Provider E.is_local = function(provider) if Config.options[provider] then return Config.options[provider]["local"] elseif Config.vendors[provider] then return Config.vendors[provider]["local"] else return false end end ---@param provider? Provider E.value = function(provider) if E.is_local(provider or Config.provider) then return "__avante_dummy" end return os.getenv(E.key(provider or Config.provider)) end --- intialize the environment variable for current neovim session. --- This will only run once and spawn a UI for users to input the envvar. ---@param var string supported providers ---@param refresh? boolean ---@private E.setup = function(var, refresh) if var == AVANTE_INTERNAL_KEY then return end refresh = refresh or false ---@param value string ---@return nil local function on_confirm(value) if value then vim.fn.setenv(var, value) else if not E[Config.provider] then Utils.warn("Failed to set " .. var .. ". Avante won't work as expected", { once = true, title = "Avante" }) end end end if refresh then vim.defer_fn(function() Dressing.initialize_input_buffer({ opts = { prompt = "Enter " .. var .. ": " }, on_confirm = on_confirm }) end, 200) elseif not E._once then E._once = true api.nvim_create_autocmd({ "BufEnter", "BufWinEnter" }, { pattern = "*", once = true, callback = function() vim.defer_fn(function() -- only mount if given buffer is not of buftype ministarter, dashboard, alpha, qf local exclude_buftypes = { "dashboard", "alpha", "qf", "nofile" } local exclude_filetypes = { "NvimTree", "Outline", "help", "dashboard", "alpha", "qf", "ministarter", "TelescopePrompt", "gitcommit", "gitrebase", "DressingInput", } if not vim.tbl_contains(exclude_buftypes, vim.bo.buftype) and not vim.tbl_contains(exclude_filetypes, vim.bo.filetype) then Dressing.initialize_input_buffer({ opts = { prompt = "Enter " .. var .. ": " }, on_confirm = on_confirm, }) end end, 200) end, }) end end ------------------------------Prompt and type------------------------------ local system_prompt = [[ You are an excellent programming expert. ]] local base_user_prompt = [[ Your primary task is to suggest code modifications with precise line number ranges. Follow these instructions meticulously: 1. Carefully analyze the original code, paying close attention to its structure and line numbers. Line numbers start from 1 and include ALL lines, even empty ones. 2. When suggesting modifications: a. Use the language in the question to reply. If there are non-English parts in the question, use the language of those parts. b. Explain why the change is necessary or beneficial. c. Provide the exact code snippet to be replaced using this format: Replace lines: {{start_line}}-{{end_line}} ```{{language}} {{suggested_code}} ``` 3. Crucial guidelines for suggested code snippets: - Only apply the change(s) suggested by the most recent assistant message (before your generation). - Do not make any unrelated changes to the code. - Produce a valid full rewrite of the entire original file without skipping any lines. Do not be lazy! - Do not arbitrarily delete pre-existing comments/empty Lines. - Do not omit large parts of the original file for no reason. - Do not omit any needed changes from the requisite messages/code blocks. - If there is a clicked code block, bias towards just applying that (and applying other changes implied). - Please keep your suggested code changes minimal, and do not include irrelevant lines in the code snippet. 4. Crucial guidelines for line numbers: - The content regarding line numbers MUST strictly follow the format "Replace lines: {{start_line}}-{{end_line}}". Do not be lazy! - The range {{start_line}}-{{end_line}} is INCLUSIVE. Both start_line and end_line are included in the replacement. - Count EVERY line, including empty lines and comments lines, comments. Do not be lazy! - For single-line changes, use the same number for start and end lines. - For multi-line changes, ensure the range covers ALL affected lines, from the very first to the very last. - Double-check that your line numbers align perfectly with the original code structure. 5. Final check: - Review all suggestions, ensuring each line number is correct, especially the start_line and end_line. - Confirm that no unrelated code is accidentally modified or deleted. - Verify that the start_line and end_line correctly include all intended lines for replacement. - Perform a final alignment check to ensure your line numbers haven't shifted, especially the start_line. - Double-check that your line numbers align perfectly with the original code structure. - Do not show the full content after these modifications. Remember: Accurate line numbers are CRITICAL. The range start_line to end_line must include ALL lines to be replaced, from the very first to the very last. Double-check every range before finalizing your response, paying special attention to the start_line to ensure it hasn't shifted down. Ensure that your line numbers perfectly match the original code structure without any overall shift. ]] ---@class AvanteHandlerOptions: table<[string], string> ---@field on_chunk AvanteChunkParser ---@field on_complete AvanteCompleteParser --- ---@class AvantePromptOptions: table<[string], string> ---@field question string ---@field code_lang string ---@field code_content string ---@field selected_code_content? string --- ---@class AvanteBaseMessage ---@field role "user" | "system" ---@field content string --- ---@class AvanteClaudeMessage: AvanteBaseMessage ---@field role "user" ---@field content {type: "text", text: string, cache_control?: {type: "ephemeral"}}[] --- ---@alias AvanteOpenAIMessage AvanteBaseMessage --- ---@alias AvanteChatMessage AvanteClaudeMessage | AvanteOpenAIMessage --- ---@alias AvanteAiMessageBuilder fun(opts: AvantePromptOptions): AvanteChatMessage[] --- ---@class AvanteCurlOutput: {url: string, body: table | string, headers: table} ---@alias AvanteCurlArgsBuilder fun(code_opts: AvantePromptOptions): AvanteCurlOutput --- ---@class ResponseParser ---@field on_chunk fun(chunk: string): any ---@field on_complete fun(err: string|nil): any ---@alias AvanteResponseParser fun(data_stream: string, event_state: string, opts: ResponseParser): nil --- ---@class AvanteDefaultBaseProvider ---@field endpoint string ---@field local? boolean --- ---@class AvanteSupportedProvider: AvanteDefaultBaseProvider ---@field model string ---@field temperature number ---@field max_tokens number --- ---@class AvanteAzureProvider: AvanteDefaultBaseProvider ---@field deployment string ---@field api_version string ---@field temperature number ---@field max_tokens number --- ---@class AvanteCopilotProvider: AvanteSupportedProvider ---@field proxy string | nil ---@field allow_insecure boolean ---@field timeout number --- ---@class AvanteProvider: AvanteDefaultBaseProvider ---@field model? string ---@field api_key_name string ---@field parse_response_data AvanteResponseParser ---@field parse_curl_args fun(opts: AvanteProvider, code_opts: AvantePromptOptions): AvanteCurlOutput ---@field parse_stream_data? fun(line: string, handler_opts: AvanteHandlerOptions): nil --- ---@alias AvanteChunkParser fun(chunk: string): any ---@alias AvanteCompleteParser fun(err: string|nil): nil ------------------------------Anthropic------------------------------ ---@param opts AvantePromptOptions ---@return AvanteClaudeMessage[] M.make_claude_message = function(opts) local code_prompt_obj = { type = "text", text = string.format("```%s\n%s```", opts.code_lang, opts.code_content), } if Tiktoken.count(code_prompt_obj.text) > 1024 then code_prompt_obj.cache_control = { type = "ephemeral" } end if opts.selected_code_content then code_prompt_obj.text = string.format("```%s\n%s```", opts.code_lang, opts.code_content) end local message_content = { code_prompt_obj, } if opts.selected_code_content then local selected_code_obj = { type = "text", text = string.format("```%s\n%s```", opts.code_lang, opts.selected_code_content), } if Tiktoken.count(selected_code_obj.text) > 1024 then selected_code_obj.cache_control = { type = "ephemeral" } end table.insert(message_content, selected_code_obj) end table.insert(message_content, { type = "text", text = string.format("%s", opts.question), }) local user_prompt = base_user_prompt local user_prompt_obj = { type = "text", text = user_prompt, } if Tiktoken.count(user_prompt_obj.text) > 1024 then user_prompt_obj.cache_control = { type = "ephemeral" } end table.insert(message_content, user_prompt_obj) return { { role = "user", content = message_content, }, } end ---@type AvanteResponseParser M.parse_claude_response = function(data_stream, event_state, opts) if event_state == "content_block_delta" then local ok, json = pcall(vim.json.decode, data_stream) if not ok then return end opts.on_chunk(json.delta.text) elseif event_state == "message_stop" then opts.on_complete(nil) return elseif event_state == "error" then opts.on_complete(vim.json.decode(data_stream)) end end ---@type AvanteCurlArgsBuilder M.make_claude_curl_args = function(code_opts) return { url = Utils.trim(Config.claude.endpoint, { suffix = "/" }) .. "/v1/messages", headers = { ["Content-Type"] = "application/json", ["x-api-key"] = E.value("claude"), ["anthropic-version"] = "2023-06-01", ["anthropic-beta"] = "prompt-caching-2024-07-31", }, body = { model = Config.claude.model, system = system_prompt, stream = true, messages = M.make_claude_message(code_opts), temperature = Config.claude.temperature, max_tokens = Config.claude.max_tokens, }, } end ------------------------------OpenAI------------------------------ ---@param opts AvantePromptOptions ---@return AvanteOpenAIMessage[] M.make_openai_message = function(opts) local user_prompt = base_user_prompt .. "\n\nCODE:\n" .. "```" .. opts.code_lang .. "\n" .. opts.code_content .. "\n```" .. "\n\nQUESTION:\n" .. opts.question if opts.selected_code_content ~= nil then user_prompt = base_user_prompt .. "\n\nCODE CONTEXT:\n" .. "```" .. opts.code_lang .. "\n" .. opts.code_content .. "\n```" .. "\n\nCODE:\n" .. "```" .. opts.code_lang .. "\n" .. opts.selected_code_content .. "\n```" .. "\n\nQUESTION:\n" .. opts.question end return { { role = "system", content = system_prompt }, { role = "user", content = user_prompt }, } end ---@type AvanteResponseParser M.parse_openai_response = function(data_stream, _, opts) if data_stream:match('"%[DONE%]":') then opts.on_complete(nil) return end if data_stream:match('"delta":') then local json = vim.json.decode(data_stream) if json.choices and json.choices[1] then local choice = json.choices[1] if choice.finish_reason == "stop" then opts.on_complete(nil) elseif choice.delta.content then opts.on_chunk(choice.delta.content) end end end end ---@type AvanteCurlArgsBuilder M.make_openai_curl_args = function(code_opts) return { url = Utils.trim(Config.openai.endpoint, { suffix = "/" }) .. "/v1/chat/completions", headers = { ["Content-Type"] = "application/json", ["Authorization"] = "Bearer " .. E.value("openai"), }, body = { model = Config.openai.model, messages = M.make_openai_message(code_opts), temperature = Config.openai.temperature, max_tokens = Config.openai.max_tokens, stream = true, }, } end ------------------------------Copilot------------------------------ ---@type AvanteAiMessageBuilder M.make_copilot_message = M.make_openai_message ---@type AvanteResponseParser M.parse_copilot_response = M.parse_openai_response ---@type AvanteCurlArgsBuilder M.make_copilot_curl_args = function(code_opts) local github_token = Utils.copilot.cached_token() if not github_token then error( "No GitHub token found, please use `:Copilot auth` to setup with `copilot.lua` or `:Copilot setup` with `copilot.vim`" ) end local on_done = function() return { url = Utils.trim(Config.copilot.endpoint, { suffix = "/" }) .. "/chat/completions", proxy = Config.copilot.proxy, insecure = Config.copilot.allow_insecure, headers = Utils.copilot.generate_headers(M.copilot.token.token, M.copilot.sessionid, M.copilot.machineid), body = { mode = Config.copilot.model, n = 1, top_p = 1, stream = true, temperature = Config.copilot.temperature, max_tokens = Config.copilot.max_tokens, messages = M.make_copilot_message(code_opts), }, } end local result = nil if not M.copilot.token or (M.copilot.token.expires_at and M.copilot.token.expires_at <= math.floor(os.time())) then local sessionid = Utils.copilot.uuid() .. tostring(math.floor(os.time() * 1000)) local url = "https://api.github.com/copilot_internal/v2/token" local headers = { ["Authorization"] = "token " .. github_token, ["Accept"] = "application/json", } for key, value in pairs(Utils.copilot.version_headers) do headers[key] = value end local response = curl.get(url, { timeout = Config.copilot.timeout, headers = headers, proxy = M.copilot.proxy, insecure = M.copilot.allow_insecure, on_error = function(err) error("Failed to get response: " .. vim.inspect(err)) end, }) M.copilot.sessionid = sessionid M.copilot.token = vim.json.decode(response.body) result = on_done() else result = on_done() end return result end ------------------------------Azure------------------------------ ---@type AvanteAiMessageBuilder M.make_azure_message = M.make_openai_message ---@type AvanteResponseParser M.parse_azure_response = M.parse_openai_response ---@type AvanteCurlArgsBuilder M.make_azure_curl_args = function(code_opts) return { url = Config.azure.endpoint .. "/openai/deployments/" .. Config.azure.deployment .. "/chat/completions?api-version=" .. Config.azure.api_version, headers = { ["Content-Type"] = "application/json", ["api-key"] = E.value("azure"), }, body = { messages = M.make_openai_message(code_opts), temperature = Config.azure.temperature, max_tokens = Config.azure.max_tokens, stream = true, }, } end ------------------------------Deepseek------------------------------ ---@type AvanteAiMessageBuilder M.make_deepseek_message = M.make_openai_message ---@type AvanteResponseParser M.parse_deepseek_response = M.parse_openai_response ---@type AvanteCurlArgsBuilder M.make_deepseek_curl_args = function(code_opts) return { url = Utils.trim(Config.deepseek.endpoint, { suffix = "/" }) .. "/chat/completions", headers = { ["Content-Type"] = "application/json", ["Authorization"] = "Bearer " .. E.value("deepseek"), }, body = { model = Config.deepseek.model, messages = M.make_openai_message(code_opts), temperature = Config.deepseek.temperature, max_tokens = Config.deepseek.max_tokens, stream = true, }, } end ------------------------------Grok------------------------------ ---@type AvanteAiMessageBuilder M.make_groq_message = M.make_openai_message ---@type AvanteResponseParser M.parse_groq_response = M.parse_openai_response ---@type AvanteCurlArgsBuilder M.make_groq_curl_args = function(code_opts) return { url = Utils.trim(Config.groq.endpoint, { suffix = "/" }) .. "/openai/v1/chat/completions", headers = { ["Content-Type"] = "application/json", ["Authorization"] = "Bearer " .. E.value("groq"), }, body = { model = Config.groq.model, messages = M.make_openai_message(code_opts), temperature = Config.groq.temperature, max_tokens = Config.groq.max_tokens, stream = true, }, } end ------------------------------Logic------------------------------ local group = vim.api.nvim_create_augroup("AvanteLLM", { clear = true }) local active_job = nil ---@param question string ---@param code_lang string ---@param code_content string ---@param selected_content_content string | nil ---@param on_chunk AvanteChunkParser ---@param on_complete AvanteCompleteParser M.stream = function(question, code_lang, code_content, selected_content_content, on_chunk, on_complete) local provider = Config.provider local code_opts = { question = question, code_lang = code_lang, code_content = code_content, selected_code_content = selected_content_content, } local current_event_state = nil local handler_opts = { on_chunk = on_chunk, on_complete = on_complete } ---@type AvanteCurlOutput local spec = nil ---@type AvanteProvider local ProviderConfig = nil if E.is_default(provider) then spec = M["make_" .. provider .. "_curl_args"](code_opts) else ProviderConfig = Config.vendors[provider] spec = ProviderConfig.parse_curl_args(ProviderConfig, code_opts) end ---@param line string local function parse_and_call(line) local event = line:match("^event: (.+)$") if event then current_event_state = event return end local data_match = line:match("^data: (.+)$") if data_match then if ProviderConfig ~= nil then ProviderConfig.parse_response_data(data_match, current_event_state, handler_opts) else M["parse_" .. provider .. "_response"](data_match, current_event_state, handler_opts) end end end if active_job then active_job:shutdown() active_job = nil end active_job = curl.post(spec.url, { headers = spec.headers, body = vim.json.encode(spec.body), stream = function(err, data, _) if err then on_complete(err) return end if not data then return end vim.schedule(function() if ProviderConfig ~= nil and ProviderConfig.parse_stream_data ~= nil then if ProviderConfig.parse_response_data ~= nil then Utils.warn( "parse_stream_data and parse_response_data are mutually exclusive, and thus parse_response_data will be ignored. Make sure that you handle the incoming data correctly.", { once = true } ) end ProviderConfig.parse_stream_data(data, handler_opts) else parse_and_call(data) end end) end, on_error = function(err) on_complete(err) end, callback = function(_) active_job = nil end, }) api.nvim_create_autocmd("User", { group = group, pattern = M.CANCEL_PATTERN, callback = function() if active_job then active_job:shutdown() Utils.debug("LLM request cancelled", { title = "Avante" }) active_job = nil end end, }) return active_job end ---@public function M.setup() if Config.provider == "copilot" and not M.copilot then M.copilot = { proxy = Config.copilot.proxy, allow_insecure = Config.copilot.allow_insecure, github_token = Utils.copilot.cached_token(), sessionid = nil, token = nil, machineid = Utils.copilot.machine_id(), } end local has = E[Config.provider] if not has then E.setup(E.key()) end M.commands() end ---@param provider Provider function M.refresh(provider) local has = E[provider] if not has then E.setup(E.key(provider), true) else Utils.info("Switch to provider: " .. provider, { once = true, title = "Avante" }) end require("avante.config").override({ provider = provider }) end ---@private M.commands = function() api.nvim_create_user_command("AvanteSwitchProvider", function(args) local cmd = vim.trim(args.args or "") M.refresh(cmd) end, { nargs = 1, desc = "avante: switch provider", complete = function(_, line) if line:match("^%s*AvanteSwitchProvider %w") then return {} end local prefix = line:match("^%s*AvanteSwitchProvider (%w*)") or "" -- join two tables local Keys = vim.list_extend(vim.tbl_keys(E.env), vim.tbl_keys(Config.vendors)) return vim.tbl_filter(function(key) return key:find(prefix) == 1 end, Keys) end, }) end M.SYSTEM_PROMPT = system_prompt M.BASE_PROMPT = base_user_prompt return M