opencode-worker 0.1.4 → 0.1.5

package/README.md

@@ -14,7 +14,7 @@ A set-but-empty `--opencode-bin`/`OPENCODE_WORKER_BIN` fails with `BIN_EMPTY` in
 - `HOME` and `XDG_{CONFIG,DATA,CACHE,STATE}_HOME` point into `<dir>/.opencode-worker/`.
 - Generated config: `model` = `small_model` = requested model, `enabled_providers: ["opencode"]`, `permission.external_directory: "deny"`.
 - Models outside the `opencode` provider are rejected (`PROVIDER_NOT_ALLOWED`); there is no fallback.
-- Timeout (default 180 s): SIGTERM, then SIGKILL after 5 s.
+- Job timeout: default 900 s (15 min). Set it once per install with `OPENCODE_WORKER_TIMEOUT_SEC` (CLI and MCP server), or per job with `--timeout` / `worker_start.timeoutSec`. On expiry: SIGTERM, then SIGKILL after 5 s; an `alarm()` 10 s later also kills the worker if this process itself died.
 - Fixed flags: `run --pure --auto --format json --agent <agent> --model <model> --variant <variant>`.
 
 Defaults: model `opencode/deepseek-v4.1-flash-free`, variant `low`, agent `build`.
@@ -22,8 +22,9 @@ Defaults: model `opencode/deepseek-v4.1-flash-free`, variant `low`, agent `build
 ## CLI
 
 ```sh
-opencode-worker run --dir ./task --timeout 180 "Fix add() in calculator.py and run the tests"
-opencode-worker run --dir ./task -f prompt.md --variant high
+opencode-worker run --dir ./task "Fix add() in calculator.py and run the tests"
+opencode-worker run --dir ./task --timeout 1800 -f prompt.md --variant high
+OPENCODE_WORKER_TIMEOUT_SEC=1800 opencode-worker run --dir ./task "…"
 ```
 
 Exit codes: `0` ok, `1` worker failed (timeout, nonzero exit, error event, model mismatch), `2` usage/setup error.
@@ -58,19 +59,21 @@ Recommended flow: `worker_start` → `worker_wait` (repeat while it returns `sta
     "opencode-worker": {
       "command": "npx",
       "args": ["-y", "opencode-worker", "mcp"],
-      "env": { "OPENCODE_WORKER_BIN": "/path/to/opencode" }
+      "env": { "OPENCODE_WORKER_BIN": "/path/to/opencode", "OPENCODE_WORKER_TIMEOUT_SEC": "1800" }
     }
   }
 }
 ```
 
+`OPENCODE_WORKER_TIMEOUT_SEC` is optional (default 900); it is the job limit, independent of the per-call `worker_wait` limit.
+
 ### Client setup
 
 Claude Code (tools must be allowed in `-p` mode; put the prompt right after `-p`, because `--allowedTools` and `--mcp-config` are variadic and swallow trailing arguments):
 
 ```sh
-claude mcp add opencode-worker -e OPENCODE_WORKER_BIN=/path/to/opencode -- npx -y opencode-worker mcp
-claude -p "…" --allowedTools "mcp__opencode-worker__worker_start,mcp__opencode-worker__worker_status,mcp__opencode-worker__worker_result"
+claude mcp add opencode-worker -e OPENCODE_WORKER_BIN=/path/to/opencode -e OPENCODE_WORKER_TIMEOUT_SEC=1800 -- npx -y opencode-worker mcp
+claude -p "…" --allowedTools "mcp__opencode-worker__worker_start,mcp__opencode-worker__worker_wait,mcp__opencode-worker__worker_status,mcp__opencode-worker__worker_result"
 ```
 
 Codex (`~/.codex/config.toml`); without the approval mode, `codex exec` rejects MCP calls under `approval: never`:
@@ -79,7 +82,7 @@ Codex (`~/.codex/config.toml`); without the approval mode, `codex exec` rejects
 [mcp_servers.opencode-worker]
 command = "npx"
 args = ["-y", "opencode-worker", "mcp"]
-env = { OPENCODE_WORKER_BIN = "/path/to/opencode" }
+env = { OPENCODE_WORKER_BIN = "/path/to/opencode", OPENCODE_WORKER_TIMEOUT_SEC = "1800" }
 default_tools_approval_mode = "approve"
 ```
 

