@wrenautomation/raven 0.2.0 → 0.2.1

package/README.md

@@ -23,7 +23,8 @@ learns. Raven never loops; the runner takes the edge.
 Needs Node 24+. The model is a command that reads the prompt on stdin and prints the answer.
 Default `claude -p --output-format json`, so Claude Code is the model in any terminal and its
 envelope gives the cost per call; `RAVEN_MODEL` or `--model` changes it (plain text out is fine);
-`--no-model` plans from your own queries only.
+`--no-model` plans from your own queries only. A command that says nothing for 3 minutes is
+killed and the call fails with why.
 
 ```sh
 npm i @wrenautomation/raven

package/dist/model.d.ts

@@ -31,7 +31,9 @@ export declare function readOutput(stdout: string): {
 /**
  * A model that is a shell command: the prompt on stdin, the answer on stdout. When stdout is
  * Claude Code's JSON envelope (`claude -p --output-format json`) the usage comes with it.
+ * A command that says nothing for `timeoutMs` (3 minutes) is killed and the ask fails with
+ * why, so a hung model never hangs the run.
  */
-export declare function commandModel(command: string, id?: string): Model;
+export declare function commandModel(command: string, id?: string, timeoutMs?: number): Model;
 /** A model that answers from a fixed list, in order: tests and dry runs. */
 export declare function scriptedModel(answers: unknown[], id?: string): Model;

package/dist/model.js

@@ -72,17 +72,30 @@ export function readOutput(stdout) {
 /**
  * A model that is a shell command: the prompt on stdin, the answer on stdout. When stdout is
  * Claude Code's JSON envelope (`claude -p --output-format json`) the usage comes with it.
+ * A command that says nothing for `timeoutMs` (3 minutes) is killed and the ask fails with
+ * why, so a hung model never hangs the run.
  */
-export function commandModel(command, id = command) {
+export function commandModel(command, id = command, timeoutMs = 180_000) {
     return {
         id,
         ask: (prompt, shape) => new Promise((resolve, reject) => {
             const child = spawn(command, { shell: true, stdio: ["pipe", "pipe", "inherit"] });
             const out = [];
+            let timedOut = false;
+            const timer = setTimeout(() => {
+                timedOut = true;
+                child.kill();
+            }, timeoutMs);
             child.stdout.on("data", (b) => out.push(b));
-            child.on("error", reject);
+            child.on("error", (e) => {
+                clearTimeout(timer);
+                reject(e);
+            });
             child.on("close", (code) => {
+                clearTimeout(timer);
                 const stdout = Buffer.concat(out).toString("utf8");
+                if (timedOut)
+                    return reject(new Error(`${command}: no answer in ${Math.round(timeoutMs / 1000)}s`));
                 if (code !== 0)
                     return reject(new Error(`${command} exited ${code}: ${stdout.slice(0, 400)}`));
                 try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrenautomation/raven",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Ask in, plan out. The planner of Wren's research engine: typed queries with who proposed them and why, proposals merged into one plan under a plan file per ask kind, read-or-skip on hits, and the edge to take after a round. Pure functions and prompts; the model is injected.",
   "license": "PolyForm-Shield-1.0.0",
   "repository": {