@rackbops/docket-types 0.8.0 → 0.10.0

package/dist/research-sources.js

@@ -1,5 +1,5 @@
 import { clean } from "@rackbops/docket-core";
-import { safeUrl } from "./research-answer.js";
+import { MAX_BLOCKED, safeUrl } from "./research-answer.js";
 /** Pages one request uses: the first this many usable ones, by address. */
 export const MAX_GATHERED_PAGES = 10;
 export const MAX_PAGE_TITLE_CHARS = 200;
@@ -8,8 +8,91 @@ export const MAX_PAGE_CHARS = 12_000;
 /** Text kept from all of a request's pages together; a page past it is cut, the rest dropped. */
 export const MAX_GATHERED_CHARS = 100_000;
 /**
- * What a run on gathered pages may not fetch: BoardGameGeek, which refuses the runner, and eBay,
- * which the tracker never opens. Claude Code permission rules (code.claude.com/docs/en/permissions,
+ * The sites a run on gathered pages never opens (0.10.0, one list for the tool denials, the
+ * de-duplication of `blocked` and the belt): BoardGameGeek, whose pages there come from the
+ * person's browser, and eBay, which the tracker never opens (eBay's User Agreement, section 3
+ * (automated access)). A first pass on the web opens BoardGameGeek like any site (Rod, 2026-10-16)
+ * and lists a refused page in `blocked`; it never opens eBay (`everywhere`). Each is the best
+ * source for its field (board games; listings and prices). Only fetches are denied: WebSearch has
+ * no domain filter, so a search may still list their pages. `domains` are the permission-rule
+ * hosts (each also as `*.host`); `host` tells a URL's hostname on the site; `names` are the ways
+ * text names it, as a pattern source.
+ */
+export const BARRED_SITES = [
+    {
+        site: "boardgamegeek.com",
+        domains: ["boardgamegeek.com", "geekdo.com"],
+        host: /(^|\.)(boardgamegeek|geekdo)\.com$/i,
+        names: "board\\s?game\\s?geek|bgg|geekdo",
+        everywhere: false,
+    },
+    {
+        site: "ebay.com",
+        domains: ["ebay.*", "ebay.co.*", "ebay.com.*"],
+        host: /(^|\.)ebay(\.[a-z]{2,3}){1,2}$/i,
+        names: "ebay",
+        everywhere: true,
+    },
+];
+/** Text that names the site `b`. */
+function namedIn(b) {
+    return new RegExp(`\\b(?:${b.names})\\b`, "i");
+}
+/** Up to three words between a site and what is said of it ("the BGG ranking page was"). */
+const GAP = "(?:[\\w'-]+[,):]?\\s+){0,3}";
+/**
+ * A verb for reading a source, in any of its forms. "use" and "see" are left out: "I didn't use
+ * the BGG weight" and "I didn't see anything on BGG suggesting a reprint" are not unread pages.
+ */
+const READ_VERB = "(?:(?:check|open|read|access|reach|load|consult|get|visit|fetch|look(?:\\s+at)?)" +
+    "(?:ed|ing|s)?|verif(?:y|ies|ied|ying)|retriev(?:e|es|ed|ing))";
+/** A negation before a reading verb: didn't, couldn't, haven't, unable to, not, without. */
+const NEG_BEFORE = "(?:(?:did|could|can|would|should|have|has|had|do|does) ?n[o']?t|cannot|(?:was|were) ?n[o']?t able to|" +
+    "unable to|never|not|without)\\s+(?:be(?:en)?\\s+able\\s+to\\s+)?";
+/** What a source did, or was not, after its name: refused, blocked, 403, not opened. */
+const FAILED_AFTER = "(?:refused|blocked|(?:was|were) blocked|returned (?:a |an )?(?:403|error)|403|forbidden|" +
+    "showed a captcha|captcha|required (?:a )?sign-?in|inaccessible|unavailable|unreachable|" +
+    "failed to (?:load|open)|timed out|(?:access )?(?:was )?denied|" +
+    "(?:could|can|did|would|was|were|is|are|has|have|had) ?n[o']?t (?:be(?:en)? )?" +
+    "(?:checked|opened|read|accessed|reached|loaded|load|open|consulted|used|available|reachable|accessible|" +
+    "looked at)|not (?:been )?(?:checked|opened|read|accessed|reached|loaded|consulted|" +
+    "available|reachable|accessible|looked at))\\b";
+/**
+ * The shapes in which a sentence says the site `b` was not read (0.10.0), with `’` read as `'`:
+ * a negated reading verb with the site as its object, a few words apart at most ("I didn't
+ * check BoardGameGeek", "without opening BGG", "unable to load the BGG page"); the site as the
+ * subject of a failure, a few words apart at most ("BGG refused the request", "the BoardGameGeek
+ * ranking was not checked", "eBay could not be opened"); or "no <site> data, ratings, rankings
+ * or results". A negation elsewhere in the sentence ("the game is not in print", "BGG users do
+ * not agree") is not one of them.
+ */
+function unreadShapes(b) {
+    const site = `(?:${b.names})(?:'s)?[,):]?`;
+    return [
+        new RegExp(`\\b${NEG_BEFORE}${READ_VERB}\\s+${GAP}${site}`, "i"),
+        new RegExp(`\\b${site}\\s+${GAP}${FAILED_AFTER}`, "i"),
+        new RegExp(`\\bno (?:${b.names})(?:'s)? (?:data|ratings?|rankings?|ranks?|scores?|results?)\\b`, "i"),
+    ];
+}
+/** The sentences of `text`, split at a stop, a semicolon or a line break; "e.g." and "i.e." are no stop. */
+function sentences(text) {
+    return text
+        .replace(/[\u2018\u2019]/g, "'")
+        .replace(/\b(e)\.(g)\.|\b(i)\.(e)\./gi, (_m, a, b, c, d) => `${a ?? c}${b ?? d}`)
+        .split(/(?<=[.!?;])\s+|\n/);
+}
+/** True when a sentence of `lines` says `b` was not read, in one of `unreadShapes`. */
+function saysUnread(b, lines) {
+    const shapes = unreadShapes(b);
+    return lines.flatMap(sentences).some((line) => shapes.some((r) => r.test(line)));
+}
+function barredDomains(everywhereOnly = false) {
+    return BARRED_SITES.filter((b) => !everywhereOnly || b.everywhere).flatMap((b) => b.domains.flatMap((d) => [d, `*.${d}`]));
+}
+/**
+ * What a run on gathered pages may not fetch: BoardGameGeek, whose pages there come from the
+ * person's browser, and eBay, which the tracker never opens (eBay's User Agreement, section 3
+ * (automated access)). Claude Code permission rules (code.claude.com/docs/en/permissions,
  * read 2026-10-13): `domain:host` matches that host only, `domain:*.host` any subdomain at any
  * depth, and a `*` elsewhere one label, so `ebay.*` is `ebay.fr` and `ebay.co.*` is `ebay.co.uk`.
  * Whether `*.ebay.*` (a leading and a later `*`) is accepted is inferred from that wording. Deny
@@ -17,18 +100,129 @@ export const MAX_GATHERED_CHARS = 100_000;
  * still list their pages; the run cannot open them there (a cache or proxy site could still serve
  * them: not covered).
  */
