feat(ui/output): extend compact_assistant_headers to 'minimal' | 'hidden' | 'full'

Allow more granular control over assistant header rendering

Author: sudo-tee

README.md

@@ -234,7 +234,7 @@ require('opencode').setup({
     },
     output = {
       filetype = 'opencode_output', -- Filetype assigned to the output buffer (default: 'opencode_output')
-      compact_assistant_headers = false, -- Collapse consecutive assistant headers in the same mode to a right-aligned timestamp only
+       compact_assistant_headers = false, -- 'full' (default), 'minimal' (compact if same mode), or 'hidden' (no headers for assistant)
       tools = {
         show_output = true, -- Show tools output [diffs, cmd output, etc.] (default: true)
         show_reasoning_output = true, -- Show reasoning/thinking steps output (default: true)

lua/opencode/types.lua

@@ -246,7 +246,7 @@
 ---@field rendering OpencodeUIOutputRenderingConfig
 ---@field always_scroll_to_bottom boolean
 ---@field filetype string
----@field compact_assistant_headers boolean
+---@field compact_assistant_headers boolean | 'minimal' | 'hidden' | 'full'
 
 ---@class OpencodeUIPickerConfig
 ---@field snacks_layout? snacks.picker.layout.Config

lua/opencode/ui/formatter.lua

@@ -190,8 +190,16 @@ function M.format_message_header(message, previous_message)
     display_name = role:upper()
   end
 
+  local header_style = config.ui.output.compact_assistant_headers
+  if header_style == true then
+    header_style = 'minimal'
+  end
+  if header_style == false then
+    header_style = 'full'
+  end
+
   local same_mode_as_previous = false
-  if config.ui.output.compact_assistant_headers and role == 'assistant' and previous_message then
+  if (header_style == 'minimal' or header_style == 'hidden') and role == 'assistant' and previous_message then
     local previous_role = previous_message.info and previous_message.info.role or nil
     local previous_mode = previous_message.info and previous_message.info.mode or state.current_mode
     local current_mode = message.info.mode or state.current_mode
@@ -206,7 +214,9 @@ function M.format_message_header(message, previous_message)
   if not same_mode_as_previous then
     output:add_lines(M.separator)
   else
-    output:add_line('')
+    if header_style ~= 'hidden' then
+      output:add_line('')
+    end
   end
 
   if not same_mode_as_previous then
@@ -223,7 +233,7 @@ function M.format_message_header(message, previous_message)
     } --[[@as OutputExtmark]])
   end
 
-  if time then
+  if time and (role ~= 'assistant' or header_style ~= 'hidden') then
     output:add_extmark(output:get_line_count() - 1, {
       virt_text = { { (same_mode_as_previous and '' or ' ') .. util.format_time(time), 'OpencodeHint' } },
       virt_text_pos = 'right_align',

tests/unit/formatter_spec.lua

@@ -349,9 +349,12 @@ describe('formatter', function()
 
     snapshot.get_restore_points_by_parent = original_get_restore_points_by_parent
 
-    assert.are.same({ 0, 0, 0, 1, 1 }, vim.tbl_map(function(action)
-      return action.display_line
-    end, output.actions))
+    assert.are.same(
+      { 0, 0, 0, 1, 1 },
+      vim.tbl_map(function(action)
+        return action.display_line
+      end, output.actions)
+    )
   end)
 
   it('falls back to current mode for assistant messages without a stamped mode', function()
@@ -404,6 +407,40 @@ describe('formatter', function()
     assert.are.equal('right_align', output.extmarks[0][1].virt_text_pos)
   end)
 
+  it('renders hidden assistant headers without any header content', function()
+    config.setup({
+      ui = {
+        output = {
+          compact_assistant_headers = 'hidden',
+        },
+      },
+    })
+
+    local output = formatter.format_message_header({
+      info = {
+        id = 'msg_current',
+        role = 'assistant',
+        sessionID = 'ses_1',
+        mode = 'build',
+        time = {
+          created = 1,
+        },
+      },
+      parts = {},
+    }, {
+      info = {
+        id = 'msg_prev',
+        role = 'assistant',
+        sessionID = 'ses_1',
+        mode = 'build',
+      },
+      parts = {},
+    })
+
+    assert.are.same({ '' }, output.lines)
+    assert.is_nil(output.extmarks[0])
+  end)
+
   it('keeps full assistant headers when the mode changes', function()
     config.setup({
       ui = {