@wrenautomation/birdwatch 0.0.0-stage → 0.30.0

package/dist/engine/judge.js

@@ -0,0 +1,323 @@
+/**
+ * The judge's passes: cheap typed answers on every hit, document and finding, written as
+ * `judge` records. A hint and a router, never a call: the brief ranks hits and shows class
+ * guesses by them, the tree counts a facet's needed classes by them before a read, and the
+ * check sends each finding the judge doubts to the model. A failed judge call writes its spend
+ * and the step goes on; a refused key ends the pass.
+ */
+import { choice, noul, top, } from "@wrenautomation/models/judge";
+import { bodyOf, contextOf } from "../document/index.js";
+import { SOURCE_CLASSES, } from "../ledger/records.js";
+import { kept } from "./state.js";
+/** Judge calls in flight at once. */
+export const JUDGE_PARALLEL = 8;
+/** A finding the judge backs under this goes to the model's check. */
+export const DOUBT = 0.8;
+/**
+ * Characters per judge call on a page read whole. Jev takes about 32k tokens of state (a 30k
+ * paper went in, 43k came back `max_tokens_exceeded`); 64k characters stays under it at 2
+ * characters a token.
+ */
+export const CHUNK = 64_000;
+/** Calls per page at most: a longer page is judged on its first `CHUNK * CHUNKS` characters. */
+export const CHUNKS = 4;
+const CLASS = choice("What kind of source is this page?", {
+    primary_data: "the party's own data: a filing, a public price page, a job ad, a dataset, a government statistic",
+    survey: "a survey or study of many respondents or firms",
+    practitioner: "one person who does the work, telling what they saw or did",
+    vendor: "a company writing about its own market, product or customers",
+    forum: "a forum thread or its comments: Reddit, a Facebook group, a Q&A site",
+    news: "a news or trade press article",
+    other: "anything else",
+});
+export const HIT_QUESTIONS = {
+    serves: noul("Could this page hold a specific fact (a number, a practice, a stated cause) that answers the ask?", {
+        true: "it likely holds such a fact",
+        false: "another topic, or nothing specific: a listicle, a directory, a sales page",
+    }),
+    side: choice("Who wrote this page, next to the people the ask is about?", {
+        subject: "those people, or a neutral party reporting on them",
+        seller: "a vendor, agency or coach selling to those people",
+        other: "neither, or it cannot tell",
+    }),
+    class: CLASS,
+};
+/**
+ * A trial (10-28): can Jev score a page's worth as a source before the extract reads it?
+ * A hint only; `judgeStats.worth` measures it against what the extract kept. From 0.25.0 it
+ * reads the whole page, in chunks, not the first 4,000 characters.
+ */
+export const DOCUMENT_QUESTIONS = {
+    class: CLASS,
+    worth: noul("Would a careful researcher answering the ask cite this page as a source?", {
+        true: "it gives specific facts on the ask (numbers, practices, causes, first-hand accounts) from a party in a position to know, or credits a named source for them",
+        false: "off the ask, thin, generic advice, a sales pitch, a rehash with no source, a list of links, or a page shell",
+    }),
+};
+export const FINDING_QUESTIONS = {
+    backs: noul("Does the quote, read in its context, say everything the sentence says? A plain rewording is fine.", {
+        true: "the quote backs every part of the sentence",
+        false: "the sentence says more than the quote (a number, a cause, a scope, a certainty, who says it), or the context turns the quote (a question, a hypothetical, an ad)",
+    }),
+    cites: noul("Does the quote or the text around it credit the fact to another named source: a survey, a study, a report, a dataset?"),
+};
+/** The names the judge asks on its own: a criterion may not take one. */
+export const RESERVED = new Set([
+    ...Object.keys(HIT_QUESTIONS),
+    ...Object.keys(DOCUMENT_QUESTIONS),
+    ...Object.keys(FINDING_QUESTIONS),
+]);
+/** The ask's criteria as yes-or-no questions, by name. */
+export const criteriaQuestions = (criteria) => Object.fromEntries((criteria ?? []).map((c) => [c.name, noul(c.question)]));
+/** The body in judge-sized parts, each cut at a paragraph when one is near the limit. */
+export function chunksOf(text) {
+    const out = [];
+    let rest = bodyOf(text);
+    while (rest.trim() && out.length < CHUNKS) {
+        if (rest.length <= CHUNK) {
+            out.push(rest);
+            break;
+        }
+        const cut = rest.lastIndexOf("\n\n", CHUNK);
+        const at = cut > CHUNK * 0.8 ? cut : CHUNK;
+        out.push(rest.slice(0, at));
+        rest = rest.slice(at);
+    }
+    return out;
+}
+/**
+ * One record's answers from its parts: a yes-or-no question takes the part most sure of a yes
+ * (a result sits in one section); a pick takes the first part's (the page's start says its kind).
+ */
+export function mergeAnswers(parts) {
+    const out = { ...parts[0] };
+    for (const part of parts.slice(1))
+        for (const [k, probs] of Object.entries(part)) {
+            const was = out[k];
+            if (!was)
+                out[k] = probs;
+            else if (probs.yes !== undefined && was.yes !== undefined && probs.yes > was.yes)
+                out[k] = probs;
+        }
+    return out;
+}
+/**
+ * One question set over many items, a few at a time; each item's answers one `judge` record.
+ * An item in parts (a long page) is asked part by part and written only when every part answered:
+ * a missing part would read as a no, so the next pass asks again.
+ */
+async function pass(ctx, items, questions) {
+    const out = { judged: 0, failed: 0 };
+    if (!ctx.deps.judge)
+        return out;
+    const askAll = async (x) => {
+        const parts = [];
+        let model = "";
+        for (const state of x.states) {
+            const g = await ctx.judge(x.on, x.about, state, questions);
+            if ("failure" in g)
+                return { failure: g.failure };
+            parts.push(g.answers);
+            model = g.model;
+        }
+        return { answers: mergeAnswers(parts), model };
+    };
+    for (let i = 0; i < items.length && !out.stopped; i += JUDGE_PARALLEL) {
+        const batch = items.slice(i, i + JUDGE_PARALLEL);
+        const got = await Promise.all(batch.map(askAll));
+        for (const [j, g] of got.entries()) {
+            const item = batch[j];
+            if ("failure" in g) {
+                out.failed++;
+                if (g.failure === "key")
+                    out.stopped = `the judge's key was refused`;
+                continue;
+            }
+            await ctx.write({ type: "judge", on: item.on, answers: g.answers }, { from: "ai", by: g.model });
+            out.judged++;
+        }
+    }
+    return out;
+}
+/** "jev: 12 judged, 1 failed" for a step's note, or nothing. */
+export const passNote = (p) => p.judged || p.failed
+    ? `; judge: ${p.judged} judged${p.failed ? `, ${p.failed} failed` : ""}${p.stopped ? ` (${p.stopped})` : ""}`
+    : "";
+/** Uncalled hits with no answers yet: serves the ask, whose side, what class, each criterion. */
+export function judgeHits(ctx, state) {
+    const ask = state.snapshot?.ask.text ?? "";
+    const whyOf = new Map(state.queries.map((q) => [q.id, q.why]));
+    const items = state.hits
+        .filter((h) => !state.judged.has(h.id) && !state.called.has(h.id))
+        .map((h) => ({
+        on: h.id,
+        about: h.url,
+        states: [
+            {
+                ask,
+                searched_for: [...new Set(h.queries.flatMap((q) => whyOf.get(q) ?? []))],
+                page: { url: h.url, title: h.title ?? "", snippet: h.snippet ?? "" },
+            },
+        ],
+    }));
+    return pass(ctx, items, { ...HIT_QUESTIONS, ...criteriaQuestions(state.snapshot?.ask.criteria) });
+}
+/** Documents with no answers yet: class, worth and each criterion, read whole in parts. */
+export function judgeDocuments(ctx, state) {
+    const ask = state.snapshot?.ask.text ?? "";
+    const items = state.documents
+        .filter((d) => !state.judged.has(d.id) && d.text.trim())
+        .map((d) => {
+        const parts = chunksOf(d.text);
+        return {
+            on: d.id,
+            about: d.url,
+            states: parts.map((text, i) => ({
+                ask,
+                url: d.url,
+                title: d.title ?? "",
+                ...(parts.length > 1 ? { part: `${i + 1} of ${parts.length}` } : {}),
+                text,
+            })),
+        };
+    });
+    return pass(ctx, items, {
+        ...DOCUMENT_QUESTIONS,
+        ...criteriaQuestions(state.snapshot?.ask.criteria),
+    });
+}
+/** Findings with a quote and no answers yet: does the quote back it, does it credit a source. */
+export function judgeFindings(ctx, state, findings) {
+    const docs = new Map(state.documents.map((d) => [d.id, d]));
+    const items = findings.flatMap((f) => {
+        const d = docs.get(f.document);
+        const quote = f.proof.quote;
+        if (!d || !quote || state.judged.has(f.id))
+            return [];
+        return [
+            {
+                on: f.id,
+                about: f.text,
+                states: [{ sentence: f.text, quote, context: contextOf(d.text, quote) }],
+            },
+        ];
+    });
+    return pass(ctx, items, FINDING_QUESTIONS);
+}
+/** The probability of a yes on one record's question, or undefined with no answer. */
+export const yesOf = (state, on, question) => state.judged.get(on)?.[question]?.yes;
+/** The judge's top label on a question, with its probability. */
+export function pickOf(state, on, question) {
+    const probs = state.judged.get(on)?.[question];
+    if (!probs)
+        return undefined;
+    const [pick, p] = top(probs);
+    return { pick, p };
+}
+/**
+ * A hit's class as best known: the agent's on its document, else the judge's on the document,
+ * else the judge's on the hit.
+ */
+export function classGuess(state, hit) {
+    const doc = state.documents.find((d) => d.hit === hit);
+    const agent = doc && state.classOf.get(doc.id);
+    if (agent)
+        return agent;
+    const guess = (doc && pickOf(state, doc.id, "class")) ?? pickOf(state, hit, "class");
+    return guess && SOURCE_CLASSES.includes(guess.pick)
+        ? guess.pick
+        : undefined;
+}
+/**
+ * How well a score ranks positives over negatives: the share of (positive, negative) pairs it
+ * orders right, ties a half. Null without both.
+ */
+export function aucOf(pairs) {
+    const pos = pairs.filter(([, y]) => y).map(([p]) => p);
+    const neg = pairs.filter(([, y]) => !y).map(([p]) => p);
+    if (!pos.length || !neg.length)
+        return null;
+    let sum = 0;
+    for (const a of pos)
+        for (const b of neg)
+            sum += a > b ? 1 : a === b ? 0.5 : 0;
+    return sum / (pos.length * neg.length);
+}
+/** What the judge did in a run and how often the deciders agreed with it. */
+export function judgeStats(state, judge) {
+    const ids = new Set(state.judges.map((j) => j.by));
+    const spends = state.spends.filter((s) => s.op === "ask" && (ids.has(s.source) || s.source === judge));
+    const tally = (pairs) => ({
+        both: pairs.length,
+        agree: pairs.filter(([a, b]) => a === b).length,
+    });
+    const hits = state.hits.flatMap((h) => {
+        const yes = yesOf(state, h.id, "serves");
+        const call = state.called.get(h.id);
+        return yes === undefined || !call ? [] : [[yes > 0.5, call === "keep"]];
+    });
+    const classes = state.documents.flatMap((d) => {
+        const guess = pickOf(state, d.id, "class");
+        const agent = state.classOf.get(d.id);
+        return !guess || !agent ? [] : [[true, guess.pick === agent]];
+    });
+    const lastCheck = new Map(state.checks.map((c) => [c.on, c.ok]));
+    const checks = [...lastCheck].flatMap(([on, ok]) => {
+        const yes = yesOf(state, on, "backs");
+        return yes === undefined ? [] : [[yes > 0.5, ok]];
+    });
+    const keptOn = new Set(state.findings.filter((f) => kept(state, f)).map((f) => f.document));
+    // Read for facts: an extract's verdict, a finding by hand, or a gap on the page.
+    const extracted = new Set([
+        ...state.verdicts.map((v) => v.document),
+        ...state.findings.map((f) => f.document),
+        ...state.gaps.flatMap((g) => (g.on ? [g.on] : [])),
+    ]);
+    // the last verdict per page: a rerun extract replaces the first
+    const quality = new Map(state.verdicts.map((v) => [v.document, v.quality]));
+    const hitOf = new Map(state.documents.map((d) => [d.id, d.hit]));
+    const scored = (name, on) => [...extracted].flatMap((d) => {
+        const id = on(d);
+        const yes = id === undefined ? undefined : yesOf(state, id, name);
+        return yes === undefined ? [] : [[yes, d]];
+    });
+    const ranked = (pairs) => ({
+        both: pairs.length,
+        auc: aucOf(pairs.map(([p, d]) => [p, keptOn.has(d)])),
+        rich: aucOf(pairs.flatMap(([p, d]) => (quality.has(d) ? [[p, quality.get(d) === "rich"]] : []))),
+    });
+    const worthPairs = scored("worth", (d) => d);
+    const worth = worthPairs.map(([p, d]) => [p, keptOn.has(d)]);
+    const under = worth.filter(([p]) => p < 0.5);
+    const criteria = Object.fromEntries((state.snapshot?.ask.criteria ?? []).map((c) => [
+        c.name,
+        {
+            hits: ranked(scored(c.name, (d) => hitOf.get(d))),
+            pages: ranked(scored(c.name, (d) => d)),
+        },
+    ]));
+    const doubted = [...lastCheck].filter(([on]) => (yesOf(state, on, "backs") ?? 1) < DOUBT);
+    return {
+        judge,
+        calls: spends.length,
+        failed: spends.filter((s) => !s.ok).length,
+        usd: spends.reduce((a, s) => a + (s.usd ?? 0), 0),
+        hits: tally(hits),
+        classes: tally(classes),
+        checks: {
+            ...tally(checks),
+            doubted: doubted.length,
+            doubtedFailed: doubted.filter(([, ok]) => !ok).length,
+        },
+        worth: {
+            both: worth.length,
+            good: worth.filter(([, y]) => y).length,
+            auc: aucOf(worth),
+            rich: ranked(worthPairs).rich,
+            under: under.length,
+            underGood: under.filter(([, y]) => y).length,
+        },
+        criteria,
+    };
+}
+//# sourceMappingURL=judge.js.map

