@ixo/openhands-sdk 0.4.0 → 0.5.0

package/dist/cjs/discovery.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KEYWORD = exports.COLLECTION = exports.CARD_VERSION = exports.STUB = void 0;
+exports.keywordsOf = keywordsOf;
+exports.shareTags = shareTags;
+exports.slugOf = slugOf;
+exports.stubOf = stubOf;
+exports.shareOrgs = shareOrgs;
+exports.httpsOrigin = httpsOrigin;
+exports.xml = xml;
+exports.jsonLd = jsonLd;
+exports.STUB = /^[a-f0-9]{12}$/;
+exports.CARD_VERSION = /^[a-f0-9]{16}$/;
+exports.COLLECTION = /^\d{1,12}$/;
+exports.KEYWORD = /^[a-z0-9][a-z0-9-]{0,47}$/;
+function keywordsOf(values) {
+    return [...new Set(values.map((value) => value.trim().toLowerCase().replace(/^#/, "")).filter((value) => exports.KEYWORD.test(value)))].sort().slice(0, 24);
+}
+const STOP_WORDS = new Set(["the", "and", "for", "this", "that", "with", "from", "your", "what", "into", "are", "you", "our", "has", "have", "which", "where", "who", "how", "its", "was", "were", "been", "any", "all", "can", "will", "about", "one"]);
+/* An open call's or a plan's campaign is an internal handle (`call-qa-connect-1020`, `plan-…-f166`), not a topic. */
+const INTERNAL_CAMPAIGN = /^(call|plan)-/;
+/**
+ * An ask's tags, two ways. `tags` is the search index (`?tag=`/`?topic=`): every whole title word, its kind of
+ * work and its campaign. `topics` is what a reader sees (the `keywords` of a page, its feed categories): at most
+ * three, the campaign when it is a real one, then the title's longest whole words. Never a word cut short.
+ */
+function shareTags(kind, campaign, title) {
+    const words = title.normalize("NFKD").replace(/[\u0300-\u036f]/g, "").toLowerCase().split(/[^a-z0-9]+/).filter((word) => word.length > 2 && !STOP_WORDS.has(word));
+    const longest = [...new Set(words)].sort((a, b) => b.length - a.length);
+    const topics = [campaign && !INTERNAL_CAMPAIGN.test(campaign) ? campaign : "", ...longest, kind].filter((value) => exports.KEYWORD.test(value));
+    return { tags: keywordsOf([kind, campaign ?? "", ...words]), topics: [...new Set(topics)].slice(0, 3) };
+}
+function slugOf(title) {
+    return title.normalize("NFKD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 56).replace(/-$/, "") || "openhands";
+}
+function stubOf(segment) {
+    const stub = segment.split("-").at(-1) ?? "";
+    return exports.STUB.test(stub) ? stub : null;
+}
+/** Hostnames come only from operator configuration, never request headers or submitted URLs. */
+function shareOrgs(raw) {
+    if (!raw)
+        return [];
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed))
+        throw new Error("SHARE_ORGS must be an array");
+    const keys = new Set();
+    const hosts = new Set();
+    const owners = new Set();
+    return parsed.map((item) => {
+        if (!item || !exports.KEYWORD.test(item.key) || typeof item.name !== "string" || !item.name.trim() || item.name.length > 80 || typeof item.owner !== "string" || !item.owner)
+            throw new Error("Invalid sharing organisation");
+        const host = item.host?.toLowerCase();
+        if (host && (!/^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,63}$/.test(host) || host.endsWith(".localhost")))
+            throw new Error("Invalid sharing hostname");
+        if (keys.has(item.key) || owners.has(item.owner) || (host && hosts.has(host)))
+            throw new Error("Duplicate sharing organisation");
+        keys.add(item.key);
+        owners.add(item.owner);
+        if (host)
+            hosts.add(host);
+        return { key: item.key, name: item.name.trim(), owner: item.owner, ...(host ? { host } : {}) };
+    });
+}
+function httpsOrigin(value) {
+    const url = new URL(value);
+    if (url.protocol !== "https:" || url.username || url.password || url.port || url.pathname !== "/" || url.search || url.hash)
+        throw new Error("Sharing requires a public HTTPS origin");
+    return url.origin;
+}
+function xml(value) {
+    // eslint-disable-next-line no-control-regex -- XML 1.0 forbids these; one in a chain title would break every subscriber's feed.
+    return value.replace(/[\u0000-\u0008\u000b\u000c\u000e-\u001f\ufffe\uffff]/g, "").replace(/[&<>"']/g, (char) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&apos;" })[char]);
+}
+function jsonLd(spec) {
+    return {
+        "@context": "https://schema.org", "@type": "CreativeWork", "@id": spec.canonicalUrl,
+        identifier: spec.pageId, name: spec.title, description: spec.description, url: spec.canonicalUrl,
+        image: spec.imageUrl, keywords: spec.keywords, inLanguage: spec.locale.replace("_", "-"),
+        dateModified: spec.updatedAt, creativeWorkStatus: spec.status, isAccessibleForFree: true,
+        publisher: { "@type": "Organization", name: spec.brand.name },
+        ...(spec.location ? { spatialCoverage: { "@type": "Place", name: spec.location.name, geo: { "@type": "GeoCoordinates", latitude: spec.location.latitude, longitude: spec.location.longitude } } } : {})
+    };
+}
+//# sourceMappingURL=discovery.js.map

package/dist/cjs/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/discovery.ts"],"names":[],"mappings":";;;AAyCA,gCAEC;AAWD,8BAKC;AAED,wBAEC;AAED,wBAGC;AAGD,8BAeC;AAED,kCAIC;AAED,kBAGC;AAED,wBASC;AAxEY,QAAA,IAAI,GAAG,gBAAgB,CAAC;AACxB,QAAA,YAAY,GAAG,gBAAgB,CAAC;AAChC,QAAA,UAAU,GAAG,YAAY,CAAC;AAC1B,QAAA,OAAO,GAAG,2BAA2B,CAAC;AAEnD,SAAgB,UAAU,CAAC,MAAgB;IACzC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtJ,CAAC;AAED,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AACzP,qHAAqH;AACrH,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAE1C;;;;GAIG;AACH,SAAgB,SAAS,CAAC,IAAY,EAAE,QAAuB,EAAE,KAAa;IAC5E,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACnK,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,CAAC,QAAQ,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACxI,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC1G,CAAC;AAED,SAAgB,MAAM,CAAC,KAAa;IAClC,OAAO,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,WAAW,CAAC;AAC/K,CAAC;AAED,SAAgB,MAAM,CAAC,OAAe;IACpC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,OAAO,YAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACvC,CAAC;AAED,gGAAgG;AAChG,SAAgB,SAAS,CAAC,GAAuB;IAC/C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,IAAc,EAAE,EAAE;QACnC,IAAI,CAAC,IAAI,IAAI,CAAC,eAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACtN,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC;QACtC,IAAI,IAAI,IAAI,CAAC,CAAC,0DAA0D,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACjK,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACjI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAAC,IAAI,IAAI;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACjG,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,WAAW,CAAC,KAAa;IACvC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,QAAQ,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACvL,OAAO,GAAG,CAAC,MAAM,CAAC;AACpB,CAAC;AAED,SAAgB,GAAG,CAAC,KAAa;IAC/B,gIAAgI;IAChI,OAAO,KAAK,CAAC,OAAO,CAAC,uDAAuD,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAE,CAAC,CAAC;AACrM,CAAC;AAED,SAAgB,MAAM,CAAC,IAAiB;IACtC,OAAO;QACL,UAAU,EAAE,oBAAoB,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI,CAAC,YAAY;QACnF,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,CAAC,YAAY;QAChG,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC;QACxF,YAAY,EAAE,IAAI,CAAC,SAAS,EAAE,kBAAkB,EAAE,IAAI,CAAC,MAAM,EAAE,mBAAmB,EAAE,IAAI;QACxF,SAAS,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;QAC7D,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxM,CAAC;AACJ,CAAC"}

package/dist/cjs/envRead.d.ts

@@ -11,5 +11,5 @@
  * that is not Next, a Worker without nodejs_compat); Next provides `process`
  * in client and edge bundles.
  */
