@rackbops/docket-types 0.9.0 → 0.11.0

package/dist/research-web.d.ts

@@ -0,0 +1,63 @@
+/**
+ * What a `web` first pass, and its reviewer, may use beyond the defaults (0.11.0, Rod's "add
+ * firecrawl" after comparing a research answer with a run through the Firecrawl tools): the
+ * Firecrawl MCP server's search and scrape. Only the web first pass gets them: a run on gathered
+ * pages (a `sent` request or a second pass) keeps `DEFAULT_ALLOWED_TOOLS` and its denials as in
+ * 0.10.0. The runner (Rackbops/docket-runner) holds the ceiling of tools a Job may name: these
+ * Jobs need runner 0.0.6 or later, whose ceiling admits the two names and which drops them when
+ * it has no Firecrawl key (the run then falls back to WebFetch). A runner older than that fails
+ * these Jobs (0.0.5 throws `ToolCeilingError`), so the runner is released first.
+ *
+ * The permission rules cannot see a tool's parameters, so nothing in the tool lists stops a
+ * scrape with a disguising proxy or of an eBay URL: `WEB_DISALLOWED_TOOLS` denies eBay to WebFetch
+ * only. The prompt is the control there (`firecrawlLines`, `firecrawlChecks`): `proxy: "basic"`
+ * always, one page at a time, and no eBay URL through any tool. The reviewer's eBay handling and
+ * the belt (`withBarredSites`) read the answer's addresses, so they apply whichever tool fetched
+ * the page.
+ */
+export declare const FIRECRAWL_TOOLS: readonly ["mcp__firecrawl__firecrawl_search", "mcp__firecrawl__firecrawl_scrape"];
+/** A `web` first pass's allowed tools (0.11.0): WebSearch, WebFetch, then `FIRECRAWL_TOOLS`. */
+export declare const WEB_ALLOWED_TOOLS: readonly string[];
+/** The research run's rules for the Firecrawl tools (0.11.0); a web first pass only. */
+export declare function firecrawlLines(): string[];
+/** The reviewer's rules for the Firecrawl tools (0.11.0); a web first pass only. */
+export declare function firecrawlChecks(): string[];
+/**
+ * BoardGameGeek's category rankings (0.11.0): the eight its own subdomains define, each a
+ * `familyids[0]` value on its advanced search. The ids were observed on boardgamegeek.com on
+ * 2026-10-18, not documented by BGG: a run that finds one wrong falls back to the category's
+ * own ranking page.
+ */
+export declare const BGG_CATEGORIES: readonly {
+    name: string;
+    familyId: number;
+}[];
+/**
+ * A BGG advanced search for one category's games of one year, best rated first, with at least
+ * 30 ratings and no expansions: the shape observed on 2026-10-18.
+ */
+export declare function bggCategoryUrl(familyId: number, year: number): string;
+/**
+ * The site's own categories (0.11.0, Rod's comparison with a run that used BGG's): where the
+ * question asks about categories and the best source defines its own, the answer uses that
+ * taxonomy and says so, rather than inventing genres or saying no source defines them. A category
+ * with no qualifying entry is answered "none yet", with why, never skipped. Every research run.
+ * A first pass's summary names every category's pick in one compact run (`COMPACT_RUN`;
+ * a second pass, `second`, names only the categories whose pick changed): `renderAnswer` fits the DM into
+ * `MAX_MESSAGE_CHARS` by dropping whole lines from the end, so a category answered only in a late
+ * finding can fall out of the DM; the summary comes first and is kept.
+ */
+export declare function categoryLines(second?: boolean): string[];
+/**
+ * The compact-run sentence (0.11.0): a first pass only. A second pass's summary says what
+ * changed and repeats nothing, so it names only the categories whose pick changed.
+ */
+export declare const COMPACT_RUN: string;
+/** The BGG search hint a web first pass may use (0.11.0), with the observed ids. */
+export declare function bggSearchHint(): string[];
+/**
+ * The reviewer's check of the site's own categories (0.11.0): an answer that invents categories
+ * where the best source defines them, or skips one with no qualifying entry, is revised.
+ */
+export declare function categoryChecks(): string[];
+//# sourceMappingURL=research-web.d.ts.map

package/dist/research-web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-web.d.ts","sourceRoot":"","sources":["../src/research-web.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,YAC1B,kCAAkC,EAClC,kCAAkC,CAC1B,CAAA;AAEV,gGAAgG;AAChG,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAAmD,CAAA;AAElG,wFAAwF;AACxF,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAUzC;AAED,oFAAoF;AACpF,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAQ1C;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EASvE,CAAA;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrE;AAQD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,MAAM,UAAQ,GAAG,MAAM,EAAE,CActD;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,QAGwC,CAAA;AAEhE,oFAAoF;AACpF,wBAAgB,aAAa,IAAI,MAAM,EAAE,CASxC;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAWzC"}

