@wrenautomation/raven 0.8.0 → 0.8.2

package/README.md

@@ -12,7 +12,7 @@ Three calls, one record each:
 |---|---|---|
 | `plan` | an ask (text, kind, what is known, what the person says: `steer`, rendered first in every prompt), proposals from people or other models, yield rows from earlier runs | a `Plan`: typed queries, each with `why`, `from` (ai or human) and `by` (model id, plan file or person), the sources it may use, the budget, and a snapshot of what raven was given |
 | `triage` | hits as a source shows them for free (title, channel, length, date, snippet, which sources returned it) | read or skip per hit; the model writes a why on a read only (a skip's is fixed text); the read budget caps it |
-| `review` | what a round came to (counts, found lines with their dates, the extractor's verdict and gap per read, the steps' gaps, the sample check, notes) | the edge: `stop`, `again` (a new round from plan) or `back` (rerun one step), with why |
+| `review` | what a round came to (counts, found lines with their dates, the extractor's verdict and gap per read, the steps' gaps, the sample check, notes) | the edge: `stop`, `again` (a new round from plan) or `back` (rerun one step), with why. On the last round of the budget the edge is `stop` whatever the model says; its why says what the ask still lacks |
 
 Ask kinds: `web`, `video`, `channel`, `person`, `site`. Each has a default plan file
 (prompts, sources, budget, and `age`: one sentence on how much a source's age counts). Copy one, tune it, keep it beside your ledger: that is where a run

package/dist/review.d.ts

@@ -1,7 +1,8 @@
 /**
  * After a round: stop, go again from plan, or back to one step. The round budget is a guard
- * rail, not a stop rule: when it is spent raven stops and says so; before that the model decides
- * and says why. The runner takes the edge; raven never loops.
+ * rail, not a stop rule: before it is spent the model decides and says why. On the last round
+ * the model still reads the round, so its why says what the ask still lacks, but the edge is
+ * stop whatever it answers. The runner takes the edge; raven never loops.
  */
 import type { Model } from "@wrenautomation/models";
 import { type Edge, type PlanFile, type Round } from "./types.js";

package/dist/review.js

@@ -26,17 +26,20 @@ export function reviewPrompt(round, planFile) {
         verdicts: lines(round.verdicts.map(verdictLine), "(none)"),
     });
 }
+/** Told to the model on the last round: its answer cannot be again or back. */
+const LAST = "This is the last round: the run stops whatever you answer. Answer stop, and in why say what the ask still lacks, or that it is answered.";
 export async function review(round, model, options = {}) {
-    if (round.round >= round.budget.rounds) {
+    const planFile = options.planFile ?? defaultPlanFile(round.ask.kind);
+    const last = round.round >= round.budget.rounds;
+    const shown = last ? { ...round, notes: [...round.notes, LAST] } : round;
+    const { value: out } = await model.ask(reviewPrompt(shown, planFile), EdgeAnswer);
+    if (last)
         return {
             next: "stop",
-            why: `round budget spent (${round.round} of ${round.budget.rounds})`,
+            why: `round budget spent (${round.round} of ${round.budget.rounds}): ${out.why}`,
             from: "ai",
-            by: "raven:budget",
+            by: model.id,
         };
-    }
-    const planFile = options.planFile ?? defaultPlanFile(round.ask.kind);
-    const { value: out } = await model.ask(reviewPrompt(round, planFile), EdgeAnswer);
     const edge = { next: out.next, why: out.why, from: "ai", by: model.id };
     if (out.next === "back")
         edge.to = out.to ?? "fetch";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrenautomation/raven",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "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": {
@@ -32,7 +32,7 @@
   "dependencies": {
     "commander": "15.0.0",
     "zod": "4.6.5",
-    "@wrenautomation/models": "0.8.0"
+    "@wrenautomation/models": "0.8.2"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",