@wrenautomation/raven 0.8.3 → 0.10.0

package/LICENSE.md

@@ -1,6 +1,6 @@
-# PolyForm Shield License 1.0.0
+# PolyForm Strict License 1.0.0
 
-<https://polyformproject.org/licenses/shield/1.0.0>
+<https://polyformproject.org/licenses/strict/1.0.0>
 
 ## Acceptance
 
@@ -8,47 +8,23 @@ In order to get any license under these terms, you must agree to them as both st
 
 ## Copyright License
 
-The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose.  However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
-
-## Distribution License
-
-The licensor grants you an additional copyright license to distribute copies of the software.  Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
-
-## Notices
-
-You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software.  For example:
-
-> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
-
-## Changes and New Works License
-
-The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
+The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose, other than distributing the software or making changes or new works based on the software.
 
 ## Patent License
 
 The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
 
-## Noncompete
-
-Any purpose is a permitted purpose, except for providing any product that competes with the software or any product the licensor or any of its affiliates provides using the software.
+## Noncommercial Purposes
 
-## Competition
+Any noncommercial purpose is a permitted purpose.
 
-Goods and services compete even when they provide functionality through different kinds of interfaces or for different technical platforms.  Applications can compete with services, libraries with plugins, frameworks with development tools, and so on, even if they're written in different programming languages or for different computer architectures.  Goods and services compete even when provided free of charge.  If you market a product as a practical substitute for the software or another product, it definitely competes.
+## Personal Uses
 
-## New Products
+Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.
 
-If you are using the software to provide a product that does not compete, but the licensor or any of its affiliates brings your product into competition by providing a new version of the software or another product using the software, you may continue using versions of the software available under these terms beforehand to provide your competing product, but not any later versions.
+## Noncommercial Organizations
 