package/dist/research-web.js

@@ -0,0 +1,136 @@
+import { DEFAULT_ALLOWED_TOOLS } from "@rackbops/docket-core";
+/**
+ * What a `web` first pass, and its reviewer, may use beyond the defaults (0.11.0, Rod's "add
+ * firecrawl" after comparing a research answer with a run through the Firecrawl tools): the
+ * Firecrawl MCP server's search and scrape. Only the web first pass gets them: a run on gathered
+ * pages (a `sent` request or a second pass) keeps `DEFAULT_ALLOWED_TOOLS` and its denials as in
+ * 0.10.0. The runner (Rackbops/docket-runner) holds the ceiling of tools a Job may name: these
+ * Jobs need runner 0.0.6 or later, whose ceiling admits the two names and which drops them when
+ * it has no Firecrawl key (the run then falls back to WebFetch). A runner older than that fails
+ * these Jobs (0.0.5 throws `ToolCeilingError`), so the runner is released first.
+ *
+ * The permission rules cannot see a tool's parameters, so nothing in the tool lists stops a
+ * scrape with a disguising proxy or of an eBay URL: `WEB_DISALLOWED_TOOLS` denies eBay to WebFetch
+ * only. The prompt is the control there (`firecrawlLines`, `firecrawlChecks`): `proxy: "basic"`
+ * always, one page at a time, and no eBay URL through any tool. The reviewer's eBay handling and
+ * the belt (`withBarredSites`) read the answer's addresses, so they apply whichever tool fetched
+ * the page.
+ */
+export const FIRECRAWL_TOOLS = [
+    "mcp__firecrawl__firecrawl_search",
+    "mcp__firecrawl__firecrawl_scrape",
+];
+/** A `web` first pass's allowed tools (0.11.0): WebSearch, WebFetch, then `FIRECRAWL_TOOLS`. */
+export const WEB_ALLOWED_TOOLS = [...DEFAULT_ALLOWED_TOOLS, ...FIRECRAWL_TOOLS];
+/** The research run's rules for the Firecrawl tools (0.11.0); a web first pass only. */
+export function firecrawlLines() {
+    return [
+        "Read pages with WebFetch first. When a page refuses WebFetch (a 403, a block, a CAPTCHA " +
+            "or challenge page), read it with `firecrawl_scrape` instead. Always pass " +
+            '`proxy: "basic"` to it; never "stealth", "enhanced" or "auto", and nothing else that ' +
+            "disguises the request. Scrape one page at a time: never several pages of the same site " +
+            "in parallel. Never pass any eBay URL to any tool, Firecrawl included. You may use " +
+            "`firecrawl_search` as you would web search. If Firecrawl is refused too, the page did " +
+            "not open: handle it as a page that refused you, as above.",
+    ];
+}
+/** The reviewer's rules for the Firecrawl tools (0.11.0); a web first pass only. */
+export function firecrawlChecks() {
+    return [
+        "- To open a source, use WebFetch first; when a page refuses it (a 403, a block, a CAPTCHA), " +
+            'read it with `firecrawl_scrape`, always with `proxy: "basic"` (never "stealth", ' +
+            '"enhanced" or "auto", nothing that disguises the request), one page at a time, never ' +
+            "several pages of one site in parallel. Never pass any eBay URL to any tool. You may use " +
+            "`firecrawl_search` as you would web search.",
+    ];
+}
+/**
+ * BoardGameGeek's category rankings (0.11.0): the eight its own subdomains define, each a
+ * `familyids[0]` value on its advanced search. The ids were observed on boardgamegeek.com on
+ * 2026-10-18, not documented by BGG: a run that finds one wrong falls back to the category's
+ * own ranking page.
+ */
+export const BGG_CATEGORIES = [
+    { name: "Strategy", familyId: 5497 },
+    { name: "Family", familyId: 5499 },
+    { name: "Thematic", familyId: 5496 },
+    { name: "Party", familyId: 5498 },
+    { name: "Abstract", familyId: 4666 },
+    { name: "Customizable", familyId: 4667 },
+    { name: "Children's", familyId: 4665 },
+    { name: "Wargames", familyId: 4664 },
+];
+/**
+ * A BGG advanced search for one category's games of one year, best rated first, with at least
+ * 30 ratings and no expansions: the shape observed on 2026-10-18.
+ */
+export function bggCategoryUrl(familyId, year) {
+    return ("https://boardgamegeek.com/search/boardgame?sort=bggrating&advsearch=1" +
+        `&range[yearpublished][min]=${year}&range[yearpublished][max]=${year}` +
+        `&range[numvoters][min]=30&nosubtypes[0]=boardgameexpansion&familyids[0]=${familyId}`);
+}
+/** "Strategy", "Family", ... as one list in words. */
+function categoryNames() {
+    const names = BGG_CATEGORIES.map((c) => c.name);
+    return `${names.slice(0, -1).join(", ")} and ${names.at(-1)}`;
+}
+/**
+ * The site's own categories (0.11.0, Rod's comparison with a run that used BGG's): where the
+ * question asks about categories and the best source defines its own, the answer uses that
+ * taxonomy and says so, rather than inventing genres or saying no source defines them. A category
+ * with no qualifying entry is answered "none yet", with why, never skipped. Every research run.
+ * A first pass's summary names every category's pick in one compact run (`COMPACT_RUN`;
+ * a second pass, `second`, names only the categories whose pick changed): `renderAnswer` fits the DM into
+ * `MAX_MESSAGE_CHARS` by dropping whole lines from the end, so a category answered only in a late
+ * finding can fall out of the DM; the summary comes first and is kept.
+ */
+export function categoryLines(second = false) {
+    return [
+        'When the question asks about categories (or "each of the major" kinds of something) and ' +
+            "the best source defines its own categories, use that site's categories and say so" +
+            (second ? "" : " in the summary") +
+            "; do not invent genres, and do not say that no source defines them. For " +
+            `board games these are BoardGameGeek's ${BGG_CATEGORIES.length} category rankings: ` +
+            `${categoryNames()}. A category with no entry that qualifies is answered "none yet", ` +
+            "with the reason; never leave it out." +
+            (second
+                ? // A second pass's summary says what changed (research.ts), so no compact run here.
+                    " In this update, the summary names any category whose pick changed."
+                : ` ${COMPACT_RUN}`),
+    ];
+}
+/**
+ * The compact-run sentence (0.11.0): a first pass only. A second pass's summary says what
+ * changed and repeats nothing, so it names only the categories whose pick changed.
+ */
+export const COMPACT_RUN = "The summary itself names every category's pick in one compact run, such as \"Strategy: X; " +
+    "Family: Y; ...; Children's: none yet (no 2026 game has 30 ratings)\", so none is lost when " +
+    "a long answer is cut; the findings carry each pick's source.";
+/** The BGG search hint a web first pass may use (0.11.0), with the observed ids. */
+export function bggSearchHint() {
+    const ids = BGG_CATEGORIES.map((c) => `${c.name} ${c.familyId}`).join(", ");
+    return [
+        "A hint you may use: a BoardGameGeek advanced search shows one category for one year, such " +
+            `as ${bggCategoryUrl(5497, 2026)} (Strategy, 2026). ` +
+            `Change the year and the \`familyids[0]\` value for the category: ${ids}. These ids were ` +
+            "seen on the site, not documented by it: if one shows the wrong category, use that " +
+            "category's own ranking page.",
+    ];
+}
+/**
+ * The reviewer's check of the site's own categories (0.11.0): an answer that invents categories
+ * where the best source defines them, or skips one with no qualifying entry, is revised.
+ */
+export function categoryChecks() {
+    return [
+        "- Where the question asks about categories and the best source defines its own (for " +
+            `board games, BoardGameGeek's ${BGG_CATEGORIES.length}: ${categoryNames()}), the answer ` +
+            "uses them and says so. An answer that invents its own categories, or says no source " +
+            "defines them, while the source does, is `revise`d onto the source's categories. A " +
+            'category with no qualifying entry is answered "none yet" with the reason, never left ' +
+            "out: `revise` an answer that skips one. The summary names every category's pick in " +
+            'one compact run ("Strategy: X; Family: Y; ..."), since the findings may be cut from ' +
+            "the DM: `revise` a summary that leaves a category to the findings alone.",
+    ];
+}
+//# sourceMappingURL=research-web.js.map

