@rackbops/docket-types 0.4.0 → 0.6.0

package/README.md

@@ -11,11 +11,69 @@ The tracker's task types, built on `@rackbops/docket-core`'s contract. Shipped s
   or the owner's pattern; `extractPrice`), appends it to the series and alerts once per crossing
   of the drop line, measured from the first, last (default) or peak price seen; done stops it.
 
-None of the three calls a model. The others land with their epics: scout and wantlist (#13),
-research with the runner (E8).
+- `research` (category 5, E8): execute lane, `once`, an optional deadline. Two `claude -p` Jobs
+  go through the runner:
+  - a research run: the web-search spike's prompt and answer schema, `{summary,
+    findings[{claim, sources[]}], uncertain[]}`, about 15 turns and 1 USD (item 61, proposed and
+    not yet decided);
+  - a reviewer run (item 62), queued as a follow-up, which checks the draft against its sources
+    and approves, revises or rejects it (8 turns and 0.5 USD, inferred).
+
+  On **approve** the stored draft goes out by DM to the owner and accepted recipients; on
+  **revise**, the reviewer's corrected answer. Each claim is saved as a finding with its first
+  source. A **rejected** answer is reported and nothing is saved. An answer the reviewer did not
+  pass is never sent; the draft stays in the task's state, which only the owner and admins see.
+
+  Model output is parsed, capped and cleaned before it reaches a message or a finding. No mention
+  can ping, no masked link can hide its target, only http(s) URLs that spell no mention count as
+  sources, and every DM stays under Discord's limit.
+
+  Failures:
+  - a schema miss, a malformed answer, a timeout or an error (including an Executor or `prepare`
+    that threw, or a Job not back in six hours): retried once;
+  - an auth failure: retried once, an hour later;
+  - a turn or budget cap: reported, not retried;
+  - a research run that would start past its deadline: makes no call and tells the owner.
+
+  A request costs up to 1.5 USD when every run succeeds, and up to about 3 USD with one retry per
+  phase. The CLI can end a run over its cap.
+
+- `scout` (category 1, E9): execute lane, `calendar` every N days at the owner's hour (the host bounds N; the tracker
+  plugin allows 1 to 30). One
+  `claude -p` Job a run (WebSearch and WebFetch; 30 turns, 1.50 USD, 10 minutes, item 61 proposed)
+  asks for five to ten things through a gift lens; an item shown once is never shown again (the
+  state keeps the newest 300 digests, each item is also a finding).
+- `wantlist` (category 2, E9): notify lane, `poll`, no model. Reads a source each run, keeps the
+  listings within the owner's limits and DMs the new ones with a Done button, each a finding.
+  Sources: `pageSource` (a pasted page's JSON-LD `ItemList`s and `Product`s, through the host's
+  Fetch port, never eBay) and `bggSource` (BGG's XML API, with the host's token).
+- `wantjudge` (category 2, plan 5.4, item 63): the same watch on the execute lane. New listings
+  are read in plain code (no charge), then one Job has the model judge each one and its seller
+  (WebFetch only on the watch's own host, never WebSearch or the runner's files; 12 turns,
+  0.50 USD, 5 minutes). The DM puts the ones worth a look first with the model's note; a look
+  that fails for good sends the listings unchecked.
+
+`reminder`, `renewal`, `price` and `wantlist` call no model.
+
+`wantlistType(sources)` and `wantjudgeType(sources)` build the two watches over the sources a
+host can run; `TASK_TYPES` has them over `pageSource` only. What the want-list types ask of a
+host:
+
+- its Fetch port refuses any hop to eBay when a read carries the `NEVER_EBAY` header, and does
+  not send that header on;
+- its Fetch port reaches only public addresses, checked after the name lookup: the judge grants
+  the runner WebFetch on the watch's own host only because the host's reads already reach it;
+- `bggSource` gets a Fetch that hands back the body as sent and follows no redirect, so BGG's
+  token never leaves BGG's host;
+- the DM text names the tracker plugin's `/task history` command, and a judged watch with no
+  Fetch says "this bot reads no pages".
+
+`wantjudgeType`'s `wait` (BGG's spacing, default `setTimeout`) and `bggSource`'s `now` (default
+`Date.now`) can be injected; a host that keeps time behind its Clock passes them.
 
 ```ts
