Activity

1. opencode-agent commented on Oct 21, 2026

   

   opencode-agentBot

   on Oct 21, 2026 – with OpenCode Agent

   Contributor

   More actions

   Thanks for the detailed report. I reproduced this on 2.1.2, and it still happens on the latest dev (3a1f9a9).

   What triggers it: the error happens when a plugin loaded by the background service has a setup() that returns something other than a cleanup function, for example an object. On reload the service tears down the old plugin generation and calls that return value as if it were a cleanup function. The resulting TypeError aborts the whole reload. ServerProcess.start and Worktree.refresh in the trace are only enclosing span labels, not where it breaks.

   Why it showed up even with no plugins: your "zero plugins" case doesn't actually remove them. OPENCODE_CONFIG_DIR only changes the config read by the CLI process. The running service still loads your real global config and its plugins. --standalone works because it starts a fresh server with your sandboxed, empty config.

   Steps (script below):

   1. Configure a local plugin export default { id: "objret", async setup() { return { hooks: {} } } } in the global opencode.jsonc.
   2. Run opencode service start.
   3. Run opencode reload (once or twice). It fails with ServiceUnavailableError: TypeError: o is not a function. (In 'o()', 'o' is an instance of Object). On dev the message reads cleanup is not a function.

   Once the plugin is removed from the config, the next reload works again. So, as a workaround, check your configured plugins for one whose setup returns an object, and update or remove it.

   Technically that plugin is breaking the contract (setup should return a cleanup function or nothing). Even so, one plugin shouldn't be able to break reload for everything. This is closely related to #57089 (a throwing plugin cleanup aborts the reload), which has an open PR, #57096.

   I haven't checked the separate opencode plugin update "Plugin is not configured" error here.

   Reproduction script (repro.sh)

   #!/usr/bin/env bash
   # Reproduces anomalyco/opencode#57719: `opencode reload` against the background
   # service fails with "TypeError: o is not a function" when a loaded plugin's
   # setup() returns a non-function value (an object) instead of a cleanup function.
   #
   # Usage: ./repro.sh                 # uses `opencode` from PATH (e.g. @opencode/cli@2.1.2)
   #        OC_DEV=/path/to/checkout ./repro.sh   # runs the CLI from source
   set -u
   export HOME=$(mktemp -d /tmp/opencode/oc57719-XXXX)
   PROJ="$HOME/proj"; mkdir -p "$PROJ" "$HOME/.config/opencode" "$HOME/objret"
   cd "$PROJ" && git init -q
   
   if [ -n "${OC_DEV:-}" ]; then
     oc() { bun --conditions=browser --preload="$OC_DEV/packages/tui/node_modules/@opentui/solid/scripts/preload.js" "$OC_DEV/packages/cli/src/index.ts" "$@"; }
   else
     oc() { opencode "$@"; }
   fi
   
   # A plugin whose setup() resolves to an object rather than a cleanup function.
   cat > "$HOME/objret/index.ts" <<'EOF'
   export default {
     id: "objret",
     async setup() {
       return { hooks: {} }
     },
   }
   EOF
   echo "{\"plugins\":[\"$HOME/objret\"]}" > "$HOME/.config/opencode/opencode.jsonc"
   
   oc --version
   if [ -n "${OC_DEV:-}" ]; then
     # From source, run the service in the foreground process (spawned children lack the preload).
     oc serve --service >"$HOME/serve.log" 2>&1 &
     SERVE_PID=$!; sleep 8
   else
     oc service start; sleep 5
   fi
   oc plugin list
   echo "--- reload #1 (activates the plugin if not yet active) ---"
   oc reload; echo "exit=$?"
   oc plugin list
   echo "--- reload #2 (tears down the active plugin generation) ---"
   oc reload; echo "exit=$?"
   # Change the config so the old plugin generation is torn down on reload.
   echo '{"plugins":[]}' > "$HOME/.config/opencode/opencode.jsonc"
   echo "--- reload after config change ---"
   oc reload; echo "exit=$?"
   grep -h "not a function" "$HOME"/.local/share/opencode/log/*.log | tail -3
   oc service stop >/dev/null 2>&1 || true
   [ -n "${SERVE_PID:-}" ] && kill "$SERVE_PID" 2>/dev/null || true

   Run it: bash repro.sh
2. opencode-agent

   added

   reproduced

   on Oct 21, 2026
3. holny commented on Oct 21, 2026

   

   holny

   on Oct 21, 2026

   Contributor

   More actions

   I'd like to take this. The bot's diagnosis matches the plugin teardown path: on reload the previous plugin generation is disposed and the value setup() returned is called as a cleanup function without checking that it actually is one, so a plugin whose setup() returns an object takes the whole reload down with it. I'll guard the teardown to only invoke function return values, add a test covering a plugin whose setup() returns a non-function, and base against origin/dev.