@mirrowel/opencode-souk 0.1.0

package/src/tui.tsx

@@ -0,0 +1,1892 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs"
+import type { TuiPlugin, TuiPluginApi, TuiDialogSelectOption } from "@opencode-ai/plugin/tui"
+import type { ScrollBoxRenderable } from "@opentui/core"
+import { useTerminalDimensions } from "@opentui/solid"
+import { createEffect, createMemo, createSignal, For, onCleanup, Show } from "solid-js"
+import {
+  backupJournalPath,
+  createFullBackup,
+  deleteAllFullBackups,
+  deleteFullBackup,
+  confidenceRank,
+  debugLogPath,
+  defaultConfigDir,
+  defaultCachePath,
+  defaultSidecarPath,
+  diagnoseConfig,
+  effectiveUiHeightPercent,
+  loadBackupJournal,
+  loadCache,
+  loadSidecar,
+  loadSidecarSafe,
+  PERSONALITY_PRESETS,
+  personalityDescription,
+  reconstructPatchBackup,
+  saveBackupJournal,
+  saveSidecar,
+  type BackupJournal,
+  type CacheFile,
+  type FullBackupEntry,
+  type RegistryItem,
+  type ScopeChoice,
+  type SidecarConfig,
+} from "./config.js"
+import { openForge } from "./forge.js"
+import { nativeInstall, previewNativeInstall, scopeLabel } from "./install.js"
+import { loadRegistry } from "./registry.js"
+
+type KeyContext = { event?: { preventDefault?: () => void; stopPropagation?: () => void } }
+type SoukItem = RegistryItem & { installed?: { id: string; active: boolean; enabled: boolean; spec: string } }
+type DialogSize = "medium" | "large" | "xlarge"
+type DialogHeight = "compact" | "normal" | "tall" | "max"
+type DisplayColor = string | TuiPluginApi["theme"]["current"]["text"]
+type UI = TuiPluginApi["ui"]
+type WizardSelectOption<Value = unknown> = TuiDialogSelectOption<Value> & { color?: DisplayColor; danger?: boolean; help?: string }
+type MenuChoice<Value> = { action: "select" | "inspect"; value: Value }
+type HeightSliderChoice = { action: "save" | "custom"; value: number }
+type BrowserState = { config: SidecarConfig; cache: CacheFile; cursor: number; selected: Set<string>; search: string }
+type BrowserAction =
+  | { action: "back"; state: BrowserState }
+  | { action: "inspect"; state: BrowserState; item: SoukItem }
+  | { action: "install"; state: BrowserState; items: SoukItem[] }
+  | { action: "settings"; state: BrowserState }
+  | { action: "refresh"; state: BrowserState }
+  | { action: "search"; state: BrowserState }
+type InstalledPluginsState = { cursor: number }
+type InstalledPluginsAction =
+  | { action: "back"; state: InstalledPluginsState }
+  | { action: "inspect"; state: InstalledPluginsState; item: SoukItem }
+  | { action: "toggle"; state: InstalledPluginsState; item: SoukItem }
+  | { action: "refresh"; state: InstalledPluginsState }
+type BackupListItem =
+  | { kind: "patch"; index: number; title: string; description: string; valid: boolean }
+  | { kind: "full"; id: string; title: string; description: string; entry: FullBackupEntry }
+
+const INTERNAL_PLUGIN_MANAGER = "internal:plugin-manager"
+const MODE = "souk.dialog"
+const UI_SIZE_KV = "opencode-souk.ui-width"
+const UI_HEIGHT_KV = "opencode-souk.ui-height"
+const UI_HEIGHT_PERCENT_KV = "opencode-souk.ui-height-percent"
+const BROWSER_SIZE_KV = "opencode-souk.browser-width"
+const HEIGHT_PERCENT_MIN = 25
+const HEIGHT_PERCENT_MAX = 100
+const HEIGHT_PRESETS: Array<{ label: DialogHeight; value: number; key: string }> = [
+  { label: "compact", value: 32, key: "1" },
+  { label: "normal", value: 50, key: "2" },
+  { label: "tall", value: 68, key: "3" },
+  { label: "max", value: 100, key: "4" },
+]
+const SHIELDED_KEYS = [
+  ..."abcdefghijklmnopqrstuvwxyz".split(""),
+  ..."0123456789".split(""),
+  "space",
+  "tab",
+  "backspace",
+  "delete",
+  "home",
+  "end",
+  "left",
+  "right",
+  "/",
+  "?",
+  ":",
+  ";",
+  "'",
+  "\"",
+  ",",
+  ".",
+  "-",
+  "=",
+  "[",
+  "]",
+  "\\",
+  "`",
+] as const
+
+function blockKey(ctx?: KeyContext) {
+  ctx?.event?.preventDefault?.()
+  ctx?.event?.stopPropagation?.()
+}
+
+function shieldBindings(command: string, except: string[] = []) {
+  return SHIELDED_KEYS.filter((key) => !except.includes(key)).map((key) => ({ key, cmd: command, desc: "Block background input" }))
+}
+
+function wizardDialogSize(api: TuiPluginApi): DialogSize {
+  const value = api.kv.get<DialogSize>(UI_SIZE_KV, "large")
+  if (value === "medium" || value === "large" || value === "xlarge") return value
+  return "large"
+}
+
+function setWizardDialogSize(api: TuiPluginApi, size: DialogSize) {
+  api.kv.set(UI_SIZE_KV, size)
+  api.ui.dialog.setSize(size)
+}
+
+function browserDialogSize(api: TuiPluginApi): DialogSize {
+  const value = api.kv.get<DialogSize>(BROWSER_SIZE_KV, "xlarge")
+  if (value === "medium" || value === "large" || value === "xlarge") return value
+  return "xlarge"
+}
+
+function setBrowserDialogSize(api: TuiPluginApi, size: DialogSize) {
+  api.kv.set(BROWSER_SIZE_KV, size)
+}
+
+function nextWizardDialogSize(api: TuiPluginApi): DialogSize {
+  const current = wizardDialogSize(api)
+  if (current === "medium") return "large"
+  if (current === "large") return "xlarge"
+  return "medium"
+}
+
+function nextBrowserDialogSize(api: TuiPluginApi): DialogSize {
+  const current = browserDialogSize(api)
+  if (current === "medium") return "large"
+  if (current === "large") return "xlarge"
+  return "medium"
+}
+
+function heightPresetPercent(height: DialogHeight) {
+  return HEIGHT_PRESETS.find((preset) => preset.label === height)?.value ?? 68
+}
+
+function setWizardDialogHeight(api: TuiPluginApi, height: DialogHeight) {
+  api.kv.set(UI_HEIGHT_KV, height)
+}
+
+function clampHeightPercent(value: number) {
+  return Math.max(HEIGHT_PERCENT_MIN, Math.min(HEIGHT_PERCENT_MAX, Math.round(value)))
+}
+
+function wizardDialogHeightPercent(api: TuiPluginApi) {
+  const value = api.kv.get<number>(UI_HEIGHT_PERCENT_KV, 68)
+  return typeof value === "number" && Number.isFinite(value) ? clampHeightPercent(value) : 68
+}
+
+function setWizardDialogHeightPercent(api: TuiPluginApi, value: number) {
+  api.kv.set(UI_HEIGHT_PERCENT_KV, clampHeightPercent(value))
+}
+
+function useWizardDialogSize(api: TuiPluginApi) {
+  createEffect(() => api.ui.dialog.setSize(wizardDialogSize(api)))
+}
+
+function useBrowserDialogSize(api: TuiPluginApi) {
+  createEffect(() => api.ui.dialog.setSize(browserDialogSize(api)))
+}
+
+function useHidePromptCursor(api: TuiPluginApi) {
+  const editors = collectEditors(api.renderer.root)
+  const previous = editors.map((editor) => ({ editor, showCursor: editor.showCursor }))
+  for (const editor of editors) editor.showCursor = false
+  onCleanup(() => {
+    for (const item of previous) {
+      if (item.editor.isDestroyed) continue
+      item.editor.showCursor = item.showCursor
+    }
+  })
+}
+
+function collectEditors(root: { getChildren?: () => unknown[] }): Array<{ showCursor: boolean; isDestroyed?: boolean; getChildren?: () => unknown[] }> {
+  const children = typeof root.getChildren === "function" ? root.getChildren() : []
+  return [
+    ...(typeof (root as { showCursor?: unknown }).showCursor === "boolean" ? [root as { showCursor: boolean; isDestroyed?: boolean; getChildren?: () => unknown[] }] : []),
+    ...children.flatMap((child) => collectEditors(child as { getChildren?: () => unknown[] })),
+  ]
+}
+
+function cappedHeight(count: number, max: number, min = 1) {
+  if (count <= 0) return min
+  return Math.max(min, Math.min(count, max))
+}
+
+function wizardMaxRows(api: TuiPluginApi, terminalHeight: number, chromeRows: number, minRows: number) {
+  const usable = Math.max(minRows, terminalHeight - chromeRows)
+  return Math.max(minRows, Math.min(usable, Math.floor(terminalHeight * (wizardDialogHeightPercent(api) / 100))))
+}
+
+function menuTitleWidth(size: DialogSize, options: readonly { title: string }[]) {
+  const longest = Math.max(0, ...options.map((option) => option.title.length)) + 3
+  if (size === "xlarge") return Math.min(Math.max(24, longest), 36)
+  if (size === "large") return Math.min(Math.max(24, longest), 30)
+  return Math.min(Math.max(22, longest), 26)
+}
+
+function dialogContentWidth(api: TuiPluginApi) {
+  const size = wizardDialogSize(api)
+  if (size === "xlarge") return 106
+  if (size === "large") return 78
+  return 50
+}
+
+function estimatedVisualRows(message: string, width: number) {
+  return message.split(/\r?\n/).reduce((rows, line) => rows + Math.max(1, Math.ceil(line.length / Math.max(1, width))), 0)
+}
+
+function singleLine(value: string | undefined, fallback = "") {
+  const text = (value ?? "").replace(/[\r\n\t]+/g, " ").replace(/\s{2,}/g, " ").trim()
+  return text || fallback
+}
+
+function KeyHints(props: { api: TuiPluginApi; hints: Array<{ key: string; label: string }> }) {
+  const theme = () => props.api.theme.current
+  return (
+    <box flexDirection="row" gap={2}>
+      <For each={props.hints}>{(hint) => (
+        <box flexDirection="row" gap={0}>
+          <text fg={theme().accent}><b>{hint.key}</b></text>
+          <text fg={theme().textMuted}> {hint.label}</text>
+        </box>
+      )}</For>
+    </box>
+  )
+}
+
+function installedItems(api: TuiPluginApi): SoukItem[] {
+  return api.plugins.list()
+    .map((plugin) => ({
+      id: `installed:${plugin.id}`,
+      source: "installed" as const,
+      sourceType: plugin.source,
+      kind: "plugin" as const,
+      confidence: "verified" as const,
+      name: plugin.id,
+      description: plugin.source === "internal" ? "Built-in TUI plugin" : plugin.spec,
+      tags: [plugin.source, plugin.active ? "active" : "inactive", plugin.enabled ? "enabled" : "disabled"],
+      aliases: [],
+      alternateKinds: [],
+      sources: [],
+      primarySource: "installed" as const,
+      warnings: plugin.id === INTERNAL_PLUGIN_MANAGER ? ["Souk replaces this built-in manager."] : plugin.id === "opencode-souk" ? ["This is the running Souk plugin."] : [],
+      installed: { id: plugin.id, active: plugin.active, enabled: plugin.enabled, spec: plugin.spec },
+    }))
+    .sort((a, b) => a.name.localeCompare(b.name))
+}
+
+function marketplaceItems(cache: CacheFile): SoukItem[] {
+  return cache.items
+    .sort((a, b) => confidenceRank(a.confidence) - confidenceRank(b.confidence) || a.kind.localeCompare(b.kind) || a.name.localeCompare(b.name))
+}
+
+function visibleMarketplaceItems(cache: CacheFile, config: SidecarConfig, query: string): SoukItem[] {
+  const terms = query.toLowerCase().split(/\s+/).filter(Boolean)
+  return marketplaceItems(cache).filter((item) => {
+    if (config.hidden[item.id]) return false
+    if (!terms.length) return true
+    const haystack = [
+      item.name,
+      item.description,
+      item.kind,
+      item.confidence,
+      item.source,
+      item.sourceType,
+      item.repoUrl,
+      item.homepageUrl,
+      item.install?.spec,
+      ...(item.install?.specs ?? []),
+      ...item.tags,
+      ...item.aliases,
+      ...item.alternateKinds,
+      ...item.sources.flatMap((source) => [source.source, source.sourceType, source.name, source.description, source.repoUrl, source.kind, source.confidence]),
+    ].filter(Boolean).join(" ").toLowerCase()
+    return terms.every((term) => haystack.includes(term))
+  })
+}
+
+async function openSouk(api: TuiPluginApi, force = false) {
+  const loaded = loadSidecarSafe(defaultSidecarPath())
+  const config = loaded.config
+  setWizardDialogSize(api, config.ui.width)
+  setWizardDialogHeight(api, config.ui.height)
+  setWizardDialogHeightPercent(api, effectiveUiHeightPercent(config.ui))
+  setBrowserDialogSize(api, config.ui.browser.width)
+  if (loaded.error) api.ui.toast({ variant: "error", message: `Souk config failed to parse; defaults are active: ${loaded.error}` })
+  let cache = loadCache(defaultCachePath())
+  if (force || (config.cache.fetch_on_empty && cache.items.length === 0)) {
+    api.ui.toast({ variant: "info", message: force ? "Refreshing Souk sources..." : "Souk cache is empty; fetching sources..." })
+    cache = await loadRegistry(config, { force })
+    api.ui.toast({ variant: cache.items.length > 0 ? "success" : "warning", message: `Souk cache has ${cache.items.length} marketplace item(s).` })
+  }
+  await mainMenu(api, config, cache, loaded.error)
+}
+
+async function mainMenu(api: TuiPluginApi, config: SidecarConfig, cache: CacheFile, configParseError?: string): Promise<void> {
+  const action = await showMenu(api, {
+    title: "OpenCode Souk",
+    options: [
+      { title: "Browse items", value: "browse", description: `${marketplaceItems(cache).length} marketplace item(s)`, help: mainMenuHelp("browse", api, config, cache) },
+      { title: "Installed plugins", value: "installed", description: `${installedItems(api).length} installed plugin(s)`, help: mainMenuHelp("installed", api, config, cache) },
+      { title: "Refresh sources", value: "refresh", description: "Fetch community sources now", help: mainMenuHelp("refresh", api, config, cache) },
+      { title: "Kāf Forge settings", value: "forge", description: `Forge ${config.forge.enabled ? "enabled" : "disabled"}`, help: mainMenuHelp("forge", api, config, cache) },
+      { title: "Run diagnostics", value: "diagnostics", description: "Check config, cache, sources, model, and backups", help: mainMenuHelp("diagnostics", api, config, cache) },
+      { title: "Debug & advanced", value: "advanced", description: "Debug log, backups, UI size", help: mainMenuHelp("advanced", api, config, cache) },
+      { title: "Info", value: "info", description: "How Souk works", help: mainMenuHelp("info", api, config, cache) },
+      { title: "Close", value: "close", description: "Leave the souk", help: mainMenuHelp("close", api, config, cache) },
+    ],
+  })
+  if (!action || action === "close") return
+  if (action === "browse") {
+    const next = await browseItems(api, config, cache)
+    return mainMenu(api, next.config, next.cache, configParseError)
+  }
+  if (action === "installed") {
+    await manageInstalledPlugins(api)
+    return mainMenu(api, config, cache, configParseError)
+  }
+  if (action === "refresh") {
+    const next = await loadRegistry(config, { force: true })
+    api.ui.toast({ variant: "success", message: `Refreshed ${next.items.length} marketplace item(s).` })
+    return mainMenu(api, config, next, configParseError)
+  }
+  if (action === "forge") {
+    const next = await forgeSettings(api, config)
+    if (next) {
+      await saveSidecarWithToast(api, next)
+      return mainMenu(api, next, cache, configParseError)
+    }
+  }
+  if (action === "diagnostics") {
+    await runDiagnostics(api, config, cache, configParseError)
+    return mainMenu(api, config, cache, configParseError)
+  }
+  if (action === "advanced") {
+    const next = await debugAdvancedMenu(api, config)
+    return mainMenu(api, next, cache, configParseError)
+  }
+  if (action === "info") {
+    await showSoukInfo(api)
+    return mainMenu(api, config, cache, configParseError)
+  }
+}
+
+function mainMenuHelp(action: "browse" | "installed" | "refresh" | "forge" | "diagnostics" | "advanced" | "info" | "close", api: TuiPluginApi, config: SidecarConfig, cache: CacheFile) {
+  const installed = installedItems(api).length
+  const marketplace = cache.items.length
+  const staleHours = config.cache.stale_after_hours
+  const sourceCount = Object.values(config.sources).filter((source) => source.enabled).length
+  const common = "Press Enter to select this menu item. Press Esc to return. Press i on any Souk menu row to read this contextual help."
+  if (action === "browse") return [
+    "Browse Items",
+    "Opens the Souk marketplace browser with cached registry entries only.",
+    "",
+    `Current inventory: ${marketplace} marketplace item(s). Installed plugins live in the separate Installed plugins view.`,
+    "",
+    "Controls",
+    "Enter toggles selection. Space opens the install menu for selected items, or for the highlighted item when nothing is selected.",
+    "/ opens marketplace search. i opens the highlighted item's appraisal without leaving the browser. s opens Kāf settings and returns to the browser. r refreshes sources and returns to the browser. Shift+Up/Down or Ctrl+Up/Down jumps kind groups. Shift+Left/Right jumps tag groups. Esc returns to this main menu.",
+    "",
+    "Safety",
+    "Item rows show normalized kind, merged confidence, source-derived name, and a one-line description. Press i before installing anything unfamiliar; combo items list every contributing source.",
+    common,
+  ].join("\n")
+  if (action === "installed") return [
+    "Installed Plugins",
+    "Opens a separate management view for plugins already known to the running OpenCode TUI.",
+    "",
+    `Installed plugins: ${installed}.`,
+    "",
+    "Controls",
+    "Enter toggles the highlighted plugin on or off. i opens plugin details. r refreshes the runtime plugin list. Esc returns to this main menu.",
+    "",
+    "Scope",
+    "This view does not install, batch-select, open Forge, or write marketplace config. It only calls OpenCode's plugin activate/deactivate API for an installed plugin.",
+    common,
+  ].join("\n")
+  if (action === "refresh") return [
+    "Refresh Sources",
+    "Fetches configured community sources now and rewrites the local marketplace cache.",
+    "",
+    `Enabled sources: ${sourceCount}. Cache stale threshold: ${staleHours} hour(s).`,
+    "Souk normally fetches when the cache is empty or when you explicitly refresh. Manual refresh is useful after changing source settings or when you expect new registry entries.",
+    "",
+    "Persistence",
+    `Cache file: ${defaultCachePath()}`,
+    "Refresh does not install anything and does not modify OpenCode config.",
+    common,
+  ].join("\n")
+  if (action === "forge") return [
+    "Kāf Forge Settings",
+    "Configures the experimental LLM-assisted install path.",
+    "",
+    `Current state: Forge ${config.forge.enabled ? "enabled" : "disabled"}. Model: ${config.forge.agent.model}. Personality: ${config.forge.agent.personality}.`,
+    "",
+    "Behavior",
+    "Kāf is available for every item, including verified items, when Forge is enabled. Kāf starts in a read-only planning agent, must analyze security, and must ask yes/no before switching to action mode.",
+    "",
+    "Risk",
+    "Forge is experimental. The souk can make mistakes. Review Kāf's plan, source provenance, config writes, shell commands, permissions, and OAuth/token handling before approving action mode.",
+    common,
+  ].join("\n")
+  if (action === "diagnostics") return [
+    "Run Diagnostics",
+    "Checks whether Souk's current runtime state looks coherent.",
+    "",
+    "Diagnostics cover config parse errors, cache/source state, stale cache age, Kāf model and variant references, backup journal health, and loaded plugin IDs.",
+    "",
+    "Diagnostics are read-only. They do not refresh sources, install items, restore backups, or write config.",
+    common,
+  ].join("\n")
+  if (action === "advanced") return [
+    "Debug & Advanced",
+    "Advanced operational tools ported from Agent Variants for safer plugin maintenance.",
+    "",
+    `Debug log: ${debugLogPath(defaultConfigDir())}`,
+    `Backup journal: ${backupJournalPath(defaultConfigDir())}`,
+    "",
+    "Includes debug logging, recent log viewing, log clearing, full config backups, backup browsing/restoring, and TUI width/height controls.",
+    "UI size changes are hot. Kāf agent config changes may require a full OpenCode restart to be fully reflected.",
+    common,
+  ].join("\n")
+  if (action === "info") return [
+    "Souk Info",
+    "Opens the full Souk help page.",
+    "",
+    "The info page explains the main menu, item browser, native installs, Forge/Kāf, confidence labels, scope prompts, cache behavior, backups, and debug logging.",
+    "Use it when you want a broader map rather than help for only the highlighted row.",
+    common,
+  ].join("\n")
+  return [
+    "Close",
+    "Leaves Souk and clears the current dialog.",
+    "",
+    "No marketplace cache, config, backup, install, or Forge changes are made by closing the UI.",
+    common,
+  ].join("\n")
+}
+
+async function browseItems(api: TuiPluginApi, config: SidecarConfig, cache: CacheFile): Promise<{ config: SidecarConfig; cache: CacheFile }> {
+  let state: BrowserState = { config, cache, cursor: 0, selected: new Set(), search: "" }
+  while (true) {
+    const action = await showBrowserOnce(api, state)
+    if (!action) return { config: state.config, cache: state.cache }
+    state = action.state
+    if (action.action === "back") return { config: state.config, cache: state.cache }
+    if (action.action === "inspect") {
+      await showInfo(api, { title: action.item.name, message: itemInfo(action.item, state.config) })
+      continue
+    }
+    if (action.action === "settings") {
+      const next = await forgeSettings(api, state.config)
+      if (next) {
+        state = { ...state, config: next }
+        await saveSidecarWithToast(api, next)
+      }
+      continue
+    }
+    if (action.action === "search") {
+      const nextSearch = await showPrompt(api, { title: "Search marketplace", placeholder: "name, kind, tag, source, repo... empty clears", value: state.search })
+      if (nextSearch !== undefined) {
+        state = { ...state, search: nextSearch.trim(), cursor: 0 }
+      }
+      continue
+    }
+    if (action.action === "refresh") {
+      try {
+        const next = await loadRegistry(state.config, { force: true })
+        state = { ...state, cache: next, cursor: Math.min(state.cursor, Math.max(0, visibleMarketplaceItems(next, state.config, state.search).length - 1)) }
+        api.ui.toast({ variant: "success", message: `Refreshed ${next.items.length} marketplace item(s).` })
+      } catch (error) {
+        api.ui.toast({ variant: "error", message: error instanceof Error ? error.message : String(error) })
+      }
+      continue
+    }
+    if (action.action === "install") {
+      await installMenu(api, state.config, action.items)
+      continue
+    }
+  }
+}
+
+function showBrowserOnce(api: TuiPluginApi, state: BrowserState): Promise<BrowserAction | undefined> {
+  return new Promise((resolve) => {
+    let settled = false
+    const done = (value: BrowserAction | undefined, clear = true) => {
+      if (settled) return
+      settled = true
+      resolve(value)
+      if (clear) api.ui.dialog.clear()
+    }
+    api.ui.dialog.replace(() => <SoukDialog api={api} initialState={state} onDone={done} />, () => done(undefined, false))
+  })
+}
+
+function SoukDialog(props: { api: TuiPluginApi; initialState: BrowserState; onDone: (value: BrowserAction | undefined) => void }) {
+  const api = props.api
+  const theme = () => api.theme.current
+  useBrowserDialogSize(api)
+  useHidePromptCursor(api)
+  const dimensions = useTerminalDimensions()
+  const [config] = createSignal(props.initialState.config)
+  const [cache] = createSignal(props.initialState.cache)
+  const [search] = createSignal(props.initialState.search)
+  const [selected, setSelected] = createSignal<Set<string>>(new Set(props.initialState.selected))
+  const [cursor, setCursor] = createSignal(props.initialState.cursor)
+  const items = createMemo(() => visibleMarketplaceItems(cache(), config(), search()))
+  const current = createMemo(() => items()[Math.min(cursor(), Math.max(0, items().length - 1))])
+  const listHeight = createMemo(() => cappedHeight(items().length, wizardMaxRows(api, dimensions().height, 12, 8), 8))
+  const nameWidth = createMemo(() => browserDialogSize(api) === "xlarge" ? 36 : browserDialogSize(api) === "large" ? 30 : 22)
+  const popMode = api.mode.push(MODE)
+  let scroll: ScrollBoxRenderable | undefined
+  const snapshot = (): BrowserState => ({
+    config: config(),
+    cache: cache(),
+    cursor: Math.min(cursor(), Math.max(0, items().length - 1)),
+    selected: new Set(selected()),
+    search: search(),
+  })
+
+  const move = (delta: number) => setCursor((value) => {
+    const next = Math.max(0, Math.min(items().length - 1, value + delta))
+    scroll?.scrollTo(Math.max(0, next - 2))
+    return next
+  })
+  const jumpBy = (delta: 1 | -1, field: "kind" | "tag") => setCursor((value) => {
+    const list = items()
+    if (!list.length) return 0
+    const currentItem = list[value]
+    const currentValue = field === "kind" ? currentItem?.kind : currentItem?.tags[0]
+    let index = value
+    while (index + delta >= 0 && index + delta < list.length) {
+      index += delta
+      const nextValue = field === "kind" ? list[index]?.kind : list[index]?.tags[0]
+      if (nextValue !== currentValue) {
+        scroll?.scrollTo(Math.max(0, index - 2))
+        return index
+      }
+    }
+    return value
+  })
+  const toggle = () => {
+    const item = current()
+    if (!item) return
+    setSelected((prev) => {
+      const next = new Set(prev)
+      if (next.has(item.id)) next.delete(item.id)
+      else next.add(item.id)
+      return next
+    })
+  }
+  const inspect = () => {
+    const item = current()
+    if (!item) return
+    props.onDone({ action: "inspect", state: snapshot(), item })
+  }
+  const install = () => {
+    const chosen = selectedItems(items(), selected())
+    if (!chosen.length) {
+      api.ui.toast({ variant: "warning", message: "Select at least one item with Enter before installing." })
+      return
+    }
+    props.onDone({ action: "install", state: snapshot(), items: chosen })
+  }
+  const commandPrefix = `souk.main.${Math.random().toString(36).slice(2)}`
+  const unregister = api.keymap.registerLayer({
+    priority: 10000,
+    commands: [
+      { name: `${commandPrefix}.up`, title: "Previous item", run: (ctx: KeyContext) => { blockKey(ctx); move(-1) } },
+      { name: `${commandPrefix}.down`, title: "Next item", run: (ctx: KeyContext) => { blockKey(ctx); move(1) } },
+      { name: `${commandPrefix}.toggle`, title: "Select item", run: (ctx: KeyContext) => { blockKey(ctx); toggle() } },
+      { name: `${commandPrefix}.install`, title: "Install selected", run: (ctx: KeyContext) => { blockKey(ctx); install() } },
+      { name: `${commandPrefix}.inspect`, title: "Inspect item", run: (ctx: KeyContext) => { blockKey(ctx); inspect() } },
+      { name: `${commandPrefix}.search`, title: "Search items", run: (ctx: KeyContext) => { blockKey(ctx); props.onDone({ action: "search", state: snapshot() }) } },
+      { name: `${commandPrefix}.jumpKindUp`, title: "Previous kind", run: (ctx: KeyContext) => { blockKey(ctx); jumpBy(-1, "kind") } },
+      { name: `${commandPrefix}.jumpKindDown`, title: "Next kind", run: (ctx: KeyContext) => { blockKey(ctx); jumpBy(1, "kind") } },
+      { name: `${commandPrefix}.jumpTagUp`, title: "Previous tag", run: (ctx: KeyContext) => { blockKey(ctx); jumpBy(-1, "tag") } },
+      { name: `${commandPrefix}.jumpTagDown`, title: "Next tag", run: (ctx: KeyContext) => { blockKey(ctx); jumpBy(1, "tag") } },
+      { name: `${commandPrefix}.refresh`, title: "Refresh sources", run: (ctx: KeyContext) => { blockKey(ctx); props.onDone({ action: "refresh", state: snapshot() }) } },
+      { name: `${commandPrefix}.settings`, title: "Forge settings", run: (ctx: KeyContext) => { blockKey(ctx); props.onDone({ action: "settings", state: snapshot() }) } },
+      { name: `${commandPrefix}.close`, title: "Back", run: (ctx: KeyContext) => { blockKey(ctx); props.onDone({ action: "back", state: snapshot() }) } },
+      { name: `${commandPrefix}.shield`, title: "Block background input", run: blockKey },
+    ],
+    bindings: [
+      { key: "up", cmd: `${commandPrefix}.up`, desc: "Previous item" },
+      { key: "ctrl+p", cmd: `${commandPrefix}.up`, desc: "Previous item" },
+      { key: "down", cmd: `${commandPrefix}.down`, desc: "Next item" },
+      { key: "ctrl+n", cmd: `${commandPrefix}.down`, desc: "Next item" },
+      { key: "enter", cmd: `${commandPrefix}.toggle`, desc: "Select item" },
+      { key: "space", cmd: `${commandPrefix}.install`, desc: "Install selected" },
+      { key: "i", cmd: `${commandPrefix}.inspect`, desc: "Inspect item" },
+      { key: "/", cmd: `${commandPrefix}.search`, desc: "Search items" },
+      { key: "shift+up", cmd: `${commandPrefix}.jumpKindUp`, desc: "Previous kind" },
+      { key: "shift+down", cmd: `${commandPrefix}.jumpKindDown`, desc: "Next kind" },
+      { key: "ctrl+up", cmd: `${commandPrefix}.jumpKindUp`, desc: "Previous kind" },
+      { key: "ctrl+down", cmd: `${commandPrefix}.jumpKindDown`, desc: "Next kind" },
+      { key: "shift+left", cmd: `${commandPrefix}.jumpTagUp`, desc: "Previous tag" },
+      { key: "shift+right", cmd: `${commandPrefix}.jumpTagDown`, desc: "Next tag" },
+      { key: "r", cmd: `${commandPrefix}.refresh`, desc: "Refresh sources" },
+      { key: "s", cmd: `${commandPrefix}.settings`, desc: "Forge settings" },
+      { key: "escape", cmd: `${commandPrefix}.close`, desc: "Back" },
+      ...shieldBindings(`${commandPrefix}.shield`, ["space", "i", "r", "s", "/"]),
+    ],
+  } as any)
+  onCleanup(() => {
+    unregister()
+    popMode()
+  })
+
+  return (
+    <box flexDirection="column" width="100%" paddingLeft={2} paddingRight={2} paddingTop={1} paddingBottom={1}>
+      <box flexDirection="row" justifyContent="space-between" width="100%" marginBottom={1}>
+        <text fg={theme().accent}><b>OpenCode Souk</b></text>
+        <KeyHints api={api} hints={[{ key: "enter", label: "select" }, { key: "space", label: "install" }, { key: "/", label: "search" }, { key: "i", label: "inspect" }, { key: "r", label: "refresh" }, { key: "s", label: "settings" }, { key: "esc", label: "back" }]} />
+      </box>
+      <box flexDirection="row" gap={2} marginBottom={1}>
+        <text fg={theme().textMuted}>{items().length} item(s)</text>
+        <Show when={search()}><text fg={theme().accent}>search: {search()}</text></Show>
+        <text fg={theme().success}>{selected().size} selected</text>
+        <text fg={config().forge.enabled ? theme().warning : theme().textMuted}>Forge: {config().forge.enabled ? "enabled" : "disabled"}</text>
+      </box>
+      <box flexDirection="row" width="100%" gap={1} paddingLeft={1} paddingRight={1} marginBottom={0}>
+        <text width={3} fg={theme().textMuted}>sel</text>
+        <text width={7} fg={theme().textMuted}>kind</text>
+        <text width={9} fg={theme().textMuted}>status</text>
+        <text width={nameWidth()} fg={theme().textMuted}>name</text>
+        <text flexGrow={1} fg={theme().textMuted}>description</text>
+      </box>
+      <scrollbox maxHeight={listHeight()} ref={(element: ScrollBoxRenderable) => (scroll = element)}>
+        <box flexDirection="column" gap={0}>
+          <For each={items()}>
+            {(item, index) => {
+              const active = createMemo(() => cursor() === index())
+              const picked = createMemo(() => selected().has(item.id))
+              const fg = createMemo(() => active() ? theme().background : item.confidence === "verified" ? theme().success : item.confidence === "partial" ? theme().warning : theme().text)
+              return (
+                <box
+                  flexDirection="row"
+                  width="100%"
+                  gap={1}
+                  paddingLeft={1}
+                  paddingRight={1}
+                  backgroundColor={active() ? theme().primary : theme().backgroundPanel}
+                  onMouseOver={() => setCursor(index())}
+                  onMouseUp={toggle}
+                >
+                  <text width={3} fg={active() ? theme().background : picked() ? theme().success : theme().textMuted}>{picked() ? "[x]" : "[ ]"}</text>
+                  <text width={7} fg={fg()} wrapMode="none" overflow="hidden">{singleLine(item.kind)}</text>
+                  <text width={9} fg={fg()} wrapMode="none" overflow="hidden">{singleLine(item.confidence)}</text>
+                  <text width={nameWidth()} fg={fg()} wrapMode="none" overflow="hidden"><b>{singleLine(item.name, item.id)}</b></text>
+                  <text flexGrow={1} fg={active() ? theme().background : theme().textMuted} wrapMode="none" overflow="hidden">{singleLine(item.description, "No description.")}</text>
+                </box>
+              )
+            }}
+          </For>
+        </box>
+      </scrollbox>
+      <box marginTop={1}>
+        <text fg={theme().textMuted}>A quiet shelf of unusual pieces. / searches. shift+up/down jumps kinds; shift+left/right jumps tags.</text>
+      </box>
+    </box>
+  )
+}
+
+async function manageInstalledPlugins(api: TuiPluginApi): Promise<void> {
+  let state: InstalledPluginsState = { cursor: 0 }
+  while (true) {
+    const action = await showInstalledPluginsOnce(api, state)
+    if (!action) return
+    state = action.state
+    if (action.action === "back") return
+    if (action.action === "inspect") {
+      await showInfo(api, { title: action.item.name, message: installedPluginInfo(action.item) })
+      continue
+    }
+    if (action.action === "refresh") {
+      state = { cursor: Math.min(state.cursor, Math.max(0, installedItems(api).length - 1)) }
+      api.ui.toast({ variant: "info", message: `Found ${installedItems(api).length} installed plugin(s).` })
+      continue
+    }
+    if (action.action === "toggle") {
+      const id = action.item.installed?.id
+      if (!id) continue
+      if (id === "opencode-souk") {
+        api.ui.toast({ variant: "warning", message: "Souk cannot deactivate itself from inside Souk." })
+        continue
+      }
+      try {
+        if (action.item.installed?.active) {
+          await api.plugins.deactivate(id)
+          api.ui.toast({ variant: "success", message: `Deactivated ${id}.` })
+        } else {
+          await api.plugins.activate(id)
+          api.ui.toast({ variant: "success", message: `Activated ${id}.` })
+        }
+      } catch (error) {
+        api.ui.toast({ variant: "error", message: error instanceof Error ? error.message : String(error) })
+      }
+      state = { cursor: Math.min(state.cursor, Math.max(0, installedItems(api).length - 1)) }
+      continue
+    }
+  }
+}
+
+function showInstalledPluginsOnce(api: TuiPluginApi, state: InstalledPluginsState): Promise<InstalledPluginsAction | undefined> {
+  return new Promise((resolve) => {
+    let settled = false
+    const done = (value: InstalledPluginsAction | undefined, clear = true) => {
+      if (settled) return
+      settled = true
+      resolve(value)
+      if (clear) api.ui.dialog.clear()
+    }
+    api.ui.dialog.replace(() => <InstalledPluginsDialog api={api} initialState={state} onDone={done} />, () => done(undefined, false))
+  })
+}
+
+function InstalledPluginsDialog(props: { api: TuiPluginApi; initialState: InstalledPluginsState; onDone: (value: InstalledPluginsAction | undefined) => void }) {
+  const api = props.api
+  const theme = () => api.theme.current
+  useBrowserDialogSize(api)
+  useHidePromptCursor(api)
+  const dimensions = useTerminalDimensions()
+  const [cursor, setCursor] = createSignal(props.initialState.cursor)
+  const items = createMemo(() => installedItems(api))
+  const current = createMemo(() => items()[Math.min(cursor(), Math.max(0, items().length - 1))])
+  const listHeight = createMemo(() => cappedHeight(items().length, wizardMaxRows(api, dimensions().height, 12, 8), 8))
+  const nameWidth = createMemo(() => browserDialogSize(api) === "xlarge" ? 40 : browserDialogSize(api) === "large" ? 32 : 24)
+  const popMode = api.mode.push(MODE)
+  let scroll: ScrollBoxRenderable | undefined
+  const snapshot = (): InstalledPluginsState => ({ cursor: Math.min(cursor(), Math.max(0, items().length - 1)) })
+  const move = (delta: number) => setCursor((value) => {
+    const next = Math.max(0, Math.min(items().length - 1, value + delta))
+    scroll?.scrollTo(Math.max(0, next - 2))
+    return next
+  })
+  const inspect = () => {
+    const item = current()
+    if (!item) return
+    props.onDone({ action: "inspect", state: snapshot(), item })
+  }
+  const toggle = () => {
+    const item = current()
+    if (!item) return
+    props.onDone({ action: "toggle", state: snapshot(), item })
+  }
+  const commandPrefix = `souk.installed.${Math.random().toString(36).slice(2)}`
+  const unregister = api.keymap.registerLayer({
+    priority: 10000,
+    commands: [
+      { name: `${commandPrefix}.up`, title: "Previous plugin", run: (ctx: KeyContext) => { blockKey(ctx); move(-1) } },
+      { name: `${commandPrefix}.down`, title: "Next plugin", run: (ctx: KeyContext) => { blockKey(ctx); move(1) } },
+      { name: `${commandPrefix}.toggle`, title: "Toggle plugin", run: (ctx: KeyContext) => { blockKey(ctx); toggle() } },
+      { name: `${commandPrefix}.inspect`, title: "Inspect plugin", run: (ctx: KeyContext) => { blockKey(ctx); inspect() } },
+      { name: `${commandPrefix}.refresh`, title: "Refresh plugins", run: (ctx: KeyContext) => { blockKey(ctx); props.onDone({ action: "refresh", state: snapshot() }) } },
+      { name: `${commandPrefix}.back`, title: "Back", run: (ctx: KeyContext) => { blockKey(ctx); props.onDone({ action: "back", state: snapshot() }) } },
+      { name: `${commandPrefix}.shield`, title: "Block background input", run: blockKey },
+    ],
+    bindings: [
+      { key: "up", cmd: `${commandPrefix}.up`, desc: "Previous plugin" },
+      { key: "ctrl+p", cmd: `${commandPrefix}.up`, desc: "Previous plugin" },
+      { key: "down", cmd: `${commandPrefix}.down`, desc: "Next plugin" },
+      { key: "ctrl+n", cmd: `${commandPrefix}.down`, desc: "Next plugin" },
+      { key: "enter", cmd: `${commandPrefix}.toggle`, desc: "Toggle plugin" },
+      { key: "i", cmd: `${commandPrefix}.inspect`, desc: "Inspect plugin" },
+      { key: "r", cmd: `${commandPrefix}.refresh`, desc: "Refresh plugins" },
+      { key: "escape", cmd: `${commandPrefix}.back`, desc: "Back" },
+      ...shieldBindings(`${commandPrefix}.shield`, ["i", "r"]),
+    ],
+  } as any)
+  onCleanup(() => { unregister(); popMode() })
+
+  return (
+    <box flexDirection="column" width="100%" paddingLeft={2} paddingRight={2} paddingTop={1} paddingBottom={1}>
+      <box flexDirection="row" justifyContent="space-between" width="100%" marginBottom={1}>
+        <text fg={theme().accent}><b>Installed Plugins</b></text>
+        <KeyHints api={api} hints={[{ key: "enter", label: "toggle" }, { key: "i", label: "inspect" }, { key: "r", label: "refresh" }, { key: "esc", label: "back" }]} />
+      </box>
+      <box flexDirection="row" gap={2} marginBottom={1}>
+        <text fg={theme().textMuted}>{items().length} plugin(s)</text>
+        <text fg={theme().success}>{items().filter((item) => item.installed?.active).length} active</text>
+        <text fg={theme().textMuted}>no batch install or Forge here</text>
+      </box>
+      <box flexDirection="row" width="100%" gap={1} paddingLeft={1} paddingRight={1} marginBottom={0}>
+        <text width={9} fg={theme().textMuted}>state</text>
+        <text width={9} fg={theme().textMuted}>source</text>
+        <text width={nameWidth()} fg={theme().textMuted}>name</text>
+        <text flexGrow={1} fg={theme().textMuted}>description</text>
+      </box>
+      <scrollbox maxHeight={listHeight()} ref={(element: ScrollBoxRenderable) => (scroll = element)}>
+        <box flexDirection="column" gap={0}>
+          <For each={items()}>
+            {(item, index) => {
+              const active = createMemo(() => cursor() === index())
+              const enabled = createMemo(() => item.installed?.active ?? false)
+              const protectedPlugin = createMemo(() => item.installed?.id === "opencode-souk")
+              const fg = createMemo(() => active() ? theme().background : enabled() ? theme().success : protectedPlugin() ? theme().warning : theme().textMuted)
+              return (
+                <box
+                  flexDirection="row"
+                  width="100%"
+                  gap={1}
+                  paddingLeft={1}
+                  paddingRight={1}
+                  backgroundColor={active() ? theme().primary : theme().backgroundPanel}
+                  onMouseOver={() => setCursor(index())}
+                  onMouseUp={toggle}
+                >
+                  <text width={9} fg={fg()} wrapMode="none" overflow="hidden">{enabled() ? "active" : "inactive"}</text>
+                  <text width={9} fg={fg()} wrapMode="none" overflow="hidden">{singleLine(item.sourceType)}</text>
+                  <text width={nameWidth()} fg={fg()} wrapMode="none" overflow="hidden"><b>{singleLine(item.name, item.id)}</b></text>
+                  <text flexGrow={1} fg={active() ? theme().background : theme().textMuted} wrapMode="none" overflow="hidden">{singleLine(item.description, "No description.")}</text>
+                </box>
+              )
+            }}
+          </For>
+        </box>
+      </scrollbox>
+      <box marginTop={1}>
+        <text fg={theme().textMuted}>Installed plugins are managed separately from marketplace browsing. Enter toggles the highlighted plugin.</text>
+      </box>
+    </box>
+  )
+}
+
+async function installMenu(api: TuiPluginApi, config: SidecarConfig, items: SoukItem[]) {
+  const scope = await askScope(api)
+  if (!scope) return
+  const options: WizardSelectOption<string>[] = [
+    { title: "Safe install", value: "safe", description: "Use deterministic native installer where Souk can verify one", help: installActionHelp("safe", config, items, scope) },
+    { title: "Forge with Kāf", value: "forge", description: config.forge.enabled ? "Open an LLM-assisted Kāf session for all selected items" : "Experimental Forge mode is disabled", help: installActionHelp("forge", config, items, scope) },
+    { title: "Preview", value: "preview", description: "Show planned native writes/actions", help: installActionHelp("preview", config, items, scope) },
+    { title: "Scope", value: "scope", description: `Current: ${scopeLabel(scope)}`, help: installActionHelp("scope", config, items, scope) },
+    { title: "Cancel", value: "cancel", description: "Return to Souk", help: "Return to the previous Souk screen without installing, previewing, opening Forge, or changing scope." },
+  ]
+  const action = await showMenu(api, { title: `${items.length} selected item(s)`, options })
+  if (!action || action === "cancel") return
+  if (action === "scope") return installMenu(api, config, items)
+  if (action === "preview") {
+    const preview = await previewNativeInstall(items, scope, config.install)
+    await showInfo(api, { title: "Native Install Preview", message: previewText(preview.summary, preview.warnings) })
+    return installMenu(api, config, items)
+  }
+  if (action === "safe") {
+    const preview = await previewNativeInstall(items, scope, config.install)
+    const ok = await showConfirm(api, {
+      title: "Safe install?",
+      message: previewText(preview.summary, preview.warnings),
+    })
+    if (!ok) return
+    const result = await nativeInstall(api, items, scope, { confirm: (title, message) => showConfirm(api, { title, message }) }, config.install)
+    await showInfo(api, { title: "Native Install Result", message: [...result.installed, ...result.failed].join("\n") || "Nothing changed." })
+    return
+  }
+  if (action === "forge") {
+    if (!config.forge.enabled) {
+      const enable = await showConfirm(api, { title: "Enable Forge?", message: "Forge is experimental. Kāf can make mistakes, but starts in plan mode and must ask before action mode. Enable Forge now?" })
+      if (!enable) return
+      config.forge.enabled = true
+      await saveSidecarWithToast(api, config)
+    }
+    const ok = await showConfirm(api, {
+      title: "Open Forge with Kāf?",
+      message: forgeConfirmText(items, scope),
+    })
+    if (!ok) return
+    try {
+      const sessionID = await openForge(api, config, items, scope)
+      api.ui.toast({ variant: "success", message: `Opened Souk Forge session ${sessionID}` })
+    } catch (error) {
+      api.ui.toast({ variant: "error", message: error instanceof Error ? error.message : String(error) })
+    }
+  }
+}
+
+function installActionHelp(action: "safe" | "forge" | "preview" | "scope", config: SidecarConfig, items: SoukItem[], scope: ScopeChoice) {
+  const counts = new Map<string, number>()
+  for (const item of items) counts.set(item.confidence, (counts.get(item.confidence) ?? 0) + 1)
+  const summary = [`Selected items: ${items.length}`, `Scope: ${scopeLabel(scope)}`, ...Array.from(counts.entries()).map(([confidence, count]) => `${confidence}: ${count}`)]
+  if (action === "safe") return [
+    "Safe Install",
+    "Runs Souk's deterministic native installer for selected items.",
+    "",
+    ...summary,
+    "",
+    "What Souk may write",
+    "Plugins install through OpenCode's plugin API. MCPs patch OpenCode config and may optionally connect/auth at runtime. Agents, commands, themes, and skills write conventional OpenCode files/config when metadata is sufficient.",
+    "",
+    "Safety behavior",
+    "Souk previews planned writes, creates a pre-install backup snapshot before supported native installs, preserves JSONC comments, uses atomic writes, and refuses conflicting overwrites. If an install path cannot be proven, Souk does not guess.",
+  ].join("\n")
+  if (action === "forge") return [
+    "Forge With Kāf",
+    config.forge.enabled ? "Opens a dedicated Kāf session for the selected items." : "Forge is currently disabled. Selecting this can ask whether to enable it first.",
+    "",
+    ...summary,
+    "",
+    "Plan/action gate",
+    "Kāf starts in a read-only planning agent with MCP research allowed. It must analyze security and ask yes/no before switching to the write-capable action agent.",
+    "",
+    "Security review",
+    "Kāf must review source provenance, package risk, config writes, permissions, shell commands, OAuth/token handling, backups, and any installation instructions. Kāf should use manual install plans when native tools are uncertain or insufficient. The souk can make mistakes.",
+  ].join("\n")
+  if (action === "preview") return [
+    "Preview",
+    "Shows Souk's deterministic native install plan before writing anything.",
+    "",
+    ...summary,
+    "",
+    "Use this before Safe install when you want to inspect paths, config patches, unsupported items, and warnings without opening Kāf.",
+  ].join("\n")
+  return [
+    "Scope",
+    "Change where persistent install writes go for this install attempt.",
+    "",
+    `Current scope: ${scopeLabel(scope)}`,
+    "",
+    "Global scope writes to your global OpenCode config directory. Project scope writes under the selected project's .opencode directory/config.",
+    "Both native installs and Kāf Forge must ask for scope before any persistent write.",
+  ].join("\n")
+}
+
+async function askScope(api: TuiPluginApi): Promise<ScopeChoice | undefined> {
+  const picked = await showMenu(api, {
+    title: "Install scope",
+    options: [
+      { title: "Global", value: "global", description: "Install into the global OpenCode config", help: `Global scope\n\nWrites to ${defaultConfigDir()}. Use this for extensions you want available in every OpenCode project.\n\nSouk still previews writes and refuses conflicting overwrites before persistence.` },
+      { title: "Project", value: "project", description: "Install into a project .opencode config", help: "Project scope\n\nWrites under a selected project's .opencode directory/config. Use this for project-specific MCPs, commands, agents, themes, or skills.\n\nSouk asks for the project path before writing." },
+      { title: "Cancel", value: "cancel", description: "Return to Souk", help: "Return without selecting an install scope. No persistent write can happen without a scope." },
+    ],
+  })
+  if (!picked || picked === "cancel") return
+  if (picked === "global") return { kind: "global" }
+  const fallback = api.state.path.worktree && api.state.path.worktree !== "/" ? api.state.path.worktree : api.state.path.directory
+  const path = await showPrompt(api, { title: "Project path", placeholder: fallback, value: fallback })
+  if (!path) return
+  return { kind: "project", path }
+}
+
+function selectedItems(items: SoukItem[], selected: Set<string>) {
+  const chosen = items.filter((item) => selected.has(item.id))
+  return chosen
+}
+
+function itemInfo(item: SoukItem, config: SidecarConfig) {
+  return [
+    `${item.name}`,
+    "",
+    "Identity",
+    `Kind: ${item.kind}`,
+    `ID: ${item.id}`,
+    `Source: ${item.source}${item.sourceType ? ` (${item.sourceType})` : ""}`,
+    item.sources.length ? `All sources: ${item.sources.map((source) => `${source.source}${source.sourceType ? `/${source.sourceType}` : ""}`).join(", ")}` : undefined,
+    item.aliases.length ? `Aliases: ${item.aliases.join(", ")}` : undefined,
+    item.alternateKinds.length ? `Alternate kinds: ${item.alternateKinds.join(", ")}` : undefined,
+    `Confidence: ${item.confidence}`,
+    `Install hint: ${item.install?.spec ?? item.install?.type ?? "none"}`,
+    item.installed ? `Installed: ${item.installed.active ? "active" : "inactive"}, ${item.installed.enabled ? "enabled" : "disabled"}` : undefined,
+    item.repoUrl ? `Repo: ${item.repoUrl}` : undefined,
+    item.homepageUrl ? `Home: ${item.homepageUrl}` : undefined,
+    item.tags.length ? `Tags: ${item.tags.join(", ")}` : undefined,
+    "",
+    item.sources.length ? "Source records:" : undefined,
+    ...item.sources.flatMap((source) => [
+      `- ${source.source}${source.sourceType ? ` (${source.sourceType})` : ""}: ${source.name ?? item.name}`,
+      source.repoUrl ? `  repo: ${source.repoUrl}` : undefined,
+      source.homepageUrl ? `  home: ${source.homepageUrl}` : undefined,
+      source.confidence ? `  confidence: ${source.confidence}${source.kind ? `, kind: ${source.kind}` : ""}` : undefined,
+      source.install?.reason ? `  install: ${source.install.reason}${source.install.spec ? ` (${source.install.spec})` : ""}` : undefined,
+    ].filter((line): line is string => typeof line === "string")),
+    item.sources.length ? "" : undefined,
+    "Description",
+    singleLine(item.description, "No description."),
+    "",
+    "Security appraisal:",
+    ...securityNotes(item),
+    "",
+    "Warnings:",
+    ...(item.warnings.length ? item.warnings.map((warning) => `- ${warning}`) : ["- No source-specific warnings."]),
+    "",
+    item.confidence === "verified" ? "Charted item. Native installer may be available." : "This path is not fully charted. The souk can make mistakes; review before writing.",
+    "",
+    "Browser controls",
+    "Enter toggles selection. Space opens the install menu. i closes this appraisal and returns to the browser. s opens Kāf settings from the browser. Esc returns from the browser to the main menu.",
+    "",
+    `Forge: ${config.forge.enabled ? "enabled" : "disabled"}`,
+    "Press Space to choose Safe install or Forge with Kāf for selected items.",
+  ].filter((line): line is string => typeof line === "string").join("\n")
+}
+
+function installedPluginInfo(item: SoukItem) {
+  const installed = item.installed
+  return [
+    item.name,
+    "",
+    "Installed Plugin",
+    `ID: ${installed?.id ?? item.id}`,
+    `Source: ${item.sourceType ?? "unknown"}`,
+    `Spec: ${installed?.spec ?? "unknown"}`,
+    `State: ${installed?.active ? "active" : "inactive"}`,
+    `Enabled: ${installed?.enabled ? "yes" : "no"}`,
+    item.tags.length ? `Tags: ${item.tags.join(", ")}` : undefined,
+    "",
+    "Description",
+    singleLine(item.description, "No description."),
+    "",
+    "Controls",
+    "Enter toggles this installed plugin on or off. r refreshes the installed plugin list. Esc returns to the main menu.",
+    "",
+    "What toggling does",
+    "Souk calls OpenCode's runtime plugin activate/deactivate API. This view does not install anything, does not batch-select, does not open Forge, and does not write marketplace cache entries.",
+    "",
+    installed?.id === "opencode-souk" ? "Protected: Souk will not deactivate itself from inside Souk." : undefined,
+    installed?.id === INTERNAL_PLUGIN_MANAGER ? "Note: Souk deactivates the built-in plugin manager on startup so the Souk command can replace it cleanly." : undefined,
+  ].filter((line): line is string => typeof line === "string").join("\n")
+}
+
+function securityNotes(item: RegistryItem) {
+  const notes = [
+    `- Provenance should be checked from source ${item.source}${item.repoUrl ? ` and repo ${item.repoUrl}` : ""}.`,
+    `- Install confidence is ${item.confidence}.`,
+  ]
+  if (item.installationMarkdown && /curl\s+[^|]+\|\s*(?:sh|bash)|sudo\s+|rm\s+-rf/i.test(item.installationMarkdown)) notes.push("- Installation text contains high-risk shell patterns.")
+  if (item.kind === "mcp") notes.push("- MCP servers can expose tools and may require tokens, headers, OAuth, or local command execution.")
+  if (item.kind === "plugin") notes.push("- Plugins can register hooks and alter OpenCode behavior at runtime.")
+  if (["agent", "command", "skill"].includes(item.kind)) notes.push("- Prompt/config extensions can alter model behavior and should be reviewed for hidden instructions.")
+  if (item.confidence !== "verified") notes.push("- Not fully verified. Use preview or Forge and review all proposed writes.")
+  return notes
+}
+
+function previewText(summary: string, warnings: string[]) {
+  return [summary, "", "Warnings:", ...(warnings.length ? warnings.map((warning) => `- ${warning}`) : ["- No native preview warnings."]), "", "The souk can make mistakes. Review before writing."].join("\n")
+}
+
+function forgeConfirmText(items: RegistryItem[], scope: ScopeChoice) {
+  const counts = new Map<string, number>()
+  for (const item of items) counts.set(item.confidence, (counts.get(item.confidence) ?? 0) + 1)
+  return [
+    `Open Forge with Kāf for ${items.length} selected item(s)?`,
+    "",
+    `Scope: ${scopeLabel(scope)}`,
+    ...Array.from(counts.entries()).map(([confidence, count]) => `${confidence}: ${count}`),
+    "",
+    "Kāf will inspect metadata, installation instructions, and security risks before proposing changes.",
+    "The souk can make mistakes. Nothing should be written until you approve action mode.",
+  ].join("\n")
+}
+
+async function saveSidecarWithToast(api: TuiPluginApi, config: SidecarConfig, options: { backup?: boolean; restart?: boolean } = {}) {
+  try {
+    const result = saveSidecar(config, defaultSidecarPath(), { backup: options.backup })
+    if (!result.changed) {
+      api.ui.toast({ variant: "info", message: "No Souk settings changed." })
+      return result
+    }
+    api.ui.toast({ variant: "success", message: options.restart === false ? "Souk settings saved." : "Souk settings saved. Restart OpenCode for Kāf agent config changes to fully apply." })
+    return result
+  } catch (error) {
+    await showInfo(api, { title: "Save failed", message: error instanceof Error ? error.message : String(error) })
+    return { changed: false }
+  }
+}
+
+async function forgeSettings(api: TuiPluginApi, config: SidecarConfig): Promise<SidecarConfig | undefined> {
+  let next = structuredClone(config)
+  while (true) {
+    const action = await showMenu(api, {
+      title: "Souk Settings",
+      options: [
+        { title: `Forge: ${next.forge.enabled ? "enabled" : "disabled"}`, value: "toggle", description: "Experimental Kāf-assisted installs", help: forgeSettingHelp("toggle", next) },
+        { title: `Kāf model: ${next.forge.agent.model}`, value: "model", description: "Provider/model reference", help: forgeSettingHelp("model", next) },
+        { title: `Kāf variant: ${next.forge.agent.variant ?? "default"}`, value: "variant", description: "Provider model variant", help: forgeSettingHelp("variant", next) },
+        { title: `Personality: ${next.forge.agent.personality}`, value: "personality", description: personalityDescription(next.forge.agent.personality), help: forgeSettingHelp("personality", next) },
+        { title: `Debug: ${next.debug ? "on" : "off"}`, value: "debug", description: "Write Souk debug log entries", help: forgeSettingHelp("debug", next) },
+        { title: "Back", value: "back", description: "Return to Souk", help: "Return to the previous Souk screen. Settings changed in this menu are saved when you leave settings." },
+      ],
+    })
+    if (!action || action === "back") return next
+    if (action === "toggle") next = { ...next, forge: { ...next.forge, enabled: !next.forge.enabled } }
+    if (action === "model") {
+      const value = await pickModel(api, next.forge.agent.model)
+      if (value && value !== next.forge.agent.model) next = { ...next, forge: { ...next.forge, agent: { ...next.forge.agent, model: value, variant: undefined } } }
+    }
+    if (action === "variant") {
+      const value = await pickModelVariant(api, next.forge.agent.model, next.forge.agent.variant)
+      if (value !== undefined) next = { ...next, forge: { ...next.forge, agent: { ...next.forge.agent, variant: value || undefined } } }
+    }
+    if (action === "personality") {
+      const value = await showMenu(api, {
+        title: "Kāf personality",
+        options: PERSONALITY_PRESETS.map((preset) => ({ title: preset, value: preset, description: personalityDescription(preset), help: personalityDescription(preset) })),
+      })
+      if (value) next = { ...next, forge: { ...next.forge, agent: { ...next.forge.agent, personality: value } } }
+    }
+    if (action === "debug") next = { ...next, debug: !next.debug }
+  }
+}
+
+function forgeSettingHelp(action: "toggle" | "model" | "variant" | "personality" | "debug", config: SidecarConfig) {
+  if (action === "toggle") return [
+    "Forge",
+    `Current state: ${config.forge.enabled ? "enabled" : "disabled"}.`,
+    "",
+    "Forge makes Kāf available from the install menu for every selected item, including verified deterministic installs.",
+    "Kāf starts in plan mode, analyzes security, and must ask yes/no before action mode.",
+    "",
+    "Forge is experimental. The souk can make mistakes.",
+  ].join("\n")
+  if (action === "model") return [
+    "Kāf Model",
+    `Current model: ${config.forge.agent.model}.`,
+    "",
+    "Pick the provider/model Kāf uses for Forge sessions. The picker is searchable and grouped by provider using OpenCode's provider catalog.",
+    "Choose Custom model only when you know the provider/model ID is valid but it is not listed.",
+  ].join("\n")
+  if (action === "variant") return [
+    "Kāf Variant",
+    `Current variant: ${config.forge.agent.variant ?? "provider default"}.`,
+    "",
+    "Optional provider-specific model variant. Known variants are shown when the selected model exposes them; otherwise you can type one manually.",
+    "Leave this unset unless the provider documents a variant you want Kāf to use.",
+  ].join("\n")
+  if (action === "personality") return [
+    "Kāf Personality",
+    `Current preset: ${config.forge.agent.personality}.`,
+    "",
+    personalityDescription(config.forge.agent.personality),
+    "",
+    "Personality affects flavor and presentation only. It must not obscure risk. Warnings drop personality and use direct language.",
+  ].join("\n")
+  return [
+    "Debug Logging",
+    `Current state: ${config.debug ? "on" : "off"}.`,
+    "",
+    `Debug log path: ${debugLogPath(defaultConfigDir())}`,
+    "Debug writes are best-effort and never fatal. Use this when diagnosing source refreshes, native installs, backup behavior, or Forge session creation.",
+  ].join("\n")
+}
+
+async function pickModel(api: TuiPluginApi, current: string) {
+  const picked = await showSelect(api.ui, { title: "Kāf model", options: modelOptions(api), current })
+  if (!picked) return undefined
+  if (picked === "__custom__") return showPrompt(api, { title: "Custom model ID", placeholder: "provider/model-id", value: current })
+  return picked
+}
+
+async function pickModelVariant(api: TuiPluginApi, model: string, current?: string) {
+  const picked = await showSelect(api.ui, { title: "Kāf model variant", options: modelVariantOptions(api, model), current: current ?? "__remove__" })
+  if (!picked) return undefined
+  if (picked === "__remove__") return ""
+  if (picked === "__custom__") return showPrompt(api, { title: "Custom model variant", placeholder: "variant-id", value: current })
+  return picked
+}
+
+function modelOptions(api: TuiPluginApi): WizardSelectOption<string>[] {
+  const opts: WizardSelectOption<string>[] = []
+  const seen = new Set<string>()
+  for (const provider of api.state.provider ?? []) {
+    for (const model of Object.values(provider.models ?? {})) {
+      const ref = `${provider.id}/${model.id}`
+      if (seen.has(ref)) continue
+      seen.add(ref)
+      opts.push({ title: model.name, value: ref, description: `via ${provider.name}`, category: provider.name, help: `Provider: ${provider.name}\nModel ID: ${ref}` })
+    }
+  }
+  opts.push({ title: "Custom model", value: "__custom__", description: "Type a provider/model ID manually", category: "Custom", help: "Use this when the provider/model is valid but not listed by the current provider catalog." })
+  return opts
+}
+
+function modelVariantOptions(api: TuiPluginApi, modelRef: string): WizardSelectOption<string>[] {
+  const opts: WizardSelectOption<string>[] = [{ title: "Default", value: "__remove__", description: "Remove the provider variant override", category: "Default" }]
+  const slash = modelRef.indexOf("/")
+  const providerID = slash === -1 ? "" : modelRef.slice(0, slash)
+  const modelID = slash === -1 ? "" : modelRef.slice(slash + 1)
+  const provider = api.state.provider?.find((item) => item.id === providerID)
+  const model = provider?.models?.[modelID]
+  if (provider && model) {
+    for (const variant of Object.keys(model.variants ?? {})) opts.push({ title: variant, value: variant, description: `${model.name} via ${provider.name}`, category: "Known variants" })
+  }
+  opts.push({ title: "Custom variant", value: "__custom__", description: provider && model ? "Type a provider-specific variant manually" : "No known variants; type one manually", category: "Custom" })
+  return opts
+}
+
+async function runDiagnostics(api: TuiPluginApi, config: SidecarConfig, cache: CacheFile, configParseError?: string) {
+  const diagnostics = diagnoseConfig(config, { providers: api.state.provider, cache, configParseError, pluginIDs: api.plugins.list().map((plugin) => plugin.id) })
+  await showInfo(api, { title: "Souk Diagnostics", message: diagnostics.map((item) => `${item.level.toUpperCase()}: ${item.message}`).join("\n") || "No diagnostics." })
+}
+
+async function debugAdvancedMenu(api: TuiPluginApi, config: SidecarConfig): Promise<SidecarConfig> {
+  let current = structuredClone(config)
+  while (true) {
+    const action = await showMenu(api, {
+      title: "Debug & advanced",
+      options: [
+        { title: `Debug mode: ${current.debug ? "on" : "off"}`, value: "debug", description: "Toggle debug log writes", help: advancedHelp("debug") },
+        { title: "View debug log", value: "view-log", description: "Show recent souk.debug.log entries", help: advancedHelp("view-log") },
+        { title: "Clear debug log", value: "clear-log", description: "Empty souk.debug.log", help: advancedHelp("clear-log") },
+        { title: "Create full config backup", value: "backup", description: "Snapshot souk.jsonc", help: advancedHelp("backup") },
+        { title: "Config backups", value: "backups", description: "Browse, preview, restore, or delete backups", help: advancedHelp("backups") },
+        { title: `Wizard UI width: ${wizardDialogSize(api)}`, value: "ui-size", description: "Cycle medium, large, xlarge", help: advancedHelp("ui-size") },
+        { title: `Wizard UI height: ${wizardDialogHeightPercent(api)}%`, value: "ui-height", description: "Adjust max height with slider or preset marks", help: advancedHelp("ui-height") },
+        { title: `Item browser width: ${browserDialogSize(api)}`, value: "browser-size", description: "Cycle browser medium, large, xlarge", help: advancedHelp("browser-size") },
+        { title: "Back", value: "back", description: "Return to main menu", help: "Return to the main Souk menu. Debug & advanced actions stay in this menu until you choose Back." },
+      ],
+    })
+    if (!action || action === "back") return current
+    if (action === "debug") {
+      current = { ...current, debug: !current.debug }
+      await saveSidecarWithToast(api, current, { backup: false, restart: false })
+      continue
+    }
+    if (action === "view-log") {
+      await viewDebugLog(api)
+      continue
+    }
+    if (action === "clear-log") {
+      const ok = await showConfirm(api, { title: "Clear debug log?", message: `Empty ${debugLogPath(defaultConfigDir())}?` })
+      if (!ok) continue
+      mkdirSync(defaultConfigDir(), { recursive: true })
+      writeFileSync(debugLogPath(defaultConfigDir()), "", "utf8")
+      api.ui.toast({ variant: "success", message: "Souk debug log cleared." })
+      continue
+    }
+    if (action === "backup") {
+      createFullBackup(current, { label: "Manual backup" })
+      api.ui.toast({ variant: "success", message: "Full Souk config backup created." })
+      continue
+    }
+    if (action === "backups") {
+      current = await configBackupsMenu(api, current)
+      continue
+    }
+    if (action === "ui-size") {
+      const width = nextWizardDialogSize(api)
+      current = { ...current, ui: { ...current.ui, width } }
+      setWizardDialogSize(api, width)
+      await saveSidecarWithToast(api, current, { backup: false, restart: false })
+      continue
+    }
+    if (action === "ui-height") {
+      const value = await showHeightSlider(api, effectiveUiHeightPercent(current.ui), "Souk UI height")
+      if (value !== undefined) {
+        const preset = HEIGHT_PRESETS.find((item) => item.value === value)
+        current = { ...current, ui: { ...current.ui, height_percent: value, height: preset?.label ?? current.ui.height } }
+        setWizardDialogHeightPercent(api, value)
+        if (preset) setWizardDialogHeight(api, preset.label)
+        await saveSidecarWithToast(api, current, { backup: false, restart: false })
+      }
+      continue
+    }
+    if (action === "browser-size") {
+      const width = nextBrowserDialogSize(api)
+      current = { ...current, ui: { ...current.ui, browser: { ...current.ui.browser, width } } }
+      setBrowserDialogSize(api, width)
+      await saveSidecarWithToast(api, current, { backup: false, restart: false })
+      continue
+    }
+  }
+}
+
+function advancedHelp(action: "debug" | "view-log" | "clear-log" | "backup" | "backups" | "ui-size" | "ui-height" | "browser-size") {
+  if (action === "debug") return [`Debug Mode`, `Path: ${debugLogPath(defaultConfigDir())}`, "", "Toggles best-effort debug logging for Souk internals. Debug writes are never fatal and should not block normal UI behavior.", "This setting is hot and does not need an OpenCode restart."].join("\n")
+  if (action === "view-log") return [`View Debug Log`, `Path: ${debugLogPath(defaultConfigDir())}`, "", "Shows recent debug log entries in a scrollable info window. This is read-only and returns to Debug & advanced when closed."].join("\n")
+  if (action === "clear-log") return [`Clear Debug Log`, `Path: ${debugLogPath(defaultConfigDir())}`, "", "Asks for confirmation, then empties the debug log file. This does not change Souk config or backups."].join("\n")
+  if (action === "backup") return [`Create Full Config Backup`, `Journal: ${backupJournalPath(defaultConfigDir())}`, "", "Creates a full snapshot of the current Souk sidecar config. Useful before changing advanced settings or restoring older config."].join("\n")
+  if (action === "backups") return [`Config Backups`, `Journal: ${backupJournalPath(defaultConfigDir())}`, "", "Browse patch restore points and full snapshots. Patch restores validate their hash chain. Full restores reset the patch chain after writing the snapshot."].join("\n")
+  if (action === "ui-size") return ["Wizard UI Width", "Cycles the dialog width between medium, large, and xlarge.", "", "This affects Souk menus, info windows, and custom sliders immediately. It is saved without creating a backup entry."].join("\n")
+  if (action === "ui-height") return ["Wizard UI Height", "Opens the height slider with compact, normal, tall, and max preset marks.", "", "This controls the maximum height used by Souk menus, info windows, custom sliders, and the item browser. It is saved without creating a backup entry."].join("\n")
+  return ["Item Browser Width", "Cycles only the item browser width between medium, large, and xlarge.", "", "Use this when the marketplace table needs more room than the rest of Souk's menus. Other menus and info windows keep using Wizard UI width."].join("\n")
+}
+
+async function showHeightSlider(api: TuiPluginApi, initial: number, title: string): Promise<number | undefined> {
+  let current = initial
+  while (true) {
+    const choice = await showHeightSliderOnce(api, current, title)
+    if (!choice) return undefined
+    current = choice.value
+    if (choice.action === "save") return current
+    const input = await showPrompt(api, { title: `${title} percent`, placeholder: `${HEIGHT_PERCENT_MIN}-${HEIGHT_PERCENT_MAX}`, value: String(current) })
+    if (input === undefined) continue
+    const value = Number(input)
+    if (!Number.isFinite(value)) {
+      api.ui.toast({ variant: "error", message: `Enter a number from ${HEIGHT_PERCENT_MIN} to ${HEIGHT_PERCENT_MAX}.` })
+      continue
+    }
+    current = clampHeightPercent(value)
+  }
+}
+
+function showHeightSliderOnce(api: TuiPluginApi, current: number, title: string): Promise<HeightSliderChoice | undefined> {
+  return new Promise((resolve) => {
+    let settled = false
+    const done = (value: HeightSliderChoice | undefined, clear = true) => {
+      if (settled) return
+      settled = true
+      resolve(value)
+      if (clear) api.ui.dialog.clear()
+    }
+    api.ui.dialog.replace(() => <HeightSliderDialog api={api} title={title} current={current} onDone={done} />, () => done(undefined, false))
+  })
+}
+
+function showSelect<Value>(
+  ui: UI,
+  props: {
+    title: string
+    options: TuiDialogSelectOption<Value>[]
+    placeholder?: string
+    current?: Value
+  },
+): Promise<Value | undefined> {
+  return new Promise((resolve) => {
+    let settled = false
+    const done = (value: Value | undefined) => {
+      if (settled) return
+      settled = true
+      resolve(value)
+    }
+    ui.dialog.replace(() =>
+      ui.DialogSelect<Value>({
+        title: props.title,
+        placeholder: props.placeholder ?? "Type to filter...",
+        options: props.options,
+        current: props.current,
+        flat: props.options.length < 15,
+        onSelect: (opt) => {
+          done(opt.value)
+          ui.dialog.clear()
+        },
+      }),
+      () => done(undefined),
+    )
+  })
+}
+
+function HeightSliderDialog(props: { api: TuiPluginApi; title: string; current: number; onDone: (value: HeightSliderChoice | undefined) => void }) {
+  const theme = () => props.api.theme.current
+  useWizardDialogSize(props.api)
+  useHidePromptCursor(props.api)
+  const [value, setValue] = createSignal(clampHeightPercent(props.current))
+  const popMode = props.api.mode.push(MODE)
+  const commandPrefix = `souk.height.${Math.random().toString(36).slice(2)}`
+  const setPreset = (height: DialogHeight) => setValue(heightPresetPercent(height))
+  const move = (delta: number) => setValue((current) => clampHeightPercent(current + delta))
+  const sliderWidth = createMemo(() => wizardDialogSize(props.api) === "xlarge" ? 64 : wizardDialogSize(props.api) === "large" ? 48 : 34)
+  const sliderCells = createMemo(() => {
+    const width = sliderWidth()
+    const selected = Math.round(((value() - HEIGHT_PERCENT_MIN) / (HEIGHT_PERCENT_MAX - HEIGHT_PERCENT_MIN)) * (width - 1))
+    const presetPositions = new Map(HEIGHT_PRESETS.map((preset) => [Math.round(((preset.value - HEIGHT_PERCENT_MIN) / (HEIGHT_PERCENT_MAX - HEIGHT_PERCENT_MIN)) * (width - 1)), preset.label]))
+    return Array.from({ length: width }, (_, index) => {
+      const current = index === selected
+      const preset = presetPositions.get(index)
+      return {
+        char: current ? "●" : preset ? "│" : index < selected ? "━" : "─",
+        color: current ? theme().primary : preset ? theme().accent : index < selected ? theme().success : theme().textMuted,
+      }
+    })
+  })
+  const unregister = props.api.keymap.registerLayer({
+    priority: 10000,
+    commands: [
+      { name: `${commandPrefix}.left`, title: "Lower height", run: (ctx: KeyContext) => { blockKey(ctx); move(-1) } },
+      { name: `${commandPrefix}.right`, title: "Raise height", run: (ctx: KeyContext) => { blockKey(ctx); move(1) } },
+      { name: `${commandPrefix}.down`, title: "Lower height faster", run: (ctx: KeyContext) => { blockKey(ctx); move(-5) } },
+      { name: `${commandPrefix}.up`, title: "Raise height faster", run: (ctx: KeyContext) => { blockKey(ctx); move(5) } },
+      { name: `${commandPrefix}.compact`, title: "Compact preset", run: (ctx: KeyContext) => { blockKey(ctx); setPreset("compact") } },
+      { name: `${commandPrefix}.normal`, title: "Normal preset", run: (ctx: KeyContext) => { blockKey(ctx); setPreset("normal") } },
+      { name: `${commandPrefix}.tall`, title: "Tall preset", run: (ctx: KeyContext) => { blockKey(ctx); setPreset("tall") } },
+      { name: `${commandPrefix}.max`, title: "Max preset", run: (ctx: KeyContext) => { blockKey(ctx); setPreset("max") } },
+      { name: `${commandPrefix}.custom`, title: "Custom percent", run: (ctx: KeyContext) => { blockKey(ctx); props.onDone({ action: "custom", value: value() }) } },
+      { name: `${commandPrefix}.save`, title: "Save height", run: (ctx: KeyContext) => { blockKey(ctx); props.onDone({ action: "save", value: value() }) } },
+      { name: `${commandPrefix}.back`, title: "Back", run: (ctx: KeyContext) => { blockKey(ctx); props.onDone(undefined) } },
+      { name: `${commandPrefix}.shield`, title: "Block background input", run: blockKey },
+    ],
+    bindings: [
+      { key: "left", cmd: `${commandPrefix}.left`, desc: "Lower height" },
+      { key: "right", cmd: `${commandPrefix}.right`, desc: "Raise height" },
+      { key: "down", cmd: `${commandPrefix}.down`, desc: "Lower height faster" },
+      { key: "up", cmd: `${commandPrefix}.up`, desc: "Raise height faster" },
+      { key: "1", cmd: `${commandPrefix}.compact`, desc: "Compact preset" },
+      { key: "2", cmd: `${commandPrefix}.normal`, desc: "Normal preset" },
+      { key: "3", cmd: `${commandPrefix}.tall`, desc: "Tall preset" },
+      { key: "4", cmd: `${commandPrefix}.max`, desc: "Max preset" },
+      { key: "c", cmd: `${commandPrefix}.custom`, desc: "Custom percent" },
+      { key: "enter", cmd: `${commandPrefix}.save`, desc: "Save height" },
+      { key: "escape", cmd: `${commandPrefix}.back`, desc: "Back" },
+      ...shieldBindings(`${commandPrefix}.shield`, ["1", "2", "3", "4", "c"]),
+    ],
+  } as any)
+  onCleanup(() => { unregister(); popMode() })
+
+  return (
+    <box flexDirection="column" width="100%" paddingLeft={2} paddingRight={2} paddingTop={1} paddingBottom={1}>
+      <box flexDirection="row" justifyContent="space-between" width="100%" marginBottom={1}>
+        <text fg={theme().accent}><b>{props.title}</b></text>
+        <KeyHints api={props.api} hints={[{ key: "esc", label: "back" }]} />
+      </box>
+      <box flexDirection="row" justifyContent="space-between" width="100%" marginBottom={1}>
+        <text fg={theme().textMuted}>Current</text>
+        <text fg={theme().primary}><b>{value()}%</b></text>
+      </box>
+      <box flexDirection="row" width="100%" marginBottom={1}>
+        <text fg={theme().textMuted}>{HEIGHT_PERCENT_MIN}% </text>
+        <For each={sliderCells()}>{(cell) => <text fg={cell.color}>{cell.char}</text>}</For>
+        <text fg={theme().textMuted}> {HEIGHT_PERCENT_MAX}%</text>
+      </box>
+      <box flexDirection="column" gap={0} marginBottom={1}>
+        <For each={HEIGHT_PRESETS}>{(preset) => <text fg={value() === preset.value ? theme().primary : theme().textMuted}>{preset.key} {preset.label}: {preset.value}%</text>}</For>
+      </box>
+      <box flexDirection="column" gap={0} marginBottom={1}>
+        <KeyHints api={props.api} hints={[{ key: "left/right", label: "adjust 1%" }]} />
+        <KeyHints api={props.api} hints={[{ key: "up/down", label: "adjust 5%" }]} />
+        <KeyHints api={props.api} hints={[{ key: "c", label: "custom percent" }]} />
+      </box>
+      <box flexDirection="row" justifyContent="space-between" width="100%">
+        <KeyHints api={props.api} hints={[{ key: "enter", label: "save" }]} />
+        <box paddingLeft={3} paddingRight={3} backgroundColor={theme().primary} onMouseUp={() => props.onDone({ action: "save", value: value() })}>
+          <text fg={theme().background}><b>save</b></text>
+        </box>
+      </box>
+    </box>
+  )
+}
+
+async function viewDebugLog(api: TuiPluginApi) {
+  const file = debugLogPath(defaultConfigDir())
+  const text = existsSync(file) ? readFileSync(file, "utf8") : "No debug log found."
+  await showInfo(api, { title: "Souk Debug Log", message: text.split(/\r?\n/).slice(-80).join("\n") || "Debug log is empty." })
+}
+
+async function configBackupsMenu(api: TuiPluginApi, config: SidecarConfig): Promise<SidecarConfig> {
+  while (true) {
+    const journal = safeLoadBackupJournal()
+    const action = await showMenu(api, {
+      title: "Config backups",
+      options: [
+        { title: "Browse / restore backups", value: "browse", description: `${journal.patches.length} patch, ${journal.full.length} full`, help: "Preview and restore patch restore points or full snapshots. Patch restore validates the hash chain before writing." },
+        { title: "Create full backup", value: "create", description: "Snapshot current souk.jsonc" },
+        { title: "Delete full backups", value: "delete-full", description: `${journal.full.length} full backup(s)` },
+        { title: "Back", value: "back", description: "Return to Debug & advanced" },
+      ],
+    })
+    if (!action || action === "back") return config
+    if (action === "create") {
+      createFullBackup(config, { label: "Manual backup" })
+      api.ui.toast({ variant: "success", message: "Full Souk config backup created." })
+      continue
+    }
+    if (action === "browse") {
+      const restored = await browseConfigBackups(api, config)
+      if (restored !== config) return restored
+      continue
+    }
+    if (action === "delete-full") {
+      await deleteFullBackupsMenu(api)
+      continue
+    }
+  }
+}
+
+async function browseConfigBackups(api: TuiPluginApi, config: SidecarConfig): Promise<SidecarConfig> {
+  const journal = safeLoadBackupJournal()
+  const items = backupListItems(config, journal)
+  if (items.length === 0) {
+    await showInfo(api, { title: "Config backups", message: `No backups found.\n\nJournal: ${backupJournalPath(defaultConfigDir())}` })
+    return config
+  }
+  const picked = await showMenu(api, {
+    title: "Restore backup",
+    options: [...items.map((item) => ({ title: item.title, value: itemKey(item), description: item.description, danger: item.kind === "patch" && !item.valid, help: backupItemHelp(item) })), { title: "Back", value: "__back__", description: "Return to Config backups" }],
+  })
+  if (!picked || picked === "__back__") return config
+  const item = items.find((candidate) => itemKey(candidate) === picked)
+  if (!item) return config
+  const restored = item.kind === "patch" ? reconstructPatchBackup(item.index, config, journal) : { ok: true as const, config: item.entry.config }
+  if (!restored.ok) {
+    await showInfo(api, { title: "Backup chain invalid", message: restored.message })
+    return config
+  }
+  await showInfo(api, { title: item.title, message: backupPreview(item, restored.config) })
+  const ok = await showConfirm(api, { title: "Restore this backup?", message: "This writes souk.jsonc to the previewed state." })
+  if (!ok) return config
+  const hardBackup = await showConfirm(api, { title: "Create full backup first?", message: "Optional safety snapshot of the current config before restoring. Default is No." })
+  if (hardBackup) createFullBackup(config, { label: "Before restore" })
+  if (item.kind === "patch") {
+    const latest = safeLoadBackupJournal()
+    const result = reconstructPatchBackup(item.index, loadSidecar(defaultSidecarPath()), latest)
+    if (!result.ok) {
+      await showInfo(api, { title: "Restore failed", message: result.message })
+      return config
+    }
+    saveSidecar(result.config, defaultSidecarPath(), { backup: false, allowInvalidPrevious: true })
+    latest.patches = latest.patches.slice(result.consumed)
+    saveBackupJournal(latest)
+    api.ui.toast({ variant: "success", message: "Config restored; consumed patch backups were removed." })
+    return result.config
+  }
+  const latest = safeLoadBackupJournal()
+  saveSidecar(restored.config, defaultSidecarPath(), { backup: false, allowInvalidPrevious: true })
+  latest.patches = []
+  saveBackupJournal(latest)
+  api.ui.toast({ variant: "success", message: "Full backup restored; patch restore chain was reset." })
+  return restored.config
+}
+
+async function deleteFullBackupsMenu(api: TuiPluginApi) {
+  const journal = safeLoadBackupJournal()
+  if (journal.full.length === 0) {
+    await showInfo(api, { title: "Delete full backups", message: "No full backups found." })
+    return
+  }
+  const picked = await showMenu(api, {
+    title: "Delete full backup",
+    options: [
+      { title: "Delete all full backups", value: "__all__", description: `${journal.full.length} full backup(s)`, danger: true },
+      ...journal.full.map((entry) => ({ title: `Delete ${formatBackupTime(entry.timestamp)}`, value: entry.id, description: entry.label ?? entry.hash.slice(0, 8), danger: true })),
+      { title: "Back", value: "__back__", description: "Return to Config backups" },
+    ],
+  })
+  if (!picked || picked === "__back__") return
+  const ok = await showConfirm(api, { title: "Delete backup?", message: picked === "__all__" ? "Delete all full Souk config backups?" : "Delete this full Souk config backup?" })
+  if (!ok) return
+  if (picked === "__all__") deleteAllFullBackups()
+  else deleteFullBackup(picked)
+  api.ui.toast({ variant: "warning", message: "Full backup deleted." })
+}
+
+function safeLoadBackupJournal(): BackupJournal {
+  try {
+    return loadBackupJournal()
+  } catch {
+    return { version: 1, patch_limit: 50, patches: [], full: [] }
+  }
+}
+
+function backupListItems(config: SidecarConfig, journal: BackupJournal): BackupListItem[] {
+  return [
+    ...journal.patches.map((entry, index): BackupListItem => {
+      const restored = reconstructPatchBackup(index, config, journal)
+      return { kind: "patch", index, valid: restored.ok, title: `Patch ${index + 1} ${formatBackupTime(entry.timestamp)}`, description: restored.ok ? entry.changed_paths.slice(0, 3).join(", ") || "config change" : "invalid hash chain" }
+    }),
+    ...journal.full.map((entry): BackupListItem => ({ kind: "full", id: entry.id, title: `Full ${formatBackupTime(entry.timestamp)}`, description: entry.label ?? entry.hash.slice(0, 8), entry })),
+  ]
+}
+
+function itemKey(item: BackupListItem) {
+  return item.kind === "patch" ? `patch:${item.index}` : `full:${item.id}`
+}
+
+function backupItemHelp(item: BackupListItem) {
+  return item.kind === "patch" ? `Patch restore point.\n\nValid: ${item.valid ? "yes" : "no"}\nChanged paths: ${item.description}` : `Full config snapshot.\n\n${item.description}`
+}
+
+function backupPreview(item: BackupListItem, config: SidecarConfig) {
+  return [item.title, item.description, "", JSON.stringify(config, null, 2)].join("\n")
+}
+
+function formatBackupTime(timestamp: string) {
+  return timestamp.replace("T", " ").replace(/\.\d+Z$/, "Z")
+}
+
+async function showSoukInfo(api: TuiPluginApi) {
+  await showInfo(api, {
+    title: "Souk Info",
+    message: [
+      "What Souk Is",
+      "OpenCode Souk is a TUI-native extension bazaar. It replaces the vanilla plugin manager with browsing, inspection, deterministic installs, and optional Kāf Forge assistance.",
+      "",
+      "Main Menu",
+      "Browse items opens the marketplace browser. Installed plugins opens the runtime plugin management view. Refresh sources updates the marketplace cache. Kāf Forge settings configures experimental agent-assisted installs. Diagnostics checks runtime health. Debug & advanced contains logs, backups, and UI size controls.",
+      "",
+      "Contextual Help",
+      "Press i on menu rows, install actions, scopes, settings, backups, and browser items. Souk should explain what the highlighted thing does, where data comes from, what it may write, and what risks matter.",
+      "",
+      "Item Browser",
+      "Browse items shows marketplace/cache entries only. Installed plugins are intentionally excluded. Enter toggles selection. Space opens the install menu for selected items, or for the highlighted item when nothing is selected. / searches names, descriptions, tags, kinds, sources, repos, aliases, and install specs. i opens an item appraisal and returns to the browser. s opens Kāf settings and returns to the browser. r refreshes sources and returns to the browser. Shift+Up/Down or Ctrl+Up/Down jumps kind groups. Shift+Left/Right jumps tag groups. Esc returns to the main menu.",
+      "",
+      "Installed Plugins",
+      "Installed plugins is a separate runtime management view. It is table-shaped like the item browser, but has no batch selection, install menu, Forge, preview, or scope prompt. Enter toggles the highlighted plugin on or off through OpenCode's plugin activate/deactivate API. i opens plugin details. r refreshes the plugin list. Esc returns to the main menu.",
+      "",
+      "Native Installs",
+      "Souk installs plugins, MCPs, agents, commands, themes, and skills deterministically when metadata is sufficient. Plugins use OpenCode's plugin API. MCPs patch OpenCode config and may connect/auth at runtime. Agents, commands, themes, and skills write conventional OpenCode files/config.",
+      "",
+      "Native Install Safety",
+      "Souk previews planned writes, creates pre-install backup snapshots, preserves JSONC comments, uses atomic writes, and refuses conflicting overwrites. Claude mcpServers conversion requires explicit approval with a diff preview. Souk does not guess when it cannot prove an install path.",
+      "",
+      "Install Scope",
+      "Both native installs and Kāf Forge ask for scope before persistent writes. Global scope writes to the global OpenCode config directory. Project scope writes under the selected project's .opencode directory/config.",
+      "",
+      "Forge And Kāf",
+      "Forge is experimental and optional. Kāf can assist with any selected item, including verified items. Kāf starts in a read-only planning agent, must analyze security, and must ask yes/no before switching to write-capable action mode.",
+      "",
+      "Kāf Security Review",
+      "Kāf must inspect source provenance, package risk, config writes, permissions, shell commands, OAuth/token handling, backups, and installation instructions. Kāf should plan manual installs when native tools may fail or lose required setup semantics. Warnings drop personality and use direct language.",
+      "",
+      "Confidence Labels",
+      "Verified means Souk has a charted path and may offer deterministic install. Partial means some mapping exists but review is still needed. Unmapped or unvetted items need extra caution. Anything below 100% confidence must say: The souk can make mistakes.",
+      "",
+      "Sources And Cache",
+      `Cache file: ${defaultCachePath()}`,
+      "Souk can read opencode.cafe, awesome-opencode, and OpenCode ecosystem docs when configured. It records per-source raw/normalized counts and parser warnings. It fetches when cache is empty or when you explicitly refresh. Refreshing sources does not install anything.",
+      "Deduped combo items preserve all contributing sources, choose the richest primary record for display, and show alternate kinds when sources disagree.",
+      "",
+      "Debug And Backups",
+      `Debug log: ${debugLogPath(defaultConfigDir())}`,
+      `Backup journal: ${backupJournalPath(defaultConfigDir())}`,
+      "Souk can write best-effort debug logs, create full config snapshots, and keep patch restore points for meaningful sidecar config changes. Native installs also create pre-install snapshots under souk-install-backups. UI/debug-only saves avoid backup spam.",
+      "",
+      "Restart Honesty",
+      "Some UI settings are hot. Kāf agent config, installed files, plugins, skills, agents, commands, and many OpenCode config changes may require a full OpenCode restart before every surface reflects them.",
+    ].join("\n"),
+  })
+}
+
+async function showMenu<Value>(api: TuiPluginApi, props: { title: string; options: WizardSelectOption<Value>[]; current?: Value }): Promise<Value | undefined> {
+  let current = props.current
+  while (true) {
+    const choice = await showMenuOnce(api, { ...props, current })
+    if (!choice) return undefined
+    current = choice.value
+    if (choice.action === "select") return choice.value
+    const option = props.options.find((item) => item.value === choice.value)
+    await showInfo(api, { title: option?.title ?? props.title, message: option?.help ?? option?.description ?? "No extra help is available for this option." })
+  }
+}
+
+function showMenuOnce<Value>(api: TuiPluginApi, props: { title: string; options: WizardSelectOption<Value>[]; current?: Value }): Promise<MenuChoice<Value> | undefined> {
+  return new Promise((resolve) => {
+    let settled = false
+    const done = (value: MenuChoice<Value> | undefined, clear = true) => {
+      if (settled) return
+      settled = true
+      resolve(value)
+      if (clear) api.ui.dialog.clear()
+    }
+    api.ui.dialog.replace(() => <MenuDialog api={api} title={props.title} options={props.options} current={props.current} onDone={done} />, () => done(undefined, false))
+  })
+}
+
+function MenuDialog<Value>(props: { api: TuiPluginApi; title: string; options: WizardSelectOption<Value>[]; current?: Value; onDone: (value: MenuChoice<Value> | undefined) => void }) {
+  const theme = () => props.api.theme.current
+  useWizardDialogSize(props.api)
+  useHidePromptCursor(props.api)
+  const dimensions = useTerminalDimensions()
+  const listHeight = createMemo(() => cappedHeight(props.options.length, wizardMaxRows(props.api, dimensions().height, 14, 6)))
+  const titleWidth = createMemo(() => menuTitleWidth(wizardDialogSize(props.api), props.options))
+  const popMode = props.api.mode.push(MODE)
+  let scroll: ScrollBoxRenderable | undefined
+  const [selected, setSelected] = createSignal(Math.max(0, props.options.findIndex((option) => option.value === props.current)))
+  const current = createMemo(() => props.options[selected()] ?? props.options[0])
+  const move = (delta: number) => setSelected((value) => {
+    const next = Math.max(0, Math.min(props.options.length - 1, value + delta))
+    scroll?.scrollTo(Math.max(0, next - 2))
+    return next
+  })
+  const choose = () => { const option = current(); if (!option || option.disabled) return; props.onDone({ action: "select", value: option.value }) }
+  const inspect = () => { const option = current(); if (!option || option.disabled) return; props.onDone({ action: "inspect", value: option.value }) }
+  const commandPrefix = `souk.menu.${Math.random().toString(36).slice(2)}`
+  const unregister = props.api.keymap.registerLayer({
+    priority: 10000,
+    commands: [
+      { name: `${commandPrefix}.up`, title: "Previous item", run: (ctx: KeyContext) => { blockKey(ctx); move(-1) } },
+      { name: `${commandPrefix}.down`, title: "Next item", run: (ctx: KeyContext) => { blockKey(ctx); move(1) } },
+      { name: `${commandPrefix}.select`, title: "Select item", run: (ctx: KeyContext) => { blockKey(ctx); choose() } },
+      { name: `${commandPrefix}.inspect`, title: "Option help", run: (ctx: KeyContext) => { blockKey(ctx); inspect() } },
+      { name: `${commandPrefix}.back`, title: "Back", run: (ctx: KeyContext) => { blockKey(ctx); props.onDone(undefined) } },
+      { name: `${commandPrefix}.shield`, title: "Block background input", run: blockKey },
+    ],
+    bindings: [
+      { key: "up", cmd: `${commandPrefix}.up`, desc: "Previous item" },
+      { key: "ctrl+p", cmd: `${commandPrefix}.up`, desc: "Previous item" },
+      { key: "down", cmd: `${commandPrefix}.down`, desc: "Next item" },
+      { key: "ctrl+n", cmd: `${commandPrefix}.down`, desc: "Next item" },
+      { key: "enter", cmd: `${commandPrefix}.select`, desc: "Select item" },
+      { key: "i", cmd: `${commandPrefix}.inspect`, desc: "Option help" },
+      { key: "escape", cmd: `${commandPrefix}.back`, desc: "Back" },
+      ...shieldBindings(`${commandPrefix}.shield`, ["i"]),
+    ],
+  } as any)
+  onCleanup(() => { unregister(); popMode() })
+  return (
+    <box flexDirection="column" width="100%" paddingLeft={2} paddingRight={2} paddingTop={1} paddingBottom={1}>
+      <box flexDirection="row" justifyContent="space-between" width="100%" marginBottom={1}>
+        <text fg={theme().text}><b>{props.title}</b></text>
+        <box onMouseUp={() => props.onDone(undefined)}><KeyHints api={props.api} hints={[{ key: "esc", label: "back" }]} /></box>
+      </box>
+      <box marginBottom={1}>
+        <KeyHints api={props.api} hints={[{ key: "enter", label: "select" }, { key: "up/down", label: "move" }, { key: "i", label: "help" }]} />
+      </box>
+      <scrollbox maxHeight={listHeight()} ref={(element: ScrollBoxRenderable) => (scroll = element)}>
+        <box flexDirection="column" gap={0}>
+          <For each={props.options}>{(option, index) => {
+            const active = createMemo(() => selected() === index())
+            const fg = createMemo(() => active() ? theme().background : option.danger ? theme().error : option.color ?? theme().text)
+            const descFg = createMemo(() => active() ? theme().background : theme().textMuted)
+            return <box flexDirection="row" width="100%" gap={1} paddingLeft={1} paddingRight={1} backgroundColor={active() ? theme().primary : theme().backgroundPanel} onMouseOver={() => setSelected(index())} onMouseUp={() => { if (!option.disabled) props.onDone({ action: "select", value: option.value }) }}>
+              <text width={titleWidth()} flexShrink={0} fg={fg()} wrapMode="none" overflow="hidden"><b>{option.title}</b></text>
+              <text flexGrow={1} fg={descFg()} wrapMode="none" overflow="hidden">{option.description ?? ""}</text>
+            </box>
+          }}</For>
+        </box>
+      </scrollbox>
+    </box>
+  )
+}
+
+function showPrompt(api: TuiPluginApi, props: { title: string; placeholder?: string; value?: string }): Promise<string | undefined> {
+  return new Promise((resolve) => {
+    let settled = false
+    const done = (value: string | undefined) => {
+      if (settled) return
+      settled = true
+      resolve(value)
+    }
+    api.ui.dialog.replace(() =>
+      api.ui.DialogPrompt({
+        title: props.title,
+        placeholder: props.placeholder,
+        value: props.value ?? "",
+        onConfirm: (value) => {
+          done(value)
+          api.ui.dialog.clear()
+        },
+        onCancel: () => {
+          done(undefined)
+          api.ui.dialog.clear()
+        },
+      }),
+      () => done(undefined),
+    )
+  })
+}
+
+function showConfirm(api: TuiPluginApi, props: { title: string; message: string }): Promise<boolean> {
+  return new Promise((resolve) => {
+    let settled = false
+    const done = (value: boolean) => {
+      if (settled) return
+      settled = true
+      resolve(value)
+    }
+    api.ui.dialog.replace(() =>
+      api.ui.DialogConfirm({
+        title: props.title,
+        message: props.message,
+        onConfirm: () => {
+          done(true)
+          api.ui.dialog.clear()
+        },
+        onCancel: () => {
+          done(false)
+          api.ui.dialog.clear()
+        },
+      }),
+      () => done(false),
+    )
+  })
+}
+
+function showInfo(api: TuiPluginApi, props: { title: string; message: string }): Promise<void> {
+  return new Promise((resolve) => {
+    let settled = false
+    const done = () => {
+      if (settled) return
+      settled = true
+      resolve()
+      api.ui.dialog.clear()
+    }
+    api.ui.dialog.replace(() => <InfoDialog api={api} title={props.title} message={props.message} onDone={done} />, done)
+  })
+}
+
+function InfoDialog(props: { api: TuiPluginApi; title: string; message: string; onDone: () => void }) {
+  const theme = () => props.api.theme.current
+  useWizardDialogSize(props.api)
+  useHidePromptCursor(props.api)
+  const dimensions = useTerminalDimensions()
+  const popMode = props.api.mode.push(MODE)
+  const lines = createMemo(() => props.message.split(/\r?\n/))
+  const visualRows = createMemo(() => estimatedVisualRows(props.message, dialogContentWidth(props.api)))
+  const bodyHeight = createMemo(() => cappedHeight(visualRows() + 1, wizardMaxRows(props.api, dimensions().height, 13, 4), 4))
+  let scroll: ScrollBoxRenderable | undefined
+  const page = () => Math.max(1, (scroll?.height ?? bodyHeight()) - 1)
+  const commandPrefix = `souk.info.${Math.random().toString(36).slice(2)}`
+  const unregister = props.api.keymap.registerLayer({
+    priority: 10000,
+    commands: [
+      { name: `${commandPrefix}.close`, title: "Close", run: (ctx: KeyContext) => { blockKey(ctx); props.onDone() } },
+      { name: `${commandPrefix}.up`, title: "Scroll up", run: (ctx: KeyContext) => { blockKey(ctx); scroll?.scrollBy(-1) } },
+      { name: `${commandPrefix}.down`, title: "Scroll down", run: (ctx: KeyContext) => { blockKey(ctx); scroll?.scrollBy(1) } },
+      { name: `${commandPrefix}.pageUp`, title: "Page up", run: (ctx: KeyContext) => { blockKey(ctx); scroll?.scrollBy(-page()) } },
+      { name: `${commandPrefix}.pageDown`, title: "Page down", run: (ctx: KeyContext) => { blockKey(ctx); scroll?.scrollBy(page()) } },
+      { name: `${commandPrefix}.home`, title: "Scroll top", run: (ctx: KeyContext) => { blockKey(ctx); scroll?.scrollTo(0) } },
+      { name: `${commandPrefix}.end`, title: "Scroll bottom", run: (ctx: KeyContext) => { blockKey(ctx); scroll?.scrollTo(scroll.scrollHeight) } },
+      { name: `${commandPrefix}.shield`, title: "Block background input", run: blockKey },
+    ],
+    bindings: [
+      { key: "enter", cmd: `${commandPrefix}.close`, desc: "Close" },
+      { key: "escape", cmd: `${commandPrefix}.close`, desc: "Close" },
+      { key: "up", cmd: `${commandPrefix}.up`, desc: "Scroll up" },
+      { key: "ctrl+p", cmd: `${commandPrefix}.up`, desc: "Scroll up" },
+      { key: "down", cmd: `${commandPrefix}.down`, desc: "Scroll down" },
+      { key: "ctrl+n", cmd: `${commandPrefix}.down`, desc: "Scroll down" },
+      { key: "pageup", cmd: `${commandPrefix}.pageUp`, desc: "Page up" },
+      { key: "ctrl+b", cmd: `${commandPrefix}.pageUp`, desc: "Page up" },
+      { key: "pagedown", cmd: `${commandPrefix}.pageDown`, desc: "Page down" },
+      { key: "ctrl+f", cmd: `${commandPrefix}.pageDown`, desc: "Page down" },
+      { key: "home", cmd: `${commandPrefix}.home`, desc: "Scroll top" },
+      { key: "end", cmd: `${commandPrefix}.end`, desc: "Scroll bottom" },
+      ...shieldBindings(`${commandPrefix}.shield`, ["home", "end"]),
+    ],
+  } as any)
+  onCleanup(() => { unregister(); popMode() })
+
+  return (
+    <box flexDirection="column" width="100%" paddingLeft={2} paddingRight={2} paddingTop={1} paddingBottom={1}>
+      <box flexDirection="row" justifyContent="space-between" width="100%" marginBottom={1}>
+        <text fg={theme().accent}><b>{props.title}</b></text>
+        <box onMouseUp={props.onDone}><KeyHints api={props.api} hints={[{ key: "esc", label: "close" }]} /></box>
+      </box>
+      <scrollbox maxHeight={bodyHeight()} ref={(element: ScrollBoxRenderable) => (scroll = element)}>
+        <box flexDirection="column" gap={0}>
+          <For each={lines()}>{(line) => {
+            const heading = line.length > 0 && !line.startsWith(" ") && (line.endsWith(":") || /^[A-Z][A-Za-z ]+$/.test(line))
+            const warning = /restart|required|red|warning|risk|mistakes|conflict|refuses|failed|error/i.test(line)
+            const positive = /hot reload|yes|saved|enabled|verified|installed|success/i.test(line)
+            return line.length === 0
+              ? <text> </text>
+              : <text fg={warning ? theme().error : positive ? theme().success : heading ? theme().accent : theme().textMuted} wrapMode="word">{heading ? <b>{line}</b> : line}</text>
+          }}</For>
+        </box>
+      </scrollbox>
+      <box flexDirection="row" justifyContent="space-between" width="100%">
+        <Show when={visualRows() > bodyHeight()}><KeyHints api={props.api} hints={[{ key: "up/down", label: "scroll" }]} /></Show>
+        <box paddingLeft={3} paddingRight={3} backgroundColor={theme().primary} onMouseUp={props.onDone}>
+          <text fg={theme().background}><b>ok</b></text>
+        </box>
+      </box>
+    </box>
+  )
+}
+
+function registerCommands(api: TuiPluginApi) {
+  return api.keymap.registerLayer({
+    priority: 1000,
+    commands: [
+      {
+        name: "souk.open",
+        title: "Souk",
+        category: "Plugin Manager",
+        namespace: "palette",
+        slashName: "souk",
+        run() {
+          void openSouk(api)
+        },
+      },
+    ],
+    bindings: [],
+  } as any)
+}
+
+const tui: TuiPlugin = async (api) => {
+  const replaced = await api.plugins.deactivate(INTERNAL_PLUGIN_MANAGER).catch(() => false)
+  if (!replaced) {
+    api.ui.toast({
+      variant: "warning",
+      message: "Souk could not deactivate the built-in plugin manager. If vanilla Plugins still opens, disable internal:plugin-manager in tui.jsonc.",
+    })
+  }
+  const unregister = registerCommands(api)
+  api.lifecycle.onDispose(() => unregister())
+}
+
+export default { id: "opencode-souk", tui }