Repository navigation
v0.0.0
[0.0.0] - 2026-11-10
Added
opencode.iconsandopencode.vendor, withassets/icon.svg,icon-128.pngandicon-256.pngfrom the family icon kit, the threeexportsandfilesentries, and theiconsstage ofnpm run check.- An
actionlintstage, and anactionlintjob in CI. - One typed code table,
src/codes.ts, with a test that fails when a code insrcis missing from it, or when a README or guide table drifts from it. - A test that parses every example in
docs/scripting.mdand the README: the method, the location header, the strict envelope and the tool's own fields.
Changed
-
Each Tavily skill's first line says how to sign in when the tools are absent:
/connect, or on Jellyjelly_connection_request. -
Every tool is allowed by default. The generated block allows the five tools and the
tavily_*namespace, so a tool Tavily adds later runs at once. The Jelly declaration's tools are allallow. Restrict it withaccess, with an agent's own rules, or with a rule per tool; the README's Permissions section,docs/configuration.mdandSECURITY.mdsay what an all-allow default means and how to restrict it. -
The
accessoption,"all"(the default),"ask-changes"and"read-only"(there is no earlier option to map). All five tools only read, so the value decides what a tool Tavily adds later does: run, ask or be denied. It generates the default rules, and status and the dialog show it. -
The host stage runs the host suite on every tested OpenCode SDK, 2.2.3, 2.2.4, 2.2.5 and 2.2.6: each release but the dev pin is installed from npm outside the lockfile into a temp folder, and the stage fails when a release did not run, as it does in CI. The pack stage keeps running every tested stock binary.
-
docs/scripting.mdcarries the family's envelope, location section, unload note, result wording and refusal table, word for word, and says which ofUPSTREAM_ERROR's two next steps applies. -
tools RPC v2: every known tool is scriptable under a prior explicit allow.
tavily.web.toolskeeps one method per known tool, each with its class (readfor all five), and resolves the rule before dispatch: only anallowruns, and anaskis refused with no prompt and no tool call.describereports each method's class, and — given a session — that session's permission, plus any live tool this plugin does not classify. A saved "Always allow" approval no longer authorizes an ad-hoc script: a script's grant is a rule in the agent's or the session's config, or a Jobsjobs_run_scriptrun session.opencode apicallers must send-H "x-opencode-directory:$PWD", or the call reaches the service's default location and failsrpc.unavailable. Tavily's error-object handling is applied to a script's result by the sameshapeResultthe model's hook uses.
Known limits
- Five tools. The plugin knows the five Tavily tools. A tool Tavily adds later is not classed by the plugin: the
accessoption decides whether it runs, asks or is denied, and/tavily-statuscounts it as unknown. - Research and crawl cost the most. Research takes minutes with no progress shown, and a call stops after 15 minutes. Crawl reads up to 50 pages by default. The plugin sets no spending limit: each call spends Tavily credits as the tool does.
- No retries. A failed call returns
UPSTREAM_ERRORwith its next step. The plugin does not retry it. - Web content is not trusted. A page can carry instructions, and nothing asks by default. The
tavilyskill tells the model not to follow them, but that is a rule for the model, not a guard in the plugin. - A shell key does not reach the server. A
TAVILY_API_KEYexported only in a terminal does not reach a running OpenCode server. See Sign in. - Hosts and platforms. The plugin is tested on 2.2.3, 2.2.4, 2.2.5 and 2.2.6, and runs on macOS or Linux. A later 2.2 release starts and is reported as untested.
- Updates are not automatic for a Git install, and
opencode plugin updateandopencode plugin checkdo not work on one: to move to a newer release, remove the old entry and add the new tag.