-import { TASK_TYPES, reminder, renewal, price, TYPE_IDS, isTypeId } from "@rackbops/docket-types"
+import { TASK_TYPES, reminder, renewal, price, research, scout, TYPE_IDS, isTypeId } from "@rackbops/docket-types"
+import { bggSource, pageSource, wantjudgeType, wantlistType } from "@rackbops/docket-types"
 ```
 
 `TASK_TYPES` is every shipped type keyed by id, ready for the dispatcher. Every type is declared

package/dist/index.d.ts

@@ -3,8 +3,10 @@
  *
  * The six categories of the plan (section 1.2) as type identifiers, and the types shipped so far:
  * `reminder` with the reminder slice (Lepid-Labs/city-hall#7), `renewal` and `price` with the
- * renewal and price-tracker slice (city-hall#11). The others land with their epics (#13: scout,
- * wantlist; research with E8).
+ * renewal and price-tracker slice (city-hall#11), and `research` (category 5, E8), the first
+ * execute-lane type: a research run and a reviewer run through the runner. `scout` (category 1),
+ * `wantlist` and the judged `wantjudge` (category 2) came from the tracker plugin in 0.6.0 (E9,
+ * plan item 104).
  */
 import type { TaskType } from "@rackbops/docket-core";
 export type { Lane } from "@rackbops/docket-core";
@@ -13,8 +15,18 @@ export { money } from "./money.js";
 export { BASELINE_RULES, type BaselineRule, DEFAULT_BASELINE, DEFAULT_DROP_PERCENT, MISSES_BEFORE_TELLING, type PriceConfig, type PriceState, price, reference, } from "./price.js";
 export { DEFAULT_SNOOZE_MS, type ReminderConfig, reminder, snoozeUntil } from "./reminder.js";
 export { decisionOf, isRenewalDecision, RENEWAL_DECISIONS, type RenewalConfig, type RenewalDecision, type RenewalState, renewal, } from "./renewal.js";
-/** The six task categories the tracker starts with (plan section 1.2), as type identifiers. */
-export declare const TYPE_IDS: readonly ["reminder", "renewal", "price", "research", "scout", "wantlist"];
+export { AUTH_RETRY_MS, deadlineOf, draftJson, MAX_CONTEXT_CHARS, MAX_QUESTION_CHARS, MAX_TRIES, RESEARCH_MAX_BUDGET_USD, RESEARCH_MAX_TURNS, RESEARCH_TIMEOUT_MS, REVIEW_MAX_BUDGET_USD, REVIEW_MAX_TURNS, REVIEW_TIMEOUT_MS, type ResearchConfig, type ResearchPhase, type ResearchState, research, researchJob, researchState, reviewJob, } from "./research.js";
+export { ANSWER_SCHEMA, clean, fitMessage, MAX_MESSAGE_CHARS, parseAnswer, parseReview, REVIEW_SCHEMA, type ResearchAnswer, type ResearchFinding, type Review, renderAnswer, safeUrl, VERDICTS, type Verdict, ZWSP, } from "./research-answer.js";
+export { itemKey, LENS_TEXT, LENSES, type Lens, lensOf, MAX_FOR_CHARS, MAX_INTEREST_CHARS, MAX_INTERESTS, MAX_ITEMS, MAX_SCOUT_NOTES, MAX_SHOWN, MIN_ITEMS, PROMPT_SHOWN, parseScout, renderScout, SCOUT_MAX_BUDGET_USD, SCOUT_MAX_TURNS, SCOUT_SCHEMA, SCOUT_TIMEOUT_MS, type ScoutConfig, type ScoutItem, type ScoutState, type ShownItem, scout, scoutJob, scoutState, } from "./scout.js";
+export { BGG_ATTRIBUTION, BGG_HOST, BGG_SPACING_MS, type BggOptions, bggSource, bggThingUrl, MAX_SCANNED, parseBggThingId, parseMarketplace, } from "./want-bgg.js";
+export { isEbayHost, type Listing, listingKey, listingsFromJsonLd, MAX_LISTINGS, NEVER_EBAY, pageSource, readListings, SOURCE_IDS, type Source, type SourceId, SourceMiss, SourceUnavailableError, } from "./want-sources.js";
+export { FITS, type Fit, JUDGE_MAX_BUDGET_USD, JUDGE_MAX_TURNS, JUDGE_SCHEMA, JUDGE_TIMEOUT_MS, type JudgeOptions, type JudgeState, type JudgeVerdict, judgeHosts, judgeJob, judgeState, parseVerdicts, RETRY_GRACE_MS, renderJudged, renderUnchecked, wantjudgeType, } from "./wantjudge.js";
+export { clip, inert, listingFinding, listingLine, MAX_DM_CHARS, MAX_NEW_PER_RUN, MAX_REPORTED, miss, type Polled, pollWant, priceText, renderWant, SHOWN_IN_DM, type WantConfig, type WantState, wantlistType, wantState, withinLimits, } from "./wantlist.js";
+/**
+ * The six task categories the tracker starts with (plan section 1.2), as type identifiers, then
+ * `wantjudge`: category 2's watch with the model's look first (plan 5.4), a type of its own.
+ */
+export declare const TYPE_IDS: readonly ["reminder", "renewal", "price", "research", "scout", "wantlist", "wantjudge"];
 export type TypeId = (typeof TYPE_IDS)[number];
 /** True when `value` names a task type. Narrows a string read from storage or the wire. */
 export declare function isTypeId(value: string): value is TypeId;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAKrD,YAAY,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAA;AACjD,OAAO,EACL,KAAK,cAAc,EACnB,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,aAAa,EACb,aAAa,EACb,gBAAgB,GACjB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EACL,cAAc,EACd,KAAK,YAAY,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,EACL,SAAS,GACV,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC7F,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,OAAO,GACR,MAAM,cAAc,CAAA;AAErB,+FAA+F;AAC/F,eAAO,MAAM,QAAQ,YAAI,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,CAAU,CAAA;AAElG,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9C,2FAA2F;AAC3F,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,MAAM,CAEvD;AAED,2EAA2E;AAC3E,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAIjE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -3,19 +3,44 @@
  *
  * The six categories of the plan (section 1.2) as type identifiers, and the types shipped so far:
  * `reminder` with the reminder slice (Lepid-Labs/city-hall#7), `renewal` and `price` with the
- * renewal and price-tracker slice (city-hall#11). The others land with their epics (#13: scout,
- * wantlist; research with E8).
+ * renewal and price-tracker slice (city-hall#11), and `research` (category 5, E8), the first
+ * execute-lane type: a research run and a reviewer run through the runner. `scout` (category 1),
+ * `wantlist` and the judged `wantjudge` (category 2) came from the tracker plugin in 0.6.0 (E9,
+ * plan item 104).
  */
 import { price } from "./price.js";
 import { reminder } from "./reminder.js";
 import { renewal } from "./renewal.js";
+import { research } from "./research.js";
+import { scout } from "./scout.js";
+import { pageSource } from "./want-sources.js";
+import { wantjudgeType } from "./wantjudge.js";
+import { wantlistType } from "./wantlist.js";
 export { extractPrice, jsonLdBlocks, parsePrice, priceFromJson, priceFromMeta, priceFromPattern, } from "./extract.js";
 export { money } from "./money.js";
 export { BASELINE_RULES, DEFAULT_BASELINE, DEFAULT_DROP_PERCENT, MISSES_BEFORE_TELLING, price, reference, } from "./price.js";
 export { DEFAULT_SNOOZE_MS, reminder, snoozeUntil } from "./reminder.js";
 export { decisionOf, isRenewalDecision, RENEWAL_DECISIONS, renewal, } from "./renewal.js";
-/** The six task categories the tracker starts with (plan section 1.2), as type identifiers. */
-export const TYPE_IDS = ["reminder", "renewal", "price", "research", "scout", "wantlist"];
+export { AUTH_RETRY_MS, deadlineOf, draftJson, MAX_CONTEXT_CHARS, MAX_QUESTION_CHARS, MAX_TRIES, RESEARCH_MAX_BUDGET_USD, RESEARCH_MAX_TURNS, RESEARCH_TIMEOUT_MS, REVIEW_MAX_BUDGET_USD, REVIEW_MAX_TURNS, REVIEW_TIMEOUT_MS, research, researchJob, researchState, reviewJob, } from "./research.js";
+export { ANSWER_SCHEMA, clean, fitMessage, MAX_MESSAGE_CHARS, parseAnswer, parseReview, REVIEW_SCHEMA, renderAnswer, safeUrl, VERDICTS, ZWSP, } from "./research-answer.js";
+export { itemKey, LENS_TEXT, LENSES, lensOf, MAX_FOR_CHARS, MAX_INTEREST_CHARS, MAX_INTERESTS, MAX_ITEMS, MAX_SCOUT_NOTES, MAX_SHOWN, MIN_ITEMS, PROMPT_SHOWN, parseScout, renderScout, SCOUT_MAX_BUDGET_USD, SCOUT_MAX_TURNS, SCOUT_SCHEMA, SCOUT_TIMEOUT_MS, scout, scoutJob, scoutState, } from "./scout.js";
+export { BGG_ATTRIBUTION, BGG_HOST, BGG_SPACING_MS, bggSource, bggThingUrl, MAX_SCANNED, parseBggThingId, parseMarketplace, } from "./want-bgg.js";
+export { isEbayHost, listingKey, listingsFromJsonLd, MAX_LISTINGS, NEVER_EBAY, pageSource, readListings, SOURCE_IDS, SourceMiss, SourceUnavailableError, } from "./want-sources.js";
+export { FITS, JUDGE_MAX_BUDGET_USD, JUDGE_MAX_TURNS, JUDGE_SCHEMA, JUDGE_TIMEOUT_MS, judgeHosts, judgeJob, judgeState, parseVerdicts, RETRY_GRACE_MS, renderJudged, renderUnchecked, wantjudgeType, } from "./wantjudge.js";
+export { clip, inert, listingFinding, listingLine, MAX_DM_CHARS, MAX_NEW_PER_RUN, MAX_REPORTED, miss, pollWant, priceText, renderWant, SHOWN_IN_DM, wantlistType, wantState, withinLimits, } from "./wantlist.js";
+/**
+ * The six task categories the tracker starts with (plan section 1.2), as type identifiers, then
+ * `wantjudge`: category 2's watch with the model's look first (plan 5.4), a type of its own.
+ */
+export const TYPE_IDS = [
+    "reminder",
+    "renewal",
+    "price",
+    "research",
+    "scout",
+    "wantlist",
+    "wantjudge",
+];
 /** True when `value` names a task type. Narrows a string read from storage or the wire. */
 export function isTypeId(value) {
     return TYPE_IDS.includes(value);
@@ -25,5 +50,10 @@ export const TASK_TYPES = Object.freeze({
     reminder: reminder,
     renewal: renewal,
     price: price,
+    research: research,
+    scout: scout,
+    // Over the page source only: BGG needs a host's token, so a host with one builds its own.
+    wantlist: wantlistType({ page: pageSource }),
+    wantjudge: wantjudgeType({ page: pageSource }),
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAGtC,OAAO,EAEL,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,aAAa,EACb,aAAa,EACb,gBAAgB,GACjB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EACL,cAAc,EAEd,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EAGrB,KAAK,EACL,SAAS,GACV,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,iBAAiB,EAAuB,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC7F,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EAIjB,OAAO,GACR,MAAM,cAAc,CAAA;AAErB,+FAA+F;AAC/F,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,CAAU,CAAA;AAIlG,2FAA2F;AAC3F,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAQ,QAA8B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACxD,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,UAAU,GAAgD,MAAM,CAAC,MAAM,CAAC;IACnF,QAAQ,EAAE,QAA6B;IACvC,OAAO,EAAE,OAA4B;IACrC,KAAK,EAAE,KAA0B;CAClC,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/research-answer.d.ts

@@ -0,0 +1,152 @@
+/**
+ * A research answer as data (plan 5.6): what the model returned is parsed field by field, capped,
+ * and cleaned before any of it becomes message text or a finding. Nothing here trusts the shape
+ * the JSON schema promised -- the CLI enforces it, but a stored draft comes back from the task's
+ * state, and a reviewer could return a valid shape around hostile text. A page the agent read can
+ * carry an instruction; the most it can do here is be quoted as text.
+ */
+import { clean, ZWSP } from "@rackbops/docket-core";
+/** The cleaner lives in core, so the dispatcher's own messages use it too; re-exported here. */
+export { clean, ZWSP };
+/** One claim and the pages it rests on. */
+export interface ResearchFinding {
+    claim: string;
+    /** http(s) URLs the run says it opened. */
+    sources: string[];
+}
+/** The shape both runs return (the reviewer inside its verdict). */
+export interface ResearchAnswer {
+    summary: string;
+    findings: ResearchFinding[];
+    uncertain: string[];
+}
+export declare const MAX_SUMMARY_CHARS = 1200;
+export declare const MAX_CLAIM_CHARS = 400;
+export declare const MAX_URL_CHARS = 400;
+export declare const MAX_FINDINGS = 12;
+export declare const MAX_SOURCES_PER_FINDING = 4;
+export declare const MAX_UNCERTAIN = 6;
+export declare const MAX_UNCERTAIN_CHARS = 300;
+/** Discord's DM limit is 2000 characters; the rest is headroom for the host's own framing. */
+export declare const MAX_MESSAGE_CHARS = 1900;
+/** The JSON schema the research run answers in: the spike's (docket-runner spike/cases.json). */
+export declare const ANSWER_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly summary: {
+            readonly type: "string";
+            readonly description: "The answer in at most 150 words.";
+        };
+        readonly findings: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly claim: {
+                        readonly type: "string";
+                    };
+                    readonly sources: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                            readonly description: "A URL you opened.";
+                        };
+                    };
+                };
+                readonly required: readonly ["claim", "sources"];
+            };
+        };
+        readonly uncertain: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+    };
+    readonly required: readonly ["summary", "findings", "uncertain"];
+};
+/** An http(s) URL, as a URL parses it, or null. Never anything else (no `javascript:`). */
+export declare function safeUrl(value: unknown): string | null;
+/**
+ * The answer in `value`, capped and cleaned, or null when it is not one. A claim with no usable
+ * source is not a finding: it moves to `uncertain`, marked, since every claim a reader might act
+ * on needs a source the run opened.
+ */
+export declare function parseAnswer(value: unknown): ResearchAnswer | null;
+/** The reviewer's three verdicts. */
+export declare const VERDICTS: readonly ["approve", "revise", "reject"];
+export type Verdict = (typeof VERDICTS)[number];
+export interface Review {
+    verdict: Verdict;
+    /** What the reviewer found wrong; empty on a clean approval. */
+    problems: string[];
+    /** The answer to send: the draft as approved, or as the reviewer corrected it. */
+    answer: ResearchAnswer | null;
+}
+export declare const MAX_PROBLEMS = 5;
+export declare const MAX_PROBLEM_CHARS = 300;
+/** The JSON schema the reviewer answers in. */
+export declare const REVIEW_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly verdict: {
+            readonly type: "string";
+            readonly enum: readonly ["approve", "revise", "reject"];
+            readonly description: string;
+        };
+        readonly problems: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly description: "Each problem found, one line each; empty when there are none.";
+        };
+        readonly answer: {
+            readonly type: "object";
+            readonly properties: {
+                readonly summary: {
+                    readonly type: "string";
+                    readonly description: "The answer in at most 150 words.";
+                };
+                readonly findings: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly claim: {
+                                readonly type: "string";
+                            };
+                            readonly sources: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                    readonly description: "A URL you opened.";
+                                };
+                            };
+                        };
+                        readonly required: readonly ["claim", "sources"];
+                    };
+                };
+                readonly uncertain: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            readonly required: readonly ["summary", "findings", "uncertain"];
+            readonly description: "The answer to send: the draft unchanged on approve, corrected on revise.";
+        };
+    };
+    readonly required: readonly ["verdict", "problems"];
+};
+/** The reviewer's verdict in `value`, cleaned, or null when it is not one. */
+export declare function parseReview(value: unknown): Review | null;
+/** Lines as one DM of at most `MAX_MESSAGE_CHARS`, whole lines dropped from the end. */
+export declare function fitMessage(lines: string[]): string;
+/**
+ * The DM a reviewed answer goes out as, at most `MAX_MESSAGE_CHARS`. Every piece of it was
+ * cleaned by `parseAnswer`; the title is the owner's own and is cleaned here.
+ */
+export declare function renderAnswer(title: string, answer: ResearchAnswer, review: Review): string;
+//# sourceMappingURL=research-answer.d.ts.map

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

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

package/dist/research-answer.js

@@ -0,0 +1,210 @@
+/**
+ * A research answer as data (plan 5.6): what the model returned is parsed field by field, capped,
+ * and cleaned before any of it becomes message text or a finding. Nothing here trusts the shape
+ * the JSON schema promised -- the CLI enforces it, but a stored draft comes back from the task's
+ * state, and a reviewer could return a valid shape around hostile text. A page the agent read can
+ * carry an instruction; the most it can do here is be quoted as text.
+ */
+import { clean, ZWSP } from "@rackbops/docket-core";
+/** The cleaner lives in core, so the dispatcher's own messages use it too; re-exported here. */
+export { clean, ZWSP };
+export const MAX_SUMMARY_CHARS = 1200;
+export const MAX_CLAIM_CHARS = 400;
+export const MAX_URL_CHARS = 400;
+export const MAX_FINDINGS = 12;
+export const MAX_SOURCES_PER_FINDING = 4;
+export const MAX_UNCERTAIN = 6;
+export const MAX_UNCERTAIN_CHARS = 300;
+/** Discord's DM limit is 2000 characters; the rest is headroom for the host's own framing. */
+export const MAX_MESSAGE_CHARS = 1900;
+/** The JSON schema the research run answers in: the spike's (docket-runner spike/cases.json). */
+export const ANSWER_SCHEMA = {
+    type: "object",
+    properties: {
+        summary: { type: "string", description: "The answer in at most 150 words." },
+        findings: {
+            type: "array",
+            items: {
+                type: "object",
+                properties: {
+                    claim: { type: "string" },
+                    sources: {
+                        type: "array",
+                        items: { type: "string", description: "A URL you opened." },
+                    },
+                },
+                required: ["claim", "sources"],
+            },
+        },
+        uncertain: { type: "array", items: { type: "string" } },
+    },
+    required: ["summary", "findings", "uncertain"],
+};
+/** An http(s) URL, as a URL parses it, or null. Never anything else (no `javascript:`). */
+export function safeUrl(value) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim().replace(/^<|>$/g, "");
+    if (trimmed.length === 0 || trimmed.length > MAX_URL_CHARS)
+        return null;
+    let url;
+    try {
+        url = new URL(trimmed);
+    }
+    catch {
+        return null;
+    }
+    if (url.protocol !== "https:" && url.protocol !== "http:")
+        return null;
+    if (url.username || url.password)
+        return null;
+    const text = url.toString();
+    // A URL is shown as is, so one that spells a mention could ping; it is no source.
+    if (/@(everyone|here)\b|<[@#]/i.test(decodeURIComponentSafe(text)))
+        return null;
+    return text;
+}
+function decodeURIComponentSafe(text) {
+    try {
+        return decodeURIComponent(text);
+    }
+    catch {
+        return text;
+    }
+}
+function isObj(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+/**
+ * The answer in `value`, capped and cleaned, or null when it is not one. A claim with no usable
+ * source is not a finding: it moves to `uncertain`, marked, since every claim a reader might act
+ * on needs a source the run opened.
+ */
+export function parseAnswer(value) {
+    if (!isObj(value) || typeof value.summary !== "string" || !Array.isArray(value.findings)) {
+        return null;
+    }
+    const summary = clean(value.summary, MAX_SUMMARY_CHARS);
+    if (summary.length === 0)
+        return null;
+    const findings = [];
+    const uncertain = [];
+    for (const f of value.findings) {
+        if (!isObj(f) || typeof f.claim !== "string")
+            continue;
+        const claim = clean(f.claim, MAX_CLAIM_CHARS, true);
+        if (claim.length === 0)
+            continue;
+        const raw = Array.isArray(f.sources) ? f.sources : [];
+        const sources = [...new Set(raw.map(safeUrl).filter((u) => u !== null))];
+        if (sources.length === 0)
+            uncertain.push(`${claim} (no source given)`);
+        else
+            findings.push({ claim, sources: sources.slice(0, MAX_SOURCES_PER_FINDING) });
+    }
+    const said = Array.isArray(value.uncertain) ? value.uncertain : [];
+    for (const u of said) {
+        if (typeof u !== "string")
+            continue;
+        const line = clean(u, MAX_UNCERTAIN_CHARS, true);
+        if (line.length > 0)
+            uncertain.push(line);
+    }
+    return {
+        summary,
+        findings: findings.slice(0, MAX_FINDINGS),
+        uncertain: uncertain.slice(0, MAX_UNCERTAIN),
+    };
+}
+/** The reviewer's three verdicts. */
+export const VERDICTS = ["approve", "revise", "reject"];
+export const MAX_PROBLEMS = 5;
+export const MAX_PROBLEM_CHARS = 300;
+/** The JSON schema the reviewer answers in. */
+export const REVIEW_SCHEMA = {
+    type: "object",
+    properties: {
+        verdict: {
+            type: "string",
+            enum: [...VERDICTS],
+            description: "approve: the draft stands as is. revise: it stands once corrected; put the corrected " +
+                "answer in `answer`. reject: it cannot be fixed by editing (wrong question, sources do " +
+                "not support it, or nothing usable).",
+        },
+        problems: {
+            type: "array",
+            items: { type: "string" },
+            description: "Each problem found, one line each; empty when there are none.",
+        },
+        answer: {
+            ...ANSWER_SCHEMA,
+            description: "The answer to send: the draft unchanged on approve, corrected on revise.",
+        },
+    },
+    required: ["verdict", "problems"],
+};
+/** The reviewer's verdict in `value`, cleaned, or null when it is not one. */
+export function parseReview(value) {
+    if (!isObj(value) || typeof value.verdict !== "string")
+        return null;
+    const verdict = VERDICTS.includes(value.verdict)
+        ? value.verdict
+        : null;
+    if (!verdict)
+        return null;
+    const problems = (Array.isArray(value.problems) ? value.problems : [])
+        .filter((p) => typeof p === "string")
+        .map((p) => clean(p, MAX_PROBLEM_CHARS, true))
+        .filter((p) => p.length > 0)
+        .slice(0, MAX_PROBLEMS);
+    const answer = parseAnswer(value.answer);
+    // Approve or revise without a usable answer is not a verdict the type can act on.
+    if (verdict !== "reject" && !answer)
+        return null;
+    return { verdict, problems, answer: verdict === "reject" ? null : answer };
+}
+/** Fits `lines` into `max` characters, dropping whole lines from the end and saying so. */
+function fit(lines, max) {
+    const out = [];
+    let length = 0;
+    for (const [i, line] of lines.entries()) {
+        const more = `(${lines.length - i} more lines not shown)`;
+        // Room for this line, and for the marker unless it is the last.
+        const reserve = i < lines.length - 1 ? more.length + 1 : 0;
+        if (length + line.length + 1 + reserve > max) {
+            out.push(more);
+            break;
+        }
+        out.push(line);
+        length += line.length + 1;
+    }
+    const text = out.join("\n");
+    return text.length > max ? `${text.slice(0, max - 3)}...` : text;
+}
+/** Lines as one DM of at most `MAX_MESSAGE_CHARS`, whole lines dropped from the end. */
+export function fitMessage(lines) {
+    return fit(lines, MAX_MESSAGE_CHARS);
+}
+/**
+ * The DM a reviewed answer goes out as, at most `MAX_MESSAGE_CHARS`. Every piece of it was
+ * cleaned by `parseAnswer`; the title is the owner's own and is cleaned here.
+ */
+export function renderAnswer(title, answer, review) {
+    const lines = [`Research: ${clean(title, 200, true)}`, "", answer.summary];
+    if (answer.findings.length > 0) {
+        lines.push("", "Findings:");
+        // Sources in <...> so Discord shows the link without an embed.
+        for (const f of answer.findings)
+            lines.push(`- ${f.claim} <${f.sources[0]}>`);
+    }
+    if (answer.uncertain.length > 0) {
+        lines.push("", "Uncertain:");
+        for (const u of answer.uncertain)
+            lines.push(`- ${u}`);
+    }
+    const note = review.verdict === "approve"
+        ? "Checked by a reviewer run."
+        : `Checked and corrected by a reviewer run (${review.problems.length} problem(s) fixed).`;
+    return `${fit(lines, MAX_MESSAGE_CHARS - note.length - 2)}\n\n${note}`;
+}
+//# sourceMappingURL=research-answer.js.map

package/dist/research-answer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-answer.js","sourceRoot":"","sources":["../src/research-answer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAA;AAEnD,gGAAgG;AAChG,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;AAgBtB,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAA;AACrC,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAA;AAClC,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAA;AAChC,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAA;AAC9B,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAA;AACxC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAA;AAC9B,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAA;AACtC,8FAA8F;AAC9F,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAA;AAErC,iGAAiG;AACjG,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;QAC5E,QAAQ,EAAE;YACR,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,OAAO,EAAE;wBACP,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;qBAC5D;iBACF;gBACD,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;aAC/B;SACF;QACD,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;KACxD;IACD,QAAQ,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC;CACtC,CAAA;AAEV,2FAA2F;AAC3F,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;IAClD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,aAAa;QAAE,OAAO,IAAI,CAAA;IACvE,IAAI,GAAQ,CAAA;IACZ,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAA;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,IAAI,CAAA;IACtE,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAA;IAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAA;IAC3B,kFAAkF;IAClF,IAAI,2BAA2B,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IAC/E,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAY;IAC1C,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAA;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,CAAU;IACvB,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;AACjE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzF,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAA;IACvD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACrC,MAAM,QAAQ,GAAsB,EAAE,CAAA;IACtC,MAAM,SAAS,GAAa,EAAE,CAAA;IAC9B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;YAAE,SAAQ;QACtD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,CAAC,CAAA;QACnD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAQ;QAChC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;QACrD,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAA;QACrF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS,CAAC,IAAI,CAAC,GAAG,KAAK,oBAAoB,CAAC,CAAA;;YACjE,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,uBAAuB,CAAC,EAAE,CAAC,CAAA;IACnF,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAA;IAClE,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,SAAQ;QACnC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,CAAC,CAAA;QAChD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3C,CAAC;IACD,OAAO;QACL,OAAO;QACP,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC;QACzC,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC;KAC7C,CAAA;AACH,CAAC;AAED,qCAAqC;AACrC,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAA;AAYhE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAA;AAC7B,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAA;AAEpC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,GAAG,QAAQ,CAAC;YACnB,WAAW,EACT,uFAAuF;gBACvF,wFAAwF;gBACxF,qCAAqC;SACxC;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EAAE,+DAA+D;SAC7E;QACD,MAAM,EAAE;YACN,GAAG,aAAa;YAChB,WAAW,EAAE,0EAA0E;SACxF;KACF;IACD,QAAQ,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;CACzB,CAAA;AAEV,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IACnE,MAAM,OAAO,GAAI,QAA8B,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;QACrE,CAAC,CAAE,KAAK,CAAC,OAAmB;QAC5B,CAAC,CAAC,IAAI,CAAA;IACR,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAA;IACzB,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;SACnE,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;SACjD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAC;SAC7C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;SAC3B,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAA;IACzB,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACxC,kFAAkF;IAClF,IAAI,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IAChD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAA;AAC5E,CAAC;AAED,2FAA2F;AAC3F,SAAS,GAAG,CAAC,KAAe,EAAE,GAAW;IACvC,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,KAAK,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,wBAAwB,CAAA;QACzD,gEAAgE;QAChE,MAAM,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1D,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,OAAO,GAAG,GAAG,EAAE,CAAC;YAC7C,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACd,MAAK;QACP,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACd,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA;IAC3B,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3B,OAAO,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;AAClE,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,UAAU,CAAC,KAAe;IACxC,OAAO,GAAG,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAA;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,MAAsB,EAAE,MAAc;IAChF,MAAM,KAAK,GAAG,CAAC,aAAa,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;IAC1E,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAA;QAC3B,+DAA+D;QAC/D,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IAC/E,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,YAAY,CAAC,CAAA;QAC5B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACxD,CAAC;IACD,MAAM,IAAI,GACR,MAAM,CAAC,OAAO,KAAK,SAAS;QAC1B,CAAC,CAAC,4BAA4B;QAC9B,CAAC,CAAC,4CAA4C,MAAM,CAAC,QAAQ,CAAC,MAAM,qBAAqB,CAAA;IAC7F,OAAO,GAAG,GAAG,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,OAAO,IAAI,EAAE,CAAA;AACxE,CAAC"}