@ixo/openhands-sdk 0.4.0 → 0.5.0

package/dist/esm/data/checkers.js

@@ -0,0 +1,304 @@
+/*
+ * Expert checkers: oracles that check answers by their OWN rules (each of their protocols' claim form `#vct` and
+ * rubric `#rub`), as opposed to Openhands, which writes fresh rules for every ask. An oracle is an expert when its
+ * `GET /v1/info` lists a non-empty `supportedProtocols` (eval-oracle's register gate 3 refuses every other protocol).
+ *
+ * Client-safe: the pure helpers (`fieldsFromClaimForm`, `validateFields`, `checkEnvelope`) import nothing; the chain
+ * and network reads load `checkersRead.ts` lazily, server-side.
+ *
+ * Posting an ask on a checker's own rules (no per-ask protocol, no `#rub` of the ask's own):
+ * - website: `createAskEntities(session, { ...input, protocol })` mints the deed alone and answers
+ *   `claimProtocolDid: protocol`; then `postAsk(..., { shape: { claimProtocolDid: protocol, ... } })` with NO
+ *   `claimDomainCard` (the poster does not control someone else's protocol) and `terms.checker` = the checker's
+ *   `address`, `checkRewardUixo` = the check's `priceBase` (0 when it bills per review) and `feeDenom` = its
+ *   `priceDenom` (a checker names its own coin; devnet's are IXO, not the network's PAY).
+ * - MCP / worker agent: `createAsk(actor, { ...ask, protocol, feeDenom })`.
+ * The collection then points at that protocol, so the engine resolves the checker's `#vct` and `#rub`; the checker
+ * is hired like every ask's oracle, by its hire nudge (`/openhands/hire/:collectionId`).
+ *
+ * An answer to such an ask is `checkEnvelope(...)`: the form's answers at the root (what the checker's rubric reads,
+ * `$.<name>`), beside the usual Openhands envelope fields.
+ */
+/** Ask the World's checker, by the address it signs as (devnet IXO-5583; testnet 2026-10-17). */
+export const ASK_THE_WORLD_CHECKERS = new Set(["ixo1qrk9dp4r2u8q5l9cs42yh4dne4pj3wynp4enwq", "ixo12mvzayzrzsvaud86jf9shy6q2nvkea3tygxhsh"]);
+/**
+ * Asky Checker: IXO's checker for Expert Review calls (call kind `review`), and their checker wherever it is deployed
+ * (2026-10-26). By its oracle's URL and the account it signs verdicts as (its `/v1/info` `address`, the ask's
+ * `terms.checker`), per network. Empty where it is not deployed yet.
+ */
+export const ASKY_CHECKER_URLS = { devnet: "", testnet: "https://asky-checker.testnet.ixo.earth", mainnet: "https://asky-checker.ixo.earth" };
+export const ASKY_CHECKER_ADDRESSES = { devnet: "", testnet: "ixo149t76xlqg5u5dmpz7sjhlz7y0qktafv4z6qg9u", mainnet: "ixo1gmt3rxksd0ukzd228u67p3a34ew7sfl2shff9f" };
+/**
+ * Its fee per check, escrowed on the ask in this coin, which is also the review's reward coin (owner and S3, 2026-10-26:
+ * Expert Reviews pay in PAY, 1 PAY a check, on both networks as each /v1/info publishes it).
+ */
+export const ASKY_CHECKER_FEES = { testnet: { base: 1_000_000, denom: "upay" }, mainnet: { base: 1_000_000, denom: "upay" } };
+export const ASKY_CHECKER_NAME = "Asky Checker";
+export const askyCheckerUrl = (network) => ASKY_CHECKER_URLS[network] || null;
+/** Asky Checker on `network`, to post a review call to, nudge and pay per check; null where it is not deployed. */
+export const askyChecker = (network) => ASKY_CHECKER_URLS[network] && ASKY_CHECKER_ADDRESSES[network] && ASKY_CHECKER_FEES[network] ? { url: ASKY_CHECKER_URLS[network], address: ASKY_CHECKER_ADDRESSES[network], fee: ASKY_CHECKER_FEES[network] } : null;
+/**
+ * The coin a checker's fee is escrowed in (owner ruling): its own, as its /v1/info publishes it (IXO, or USDC on mainnet).
+ * PAY is the fee only for IXO-managed checkers (our own two); any other checker naming it is refused.
+ */
+export function feeCoinOf(denom, managed) {
+    if (!denom)
+        return { refused: "This reviewer has not published a fee currency" };
+    if (denom === "upay" && !managed)
+        return { refused: "This reviewer charges in PAY, which is reserved for IXO reviewers on this network" };
+    return { denom };
+}
+/**
+ * Whether an oracle is an Openhands checker: its builder turned the Openhands add-on on at init, so its `/v1/info`
+ * names the hire route (`openhands: { hire, scan }`); or it is one of our own two (the deployment's oracle, Ask the
+ * World's checker), which serve the routes without saying so. Every other oracle is not listed at all.
+ */
+export const isOpenhandsChecker = (info, own = false) => own || typeof info?.openhands?.hire === "string";
+/** The add-on's routes from `/v1/info`, when it names them. */
+export function openhandsRoutes(info) {
+    const hire = info?.openhands?.hire;
+    const scan = info?.openhands?.scan;
+    return typeof hire === "string" && hire.startsWith("/") ? { hire, ...(typeof scan === "string" && scan.startsWith("/") ? { scan } : {}) } : undefined;
+}
+/** The path to nudge for `event` on this ask: the oracle's own route, else `/openhands/<event>/<id>` (our own two). */
+export const openhandsPath = (routes, event, collectionId) => (routes?.[event] ?? `/openhands/${event}/:collectionId`).replace(":collectionId", encodeURIComponent(collectionId));
+/** Every checker on the network that publishes a card: the experts with their checks, and the Openhands ones (no checks). */
+export async function listCheckers(opts = {}) {
+    return (await import("./checkersRead.js")).readCheckers(opts);
+}
+/** One checker by the address that signs for it (any carded oracle that is an Openhands checker), as its domain card presents it: name, blurb, logo. Null when none. */
+export async function checkerByAddress(address, opts = {}) {
+    return (await import("./checkersRead.js")).readCheckerByAddress(address, opts);
+}
+/** One protocol's check: its form's fields (hash-checked `#vct`) and whether its rubric has a person step. Null when unreadable. */
+export async function checkOfProtocol(protocolDid, opts = {}) {
+    return (await import("./checkersRead.js")).readCheckOfProtocol(protocolDid, opts);
+}
+/** The checker and check a protocol belongs to, among `checkers`. */
+export function checkerOfProtocol(checkers, protocolDid) {
+    for (const checker of checkers) {
+        const check = checker.checks.find((one) => one.did === protocolDid);
+        if (check)
+            return { checker, check };
+    }
+    return null;
+}
+const plain = (text) => text.trim().toLowerCase();
+/**
+ * The expert checker a person named (its DID or plain name, any case) and the check (`check`: a DID or name; left
+ * out when it offers only one). A refusal in plain words otherwise.
+ */
+export function pickCheck(checkers, checker, check) {
+    const experts = checkers.filter((one) => one.expert);
+    /* A card's name may carry a tagline ("VeriTrack — invoice verification"): the part before the dash is a name too. */
+    const found = experts.find((one) => one.did === checker.trim()) ?? experts.find((one) => plain(one.name) === plain(checker)) ?? experts.find((one) => plain(one.name.split(/\s+[—–-]\s+/)[0]) === plain(checker));
+    if (!found)
+        return { refused: `there is no reviewer called "${checker}" on this network${experts.length ? ` (there are: ${experts.map((one) => one.name).join(", ")})` : ""}` };
+    if (found.unavailable || !found.address)
+        return { refused: `${found.name} cannot take asks just now${found.unavailable ? ` (${found.unavailable})` : ""}` };
+    const picked = check ? (found.checks.find((one) => one.did === check.trim()) ?? found.checks.find((one) => plain(one.name) === plain(check))) : found.checks.length === 1 ? found.checks[0] : undefined;
+    if (!picked)
+        return { refused: check ? `${found.name} has no check called "${check}" (it has: ${found.checks.map((one) => one.name).join(", ")})` : `${found.name} offers several checks: say which with check (one of: ${found.checks.map((one) => one.name).join(", ")})` };
+    return { checker: found, check: picked };
+}
+const list = (value) => (Array.isArray(value) ? value : []);
+const str = (value) => (typeof value === "string" && value.trim() ? value.trim() : undefined);
+/** SurveyJS text may be localised: `{ default: "…", fr: "…" }`. */
+const words = (value) => str(value) ?? (value && typeof value === "object" ? str(value.default) : undefined);
+const choiceValue = (choice) => String(choice && typeof choice === "object" && "value" in choice ? choice.value : choice);
+/** Display-only SurveyJS elements: they answer nothing. */
+const NOT_ANSWERS = new Set(["html", "expression", "image"]);
+function surveyField(q, name, conditional) {
+    const inputType = q.inputType;
+    const choices = list(q.choices).map(choiceValue);
+    let type;
+    switch (q.type) {
+        case "text":
+            type = inputType === "number" || inputType === "range" ? "number" : inputType === "date" ? "date" : "string";
+            break;
+        case "comment":
+        case "dropdown":
+        case "radiogroup":
+            type = "string";
+            break;
+        case "boolean":
+            type = "boolean";
+            break;
+        case "rating":
+        case "slider":
+            type = "number";
+            break;
+        case "file":
+        case "signaturepad":
+            type = "file";
+            break;
+        default:
+            /* shortcut: multi-choice, matrix and dynamic-panel questions are not offered on the simple form; add them when a checker's form needs them. */
+            return null;
+    }
+    const description = words(q.description);
+    const accept = type === "file" ? str(q.acceptedTypes) : undefined;
+    return {
+        name,
+        label: words(q.title) ?? name,
+        type,
+        /* A question shown only on a condition may be left out, whatever its `isRequired` says (eval-oracle's work order). */
+        required: q.isRequired === true && !conditional,
+        ...(description ? { description } : {}),
+        ...((q.type === "dropdown" || q.type === "radiogroup") && choices.length ? { enum: choices } : {}),
+        ...(q.type === "text" && inputType === "url" ? { url: true } : {}),
+        ...(accept ? { accept } : {})
+    };
+}
+function surveyFields(elements, conditional, seen) {
+    const out = [];
+    for (const element of elements) {
+        if (!element || typeof element !== "object")
+            continue;
+        const q = element;
+        if (q.visible === false)
+            continue;
+        const cond = conditional || q.visibleIf !== undefined;
+        if (q.type === "panel") {
+            out.push(...surveyFields(list(q.elements), cond, seen));
+            continue;
+        }
+        const name = str(q.name);
+        if (!name || NOT_ANSWERS.has(String(q.type)) || seen.has(name))
+            continue;
+        seen.add(name);
+        const field = surveyField(q, name, cond);
+        if (field)
+            out.push(field);
+    }
+    return out;
+}
+function schemaFields(schema) {
+    const required = new Set(list(schema.required).filter((one) => typeof one === "string"));
+    return Object.entries((schema.properties ?? {})).flatMap(([name, prop]) => {
+        const kind = prop?.type;
+        const type = kind === "string" ? (prop.format === "date" ? "date" : "string") : kind === "number" ? "number" : kind === "integer" ? "integer" : kind === "boolean" ? "boolean" : null;
+        if (!type)
+            return [];
+        const description = str(prop.description);
+        const choices = list(prop.enum).map(String);
+        const url = type === "string" && (prop.format === "uri" || prop.format === "url");
+        return [{ name, label: str(prop.title) ?? name, type, required: required.has(name), ...(description ? { description } : {}), ...(choices.length ? { enum: choices } : {}), ...(url ? { url: true } : {}) }];
+    });
+}
+/**
+ * The questions a protocol's claim form (`#vct`) asks, as simple fields: a SurveyJS template (bare, or inside the
+ * `surveyTemplate` envelope's `question`) or a JSON Schema's `properties`. Display elements and hidden questions are
+ * left out; a question shown only on a condition is never required.
+ */
+export function fieldsFromClaimForm(vct) {
+    if (!vct || typeof vct !== "object")
+        return [];
+    const root = vct;
+    const survey = (root.question && typeof root.question === "object" ? root.question : root);
+    if (survey.properties && typeof survey.properties === "object")
+        return schemaFields(survey);
+    const seen = new Set();
+    const pages = list(survey.pages).flatMap((page) => {
+        const p = (page ?? {});
+        return p.visible === false ? [] : surveyFields(list(p.elements), p.visibleIf !== undefined, seen);
+    });
+    return [...pages, ...surveyFields(list(survey.elements), false, seen)];
+}
+const isEmpty = (value) => value === undefined || value === null || (typeof value === "string" && value.trim() === "") || (Array.isArray(value) && value.length === 0);
+const filesOf = (value) => (Array.isArray(value) ? value : [value]);
+const isFile = (value) => {
+    const file = value;
+    return Boolean(file && typeof file === "object" && typeof file.name === "string" && typeof file.type === "string" && typeof file.url === "string" && /^https:\/\//.test(file.url));
+};
+/** A number typed into a box arrives as text: "12.5" counts. */
+const numberOf = (value) => (typeof value === "number" ? value : typeof value === "string" && value.trim() !== "" ? Number(value) : NaN);
+/** Plain-word problems with `values` against `fields`; empty = ok. */
+export function validateFields(fields, values) {
+    const problems = [];
+    for (const field of fields) {
+        const value = values[field.name];
+        if (isEmpty(value)) {
+            if (field.required)
+                problems.push(`${field.label} is needed.`);
+            continue;
+        }
+        switch (field.type) {
+            case "number":
+            case "integer": {
+                const number = numberOf(value);
+                if (!Number.isFinite(number))
+                    problems.push(`${field.label} must be a number.`);
+                else if (field.type === "integer" && !Number.isInteger(number))
+                    problems.push(`${field.label} must be a whole number.`);
+                break;
+            }
+            case "boolean":
+                if (typeof value !== "boolean")
+                    problems.push(`${field.label} must be yes or no.`);
+                break;
+            case "date":
+                if (typeof value !== "string" || !/^\d{4}-\d{2}-\d{2}$/.test(value) || Number.isNaN(Date.parse(value)))
+                    problems.push(`${field.label} must be a date (year-month-day).`);
+                break;
+            case "file":
+                if (!filesOf(value).every(isFile))
+                    problems.push(`${field.label} must be a file that has been uploaded.`);
+                break;
+            default:
+                if (typeof value !== "string")
+                    problems.push(`${field.label} must be text.`);
+                else if (field.url && !/^https?:\/\/\S+$/i.test(value.trim()))
+                    problems.push(`${field.label} must be a web address starting with https://.`);
+        }
+        if (field.enum && !field.enum.includes(String(value)))
+            problems.push(`${field.label} must be one of: ${field.enum.join(", ")}.`);
+    }
+    const known = new Set(fields.map((field) => field.name));
+    for (const name of Object.keys(values))
+        if (!known.has(name) && !isEmpty(values[name]))
+            problems.push(`"${name}" is not a question on this form.`);
+    return problems;
+}
+/** The answer's value as the checker's rubric reads it: numbers as numbers, files as SurveyJS file answers. */
+function answerOf(field, value) {
+    if (field.type === "number" || field.type === "integer")
+        return numberOf(value);
+    if (field.type === "file")
+        return filesOf(value).map((file) => ({ name: file.name, type: file.type, content: file.url }));
+    return typeof value === "string" ? value.trim() : value;
+}
+/**
+ * The claim body of an answer to an expert ask, the same from the website and the MCP. The checker's engine reads
+ * the claim body verbatim as its `answers`, so every form answer sits at the root under its own name; the Openhands
+ * envelope fields ride beside them, with `deliverable` as the answers in words for Openhands' own pages. Throws the
+ * plain-word problems when the values do not fit the form.
+ */
+export function checkEnvelope(input) {
+    const problems = validateFields(input.fields, input.values);
+    if (problems.length)
+        throw new Error(problems.join(" "));
+    const answered = input.fields.filter((field) => !isEmpty(input.values[field.name]));
+    const answers = Object.fromEntries(answered.map((field) => [field.name, answerOf(field, input.values[field.name])]));
+    const said = (field) => {
+        const value = input.values[field.name];
+        if (field.type === "file")
+            return filesOf(value).map((file) => file.name).join(", ");
+        if (field.type === "boolean")
+            return value ? "yes" : "no";
+        return String(answers[field.name]);
+    };
+    return {
+        v: 2,
+        collectionId: input.collectionId,
+        ts: input.ts ?? new Date().toISOString(),
+        submitter: input.submitter,
+        ...(input.delegate ? { delegate: input.delegate } : {}),
+        ...(input.alias ? { alias: input.alias } : {}),
+        ...(input.via ? { via: input.via } : {}),
+        deliverable: answered.map((field) => `${field.label}: ${said(field)}`).join("\n"),
+        /* Last: a form question that shares an envelope field's name keeps the person's answer, which is what the checker reads. */
+        ...answers
+    };
+}
+//# sourceMappingURL=checkers.js.map

package/dist/esm/data/checkers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkers.js","sourceRoot":"","sources":["../../../src/data/checkers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAkDH,iGAAiG;AACjG,MAAM,CAAC,MAAM,sBAAsB,GAAwB,IAAI,GAAG,CAAC,CAAC,4CAA4C,EAAE,4CAA4C,CAAC,CAAC,CAAC;AAEjK;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAqC,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,wCAAwC,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;AAChL,MAAM,CAAC,MAAM,sBAAsB,GAAqC,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC;AACrM;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA8D,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;AACzL,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAChD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAe,EAAiB,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;AACrG,mHAAmH;AACnH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAe,EAAiF,EAAE,CAC5H,iBAAiB,CAAC,OAAO,CAAC,IAAI,sBAAsB,CAAC,OAAO,CAAC,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,iBAAiB,CAAC,OAAO,CAAE,EAAE,OAAO,EAAE,sBAAsB,CAAC,OAAO,CAAE,EAAE,GAAG,EAAE,iBAAiB,CAAC,OAAO,CAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAEzN;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAgC,EAAE,OAAgB;IAC1E,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC;IACjF,IAAI,KAAK,KAAK,MAAM,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,mFAAmF,EAAE,CAAC;IAC1I,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAkE,EAAE,GAAG,GAAG,KAAK,EAAW,EAAE,CAAC,GAAG,IAAI,OAAO,IAAI,EAAE,SAAS,EAAE,IAAI,KAAK,QAAQ,CAAC;AAEjL,+DAA+D;AAC/D,MAAM,UAAU,eAAe,CAAC,IAAkF;IAChH,MAAM,IAAI,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC;IACnC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACxJ,CAAC;AAED,uHAAuH;AACvH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAA0C,EAAE,KAAsB,EAAE,YAAoB,EAAU,EAAE,CAChI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,cAAc,KAAK,gBAAgB,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC;AAItH,6HAA6H;AAC7H,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAoB,EAAE;IACvD,OAAO,CAAC,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC;AAED,wKAAwK;AACxK,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAe,EAAE,OAAoB,EAAE;IAC5E,OAAO,CAAC,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACjF,CAAC;AAED,oIAAoI;AACpI,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,WAAmB,EAAE,OAAoB,EAAE;IAC/E,OAAO,CAAC,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,mBAAmB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AACpF,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,iBAAiB,CAAC,QAA4B,EAAE,WAAmB;IACjF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,WAAW,CAAC,CAAC;QACpE,IAAI,KAAK;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,KAAK,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAElE;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,QAA4B,EAAE,OAAe,EAAE,KAAqB;IAC5F,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrD,qHAAqH;IACrH,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAE,CAAC,KAAK,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACnN,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,OAAO,EAAE,gCAAgC,OAAO,oBAAoB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;IAChL,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,IAAI,6BAA6B,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;IAC5J,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxM,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,yBAAyB,KAAK,cAAc,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,yDAAyD,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IAC9Q,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3C,CAAC;AAKD,MAAM,IAAI,GAAG,CAAC,KAAc,EAAa,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAChF,MAAM,GAAG,GAAG,CAAC,KAAc,EAAsB,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAC3H,mEAAmE;AACnE,MAAM,KAAK,GAAG,CAAC,KAAc,EAAsB,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAE,KAA+B,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AACrK,MAAM,WAAW,GAAG,CAAC,MAAe,EAAU,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,IAAI,MAAM,CAAC,CAAC,CAAE,MAA6B,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACnK,2DAA2D;AAC3D,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;AAE7D,SAAS,WAAW,CAAC,CAAW,EAAE,IAAY,EAAE,WAAoB;IAClE,MAAM,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;IAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACjD,IAAI,IAAwB,CAAC;IAC7B,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,MAAM;YACT,IAAI,GAAG,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC7G,MAAM;QACR,KAAK,SAAS,CAAC;QACf,KAAK,UAAU,CAAC;QAChB,KAAK,YAAY;YACf,IAAI,GAAG,QAAQ,CAAC;YAChB,MAAM;QACR,KAAK,SAAS;YACZ,IAAI,GAAG,SAAS,CAAC;YACjB,MAAM;QACR,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ;YACX,IAAI,GAAG,QAAQ,CAAC;YAChB,MAAM;QACR,KAAK,MAAM,CAAC;QACZ,KAAK,cAAc;YACjB,IAAI,GAAG,MAAM,CAAC;YACd,MAAM;QACR;YACE,+IAA+I;YAC/I,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI;QAC7B,IAAI;QACJ,sHAAsH;QACtH,QAAQ,EAAE,CAAC,CAAC,UAAU,KAAK,IAAI,IAAI,CAAC,WAAW;QAC/C,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClG,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9B,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,QAAmB,EAAE,WAAoB,EAAE,IAAiB;IAChF,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,SAAS;QACtD,MAAM,CAAC,GAAG,OAAmB,CAAC;QAC9B,IAAI,CAAC,CAAC,OAAO,KAAK,KAAK;YAAE,SAAS;QAClC,MAAM,IAAI,GAAG,WAAW,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC;QACtD,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACvB,GAAG,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YACxD,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QACzE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,KAAK;YAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,YAAY,CAAC,MAAgB;IACpC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC;IACxG,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAA6B,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAgB,EAAE;QAClH,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC;QACxB,MAAM,IAAI,GACR,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3K,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAC;QACrB,MAAM,WAAW,GAAG,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,GAAG,GAAG,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC;QAClF,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACvN,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC/C,MAAM,IAAI,GAAG,GAAe,CAAC;IAC7B,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAa,CAAC;IACvG,IAAI,MAAM,CAAC,UAAU,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;QAAE,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5F,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAChD,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAa,CAAC;QACnC,OAAO,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,KAAK,SAAS,EAAE,IAAI,CAAC,CAAC;IACpG,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,KAAK,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AACzE,CAAC;AAOD,MAAM,OAAO,GAAG,CAAC,KAAc,EAAW,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;AACzL,MAAM,OAAO,GAAG,CAAC,KAAc,EAAa,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AACxF,MAAM,MAAM,GAAG,CAAC,KAAc,EAAsB,EAAE;IACpD,MAAM,IAAI,GAAG,KAAkC,CAAC;IAChD,OAAO,OAAO,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrL,CAAC,CAAC;AACF,gEAAgE;AAChE,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAU,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAE1J,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAAC,MAAoB,EAAE,MAA+B;IAClF,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACnB,IAAI,KAAK,CAAC,QAAQ;gBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,aAAa,CAAC,CAAC;YAC/D,SAAS;QACX,CAAC;QACD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,QAAQ,CAAC;YACd,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;oBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,oBAAoB,CAAC,CAAC;qBAC3E,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC;oBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,0BAA0B,CAAC,CAAC;gBACxH,MAAM;YACR,CAAC;YACD,KAAK,SAAS;gBACZ,IAAI,OAAO,KAAK,KAAK,SAAS;oBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,qBAAqB,CAAC,CAAC;gBACnF,MAAM;YACR,KAAK,MAAM;gBACT,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,mCAAmC,CAAC,CAAC;gBACzK,MAAM;YACR,KAAK,MAAM;gBACT,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;oBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,yCAAyC,CAAC,CAAC;gBAC1G,MAAM;YACR;gBACE,IAAI,OAAO,KAAK,KAAK,QAAQ;oBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,gBAAgB,CAAC,CAAC;qBACxE,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;oBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,gDAAgD,CAAC,CAAC;QACjJ,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,oBAAoB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnI,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,mCAAmC,CAAC,CAAC;IACnJ,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,+GAA+G;AAC/G,SAAS,QAAQ,CAAC,KAAiB,EAAE,KAAc;IACjD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChF,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAG,IAAkB,CAAC,IAAI,EAAE,IAAI,EAAG,IAAkB,CAAC,IAAI,EAAE,OAAO,EAAG,IAAkB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACvK,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC1D,CAAC;AAcD;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5D,IAAI,QAAQ,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpF,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrH,MAAM,IAAI,GAAG,CAAC,KAAiB,EAAU,EAAE;QACzC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAE,IAAkB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpG,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1D,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC;IACF,OAAO;QACL,CAAC,EAAE,CAAC;QACJ,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACxC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,WAAW,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACjF,4HAA4H;QAC5H,GAAG,OAAO;KACX,CAAC;AACJ,CAAC"}

package/dist/esm/data/checkersRead.d.ts

@@ -0,0 +1,58 @@
+/** The network reads behind `checkers.ts`. Server-side; loaded lazily so a page that only validates a form never carries them. */
+import type { Checker, CheckerCheck, CheckerOpts, CheckRule } from "./checkers.ts";
+/**
+ * Whether these bytes are what a linked resource's `proof` promised: a sha256 hex (an engine `#vct`/`#rub`) or a
+ * CIDv1 raw sha256 (a Portal-published form). Anything else fails closed.
+ */
+export declare function proofMatches(proof: string, text: string): Promise<boolean>;
+/** The engine's work order says a person answers before the verdict: `review.taskDetails` (or the older `review.tasks`). */
+export declare const hasPersonStep: (manifest: unknown) => boolean;
+/**
+ * A check's rules in its author's words: each gate's reason (a rule every answer must pass), each AI check's
+ * instructions, each review task's question (a person decides). From the rubric (`#rub`); the engine's work order
+ * (`/v1/rubrics/manifest`) stands in for the AI checks and review tasks when the rubric could not be read (it carries
+ * no gate reasons).
+ */
+export declare function rulesOf(rubric: unknown, manifest: unknown): CheckRule[];
+export declare function readCheckOfProtocol(protocolDid: string, opts?: CheckerOpts): Promise<CheckerCheck | null>;
+interface InfoDoc {
+    supportedProtocols?: unknown;
+    openhands?: {
+        hire?: unknown;
+        scan?: unknown;
+    } | null;
+    pricing?: {
+        evaluation?: {
+            denom?: unknown;
+            minAmount?: unknown;
+        };
+        byProtocol?: Record<string, {
+            denom?: unknown;
+            minAmount?: unknown;
+        }>;
+    };
+    protocols?: unknown;
+    reviewBilling?: {
+        mode?: unknown;
+    };
+}
+/** The fee a collection of `protocolDid` is held to: `protocols[].fee` for that protocol, else `pricing.byProtocol[did]`, else `pricing.evaluation` (eval-oracle `publishedPrice`). */
+export declare function priceOf(info: InfoDoc, protocolDid: string): {
+    priceBase: number | null;
+    priceDenom: string | null;
+};
+export declare function readCheckers(opts?: CheckerOpts): Promise<Checker[]>;
+/**
+ * How a checker presents itself, from its domain card (`#dmn` `credentialSubject`) and profile (`#pro`): its name and
+ * blurb, and its logo (`logo.contentUrl`, else `image[0].contentUrl`, else the profile's `logo`/`image`). A logo is
+ * kept only on IXO's own stores, so a page shows it through <img> from a host it already trusts. Pure.
+ */
+export declare function lookOf(domainCard: unknown, profile: unknown): {
+    name?: string;
+    what?: string;
+    logo?: string;
+};
+/** One checker by its signing address, as its domain card presents it (name, blurb, logo); null when none. */
+export declare function readCheckerByAddress(address: string, opts?: CheckerOpts): Promise<Checker | null>;
+export {};
+//# sourceMappingURL=checkersRead.d.ts.map

package/dist/esm/data/checkersRead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkersRead.d.ts","sourceRoot":"","sources":["../../../src/data/checkersRead.ts"],"names":[],"mappings":"AAAA,kIAAkI;AAElI,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAuDnF;;;GAGG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKhF;AAED,4HAA4H;AAC5H,eAAO,MAAM,aAAa,GAAI,UAAU,OAAO,KAAG,OAGjD,CAAC;AAOF;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,SAAS,EAAE,CAevE;AAcD,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAwCnH;AAiBD,UAAU,OAAO;IACf,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACtD,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,OAAO,CAAC;YAAC,SAAS,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,KAAK,CAAC,EAAE,OAAO,CAAC;YAAC,SAAS,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAC3I,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACpC;AAED,uLAAuL;AACvL,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAMnH;AAyCD,wBAAsB,YAAY,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAI7E;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAQ7G;AAED,8GAA8G;AAC9G,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAc3G"}

package/dist/esm/data/checkersRead.js

@@ -0,0 +1,252 @@
+/** The network reads behind `checkers.ts`. Server-side; loaded lazily so a page that only validates a form never carries them. */
+import { ASK_THE_WORLD_CHECKERS, fieldsFromClaimForm, isOpenhandsChecker, openhandsRoutes } from "./checkers.js";
+import { oracleUrl } from "../chain/oracle.js";
+import { engineUrl as defaultEngineUrl } from "./engineUrl.js";
+import { gql } from "./gql.js";
+import { loadOracles } from "./oracles.js";
+import { clampText, reachable } from "./outbound.js";
+import { entityNames } from "./profiles.js";
+import { isStoredFile } from "../rubric/report.js";
+const TIMEOUT_MS = 8_000;
+/** A claim form is a few KB; a generous cap that still bounds a stranger's document. */
+const FORM_MAX_BYTES = 512 * 1024;
+/** One oracle offering more checks than this is not a menu a person can read. */
+const CHECKS_MAX = 10;
+async function readText(url, fetchImpl, maxBytes = 64 * 1024) {
+    if (!reachable(url))
+        return null;
+    try {
+        const response = await fetchImpl(url, { signal: AbortSignal.timeout(TIMEOUT_MS), headers: { accept: "application/json" } });
+        if (!response.ok)
+            return null;
+        const text = await response.text();
+        return text.length > maxBytes ? null : text;
+    }
+    catch {
+        return null;
+    }
+}
+const readJson = async (url, fetchImpl) => {
+    const text = await readText(url, fetchImpl);
+    try {
+        return text === null ? null : JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+};
+/* RFC 4648 base32, lower case, no padding (multibase `b`), as cid.ts — repeated so this module needs no node:crypto. */
+function base32(bytes) {
+    const alphabet = "abcdefghijklmnopqrstuvwxyz234567";
+    let bits = 0;
+    let value = 0;
+    let out = "";
+    for (const byte of bytes) {
+        value = (value << 8) | byte;
+        bits += 8;
+        while (bits >= 5) {
+            out += alphabet[(value >>> (bits - 5)) & 31];
+            bits -= 5;
+        }
+    }
+    if (bits > 0)
+        out += alphabet[(value << (5 - bits)) & 31];
+    return out;
+}
+/**
+ * Whether these bytes are what a linked resource's `proof` promised: a sha256 hex (an engine `#vct`/`#rub`) or a
+ * CIDv1 raw sha256 (a Portal-published form). Anything else fails closed.
+ */
+export async function proofMatches(proof, text) {
+    const digest = new Uint8Array(await crypto.subtle.digest("SHA-256", new TextEncoder().encode(text)));
+    if (/^[0-9a-f]{64}$/i.test(proof))
+        return [...digest].map((byte) => byte.toString(16).padStart(2, "0")).join("") === proof.toLowerCase();
+    if (/^b[a-z2-7]+$/.test(proof))
+        return `b${base32(Uint8Array.from([0x01, 0x55, 0x12, 0x20, ...digest]))}` === proof;
+    return false;
+}
+/** The engine's work order says a person answers before the verdict: `review.taskDetails` (or the older `review.tasks`). */
+export const hasPersonStep = (manifest) => {
+    const review = manifest?.review;
+    return (Array.isArray(review?.taskDetails) && review.taskDetails.length > 0) || (Array.isArray(review?.tasks) && review.tasks.length > 0);
+};
+const RULES_MAX = 20;
+const listOf = (value) => (Array.isArray(value) ? value.filter((one) => Boolean(one) && typeof one === "object") : []);
+/**
+ * A check's rules in its author's words: each gate's reason (a rule every answer must pass), each AI check's
+ * instructions, each review task's question (a person decides). From the rubric (`#rub`); the engine's work order
+ * (`/v1/rubrics/manifest`) stands in for the AI checks and review tasks when the rubric could not be read (it carries
+ * no gate reasons).
+ */
+export function rulesOf(rubric, manifest) {
+    const outer = (rubric && typeof rubric === "object" ? rubric : {});
+    const rub = (outer.rubric && typeof outer.rubric === "object" ? outer.rubric : outer);
+    const work = (manifest && typeof manifest === "object" ? manifest : {});
+    const ai = listOf(rub.aiChecks).length ? listOf(rub.aiChecks) : listOf(work.ai && typeof work.ai === "object" ? Object.values(work.ai) : []);
+    const tasks = listOf(rub.review?.tasks).length ? listOf(rub.review?.tasks) : listOf(work.review?.taskDetails);
+    const said = (kind) => (raw) => {
+        const text = clampText(raw, 300);
+        return text ? [{ text, kind }] : [];
+    };
+    return [
+        ...listOf(rub.gates).flatMap((gate) => said("measure")(gate.reason)),
+        ...ai.flatMap((check) => (Array.isArray(check.instructions) ? check.instructions : []).flatMap(said("judge"))),
+        ...tasks.flatMap((task) => said("attest")(task.prompt))
+    ].slice(0, RULES_MAX);
+}
+/** A linked JSON document whose bytes are what its `proof` promised; null otherwise. */
+async function readProven(resource, fetchImpl) {
+    if (!resource?.serviceEndpoint || !resource.proof)
+        return null;
+    const text = await readText(resource.serviceEndpoint, fetchImpl, FORM_MAX_BYTES);
+    if (text === null || !(await proofMatches(resource.proof, text)))
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+export async function readCheckOfProtocol(protocolDid, opts = {}) {
+    if (!/^did:ixo:entity:[0-9a-f]+$/i.test(protocolDid))
+        return null;
+    const fetchImpl = opts.fetch ?? fetch;
+    const engine = (opts.engineUrl ?? defaultEngineUrl()).replace(/\/$/, "");
+    if (!/^https?:\/\//.test(engine))
+        return null;
+    /* Blocksync's view merges the class's resources in, so an inherited `#vct` is found too. */
+    const data = await gql(`query { entities(filter: {id: {equalTo: ${JSON.stringify(protocolDid)}}}) { nodes { linkedResource } } }`, 300).catch(() => null);
+    const resources = data?.entities?.nodes?.[0]?.linkedResource ?? [];
+    const vct = resources.find((one) => one?.id?.endsWith("#vct"));
+    if (!vct?.serviceEndpoint || !vct.proof)
+        return null;
+    const [text, manifest, rubric] = await Promise.all([
+        readText(vct.serviceEndpoint, fetchImpl, FORM_MAX_BYTES),
+        readJson(`${engine}/v1/rubrics/manifest?protocol=${encodeURIComponent(protocolDid)}`, fetchImpl).catch(() => null),
+        readProven(resources.find((one) => one?.id?.endsWith("#rub")), fetchImpl).catch(() => null)
+    ]);
+    /* A form whose bytes are not the anchored ones is not this check's form; a protocol the engine cannot read has no rules to check by. */
+    if (text === null || !(await proofMatches(vct.proof, text)) || !manifest)
+        return null;
+    let form;
+    try {
+        form = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    const survey = (form?.question ?? form);
+    const title = clampText(typeof survey?.title === "object" ? survey.title?.default : survey?.title, 80);
+    const name = title ?? (await entityNames([protocolDid]).catch(() => new Map())).get(protocolDid) ?? "A check";
+    const rules = rulesOf(rubric, manifest);
+    return {
+        did: protocolDid,
+        name,
+        what: clampText(typeof survey?.description === "object" ? survey.description?.default : survey?.description, 300) ?? name,
+        fields: fieldsFromClaimForm(form),
+        personStep: hasPersonStep(manifest),
+        priceBase: null,
+        priceDenom: null,
+        ...(rules.length ? { rules } : {})
+    };
+}
+/** The origin of an oracle entity's eval-oracle: its anchored `#eval` service, https and public. */
+async function originOf(did) {
+    const data = await gql(`query { iids(filter: {id: {equalTo: ${JSON.stringify(did)}}}) { nodes { service } } }`, 60).catch(() => null);
+    const endpoint = data?.iids?.nodes?.[0]?.service?.find((one) => one.id.endsWith("#eval") || one.type === "EvalOracleAPI")?.serviceEndpoint;
+    try {
+        const url = new URL(endpoint ?? "");
+        return url.protocol === "https:" && reachable(url.origin) ? url.origin : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** The fee a collection of `protocolDid` is held to: `protocols[].fee` for that protocol, else `pricing.byProtocol[did]`, else `pricing.evaluation` (eval-oracle `publishedPrice`). */
+export function priceOf(info, protocolDid) {
+    const listed = Array.isArray(info.protocols) ? info.protocols.find((one) => one?.did === protocolDid)?.fee : undefined;
+    const own = info.pricing?.byProtocol && Object.prototype.hasOwnProperty.call(info.pricing.byProtocol, protocolDid) ? info.pricing.byProtocol[protocolDid] : undefined;
+    const fee = listed ?? own ?? info.pricing?.evaluation;
+    const amount = typeof fee?.minAmount === "string" && /^\d{1,20}$/.test(fee.minAmount) ? Number(fee.minAmount) : null;
+    return amount !== null && typeof fee?.denom === "string" && fee.denom ? { priceBase: amount, priceDenom: fee.denom } : { priceBase: null, priceDenom: null };
+}
+/** Our own two: the deployment's oracle and Ask the World's checker, which serve the hire route without naming it. */
+const isOwn = (oracle, url) => {
+    if (ASK_THE_WORLD_CHECKERS.has(oracle.address))
+        return true;
+    try {
+        return Boolean(url) && new URL(oracleUrl()).origin === url;
+    }
+    catch {
+        return false;
+    }
+};
+/** One carded oracle as a checker: null when it is not an Openhands checker, or an expert none of whose checks can be read. */
+async function checkerOf(oracle, opts) {
+    const fetchImpl = opts.fetch ?? fetch;
+    const url = await originOf(oracle.did);
+    const info = ((url ? await readJson(`${url}/v1/info`, fetchImpl) : null) ?? {});
+    /* Only Openhands checkers (the add-on on, or our own two): any other oracle is not listed, not even as unavailable. */
+    if (!isOpenhandsChecker(info, isOwn(oracle, url)))
+        return null;
+    const supported = Array.isArray(info.supportedProtocols) ? info.supportedProtocols.filter((one) => typeof one === "string") : [];
+    const routes = openhandsRoutes(info);
+    const price = priceOf(info, "");
+    const base = {
+        did: oracle.did,
+        name: oracle.name,
+        what: oracle.description,
+        url,
+        address: oracle.address,
+        perReview: info.reviewBilling?.mode === "x402",
+        ...(oracle.unavailable ? { unavailable: oracle.unavailable } : {}),
+        ...(routes ? { routes } : {}),
+        ...(price.priceBase !== null && price.priceDenom ? { price: { base: price.priceBase, denom: price.priceDenom } } : {})
+    };
+    if (supported.length === 0)
+        return { ...base, expert: false, checks: [] };
+    const checks = (await Promise.all(supported.slice(0, CHECKS_MAX).map((did) => readCheckOfProtocol(did, opts).catch(() => null))))
+        .filter((check) => check !== null)
+        .map((check) => ({ ...check, ...priceOf(info, check.did) }));
+    /* An expert none of whose checks can be read offers nothing a person could pick. */
+    return checks.length ? { ...base, expert: true, checks } : null;
+}
+export async function readCheckers(opts = {}) {
+    const oracles = await loadOracles().catch(() => []);
+    const found = await Promise.all(oracles.map((oracle) => checkerOf(oracle, opts)));
+    return found.filter((checker) => checker !== null);
+}
+/**
+ * How a checker presents itself, from its domain card (`#dmn` `credentialSubject`) and profile (`#pro`): its name and
+ * blurb, and its logo (`logo.contentUrl`, else `image[0].contentUrl`, else the profile's `logo`/`image`). A logo is
+ * kept only on IXO's own stores, so a page shows it through <img> from a host it already trusts. Pure.
+ */
+export function lookOf(domainCard, profile) {
+    const subject = (domainCard?.credentialSubject ?? {});
+    const pro = (profile && typeof profile === "object" ? profile : {});
+    const image = Array.isArray(subject.image) ? subject.image[0]?.contentUrl : undefined;
+    const logo = [subject.logo?.contentUrl, image, pro.logo, pro.image].find(isStoredFile);
+    const name = clampText(subject.name, 60);
+    const what = clampText(subject.description, 300);
+    return { ...(name ? { name } : {}), ...(what ? { what } : {}), ...(logo ? { logo } : {}) };
+}
+/** One checker by its signing address, as its domain card presents it (name, blurb, logo); null when none. */
+export async function readCheckerByAddress(address, opts = {}) {
+    if (!address)
+        return null;
+    const fetchImpl = opts.fetch ?? fetch;
+    const oracle = (await loadOracles().catch(() => [])).find((one) => one.address === address);
+    if (!oracle)
+        return null;
+    /* The chain's own resources, not the domain indexer, which lags a re-anchored card. */
+    const readLook = async () => {
+        const data = await gql(`query { iids(filter: {id: {equalTo: ${JSON.stringify(oracle.did)}}}) { nodes { linkedResource } } }`, 60).catch(() => null);
+        const resources = data?.iids?.nodes?.[0]?.linkedResource ?? [];
+        const [dmn, pro] = await Promise.all(["#dmn", "#pro"].map((frag) => readProven(resources.find((one) => one?.id?.endsWith(frag)), fetchImpl).catch(() => null)));
+        return lookOf(dmn, pro);
+    };
+    const [checker, look] = await Promise.all([checkerOf(oracle, opts), readLook()]);
+    return checker ? { ...checker, ...look } : null;
+}
+//# sourceMappingURL=checkersRead.js.map