feat: Add configurable buffer names for Agentic panels

Signed-off-by: Chance Zibolski <chance.zibolski@gmail.com>

Author: chancez

README.md

@@ -495,6 +495,47 @@ header parts:
 }
 ```
 
+### Customizing Buffer Names
+
+By default, buffer names mirror the window header titles. You can override them
+independently via the `buffer_name` field in each window's config, for example
+to show cleaner names in your statusline or buffer switcher:
+
+```lua
+{
+  "carlos-algms/agentic.nvim",
+  opts = {
+    windows = {
+      chat = { buffer_name = "Agentic Chat" },
+      input = { buffer_name = "Agentic Prompt" },
+      code = { buffer_name = "Code Snippets" },
+      files = { buffer_name = "Files" },
+      diagnostics = { buffer_name = "Diagnostics" },
+      todos = { buffer_name = "Tasks" },
+    },
+  },
+}
+```
+
+You can also use a function that receives the header parts and returns a string:
+
+```lua
+{
+  "carlos-algms/agentic.nvim",
+  opts = {
+    windows = {
+      chat = {
+        buffer_name = function(parts)
+          return "AI: " .. parts.title
+        end,
+      },
+    },
+  },
+}
+```
+
+When a panel has no `buffer_name` set, it falls back to the header title.
+
 ## 🚀 Usage (Public Lua API)
 
 ### Commands

lua/agentic/config_default.lua

@@ -57,26 +57,34 @@
 --- Overrides default options (wrap, linebreak, winfixbuf, winfixheight)
 --- @alias agentic.UserConfig.WinOpts table<string, any>
 
+--- @alias agentic.UserConfig.BufferNameFn fun(header: agentic.ui.ChatWidget.HeaderParts): string|nil
+
 --- @class agentic.UserConfig.Windows.Chat
+--- @field buffer_name? string|agentic.UserConfig.BufferNameFn
 --- @field win_opts? agentic.UserConfig.WinOpts
 
 --- @class agentic.UserConfig.Windows.Input
+--- @field buffer_name? string|agentic.UserConfig.BufferNameFn
 --- @field height number
 --- @field win_opts? agentic.UserConfig.WinOpts
 
 --- @class agentic.UserConfig.Windows.Code
+--- @field buffer_name? string|agentic.UserConfig.BufferNameFn
 --- @field max_height number
 --- @field win_opts? agentic.UserConfig.WinOpts
 
 --- @class agentic.UserConfig.Windows.Files
+--- @field buffer_name? string|agentic.UserConfig.BufferNameFn
 --- @field max_height number
 --- @field win_opts? agentic.UserConfig.WinOpts
 
 --- @class agentic.UserConfig.Windows.Diagnostics
+--- @field buffer_name? string|agentic.UserConfig.BufferNameFn
 --- @field max_height number
 --- @field win_opts? agentic.UserConfig.WinOpts
 
 --- @class agentic.UserConfig.Windows.Todos
+--- @field buffer_name? string|agentic.UserConfig.BufferNameFn
 --- @field display boolean
 --- @field max_height number
 --- @field win_opts? agentic.UserConfig.WinOpts
@@ -419,6 +427,8 @@ local ConfigDefault = {
 
     headers = {},
 
+    --- Control various behaviors and features of the plugin
+    --- @class agentic.UserConfig.Settings
     settings = {
         move_cursor_to_chat_on_submit = true,
     },

lua/agentic/ui/window_decoration.lua

@@ -195,12 +195,73 @@ local function set_winbar(winid, text)
     vim.api.nvim_set_option_value("winbar", winbar_text, { win = winid })
 end
 
+--- Resolves the buffer name from config, supporting string or function values
+--- @param window_name string Window name for Config.windows[name].buffer_name lookup
+--- @param header_parts agentic.ui.ChatWidget.HeaderParts Header parts passed to function-type buffer_name
+--- @param fallback string|nil Fallback name (resolved header text) when buffer_name is not set
+--- @return string|nil name
+local function resolve_buffer_name(window_name, header_parts, fallback)
+    local win_cfg = Config.windows[window_name]
+    local buffer_name = win_cfg and win_cfg.buffer_name
+
+    if buffer_name == nil then
+        return fallback
+    end
+
+    if type(buffer_name) == "string" then
+        return buffer_name
+    end
+
+    if type(buffer_name) == "function" then
+        local ok, result = pcall(buffer_name, header_parts)
+        if not ok then
+            Logger.notify(
+                string.format(
+                    "Error in buffer_name function for '%s': %s",
+                    window_name,
+                    result
+                )
+            )
+            return fallback
+        end
+        if result ~= nil and type(result) ~= "string" then
+            Logger.notify(
+                string.format(
+                    "buffer_name function for '%s' must return string|nil, got %s",
+                    window_name,
+                    type(result)
+                )
+            )
+            return fallback
+        end
+        return result
+    end
+
+    Logger.notify(
+        string.format(
+            "buffer_name for '%s' must be string|function|nil, got %s",
+            window_name,
+            type(buffer_name)
+        )
+    )
+    return fallback
+end
+
 --- Sets the buffer name based on header text and tab count
 --- @param bufnr integer Buffer number
 --- @param header_text string|nil Resolved header text
 --- @param tab_page_id integer Tab page ID for suffix
-local function set_buffer_name(bufnr, header_text, tab_page_id)
-    if not header_text or header_text == "" then
+--- @param window_name string Window name for Config.windows[name].buffer_name lookup
+--- @param header_parts agentic.ui.ChatWidget.HeaderParts Header parts for function-type buffer_name
+local function set_buffer_name(
+    bufnr,
+    header_text,
+    tab_page_id,
+    window_name,
+    header_parts
+)
+    local name = resolve_buffer_name(window_name, header_parts, header_text)
+    if not name or name == "" then
         return
     end
 
@@ -210,9 +271,9 @@ local function set_buffer_name(bufnr, header_text, tab_page_id)
     --- @type string|nil
     local buf_name
     if total_tabs > 1 then
-        buf_name = string.format("%s (Tab %d)", header_text, tab_page_id)
+        buf_name = string.format("%s (Tab %d)", name, tab_page_id)
     else
-        buf_name = header_text
+        buf_name = name
     end
 
     vim.api.nvim_buf_set_name(bufnr, buf_name)
@@ -263,7 +324,13 @@ function WindowDecoration.render_header(bufnr, window_name, context)
         local text = (header_text and header_text ~= "") and header_text or ""
 
         set_winbar(winid, text)
-        set_buffer_name(bufnr, header_text, tab_page_id)
+        set_buffer_name(
+            bufnr,
+            header_text,
+            tab_page_id,
+            window_name,
+            dynamic_header
+        )
     end)
 end
 

tests/integration/test_buffer_naming.lua

@@ -78,6 +78,47 @@ end)()
         assert.equal(5, session_count)
     end)
 
+    it("uses custom buffer_name from windows config when set", function()
+        child.lua([[
+            require("agentic").setup({ windows = { chat = { buffer_name = "My Chat" } } })
+            require("agentic").toggle()
+        ]])
+        child.flush()
+
+        local basename = get_panel_basename("chat")
+        assert.is_true(vim.startswith(basename, "My Chat"))
+    end)
+
+    it("uses buffer_name function to derive name from header parts", function()
+        child.lua([[
+            require("agentic").setup({
+                windows = {
+                    chat = {
+                        buffer_name = function(parts)
+                            return "Custom: " .. parts.title
+                        end,
+                    },
+                },
+            })
+            require("agentic").toggle()
+        ]])
+        child.flush()
+
+        local basename = get_panel_basename("chat")
+        assert.is_true(vim.startswith(basename, "Custom: 󰻞 Agentic Chat"))
+    end)
+
+    it("falls back to header title when buffer_name not set", function()
+        child.lua([[
+            require("agentic").setup({})
+            require("agentic").toggle()
+        ]])
+        child.flush()
+
+        local basename = get_panel_basename("chat")
+        assert.is_true(vim.startswith(basename, "󰻞 Agentic Chat"))
+    end)
+
     it("each panel has distinct buffer name prefix", function()
         child.lua([[ require("agentic").toggle() ]])
         child.flush()