package/dist/research-web.js.map

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

package/dist/research.d.ts

@@ -25,7 +25,7 @@ import { type GatheredPage, type ReadSources } from "./research-sources.js";
  * and tells the owner so, and so does a host that cannot read them.
  *
  * **A second pass on pages the run could not open** (0.9.0): a research run lists in `blocked` the
- * pages it needed and could not open (BoardGameGeek refuses the runner; eBay is never opened). When
+ * pages it needed and could not open (a BoardGameGeek page that refused it; eBay, never opened). When
  * the reviewed answer passes, the research run's own draft lists any, the request is a `web` one,
  * and the host can read gathered pages (`readSources`), the owner gets the answer now with a short
  * "Couldn't open:" list. With at least `MIN_SOURCES_WAIT_MS` (an hour) before `sourcesExpiry` (14
@@ -39,6 +39,29 @@ import { type GatheredPage, type ReadSources } from "./research-sources.js";
  * `update` beside the first pass's. With no pages, past the deadline, or on a second-pass failure,
  * the task ends with one short line: the first answer stands, uncharged when no run was made.
  *
+ * **Every part of the question** (0.10.0): the research run splits the question into the parts it
+ * needs answered before it searches, a part another depends on first, and answers each or names it
+ * in `uncertain`; both reviewers never approve an answer that silently skips one (`partsLines`,
+ * `answerChecks`, `updateChecks`). Prompt only: the schemas and the DM are as they were.
+ *
+ * **The best source** (0.10.0): the research run names each part's reference site first
+ * (BoardGameGeek for board games, eBay for listings and prices). A web first pass and its reviewer
+ * open BoardGameGeek like any site; eBay no run opens (`WEB_DISALLOWED_TOOLS`; eBay's User
+ * Agreement, section 3 (automated access)). Where a fuller pass can follow (`canWait`: a web first
+ * pass with `readSources`), a best source not opened goes in `blocked`, the reviewer adds one the
+ * answer leans around, and the belt (`withBarredSites`) adds a barred site the answer or its draft
+ * names as unread; elsewhere `blocked` is never shown, so the runs name it in `uncertain`.
+ *
+ * **Firecrawl** (0.11.0): a web first pass and its reviewer may also use the Firecrawl MCP tools
+ * (`WEB_ALLOWED_TOOLS`, `research-web.ts`): WebFetch first, `firecrawl_scrape` with
+ * `proxy: "basic"` for a page that refuses it, one page at a time, never an eBay URL. The tool
+ * rules cannot see parameters, so the prompt is the control for the proxy and for eBay through
+ * Firecrawl. Runs on gathered pages keep their tools and denials.
+ *
+ * **The site's own categories** (0.11.0): a question about categories is answered in the best
+ * source's own taxonomy (BoardGameGeek's eight category rankings for board games), a category
+ * with no qualifying entry as "none yet"; the reviewer revises an answer that invents its own.
+ *
  * Failures (a usage limit never reaches `finish`: the dispatcher requeues the run):
  *
  * - `schema_miss`, a malformed answer, `timeout`, `error`: retried once in the same phase, at once.