-export { firstSet, hasEnv, strictBase } from "./network.ts";
+export { firstSet, hasEnv, scopedVar, strictBase } from "./network.ts";
 //# sourceMappingURL=envRead.d.ts.map

package/dist/cjs/envRead.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"envRead.d.ts","sourceRoot":"","sources":["../../src/envRead.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"envRead.d.ts","sourceRoot":"","sources":["../../src/envRead.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/cjs/envRead.js

@@ -13,7 +13,7 @@
  * in client and edge bundles.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.strictBase = exports.hasEnv = exports.firstSet = void 0;
+exports.strictBase = exports.scopedVar = exports.hasEnv = exports.firstSet = void 0;
 /* Implemented in `network.ts` (one shared module, one chunk); re-exported
    here so accessors keep a name that says what they import. Kept as a
    separate re-export on purpose: measured on the app build, importing the
@@ -22,5 +22,6 @@ exports.strictBase = exports.hasEnv = exports.firstSet = void 0;
 var network_ts_1 = require("./network.js");
 Object.defineProperty(exports, "firstSet", { enumerable: true, get: function () { return network_ts_1.firstSet; } });
 Object.defineProperty(exports, "hasEnv", { enumerable: true, get: function () { return network_ts_1.hasEnv; } });
+Object.defineProperty(exports, "scopedVar", { enumerable: true, get: function () { return network_ts_1.scopedVar; } });
 Object.defineProperty(exports, "strictBase", { enumerable: true, get: function () { return network_ts_1.strictBase; } });
 //# sourceMappingURL=envRead.js.map

package/dist/cjs/envRead.js.map

@@ -1 +1 @@
-{"version":3,"file":"envRead.js","sourceRoot":"","sources":["../../src/envRead.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAEH;;;;4EAI4E;AAC5E,2CAA4D;AAAnD,sGAAA,QAAQ,OAAA;AAAE,oGAAA,MAAM,OAAA;AAAE,wGAAA,UAAU,OAAA"}
+{"version":3,"file":"envRead.js","sourceRoot":"","sources":["../../src/envRead.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAEH;;;;4EAI4E;AAC5E,2CAAuE;AAA9D,sGAAA,QAAQ,OAAA;AAAE,oGAAA,MAAM,OAAA;AAAE,uGAAA,SAAS,OAAA;AAAE,wGAAA,UAAU,OAAA"}

package/dist/cjs/given.d.ts

@@ -6,6 +6,20 @@
  * every page's shared chunk.
  */
 import type { OpenhandsConfig } from "./config.ts";
+/**
+ * One call's own configuration, for a host that serves several networks from one process (the local MCP: one
+ * scope per tool call, held in its AsyncLocalStorage): the network, what was adopted for it on top of `given`,
+ * variables it holds in place of the environment's, and whether this process's environment describes it at all.
+ */
+export interface Scope {
+    network: string;
+    given: Partial<OpenhandsConfig>;
+    vars: Record<string, string>;
+    env: boolean;
+}
+/** Install the reader of the current scope (once, by the host that keeps one). */
+export declare const setScope: (read: () => Scope | undefined) => void;
+export declare const currentScope: () => Scope | undefined;
 export declare const givenConfig: () => Partial<OpenhandsConfig>;
 export declare const setGivenConfig: (next: Partial<OpenhandsConfig>) => void;
 /** The current generation of the configuration; `config()` recomputes when it moves. */

package/dist/cjs/given.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"given.d.ts","sourceRoot":"","sources":["../../src/given.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AASnD,eAAO,MAAM,WAAW,QAAO,OAAO,CAAC,eAAe,CAAU,CAAC;AACjE,eAAO,MAAM,cAAc,GAAI,MAAM,OAAO,CAAC,eAAe,CAAC,KAAG,IAG/D,CAAC;AACF,wFAAwF;AACxF,eAAO,MAAM,YAAY,QAAO,MAAiB,CAAC;AAClD,qGAAqG;AACrG,eAAO,MAAM,eAAe,QAAO,IAElC,CAAC"}
+{"version":3,"file":"given.d.ts","sourceRoot":"","sources":["../../src/given.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AASnD;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,EAAE,OAAO,CAAC;CACd;AAED,kFAAkF;AAClF,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAK,GAAG,SAAS,KAAG,IAGxD,CAAC;AACF,eAAO,MAAM,YAAY,QAAO,KAAK,GAAG,SAAoB,CAAC;AAE7D,eAAO,MAAM,WAAW,QAAO,OAAO,CAAC,eAAe,CAGrD,CAAC;AACF,eAAO,MAAM,cAAc,GAAI,MAAM,OAAO,CAAC,eAAe,CAAC,KAAG,IAG/D,CAAC;AACF,wFAAwF;AACxF,eAAO,MAAM,YAAY,QAAO,MAAiB,CAAC;AAClD,qGAAqG;AACrG,eAAO,MAAM,eAAe,QAAO,IAElC,CAAC"}

package/dist/cjs/given.js

@@ -1,13 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.invalidateGiven = exports.givenVersion = exports.setGivenConfig = exports.givenConfig = void 0;
+exports.invalidateGiven = exports.givenVersion = exports.setGivenConfig = exports.givenConfig = exports.currentScope = exports.setScope = void 0;
 let given = {};
 /* Bumped whenever what the accessors may see changes; `config()` keys its
    memo on it, so a host that refreshes `process.env` (the Worker's `bindEnv`,
    once per event) can drop that memo through this module alone, without
    loading the resolver and every accessor behind it. */
 let version = 0;
-const givenConfig = () => given;
+let scope = () => undefined;
+/** Install the reader of the current scope (once, by the host that keeps one). */
+const setScope = (read) => {
+    scope = read;
+    version += 1;
+};
+exports.setScope = setScope;
+const currentScope = () => scope();
+exports.currentScope = currentScope;
+const givenConfig = () => {
+    const current = scope();
+    return current ? { ...given, ...current.given } : given;
+};
 exports.givenConfig = givenConfig;
 const setGivenConfig = (next) => {
     given = next;

package/dist/cjs/given.js.map

@@ -1 +1 @@
-{"version":3,"file":"given.js","sourceRoot":"","sources":["../../src/given.ts"],"names":[],"mappings":";;;AASA,IAAI,KAAK,GAA6B,EAAE,CAAC;AACzC;;;wDAGwD;AACxD,IAAI,OAAO,GAAG,CAAC,CAAC;AAET,MAAM,WAAW,GAAG,GAA6B,EAAE,CAAC,KAAK,CAAC;AAApD,QAAA,WAAW,eAAyC;AAC1D,MAAM,cAAc,GAAG,CAAC,IAA8B,EAAQ,EAAE;IACrE,KAAK,GAAG,IAAI,CAAC;IACb,OAAO,IAAI,CAAC,CAAC;AACf,CAAC,CAAC;AAHW,QAAA,cAAc,kBAGzB;AACF,wFAAwF;AACjF,MAAM,YAAY,GAAG,GAAW,EAAE,CAAC,OAAO,CAAC;AAArC,QAAA,YAAY,gBAAyB;AAClD,qGAAqG;AAC9F,MAAM,eAAe,GAAG,GAAS,EAAE;IACxC,OAAO,IAAI,CAAC,CAAC;AACf,CAAC,CAAC;AAFW,QAAA,eAAe,mBAE1B"}
+{"version":3,"file":"given.js","sourceRoot":"","sources":["../../src/given.ts"],"names":[],"mappings":";;;AASA,IAAI,KAAK,GAA6B,EAAE,CAAC;AACzC;;;wDAGwD;AACxD,IAAI,OAAO,GAAG,CAAC,CAAC;AAahB,IAAI,KAAK,GAA4B,GAAG,EAAE,CAAC,SAAS,CAAC;AACrD,kFAAkF;AAC3E,MAAM,QAAQ,GAAG,CAAC,IAA6B,EAAQ,EAAE;IAC9D,KAAK,GAAG,IAAI,CAAC;IACb,OAAO,IAAI,CAAC,CAAC;AACf,CAAC,CAAC;AAHW,QAAA,QAAQ,YAGnB;AACK,MAAM,YAAY,GAAG,GAAsB,EAAE,CAAC,KAAK,EAAE,CAAC;AAAhD,QAAA,YAAY,gBAAoC;AAEtD,MAAM,WAAW,GAAG,GAA6B,EAAE;IACxD,MAAM,OAAO,GAAG,KAAK,EAAE,CAAC;IACxB,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC1D,CAAC,CAAC;AAHW,QAAA,WAAW,eAGtB;AACK,MAAM,cAAc,GAAG,CAAC,IAA8B,EAAQ,EAAE;IACrE,KAAK,GAAG,IAAI,CAAC;IACb,OAAO,IAAI,CAAC,CAAC;AACf,CAAC,CAAC;AAHW,QAAA,cAAc,kBAGzB;AACF,wFAAwF;AACjF,MAAM,YAAY,GAAG,GAAW,EAAE,CAAC,OAAO,CAAC;AAArC,QAAA,YAAY,gBAAyB;AAClD,qGAAqG;AAC9F,MAAM,eAAe,GAAG,GAAS,EAAE;IACxC,OAAO,IAAI,CAAC,CAAC;AACf,CAAC,CAAC;AAFW,QAAA,eAAe,mBAE1B"}

package/dist/cjs/network.d.ts

@@ -10,9 +10,11 @@
 export declare const NETWORKS: readonly ["devnet", "testnet", "mainnet"];
 export type Network = (typeof NETWORKS)[number];
 export declare function chainNetwork(raw: string | undefined, source?: string): Network;
-/** `configure({ network })`, else `NEXT_PUBLIC_CHAIN_NETWORK`, else testnet. Throws on anything else. */
+/** The call's scope (`given.ts`), else `configure({ network })`, else `NEXT_PUBLIC_CHAIN_NETWORK`, else testnet. Throws on anything else. */
 export declare function network(): Network;
 export declare const hasEnv: () => boolean;
+/** A variable the call's scope holds in place of the environment's (the local MCP's adopted claim form and billing switch). */
+export declare const scopedVar: (name: string) => string | undefined;
 export declare const firstSet: (...values: (string | undefined)[]) => string | undefined;
 /**
  * A count of base units, read strictly: a mis-set variable used to become NaN

package/dist/cjs/network.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/network.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,eAAO,MAAM,QAAQ,2CAA4C,CAAC;AAClE,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,SAA8B,GAAG,OAAO,CAInG;AAED,yGAAyG;AACzG,wBAAgB,OAAO,IAAI,OAAO,CAIjC;AAUD,eAAO,MAAM,MAAM,QAAO,OAAiE,CAAC;AAG5F,eAAO,MAAM,QAAQ,GAAI,GAAG,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,KAAG,MAAM,GAAG,SAAwE,CAAC;AAE/I;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI5E"}
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/network.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,eAAO,MAAM,QAAQ,2CAA4C,CAAC;AAClE,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,SAA8B,GAAG,OAAO,CAInG;AAED,6IAA6I;AAC7I,wBAAgB,OAAO,IAAI,OAAO,CAMjC;AAYD,eAAO,MAAM,MAAM,QAAO,OAAkG,CAAC;AAE7H,+HAA+H;AAC/H,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,SAAuC,CAAC;AAG1F,eAAO,MAAM,QAAQ,GAAI,GAAG,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,KAAG,MAAM,GAAG,SAAwE,CAAC;AAE/I;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI5E"}

package/dist/cjs/network.js

@@ -9,7 +9,7 @@
  * documented default. Deliberately exact. Validated when read, never at import.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.firstSet = exports.hasEnv = exports.NETWORKS = void 0;
+exports.firstSet = exports.scopedVar = exports.hasEnv = exports.NETWORKS = void 0;
 exports.chainNetwork = chainNetwork;
 exports.network = network;
 exports.strictBase = strictBase;
@@ -22,8 +22,11 @@ function chainNetwork(raw, source = "NEXT_PUBLIC_CHAIN_NETWORK") {
         return raw;
     throw new Error(`${source} is ${JSON.stringify(raw)}; it must be one of ${exports.NETWORKS.join(", ")} (or unset for testnet)`);
 }
-/** `configure({ network })`, else `NEXT_PUBLIC_CHAIN_NETWORK`, else testnet. Throws on anything else. */
+/** The call's scope (`given.ts`), else `configure({ network })`, else `NEXT_PUBLIC_CHAIN_NETWORK`, else testnet. Throws on anything else. */
 function network() {
+    const scoped = (0, given_ts_1.currentScope)()?.network;
+    if (scoped !== undefined)
+        return chainNetwork(scoped, "the call's network");
     const given = (0, given_ts_1.givenConfig)().network;
     if (given !== undefined)
         return chainNetwork(given, "configure({ network })");
@@ -37,8 +40,13 @@ function network() {
  * lazily-loaded accessors import this module; first-load code (`docPath`,
  * `engineUrl`, `askDenom`) needs only `given.ts`.
  */
-const hasEnv = () => typeof process !== "undefined" && Boolean(process.env);
+/* In a scope for another network than the one this process's environment names, its overrides are not read:
+   they describe that other network. */
+const hasEnv = () => typeof process !== "undefined" && Boolean(process.env) && (0, given_ts_1.currentScope)()?.env !== false;
 exports.hasEnv = hasEnv;
+/** A variable the call's scope holds in place of the environment's (the local MCP's adopted claim form and billing switch). */
+const scopedVar = (name) => (0, given_ts_1.currentScope)()?.vars[name];
+exports.scopedVar = scopedVar;
 /* `||`, not `??`: an empty variable has always meant "unset" in this repo. */
 const firstSet = (...values) => values.find((value) => value !== undefined && value !== "");
 exports.firstSet = firstSet;

package/dist/cjs/network.js.map

@@ -1 +1 @@
-{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/network.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAOH,oCAIC;AAGD,0BAIC;AAoBD,gCAIC;AAxCD,yCAAyC;AAE5B,QAAA,QAAQ,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAGlE,SAAgB,YAAY,CAAC,GAAuB,EAAE,MAAM,GAAG,2BAA2B;IACxF,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACtD,IAAK,gBAA8B,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,GAAc,CAAC;IACzE,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,uBAAuB,gBAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;AAC1H,CAAC;AAED,yGAAyG;AACzG,SAAgB,OAAO;IACrB,MAAM,KAAK,GAAG,IAAA,sBAAW,GAAE,CAAC,OAAO,CAAC;IACpC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,YAAY,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC;IAC9E,OAAO,YAAY,CAAC,IAAA,cAAM,GAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AACpF,CAAC;AAED;;;;;;;GAOG;AACI,MAAM,MAAM,GAAG,GAAY,EAAE,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAA/E,QAAA,MAAM,UAAyE;AAE5F,8EAA8E;AACvE,MAAM,QAAQ,GAAG,CAAC,GAAG,MAA8B,EAAsB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;AAAlI,QAAA,QAAQ,YAA0H;AAE/I;;;;GAIG;AACH,SAAgB,UAAU,CAAC,GAAuB,EAAE,QAAgB;IAClE,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AACzE,CAAC"}
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/network.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAOH,oCAIC;AAGD,0BAMC;AAyBD,gCAIC;AA/CD,yCAAuD;AAE1C,QAAA,QAAQ,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAGlE,SAAgB,YAAY,CAAC,GAAuB,EAAE,MAAM,GAAG,2BAA2B;IACxF,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACtD,IAAK,gBAA8B,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,GAAc,CAAC;IACzE,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,uBAAuB,gBAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;AAC1H,CAAC;AAED,6IAA6I;AAC7I,SAAgB,OAAO;IACrB,MAAM,MAAM,GAAG,IAAA,uBAAY,GAAE,EAAE,OAAO,CAAC;IACvC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,YAAY,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,IAAA,sBAAW,GAAE,CAAC,OAAO,CAAC;IACpC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,YAAY,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC;IAC9E,OAAO,YAAY,CAAC,IAAA,cAAM,GAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AACpF,CAAC;AAED;;;;;;;GAOG;AACH;uCACuC;AAChC,MAAM,MAAM,GAAG,GAAY,EAAE,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAA,uBAAY,GAAE,EAAE,GAAG,KAAK,KAAK,CAAC;AAAhH,QAAA,MAAM,UAA0G;AAE7H,+HAA+H;AACxH,MAAM,SAAS,GAAG,CAAC,IAAY,EAAsB,EAAE,CAAC,IAAA,uBAAY,GAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;AAA7E,QAAA,SAAS,aAAoE;AAE1F,8EAA8E;AACvE,MAAM,QAAQ,GAAG,CAAC,GAAG,MAA8B,EAAsB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;AAAlI,QAAA,QAAQ,YAA0H;AAE/I;;;;GAIG;AACH,SAAgB,UAAU,CAAC,GAAuB,EAAE,QAAgB;IAClE,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AACzE,CAAC"}

package/dist/cjs/rubric/bridge.d.ts

@@ -510,6 +510,14 @@ export declare function realPhotoRule(shape: {
  * paragraph, because its judge is sent the file.
  */
 export declare const guidanceFor: (type: AskTerms["deliverable"]["type"]) => string;
+/**
+ * What an Expert Review's checks are told the ask is (`reviewRules`): its sentence, what is reviewed at which version,
+ * and the scenarios in order. The ask's sentence alone names neither, and "covers the scenarios" and "reviews this
+ * and not something else" cannot be ruled on without them. `where` stays out: it is for the specialist, not the check.
+ */
+export declare function reviewBrief(terms: AskTerms): string;
+/** The claim-level task every approver ask carries (`approver`): without one a gate review ends UNDECIDED. */
+export declare const APPROVE_TASK = "OH-RT-APPROVE";
 /**
  * Terms → the engine's rubric.
  *

package/dist/cjs/rubric/bridge.d.ts.map

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

package/dist/cjs/rubric/bridge.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.guidanceFor = exports.TEXT_JUDGE_GUIDANCE = exports.JUDGE_GUIDANCE = exports.SITE_KIND_PREAMBLE = exports.JUDGE_SEND_KEYS = exports.SEND_KEYS = exports.UNIQUE_RULE_ID = exports.NAME_CEILING = exports.NOT_ELSEWHERE_FLOOR_METERS = exports.PERSON_CHECKS = exports.PHOTO_CHECKS = exports.JUDGE_NAME = exports.SITE_SOURCE = exports.WITHIN_ASK_RADIUS_SOURCE = exports.COOLDOWN_SOURCE = exports.SOURCE_NAMES = exports.ORACLE_HOST = exports.DEFAULT_COOLDOWN = exports.ON_ERROR = void 0;
+exports.APPROVE_TASK = exports.guidanceFor = exports.TEXT_JUDGE_GUIDANCE = exports.JUDGE_GUIDANCE = exports.SITE_KIND_PREAMBLE = exports.JUDGE_SEND_KEYS = exports.SEND_KEYS = exports.UNIQUE_RULE_ID = exports.NAME_CEILING = exports.NOT_ELSEWHERE_FLOOR_METERS = exports.PERSON_CHECKS = exports.PHOTO_CHECKS = exports.JUDGE_NAME = exports.SITE_SOURCE = exports.WITHIN_ASK_RADIUS_SOURCE = exports.COOLDOWN_SOURCE = exports.SOURCE_NAMES = exports.ORACLE_HOST = exports.DEFAULT_COOLDOWN = exports.ON_ERROR = void 0;
 exports.rubricDocument = rubricDocument;
 exports.realPhotoRule = realPhotoRule;
+exports.reviewBrief = reviewBrief;
 exports.toEngineRubric = toEngineRubric;
+const report_ts_1 = require("./report.js");
 const terms_ts_1 = require("./terms.js");
 /**
  * What every source and AI check says when it could not answer at all.
@@ -417,6 +419,17 @@ const LENGTH_CEILING = 1_000_000;
 const MEGABYTE = 1_048_576;
 /** Bytes as the MB their `maxSizeMB` reads, rounded up to a hundredth so a limit never tightens. */
 const megabytes = (bytes) => Math.ceil((bytes / MEGABYTE) * 100) / 100;
+/**
+ * What an Expert Review's checks are told the ask is (`reviewRules`): its sentence, what is reviewed at which version,
+ * and the scenarios in order. The ask's sentence alone names neither, and "covers the scenarios" and "reviews this
+ * and not something else" cannot be ruled on without them. `where` stays out: it is for the specialist, not the check.
+ */
+function reviewBrief(terms) {
+    const subject = terms.call?.subject;
+    const what = subject ? ` It reviews ${subject.name}${subject.version ? ` version ${subject.version}` : ""}.` : "";
+    const scenarios = terms.call?.scenarios?.length ? ` The scenarios to try: ${terms.call.scenarios.map((one, index) => `${index + 1}. ${one}`).join(" ")}` : "";
+    return `${terms.task.replace(/[.\s]+$/, "")}.${what}${scenarios}`;
+}
 const escapeRegex = (raw) => raw.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 /**
  * A literal as a case-insensitive pattern, spelled out.
@@ -471,6 +484,11 @@ const DOWN_WORDS = [
 /* Bounded on both sides: the gap is capped so the pattern cannot backtrack,
    which is also what keeps it inside their safe-regex subset. */
 const statusPattern = () => [...STATUS_WORDS.map((word) => `${insensitive(word)}[^0-9]{0,16}[0-9]{3}`), ...DOWN_WORDS.map(insensitive)].join("|");
+/** The claim-level task every approver ask carries (`approver`): without one a gate review ends UNDECIDED. */
+exports.APPROVE_TASK = "OH-RT-APPROVE";
+/** One Yes/No for the approver: Yes approves, No rejects. Shown beside the deliverable. */
+/* The engine shows no option labels yet, so the prompt names the two answers in words. */
+const personTask = (id, prompt, show) => ({ "@type": "ReviewTask", id, prompt: `${prompt} Yes approves, No turns it down.`, show, answer: { type: "boolean" }, map: { true: "approve", false: "reject" } });
 /** A native gate: the engine performs it itself. */
 function nativeGate(gate, index) {
     switch (gate.id) {
@@ -684,8 +702,10 @@ function toEngineRubric(terms, binding, options = {}) {
     const pair = normalized.deliverable.type === "photo-pair" || measure("before-after") !== null;
     /* A site, a second file, or a disposal photograph: the bags ride beside the pair. */
     const expectsExtra = normalized.site === true || measure("with-file") !== null || measure("at-registered-point") !== null;
+    /* An Expert Review under its own rules (reportLine.ts `v`): its checks rule on what was to be reviewed and on which scenarios. */
+    const reviewRules = normalized.report?.v === 2 && normalized.call?.kind === "review" && Boolean(normalized.approver);
     const judgeSend = {
-        task: literal(options.task?.trim() || normalized.task),
+        task: literal(options.task?.trim() || (reviewRules ? reviewBrief(normalized) : normalized.task)),
         text: TEXT,
         ...(withPhoto ? { photo: PHOTO } : {}),
         ...(pair ? { before: BEFORE_PHOTO, after: AFTER_PHOTO } : {}),
@@ -695,7 +715,12 @@ function toEngineRubric(terms, binding, options = {}) {
     /* Read off the same shape as the send map, so the paragraph describes what the judge is actually given. */
     const guidance = (0, exports.guidanceFor)(normalized.deliverable.type);
     const gates = [];
+    /* The AI's gates that still refuse when a person gives the final OK (see where the approver's holds are written). */
+    const clearFailures = new Set();
     let review = null;
+    /* The approver's lines, in criteria order; "Approve this answer?" is added after them. */
+    const personTasks = [];
+    const shown = withPhoto ? [PHOTO, TEXT] : [TEXT];
     const aiChecks = [];
     /* Sources by bare name first; the suffix is decided once the count is known. */
     const pending = [];
@@ -800,7 +825,7 @@ function toEngineRubric(terms, binding, options = {}) {
              * cannot decide anything. Cheap, and honest: nothing here pretends the
              * question was not asked.
              */
-            gates.push({
+            const gate = {
                 "@type": "Gate",
                 code: codeFor(index, "judged"),
                 reason: criterion.text,
@@ -808,13 +833,18 @@ function toEngineRubric(terms, binding, options = {}) {
                 when: field(`ai.${name}.valid`, "isTrue"),
                 onFail: "reject",
                 class: "refuted"
-            });
+            };
+            gates.push(gate);
+            /* Under the review rules the report line is only the clear failure (no report, or one of something else): it refuses even with a person behind the ask. */
+            if (reviewRules && criterion.id === report_ts_1.REPORT_CHECK_ID)
+                clearFailures.add(gate);
             return;
         }
-        /* `attest` is the poster's own eye by construction, and there is no
-           poster in this loop. An ask carrying one is not served by the oracle,
-           so it gets no rubric — `servableByOracle` is where that is decided. */
-        throw new Error(`criterion ${criterion.id} is attested by the poster; an oracle cannot serve it`);
+        /* `attest` is a person's eye by construction. With an `approver` it is their Yes/No (a ReviewTask, below);
+           without one there is no person in this loop, so the ask gets no rubric — `servableByOracle` decides that. */
+        if (!normalized.approver)
+            throw new Error(`criterion ${criterion.id} is attested by the poster; an oracle cannot serve it`);
+        personTasks.push(personTask(`OH-RT-${index}`, criterion.text, shown));
     });
     /*
      * Rules the terms do not spell out but every ask of the shape carries.
@@ -974,6 +1004,60 @@ function toEngineRubric(terms, binding, options = {}) {
             }
         }
     }
+    /*
+     * A report ask (`report`, rubric/report.ts): the answer is a structured report — its JSON as the words, every
+     * section the shape and the poster require present — or a report attached as a PDF, which the AI's report line
+     * (`withReport`) reads. Shape by machine here; how good it is stays with the AI line and the person.
+     */
+    if (normalized.report) {
+        extra += 1;
+        /* `reportText` writes one order, kind first and sections last: a heading counts only after `"sections":{`. */
+        const keys = [`^${escapeRegex(`{"kind":"${report_ts_1.REPORT_KIND}","summary":{`)}`, ...report_ts_1.REPORT_KEYS.slice(1).map((key) => escapeRegex(`,"${key}":[`)), ...normalized.report.sections.map((heading) => `${escapeRegex('"sections":{')}.*${escapeRegex(`${JSON.stringify(heading)}:"`)}`)];
+        gates.push({
+            "@type": "Gate",
+            code: codeFor(extra, "report"),
+            reason: "This ask wants a review report: hand in the structured report with every section it asks for, or attach the report as a PDF",
+            when: { "@type": "Condition", any: [{ "@type": "Condition", all: keys.map((key) => field(TEXT, "matches", key)) }, field(PHOTO, "mediaTypeIn", ["application/pdf"])] },
+            onFail: "reject",
+            class: "insufficient_evidence"
+        });
+        /*
+         * The review rules (reportLine.ts `v`), by machine where the words can be read: a written report with no evidence
+         * at all is refused (a PDF carries its own), and one that states no limitations is the person's to weigh.
+         */
+        if (reviewRules) {
+            extra += 1;
+            gates.push({
+                "@type": "Gate",
+                code: codeFor(extra, "report-evidence"),
+                reason: "A review report needs its evidence: attach at least one screenshot, recording or trace and name it under a step's or a finding's evidence",
+                when: { "@type": "Condition", any: [field(TEXT, "matches", escapeRegex('"evidence":["')), field(PHOTO, "mediaTypeIn", ["application/pdf"])] },
+                onFail: "reject",
+                class: "insufficient_evidence"
+            });
+            extra += 1;
+            gates.push({
+                "@type": "Gate",
+                code: codeFor(extra, "report-limits"),
+                reason: "The report states no limitations: say what could not be tested, or why the result may not hold",
+                when: { "@type": "Condition", any: [field(TEXT, "matches", escapeRegex(',"limitations":["')), field(PHOTO, "mediaTypeIn", ["application/pdf"])] },
+                onFail: "review",
+                class: "insufficient_evidence"
+            });
+        }
+    }
+    /*
+     * A person gives the final OK (`approver`): every claim the rules above let through is held for them. The gate
+     * reads the deliverable gate 0 already required, as `empty`, so it always fails once reached, last, after every
+     * `reject`. Its `review` ends UNDECIDED without a claim-level task (engine decide.ts), so one always rides:
+     * "Approve this answer?", beside the poster's own lines. Any No rejects; all Yes approves.
+     */
+    if (normalized.approver) {
+        extra += 1;
+        personTasks.push(personTask(exports.APPROVE_TASK, "Approve this answer?", shown));
+        review = review ? { ...review, tasks: [...review.tasks, ...personTasks] } : { "@type": "HumanReview", assignTo: { role: "reviewer" }, slaHours: 48, onTimeout: "reject", tasks: personTasks };
+        gates.push({ "@type": "Gate", code: codeFor(extra, "person"), reason: "A person gives final approval", when: { ...gates[0].when, op: "empty" }, onFail: "review", class: "requires_human_review" });
+    }
     /*
      * Names, finally. A vocabulary word is used bare the first time and with a
      * suffix from 2 when the same rule repeats within one rubric —
@@ -999,6 +1083,21 @@ function toEngineRubric(terms, binding, options = {}) {
             timeoutMs: SOURCE_TIMEOUT_MS
         };
     });
+    /*
+     * A person gives the final OK: only a deterministic failure refuses on its own (the deliverable missing, a wrong file
+     * type or size, the report's shape, a duplicate). Anything a model or an outside check says, including that it could
+     * not say, is the person's to weigh: those gates hold for review, and an errored check holds rather than refuses.
+     */
+    if (normalized.approver) {
+        const readsFacts = (gate) => /"field":"(ext|ai)\./.test(JSON.stringify(gate.when));
+        for (const gate of gates)
+            if (gate.onFail === "reject" && readsFacts(gate) && !clearFailures.has(gate))
+                gate.onFail = "review";
+        for (const source of sources)
+            source.onError = "review";
+        for (const check of aiChecks)
+            check.onError = "review";
+    }
     /* The same photograph, handed in twice, is paid once. Keyed by the
        photograph; the attachment lanes (exact CID and near-duplicate) cover
        every file on the claim regardless. One band: a near-certain duplicate