package/dist/engine/judge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"judge.js","sourceRoot":"","sources":["../../src/engine/judge.ts"],"names":[],"mappings":"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"}

package/dist/engine/people.d.ts

@@ -0,0 +1,34 @@
+import type { PersonRecord } from "../ledger/records.js";
+import { type RunState } from "./state.js";
+/** A URL as a prefix key: host without www, path without its trailing slash, lower case. */
+export declare function profileKey(url: string): string | null;
+/** The latest record per name (case folded). */
+export declare function peopleOf(state: RunState): PersonRecord[];
+/** Each document's person, by follow, URL prefix, then channel name. */
+export declare function ownersOf(state: RunState): Map<string, PersonRecord>;
+export interface PersonView {
+    id: string;
+    name: string;
+    profiles: string[];
+    aka: string[];
+    why: string;
+    documents: number;
+    /** Kept findings on their documents. */
+    kept: number;
+    /** Distinct sites their documents sit on. */
+    sites: number;
+}
+/** People, most kept findings first. */
+export declare function peopleView(state: RunState): PersonView[];
+export interface Unfollowed {
+    document: string;
+    url: string;
+    title?: string;
+    channel?: string;
+    kept: number;
+}
+/**
+ * Kept pages no follow started from and no person owns: whose author's other posts and pages
+ * like it are still unseen. Most kept findings first.
+ */
+export declare function unfollowedOf(state: RunState): Unfollowed[];

