opencode-fold-tools 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 ningzimu
+Copyright (c) 2026 tanman24
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,109 @@
+# opencode-fold-tools
+
+[简体中文](README.zh-CN.md)
+
+Compact, expandable tool output for the OpenCode TUI. Each tool call keeps its own input summary in conversation order. Click the summary to reveal its output underneath; only the arrow changes on the input line.
+
+```text
+▸ Read src/example.ts
+▸ Shell npm test
+
+▾ Shell npm test
+  │ ✓ tests passed
+  │ …output continues here…
+```
+
+The expanded output has a theme-colored background and a left border. Collapsing it removes the output panel and its background. Consecutive reads and searches are not grouped.
+
+## Features
+
+- Click a tool summary to expand or collapse its output. Long text output scrolls inside its panel.
+- Keep native colored diffs and line numbers for Edit, Write, and Apply Patch where available.
+- Press **Ctrl+O** to expand or collapse all matched tool rows.
+- Open **Ctrl+P → 所有工具详情** (All tool details) to inspect tool records, including running calls that have no matching inline row. This fallback shows both input and output.
+- Keep an **打开子任务 →** (Open subtask) link for Task calls with a child session.
+
+Command labels and status messages are currently in Chinese. Tool names and output retain their original text.
+
+## Compatibility
+
+Tested with **OpenCode 1.18.27** in **Otty**. The plugin uses OpenCode's internal render tree; other versions and terminals may behave differently. It does not patch the OpenCode executable.
+
+Do not enable this plugin alongside `opencode-fold-diffs` or another plugin that rewrites the same tool rows. Remove the old plugin entry from your TUI configuration before installation.
+
+## Install
+
+Install the npm package globally through OpenCode:
+
+```sh
+opencode plugin opencode-fold-tools -g
+```
+
+Restart OpenCode to load the plugin. This method does not require a separate Node.js installation or a Git checkout.
+
+## Update
+
+```sh
+opencode plugin opencode-fold-tools@latest -g --force
+```
+
+Restart OpenCode after updating.
+
+## Install from source
+
+For a local checkout, you need **Node.js 22 or later**, **Git**, and OpenCode. Use either the npm package or a source checkout, not both.
+
+```sh
+git clone https://github.com/ningzimu/opencode-fold-tools.git
+cd opencode-fold-tools
+npm ci --ignore-scripts
+npm run install:plugin
+```
+
+The installer adds this checkout's `index.js` as an absolute file URL to your global `tui.json` or `tui.jsonc`, preserving other settings. Keep the checkout in place: OpenCode loads the plugin from it. Restart OpenCode after installation.
+
+For a specific configuration file:
+
+```sh
+npm run install:plugin -- --config /path/to/tui.jsonc
+```
+
+To update a source installation, run these commands inside your existing checkout, then restart OpenCode:
+
+```sh
+git pull --ff-only
+npm ci --ignore-scripts
+npm run install:plugin
+```
+
+If you installed into a custom configuration, pass the same `-- --config /path/to/tui.jsonc` argument again.
+
+## Verify and troubleshoot
+
+To run the automated checks from a source checkout (Node.js 22 or later):
+
+```sh
+npm test
+```
+
+After restarting OpenCode, open a session containing tool calls. Confirm that **Ctrl+P** lists **所有工具详情**, then click a Read or Shell summary. Its output should appear below, on a background, while the summary stays unchanged except for its arrow. Click again to hide the panel, and try **Ctrl+O** for all matched rows.
+
+If keyboard toggling works but clicking does not, clear any text selection and check that the terminal forwards mouse events. In Otty, enable **Settings → Advanced → All Settings → Allow Mouse Capture**.
+
+If a row cannot be matched to OpenCode's current layout, use **所有工具详情** as a fallback. The plugin can show only the output OpenCode retains; it cannot recover compacted or truncated history. Automated tests do not establish compatibility with every OpenCode version or terminal.
+
+## Uninstall
+
+For an npm installation, remove the `opencode-fold-tools` entry (including any version suffix) from the `plugin` array in your global `tui.json` or `tui.jsonc`, then restart OpenCode.
+
+For a source installation, run this from the checkout:
+
+```sh
+npm run uninstall:plugin
+```
+
+For a custom configuration, append `-- --config /path/to/tui.jsonc`. Uninstall removes only this plugin's configuration entry. Restart OpenCode, then delete the checkout if you no longer need it.
+
+## License and credits
+
+[MIT](LICENSE). Inspired by [opencode-fold-diffs](https://github.com/tannerbruhn/opencode-fold-diffs) by Tanner Bruhn.

package/README.zh-CN.md

@@ -0,0 +1,109 @@
+# opencode-fold-tools
+
+[English](README.md)
+
+为 OpenCode TUI 提供紧凑、可展开的工具输出。每次工具调用按原顺序保留一行输入摘要，点击后在下方展开输出；输入行只改变箭头。
+
+```text
+▸ Read src/example.ts
+▸ Shell npm test
+
+▾ Shell npm test
+  │ ✓ tests passed
+  │ …后续输出…
+```
+
+展开的输出区域使用主题背景色和左侧边线，收起后输出及背景一起消失。连续的读取和搜索不会合并分组。
+
+## 功能
+
+- 点击工具摘要展开或收起输出，长文本输出可在面板内滚动。
+- Edit、Write、Apply Patch 在可用时保留原生 diff 高亮和行号。
+- **Ctrl+O**：统一展开或收起所有已匹配的工具行。
+- **Ctrl+P → 所有工具详情**：查看工具记录，包括尚未匹配到行内展示的运行中调用。此备用入口同时展示输入和输出。
+- Task 存在子会话时保留 **打开子任务 →** 入口。
+
+当前命令名称和状态提示使用中文，工具名及输出保留原文。
+
+## 兼容性
+
+已在 **OpenCode 1.18.27 + Otty** 中验证。插件依赖 OpenCode 内部渲染树，其他版本或终端的表现可能不同；不会修改 OpenCode 可执行文件。
+
+请勿同时启用 `opencode-fold-diffs` 或其他改写相同工具行的插件。安装前先从 TUI 配置中移除旧插件条目。
+
+## 安装
+
+通过 OpenCode 全局安装 npm 包：
+
+```sh
+opencode plugin opencode-fold-tools -g
+```
+
+重启 OpenCode 后加载插件。此方式无需额外安装 Node.js 或克隆 Git 仓库。
+
+## 更新
+
+```sh
+opencode plugin opencode-fold-tools@latest -g --force
+```
+
+更新后重启 OpenCode。
+
+## 从源码安装
+
+本地源码安装需要 **Node.js 22 或更高版本**、**Git** 和 OpenCode。npm 包与源码安装请选择一种，不要同时启用。
+
+```sh
+git clone https://github.com/ningzimu/opencode-fold-tools.git
+cd opencode-fold-tools
+npm ci --ignore-scripts
+npm run install:plugin
+```
+
+安装器将此仓库中的 `index.js` 以绝对文件 URL 加入全局 `tui.json` 或 `tui.jsonc`，保留其他设置。**请保留仓库目录**，OpenCode 会从这里加载插件。安装后重启 OpenCode。
+
+指定配置文件：
+
+```sh
+npm run install:plugin -- --config /path/to/tui.jsonc
+```
+
+更新源码安装时，在原仓库目录中运行，然后重启 OpenCode：
+
+```sh
+git pull --ff-only
+npm ci --ignore-scripts
+npm run install:plugin
+```
+
+如果安装时指定了配置文件，更新时同样添加 `-- --config /path/to/tui.jsonc`。
+
+## 验证与排障
+
+在源码仓库中运行自动化检查（需要 Node.js 22 或更高版本）：
+
+```sh
+npm test
+```
+
+重启 OpenCode 后，打开包含工具调用的会话。在 **Ctrl+P** 中确认存在 **所有工具详情**，然后点击 Read 或 Shell 摘要：下方应出现带背景的输出，输入摘要保持不变，仅箭头变化。再次点击应隐藏输出面板；使用 **Ctrl+O** 检查所有已匹配行的统一切换。
+
+如果快捷键有效但点击无效，先清除文本选区，并检查终端是否向应用转发鼠标事件。Otty 中需开启 **Settings → Advanced → All Settings → Allow Mouse Capture**。
+
+无法匹配当前 OpenCode 布局的工具行，可从 **所有工具详情** 查看。插件只能展示 OpenCode 仍保留的输出，无法恢复已压缩或截断的历史内容。自动化测试不代表所有 OpenCode 版本或终端都已兼容。
+
+## 卸载
+
+npm 安装：从全局 `tui.json` 或 `tui.jsonc` 的 `plugin` 数组中移除 `opencode-fold-tools` 条目（包括可能存在的版本后缀），然后重启 OpenCode。
+
+源码安装：在仓库目录中运行：
+
+```sh
+npm run uninstall:plugin
+```
+
+使用自定义配置时，添加 `-- --config /path/to/tui.jsonc`。卸载仅移除此插件的配置条目。重启 OpenCode 后，即可按需删除仓库目录。
+
+## 许可与致谢
+
+[MIT](LICENSE) 开源许可。受 Tanner Bruhn 的 [opencode-fold-diffs](https://github.com/tannerbruhn/opencode-fold-diffs) 启发。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,7 @@
+# Attribution
+
+This project grew from a local adaptation of [opencode-fold-diffs](https://github.com/tannerbruhn/opencode-fold-diffs) by Tanner Bruhn, licensed under MIT (copyright 2026 tanman24). Its approach to discovering tool renderables and preserving native file diffs informed this implementation. The original copyright notice is retained in LICENSE.
+
+OpenCode and OpenTUI are separate projects. This is an independent community plugin, not an official OpenCode product.
+
+The installer uses [jsonc-parser](https://github.com/microsoft/node-jsonc-parser), licensed under MIT, to preserve JSONC settings and comments. The plugin itself has no runtime package imports beyond Node built-ins.

package/index.js

@@ -0,0 +1,273 @@
+import path from 'node:path'
+import os from 'node:os'
+
+const children = node => node?.getChildren?.() ?? []
+const plain = node => typeof node?.plainText === 'string' ? node.plainText : ''
+const clean = text => text.replace(/\x1b\[[0-?]*[ -/]*[@-~]/g, '').replace(/[\x00-\x08\x0b-\x1f\x7f]/g, '')
+const json = value => JSON.stringify(value ?? {}, null, 2)
+const running = part => ['pending', 'running'].includes(part.state.status)
+const scalar = (input, omit = []) => {
+  const values = Object.entries(input).filter(([key, value]) => !omit.includes(key) && ['string', 'number', 'boolean'].includes(typeof value))
+  return values.length ? `[${values.map(([key, value]) => `${key}=${value}`).join(', ')}]` : ''
+}
+function fileLabel(value, directory) {
+  if (typeof value !== 'string') return ''
+  const absolute = path.resolve(directory, value)
+  const relative = path.relative(directory, absolute)
+  if (!relative) return '.'
+  if (relative !== '..' && !relative.startsWith('..' + path.sep) && !path.isAbsolute(relative)) return relative
+  const home = os.homedir()
+  return absolute.startsWith(home + path.sep) ? '~' + path.sep + absolute.slice(home.length + 1) : absolute
+}
+
+export function details(part, includeInput = false) {
+  const s = part.state
+  let output = s.status === 'error' ? s.error : s.output ?? s.metadata?.output
+  if (s.time?.compacted) output = '[历史输出已被 OpenCode 压缩，无法恢复原文]'
+  else if (output === undefined) output = running(part) ? '[正在运行，尚无输出]' : '[无文本输出]'
+  const input = part.tool === 'bash' ? `$ ${s.input?.command ?? ''}` : `输入\n${json(s.input)}`
+  return clean(`${includeInput ? input + '\n\n' : ''}${s.status === 'error' ? '错误\n' : ''}${typeof output === 'string' ? output : json(output)}`)
+}
+
+export function summary(part, directory) {
+  const input = part.state.input ?? {}
+  const file = fileLabel(input.filePath, directory)
+  switch (part.tool) {
+    case 'bash': return `Shell ${input.command ?? ''}`
+    case 'read': return `Read ${file}`
+    case 'glob': return `Glob ${input.pattern ?? ''}`
+    case 'grep': return `Grep ${input.pattern ?? ''}`
+    case 'edit': return `Edit ${file}`
+    case 'write': return `Write ${file}`
+    case 'task': return `Task ${input.description ?? ''}`
+    case 'webfetch': return `WebFetch ${input.url ?? ''}`
+    case 'websearch': return `WebSearch ${input.query ?? ''}`
+    case 'skill': return `Skill ${input.name ?? ''}`
+    case 'apply_patch': return `Patch ${(part.state.metadata?.files ?? []).map(file => file.relativePath).join(', ')}`
+    case 'todowrite': return `Todos ${input.todos?.length ?? 0} 项`
+    case 'question': return `Questions ${input.questions?.length ?? 0} 项`
+    default: return `${part.tool} ${Object.values(input).find(v => typeof v === 'string') ?? ''}`
+  }
+}
+
+export function groups(messages, getParts) {
+  return messages.filter(message => message.role === 'assistant').flatMap(message =>
+    getParts(message.id).filter(part => part.type === 'tool').map(part => ({
+      id: part.id, parentID: message.parentID, parts: [part],
+    })))
+}
+
+export function groupTitle(group, directory) {
+  return summary(group.parts[0], directory)
+}
+
+// Reproduce the host's labels, including scalar arguments, to distinguish
+// repeated reads at different offsets and searches in different directories.
+export function matches(label, part, directory) {
+  label = label.trim()
+  const s = part.state.input ?? {}
+  const file = fileLabel(s.filePath, directory)
+  const pending = { read: 'Reading file...', glob: 'Finding files...', grep: 'Searching content...', bash: 'Writing command...', edit: 'Preparing edit...', write: 'Preparing write...', apply_patch: 'Preparing patch...', task: 'Delegating...', question: 'Asking questions...', todowrite: 'Updating todos...', skill: 'Loading skill...', webfetch: 'Fetching from the web...', websearch: 'Searching web...', execute: 'execute' }
+  if (running(part) && label === `~ ${pending[part.tool] ?? 'Writing command...'}`) return true
+  switch (part.tool) {
+    case 'read': return label === `Read ${file} ${scalar(s, ['filePath'])}`.trim()
+    case 'glob':
+    case 'grep': {
+      const name = part.tool === 'glob' ? 'Glob' : 'Grep'
+      const prefix = `${name} "${s.pattern}"${s.path ? ` in ${fileLabel(s.path, directory)}` : ''}`
+      return label === prefix || label.startsWith(prefix + ' (')
+    }
+    case 'bash': return label === `$ ${s.command}`.trim() || label === s.command?.trim()
+    case 'edit': return label === `← Edit ${file}` || label === `Edit ${file}`
+    case 'write': return label === `# Wrote ${file}` || label === `Write ${file}`
+    case 'webfetch': return label === `WebFetch ${s.url}`
+    case 'websearch': return typeof s.query === 'string' && /^[^\n]+ "/.test(label) && (label.endsWith(`"${s.query}"`) || label.includes(`"${s.query}" (`))
+    case 'task': return typeof s.description === 'string' && /Task(?: \(background\))? — /.test(label) && label.split('\n')[0].endsWith(`— ${s.description}`)
+    case 'todowrite': return label === '# Todos' || label === 'Updating todos...'
+    case 'question': return label === '# Questions' || label === `Asked ${s.questions?.length} question${s.questions?.length === 1 ? '' : 's'}`
+    case 'execute': return label === 'execute' || label.startsWith('execute\n')
+    case 'apply_patch': return (part.state.status === 'error' && label === 'Patch failed') || (part.state.metadata?.files ?? []).some(file => {
+      const expected = file.type === 'delete' ? `# Deleted ${file.relativePath}` : file.type === 'add' ? `# Created ${file.relativePath}` : file.type === 'move' ? `# Moved ${fileLabel(file.filePath, directory)} → ${file.relativePath}` : `← Patched ${file.relativePath}`
+      return label === expected
+    })
+    case 'skill': return label === `Skill "${s.name}"`
+    default: return label === `${part.tool} ${scalar(s)}`.trim() || label === `# ${part.tool} ${scalar(s)}`.trim()
+  }
+}
+
+export default {
+  id: 'opencode-fold-tools',
+  async tui(api) {
+    let sessionID, allOpen = false, serial = 0
+    const opened = new Set(), widgets = new Map(), hidden = new Map(), owned = new WeakSet(), nativeHeaders = new Map()
+    let disposed = false
+    // The host must create tool rows before this plugin can replace them.
+    if (api.kv?.get('tool_details_visibility', true) === false) api.kv.set('tool_details_visibility', true)
+    const model = () => groups(api.state.session.messages(api.route.current.params?.sessionID), id => api.state.part(id))
+    const text = (Sample, content, options = {}) => {
+      const node = new Sample(api.renderer, { id: `fold-tools-${++serial}`, content, fg: api.theme.current.text, wrapMode: 'word', flexShrink: 0, ...options })
+      owned.add(node); return node
+    }
+    function remove(widget) {
+      if (!widget.root.isDestroyed) {
+        if (widget.root.destroyRecursively) widget.root.destroyRecursively(); else widget.root.destroy()
+      }
+    }
+    function reset() {
+      for (const widget of widgets.values()) remove(widget)
+      widgets.clear()
+      for (const [node, visible] of hidden) if (!node.isDestroyed) node.visible = visible
+      hidden.clear(); opened.clear()
+      for (const [node, visible] of nativeHeaders) if (!node.isDestroyed) node.visible = visible
+      nativeHeaders.clear()
+    }
+    function findTranscript(node) {
+      if (!node || node.isDestroyed || owned.has(node)) return
+      if (node.stickyScroll && node.stickyStart === 'bottom') return node
+      if (typeof node.scrollTo === 'function') return
+      for (const child of children(node)) { const found = findTranscript(child); if (found) return found }
+    }
+    function candidates(transcript, userIDs) {
+      const found = []
+      let parentID
+      function visit(node) {
+        if (!node || node.isDestroyed || owned.has(node)) return
+        if (userIDs.has(node.id)) parentID = node.id
+        const kids = children(node)
+        for (const row of kids) {
+          const peers = children(row)
+          if (peers.length === 2 && /^[→←✱⚙$%◈✓│✗]$/.test(plain(peers[0]).trim()) && plain(peers[1])) {
+            found.push({ node: peers[1], host: node, label: plain(peers[1]).trim(), parentID })
+            return
+          }
+        }
+        const head = kids.find(child => plain(child).trim())
+        if (head && plain(head).startsWith('~ ')) {
+          found.push({ node: head, host: node, label: plain(head).trim(), parentID })
+          return
+        }
+        if (head && !plain(head).startsWith('# Running in ') && /^(# |← (Edit|Patched) )/.test(plain(head))) {
+          found.push({ node: head, host: node, label: plain(head).trim(), parentID, native: /^(← (Edit|Patched) |# (Wrote|Created|Deleted|Moved) )/.test(plain(head)) })
+          return
+        }
+        for (const inner of kids) {
+          const command = children(inner)[0]
+          if (plain(command).startsWith('$ ')) {
+            found.push({ node: command, host: node, label: plain(command).trim(), parentID })
+            return
+          }
+        }
+        for (const child of children(node)) visit(child)
+      }
+      visit(transcript)
+      return found
+    }
+    function sweep() {
+      if (disposed) return
+      if (api.route.current.name !== 'session') { reset(); sessionID = undefined; return }
+      const id = api.route.current.params?.sessionID
+      if (id !== sessionID) { reset(); sessionID = id }
+      const transcript = findTranscript(api.renderer.root)
+      if (!transcript) return
+      const list = model(), records = list.flatMap(group => group.parts.map(part => ({ group, part })))
+      const userIDs = new Set(api.state.session.messages(id).filter(m => m.role === 'user').map(m => m.id))
+      const roots = new Map(), matched = new Set(), usedHosts = new Set(), patchFiles = new Map()
+      let cursor = 0
+      for (const candidate of candidates(transcript, userIDs)) {
+        if (usedHosts.has(candidate.host)) continue
+        const index = records.findIndex((r, i) => i >= cursor && (!candidate.parentID || r.group.parentID === candidate.parentID) && matches(candidate.label, r.part, api.state.path.directory))
+        if (index < 0) continue
+        const record = records[index]
+        cursor = index
+        if (record.part.tool === 'apply_patch') {
+          const seen = patchFiles.get(record.part.id) ?? new Set()
+          seen.add(candidate.label); patchFiles.set(record.part.id, seen)
+          if (seen.size >= (record.part.state.metadata?.files?.length ?? 1)) cursor++
+        } else cursor++
+        usedHosts.add(candidate.host); matched.add(candidate.host)
+        if (!roots.has(record.group.id)) roots.set(record.group.id, [])
+        roots.get(record.group.id).push(candidate)
+      }
+      for (const [host, visible] of hidden) if (host.isDestroyed || !matched.has(host)) { if (!host.isDestroyed) host.visible = visible; hidden.delete(host) }
+      for (const host of matched) { if (!hidden.has(host)) hidden.set(host, host.visible); host.visible = false }
+      for (const [key, widget] of widgets) if (!roots.has(key) || widget.root.isDestroyed) { remove(widget); widgets.delete(key) }
+      for (const group of list) {
+        const anchors = roots.get(group.id)
+        if (!anchors?.length) continue
+        const anchor = anchors[0]
+        let widget = widgets.get(group.id)
+        if (!widget) {
+          const root = new anchor.host.constructor(api.renderer, { id: `fold-tools-${++serial}`, flexDirection: 'column', paddingLeft: 3, flexShrink: 0 })
+          owned.add(root)
+          const header = text(anchor.node.constructor, '', { maxHeight: 1, overflow: 'hidden', selectable: false })
+          const body = new transcript.constructor(api.renderer, { id: `fold-tools-${++serial}`, height: 14, width: '100%', border: ['left'], borderColor: api.theme.current.borderSubtle, backgroundColor: api.theme.current.backgroundPanel, padding: 1, stickyScroll: false, flexShrink: 0 })
+          owned.add(body)
+          const content = text(anchor.node.constructor, '', { selectable: true })
+          body.add(content); root.add(header); root.add(body)
+          const navigation = text(anchor.node.constructor, '打开子任务 →', { selectable: false, fg: api.theme.current.primary })
+          root.add(navigation)
+          widget = { root, header, body, content, navigation, group }
+          widgets.set(group.id, widget)
+          if (allOpen) opened.add(group.id)
+          header.onMouseUp = event => {
+            if (api.renderer.getSelection?.()?.getSelectedText?.()) return
+            if (opened.has(group.id)) opened.delete(group.id); else opened.add(group.id)
+            refresh(widget); event?.stopPropagation?.()
+          }
+          navigation.onMouseUp = event => {
+            const childID = widget.group.parts[0].state.metadata?.sessionId
+            if (childID) api.route.navigate('session', { sessionID: childID })
+            event?.stopPropagation?.()
+          }
+        }
+        widget.group = group
+        widget.native = ['edit', 'write', 'apply_patch'].includes(group.parts[0].tool) && anchors.every(a => a.native)
+        widget.anchors = anchors
+        if (widget.native) for (const item of anchors) {
+          if (!nativeHeaders.has(item.node)) nativeHeaders.set(item.node, item.node.visible)
+        }
+        if (widget.root.parent !== anchor.host.parent || children(anchor.host.parent).indexOf(widget.root) + 1 !== children(anchor.host.parent).indexOf(anchor.host)) anchor.host.parent.insertBefore(widget.root, anchor.host)
+        refresh(widget)
+      }
+    }
+    function refresh(widget) {
+      const { group } = widget, open = opened.has(group.id)
+      const title = `${open ? '▾' : '▸'} ${groupTitle(group, api.state.path.directory).replace(/\s+/g, ' ')}`
+      if (widget.header.content !== title) widget.header.content = title
+      widget.root.visible = true
+      if (widget.native) for (const anchor of widget.anchors) {
+        anchor.host.visible = open
+        anchor.node.visible = open ? false : nativeHeaders.get(anchor.node)
+      }
+      widget.root.backgroundColor = api.theme.current.background
+      widget.body.visible = open && !widget.native
+      widget.navigation.visible = open && group.parts[0].tool === 'task' && Boolean(group.parts[0].state.metadata?.sessionId)
+      if (open) {
+        const value = details(group.parts[0])
+        if (widget.content.content !== value) widget.content.content = value
+        widget.body.height = Math.min(16, Math.max(5, value.split('\n').length + 2))
+      }
+    }
+    function picker() {
+      const parts = model().flatMap(group => group.parts)
+      api.ui.dialog.replace(() => api.ui.DialogSelect({ title: '所有工具详情', options: parts.map((part, index) => ({
+        title: `${index + 1}. ${summary(part, api.state.path.directory).replace(/\s+/g, ' ')}`,
+        description: part.state.status, value: part.id,
+        onSelect: () => api.ui.dialog.replace(() => api.ui.DialogAlert({ title: part.tool, message: details(part, true) })),
+      })) }))
+    }
+    const unregister = api.keymap.registerLayer({ mode: 'base', priority: 110,
+      commands: [{ name: 'fold_tools.toggle', title: '展开 / 折叠所有工具', category: 'Plugin', run() {
+        allOpen = !allOpen; sweep()
+        for (const key of widgets.keys()) { if (allOpen) opened.add(key); else opened.delete(key) }
+        for (const widget of widgets.values()) refresh(widget)
+        api.ui.toast({ variant: 'info', message: `${allOpen ? '已展开' : '已折叠'} ${widgets.size} 个工具`, duration: 1500 })
+        return true
+      } }, { name: 'fold_tools.list', title: '所有工具详情', category: 'Plugin', run() { picker(); return true } }],
+      bindings: [{ key: 'ctrl+o', cmd: 'fold_tools.toggle', desc: '展开 / 折叠所有工具', preventDefault: true }],
+    })
+    const off = [api.event.on('message.part.updated', sweep), api.event.on('message.updated', sweep)]
+    const timer = setInterval(sweep, 1000)
+    api.lifecycle.onDispose(() => { disposed = true; clearInterval(timer); off.forEach(fn => fn()); if (typeof unregister === 'function') unregister(); reset() })
+  },
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "opencode-fold-tools",
+  "version": "0.1.0",
+  "description": "One row per OpenCode tool call. Click to reveal its output, with native file diffs and no exploration grouping.",
+  "type": "module",
+  "license": "MIT",
+  "author": "ningzimu",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ningzimu/opencode-fold-tools.git"
+  },
+  "homepage": "https://github.com/ningzimu/opencode-fold-tools#readme",
+  "bugs": "https://github.com/ningzimu/opencode-fold-tools/issues",
+  "keywords": ["opencode", "opencode-plugin", "tui", "fold", "tool-output"],
+  "oc-plugin": ["tui"],
+  "exports": {"./tui": "./index.js"},
+  "files": ["index.js", "scripts", "README.md", "README.zh-CN.md", "LICENSE", "THIRD_PARTY_NOTICES.md"],
+  "scripts": {
+    "test": "node --test",
+    "install:plugin": "node scripts/configure.mjs install",
+    "uninstall:plugin": "node scripts/configure.mjs uninstall"
+  },
+  "engines": {"node": ">=22"},
+  "dependencies": {"jsonc-parser": "3.3.1"}
+}

package/scripts/configure.mjs

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+import fs from 'node:fs'
+import path from 'node:path'
+import os from 'node:os'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+import { parse, modify, applyEdits, printParseErrorCode } from 'jsonc-parser'
+
+export const pluginPath = fileURLToPath(new URL('../index.js', import.meta.url))
+
+export function configPath(explicit, env = process.env) {
+  if (explicit || env.OPENCODE_TUI_CONFIG) return path.resolve(explicit || env.OPENCODE_TUI_CONFIG)
+  const directory = env.OPENCODE_CONFIG_DIR || path.join(env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config'), 'opencode')
+  const json = path.join(directory, 'tui.json'), jsonc = path.join(directory, 'tui.jsonc')
+  if (fs.existsSync(json) && fs.existsSync(jsonc)) throw new Error('Both tui.json and tui.jsonc exist. Select one with --config <path>.')
+  return fs.existsSync(jsonc) ? jsonc : json
+}
+
+function isThisPlugin(entry, config, target) {
+  const spec = Array.isArray(entry) ? entry[0] : entry
+  if (typeof spec !== 'string') return false
+  if (/^opencode-fold-tools(?:@[^/]+)?$/.test(spec)) return true
+  if (!spec.startsWith('file:') && !spec.startsWith('.') && !path.isAbsolute(spec)) return false
+  try {
+    const location = spec.startsWith('file:') ? fileURLToPath(spec) : path.resolve(path.dirname(config), spec)
+    return path.resolve(location) === path.resolve(target)
+  } catch { return false }
+}
+
+export function configure(config, action, target = pluginPath) {
+  if (!['install', 'uninstall'].includes(action)) throw new Error('Action must be install or uninstall.')
+  config = path.resolve(config)
+  const exists = fs.existsSync(config)
+  if (exists) config = fs.realpathSync(config)
+  if (!exists && action === 'uninstall') return { changed: false, config }
+  const original = exists ? fs.readFileSync(config, 'utf8') : '{}\n'
+  const errors = []
+  const data = parse(original, errors, { allowTrailingComma: true, disallowComments: false })
+  if (errors.length) throw new Error(`Invalid config: ${printParseErrorCode(errors[0].error)} at offset ${errors[0].offset}. No changes made.`)
+  if (typeof data !== 'object' || Array.isArray(data) || data === null) throw new Error('Config must be an object. No changes made.')
+  if (data.plugin !== undefined && !Array.isArray(data.plugin)) throw new Error('The plugin field must be an array. No changes made.')
+  if (action === 'install' && !fs.existsSync(target)) throw new Error(`Plugin file does not exist: ${target}`)
+  const spec = pathToFileURL(target).href
+  const previous = data.plugin ?? []
+  const alreadyInstalled = previous.some(entry => isThisPlugin(entry, config, target))
+  const next = action === 'uninstall' ? previous.filter(entry => !isThisPlugin(entry, config, target)) : alreadyInstalled ? previous : [...previous, spec]
+  if (JSON.stringify(previous) === JSON.stringify(next)) return { changed: false, config, spec }
+  const updated = applyEdits(original, modify(original, ['plugin'], next, { formattingOptions: { insertSpaces: true, tabSize: 2, eol: original.includes('\r\n') ? '\r\n' : '\n' } }))
+  fs.mkdirSync(path.dirname(config), { recursive: true })
+  let backup
+  if (exists) {
+    backup = `${config}.fold-tools-backup-${Date.now()}`
+    fs.copyFileSync(config, backup, fs.constants.COPYFILE_EXCL)
+    fs.chmodSync(backup, 0o600)
+  }
+  const temporary = `${config}.fold-tools-${process.pid}.tmp`
+  try {
+    fs.writeFileSync(temporary, updated, { flag: 'wx', mode: exists ? fs.statSync(config).mode & 0o777 : 0o600 })
+    fs.renameSync(temporary, config)
+  } finally {
+    if (fs.existsSync(temporary)) fs.unlinkSync(temporary)
+  }
+  return { changed: true, config, spec, backup }
+}
+
+function main(args) {
+  if (args.includes('--help') || args.length === 0) {
+    console.log('Usage: node scripts/configure.mjs <install|uninstall> [--config /path/to/tui.jsonc]')
+    return
+  }
+  const action = args.shift()
+  let explicit
+  while (args.length) {
+    const flag = args.shift()
+    if (flag !== '--config' || !args[0]) throw new Error(`Unknown or incomplete option: ${flag}`)
+    explicit = args.shift()
+  }
+  const result = configure(configPath(explicit), action)
+  console.log(`${result.changed ? 'Updated' : 'Unchanged'}: ${result.config}`)
+  if (result.backup) console.log(`Backup: ${result.backup}`)
+  console.log(action === 'install' ? 'Plugin registered. Keep this checkout and restart OpenCode.' : 'Plugin entry removed. Restart OpenCode; other plugins and settings are unchanged.')
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  try { main(process.argv.slice(2)) } catch (error) { console.error(error.message); process.exitCode = 1 }
+}