opencode-plugin-fixes

Overview

Archived historical project. The repository is read-only. opencode-plugin-fixes was never published to npm, so it is not a valid OpenCode package entry.

opencode-plugin-fixes is a small dependency-free source bundle for OpenCode. It explores four boring but expensive tool-call failure modes: malformed question arguments, over-broad MCP object coercion, DCP compress range payload shape failures, and repeated question prompts while the user is still answering.

What It Includes

FixQuestionSchema - normalizes stringified questions, bare question objects, and stringified options before OpenCode validates the question tool call.
FixMcpNestedObject - parses only selected schema-like MCP fields such as metadata, arguments, and queries, while leaving JSON-looking file bodies and user content untouched.
FixDcpCompressFlat - accepts flat DCP range payloads such as { topic, startId, endId, summary }, parses stringified native range arrays, and restores DCP's native content: [{ startId, endId, summary }] shape.
BlockRepeatQuestion - holds a per-session lock so (no answer) placeholders do not trigger retry spam before the user replies.

Why It Exists

Frontier models usually call tools correctly. When they do not, the failure is often just one level of JSON stringification or one nested array away from valid input. The source bundle fixes that narrow, recoverable class without pretending every malformed call is safe to rewrite. The DCP guardrail exists because compress range mode expects content: [{ startId, endId, summary }]. Some models reliably preserve the same information as flat fields, but keep breaking the array shape. FixDcpCompressFlat restores the native shape before validation while leaving native nested calls unchanged. The repeat-question blocker addresses a separate UI behavior: OpenCode can render (no answer) while the user is still typing. Some models read that as a decline and ask again. The plugin turns that into an explicit stop condition.

Historical Status

The final main branch preserves all four guardrails for reference, but the project is no longer maintained or part of the author's OpenCode setup. No npm package was published. Do not add "opencode-plugin-fixes" to OpenCode's plugin array. The initial v0.1.0 tag predates FixDcpCompressFlat; the fourth guardrail exists only in the final archived source tree.

Verification

The final archived source tree can be checked with:

Bash

npm test
npm pack --dry-run

The driver exercises all four hooks end-to-end, including the regression that arbitrary JSON-looking filesystem_write_file.content must remain unchanged.

中文简介

opencode-plugin-fixes 是一组零依赖 OpenCode 插件，用来保护长上下文 agent 运行中最烦人的四类小故障：question 参数形状错误、MCP nested object 被字符串化、DCP compress 的 range 参数形状失败、以及用户还没回答完时模型反复追问。它不会泛化地重写所有 JSON-looking 字符串；FixMcpNestedObject 只处理明确的 schema-like 字段，避免把文件正文、命令或用户内容误解析成对象。新增的 FixDcpCompressFlat 也只碰 compress 工具，把 flat { topic, startId, endId, summary } 还原成 DCP 原生的 content 数组形态。本项目已经归档，不再维护，也不属于作者当前的 OpenCode 配置。npm 包从未发布，"opencode-plugin-fixes" 不是可用的 package entry。最终 main 分支保留四个护栏；初始 v0.1.0 tag 只有前三个，FixDcpCompressFlat 是后续补入的源码。