feat: notify and mark background prompts on session tabs

Author: sudo-tee

README.md

@@ -229,6 +229,7 @@ require('opencode').setup({
     display_context_size = true, -- Display context size in the footer
     display_cost = true, -- Display cost in the footer
     hide_single_tab = false, -- Hide the panel tab strip when only one session tab exists
+    notify_on_background_prompt = true, -- Notify when an unfocused session needs a question or permission response
     window_highlight = 'Normal:OpencodeBackground,FloatBorder:OpencodeBorder', -- Highlight group for the opencode window
     persist_state = true, -- Keep buffers when toggling/closing UI so window state restores quickly
     icons = {

lua/opencode/config.lua

@@ -178,6 +178,7 @@ M.defaults = {
     display_context_size = true,
     display_cost = true,
     hide_single_tab = true,
+    notify_on_background_prompt = true,
     window_highlight = 'Normal:OpencodeBackground,FloatBorder:OpencodeBorder',
     persist_state = true,
     icons = {

lua/opencode/init.lua

@@ -60,6 +60,7 @@ function M.setup(opts)
   require('opencode.ui.completion').setup()
   require('opencode.keymap').setup(config.keymap)
   require('opencode.event_manager').setup()
+  require('opencode.ui.session_tab_notifications').setup()
   require('opencode.context').setup()
   require('opencode.ui.context_bar').setup()
 end

lua/opencode/state/session.lua

@@ -6,6 +6,16 @@ local M = {}
 
 ---@param session Session|nil
 function M.set_active(session)
+  local previous = store.get('active_session')
+  local previous_id = type(previous) == 'table' and previous.id or nil
+  local session_id = type(session) == 'table' and session.id or nil
+  if previous_id ~= session_id then
+    local runtime = session_tabs.current()
+    if runtime then
+      session_tabs.clear_pending_prompts(runtime.id)
+    end
+  end
+
   local result = store.batch(function()
     store.set('restore_points', {})
     store.set('last_sent_context', nil)
@@ -17,6 +27,13 @@ function M.set_active(session)
 end
 
 function M.clear_active()
+  if store.get('active_session') then
+    local runtime = session_tabs.current()
+    if runtime then
+      session_tabs.clear_pending_prompts(runtime.id)
+    end
+  end
+
   local result = store.batch(function()
     store.set('restore_points', {})
     store.set('last_sent_context', nil)

lua/opencode/state/session_tabs.lua

@@ -28,6 +28,8 @@ local store = require('opencode.state.store')
 ---@field messages OpencodeMessage[]|nil
 ---@field current_message OpencodeMessage|nil
 ---@field pending_permissions OpencodePermission[]
+---@field pending_prompt_permissions OpencodePermission[]
+---@field pending_questions OpencodeQuestionRequest[]
 ---@field cost number
 ---@field tokens_count number
 ---@field user_message_count table<string, number>
@@ -141,6 +143,8 @@ local function default_runtime(id)
     messages = nil,
     current_message = nil,
     pending_permissions = {},
+    pending_prompt_permissions = {},
+    pending_questions = {},
     cost = 0,
     tokens_count = 0,
     user_message_count = {},
@@ -215,6 +219,139 @@ function M.get(id)
   return runtimes[id]
 end
 
+---@param session_id string|nil
+---@return OpencodeSessionTabRuntime|nil
+function M.find_by_session_id(session_id)
+  if not session_id or session_id == '' then
+    return nil
+  end
+
+  for _, runtime in ipairs(M.list()) do
+    if runtime.active_session and runtime.active_session.id == session_id then
+      return runtime
+    end
+
+    local render_state = runtime.renderer_context and runtime.renderer_context.render_state
+    if render_state and render_state.get_task_part_by_child_session then
+      local ok, task_part = pcall(render_state.get_task_part_by_child_session, render_state, session_id)
+      if ok and task_part then
+        return runtime
+      end
+    end
+  end
+
+  local current = M.current()
+  if current and current.active_session and current.active_session.id then
+    local render_state = require('opencode.ui.renderer.ctx').render_state
+    if render_state:get_task_part_by_child_session(session_id) then
+      return current
+    end
+  end
+end
+
+---@param tab_id string
+---@param permission OpencodePermission
+function M.add_pending_permission(tab_id, permission)
+  local runtime = runtimes[tab_id]
+  if not runtime or not permission or not permission.id then
+    return
+  end
+
+  for index, existing in ipairs(runtime.pending_prompt_permissions) do
+    if existing.id == permission.id then
+      runtime.pending_prompt_permissions[index] = permission
+      notify_change()
+      return
+    end
+  end
+
+  table.insert(runtime.pending_prompt_permissions, permission)
+  notify_change()
+end
+
+---@param tab_id string
+---@param permission_id string
+function M.remove_pending_permission(tab_id, permission_id)
+  local runtime = runtimes[tab_id]
+  if not runtime or not permission_id then
+    return
+  end
+
+  for index, permission in ipairs(runtime.pending_prompt_permissions) do
+    if permission.id == permission_id then
+      table.remove(runtime.pending_prompt_permissions, index)
+      notify_change()
+      return
+    end
+  end
+end
+
+---@param tab_id string
+---@param question OpencodeQuestionRequest
+function M.add_pending_question(tab_id, question)
+  local runtime = runtimes[tab_id]
+  if not runtime or not question or not question.id then
+    return
+  end
+
+  for index, existing in ipairs(runtime.pending_questions) do
+    if existing.id == question.id then
+      runtime.pending_questions[index] = question
+      notify_change()
+      return
+    end
+  end
+
+  table.insert(runtime.pending_questions, question)
+  notify_change()
+end
+
+---@param tab_id string
+---@param question_id string
+function M.remove_pending_question(tab_id, question_id)
+  local runtime = runtimes[tab_id]
+  if not runtime or not question_id then
+    return
+  end
+
+  for index, question in ipairs(runtime.pending_questions) do
+    if question.id == question_id then
+      table.remove(runtime.pending_questions, index)
+      notify_change()
+      return
+    end
+  end
+end
+
+---@param tab_id string
+function M.clear_pending_prompts(tab_id)
+  local runtime = runtimes[tab_id]
+  if not runtime then
+    return
+  end
+
+  local active = M.active_id() == tab_id
+  local has_pending = #runtime.pending_permissions > 0
+    or #runtime.pending_prompt_permissions > 0
+    or #runtime.pending_questions > 0
+  if active then
+    has_pending = has_pending or #(store.get('pending_permissions') or {}) > 0
+  end
+  if not has_pending then
+    return
+  end
+
+  runtime.pending_permissions = {}
+  runtime.pending_prompt_permissions = {}
+  runtime.pending_questions = {}
+  if active then
+    store.batch(function()
+      store.set('pending_permissions', {})
+    end)
+  end
+  notify_change()
+end
+
 ---@return OpencodeSessionTabRuntime|nil
 function M.current()
   local runtime = runtimes[store.get('active_session_tab')]
@@ -337,6 +474,8 @@ function M.create(session)
   runtime.messages = nil
   runtime.current_message = nil
   runtime.pending_permissions = {}
+  runtime.pending_prompt_permissions = {}
+  runtime.pending_questions = {}
   runtime.restore_points = {}
   runtime.last_sent_context = nil
   runtime.user_message_count = {}

lua/opencode/types.lua

@@ -243,6 +243,7 @@
 ---@field display_context_size boolean
 ---@field display_cost boolean
 ---@field hide_single_tab boolean
+---@field notify_on_background_prompt boolean
 ---@field window_highlight string
 ---@field icons { preset: 'text'|'nerdfonts', overrides: table<string,string> }
 ---@field loading_animation OpencodeLoadingAnimationConfig

lua/opencode/ui/base_picker.lua

@@ -63,6 +63,7 @@ local Promise = require('opencode.promise')
 ---@class BasePicker
 local M = {}
 local picker = require('opencode.ui.picker')
+local icons = require('lua.opencode.ui.icons')
 
 ---@param bufnr integer?
 ---@return PickerPreviewTarget
@@ -135,7 +136,7 @@ local function build_title(base_title, actions, support_multi)
       table.insert(legend, action.key[1] .. ' ' .. label)
     end
   end
-  return base_title .. (#legend > 0 and '' .. table.concat(legend, '') or '')
+  return base_title .. (#legend > 0 and icons.get('separator') .. table.concat(legend, icons.get('separator')) or '')
 end
 
 ---Telescope UI implementation

lua/opencode/ui/highlight.lua

@@ -13,6 +13,16 @@ function M.setup()
     vim.api.nvim_set_hl(0, 'OpencodeSessionTabIndex', { link = 'Number', default = true })
     vim.api.nvim_set_hl(0, 'OpencodeSessionTabSeparator', { link = 'NonText', default = true })
     vim.api.nvim_set_hl(0, 'OpencodeSessionTabOverflow', { link = 'Special', bold = true, default = true })
+    vim.api.nvim_set_hl(
+      0,
+      'OpencodeSessionTabPendingPermission',
+      { fg = '#9A3412', bg = '#FED7AA', bold = true, default = true }
+    )
+    vim.api.nvim_set_hl(
+      0,
+      'OpencodeSessionTabPendingQuestion',
+      { fg = '#1D4ED8', bg = '#DBEAFE', bold = true, default = true }
+    )
     vim.api.nvim_set_hl(0, 'OpencodeMention', { link = 'Special', default = true })
     vim.api.nvim_set_hl(0, 'OpencodeToolBorder', { fg = '#B0BEC5', nocombine = true, default = true })
     vim.api.nvim_set_hl(0, 'OpencodeMessageRoleAssistant', { link = 'Special', default = true })
@@ -69,6 +79,16 @@ function M.setup()
     vim.api.nvim_set_hl(0, 'OpencodeSessionTabIndex', { link = 'Number', default = true })
     vim.api.nvim_set_hl(0, 'OpencodeSessionTabSeparator', { link = 'NonText', default = true })
     vim.api.nvim_set_hl(0, 'OpencodeSessionTabOverflow', { link = 'Special', bold = true, default = true })
+    vim.api.nvim_set_hl(
+      0,
+      'OpencodeSessionTabPendingPermission',
+      { fg = '#FFD580', bg = '#5A3A00', bold = true, default = true }
+    )
+    vim.api.nvim_set_hl(
+      0,
+      'OpencodeSessionTabPendingQuestion',
+      { fg = '#9CDCFE', bg = '#1E3A5F', bold = true, default = true }
+    )
     vim.api.nvim_set_hl(0, 'OpencodeMention', { link = 'Special', default = true })
     vim.api.nvim_set_hl(0, 'OpencodeToolBorder', { fg = '#3b4261', nocombine = true, default = true })
     vim.api.nvim_set_hl(0, 'OpencodeRevertBorder', { bg = '#FF9E3B', default = true })

lua/opencode/ui/icons.lua

@@ -51,6 +51,7 @@ local presets = {
     running = ' ',
     checkbox_checked = ' ',
     checkbox_unchecked = ' ',
+    separator = '',
   },
   text = {
     -- headers
@@ -98,6 +99,7 @@ local presets = {
     running = '> ',
     checkbox_checked = '[*]',
     checkbox_unchecked = '[ ]',
+    separator = '|',
   },
 }
 

lua/opencode/ui/permission_window.lua

@@ -1,4 +1,5 @@
 local state = require('opencode.state')
+local session_tabs = require('opencode.state.session_tabs')
 local Dialog = require('opencode.ui.dialog')
 local session_scope = require('opencode.ui.session_scope')
 local formatter_utils = require('opencode.ui.formatter.utils')
@@ -219,6 +220,10 @@ function M.remove_permission(permission_id)
 
   for i, permission in ipairs(M._permission_queue) do
     if permission.id == permission_id then
+      local runtime = session_tabs.find_by_session_id(permission.sessionID)
+      if runtime then
+        session_tabs.remove_pending_permission(runtime.id, permission_id)
+      end
       table.remove(M._permission_queue, i)
       break
     end
@@ -532,6 +537,10 @@ function M.restore_pending_permissions(session_id)
       for _, permission in ipairs(permissions) do
         if permission and permission.id then
           if session_scope.belongs_to_session(permission, session_id) and not is_resolved_permission(permission) then
+            local runtime = session_tabs.find_by_session_id(session_id)
+            if runtime then
+              session_tabs.add_pending_permission(runtime.id, permission)
+            end
             -- Check if already queued (avoid duplicate)
             local already_queued = false
             for _, existing in ipairs(M._permission_queue) do