-## Discontinued Products
-
-You may begin using the software to compete with a product or service that the licensor or any of its affiliates has stopped providing, unless the licensor includes a plain-text line beginning with `Licensor Line of Business:` with the software that mentions that line of business.  For example:
-
-> Licensor Line of Business: YoyodyneCMS Content Management System (http://example.com/cms)
-
-## Sales of Business
-
-If the licensor or any of its affiliates sells a line of business developing the software or using the software to provide a product, the buyer can also enforce [Noncompete](#noncompete) for that product.
+Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.
 
 ## Fair Use
 
@@ -74,15 +50,9 @@ The first time you are notified in writing that you have violated any of these t
 
 The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
 
-A **product** can be a good or service, or a combination of them.
-
 **You** refers to the individual or entity agreeing to these terms.
 
-**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all its affiliates.
-
-**Affiliates** means the other organizations than an organization has control over, is under the control of, or is under common control with.
-
-**Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
+**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization.  **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
 
 **Your licenses** are all the licenses granted to you for the software under these terms.
 

package/README.md

@@ -12,11 +12,16 @@ 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. On the last round of the budget the edge is `stop` whatever the model says; its why says what the ask still lacks |
+| `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. The budget is shown, never enforced here: the runner parks past it |
 
 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
-learns. Raven never loops; the runner takes the edge.
+(prompts, sources, budget, and `age`: one sentence on how much a source's age counts). Copy one,
+tune it, keep it beside your ledger (`weaver learn`): that is where a run learns. Raven never
+loops; the runner takes the edge.
+
+Raven is the runner's planner. An agent that drives weaver's commands (`skills/birdwatch`) does
+raven's three decisions itself and uses raven for its types (`Ask`, `Plan`, `PlanFile`, the
+records), the merge of proposals, and the renderers.
 
 ## CLI
 
@@ -56,4 +61,4 @@ model's.
 
 ## License
 
-PolyForm Shield 1.0.0. Free to use, change and share; not to build a competing product.
+PolyForm Strict 1.0.0. Noncommercial use only; commercial use by license from Wren Automation.

package/dist/plans/index.d.ts

@@ -5,6 +5,6 @@
 import { type AskKind, type PlanFile } from "../types.js";
 /** The default plan file for a kind, validated, as a fresh copy. */
 export declare function defaultPlanFile(kind: AskKind): PlanFile;
-/** The plan file's word on age; a stored file from before version 4 takes its kind's default. */
+/** The plan file's word on age; a stored file from before version 4 takes its kind's default. Version 5: the review no longer says "at most". */
 export declare const ageOf: (planFile: PlanFile) => string | undefined;
 export declare const PLAN_KINDS: AskKind[];

package/dist/plans/index.js

@@ -33,7 +33,7 @@ Rules:
 - "why" is one short line a person reads to agree or not. On "again" it is what the next plan reads first.
 
 Ask: {ask}
-{steer}Round {round} of at most {rounds}. Hits {hits}, reads {reads}, findings proposed {proposed}, kept {kept}.
+{steer}Round {round}; the budget is {rounds} rounds, a guard rail (past it the runner parks and a person decides), not a stop rule. Hits {hits}, reads {reads}, findings proposed {proposed}, kept {kept}.
 Found (the source's date in brackets when it gives one):
 {found}
 Read (quality: rich, thin, off or empty; then the gap, what the ask still lacks):
@@ -47,7 +47,7 @@ Notes:
 const web = {
     id: "raven/web",
     kind: "web",
-    version: 4,
+    version: 5,
     propose: `You plan web searches for one research ask.
 
 ${SHAPE_QUERIES}
@@ -79,7 +79,7 @@ Hits:
 const video = {
     id: "raven/video",
     kind: "video",
-    version: 4,
+    version: 5,
     propose: `You plan video searches for one research ask: talks, walkthroughs, interviews and reviews on YouTube and podcast feeds.
 
 ${SHAPE_QUERIES}
@@ -111,7 +111,7 @@ Hits:
 const channel = {
     id: "raven/channel",
     kind: "channel",
-    version: 4,
+    version: 5,
     propose: `You plan searches that find the people and channels worth following for one research ask: creators, newsletters, podcasts, forums.
 
 ${SHAPE_QUERIES}
@@ -141,7 +141,7 @@ Hits:
 const person = {
     id: "raven/person",
     kind: "person",
-    version: 4,
+    version: 5,
     propose: `You plan searches about one person or company for one research ask: what they do, what they said, what others say about them.
 
 ${SHAPE_QUERIES}
@@ -173,7 +173,7 @@ Hits:
 const site = {
     id: "raven/site",
     kind: "site",
-    version: 4,
+    version: 5,
     propose: `You plan searches inside one website for one research ask. Every query runs on {site} only.
 
 ${SHAPE_QUERIES}
@@ -206,7 +206,7 @@ const DEFAULTS = { web, video, channel, person, site };
 export function defaultPlanFile(kind) {
     return PlanFileShape.parse(structuredClone(DEFAULTS[kind]));
 }
-/** The plan file's word on age; a stored file from before version 4 takes its kind's default. */
+/** The plan file's word on age; a stored file from before version 4 takes its kind's default. Version 5: the review no longer says "at most". */
 export const ageOf = (planFile) => planFile.age ?? DEFAULTS[planFile.kind].age;
 export const PLAN_KINDS = Object.keys(DEFAULTS);
 //# sourceMappingURL=index.js.map

package/dist/review.d.ts

@@ -1,8 +1,7 @@
 /**
- * After a round: stop, go again from plan, or back to one step. The round budget is a guard
- * 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.
+ * After a round: stop, go again from plan, or back to one step. The model decides and says why;
+ * the round budget is a guard rail it sees (`{round}` of `{rounds}`), never a stop rule. The
+ * runner takes the edge and parks past the budget; raven never loops.
  */
 import type { Model } from "@wrenautomation/models";
 import { type Edge, type PlanFile, type Round } from "./types.js";

package/dist/review.js

@@ -26,20 +26,9 @@ 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 = {}) {
     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}): ${out.why}`,
-            from: "ai",
-            by: model.id,
-        };
+    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,8 +1,8 @@
 {
   "name": "@wrenautomation/raven",
-  "version": "0.8.3",
+  "version": "0.10.0",
   "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",
+  "license": "PolyForm-Strict-1.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/wrenautomation/engine.git",
@@ -32,7 +32,7 @@
   "dependencies": {
     "commander": "15.0.0",
     "zod": "4.6.5",
-    "@wrenautomation/models": "0.8.3"
+    "@wrenautomation/models": "0.10.0"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",