package/dist/engine/people.js

@@ -0,0 +1,125 @@
+/**
+ * People across platforms: signals cluster in people, so a good page points at its author's
+ * other posts and profiles. The agent writes a `person` (profiles, names); a document is theirs
+ * when a follow from one of their profiles found it, when its URL sits under a profile, or when
+ * its channel is one of their names. The brief counts kept findings per person and lists the
+ * kept pages whose author no follow and no person covers yet.
+ */
+import { hostOf } from "../document/index.js";
+import { kept } from "./state.js";
+/** A URL as a prefix key: host without www, path without its trailing slash, lower case. */
+export function profileKey(url) {
+    try {
+        const u = new URL(url);
+        const host = u.hostname.toLowerCase().replace(/^www\./, "");
+        return `${host}${u.pathname.replace(/\/+$/, "").toLowerCase()}`;
+    }
+    catch {
+        return null;
+    }
+}
+/** The latest record per name (case folded). */
+export function peopleOf(state) {
+    const out = new Map();
+    for (const p of state.people)
+        out.set(p.name.toLowerCase(), p);
+    return [...out.values()];
+}
+/** A document's channel, else its hit's: a web opener knows none. */
+function channelsOf(state) {
+    const hits = new Map(state.hits.map((h) => [h.id, h.channel]));
+    const out = new Map();
+    for (const d of state.documents) {
+        const c = d.channel ?? hits.get(d.hit);
+        if (c)
+            out.set(d.id, c);
+    }
+    return out;
+}
+/** Each document's person, by follow, URL prefix, then channel name. */
+export function ownersOf(state) {
+    const people = peopleOf(state);
+    const keys = people.flatMap((p) => p.profiles.flatMap((u) => {
+        const k = profileKey(u);
+        return k ? [{ k, p }] : [];
+    }));
+    const channels = channelsOf(state);
+    const names = new Map(people.flatMap((p) => [p.name, ...p.aka].map((n) => [n.toLowerCase(), p])));
+    // A follow from a profile: its hits are the profile's posts.
+    const byQuery = new Map();
+    for (const q of state.queries) {
+        if (q.follow?.as !== "posts")
+            continue;
+        const k = profileKey(q.follow.url);
+        const fromDoc = q.follow.document
+            ? state.documents.find((d) => d.id === q.follow?.document)
+            : undefined;
+        const p = keys.find((x) => k && (k === x.k || k.startsWith(`${x.k}/`)))?.p ??
+            (fromDoc ? names.get(channels.get(fromDoc.id)?.toLowerCase() ?? "") : undefined);
+        if (p)
+            byQuery.set(q.id, p);
+    }
+    const queriesOfHit = new Map(state.hits.map((h) => [h.id, [...h.queries]]));
+    for (const f of state.founds)
+        queriesOfHit.get(f.hit)?.push(f.query);
+    const out = new Map();
+    for (const d of state.documents) {
+        const k = profileKey(d.url);
+        const p = (queriesOfHit.get(d.hit) ?? []).map((q) => byQuery.get(q)).find(Boolean) ??
+            keys.find((x) => k && (k === x.k || k.startsWith(`${x.k}/`)))?.p ??
+            names.get(channels.get(d.id)?.toLowerCase() ?? "");
+        if (p)
+            out.set(d.id, p);
+    }
+    return out;
+}
+/** People, most kept findings first. */
+export function peopleView(state) {
+    const owners = ownersOf(state);
+    return peopleOf(state)
+        .map((p) => {
+        const docs = state.documents.filter((d) => owners.get(d.id) === p);
+        const ids = new Set(docs.map((d) => d.id));
+        return {
+            id: p.id,
+            name: p.name,
+            profiles: p.profiles,
+            aka: p.aka,
+            why: p.why,
+            documents: docs.length,
+            kept: state.findings.filter((f) => ids.has(f.document) && kept(state, f)).length,
+            sites: new Set(docs.map((d) => hostOf(d.url))).size,
+        };
+    })
+        .sort((a, b) => b.kept - a.kept || a.name.localeCompare(b.name));
+}
+/**
+ * Kept pages no follow started from and no person owns: whose author's other posts and pages
+ * like it are still unseen. Most kept findings first.
+ */
+export function unfollowedOf(state) {
+    const owners = ownersOf(state);
+    const channels = channelsOf(state);
+    const followed = new Set(state.queries.flatMap((q) => q.follow ? [q.follow.document, profileKey(q.follow.url)].filter(Boolean) : []));
+    const keptOn = new Map();
+    for (const f of state.findings)
+        if (kept(state, f))
+            keptOn.set(f.document, (keptOn.get(f.document) ?? 0) + 1);
+    return state.documents
+        .filter((d) => {
+        const k = profileKey(d.url);
+        return (keptOn.get(d.id) && !owners.has(d.id) && !followed.has(d.id) && !(k && followed.has(k)));
+    })
+        .map((d) => {
+        const channel = channels.get(d.id);
+        return {
+            document: d.id,
+            url: d.url,
+            ...(d.title ? { title: d.title } : {}),
+            ...(channel ? { channel } : {}),
+            kept: keptOn.get(d.id) ?? 0,
+        };
+    })
+        .sort((a, b) => b.kept - a.kept);
+}
+//# sourceMappingURL=people.js.map