package/bin/opencode-worker.mjs

@@ -13,7 +13,7 @@ Options (run):
   --model <id>           default ${DEFAULTS.model} (provider must be one of ${DEFAULTS.providers.join(",")})
   --variant <v>          default ${DEFAULTS.variant}
   --agent <name>         default ${DEFAULTS.agent}
-  --timeout <sec>        default ${DEFAULTS.timeoutSec}
+  --timeout <sec>        default $OPENCODE_WORKER_TIMEOUT_SEC, else ${DEFAULTS.timeoutSec}
   --opencode-bin <path>  default $OPENCODE_WORKER_BIN, then PATH
   -f, --prompt-file <f>  Read prompt from file
 

package/lib/mcp.mjs

@@ -45,7 +45,7 @@ const runSchema = {
     model: { type: "string", description: `default ${DEFAULTS.model}` },
     variant: { type: "string", description: `default ${DEFAULTS.variant}` },
     agent: { type: "string", description: `default ${DEFAULTS.agent}` },
-    timeoutSec: { type: "number", description: `default ${DEFAULTS.timeoutSec}` },
+    timeoutSec: { type: "number", description: `Job time limit in seconds; omit to use the server default ($OPENCODE_WORKER_TIMEOUT_SEC, else ${DEFAULTS.timeoutSec})` },
   },
   required: ["dir", "prompt"],
 };

package/lib/worker.mjs

@@ -7,7 +7,7 @@ export const DEFAULTS = {
   model: "opencode/deepseek-v4.1-flash-free",
   variant: "low",
   agent: "build",
-  timeoutSec: 180,
+  timeoutSec: 900,
   providers: ["opencode"],
 };
 const STATE_DIR = ".opencode-worker";
@@ -132,6 +132,16 @@ function actualModels(stateRoot, sessionID) {
   });
 }
 
+/** Job timeout default: OPENCODE_WORKER_TIMEOUT_SEC if set, else DEFAULTS.timeoutSec. */
+export function defaultTimeoutSec() {
+  const raw = process.env.OPENCODE_WORKER_TIMEOUT_SEC;
+  if (raw === undefined) return DEFAULTS.timeoutSec;
+  const n = Number(raw);
+  if (raw.trim() === "" || !(Number.isFinite(n) && n > 0))
+    throw new WorkerError("BAD_CONFIG", `OPENCODE_WORKER_TIMEOUT_SEC must be a positive number of seconds, got '${raw}'`);
+  return n;
+}
+
 /**
  * Run one OpenCode worker task.
  * @param {{dir:string,prompt:string,model?:string,variant?:string,agent?:string,timeoutSec?:number,opencodeBin?:string,signal?:AbortSignal}} o
@@ -143,7 +153,8 @@ export async function runWorker(o) {
   const model = o.model ?? DEFAULTS.model;
   const variant = o.variant ?? DEFAULTS.variant;
   const agent = o.agent ?? DEFAULTS.agent;
-  const timeoutSec = o.timeoutSec ?? DEFAULTS.timeoutSec;
+  const timeoutSec = o.timeoutSec ?? defaultTimeoutSec();
+  if (!(Number.isFinite(timeoutSec) && timeoutSec > 0)) throw new WorkerError("BAD_ARGS", `timeoutSec must be a positive number, got ${o.timeoutSec}`);
   const provider = model.split("/")[0];
   if (!DEFAULTS.providers.includes(provider))
     throw new WorkerError("PROVIDER_NOT_ALLOWED", `provider '${provider}' not in ${JSON.stringify(DEFAULTS.providers)}`);

package/package.json

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