opencode-worker 0.1.2 → 0.1.3

package/README.md

@@ -5,7 +5,8 @@ Run the official OpenCode CLI as an isolated, time-boxed worker. One package, tw
 - `opencode-worker run` — CLI, prints one JSON result
 - `opencode-worker mcp` — MCP stdio server (async jobs)
 
-No dependencies. Node ≥ 20. OpenCode is **not** bundled: pass `--opencode-bin`, set `OPENCODE_WORKER_BIN`, or have `opencode` on `PATH`.
+No dependencies. Node ≥ 20. OpenCode is **not** bundled: pass `--opencode-bin`, set `OPENCODE_WORKER_BIN`, or have `opencode` on `PATH` (checked in that order).
+A set-but-empty `--opencode-bin`/`OPENCODE_WORKER_BIN` fails with `BIN_EMPTY` instead of falling back to `PATH`; this usually means a shell variable was not expanded in your MCP config.
 
 ## Safety defaults
 

package/lib/worker.mjs

@@ -22,14 +22,20 @@ export class WorkerError extends Error {
 }
 
 export function resolveOpencodeBin(explicit) {
-  const candidates = [explicit, process.env.OPENCODE_WORKER_BIN].filter(Boolean);
-  for (const c of candidates) {
-    if (fs.existsSync(c)) return path.resolve(c);
-    throw new WorkerError("BIN_NOT_FOUND", `opencode binary not found: ${c}`);
+  const sources = [
+    ["--opencode-bin", explicit],
+    ["OPENCODE_WORKER_BIN", process.env.OPENCODE_WORKER_BIN],
+  ];
+  for (const [name, value] of sources) {
+    if (value === undefined || value === null) continue;
+    // A set-but-empty value is almost always an unexpanded shell variable; never fall back to PATH silently.
+    if (value.trim() === "") throw new WorkerError("BIN_EMPTY", `${name} is set but empty; give the absolute path to the opencode binary`);
+    if (!fs.existsSync(value)) throw new WorkerError("BIN_NOT_FOUND", `opencode binary not found at ${name}=${value}`);
+    return path.resolve(value);
   }
   const which = spawnSync("/usr/bin/env", ["which", "opencode"], { encoding: "utf8" });
   if (which.status === 0 && which.stdout.trim()) return which.stdout.trim();
-  throw new WorkerError("BIN_NOT_FOUND", "opencode not found (use --opencode-bin or OPENCODE_WORKER_BIN)");
+  throw new WorkerError("BIN_NOT_FOUND", "opencode not found on PATH (set OPENCODE_WORKER_BIN or --opencode-bin)");
 }
 
 function opencodeVersion(bin) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-worker",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Run the official OpenCode CLI as an isolated, time-boxed worker. CLI + MCP stdio server.",
   "repository": {
     "type": "git",