package/dist/engine/people.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"people.js","sourceRoot":"","sources":["../../src/engine/people.ts"],"names":[],"mappings":"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"}

package/dist/engine/plan.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The names a host needs to drive the engine: the plan file, the ask, the records' shapes. The
+ * model seam is `@wrenautomation/models`'. `From` and `Step` stay out: the ledger's are wider.
+ */
+export { ageOf, defaultPlanFile, PLAN_KINDS, rulesOf, TREE, treeOf } from "./plans/index.js";
+export { Ask, AskKind, Budget, Criterion, Edge, HitView, type HitViewIn, PlanFile, Query, QueryTree, Snapshot, TreeGuide, Verdict, YieldRow, } from "./types.js";

package/dist/engine/plan.js

@@ -0,0 +1,7 @@
+/**
+ * The names a host needs to drive the engine: the plan file, the ask, the records' shapes. The
+ * model seam is `@wrenautomation/models`'. `From` and `Step` stay out: the ledger's are wider.
+ */
+export { ageOf, defaultPlanFile, PLAN_KINDS, rulesOf, TREE, treeOf } from "./plans/index.js";
+export { Ask, AskKind, Budget, Criterion, Edge, HitView, PlanFile, Query, QueryTree, Snapshot, TreeGuide, Verdict, YieldRow, } from "./types.js";
+//# sourceMappingURL=plan.js.map

