opencode-fixes

Плагин-«ремонт» для OpenCode v2 против типичных проблем self-hosted inference (llama.cpp / llama-swap / vLLM и т.п.):

Фикс	Симптом	Что делает
bool-args	`Invalid input: expected boolean, received "True"` — модель отдаёт `"True"`/`"FALSE"` строками вместо булевых аргументов инструментов	Приводит строки к `true`/`false`, но только в позициях схемы, доказуемо булевых (Effect-схемы нативных инструментов и JSON-схемы плагинов/MCP). Обычные строковые поля не трогает
toolcall-leak	Сессия «зависает»: модель сгенерировала вызов инструмента, сервер не распарсил его и вернул как обычный текст с `finish_reason=stop`; OpenCode считает ход финальным ответом	Распознаёт протёкший tool call и автоматически просит модель повторить действие настоящим вызовом инструмента

Установка

Вариант 1 — файл (самый простой): скопируйте index.ts в

~/.config/opencode/plugins/opencode-fixes.ts     # глобально
<проект>/.opencode/plugin/opencode-fixes.ts      # для одного проекта

OpenCode v2 подхватывает файлы из этих папок автоматически, без рестарта.

Вариант 2 — путь в конфиге: склонируйте репозиторий и пропишите в ~/.config/opencode/opencode.json:

{ "plugin": ["/абсолютный/путь/до/opencode-fixes/index.ts"] }

Зависимостей нет: только node:fs/os/path и рантайм-модуль @opencode/plugin, который предоставляет OpenCode.

Как работает toolcall-leak

Ход считается «протёкшим», если он:

завершился с finish=stop (не ошибка и не настоящий tool call);
не содержит ни одного tool-вызова;
его текст ≤ 1200 символов, без markdown-код-блоков;
начинается с <tool_call> или заканчивается на </tool_call>.

Действие: в сессию отправляется короткое системное уведомление с просьбой повторить действие настоящим вызовом инструмента.

Защита от петель: максимум 3 ретрая подряд, счётчик сбрасывается первым же успешным ходом. Кумулятивных лимитов нет — в длинной сессии каждая новая утечка чинится штатно. Есть дедупликация между инстансами плагина (хот-релоад может оставить старые копии) — ретрай всегда ровно один на утечку.

Настройка (переменные окружения)

Переменная	По умолчанию	Значение
`OPENCODE_FIXES_LOG`	`~/.local/state/opencode/opencode-fixes.log`	путь к логу
`OPENCODE_FIXES_LEAK_MAX_LEN`	`1200`	максимальная длина «утёкшего» текста
`OPENCODE_FIXES_LEAK_MAX_CONSECUTIVE`	`3`	ретраев подряд до сдачи
`OPENCODE_FIXES_DEBUG`	—	подробные логи bool-фикса

Диагностика

При старте плагин прогоняет self-test обоих фиксаторов (4 + 8 кейсов). Полезные строки лога:

bool self-test True: PASS
bool: repaired shell: {"command":"ls","background":true}
leak self-test prefix-leak: PASS
leak: tool call leaked as text (pid ... ses_... msg_...), retry 1/3
leak: clean turn, consecutive reset (ses_...)

Требования

OpenCode v2 (API Plugin.define). Проверено с серверами на базе llama.cpp (llama-swap), vLLM и совместимыми OpenAI API.

Лицензия

MIT

4.4 KiB Raw Permalink Blame History Unescape Escape