@@ -129,12 +152,22 @@ export declare function draftJson(draft: ResearchAnswer): string;
  * second pass (0.9.0): the answer already sent goes in as escaped JSON between markers, and the
  * run answers with only what the pages add or correct.
  */
-export declare function researchJob(config: ResearchConfig, pages?: readonly GatheredPage[], earlier?: ResearchAnswer): JobSpec;
+export declare function researchJob(config: ResearchConfig, pages?: readonly GatheredPage[], earlier?: ResearchAnswer, options?: ResearchJobOptions): JobSpec;
+/**
+ * What a prompt builder needs to know beyond the request (0.10.0). `canWait`: a fuller pass can
+ * follow this answer -- a `web` first pass whose host can read gathered pages -- so a best source
+ * the run could not open goes in `blocked`, which then starts the wait. Anywhere else `blocked` is
+ * never shown, so the run names the missing source in one short `uncertain` line instead.
+ * Ignored on gathered pages and on a second pass, which never wait.
+ */
+export interface ResearchJobOptions {
+    canWait?: boolean;
+}
 /**
  * The reviewer run: the question, and the draft as escaped JSON between markers; with `pages`
  * (`sources: "sent"`), the same gathered pages the research run had, to check its claims against.
  */
-export declare function reviewJob(config: ResearchConfig, draft: ResearchAnswer, pages?: readonly GatheredPage[], earlier?: ResearchAnswer): JobSpec;
+export declare function reviewJob(config: ResearchConfig, draft: ResearchAnswer, pages?: readonly GatheredPage[], earlier?: ResearchAnswer, options?: ResearchJobOptions): JobSpec;
 /**
  * The shortest wait for pages worth starting (0.9.0): with less than this before the expiry, a
  * person has no real chance to gather pages, so the answer goes out as it is.

package/dist/research.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../src/research.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../src/research.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,OAAO,EAIZ,KAAK,QAAQ,EACd,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAEL,KAAK,WAAW,EAQhB,KAAK,cAAc,EAIpB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,KAAK,YAAY,EAGjB,KAAK,WAAW,EAMjB,MAAM,uBAAuB,CAAA;AAU9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AAEH,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yFAAyF;IACzF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;CACzB;AAED,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAE/D;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,QAAQ,GAAG,gBAAgB,GAAG,MAAM,CAAA;AAE7E,gGAAgG;AAChG,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,aAAa,CAAA;IACpB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;IAC5B,iGAAiG;IACjG,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;IACZ,gFAAgF;IAChF,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;IACvB,iFAAiF;IACjF,OAAO,CAAC,EAAE,cAAc,CAAA;CACzB;AAED,eAAO,MAAM,kBAAkB,OAAO,CAAA;AACtC,eAAO,MAAM,iBAAiB,OAAO,CAAA;AACrC,iDAAiD;AACjD,eAAO,MAAM,SAAS,IAAI,CAAA;AAC1B,2DAA2D;AAC3D,eAAO,MAAM,aAAa,UAAY,CAAA;AAEtC;;;GAGG;AACH,eAAO,MAAM,kBAAkB,KAAK,CAAA;AACpC,eAAO,MAAM,uBAAuB,IAAI,CAAA;AACxC,+FAA+F;AAC/F,eAAO,MAAM,mBAAmB,SAAU,CAAA;AAC1C;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAA;AACjC,eAAO,MAAM,qBAAqB,MAAM,CAAA;AACxC,eAAO,MAAM,iBAAiB,SAAU,CAAA;AAyBxC;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAmB3D;AAaD,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAI9D;AAWD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAEvD;AA+BD;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,cAAc,EACtB,KAAK,CAAC,EAAE,SAAS,YAAY,EAAE,EAC/B,OAAO,CAAC,EAAE,cAAc,EACxB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CA0DT;AA2BD;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAyCD;;;GAGG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,cAAc,EACrB,KAAK,CAAC,EAAE,SAAS,YAAY,EAAE,EAC/B,OAAO,CAAC,EAAE,cAAc,EACxB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAiDT;AAwPD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,UAAY,CAAA;AAqI5C,MAAM,WAAW,eAAe;IAC9B,8FAA8F;IAC9F,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,eAAoB,GAAG,QAAQ,CAAC,cAAc,CAAC,CA+GpF;AAED,mEAAmE;AACnE,eAAO,MAAM,QAAQ,0BAAiB,CAAA"}

package/dist/research.js

@@ -1,6 +1,7 @@
 import { DEFAULT_ALLOWED_TOOLS, DEFAULT_DISALLOWED_TOOLS, defineTaskType, } from "@rackbops/docket-core";
 import { ANSWER_SCHEMA, clean, fitLines, fitMessage, parseAnswer, parseBlocked, parseReview, REVIEW_SCHEMA, renderAnswer, renderUpdate, } from "./research-answer.js";
-import { gatheredPages, pagesBlock, SENT_DISALLOWED_TOOLS, sourcesExpiry, } from "./research-sources.js";
+import { gatheredPages, pagesBlock, SENT_DISALLOWED_TOOLS, sourcesExpiry, uniqueBlocked, WEB_DISALLOWED_TOOLS, withBarredSites, } from "./research-sources.js";
+import { bggSearchHint, categoryChecks, categoryLines, firecrawlChecks, firecrawlLines, WEB_ALLOWED_TOOLS, } from "./research-web.js";
 /** True when `config` asks for gathered pages. */
 export function usesSentSources(config) {
     return typeof config.sources === "string" && config.sources.trim().toLowerCase() === "sent";
@@ -121,9 +122,19 @@ function earlierBlock(earlier) {
         "EARLIER>>>",
     ];
 }
