@wrenautomation/birdwatch 0.29.0 → 0.30.1

package/dist/{plan → engine}/types.d.ts

@@ -1,8 +1,7 @@
 /**
- * The planner's shapes. A query says what to look for and who asked for it; a plan is the
- * queries of one round plus the sources and budget it runs under; a plan file is the tuned
- * recipe per ask kind. Hits are the engine's; the planner sees them through `HitView`, the fields a
- * source shows for free, because the engine depends on the planner and not the reverse.
+ * The ask and its plan file: what to look for, who asked, the tuned recipe per ask kind (sources,
+ * budget, tree guide). The agent plans; these are its shapes. `HitView` is a hit's free fields;
+ * the ledger's records extend these, so old ledgers still parse.
  */
 import { z } from "zod";
 export declare const AskKind: z.ZodEnum<{
@@ -13,7 +12,7 @@ export declare const AskKind: z.ZodEnum<{
     site: "site";
 }>;
 export type AskKind = z.infer<typeof AskKind>;
-/** Who wrote a record: a model, a plan file or a person. */
+/** Who wrote a record: the agent or a person. */
 export declare const From: z.ZodEnum<{
     ai: "ai";
     human: "human";
@@ -71,30 +70,6 @@ export declare const Query: z.ZodObject<{
     by: z.ZodString;
 }, z.core.$strip>;
 export type Query = z.infer<typeof Query>;
-/** Queries from one proposer. The model is one; a plan file, a teammate or a second model are others. */
-export declare const Proposal: z.ZodObject<{
-    from: z.ZodEnum<{
-        ai: "ai";
-        human: "human";
-    }>;
-    by: z.ZodString;
-    queries: z.ZodArray<z.ZodObject<{
-        kind: z.ZodEnum<{
-            video: "video";
-            channel: "channel";
-            web: "web";
-            person: "person";
-            site: "site";
-        }>;
-        why: z.ZodString;
-        site: z.ZodOptional<z.ZodString>;
-        terms: z.ZodString;
-        facet: z.ZodOptional<z.ZodString>;
-        tier: z.ZodOptional<z.ZodNumber>;
-        needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export type Proposal = z.infer<typeof Proposal>;
 /** One query as a leaf of the tree: what a person would type, and why. */
 export declare const Leaf: z.ZodObject<{
     terms: z.ZodString;
@@ -149,10 +124,9 @@ export declare const Budget: z.ZodObject<{
 }, z.core.$strip>;
 export type Budget = z.infer<typeof Budget>;
 /**
- * The recipe for one ask kind: the prompts, the sources it may use, the budget. Versioned and
- * tuned like an SOP, stored beside the ledger. `{name}` marks in a prompt are filled from the
- * ask: `{ask}`, `{known}`, `{yield}`, `{n}`, `{year}`, `{site}`, `{open}`, `{age}`; the review's
- * also `{gaps}` and `{checks}`.
+ * The recipe for one ask kind: the sources it may use, the budget, the tree guide. Versioned and
+ * tuned like an SOP, stored beside the ledger. A file from before 0.30.0 carries the old
+ * model planner's prompts: parsing drops them.
  */
 export declare const PlanFile: z.ZodObject<{
     id: z.ZodString;
@@ -164,9 +138,6 @@ export declare const PlanFile: z.ZodObject<{
         site: "site";
     }>;
     version: z.ZodNumber;
-    propose: z.ZodString;
-    triage: z.ZodString;
-    review: z.ZodString;
     sources: z.ZodArray<z.ZodString>;
     budget: z.ZodObject<{
         queries: z.ZodNumber;
@@ -175,6 +146,7 @@ export declare const PlanFile: z.ZodObject<{
         checks: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>;
     age: z.ZodOptional<z.ZodString>;
+    rules: z.ZodOptional<z.ZodArray<z.ZodString>>;
     tree: z.ZodOptional<z.ZodObject<{
         facets: z.ZodArray<z.ZodObject<{
             name: z.ZodString;
@@ -189,7 +161,7 @@ export declare const PlanFile: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type PlanFile = z.infer<typeof PlanFile>;
-/** What a source, channel or proposer yielded before. The planner reads it; wren or the files ledger writes it. */
+/** What a source, channel or proposer yielded before. The files ledger writes it. */
 export declare const YieldRow: z.ZodObject<{
     by: z.ZodOptional<z.ZodString>;
     source: z.ZodOptional<z.ZodString>;
@@ -207,7 +179,7 @@ export declare const YieldRow: z.ZodObject<{
     kept: z.ZodNumber;
 }, z.core.$strip>;
 export type YieldRow = z.infer<typeof YieldRow>;
-/** What the planner was given for one round: the RL state, kept with the plan. */
+/** What a round was planned from, kept with its snapshot. */
 export declare const Snapshot: z.ZodObject<{
     at: z.ZodString;
     known: z.ZodArray<z.ZodString>;
@@ -219,66 +191,6 @@ export declare const Snapshot: z.ZodObject<{
     yieldRows: z.ZodNumber;
 }, z.core.$strip>;
 export type Snapshot = z.infer<typeof Snapshot>;
-export declare const Plan: z.ZodObject<{
-    ask: z.ZodObject<{
-        text: z.ZodString;
-        kind: z.ZodEnum<{
-            video: "video";
-            channel: "channel";
-            web: "web";
-            person: "person";
-            site: "site";
-        }>;
-        known: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        premises: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        steer: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        open: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        criteria: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            name: z.ZodString;
-            question: z.ZodString;
-        }, z.core.$strip>>>;
-        site: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-    round: z.ZodNumber;
-    queries: z.ZodArray<z.ZodObject<{
-        kind: z.ZodEnum<{
-            video: "video";
-            channel: "channel";
-            web: "web";
-            person: "person";
-            site: "site";
-        }>;
-        terms: z.ZodString;
-        site: z.ZodOptional<z.ZodString>;
-        why: z.ZodString;
-        facet: z.ZodOptional<z.ZodString>;
-        tier: z.ZodOptional<z.ZodNumber>;
-        needs: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        from: z.ZodEnum<{
-            ai: "ai";
-            human: "human";
-        }>;
-        by: z.ZodString;
-    }, z.core.$strip>>;
-    sources: z.ZodArray<z.ZodString>;
-    budget: z.ZodObject<{
-        queries: z.ZodNumber;
-        reads: z.ZodNumber;
-        rounds: z.ZodNumber;
-        checks: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>;
-    snapshot: z.ZodObject<{
-        at: z.ZodString;
-        known: z.ZodArray<z.ZodString>;
-        planFile: z.ZodObject<{
-            id: z.ZodString;
-            version: z.ZodNumber;
-        }, z.core.$strip>;
-        model: z.ZodNullable<z.ZodString>;
-        yieldRows: z.ZodNumber;
-    }, z.core.$strip>;
-}, z.core.$strip>;
-export type Plan = z.infer<typeof Plan>;
 /** A hit as a source shows it for free: no read has happened. `sources` is every source that returned it. */
 export declare const HitView: z.ZodObject<{
     url: z.ZodString;
@@ -293,17 +205,6 @@ export declare const HitView: z.ZodObject<{
 export type HitView = z.infer<typeof HitView>;
 /** A hit as a caller may pass it: `sources` optional. */
 export type HitViewIn = z.input<typeof HitView>;
-export declare const Triage: z.ZodObject<{
-    url: z.ZodString;
-    read: z.ZodBoolean;
-    why: z.ZodString;
-    from: z.ZodEnum<{
-        ai: "ai";
-        human: "human";
-    }>;
-    by: z.ZodString;
-}, z.core.$strip>;
-export type Triage = z.infer<typeof Triage>;
 /** The extractor's word on one read document: how much of the ask it served, what is still missing. */
 export declare const Verdict: z.ZodObject<{
     url: z.ZodString;
@@ -316,63 +217,11 @@ export declare const Verdict: z.ZodObject<{
     gap: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type Verdict = z.infer<typeof Verdict>;
-/** What one round came to, as counts, verdicts and notes. The runner fills it; the planner reads it. */
-export declare const Round: z.ZodObject<{
-    ask: z.ZodObject<{
-        text: z.ZodString;
-        kind: z.ZodEnum<{
-            video: "video";
-            channel: "channel";
-            web: "web";
-            person: "person";
-            site: "site";
-        }>;
-        known: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        premises: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        steer: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        open: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        criteria: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            name: z.ZodString;
-            question: z.ZodString;
-        }, z.core.$strip>>>;
-        site: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-    round: z.ZodNumber;
-    budget: z.ZodObject<{
-        queries: z.ZodNumber;
-        reads: z.ZodNumber;
-        rounds: z.ZodNumber;
-        checks: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>;
-    hits: z.ZodNumber;
-    reads: z.ZodNumber;
-    proposed: z.ZodNumber;
-    kept: z.ZodNumber;
-    found: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    notes: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    verdicts: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        url: z.ZodString;
-        quality: z.ZodEnum<{
-            rich: "rich";
-            thin: "thin";
-            off: "off";
-            empty: "empty";
-        }>;
-        gap: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
-    gaps: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    checks: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    earlier: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        hits: z.ZodNumber;
-        kept: z.ZodNumber;
-    }, z.core.$strip>>>;
-}, z.core.$strip>;
-export type Round = z.infer<typeof Round>;
 export declare const Step: z.ZodEnum<{
-    triage: "triage";
-    read: "read";
     plan: "plan";
     fetch: "fetch";
+    triage: "triage";
+    read: "read";
     extract: "extract";
 }>;
 export type Step = z.infer<typeof Step>;
@@ -384,10 +233,10 @@ export declare const Edge: z.ZodObject<{
         back: "back";
     }>;
     to: z.ZodOptional<z.ZodEnum<{
-        triage: "triage";
-        read: "read";
         plan: "plan";
         fetch: "fetch";
+        triage: "triage";
+        read: "read";
         extract: "extract";
     }>>;
     why: z.ZodString;

package/dist/{plan → engine}/types.js

@@ -1,12 +1,11 @@
 /**
- * The planner's shapes. A query says what to look for and who asked for it; a plan is the
- * queries of one round plus the sources and budget it runs under; a plan file is the tuned
- * recipe per ask kind. Hits are the engine's; the planner sees them through `HitView`, the fields a
- * source shows for free, because the engine depends on the planner and not the reverse.
+ * The ask and its plan file: what to look for, who asked, the tuned recipe per ask kind (sources,
+ * budget, tree guide). The agent plans; these are its shapes. `HitView` is a hit's free fields;
+ * the ledger's records extend these, so old ledgers still parse.
  */
 import { z } from "zod";
 export const AskKind = z.enum(["web", "video", "channel", "person", "site"]);
-/** Who wrote a record: a model, a plan file or a person. */
+/** Who wrote a record: the agent or a person. */
 export const From = z.enum(["ai", "human"]);
 /**
  * One yes-or-no test a good source passes, named: the judge answers it on every hit and every
@@ -20,13 +19,13 @@ export const Criterion = z.object({
 export const Ask = z.object({
     text: z.string().min(1),
     kind: AskKind,
-    /** Facts already in hand, one line each: the planner looks past them. */
+    /** Facts already in hand, one line each: the plan looks past them. */
     known: z.array(z.string()).default([]),
     /** Lines taken as given with no source behind them: the plan tests each, never looks past it. */
     premises: z.array(z.string()).default([]),
-    /** What the person said along the way, one line each: every prompt renders it first. */
+    /** What the person said along the way, one line each: the brief shows it first. */
     steer: z.array(z.string()).default([]),
-    /** What the last round left open, one line each: its review's why, its gaps. The planner looks there first. */
+    /** What the last round left open, one line each: its edge's why, its gaps. The next plan looks there first. */
     open: z.array(z.string()).default([]),
     /** The person's tests of a good source; empty: none. */
     criteria: z.array(Criterion).default([]),
@@ -49,12 +48,6 @@ export const Query = z.object({
     /** Model id, plan file id or a person's name. */
     by: z.string(),
 });
-/** Queries from one proposer. The model is one; a plan file, a teammate or a second model are others. */
-export const Proposal = z.object({
-    from: From,
-    by: z.string(),
-    queries: z.array(Query.omit({ from: true, by: true })),
-});
 /** One query as a leaf of the tree: what a person would type, and why. */
 export const Leaf = z.object({
     terms: z.string().min(1),
@@ -83,36 +76,31 @@ export const TreeGuide = z.object({
     thin: z.number().int().nonnegative(),
 });
 export const Budget = z.object({
-    /** Queries per round after the merge. Human queries never count against it. */
+    /** Queries per round: a guard rail the brief shows, never a cap. */
     queries: z.number().int().positive(),
     /** Documents to read per round. */
     reads: z.number().int().positive(),
-    /** Rounds before `review` must stop. */
+    /** Rounds before a review should stop: a guard rail; past it the why says why. */
     rounds: z.number().int().positive(),
     /** Kept findings per round that a model checks against their document: a sample spread across the documents. 0: none. */
     checks: z.number().int().nonnegative().default(3),
 });
 /**
- * The recipe for one ask kind: the prompts, the sources it may use, the budget. Versioned and
- * tuned like an SOP, stored beside the ledger. `{name}` marks in a prompt are filled from the
- * ask: `{ask}`, `{known}`, `{yield}`, `{n}`, `{year}`, `{site}`, `{open}`, `{age}`; the review's
- * also `{gaps}` and `{checks}`.
+ * The recipe for one ask kind: the sources it may use, the budget, the tree guide. Versioned and
+ * tuned like an SOP, stored beside the ledger. A file from before 0.30.0 carries the old
+ * model planner's prompts: parsing drops them.
  */
 export const PlanFile = z.object({
     id: z.string().min(1),
     kind: AskKind,
     version: z.number().int().positive(),
-    /** Asks the model for queries. Must say to answer with `{"queries":[{"terms","why","site?"}]}`. */
-    propose: z.string().min(1),
-    /** Asks the model to read or skip each hit. Must say to answer with `{"hits":[{"url","read","why"}]}`. */
-    triage: z.string().min(1),
-    /** Asks the model which edge to take after a round. Must say to answer with `{"next","to?","why"}`. */
-    review: z.string().min(1),
     /** Source names a run may use, in order of preference. A run can narrow the list, never widen it. */
     sources: z.array(z.string()),
     budget: Budget,
-    /** How much a source's age counts for this kind, one sentence: filled as `{age}`. Never a cutoff. */
+    /** How much a source's age counts for this kind, one sentence the brief shows. Never a cutoff. */
     age: z.string().optional(),
+    /** What the agent heeds for this kind when it plans and triages, one line each. Absent: the kind's default. */
+    rules: z.array(z.string().min(1)).optional(),
     /** The facets a query tree of this kind covers. Absent on a file from before version 6: the kind's default. */
     tree: TreeGuide.optional(),
     /**
@@ -128,7 +116,7 @@ export const PlanFile = z.object({
     })
         .optional(),
 });
-/** What a source, channel or proposer yielded before. The planner reads it; wren or the files ledger writes it. */
+/** What a source, channel or proposer yielded before. The files ledger writes it. */
 export const YieldRow = z.object({
     by: z.string().optional(),
     source: z.string().optional(),
@@ -139,7 +127,7 @@ export const YieldRow = z.object({
     proposed: z.number().int().nonnegative(),
     kept: z.number().int().nonnegative(),
 });
-/** What the planner was given for one round: the RL state, kept with the plan. */
+/** What a round was planned from, kept with its snapshot. */
 export const Snapshot = z.object({
     at: z.string(),
     known: z.array(z.string()),
@@ -147,14 +135,6 @@ export const Snapshot = z.object({
     model: z.string().nullable(),
     yieldRows: z.number().int().nonnegative(),
 });
-export const Plan = z.object({
-    ask: Ask,
-    round: z.number().int().positive(),
-    queries: z.array(Query),
-    sources: z.array(z.string()),
-    budget: Budget,
-    snapshot: Snapshot,
-});
 /** A hit as a source shows it for free: no read has happened. `sources` is every source that returned it. */
 export const HitView = z.object({
     url: z.string().min(1),
@@ -166,50 +146,15 @@ export const HitView = z.object({
     date: z.string().optional(),
     snippet: z.string().optional(),
     sources: z.array(z.string()).default([]),
-    /** The judge's yes odds by question (serves, each criterion): a hint the triage prompt shows. */
+    /** The judge's yes odds by question (serves, each criterion): a hint the brief shows. */
     odds: z.record(z.string(), z.number()).optional(),
 });
-export const Triage = z.object({
-    url: z.string(),
-    read: z.boolean(),
-    /** The model's line on a read; a skip's is fixed text, so the model writes none. */
-    why: z.string(),
-    from: From,
-    by: z.string(),
-});
 /** The extractor's word on one read document: how much of the ask it served, what is still missing. */
 export const Verdict = z.object({
     url: z.string(),
     quality: z.enum(["rich", "thin", "off", "empty"]),
     gap: z.string().optional(),
 });
-/** What one round came to, as counts, verdicts and notes. The runner fills it; the planner reads it. */
-export const Round = z.object({
-    ask: Ask,
-    round: z.number().int().positive(),
-    budget: Budget,
-    hits: z.number().int().nonnegative(),
-    reads: z.number().int().nonnegative(),
-    proposed: z.number().int().nonnegative(),
-    kept: z.number().int().nonnegative(),
-    /** What the kept findings say, one line each: the planner sees what is answered. */
-    found: z.array(z.string()).default([]),
-    /** What went wrong or ran out, one line each. */
-    notes: z.array(z.string()).default([]),
-    /** The extractor's verdict on each document read this round: the planner sees what the reads were worth. */
-    verdicts: z.array(Verdict).default([]),
-    /** What a step or a person said the round lacks, one line each, the step or the person first. */
-    gaps: z.array(z.string()).default([]),
-    /** The sample check: whether each checked finding's quote backs it, one line each. */
-    checks: z.array(z.string()).default([]),
-    /** Each earlier round's new hits and kept findings: the review sees the trend, and decides. */
-    earlier: z
-        .array(z.object({
-        hits: z.number().int().nonnegative(),
-        kept: z.number().int().nonnegative(),
-    }))
-        .default([]),
-});
 export const Step = z.enum(["plan", "fetch", "triage", "read", "extract"]);
 /** The edge out of a round. `again` is a new round from `plan`; `back` reruns one step of this round. */
 export const Edge = z.object({

package/dist/engine/types.js.map

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

package/dist/index.d.ts

@@ -1,13 +1,13 @@
 /**
- * birdwatch: research from the open web, one step per command, every record in a ledger. Six
- * doors: `./engine` (the source port, registry, run state, the step table and the runner),
- * `./sources` (SearXNG, Exa, Google, arXiv, yt-dlp, the site readers, the fetcher, the ladder, a
- * paste, the ledger), `./ledger` (the records, a folder of JSON lines per run per writer, yield
- * rows), `./plan` (the ask, the plan file per ask kind, the planner's prompts), `./document`
- * (`Document`, `Finding`, `Proof`, readers by media, the claim extractor) and this root (the
- * engine's CLI commands, `addEngineCommands`, for a host that mounts them on its own program).
- * Reading the web and files is `@wrenautomation/read`'s; every model call goes through
- * `@wrenautomation/models`. Design: wren's `designs/2026-10-26-research-engine.md`.
+ * birdwatch: research from the open web, driven by an agent one step per command, every record
+ * in a ledger. Five doors: `./engine` (the ask and plan files, the source port, registry, run
+ * state, the steps and the agent commands), `./sources` (SearXNG, Exa, Google, arXiv, yt-dlp, the
+ * site readers, the fetcher, the ladder, a paste, the ledger), `./ledger` (the records, a folder of
+ * JSON lines per run per writer, yield rows), `./document` (`Document`, `Finding`, `Proof`, readers
+ * by media, the claim extractor) and this root (the engine's CLI commands, `addEngineCommands`,
+ * for a host that mounts them on its own program). Reading the web and files is
+ * `@wrenautomation/read`'s; every model call goes through `@wrenautomation/models`. Design: wren's
+ * `designs/2026-10-26-research-engine.md`.
  */
 export * from "./app/index.js";
 export * from "./engine/index.js";

package/dist/index.js

@@ -1,13 +1,13 @@
 /**
- * birdwatch: research from the open web, one step per command, every record in a ledger. Six
- * doors: `./engine` (the source port, registry, run state, the step table and the runner),
- * `./sources` (SearXNG, Exa, Google, arXiv, yt-dlp, the site readers, the fetcher, the ladder, a
- * paste, the ledger), `./ledger` (the records, a folder of JSON lines per run per writer, yield
- * rows), `./plan` (the ask, the plan file per ask kind, the planner's prompts), `./document`
- * (`Document`, `Finding`, `Proof`, readers by media, the claim extractor) and this root (the
- * engine's CLI commands, `addEngineCommands`, for a host that mounts them on its own program).
- * Reading the web and files is `@wrenautomation/read`'s; every model call goes through
- * `@wrenautomation/models`. Design: wren's `designs/2026-10-26-research-engine.md`.
+ * birdwatch: research from the open web, driven by an agent one step per command, every record
+ * in a ledger. Five doors: `./engine` (the ask and plan files, the source port, registry, run
+ * state, the steps and the agent commands), `./sources` (SearXNG, Exa, Google, arXiv, yt-dlp, the
+ * site readers, the fetcher, the ladder, a paste, the ledger), `./ledger` (the records, a folder of
+ * JSON lines per run per writer, yield rows), `./document` (`Document`, `Finding`, `Proof`, readers
+ * by media, the claim extractor) and this root (the engine's CLI commands, `addEngineCommands`,
+ * for a host that mounts them on its own program). Reading the web and files is
+ * `@wrenautomation/read`'s; every model call goes through `@wrenautomation/models`. Design: wren's
+ * `designs/2026-10-26-research-engine.md`.
  */
 export * from "./app/index.js";
 export * from "./engine/index.js";

package/dist/ledger/files.d.ts

@@ -1,4 +1,4 @@
-import { type AskKind, PlanFile } from "../plan/index.js";
+import { type AskKind, PlanFile } from "../engine/types.js";
 import { type Filter, type Ledger, type YieldFilter } from "./ledger.js";
 import { LedgerRecord } from "./records.js";
 /** A line the backend could not read: a partial last line from a killed writer, or a record it does not know. */

package/dist/ledger/files.js

@@ -6,7 +6,7 @@
  */
 import { appendFile, mkdir, readdir, readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";
-import { PlanFile } from "../plan/index.js";
+import { PlanFile } from "../engine/types.js";
 import { matches, yieldRows } from "./ledger.js";
 import { byTime, LedgerRecord } from "./records.js";
 const safe = (name) => name.replace(/[^A-Za-z0-9._-]+/g, "-");

package/dist/ledger/files.js.map

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

package/dist/ledger/ledger.d.ts

@@ -1,10 +1,10 @@
 /**
  * The ledger contract: four calls every backend answers. `append` one record; `trace` one run's
  * records in time order; `scan` records across runs by a filter; `yield` what sources, proposers,
- * channels and ask kinds yielded, as the planner's rows. The yield is a fold over records, shared here
+ * channels and ask kinds yielded, as the yield rows. The yield is a fold over records, shared here
  * so the files backend and a database compute the same rows (a database may do it in SQL).
  */
-import type { AskKind, PlanFile, YieldRow } from "../plan/index.js";
+import type { AskKind, PlanFile, YieldRow } from "../engine/types.js";
 import { type From, type LedgerRecord, type RecordOf, type RecordType, type Step } from "./records.js";
 export interface Filter {
     run?: string;