feat/jump to user message (#420)

* feat(output_window): add jump-to-user-message action with [u/]u keymap

Add navigation.goto_next_user_message / goto_prev_user_message and the
underlying renderer.get_next_user_message / get_prev_user_message, which
filter state.messages by role == 'user' so the cursor only lands on
user turns (not the assistant response between them).

Wire them through workflow (action + command_def), expose them in
opencode.api, and bind [u / ]u in the default output_window keymap next
to the existing ]] / [[ section-movement pair.

Tests cover role filtering, jump behavior, and the no-target notify case
in tests/unit/navigation_user_message_spec.lua.

* fix(navigation): load all messages before user-message jump under lazy render

Under lazy render only the most recent N messages have a line_start in
render_state, so goto_prev/next_user_message would silently no-op when
the target user message had not yet been rendered, falling through to
the 'No previous/next user message' notify.

Mirror the 'gg' binding in output_window.setup_keymaps and force a
full render via renderer.load_all_messages() before resolving the
target. Three new tests cover the lazy render interaction.

Author: phanen

lua/opencode/api.lua

@@ -80,6 +80,8 @@ local action_groups = {
     next_prompt_history = workflow.next_prompt_history,
     next_message = workflow.next_message,
     prev_message = workflow.prev_message,
+    next_user_message = workflow.next_user_message,
+    prev_user_message = workflow.prev_user_message,
     mention_file = workflow.mention_file,
     mention = workflow.mention,
     context_items = workflow.context_items,

lua/opencode/commands/handlers/workflow.lua

@@ -277,6 +277,14 @@ function M.actions.prev_message()
   require('opencode.ui.navigation').goto_prev_message()
 end
 
+function M.actions.next_user_message()
+  require('opencode.ui.navigation').goto_next_user_message()
+end
+
+function M.actions.prev_user_message()
+  require('opencode.ui.navigation').goto_prev_user_message()
+end
+
 function M.actions.clear_selections()
   require('opencode.context').clear_selections()
   vim.notify('Selections cleared', vim.log.levels.INFO)
@@ -472,6 +480,14 @@ M.command_defs = {
     desc = 'Navigate to previous message in output window',
     execute = M.actions.prev_message,
   },
+  next_user_message = {
+    desc = 'Navigate to next user message in output window',
+    execute = M.actions.next_user_message,
+  },
+  prev_user_message = {
+    desc = 'Navigate to previous user message in output window',
+    execute = M.actions.prev_user_message,
+  },
   clear_selections = {
     desc = 'Clear only selections from context',
     execute = M.actions.clear_selections,

lua/opencode/config.lua

@@ -69,6 +69,8 @@ M.defaults = {
       ['<C-c>'] =       { 'cancel',                                            desc = 'Cancel running request' },
       [']]']   =        { 'next_message',                                      desc = 'Go to next message' },
       ['[[']   =        { 'prev_message',                                      desc = 'Go to previous message' },
+      [']u']   =        { 'next_user_message',                                 desc = 'Go to next user message' },
+      ['[u']   =        { 'prev_user_message',                                 desc = 'Go to previous user message' },
       ['<tab>'] =       { 'toggle_pane',                  mode = { 'n' },      desc = 'Toggle input/output panes' },
       ['i']     =       { 'focus_input',                                       desc = 'Focus input window' },
       ['gr']    =       { 'references',                                        desc = 'Browse code references' },

lua/opencode/ui/navigation.lua

@@ -62,6 +62,52 @@ function M.goto_prev_message()
   vim.api.nvim_win_set_cursor(win, { 1, 0 })
 end
 
+function M.goto_next_user_message()
+  require('opencode.ui.ui').focus_output()
+  local windows = state.windows or {}
+  local win = windows.output_win
+  local buf = windows.output_buf
+
+  if not win or not buf then
+    return
+  end
+
+  -- Mirror `gg` in output_window.setup_keymaps: under lazy render the target
+  -- message may not yet have a line_start, so force a full render first.
+  renderer.load_all_messages()
+
+  local current_line = vim.api.nvim_win_get_cursor(win)[1]
+  local next_message = renderer.get_next_user_message(current_line)
+  if next_message and next_message.line_start then
+    vim.api.nvim_win_set_cursor(win, { next_message.line_start + 1, 0 })
+    return
+  end
+
+  vim.notify('No next user message', vim.log.levels.INFO)
+end
+
+function M.goto_prev_user_message()
+  require('opencode.ui.ui').focus_output()
+  local windows = state.windows or {}
+  local win = windows.output_win
+  local buf = windows.output_buf
+
+  if not win or not buf then
+    return
+  end
+
+  renderer.load_all_messages()
+
+  local current_line = vim.api.nvim_win_get_cursor(win)[1]
+  local previous_message = renderer.get_prev_user_message(current_line)
+  if previous_message and previous_message.line_start then
+    vim.api.nvim_win_set_cursor(win, { previous_message.line_start + 1, 0 })
+    return
+  end
+
+  vim.notify('No previous user message', vim.log.levels.INFO)
+end
+
 ---@param raw string
 local function resolve_path(raw)
   if vim.uv.fs_stat(raw) then

lua/opencode/ui/renderer.lua

@@ -625,4 +625,35 @@ function M.get_prev_rendered_message(current_line)
   return nil
 end
 
+---@param current_line integer
+---@return RenderedMessage|nil
+function M.get_next_user_message(current_line)
+  for _, message in ipairs(state.messages or {}) do
+    if message.info and message.info.role == 'user' then
+      local rendered = message.info.id and ctx.render_state:get_message(message.info.id) or nil
+      if rendered and rendered.line_start and rendered.line_start + 1 > current_line then
+        return rendered
+      end
+    end
+  end
+
+  return nil
+end
+
+---@param current_line integer
+---@return RenderedMessage|nil
+function M.get_prev_user_message(current_line)
+  for i = #(state.messages or {}), 1, -1 do
+    local message = state.messages[i]
+    if message and message.info and message.info.role == 'user' then
+      local rendered = message.info.id and ctx.render_state:get_message(message.info.id)
+      if rendered and rendered.line_start and rendered.line_start + 1 < current_line then
+        return rendered
+      end
+    end
+  end
+
+  return nil
+end
+
 return M