-/** The runs' tool denials: the defaults, and BGG and eBay for a request on gathered pages. */
+/**
+ * The runs' tool denials: the defaults, and BGG and eBay for a run on gathered pages; eBay alone
+ * for a web first pass (0.10.0), which opens BoardGameGeek like any site.
+ */
 function disallowed(sent) {
-    return [...DEFAULT_DISALLOWED_TOOLS, ...(sent ? SENT_DISALLOWED_TOOLS : [])];
+    return [...DEFAULT_DISALLOWED_TOOLS, ...(sent ? SENT_DISALLOWED_TOOLS : WEB_DISALLOWED_TOOLS)];
+}
+/**
+ * The runs' allowed tools (0.11.0): a web first pass adds the Firecrawl tools; a run on gathered
+ * pages, or a second pass, keeps the defaults.
+ */
+function allowed(webFirst) {
+    return [...(webFirst ? WEB_ALLOWED_TOOLS : DEFAULT_ALLOWED_TOOLS)];
 }
 /**
  * The research run: the spike's prompt (docket-runner spike/cases.json, case `research`), with the
@@ -131,8 +142,10 @@ function disallowed(sent) {
  * second pass (0.9.0): the answer already sent goes in as escaped JSON between markers, and the
  * run answers with only what the pages add or correct.
  */