-export const SENT_DISALLOWED_TOOLS = [
-    "boardgamegeek.com",
-    "*.boardgamegeek.com",
-    "geekdo.com",
-    "*.geekdo.com",
-    "ebay.*",
-    "*.ebay.*",
-    "ebay.co.*",
-    "*.ebay.co.*",
-    "ebay.com.*",
-    "*.ebay.com.*",
-].map((host) => `WebFetch(domain:${host})`);
+export const SENT_DISALLOWED_TOOLS = barredDomains().map((host) => `WebFetch(domain:${host})`);
+/**
+ * What a web first pass, and its reviewer, may not fetch (0.10.0): eBay only (eBay's User
+ * Agreement, section 3 (automated access)). BoardGameGeek they open like any site, and list a page
+ * that refuses them in `blocked`.
+ */
+export const WEB_DISALLOWED_TOOLS = barredDomains(true).map((host) => `WebFetch(domain:${host})`);
+function hostOf(url) {
+    try {
+        return new URL(url).hostname;
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * A site name or host as one site: a barred site's own name for any of its aliases (BGG,
+ * BoardGameGeek, geekdo.com; eBay, ebay.co.uk), otherwise the text lower-cased without `www.`.
+ * Nothing else is merged: amazon.de and amazon.co.uk stay two sites.
+ */
+function siteOf(text) {
+    const t = text
+        .trim()
+        .toLowerCase()
+        .replace(/^www\./, "");
+    for (const b of BARRED_SITES)
+        if (b.host.test(t) || namedIn(b).test(t))
+            return b.site;
+    return t;
+}
+/** A URL as one page: its site (`siteOf` its host), then its path, with no query or end slash. */
+function pageOf(url) {
+    try {
+        const u = new URL(url);
+        return `${siteOf(u.hostname)}${u.pathname.replace(/\/+$/, "")}`;
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * The key one entry of `blocked` is told apart by (0.10.0): its page (`pageOf`) when it has a
+ * URL, so two pages on one site are two entries; its site (`siteOf`) when it has none.
+ */
+export function blockedKey(entry) {
+    return entry.url ? pageOf(entry.url) : siteOf(entry.site);
+}
+/** The sites an entry is on: its site's name, and its URL's host, each through `siteOf`. */
+function sitesOf(entry) {
+    const out = new Set([siteOf(entry.site)]);
+    if (entry.url)
+        out.add(siteOf(hostOf(entry.url)));
+    return out;
+}
+/**
+ * `entries` with one entry per page, at most `MAX_BLOCKED` (0.10.0). Two entries with one page
+ * (`blockedKey`) are one, the first kept. An entry with no URL merges into any entry on its site
+ * (`sitesOf`): after one, it is dropped; before one, the entry with the URL takes its place. So
+ * "BoardGameGeek" and a boardgamegeek.com page are one entry, and two BoardGameGeek pages are two.
+ */
+export function uniqueBlocked(entries) {
+    const out = [];
+    for (const e of entries) {
+        const key = blockedKey(e);
+        if (out.some((o) => o.url && blockedKey(o) === key))
+            continue;
+        if (!e.url) {
+            const site = siteOf(e.site);
+            if (out.some((o) => sitesOf(o).has(site)))
+                continue;
+        }
+        else {
+            const sites = sitesOf(e);
+            const bare = out.findIndex((o) => !o.url && sites.has(siteOf(o.site)));
+            if (bare >= 0) {
+                out[bare] = e;
+                continue;
+            }
+        }
+        if (out.length >= MAX_BLOCKED)
+            break;
+        out.push(e);
+    }
+    return out;
+}
+/** What the belt says of a barred site the answer leaves unread and unlisted. */
+export const NOT_OPENED_WHY = "not opened by the research run";
+/**
+ * The belt under the prompts (0.10.0): `blocked` with an entry `{site, why: NOT_OPENED_WHY}`, no
+ * URL, added for each site of `BARRED_SITES` the answer leaves unread without listing it. It reads
+ * the outgoing `answer` and the research run's own `draft`, so a reviewer's rewording or a claim
+ * moved to `uncertain` cannot hide it. A site counts as unread when a sentence of a summary or an
+ * uncertain line says so in one of `unreadShapes` ("I didn't check BoardGameGeek", "BGG refused
+ * the request", "no BGG ratings"); eBay, which no run opens, also when a finding of either rests
+ * only on eBay addresses (a search listing, never an opened page). A passing mention, or a
+ * negation that is not about the site, counts for neither. BoardGameGeek is left alone when a
+ * finding of the outgoing answer cites one of its pages (a web first pass may open it); eBay has
+ * no such exemption. An entry on the site, by its site's name or its URL's host (`sitesOf`: a
+ * "BoardGameGeek" entry with an archive.org URL counts), stops it; past `MAX_BLOCKED` nothing is
+ * added.
+ */
+export function withBarredSites(answer, blocked, draft) {
+    const out = [...blocked];
+    const lines = [answer.summary, ...answer.uncertain];
+    if (draft)
+        lines.push(draft.summary, ...draft.uncertain);
+    const findings = [...answer.findings, ...(draft?.findings ?? [])];
+    const cited = answer.findings.flatMap((f) => f.sources.map(hostOf));
+    for (const b of BARRED_SITES) {
+        if (out.length >= MAX_BLOCKED)
+            break;
+        const onlyOn = findings.some((f) => f.sources.length > 0 && f.sources.every((u) => b.host.test(hostOf(u))));
+        const unread = saysUnread(b, lines) || (b.everywhere && onlyOn);
+        if (!unread)
+            continue;
+        if (!b.everywhere && cited.some((h) => b.host.test(h)))
+            continue;
+        if (out.some((e) => sitesOf(e).has(b.site)))
+            continue;
+        out.push({ site: b.site, why: NOT_OPENED_WHY });
+    }
+    return out;
+}
 /** A page whose text would be cut shorter than this to fit the whole is dropped instead. */
 export const MIN_PAGE_CHARS = 200;
 /**
@@ -85,4 +279,30 @@ export function pagesBlock(pages) {
         "PAGES>>>",
     ];
 }
+/** The longest a request waits for gathered pages, in days. */
+export const SOURCES_WAIT_DAYS = 14;
+export const SOURCES_WAIT_MS = SOURCES_WAIT_DAYS * 24 * 60 * 60 * 1000;
+/**
+ * How long before its deadline a wait for pages ends when the deadline comes first: a research run
+ * makes no call once it starts past the deadline, and the execute tick picks a due run up within a
+ * minute or two, so a run queued at the deadline itself would always miss it.
+ */
+export const SOURCES_DEADLINE_MARGIN_MINUTES = 10;
+export const SOURCES_DEADLINE_MARGIN_MS = SOURCES_DEADLINE_MARGIN_MINUTES * 60 * 1000;
+/**
+ * When a wait for gathered pages begun at `now` ends if the pages never come: `SOURCES_WAIT_DAYS`
+ * out, or `SOURCES_DEADLINE_MARGIN_MINUTES` before the deadline when that is sooner (never before
+ * `now`). `byDeadline` says which. The tracker plugin's own copy (rackbops-bot-plugins
+ * `research-sources.ts`) moves here (0.9.0).
+ */
+export function sourcesExpiry(now, deadline) {
+    const wait = now.getTime() + SOURCES_WAIT_MS;
+    if (!deadline || deadline.getTime() - SOURCES_DEADLINE_MARGIN_MS >= wait) {
+        return { at: new Date(wait), byDeadline: false };
+    }
+    return {
+        at: new Date(Math.max(now.getTime(), deadline.getTime() - SOURCES_DEADLINE_MARGIN_MS)),
+        byDeadline: true,
+    };
+}
 //# sourceMappingURL=research-sources.js.map

package/dist/research-sources.js.map

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

package/dist/research.d.ts

@@ -1,5 +1,5 @@
 import { type JobSpec, type TaskType } from "@rackbops/docket-core";
-import { type ResearchAnswer } from "./research-answer.js";
+import { type BlockedPage, type ResearchAnswer } from "./research-answer.js";
 import { type GatheredPage, type ReadSources } from "./research-sources.js";
 /**
  * Category 5 (plan section 1.2 row 5): "look into X and report back once". Execute lane, a `once`
@@ -24,6 +24,34 @@ import { type GatheredPage, type ReadSources } from "./research-sources.js";
  * moves the run to now once the pages are in. A run that finds no usable page makes no model call
  * 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 (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
+ * days, or 10 minutes before a sooner deadline), the DM also says a fuller pass is queued, and the
+ * task waits (`awaiting-pages`) on a follow-up at that expiry, so the wait sends nothing, runs
+ * nothing and charges nothing; with less, the task ends there. The findings are saved either way.
+ * The host's `ready` (README: the contract) moves the once task to now and deletes that follow-up.
+ * Then a second research run gets the pages and the earlier answer and returns only new or
+ * corrected findings; its reviewer checks them as an update to the earlier answer, against the
+ * pages, and the owner gets an "Update to" DM (one line when it adds nothing), its findings tagged
+ * `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`.
+ *
  * 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.
@@ -52,13 +80,23 @@ export interface ResearchConfig {
 }
 /** True when `config` asks for gathered pages. */
 export declare function usesSentSources(config: ResearchConfig): boolean;
-export type ResearchPhase = "research" | "review" | "done";
+/**
+ * `awaiting-pages` (0.9.0): the first answer went out, and the task waits for gathered pages for a
+ * second pass; its run is the second pass's research run.
+ */
+export type ResearchPhase = "research" | "review" | "awaiting-pages" | "done";
 /** The current row: which run is next, how often it failed, and the draft once there is one. */
 export interface ResearchState {
     phase: ResearchPhase;
     /** Failed tries in the current phase. */
     failures: number;
     draft: ResearchAnswer | null;
+    /** Which pass (0.9.0): 2 once the second pass's research run has answered. Absent: the first. */
+    pass?: 1 | 2;
+    /** The pages the first pass could not open, as its research run listed them. */
+    blocked?: BlockedPage[];
+    /** The first pass's reviewed answer, as sent: what the second pass builds on. */
+    earlier?: ResearchAnswer;
 }
 export declare const MAX_QUESTION_CHARS = 1000;
 export declare const MAX_CONTEXT_CHARS = 2000;
@@ -85,7 +123,11 @@ export declare const RESEARCH_TIMEOUT_MS = 600000;
 export declare const REVIEW_MAX_TURNS = 8;
 export declare const REVIEW_MAX_BUDGET_USD = 0.5;
 export declare const REVIEW_TIMEOUT_MS = 300000;
-/** The state as stored, or a fresh one; a review phase with no readable draft starts over. */
+/**
+ * The state as stored, or a fresh one; a review phase with no readable draft starts over (in the
+ * second pass, from the wait for pages). A wait for pages with no readable earlier answer has
+ * nothing to build on, so it is done. A state stored before 0.9.0 reads as it did.
+ */
 export declare function researchState(value: unknown): ResearchState;
 /** The deadline as an instant, or null when there is none or it does not parse. */
 export declare function deadlineOf(config: ResearchConfig): Date | null;
@@ -96,14 +138,31 @@ export declare function deadlineOf(config: ResearchConfig): Date | null;
 export declare function draftJson(draft: ResearchAnswer): string;
 /**
  * The research run: the spike's prompt (docket-runner spike/cases.json, case `research`), with the
- * gathered pages when `pages` is given (`sources: "sent"`).
+ * gathered pages when `pages` is given (`sources: "sent"`, or a second pass). With `earlier`, the
+ * 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, 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 declare function researchJob(config: ResearchConfig, pages?: readonly GatheredPage[]): JobSpec;
+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[]): 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.
+ */
+export declare const MIN_SOURCES_WAIT_MS = 3600000;
 export interface ResearchOptions {
     /** The host's store of gathered pages; without it, a `sources: "sent"` request is not run. */
     readSources?: ReadSources;

package/dist/research.d.ts.map

@@ -1 +1 @@
-{"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,EAOL,KAAK,cAAc,EAEpB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,KAAK,YAAY,EAGjB,KAAK,WAAW,EAEjB,MAAM,uBAAuB,CAAA;AAE9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;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,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAA;AAE1D,gGAAgG;AAChG,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,aAAa,CAAA;IACpB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;CAC7B;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;AAYxC,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAU3D;AAQD,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;AAOD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAmC5F;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,cAAc,EACrB,KAAK,CAAC,EAAE,SAAS,YAAY,EAAE,GAC9B,OAAO,CA8CT;AA+ID,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,CA6EpF;AAED,mEAAmE;AACnE,eAAO,MAAM,QAAQ,0BAAiB,CAAA"}
+{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../src/research.ts"],"names":[],"mappings":"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"}