package/dist/engine/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/engine/plan.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC7F,OAAO,EACL,GAAG,EACH,OAAO,EACP,MAAM,EACN,SAAS,EACT,IAAI,EACJ,OAAO,EAEP,QAAQ,EACR,KAAK,EACL,SAAS,EACT,QAAQ,EACR,SAAS,EACT,OAAO,EACP,QAAQ,GACT,MAAM,YAAY,CAAC"}

package/dist/engine/plans/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The default plan file per ask kind. A copy of one, tuned and stored beside a ledger, is how
+ * a run learns: the recipe changes, the agent reads it. `birdwatch plans <kind>` prints one to start from.
+ */
+import { type AskKind, type PlanFile, type TreeGuide } from "../types.js";
+/**
+ * The five sides a researcher covers before the reads start. One tree per round; the agent
+ * fills each facet with tries, in order of what it expects to work.
+ */
+export declare const TREE: TreeGuide;
+/** 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. Version 5: the review no longer says "at most". Version 6: `tree`, the query tree's guide. 0.30.0 dropped the prompts with no bump: the agent never read them. */
+export declare const ageOf: (planFile: PlanFile) => string | undefined;
+/** The plan file's rules for the agent; a stored file from before 0.30.0 takes its kind's default. */
+export declare const rulesOf: (planFile: PlanFile) => string[];
+/** The plan file's guide for a query tree; a stored file from before version 6 takes its kind's default. */
+export declare const treeOf: (planFile: PlanFile) => TreeGuide;
+export declare const PLAN_KINDS: AskKind[];