-export function researchJob(config, pages, earlier) {
+export function researchJob(config, pages, earlier, options = {}) {
+    const canWait = options.canWait === true && pages === undefined && earlier === undefined;
     const sent = pages !== undefined;
+    const webFirst = !sent && earlier === undefined;
     const prompt = [
         "You are researching a one-off question for a person, who will read your answer as a " +
             "Discord DM.",
@@ -149,6 +162,12 @@ export function researchJob(config, pages, earlier) {
                 "",
             ]
             : []),
+        ...partsLines(earlier !== undefined),
+        ...categoryLines(earlier !== undefined),
+        "",
+        ...bestSourceLines(sent, canWait),
+        ...(webFirst ? ["", ...firecrawlLines(), ...bggSearchHint()] : []),
+        "",
         "Use web search and fetch pages to check facts. Prefer primary sources (manufacturers, " +
             "government, utilities, standards bodies). Every claim that a reader might act on needs a " +
             "source you actually opened. Say plainly where sources disagree or where you are unsure.",
@@ -157,7 +176,9 @@ export function researchJob(config, pages, earlier) {
             "`summary` (the answer in at most 150 words), `findings` (each claim with the URLs you " +
             "opened for it) and `uncertain` (where sources disagree, or what you could not confirm).",
         "If a page you needed would not open (refused, a 403, a CAPTCHA, a sign-in wall), list it in " +
-            "`blocked` with its site, its URL if you have one, and why.",
+            "`blocked` with its site, its URL if you have one, and why." +
+            // `blocked` is shown only where a fuller pass can follow (0.10.0).
+            (canWait ? "" : " Name it in `uncertain` too: `blocked` is not shown."),
         ...(sent ? ["A gathered page counts as opened: cite its `url`."] : []),
         ...(earlier
             ? [
@@ -173,19 +194,82 @@ export function researchJob(config, pages, earlier) {
     return {
         prompt,
         jsonSchema: ANSWER_SCHEMA,
-        allowedTools: [...DEFAULT_ALLOWED_TOOLS],
+        allowedTools: allowed(webFirst),
         disallowedTools: disallowed(sent),
         maxTurns: RESEARCH_MAX_TURNS,
         maxBudgetUsd: RESEARCH_MAX_BUDGET_USD,
         timeoutMs: RESEARCH_TIMEOUT_MS,
     };
 }
+/**
+ * The research run's split of the question into parts (0.10.0): a question can imply more than one
+ * thing to find out, and one part can depend on another ("the best in each major category" needs
+ * the categories first). The answer covers every part, or says in `uncertain` which it could not
+ * settle. Prompt only: the summary and findings carry each part's answer, so the schema is as it
+ * was. On a second pass, a part the earlier answer left unsettled is what the pages may fill.
+ */
+function partsLines(second) {
+    return [
+        "Before you search, split the question into the parts it needs answered, including any " +
+            'list the question takes for granted. A part can depend on another: for "the best game ' +
+            'of the year in each major category", first establish what the major categories are, ' +
+            "then find the best in each. Settle the parts in that order, and answer every one: the " +
+            "summary answers each part, and the findings carry the claims behind each. A part you " +
+            "could not settle goes in `uncertain`, naming the part and why; never leave a part out " +
+            "silently.",
+        ...(second
+            ? [
+                "A part the earlier answer left unsettled (in its `uncertain`, or not at all) that the " +
+                    "pages settle is a new finding.",
+            ]
+            : []),
+    ];
+}
+/**
+ * The research run's best source (0.10.0, Rod's feedback on "I didn't check BoardGameGeek"): each
+ * part has a source its field treats as the reference, and the answer rests on it or says that
+ * the run could not open it: in `blocked` when a fuller pass can follow (`canWait`), so the
+ * person's browser can gather it, otherwise in one short `uncertain` line. A first pass on the
+ * web tries BoardGameGeek like any site (Rod, 2026-10-16); eBay no run opens. A run on gathered
+ * pages (`pages`: a `sent` request or a second pass) opens neither (`SENT_DISALLOWED_TOOLS`), and
+ * a gathered page counts as opened.
+ */
+function bestSourceLines(pages, canWait) {
+    return [
+        "For each part, decide first which source is the best one for it: the site people in that " +
+            "field treat as the reference (for board games, BoardGameGeek; for listings and sold " +
+            "prices, eBay; otherwise the maker, the standards body or the official record). The " +
+            "answer should rest on it.",
+        (pages
+            ? "BoardGameGeek and eBay are not opened from this run: do not try. When the best source " +
+                "is one of them and no gathered page is from it, or a page refused you (a 403, a " +
+                "CAPTCHA or challenge page, an empty or blocked body, a sign-in wall)"
+            : "Open BoardGameGeek like any other site: an ordinary read, with nothing that disguises " +
+                "the request; a page that refuses WebFetch gets one more try through " +
+                "`firecrawl_scrape`, as below (0.11.0). eBay is not opened from this run: do not try it. When the best source is " +
+                "eBay, or its page refused you (BoardGameGeek or any other: a 403, a CAPTCHA or " +
+                "challenge page, an empty or blocked body, a sign-in wall)") +
+            (canWait
+                ? ", list it in `blocked` with its site, its URL only when that is the page's real " +
+                    "address (such as BoardGameGeek's ranking or browse page), never a guessed one, and " +
+                    "why; then answer from the best sources you could open. Never write in `summary` or " +
+                    '`uncertain` that you "didn\'t check" it: `blocked` is where that goes, and the ' +
+                    "person's own browser can gather it for a fuller pass."
+                : ", answer from the best sources you could open and name the missing source in one " +
+                    "short `uncertain` line, such as " +
+                    (pages
+                        ? '"BoardGameGeek was not among the pages read"'
+                        : '"BoardGameGeek refused the request, so its ranking is not used"') +
+                    ": no fuller pass follows this answer, so that line is how the person learns of it."),
+    ];
+}
 /**
  * The reviewer run: the question, and the draft as escaped JSON between markers; with `pages`
  * (`sources: "sent"`), the same gathered pages the research run had, to check its claims against.
  */
-export function reviewJob(config, draft, pages, earlier) {
+export function reviewJob(config, draft, pages, earlier, options = {}) {
     const sent = pages !== undefined;
+    const canWait = options.canWait === true && !sent && earlier === undefined;
     const prompt = [
         earlier
             ? "You are reviewing an update to a research answer before it is sent to a person as a " +
@@ -215,26 +299,36 @@ export function reviewJob(config, draft, pages, earlier) {
                     "gathered pages cannot be checked: move it to `uncertain`.",
             ]
             : []),
-        ...(earlier ? updateChecks() : answerChecks()),
+        ...(earlier ? updateChecks() : [...answerChecks(), ...categoryChecks()]),
+        ...(earlier || sent ? [] : [...bestSourceChecks(canWait), ...firecrawlChecks()]),
         "",
-        "Then give a verdict: `approve` if the draft stands as is (return it unchanged in " +
-            "`answer`); `revise` if it stands once corrected (return the corrected answer in " +
-            "`answer`); `reject` if editing cannot fix it. List each problem you found in " +
+        "Then give a verdict: `approve` if the draft stands as is and covers every part (return it " +
+            "unchanged in `answer`); `revise` if it stands once corrected (return the corrected " +
+            "answer in `answer`); `reject` if editing cannot fix it. List each problem you found in " +
             "`problems`, one line each.",
     ].join("\n");
     return {
         prompt,
         jsonSchema: REVIEW_SCHEMA,
-        allowedTools: [...DEFAULT_ALLOWED_TOOLS],
+        allowedTools: allowed(!sent && earlier === undefined),
         disallowedTools: disallowed(sent),
         maxTurns: REVIEW_MAX_TURNS,
         maxBudgetUsd: REVIEW_MAX_BUDGET_USD,
         timeoutMs: REVIEW_TIMEOUT_MS,
     };
 }
-/** The reviewer's checks of a full answer: the spike's, unchanged. */
+/**
+ * The reviewer's checks of a full answer: the spike's, after the parts check (0.10.0), which
+ * comes first so the rest is checked against what the question asked.
+ */
 function answerChecks() {
     return [
+        "- First work out the parts the question implies, including any list it takes for granted: " +
+            '"the best in each of the major categories" means naming the major categories, then ' +
+            "answering for each one. The answer covers every part, in the summary or the findings, " +
+            "or names it in `uncertain` with why it could not be settled. An answer that silently " +
+            "skips a part is never approved: `revise` it, filling the part from the sources (or " +
+            "naming it in `uncertain` when they cannot settle it), or `reject` it.",
         "- Open the sources behind every claim a reader might act on, and confirm each one says what " +
             "the claim says. A claim its sources do not support is corrected, moved to `uncertain`, or " +
             "removed.",
@@ -243,13 +337,51 @@ function answerChecks() {
     ];
 }
 /**
- * The reviewer's checks of a second pass (0.9.0): the draft is an update to the earlier answer,
- * so it should hold only new findings and corrections.
+ * The reviewer's best-source checks of a first pass on the web (0.10.0), which may open
+ * BoardGameGeek like the research run. An answer that leans on secondary sources while the best
+ * one is neither cited nor said to be missing is revised: with `canWait`, to list it in `blocked`,
+ * so the person's browser can gather it; otherwise to name it in one short `uncertain` line, since
+ * `blocked` is never shown there. A claim resting only on an eBay address moves to `uncertain`,
+ * whichever tool listed or fetched it (no run may open eBay; 0.11.0 names Firecrawl too). Not asked on
+ * gathered pages (their own checks cover BGG and eBay) nor of an update.
+ */
+function bestSourceChecks(canWait) {
+    return [
+        "- Name the best source for each part: the site its field treats as the reference (for " +
+            "board games, BoardGameGeek; for listings and sold prices, eBay). If the answer leans on " +
+            "secondary sources while that source is neither among its findings' sources nor " +
+            (canWait
+                ? "in `blocked`, the verdict is `revise`: add it to `blocked` (its site, its URL only " +
+                    "when that is the page's real address, such as BoardGameGeek's ranking or browse " +
+                    "page, never a guessed one, and why) and keep the answer from the sources it has."
+                : "named in `uncertain`, the verdict is `revise`: add one short `uncertain` line naming " +
+                    "it, and keep the answer from the sources it has."),
+        "- You may open BoardGameGeek like any site. eBay is never opened by these runs, through " +
+            "any tool (WebFetch, Firecrawl or another): a claim resting only on an eBay address, " +
+            "whichever tool listed or fetched it, is not one an answer may rest on, so move it to " +
+            "`uncertain`.",
+        ...(canWait
+            ? [
+                "- A page that refused is not read, so a claim must not say a source was checked " +
+                    "unless a finding cites it. A line saying a source was not checked (\"I didn't " +
+                    'check BoardGameGeek") is no answer: move it to `blocked` on a `revise`.',
+            ]
+            : []),
+    ];
+}
+/**
+ * The reviewer's checks of a second pass (0.9.0; the parts check 0.10.0): the draft is an update
+ * to the earlier answer, so it should hold only new findings and corrections.
  */
 function updateChecks() {
     return [
         "- The draft is an update to the earlier answer: it should hold only new findings and " +
             "corrections to the earlier answer.",
+        "- Work out the parts the question implies, as for a full answer, including any list it " +
+            "takes for granted. Where the earlier answer left a part unsettled (in its `uncertain`, " +
+            "or not at all) and the pages settle it, the update fills it. An update that silently " +
+            "skips such a part is never approved: `revise` it, filling the part from the pages, or " +
+            "`reject` it.",
         "- Each new claim is supported by the source it cites. A claim its source does not support " +
             "is corrected, moved to `uncertain`, or removed.",
         '- A claim starting "Correction:" really corrects a claim the earlier answer made, and its ' +
@@ -354,8 +486,7 @@ function afterReview(ctx, state, output, canWait) {
         ...(f.sources[0] ? { source: f.sources[0] } : {}),
         tags: ["research", review.verdict],
     }));
-    // The research run's own list: a reviewer cannot start a wait, nor stop one, by what it returns.
-    const blocked = canWait ? (state.draft?.blocked ?? []) : [];
+    const blocked = canWait ? blockedAfterReview(state, review, answer) : [];
     if (blocked.length > 0) {
         const until = sourcesExpiry(ctx.now, deadlineOf(ctx.config)).at;
         if (until.getTime() - ctx.now.getTime() >= MIN_SOURCES_WAIT_MS) {
@@ -394,6 +525,18 @@ function afterReview(ctx, state, output, canWait) {
         summary: `${verdict}: ${n} finding(s)`,
     };
 }
+/**
+ * The pages the first pass waits for (0.10.0): the research run's own list, then any the reviewer
+ * added on a revise (a reviewer cannot stop a wait, and on approve, where the stored draft is what
+ * goes out, it cannot start one either), one entry per page (`uniqueBlocked`), then the belt's
+ * (`withBarredSites`), which also reads the draft, so a reviewer that rewords "I didn't check
+ * BoardGameGeek" away, or moves an eBay-only claim to `uncertain`, still leaves the wait.
+ */
+function blockedAfterReview(state, review, answer) {
+    const own = state.draft?.blocked ?? [];
+    const added = review.verdict === "revise" ? (review.answer?.blocked ?? []) : [];
+    return withBarredSites(answer, uniqueBlocked([...own, ...added]), state.draft);
+}
 /**
  * The shortest wait for pages worth starting (0.9.0): with less than this before the expiry, a
  * person has no real chance to gather pages, so the answer goes out as it is.
@@ -583,9 +726,12 @@ export function researchType(options = {}) {
             if (state.phase === "awaiting-pages")
                 return morePages(ctx, state);
             const sent = usesSentSources(ctx.config);
+            // A web first pass whose host can read gathered pages: a fuller pass can follow it.
+            const canWait = readSources !== undefined && !sent;
             if (state.phase === "review" && state.draft) {
-                if (!sent && state.pass !== 2)
-                    return reviewJob(ctx.config, state.draft);
+                if (!sent && state.pass !== 2) {
+                    return reviewJob(ctx.config, state.draft, undefined, undefined, { canWait });
+                }
                 const got = await pagesFor(ctx, state);
                 if ("outcome" in got)
                     return got;
@@ -596,7 +742,7 @@ export function researchType(options = {}) {
             if (deadline && ctx.now > deadline)
                 return { outcome: missed(ctx, deadline) };
             if (!sent)
-                return researchJob(ctx.config);
+                return researchJob(ctx.config, undefined, undefined, { canWait });
             const got = await pagesFor(ctx, state);
             return "outcome" in got ? got : researchJob(ctx.config, got.pages);
         },