@agalmic/contextengine 0.1.0 → 0.2.0

package/dist/contextengine.mjs

@@ -7618,8 +7618,8 @@ var require_bytes32 = __commonJS({
     var constants_1 = require_lib8();
     var bytes_1 = require_lib2();
     var utf8_1 = require_utf8();
-    function formatBytes32String(text4) {
-      var bytes = (0, utf8_1.toUtf8Bytes)(text4);
+    function formatBytes32String(text5) {
+      var bytes = (0, utf8_1.toUtf8Bytes)(text5);
       if (bytes.length > 31) {
         throw new Error("bytes32 string must be less than 32 bytes");
       }
@@ -8137,8 +8137,8 @@ var require_id = __commonJS({
     exports.id = void 0;
     var keccak256_1 = require_lib5();
     var strings_1 = require_lib9();
-    function id(text4) {
-      return (0, keccak256_1.keccak256)((0, strings_1.toUtf8Bytes)(text4));
+    function id(text5) {
+      return (0, keccak256_1.keccak256)((0, strings_1.toUtf8Bytes)(text5));
     }
     exports.id = id;
   }
@@ -21923,13 +21923,13 @@ var require_aes_js = __commonJS({
         targetArray.set(sourceArray, targetStart);
       }
       var convertUtf8 = /* @__PURE__ */ (function() {
-        function toBytes(text4) {
+        function toBytes(text5) {
           var result = [], i = 0;
-          text4 = encodeURI(text4);
-          while (i < text4.length) {
-            var c = text4.charCodeAt(i++);
+          text5 = encodeURI(text5);
+          while (i < text5.length) {
+            var c = text5.charCodeAt(i++);
             if (c === 37) {
-              result.push(parseInt(text4.substr(i, 2), 16));
+              result.push(parseInt(text5.substr(i, 2), 16));
               i += 2;
             } else {
               result.push(c);
@@ -21960,10 +21960,10 @@ var require_aes_js = __commonJS({
         };
       })();
       var convertHex = /* @__PURE__ */ (function() {
-        function toBytes(text4) {
+        function toBytes(text5) {
           var result = [];
-          for (var i = 0; i < text4.length; i += 2) {
-            result.push(parseInt(text4.substr(i, 2), 16));
+          for (var i = 0; i < text5.length; i += 2) {
+            result.push(parseInt(text5.substr(i, 2), 16));
           }
           return result;
         }
@@ -31004,7 +31004,7 @@ var require_websocket = __commonJS({
     var http = __require("http");
     var net = __require("net");
     var tls = __require("tls");
-    var { randomBytes, createHash } = __require("crypto");
+    var { randomBytes, createHash: createHash2 } = __require("crypto");
     var { Readable } = __require("stream");
     var { URL: URL2 } = __require("url");
     var PerMessageDeflate = require_permessage_deflate();
@@ -31586,7 +31586,7 @@ var require_websocket = __commonJS({
           abortHandshake(websocket, socket, "Invalid Upgrade header");
           return;
         }
-        const digest = createHash("sha1").update(key + GUID).digest("base64");
+        const digest = createHash2("sha1").update(key + GUID).digest("base64");
         if (res.headers["sec-websocket-accept"] !== digest) {
           abortHandshake(websocket, socket, "Invalid Sec-WebSocket-Accept header");
           return;
@@ -31900,7 +31900,7 @@ var require_websocket_server = __commonJS({
     var https = __require("https");
     var net = __require("net");
     var tls = __require("tls");
-    var { createHash } = __require("crypto");
+    var { createHash: createHash2 } = __require("crypto");
     var PerMessageDeflate = require_permessage_deflate();
     var WebSocket = require_websocket();
     var { format, parse } = require_extension();
@@ -32127,7 +32127,7 @@ var require_websocket_server = __commonJS({
           );
         }
         if (this._state > RUNNING) return abortHandshake(socket, 503);
-        const digest = createHash("sha1").update(key + GUID).digest("base64");
+        const digest = createHash2("sha1").update(key + GUID).digest("base64");
         const headers = [
           "HTTP/1.1 101 Switching Protocols",
           "Upgrade: websocket",
@@ -32137,7 +32137,7 @@ var require_websocket_server = __commonJS({
         const ws = new WebSocket(null);
         let protocol = req.headers["sec-websocket-protocol"];
         if (protocol) {
-          protocol = protocol.split(",").map(trim7);
+          protocol = protocol.split(",").map(trim9);
           if (this.options.handleProtocols) {
             protocol = this.options.handleProtocols(protocol, req);
           } else {
@@ -32206,7 +32206,7 @@ var require_websocket_server = __commonJS({
       socket.removeListener("error", socketOnError);
       socket.destroy();
     }
-    function trim7(str) {
+    function trim9(str) {
       return str.trim();
     }
   }
@@ -36317,10 +36317,9 @@ var require_rpcDefaults = __commonJS({
   }
 });
 
-// client/src/utilities/crypto/groupPasswordDerivation.cjs
+// shared/crypto/groupPasswordDerivation.cjs
 var require_groupPasswordDerivation = __commonJS({
-  "client/src/utilities/crypto/groupPasswordDerivation.cjs"(exports, module) {
-    "use strict";
+  "shared/crypto/groupPasswordDerivation.cjs"(exports, module) {
     var GROUP_PASSWORD_DERIVATION = "sbt-group-password-v4";
     var GROUP_PASSWORD_PBKDF2_ITERATIONS = 6e5;
     var createGroupPasswordDerivation2 = (ethers7) => {
@@ -36407,15 +36406,15 @@ var SETTINGS = Object.freeze({
 var MAX_LABEL_LENGTH = 80;
 var trim = (value) => String(value ?? "").trim();
 var normalizeLabel = (value, field) => {
-  const text4 = trim(value).replace(/\s+/g, " ");
-  if (text4.length > MAX_LABEL_LENGTH) throw new Error(`${field} must be ${MAX_LABEL_LENGTH} characters or fewer.`);
-  return text4;
+  const text5 = trim(value).replace(/\s+/g, " ");
+  if (text5.length > MAX_LABEL_LENGTH) throw new Error(`${field} must be ${MAX_LABEL_LENGTH} characters or fewer.`);
+  return text5;
 };
 var normalizeHttpOrigin = (value, field) => {
-  const text4 = trim(value);
+  const text5 = trim(value);
   let parsed;
   try {
-    parsed = new URL(text4);
+    parsed = new URL(text5);
   } catch {
     throw new Error(`${field} must be an http(s) origin.`);
   }
@@ -36426,11 +36425,11 @@ var normalizeHttpOrigin = (value, field) => {
 };
 var isLocalUrl = (url) => ["localhost", "127.0.0.1", "[::1]"].includes(url.hostname);
 var normalizeRpcUrl = (value, allowLocal) => {
-  const text4 = trim(value);
-  if (!text4) return "";
+  const text5 = trim(value);
+  if (!text5) return "";
   let parsed;
   try {
-    parsed = new URL(text4);
+    parsed = new URL(text5);
   } catch {
     throw new Error("CE_MCP_RPC_URL must be an https URL.");
   }
@@ -36495,13 +36494,22 @@ var ensureStateDir = async (stateDir) => {
 var writeOwnerOnlyJson = async (filePath, value, { exclusive = false } = {}) => {
   const body = `${JSON.stringify(value, null, 2)}
 `;
-  if (exclusive) {
-    await fs.writeFile(filePath, body, { mode: OWNER_ONLY_FILE, flag: "wx" });
-    return;
-  }
   const temporary = `${filePath}.${process.pid}.${crypto.randomBytes(6).toString("hex")}.tmp`;
   await fs.writeFile(temporary, body, { mode: OWNER_ONLY_FILE, flag: "wx" });
-  await fs.rename(temporary, filePath);
+  try {
+    if (exclusive) {
+      try {
+        await fs.link(temporary, filePath);
+      } catch (error) {
+        if (!["EPERM", "ENOTSUP", "EXDEV"].includes(error?.code)) throw error;
+        await fs.writeFile(filePath, body, { mode: OWNER_ONLY_FILE, flag: "wx" });
+      }
+    } else {
+      await fs.rename(temporary, filePath);
+    }
+  } finally {
+    await fs.rm(temporary, { force: true });
+  }
 };
 var readKeyFile = async (keyPath) => {
   const info = await fs.lstat(keyPath);
@@ -36521,8 +36529,7 @@ var readKeyFile = async (keyPath) => {
   }
   return wallet;
 };
-var loadOrCreateWallet = async (stateDir) => {
-  await ensureStateDir(stateDir);
+var loadOrCreateKey = async (stateDir) => {
   const keyPath = path2.join(stateDir, KEY_FILE);
   for (let attempt = 0; attempt < 2; attempt += 1) {
     try {
@@ -36530,6 +36537,12 @@ var loadOrCreateWallet = async (stateDir) => {
     } catch (error) {
       if (error?.code !== "ENOENT") throw error;
     }
+    const saved = await readAgentState(stateDir);
+    if (saved.address || Object.keys(saved.sessions).length) {
+      throw new Error(
+        `${keyPath} is missing, but ${STATE_FILE} belongs to ${saved.address ? `agent ${saved.address}` : "an earlier agent"}. Restore the key from a backup, or move ${STATE_FILE} aside to start as a new agent.`
+      );
+    }
     const wallet = import_ethers.ethers.Wallet.createRandom();
     try {
       await writeOwnerOnlyJson(
@@ -36544,7 +36557,21 @@ var loadOrCreateWallet = async (stateDir) => {
   }
   throw new Error(`${keyPath} could not be read or created.`);
 };
-var emptyState = () => ({ version: 1, profile: {}, sessions: {}, current: "" });
+var loadOrCreateWallet = async (stateDir) => {
+  await ensureStateDir(stateDir);
+  const loaded = await loadOrCreateKey(stateDir);
+  await withStateWriter(stateDir, async () => {
+    const state = await readAgentState(stateDir);
+    if (state.address && state.address.toLowerCase() !== loaded.wallet.address.toLowerCase()) {
+      throw new Error(
+        `${path2.join(stateDir, STATE_FILE)} belongs to agent ${state.address}, but ${KEY_FILE} holds ${loaded.wallet.address}. Restore the matching files, or move ${STATE_FILE} aside to start fresh with this key.`
+      );
+    }
+    if (!state.address) await writeOwnerOnlyJson(path2.join(stateDir, STATE_FILE), { ...state, address: loaded.wallet.address });
+  });
+  return loaded;
+};
+var emptyState = () => ({ version: 1, address: "", profile: {}, sessions: {}, current: "" });
 var readAgentState = async (stateDir) => {
   let parsed;
   try {
@@ -36556,6 +36583,8 @@ var readAgentState = async (stateDir) => {
   if (!isRecord(parsed)) return emptyState();
   return {
     version: 1,
+    // The agent this state belongs to; its remembered answers are that agent's.
+    address: typeof parsed.address === "string" ? parsed.address : "",
     profile: isRecord(parsed.profile) ? parsed.profile : {},
     sessions: isRecord(parsed.sessions) ? parsed.sessions : {},
     current: typeof parsed.current === "string" ? parsed.current : ""
@@ -36606,7 +36635,15 @@ var hasId = (message) => Object.prototype.hasOwnProperty.call(message, "id");
 var isValidId = (id) => typeof id === "string" || typeof id === "number" && Number.isFinite(id);
 var errorResponse = (id, code, message) => ({ jsonrpc: "2.0", id, error: { code, message } });
 var resultResponse = (id, result) => ({ jsonrpc: "2.0", id, result });
-var describeError = (error) => String(error?.message || error || "Unknown error.");
+var MAX_ERROR_LENGTH = 1e3;
+var DIAGNOSTICS = /\[ See: |\((?=\w+=)|\b(?:requestBody|body|url|transaction|data|error)=/i;
+var URLS = /\b[a-z][\w+.-]*:\/\/[^\s"'`]+/gi;
+var hostOnly = (url) => /<\w+>/.test(url) ? url : url.replace(/^([^:]+:\/\/)(?:[^/?#]*@)?([^/?#]*)[\s\S]*$/, "$1$2");
+var describeError = (error) => {
+  const text5 = String(error?.message || error || "").slice(0, MAX_ERROR_LENGTH);
+  const cut = text5.search(DIAGNOSTICS);
+  return (cut < 0 ? text5 : text5.slice(0, cut)).trimEnd().replace(URLS, hostOnly) || "Unknown error.";
+};
 var DEFAULT_TOOL_TIMEOUT_MS = 15 * 60 * 1e3;
 var createMcpServer = ({
   serverInfo,
@@ -36628,8 +36665,8 @@ var createMcpServer = ({
     ...annotations ? { annotations } : {}
   }));
   const toolResult = (value, isError = false) => {
-    const text4 = typeof value === "string" ? value : JSON.stringify(value, null, 2);
-    const result = { content: [{ type: "text", text: text4 }] };
+    const text5 = typeof value === "string" ? value : JSON.stringify(value, null, 2);
+    const result = { content: [{ type: "text", text: text5 }] };
     if (!isError && isRecord2(value) && protocolVersion >= STRUCTURED_CONTENT_SINCE) {
       result.structuredContent = value;
     }
@@ -36724,11 +36761,11 @@ var createMcpServer = ({
     }
   };
   const handleLine = async (line) => {
-    const text4 = String(line || "").trim();
-    if (!text4) return "";
+    const text5 = String(line || "").trim();
+    if (!text5) return "";
     let decoded;
     try {
-      decoded = JSON.parse(text4);
+      decoded = JSON.parse(text5);
     } catch {
       return JSON.stringify(errorResponse(null, PARSE_ERROR, "Parse error."));
     }
@@ -36801,13 +36838,45 @@ var describeTestEthOffer = ({ config, resourcePresence } = {}) => {
     return { ...result, reason: "Session config is unavailable or unsupported." };
   }
   if (!network) return { ...result, reason: "No supported test network is configured." };
-  if (hosted && !(Array.isArray(config.workerAuthority?.participantScopes) && config.workerAuthority.participantScopes.includes("faucet"))) {
+  if (hosted && !(Array.isArray(config.workerAuthority?.participantScopes) && config.workerAuthority.participantScopes.some((scope) => scope === "faucet_self" || scope === "faucet"))) {
     return { ...result, reason: "Participants are not offered test ETH." };
   }
   if (resourcePresence?.txGas !== true) return { ...result, reason: "A configured faucet has not been confirmed." };
   return { ...result, offered: true };
 };
 
+// mcp/lib/chainErrors.mjs
+var SAFE_CODE = /^[A-Z_]{3,40}$/;
+var SAFE_REASON = /^[A-Za-z][\w .,'()-]{0,119}$/;
+var TX_HASH = /^0x[0-9a-f]{64}$/i;
+var safeErrorCode = (error) => typeof error?.code === "string" && SAFE_CODE.test(error.code) ? error.code : "";
+var safeErrorReason = (error) => [error?.reason, error?.errorName, error?.error?.reason].map((value) => typeof value === "string" ? value.replace(/^execution reverted:?\s*/i, "").trim() : "").find((value) => SAFE_REASON.test(value)) || "";
+var transactionHashOf = (error) => [error?.transactionHash, error?.transaction?.hash, error?.receipt?.transactionHash].find((value) => typeof value === "string" && TX_HASH.test(value));
+var safeChainError = (error, { submission = false } = {}) => {
+  const code = safeErrorCode(error);
+  const detail = [code, safeErrorReason(error)].filter(Boolean).join(": ");
+  const note = detail ? ` (${detail})` : "";
+  if (submission) {
+    const txHash = transactionHashOf(error);
+    return Object.assign(
+      new Error(`${txHash ? `Transaction ${txHash}` : "The transaction"} may have been submitted but its outcome is unknown${note}. Check the chain before retrying.`),
+      { ...code ? { code } : {}, reconciliationRequired: true, ...txHash ? { txHash } : {} }
+    );
+  }
+  const retryable = code !== "CALL_EXCEPTION";
+  return Object.assign(
+    new Error(retryable ? `The chain request failed${note}. Check the RPC connection and retry.` : `The contract rejected the request${note}.`),
+    { ...code ? { code } : {}, retryable }
+  );
+};
+var chainRequest = async (request, options) => {
+  try {
+    return await request();
+  } catch (error) {
+    throw safeChainError(error, options);
+  }
+};
+
 // mcp/lib/testEth.mjs
 var amount = (value) => typeof value === "string" && /^\d+(?:\.\d{1,18})?$/.test(value) ? value : null;
 var pause = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
@@ -36836,15 +36905,16 @@ var createTestEthRequester = ({
   await ctx.client.ensureToken();
   if (ctx.client.tokenClaims?.scopes?.faucet !== true) throw new Error("This session does not offer test ETH to you.");
   const provider = suppliedProvider || createProvider(chainId);
-  const reported = Number(await provider.send("eth_chainId", []));
+  const reported = Number(await chainRequest(() => provider.send("eth_chainId", [])));
   if (reported !== chainId) throw new Error(`The RPC for chain ${chainId} reports chain ${reported}; refusing the faucet request.`);
-  const before = await provider.getBalance(wallet.address);
+  const before = await chainRequest(() => provider.getBalance(wallet.address));
   checkpoint();
   let paid;
   try {
     paid = await ctx.client.request("/", {
       method: "POST",
       auth: true,
+      signal,
       headers: { "X-Session-Slug": ctx.info.slug },
       body: { action: "request_test_eth", to: wallet.address }
     });
@@ -36872,7 +36942,7 @@ var createTestEthRequester = ({
     let observed;
     try {
       observed = await Promise.race([
-        provider.getBalance(wallet.address).catch(() => null),
+        chainRequest(() => provider.getBalance(wallet.address)).catch(() => null),
         new Promise((resolve) => {
           timer = setTimeout(() => resolve(null), Math.max(0, deadline - now()));
         })
@@ -36895,9 +36965,23 @@ var createTestEthRequester = ({
   };
 };
 
+// mcp/lib/participant.mjs
+import { createHash, randomUUID as randomUUID2 } from "node:crypto";
+
 // mcp/lib/registrySession.mjs
 var import_ethers5 = __toESM(require_lib32(), 1);
 
+// shared/responseReadWindow.mjs
+var responsePairKey = (responder, id) => `${String(responder || "").toLowerCase()}|${String(id || "").toLowerCase()}`;
+var responseReadWindowOptions = (window2, responder, id) => window2 ? {
+  _responseReadWindow: window2,
+  blockTag: window2.laterPairs && !window2.laterPairs.has(responsePairKey(responder, id)) ? window2.unchangedBlockTag : window2.blockTag
+} : {};
+var historicalResponseReadError = (error, blockTag) => Object.assign(
+  new Error(`Response state at block ${String(blockTag)} is unavailable: ${error instanceof Error ? error.message : String(error)}`),
+  { code: "RESPONSE_HISTORY_UNAVAILABLE", retryable: true, blockTag, cause: error }
+);
+
 // client/src/variables/contracts.json
 var contracts_default = {
   sessionRegistryAddresses: {
@@ -38193,50 +38277,41 @@ var normalizeRatingScale = (question = {}) => {
     )
   };
 };
+var DEFAULT_RATING_SCALE = Object.freeze({ min: 0, max: 10, minLabel: "0", maxLabel: "10" });
+var ratingStepFor = (question = {}) => {
+  const source = [question.scale, question.ratingScale].find((record) => isObj(record) && recordHasRatingScaleMetadata(record)) || question;
+  const step = Number(source.step);
+  return Number.isFinite(step) && step > 0 ? step : 1;
+};
+var decimalPlaces = (value) => {
+  const [coefficient, exponent = "0"] = String(value).split("e");
+  return Math.max(0, (coefficient.split(".")[1]?.length || 0) - Number(exponent));
+};
+var normalizeRatingAnswer = (value, question = {}) => {
+  if (typeof value !== "number" && typeof value !== "string") return null;
+  if (typeof value === "string" && value.trim() === "") return null;
+  const number = Number(value);
+  const { min, max } = normalizeRatingScale(question) || DEFAULT_RATING_SCALE;
+  const step = ratingStepFor(question);
+  const index = (number - min) / step;
+  if (!Number.isFinite(number) || number < min || number > max || !Number.isFinite(index) || Math.abs(index - Math.round(index)) > 1e-9) return null;
+  const precision = Math.min(100, Math.max(decimalPlaces(step), decimalPlaces(min)));
+  return Number((min + Math.round(index) * step).toFixed(precision));
+};
 
-// mcp/lib/records.mjs
+// shared/questions/answerValue.mjs
 var QUESTION_TYPES = Object.freeze(["binary", "rating", "multichoice", "quadratic", "freeform"]);
 var BINARY_ANSWERS = Object.freeze(["Agree", "Unsure", "Disagree"]);
-var MAX_PROMPT_LENGTH = 1e3;
-var MAX_OPTION_LENGTH = 200;
-var MAX_OPTIONS = 12;
-var MAX_TAGS = 10;
-var MAX_TAG_LENGTH = 40;
 var MAX_FREEFORM_LENGTH = 8e3;
-var MAX_COMMENT_LENGTH = 4e3;
 var trim3 = (value) => typeof value === "string" ? value.trim() : typeof value === "number" ? String(value) : "";
-var isRecord3 = (value) => !!value && typeof value === "object" && !Array.isArray(value);
 var fail = (error) => ({ ok: false, error });
-var generateQuestionId = (type, prompt, options = [], singleSelect = false, voiceCredits = 99) => {
-  let dataToHash = `${type}:${(prompt || "").trim().toLowerCase()}`;
-  const validOptions = Array.isArray(options) ? options.filter((option) => typeof option === "string" && option.trim() !== "") : [];
-  if (type === "multichoice") {
-    if (validOptions.length > 0) dataToHash += `:${validOptions.map((option) => option.trim()).join(",").toLowerCase()}`;
-    if (singleSelect) dataToHash += ":single";
-  }
-  if (type === "quadratic") {
-    dataToHash += `:${JSON.stringify(validOptions.map((option) => option.trim().toLowerCase()))}:${voiceCredits}`;
-  }
-  return import_ethers3.ethers.utils.id(dataToHash);
-};
-var ratingScaleFor = (question = {}) => normalizeRatingScale(question) || { min: 0, max: 10, minLabel: "0", maxLabel: "10" };
+var ratingScaleFor = (question = {}) => ({ ...normalizeRatingScale(question) || DEFAULT_RATING_SCALE, step: ratingStepFor(question) });
 var optionsOf = (question) => Array.isArray(question.options) ? question.options.filter((option) => typeof option === "string") : [];
 var isSingleSelect = (question) => question.singleSelect === true || question.oneSelectionOnly === true || question.singleChoice === true;
-var isLockedQuestion = (question) => question?.locked === true || !!question?.promptEncrypted || !!question?.encryption && typeof question.encryption === "object" || typeof question?.prompt === "string" && question.prompt.trim() === "[encrypted]";
-var normalizeRecruitmentSource = (value) => {
-  const normalized2 = (typeof value === "string" ? value : "").trim().replace(/\s+/g, "-").slice(0, 128);
-  return /^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,127}$/.test(normalized2) ? normalized2 : "";
-};
 var matchOption = (options, value) => {
   const wanted = trim3(value).toLowerCase();
   return options.find((option) => option.trim().toLowerCase() === wanted);
 };
-var readScore = (value, field) => {
-  if (value === void 0 || value === null || value === "") return { ok: true, value: null };
-  const number = Number(value);
-  if (!Number.isInteger(number) || number < 0 || number > 10) return fail(`${field} must be a whole number from 0 to 10.`);
-  return { ok: true, value: number };
-};
 var normalizeAnswerValue = (question = {}, value) => {
   switch (question.type) {
     case "binary": {
@@ -38245,9 +38320,9 @@ var normalizeAnswerValue = (question = {}, value) => {
     }
     case "rating": {
       const scale = ratingScaleFor(question);
-      const number = typeof value === "string" && trim3(value) !== "" ? Number(value) : value;
-      if (!Number.isInteger(number) || number < scale.min || number > scale.max) {
-        return fail(`Rating answers must be a whole number from ${scale.min} to ${scale.max}.`);
+      const number = normalizeRatingAnswer(value, question);
+      if (number === null) {
+        return fail(`Rating answers must be from ${scale.min} to ${scale.max} in increments of ${scale.step} from ${scale.min}.`);
       }
       return { ok: true, value: number };
     }
@@ -38275,15 +38350,72 @@ var normalizeAnswerValue = (question = {}, value) => {
       return { ok: true, value: votes };
     }
     case "freeform": {
-      const text4 = trim3(value);
-      if (!text4) return fail("Freeform answers must be non-empty text.");
-      if (text4.length > MAX_FREEFORM_LENGTH) return fail(`Freeform answers must be ${MAX_FREEFORM_LENGTH} characters or fewer.`);
-      return { ok: true, value: text4 };
+      const text5 = trim3(value);
+      if (!text5) return fail("Freeform answers must be non-empty text.");
+      if (text5.length > MAX_FREEFORM_LENGTH) return fail(`Freeform answers must be ${MAX_FREEFORM_LENGTH} characters or fewer.`);
+      return { ok: true, value: text5 };
     }
     default:
       return fail(`Unsupported question type "${trim3(question.type)}".`);
   }
 };
+
+// shared/questions/questionId.mjs
+var validOptions = (options) => Array.isArray(options) ? options.filter((o) => o && o.trim() !== "") : [];
+var legacyPreimage = (type, prompt, options, singleSelect, voiceCredits) => {
+  let preimage = `${type}:${(prompt || "").trim().toLowerCase()}`;
+  const validOpts = validOptions(options);
+  if (type === "multichoice") {
+    if (validOpts.length > 0)
+      preimage += `:${validOpts.map((o) => o.trim()).join(",").toLowerCase()}`;
+    if (singleSelect) preimage += ":single";
+  }
+  if (type === "quadratic") {
+    preimage += `:${JSON.stringify(validOpts.map((option) => option.trim().toLowerCase()))}:${voiceCredits}`;
+  }
+  return preimage;
+};
+var legacyIsAmbiguous = (type, options, singleSelect) => {
+  if (type !== "multichoice") return false;
+  const labels = validOptions(options).map((o) => o.trim().toLowerCase());
+  return labels.length === 0 || labels.some((label) => label.includes(":") || label.includes(",")) || !singleSelect && labels.length === 1 && labels[0] === "single";
+};
+var v2Text = (text5) => (text5 || "").trim().toLowerCase().normalize("NFC");
+var v2Preimage = (type, prompt, options, singleSelect) => JSON.stringify(["ce-question-id", 2, type, v2Text(prompt), validOptions(options).map(v2Text), !!singleSelect]);
+var createQuestionIdDerivation = (ethers7) => {
+  const { id: hash } = ethers7.utils;
+  const generateQuestionId2 = (type, prompt, options = [], singleSelect = false, voiceCredits = 99) => hash(
+    legacyIsAmbiguous(type, options, singleSelect) ? v2Preimage(type, prompt, options, singleSelect) : legacyPreimage(type, prompt, options, singleSelect, voiceCredits)
+  );
+  const questionIdMatchesContent2 = (id, { type, prompt, options = [], singleSelect = false, voiceCredits = 99 } = {}) => {
+    const wanted = String(id).toLowerCase();
+    return hash(legacyPreimage(type, prompt, options, singleSelect, voiceCredits)) === wanted || type === "multichoice" && hash(v2Preimage(type, prompt, options, singleSelect)) === wanted;
+  };
+  return Object.freeze({ generateQuestionId: generateQuestionId2, questionIdMatchesContent: questionIdMatchesContent2 });
+};
+
+// mcp/lib/records.mjs
+var MAX_PROMPT_LENGTH = 1e3;
+var MAX_OPTION_LENGTH = 200;
+var MAX_OPTIONS = 12;
+var MAX_TAGS = 10;
+var MAX_TAG_LENGTH = 40;
+var MAX_COMMENT_LENGTH = 4e3;
+var trim4 = (value) => typeof value === "string" ? value.trim() : typeof value === "number" ? String(value) : "";
+var isRecord3 = (value) => !!value && typeof value === "object" && !Array.isArray(value);
+var fail2 = (error) => ({ ok: false, error });
+var { generateQuestionId, questionIdMatchesContent } = createQuestionIdDerivation(import_ethers3.ethers);
+var isLockedQuestion = (question) => question?.locked === true || !!question?.promptEncrypted || !!question?.encryption && typeof question.encryption === "object" || typeof question?.prompt === "string" && question.prompt.trim() === "[encrypted]";
+var normalizeRecruitmentSource = (value) => {
+  const normalized2 = (typeof value === "string" ? value : "").trim().replace(/\s+/g, "-").slice(0, 128);
+  return /^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,127}$/.test(normalized2) ? normalized2 : "";
+};
+var readScore = (value, field) => {
+  if (value === void 0 || value === null || value === "") return { ok: true, value: null };
+  const number = Number(value);
+  if (!Number.isInteger(number) || number < 0 || number > 10) return fail2(`${field} must be a whole number from 0 to 10.`);
+  return { ok: true, value: number };
+};
 var plaintextField = (value, hash) => ({
   value,
   encrypted: false,
@@ -38296,8 +38428,8 @@ var plaintextField = (value, hash) => ({
 var textHash = (value) => typeof value === "string" && value ? import_ethers3.ethers.utils.id(value) : "";
 var buildParticipantMarker = ({ modelId = "", platform = "" } = {}) => ({
   kind: "agent",
-  ...trim3(modelId) ? { modelId: trim3(modelId) } : {},
-  ...trim3(platform) ? { platform: trim3(platform) } : {},
+  ...trim4(modelId) ? { modelId: trim4(modelId) } : {},
+  ...trim4(platform) ? { platform: trim4(platform) } : {},
   verification: "self_reported"
 });
 var buildResponseRecord = ({
@@ -38311,21 +38443,21 @@ var buildResponseRecord = ({
   profile = {},
   recruitmentSource = ""
 }) => {
-  if (!isRecord3(question) || !trim3(question.id)) return fail("Unknown question.");
-  if (isLockedQuestion(question)) return fail("This question is locked to certain members; agents cannot answer locked questions yet.");
+  if (!isRecord3(question) || !trim4(question.id)) return fail2("Unknown question.");
+  if (isLockedQuestion(question)) return fail2("This question is locked to certain members; agents cannot answer locked questions yet.");
   const answer = normalizeAnswerValue(question, value);
   if (!answer.ok) return answer;
-  const note = trim3(comment);
-  if (note.length > MAX_COMMENT_LENGTH) return fail(`Comments must be ${MAX_COMMENT_LENGTH} characters or fewer.`);
+  const note = trim4(comment);
+  if (note.length > MAX_COMMENT_LENGTH) return fail2(`Comments must be ${MAX_COMMENT_LENGTH} characters or fewer.`);
   const convictionScore = readScore(conviction, "Conviction");
   if (!convictionScore.ok) return convictionScore;
   const importanceScore = readScore(importance, "Importance");
   if (!importanceScore.ok) return importanceScore;
-  const displayName = trim3(profile.displayName);
+  const displayName = trim4(profile.displayName);
   return {
     ok: true,
     record: {
-      questionID: trim3(question.id).toLowerCase(),
+      questionID: trim4(question.id).toLowerCase(),
       responder: import_ethers3.ethers.utils.getAddress(responder),
       type: question.type,
       prompt: typeof question.prompt === "string" ? question.prompt : "",
@@ -38343,19 +38475,19 @@ var buildResponseRecord = ({
   };
 };
 var normalizeOptionList = (options) => {
-  const list = (Array.isArray(options) ? options : []).map(trim3).filter(Boolean);
-  if (list.length < 2) return fail("Provide at least two options.");
-  if (list.length > MAX_OPTIONS) return fail(`Provide at most ${MAX_OPTIONS} options.`);
-  if (list.some((option) => option.length > MAX_OPTION_LENGTH)) return fail(`Options must be ${MAX_OPTION_LENGTH} characters or fewer.`);
-  if (new Set(list.map((option) => option.toLowerCase())).size !== list.length) return fail("Options must be unique.");
+  const list = (Array.isArray(options) ? options : []).map(trim4).filter(Boolean);
+  if (list.length < 2) return fail2("Provide at least two options.");
+  if (list.length > MAX_OPTIONS) return fail2(`Provide at most ${MAX_OPTIONS} options.`);
+  if (list.some((option) => option.length > MAX_OPTION_LENGTH)) return fail2(`Options must be ${MAX_OPTION_LENGTH} characters or fewer.`);
+  if (new Set(list.map((option) => option.toLowerCase())).size !== list.length) return fail2("Options must be unique.");
   return { ok: true, value: list };
 };
 var buildQuestionRecord = ({ type = "binary", prompt, options, singleSelect = false, voiceCredits, tags = [], creator, session, profile = {} }) => {
-  if (!QUESTION_TYPES.includes(type)) return fail(`Question type must be one of: ${QUESTION_TYPES.join(", ")}.`);
-  const text4 = trim3(prompt);
-  if (!text4) return fail("The statement text is empty.");
-  if (text4.length > MAX_PROMPT_LENGTH) return fail(`Statements must be ${MAX_PROMPT_LENGTH} characters or fewer.`);
-  const record = { id: "", type, prompt: text4 };
+  if (!QUESTION_TYPES.includes(type)) return fail2(`Question type must be one of: ${QUESTION_TYPES.join(", ")}.`);
+  const text5 = trim4(prompt);
+  if (!text5) return fail2("The statement text is empty.");
+  if (text5.length > MAX_PROMPT_LENGTH) return fail2(`Statements must be ${MAX_PROMPT_LENGTH} characters or fewer.`);
+  const record = { id: "", type, prompt: text5 };
   let optionList = [];
   if (type === "multichoice" || type === "quadratic") {
     const normalized2 = normalizeOptionList(options);
@@ -38369,20 +38501,20 @@ var buildQuestionRecord = ({ type = "binary", prompt, options, singleSelect = fa
     credits = voiceCredits === void 0 || voiceCredits === null ? 99 : Number(voiceCredits);
     record.voiceCredits = credits;
     const error = validateQuadraticQuestion(record);
-    if (error) return fail(error);
+    if (error) return fail2(error);
   }
-  const tagList = (Array.isArray(tags) ? tags : []).map(trim3).filter(Boolean);
+  const tagList = (Array.isArray(tags) ? tags : []).map(trim4).filter(Boolean);
   if (tagList.length > MAX_TAGS || tagList.some((tag) => tag.length > MAX_TAG_LENGTH)) {
-    return fail(`Use at most ${MAX_TAGS} tags of ${MAX_TAG_LENGTH} characters or fewer.`);
+    return fail2(`Use at most ${MAX_TAGS} tags of ${MAX_TAG_LENGTH} characters or fewer.`);
   }
   record.tags = tagList;
   record.creator = import_ethers3.ethers.utils.getAddress(creator);
   record.associatedSurveyId = import_ethers3.ethers.constants.HashZero;
   record.participant = buildParticipantMarker(profile);
-  record.sessionName = trim3(session.sessionName) || session.sessionSlug;
+  record.sessionName = trim4(session.sessionName) || session.sessionSlug;
   record.sessionSlug = session.sessionSlug;
   record.sessionId = session.sessionId;
-  record.id = generateQuestionId(type, text4, optionList, record.singleSelect === true, credits);
+  record.id = generateQuestionId(type, text5, optionList, record.singleSelect === true, credits);
   return { ok: true, id: record.id, record };
 };
 
@@ -38390,9 +38522,9 @@ var buildQuestionRecord = ({ type = "binary", prompt, options, singleSelect = fa
 var SLUG_RE = /^[a-z0-9_-]{1,128}$/;
 var ADDRESS_RE = /^0x[0-9a-fA-F]{40}$/;
 var GROUP_ID_RE = /^[A-Za-z0-9._:-]{1,128}$/;
-var trim4 = (value) => String(value ?? "").trim();
+var trim5 = (value) => String(value ?? "").trim();
 var normalizeSessionSlug = (value) => {
-  const slug = trim4(value).toLowerCase();
+  const slug = trim5(value).toLowerCase();
   if (!SLUG_RE.test(slug)) throw new Error("Session slug must be 1-128 lowercase letters, digits, dashes, or underscores.");
   return slug;
 };
@@ -38415,9 +38547,9 @@ var readClaimPairs = (params) => {
   const pairs = [];
   const seen = /* @__PURE__ */ new Set();
   const add = (sbt, gp, inv, auto) => {
-    const address = trim4(sbt);
+    const address = trim5(sbt);
     if (!ADDRESS_RE.test(address)) return;
-    const pair = { sbt: address, groupPassword: trim4(gp), inviteCode: trim4(inv), auto };
+    const pair = { sbt: address, groupPassword: trim5(gp), inviteCode: trim5(inv), auto };
     const key = `${address.toLowerCase()}|${pair.groupPassword}|${pair.inviteCode}`;
     if (seen.has(key)) return;
     seen.add(key);
@@ -38435,7 +38567,7 @@ var readClaimPairs = (params) => {
 var parseSessionLink = (link, { allowLocalWorkers = false } = {}) => {
   let url;
   try {
-    url = new URL(trim4(link));
+    url = new URL(trim5(link));
   } catch {
     throw new Error("Session link must be a full URL, such as https://contextengine.sh/session/<slug>?worker=<origin>.");
   }
@@ -38448,7 +38580,7 @@ var parseSessionLink = (link, { allowLocalWorkers = false } = {}) => {
   if (workers.length > 1) {
     throw new Error("Session link must name exactly one hosted Worker when using ?worker=.");
   }
-  const joinGroup = trim4(params.get("joinGroup"));
+  const joinGroup = trim5(params.get("joinGroup"));
   if (joinGroup && !GROUP_ID_RE.test(joinGroup)) throw new Error("Session link has an invalid group id.");
   return {
     appOrigin: normalizeHttpOrigin(url.origin, "Session link"),
@@ -38462,6 +38594,51 @@ var parseSessionLink = (link, { allowLocalWorkers = false } = {}) => {
 };
 var buildSessionWebUrl = ({ appOrigin, slug, workerOrigin, kind }) => `${appOrigin}/session/${encodeURIComponent(slug)}${kind === "registry" ? "" : `?worker=${encodeURIComponent(workerOrigin)}`}`;
 
+// shared/auth/siweMessage.mjs
+var normalizeSessionIdHex = (value) => {
+  if (typeof value !== "string" || value !== value.trim()) return "";
+  const lower = value.toLowerCase();
+  const hex = lower.startsWith("0x") ? lower.slice(2) : lower;
+  if (/^[0-9a-f]{32}$/.test(hex) && !/^0+$/.test(hex)) return `0x${hex}`;
+  if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(lower)) {
+    const uuidHex = lower.replace(/-/g, "");
+    return /^0+$/.test(uuidHex) ? "" : `0x${uuidHex}`;
+  }
+  return "";
+};
+var buildSiweMessage = ({
+  address,
+  nonce,
+  chainId,
+  domain,
+  uri,
+  statement,
+  issuedAt,
+  expirationTime,
+  workerUrl,
+  sessionId,
+  sessionSlug
+}) => {
+  const id = String(sessionId || "").trim().toLowerCase();
+  const slug = sessionSlug === "general" ? "" : String(sessionSlug || "");
+  const sessionResource = id ? `urn:context-engine:session:id:${encodeURIComponent(id)}` : `urn:context-engine:session:slug:${encodeURIComponent(slug)}`;
+  const resources = workerUrl ? `
+Resources:
+- ${new URL(String(workerUrl)).origin}
+- ${sessionResource}` : "";
+  return `${domain} wants you to sign in with your Ethereum account:
+${address}
+
+${statement}
+
+URI: ${uri}
+Version: 1
+Chain ID: ${chainId}
+Nonce: ${nonce}
+Issued At: ${issuedAt}
+Expiration Time: ${expirationTime}${resources}`;
+};
+
 // mcp/lib/workerClient.mjs
 var REQUEST_TIMEOUT_MS = 2e4;
 var MAX_RESPONSE_BYTES = 8 * 1024 * 1024;
@@ -38521,17 +38698,6 @@ var readLimitedText = async (response, maxBytes = MAX_RESPONSE_BYTES) => {
   }
   return Buffer.concat(chunks.map((chunk) => Buffer.from(chunk))).toString("utf8");
 };
-var normalizeSessionIdHex = (value) => {
-  if (typeof value !== "string" || value !== value.trim()) return "";
-  const lower = value.toLowerCase();
-  const hex = lower.startsWith("0x") ? lower.slice(2) : lower;
-  if (/^[0-9a-f]{32}$/.test(hex) && !/^0+$/.test(hex)) return `0x${hex}`;
-  if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(lower)) {
-    const uuidHex = lower.replace(/-/g, "");
-    return /^0+$/.test(uuidHex) ? "" : `0x${uuidHex}`;
-  }
-  return "";
-};
 var resolveSessionIdHex = (config) => {
   const present = (value) => value !== void 0 && value !== null && value !== "";
   const sessionId = normalizeSessionIdHex(config?.sessionId);
@@ -38541,24 +38707,19 @@ var resolveSessionIdHex = (config) => {
   }
   return sessionId || sessionIdHex;
 };
-var buildSiweMessage = ({ address, nonce, appOrigin, workerOrigin, sessionId, sessionSlug = "", issuedAt, expirationTime, chainId = 1 }) => {
-  const { host } = new URL(appOrigin);
-  const resource = sessionId ? `urn:context-engine:session:id:${encodeURIComponent(sessionId)}` : `urn:context-engine:session:slug:${encodeURIComponent(sessionSlug === "general" ? "" : sessionSlug)}`;
-  return `${host} wants you to sign in with your Ethereum account:
-${address}
-
-Sign in to Context Engine.
-
-URI: ${appOrigin}
-Version: 1
-Chain ID: ${chainId}
-Nonce: ${nonce}
-Issued At: ${issuedAt}
-Expiration Time: ${expirationTime}
-Resources:
-- ${workerOrigin}
-- ${resource}`;
-};
+var buildSiweMessage2 = ({ address, nonce, appOrigin, workerOrigin, sessionId, sessionSlug = "", issuedAt, expirationTime, chainId = 1 }) => buildSiweMessage({
+  address,
+  nonce,
+  domain: new URL(appOrigin).host,
+  uri: appOrigin,
+  workerUrl: workerOrigin,
+  sessionId,
+  sessionSlug,
+  issuedAt,
+  expirationTime,
+  chainId,
+  statement: "Sign in to Context Engine."
+});
 var decodeTokenClaims = (token) => {
   try {
     const [payload] = text(token).split(".");
@@ -38595,8 +38756,13 @@ var createWorkerClient = ({ workerOrigin, slug, trustedOrigins, wallet, fetchImp
   let pendingLogin = null;
   let presence = null;
   let presenceLoadedAt = -Infinity;
-  const request = async (path3, { method = "GET", headers = {}, body, auth = false, retried = false, maxBytes = MAX_RESPONSE_BYTES } = {}) => {
+  const request = async (path3, { method = "GET", headers = {}, body, auth = false, retried = false, maxBytes = MAX_RESPONSE_BYTES, signal } = {}) => {
+    const checkpoint = () => {
+      if (signal?.aborted) throw new Error("Stopped before the Worker request was sent.");
+    };
+    checkpoint();
     if (auth) await ensureToken();
+    checkpoint();
     let response;
     try {
       response = await fetchImpl(`${workerOrigin}${path3}`, {
@@ -38626,7 +38792,7 @@ var createWorkerClient = ({ workerOrigin, slug, trustedOrigins, wallet, fetchImp
     const error = isRecord4(data) ? text(data.error) || text(data.message) : "";
     if (response.status === 401 && auth && !retried && (!error || TOKEN_ERROR_RE.test(error))) {
       token = "";
-      return request(path3, { method, headers, body, auth, retried: true, maxBytes });
+      return request(path3, { method, headers, body, auth, retried: true, maxBytes, signal });
     }
     if (response.status === 401 && error && !TOKEN_ERROR_RE.test(error)) {
       throw new WorkerRequestError(error.slice(0, MAX_ERROR_DETAIL), { status: 401, code: error });
@@ -38679,7 +38845,7 @@ var createWorkerClient = ({ workerOrigin, slug, trustedOrigins, wallet, fetchImp
     const nonce = text(nonceData?.nonce);
     if (!/^[A-Za-z0-9]{8,200}$/.test(nonce)) throw new WorkerRequestError("The Worker did not issue a usable sign-in nonce.");
     const issued = new Date(now());
-    const message = buildSiweMessage({
+    const message = buildSiweMessage2({
       address,
       nonce,
       appOrigin: loginOrigin,
@@ -38744,15 +38910,16 @@ var createWorkerClient = ({ workerOrigin, slug, trustedOrigins, wallet, fetchImp
     }
     return data;
   };
-  const upload = async ({ resource, data, tags = [] }) => {
+  const upload = async ({ resource, data, tags = [], requestId = "", signal }) => {
     const result = await request("/storage/upload", {
+      signal,
       method: "POST",
       auth: true,
-      body: { backend: "cloudflare", resource, contentType: "application/json", payloadEncrypted: false, tags, data }
+      body: { backend: "cloudflare", resource, contentType: "application/json", payloadEncrypted: false, tags, data, ...requestId ? { requestId } : {} }
     });
     return isRecord4(result?.storageRef) ? result.storageRef : { id: text(result?.id) };
   };
-  const joinGroup = (groupId) => request("/groups/join", { method: "POST", auth: true, body: { sessionId, groupId } });
+  const joinGroup = (groupId, { signal } = {}) => request("/groups/join", { method: "POST", auth: true, signal, body: { sessionId, groupId } });
   const describeTestEth = async () => {
     await refreshConfig();
     if (now() - presenceLoadedAt >= CONFIG_MAX_AGE_MS) {
@@ -38793,7 +38960,7 @@ var createWorkerClient = ({ workerOrigin, slug, trustedOrigins, wallet, fetchImp
 // mcp/lib/registryChain.mjs
 var compareChainOrder = (a, b) => Number(a.blockNumber || 0) - Number(b.blockNumber || 0) || Number(a.transactionIndex || 0) - Number(b.transactionIndex || 0) || Number(a.logIndex || 0) - Number(b.logIndex || 0);
 var checkRegistryChain = async (provider, chainId) => {
-  const actual = Number(await provider.send("eth_chainId", []));
+  const actual = Number(await chainRequest(() => provider.send("eth_chainId", [])));
   if (actual !== chainId) throw new Error(`The RPC is on a different chain (${actual}); expected ${chainId}.`);
 };
 var findStartBlock = async (provider, createdAt, head) => {
@@ -38801,7 +38968,7 @@ var findStartBlock = async (provider, createdAt, head) => {
   let high = head;
   while (low < high) {
     const mid = Math.floor((low + high) / 2);
-    const block = await provider.getBlock(mid);
+    const block = await chainRequest(() => provider.getBlock(mid));
     if (!block || !Number.isFinite(Number(block.timestamp))) throw new Error("Could not locate the session creation block.");
     if (Number(block.timestamp) < createdAt) low = mid + 1;
     else high = mid;
@@ -38839,7 +39006,7 @@ var scanRegistryLogs = async ({
         range = Math.max(1, Math.floor((end - begin + 1) / 2));
         continue;
       }
-      throw error;
+      throw safeChainError(error);
     }
     batch = batch.sort((a, b) => descending ? compareChainOrder(b, a) : compareChainOrder(a, b));
     let skipped = 0;
@@ -38971,13 +39138,14 @@ var stopped = (signal) => {
   if (signal?.aborted) throw new Error("Stopped before the chain transaction was sent.");
 };
 var createRegistryWriter = ({ provider, chainId, wallet, surveys, slug, remember }) => {
+  const checkChain = () => checkRegistryChain(provider, chainId);
   const prepare = async ({ client, gasLimit, fund, signal }) => {
     stopped(signal);
-    await checkRegistryChain(provider, chainId);
-    const gasPrice = await provider.getGasPrice();
+    await checkChain();
+    const gasPrice = await chainRequest(() => provider.getGasPrice());
     const cost = gasPrice.mul(gasLimit);
     if (cost.gt(MAX_COST)) throw new Error("This transaction would exceed the 0.005 ETH gas cap; retry when gas is cheaper.");
-    let balance = await provider.getBalance(wallet.address);
+    let balance = await chainRequest(() => provider.getBalance(wallet.address));
     const shortfall = `Fund ${wallet.address} with test ETH on chain ${chainId}; this transaction needs up to ${import_ethers4.ethers.utils.formatEther(cost)} ETH.`;
     let fundingNote = "";
     if (balance.lt(cost) && fund) {
@@ -38985,13 +39153,14 @@ var createRegistryWriter = ({ provider, chainId, wallet, surveys, slug, remember
       if (offer.offered && offer.tokenHasFaucetScope !== false) {
         let funding;
         try {
+          stopped(signal);
           funding = await fund();
         } catch (error) {
           throw new Error(`${shortfall} ${String(error?.message || "The faucet request failed.").slice(0, 250)}`);
         }
         if (funding?.sent) fundingNote = ` Faucet transaction ${funding.txHash} was sent; check it before requesting another payout.`;
         else if (funding?.reason === "balance_high") fundingNote = " The faucet refused because the balance is above its threshold.";
-        balance = await provider.getBalance(wallet.address).catch(() => null);
+        balance = await chainRequest(() => provider.getBalance(wallet.address)).catch(() => null);
         if (!balance) throw new Error(`${shortfall}${fundingNote} The current balance could not be checked.`);
       }
     }
@@ -39001,7 +39170,7 @@ var createRegistryWriter = ({ provider, chainId, wallet, surveys, slug, remember
   };
   const upload = async (client, resource, id, record, signal) => {
     stopped(signal);
-    const result = await client.request("/arweave/upload", { method: "POST", auth: true, body: {
+    const result = await client.request("/arweave/upload", { method: "POST", auth: true, signal, body: {
       data: JSON.stringify(record),
       contentType: "application/json",
       requestId: randomUUID(),
@@ -39021,7 +39190,7 @@ var createRegistryWriter = ({ provider, chainId, wallet, surveys, slug, remember
         })
       ]);
     } catch {
-      throw new Error(`Transaction ${tx.hash} was submitted but could not be confirmed. Check it before retrying.`);
+      throw Object.assign(new Error(`Transaction ${tx.hash} was submitted but could not be confirmed. Check it before retrying.`), { txHash: tx.hash, reconciliationRequired: true });
     } finally {
       clearTimeout(timer);
     }
@@ -39046,22 +39215,24 @@ var createRegistryWriter = ({ provider, chainId, wallet, surveys, slug, remember
     const pointers = [];
     for (const record of records) pointers.push(await upload(client, "responses", record.questionID, record, signal));
     stopped(signal);
-    await checkRegistryChain(provider, chainId);
-    const tx = await surveys.connect(wallet.connect(provider)).submitResponses(ids, pointers, import_ethers4.ethers.constants.HashZero, import_ethers4.ethers.constants.HashZero, fees);
+    await checkChain();
+    stopped(signal);
+    const tx = await chainRequest(() => surveys.connect(wallet.connect(provider)).submitResponses(ids, pointers, import_ethers4.ethers.constants.HashZero, import_ethers4.ethers.constants.HashZero, fees), { submission: true });
     const receipt = await confirm(tx, "ResponsesSubmitted", ids);
     records.forEach((record, index) => remember("responses", record.questionID, record, pointers[index], receipt));
     return { txHash: tx.hash, receipt };
   };
   const addStatement = async ({ client, record, fund, signal }) => {
-    await checkRegistryChain(provider, chainId);
-    if (await surveys.questionHashes(record.id) !== import_ethers4.ethers.constants.HashZero) {
+    await checkChain();
+    if (await chainRequest(() => surveys.questionHashes(record.id)) !== import_ethers4.ethers.constants.HashZero) {
       throw new Error("This statement already exists on chain, possibly in another session; reword it to add a new statement.");
     }
     const fees = await prepare({ client, gasLimit: 4e5, fund, signal });
     const pointer = await upload(client, "questions", record.id, record, signal);
     stopped(signal);
-    await checkRegistryChain(provider, chainId);
-    const tx = await surveys.connect(wallet.connect(provider)).addQuestions([record.id], [pointer], [import_ethers4.ethers.constants.HashZero], fees);
+    await checkChain();
+    stopped(signal);
+    const tx = await chainRequest(() => surveys.connect(wallet.connect(provider)).addQuestions([record.id], [pointer], [import_ethers4.ethers.constants.HashZero], fees), { submission: true });
     const receipt = await confirm(tx, "QuestionsAdded", [record.id]);
     remember("questions", record.id, record, pointer, receipt);
     return { txHash: tx.hash };
@@ -39124,6 +39295,11 @@ var createRegistrySession = async ({ info, config, wallet, fetchImpl = globalThi
   let workerOrigin;
   let surveys;
   let startBlock;
+  const creationBlocks = /* @__PURE__ */ new Map();
+  let endBlock = null;
+  let readEnd;
+  let windowKey;
+  let questionMark = null;
   let questionCursor;
   const pending = /* @__PURE__ */ new Map();
   const questions = /* @__PURE__ */ new Map();
@@ -39131,16 +39307,30 @@ var createRegistrySession = async ({ info, config, wallet, fetchImpl = globalThi
   const localAnswers = /* @__PURE__ */ new Map();
   const answerScans = /* @__PURE__ */ new Map();
   let loadingQuestions;
+  const containsBlock = (block) => Number.isSafeInteger(block) && block >= startBlock && (endBlock === null || block <= readEnd);
+  const readWindowEnd = async () => {
+    const head = await chainRequest(() => provider.getBlockNumber());
+    readEnd = endBlock === null ? head : Math.min(endBlock, head);
+    return readEnd;
+  };
+  const configuredBlock = (value, name) => {
+    if (value == null) return null;
+    const block = Number(value);
+    if (typeof value !== "number" && typeof value !== "string" || String(value).trim() === "" || !Number.isSafeInteger(block) || block < 0) {
+      throw new Error(`Invalid session block limit: ${name} must be a nonnegative integer.`);
+    }
+    return block;
+  };
   const loadConfig = async () => {
     await checkRegistryChain(provider, chainId);
-    const slug = info.slug === "general" ? "" : info.slug;
-    const row = await registry.getSessionBySlug(slug);
+    const slug = info.slug || "general";
+    const row = await chainRequest(() => registry.getSessionBySlug(slug));
     if (normalized(row[0]) !== slug) throw new Error("The registry returned a different session.");
     if (text(row[3])) throw new Error("Encrypted registry metadata is unsupported; use an unencrypted session.");
     if (Number(row[1]) !== chainId) throw new Error("The session uses a different chain from this registry.");
     const metadata = await readRegistryMetadata(row[2], { fetchImpl });
     checkMetadata(metadata);
-    const fields = await registry.getSessionFields(slug, ["corsWorkerUrl"]);
+    const fields = await chainRequest(() => registry.getSessionFields(slug, ["corsWorkerUrl"]));
     const workerUrl = text(fields[0]) || text(metadata.corsWorkerUrl);
     if (/^\s*(?:\{|enc:|lit:)/i.test(workerUrl)) throw new Error("Encrypted Worker URLs are unsupported; use an unencrypted registry session.");
     const nextOrigin = normalizeWorkerOrigin(workerUrl, { allowLocalWorkers: config.allowLocalWorkers });
@@ -39161,11 +39351,32 @@ var createRegistrySession = async ({ info, config, wallet, fetchImpl = globalThi
       corsWorkerUrl: workerOrigin,
       contracts: { ...metadata.contracts, surveys: { address, chainId } }
     };
-    if (startBlock === void 0) {
-      const configured = Number(metadata.blockLimits?.start);
-      const head = await provider.getBlockNumber();
-      startBlock = metadata.blockLimits?.start !== void 0 && Number.isSafeInteger(configured) && configured >= 0 ? configured : await findStartBlock(provider, Number(row[5]), head);
+    const head = await chainRequest(() => provider.getBlockNumber());
+    let nextStart = configuredBlock(metadata.blockLimits?.start, "start");
+    if (nextStart === null) {
+      const createdAt = Number(row[5]);
+      if (!creationBlocks.has(createdAt)) {
+        const lookup = findStartBlock(provider, createdAt, head).catch((error) => {
+          creationBlocks.delete(createdAt);
+          throw error;
+        });
+        creationBlocks.set(createdAt, lookup);
+      }
+      nextStart = await creationBlocks.get(createdAt);
+    }
+    const nextEnd = configuredBlock(metadata.blockLimits?.end, "end");
+    if (nextEnd !== null && nextEnd < nextStart) throw new Error("Invalid session block window: end must not precede start.");
+    const nextKey = `${nextStart}:${nextEnd ?? "head"}`;
+    startBlock = nextStart;
+    endBlock = nextEnd;
+    readEnd = endBlock === null ? head : Math.min(endBlock, head);
+    if (windowKey !== nextKey) {
+      windowKey = nextKey;
       questionCursor = { block: startBlock, offset: 0 };
+      questionMark = null;
+      pending.clear();
+      for (const [id, entry] of questions) if (!entry.local || !containsBlock(entry.blockNumber)) questions.delete(id);
+      answerScans.clear();
     }
     return sessionConfig;
   };
@@ -39181,28 +39392,66 @@ var createRegistrySession = async ({ info, config, wallet, fetchImpl = globalThi
     return payload;
   };
   const filter = (eventName) => ({ address: surveys.address, topics: [surveys.interface.getEventTopic(eventName)] });
+  const readBlock = (number, blocks) => {
+    if (!blocks.has(number)) blocks.set(number, chainRequest(() => provider.getBlock(number)).catch(() => null));
+    return blocks.get(number);
+  };
+  const readHeadMark = async (number, blocks) => {
+    const block = await readBlock(number, blocks);
+    return block?.hash ? { number, hash: block.hash } : null;
+  };
+  const historyReplaced = async (mark, blocks) => {
+    if (!mark?.hash) return false;
+    const block = await readBlock(mark.number, blocks);
+    return block?.hash ? block.hash !== mark.hash : null;
+  };
+  const replacedWrite = (entry, blocks = /* @__PURE__ */ new Map()) => historyReplaced(entry?.blockHash ? { number: entry.blockNumber, hash: entry.blockHash } : null, blocks);
+  const visibleQuestions = () => {
+    const blocked = new Set((Array.isArray(sessionConfig.BLOCKED_QUESTION_IDS) ? sessionConfig.BLOCKED_QUESTION_IDS : []).map(normalized));
+    return [...questions.values()].filter((entry) => !blocked.has(entry.id) && containsBlock(entry.blockNumber));
+  };
   const readQuestions = async ({ signal } = {}) => {
     const deadline = now() + 9e4;
+    const blocks = /* @__PURE__ */ new Map();
+    const end = await readWindowEnd();
     let complete = true;
+    const replaced = await historyReplaced(questionMark, blocks);
+    if (replaced === null) return { items: visibleQuestions(), complete: false };
+    if (replaced) {
+      questions.clear();
+      pending.clear();
+      questionCursor = { block: startBlock, offset: 0 };
+      questionMark = null;
+    }
+    for (const [id, entry] of questions) {
+      if (!entry.local) continue;
+      const replaced2 = await replacedWrite(entry, blocks);
+      if (replaced2 === null) complete = false;
+      if (replaced2) questions.delete(id);
+    }
     if (pending.size < MAX_CACHE && questions.size < MAX_QUESTIONS) {
-      const scanned = await scanRegistryLogs({
-        provider,
-        filter: filter("QuestionsAdded"),
-        cursor: questionCursor,
-        toBlock: await provider.getBlockNumber(),
-        maxLogs: 1e3,
-        deadline,
-        now,
-        signal
-      });
-      questionCursor = scanned.cursor;
-      complete = scanned.complete;
-      for (const log2 of scanned.logs) {
-        const event = surveys.interface.parseLog(log2);
-        event.args.questionIds.forEach((id, index) => {
-          if (event.args.surveyIds[index] === import_ethers5.ethers.constants.HashZero && !questions.has(normalized(id))) pending.set(normalized(id), log2);
+      const head = await readHeadMark(end, blocks);
+      if (head) {
+        const scanned = await scanRegistryLogs({
+          provider,
+          filter: filter("QuestionsAdded"),
+          cursor: questionCursor,
+          toBlock: head.number,
+          maxLogs: 1e3,
+          deadline,
+          now,
+          signal
         });
-      }
+        questionCursor = scanned.cursor;
+        complete = complete && scanned.complete;
+        if (replaced !== null && (!questionMark || head.number >= questionMark.number)) questionMark = head;
+        for (const log2 of scanned.logs) {
+          const event = surveys.interface.parseLog(log2);
+          event.args.questionIds.forEach((id, index) => {
+            if (event.args.surveyIds[index] === import_ethers5.ethers.constants.HashZero && !questions.has(normalized(id))) pending.set(normalized(id), log2);
+          });
+        }
+      } else complete = false;
     } else complete = false;
     const work = [...pending.entries()];
     let next = 0;
@@ -39210,7 +39459,7 @@ var createRegistrySession = async ({ info, config, wallet, fetchImpl = globalThi
       while (next < work.length && now() < deadline && !signal?.aborted && questions.size < MAX_QUESTIONS) {
         const [id, log2] = work[next++];
         try {
-          const pointer = await surveys.getQuestionHash(id);
+          const pointer = await chainRequest(() => surveys.getQuestionHash(id));
           const payload = await readPayload(pointer);
           const matches = registryQuestionMatchesSession(payload, sessionConfig);
           if (matches) questions.set(id, { id, payload: { ...payload, id }, createdAt: String(log2.blockNumber).padStart(16, "0"), ...log2 });
@@ -39220,8 +39469,7 @@ var createRegistrySession = async ({ info, config, wallet, fetchImpl = globalThi
         }
       }
     }));
-    const blocked = new Set((Array.isArray(sessionConfig.BLOCKED_QUESTION_IDS) ? sessionConfig.BLOCKED_QUESTION_IDS : []).map(normalized));
-    return { items: [...questions.values()].filter((entry) => !blocked.has(entry.id)), complete: complete && !pending.size && questions.size < MAX_QUESTIONS };
+    return { items: visibleQuestions(), complete: complete && !pending.size && questions.size < MAX_QUESTIONS };
   };
   const loadQuestions = (args) => {
     if (!loadingQuestions) loadingQuestions = readQuestions(args).finally(() => {
@@ -39232,17 +39480,42 @@ var createRegistrySession = async ({ info, config, wallet, fetchImpl = globalThi
   const readAnswers = async ({ questionIds, maxRecords = 1e4, mine = false, signal } = {}) => {
     const known = new Set(questionIds);
     const deadline = now() + 9e4;
+    const blocks = /* @__PURE__ */ new Map();
+    let verified = true;
     const responseFilter = filter("ResponsesSubmitted");
     if (mine) responseFilter.topics.push(import_ethers5.ethers.utils.hexZeroPad(wallet.address, 32));
-    const head = await provider.getBlockNumber();
+    const head = await readWindowEnd();
     const scope = [...known].sort().join(",");
     let state = answerScans.get(mine);
-    if (!state || state.scope !== scope || head < state.head) {
-      state = { scope, head: startBlock - 1, ranges: [], latest: /* @__PURE__ */ new Map(), capped: false };
+    const replaced = !!state && state.scope === scope && head >= state.head && await historyReplaced(state.mark, blocks);
+    if (replaced === null) {
+      const held = new Map((state.result?.entries || []).map((entry) => [`${entry.questionId}:${normalized(entry.responder)}`, entry]));
+      const chainOrders2 = new Map(state.result?.chainOrders || []);
+      for (const entry of localAnswers.values()) {
+        if (!known.has(entry.questionId) || !containsBlock(entry.blockNumber)) continue;
+        const key = `${entry.questionId}:${normalized(entry.responder)}`;
+        if ([state.latest.get(key), held.get(key)].some((previous) => previous && compareChainOrder(entry, previous) < 0)) continue;
+        chainOrders2.set(entry.questionId, entry);
+        held.delete(key);
+        if (registryResponseMatchesSession(entry.payload, sessionConfig) && entry.payload.answer?.encrypted !== true && normalized(entry.payload.questionID || entry.payload.questionId) === entry.questionId) held.set(key, entry);
+      }
+      return {
+        entries: [...held.values()].sort((a, b) => compareChainOrder(b, a)).slice(0, maxRecords),
+        complete: false,
+        chainOrders: chainOrders2,
+        unreadAnswers: state.result?.unreadAnswers || 0
+      };
+    }
+    if (!state || state.scope !== scope || head < state.head || replaced) {
+      state = { scope, head: startBlock - 1, mark: null, ranges: [], latest: /* @__PURE__ */ new Map(), capped: false };
     } else state = { ...state, ranges: state.ranges.map((range) => ({ ...range })), latest: new Map(state.latest) };
     if (head > state.head) {
-      state.ranges.unshift({ from: Math.max(startBlock, state.head + 1), cursor: { block: head, offset: 0 } });
-      state.head = head;
+      const mark = await readHeadMark(head, blocks);
+      if (mark) {
+        state.ranges.unshift({ from: Math.max(startBlock, state.head + 1), cursor: { block: head, offset: 0 } });
+        state.head = head;
+        if (replaced !== null) state.mark = mark;
+      } else verified = false;
     }
     if (state.ranges.length > 64) {
       const oldest = state.ranges.pop();
@@ -39295,8 +39568,14 @@ var createRegistrySession = async ({ info, config, wallet, fetchImpl = globalThi
     answerScans.set(mine, state);
     const scannedAll = !state.ranges.length && !state.capped;
     const latest = new Map(state.latest);
-    for (const entry of localAnswers.values()) {
-      if (!known.has(entry.questionId)) continue;
+    for (const [id, entry] of localAnswers) {
+      if (!known.has(entry.questionId) || !containsBlock(entry.blockNumber)) continue;
+      const replaced2 = await replacedWrite(entry, blocks);
+      if (replaced2 === null) verified = false;
+      if (replaced2) {
+        localAnswers.delete(id);
+        continue;
+      }
       if (!scannedAll && entry.blockNumber <= head) continue;
       const key = `${entry.questionId}:${normalized(entry.responder)}`;
       if (!latest.has(key) || compareChainOrder(entry, latest.get(key)) > 0) latest.set(key, { ...entry, local: true });
@@ -39304,8 +39583,8 @@ var createRegistrySession = async ({ info, config, wallet, fetchImpl = globalThi
     const candidates = [...latest.values()].sort((a, b) => compareChainOrder(b, a));
     const chainOrders = new Map(candidates.filter((entry) => normalized(entry.responder) === normalized(wallet.address)).map((entry) => [entry.questionId, entry]));
     const entries = [];
-    const blockTimes = /* @__PURE__ */ new Map();
-    let complete = scannedAll && candidates.length <= maxRecords;
+    let complete = verified && scannedAll && candidates.length <= maxRecords;
+    let unreadAnswers = 0;
     let next = 0;
     const selected = candidates.slice(0, maxRecords);
     await Promise.all(Array.from({ length: Math.min(6, selected.length) }, async () => {
@@ -39316,20 +39595,32 @@ var createRegistrySession = async ({ info, config, wallet, fetchImpl = globalThi
         }
         const entry = selected[next++];
         try {
-          const pointer = entry.local ? entry.storageId : await surveys.getResponse(entry.responder, entry.questionId);
+          const { blockTag } = responseReadWindowOptions(endBlock === null ? null : { blockTag: head }, entry.responder, entry.questionId);
+          let pointer;
+          if (entry.local) pointer = entry.storageId;
+          else {
+            try {
+              pointer = await chainRequest(() => blockTag == null ? surveys.getResponse(entry.responder, entry.questionId) : surveys.getResponse(entry.responder, entry.questionId, { blockTag }));
+            } catch (error) {
+              throw blockTag == null ? error : historicalResponseReadError(error, blockTag);
+            }
+          }
           const payload = await readPayload(pointer);
           if (!registryResponseMatchesSession(payload, sessionConfig) || payload.answer?.encrypted === true) continue;
           if (normalized(payload.questionID || payload.questionId) !== entry.questionId) continue;
-          if (!blockTimes.has(entry.blockNumber)) blockTimes.set(entry.blockNumber, provider.getBlock(entry.blockNumber));
-          const block = await blockTimes.get(entry.blockNumber);
-          const createdAt = block?.timestamp ? new Date(Number(block.timestamp) * 1e3).toISOString() : "";
+          const block = await readBlock(entry.blockNumber, blocks);
+          if (!block) complete = false;
+          const createdAt = block?.timestamp ? new Date(Number(block.timestamp) * 1e3).toISOString() : entry.createdAt || "";
           entries.push({ ...entry, storageId: pointer, createdAt, payload });
         } catch {
           complete = false;
+          unreadAnswers++;
         }
       }
     }));
-    return { entries, complete, chainOrders };
+    unreadAnswers += selected.length - next;
+    state.result = { entries, complete, chainOrders, unreadAnswers };
+    return state.result;
   };
   const writer = createRegistryWriter({ provider, chainId, wallet, surveys, slug: info.slug, remember: (resource, id, payload, pointer, receipt) => {
     cache(pointer, payload);
@@ -39340,20 +39631,75 @@ var createRegistrySession = async ({ info, config, wallet, fetchImpl = globalThi
       storageId: pointer,
       responder: wallet.address,
       blockNumber: receipt.blockNumber,
+      blockHash: receipt.blockHash,
       transactionIndex: receipt.transactionIndex,
       logIndex: receipt.logs.at(-1)?.logIndex || 0,
       createdAt: new Date(now()).toISOString()
     };
-    if (resource === "questions") questions.set(id, entry);
+    if (resource === "questions") questions.set(id, { ...entry, local: true });
     else localAnswers.set(id, entry);
   } });
-  return { loadConfig, loadQuestions, readAnswers, ...writer, get config() {
+  return { loadConfig, loadQuestions, readAnswers, replacedWrite, containsBlock, get windowKey() {
+    return windowKey;
+  }, ...writer, get config() {
     return sessionConfig;
   }, workerOrigin };
 };
 
-// mcp/lib/results.mjs
+// shared/storage/canonicalStorageVersions.mjs
+var trim6 = (value) => (typeof value === "string" ? value : value == null ? "" : String(value)).trim();
+var compareStorageIds = (left, right) => left < right ? -1 : left > right ? 1 : 0;
+var compareVersionAge = (left, right) => (Number(left.createdAtMs) || 0) - (Number(right.createdAtMs) || 0) || compareStorageIds(trim6(left.storageRefId), trim6(right.storageRefId));
+var isAdminStorageVersion = (candidate) => candidate.uploadAuthority === "admin";
+var isPreferredStorageVersion = (candidate, current) => {
+  if (!current) return true;
+  const candidateAdmin = isAdminStorageVersion(candidate);
+  const currentAdmin = isAdminStorageVersion(current);
+  if (candidateAdmin !== currentAdmin) return candidateAdmin;
+  const age = compareVersionAge(candidate, current);
+  return candidateAdmin ? age > 0 : age < 0;
+};
+
+// shared/sessionContext.mjs
+var SESSION_CONTEXT_LIMITS = Object.freeze({
+  titleChars: 80,
+  paragraphs: 6,
+  paragraphChars: 2e3,
+  links: 8,
+  labelChars: 120,
+  urlChars: 2e3,
+  htmlChars: 2e4
+});
+var L = SESSION_CONTEXT_LIMITS;
+var isRecord5 = (value) => !!value && typeof value === "object" && !Array.isArray(value);
 var text2 = (value) => typeof value === "string" ? value.trim() : "";
+var NAMED_ENTITIES = { amp: "&", lt: "<", gt: ">", quot: '"', apos: "'", nbsp: " " };
+var decodeEntity = (match, entity) => {
+  const code = /^#x/i.test(entity) ? parseInt(entity.slice(2), 16) : /^#/.test(entity) ? parseInt(entity.slice(1), 10) : NaN;
+  if (Number.isInteger(code)) return code > 0 && code <= 1114111 ? String.fromCodePoint(code) : " ";
+  return NAMED_ENTITIES[entity.toLowerCase()] ?? match;
+};
+var htmlToPlainText = (html) => String(html ?? "").replace(/<(script|style|template)\b[\s\S]*?<\/\1\s*>/gi, " ").replace(/<!--[\s\S]*?-->/g, " ").replace(/<br\s*\/?>|<\/(?:p|div|li|h[1-6]|tr|summary|details|blockquote|pre|table|ul|ol|dt|dd)>/gi, "\n").replace(/<[^>]*>/g, " ").replace(/&(#x[0-9a-f]+|#\d+|[a-z]+);/gi, decodeEntity).split("\n").map((line) => line.replace(/\s+/g, " ").trim()).filter(Boolean).join("\n");
+var isHttpsUrl = (value) => {
+  if (typeof value !== "string" || !value || value.length > L.urlChars) return false;
+  try {
+    return new URL(value).protocol === "https:";
+  } catch {
+    return false;
+  }
+};
+var normalizeSessionContext = (value) => {
+  const context = isRecord5(value) ? value : {};
+  const title = text2(context.title).slice(0, L.titleChars);
+  const html = text2(context.html).slice(0, L.htmlChars);
+  if (html) return { title, html, paragraphs: [], links: [] };
+  const paragraphs = (Array.isArray(context.paragraphs) ? context.paragraphs : [context.body]).map(text2).filter(Boolean).slice(0, L.paragraphs).map((paragraph) => paragraph.slice(0, L.paragraphChars));
+  const links = (Array.isArray(context.links) ? context.links : []).filter(isRecord5).map((link) => ({ label: text2(link.label).slice(0, L.labelChars), url: text2(link.url) })).filter((link) => isHttpsUrl(link.url)).slice(0, L.links).map((link) => ({ label: link.label || link.url, url: link.url }));
+  return { title, paragraphs, links };
+};
+
+// mcp/lib/results.mjs
+var text3 = (value) => typeof value === "string" ? value.trim() : "";
 var MAX_FREEFORM_SAMPLES = 5;
 var MAX_SAMPLE_LENGTH = 280;
 var isNewer = (candidate, current) => !current || candidate.createdAt > current.createdAt || candidate.createdAt === current.createdAt && candidate.storageId > current.storageId;
@@ -39362,11 +39708,11 @@ var latestAnswersByQuestion = (entries, { sessionSlug, sessionId, registryConfig
   for (const entry of entries) {
     const payload = entry?.payload;
     if (!payload || typeof payload !== "object" || Array.isArray(payload)) continue;
-    const questionId = (text2(payload.questionID) || text2(payload.questionId)).toLowerCase();
+    const questionId = (text3(payload.questionID) || text3(payload.questionId)).toLowerCase();
     if (registryConfig) {
       if (!questionIds?.has(questionId) || !registryResponseMatchesSession(payload, registryConfig) || payload.answer?.encrypted === true) continue;
-    } else if (text2(payload.sessionSlug) !== sessionSlug || normalizeSessionIdHex(text2(payload.sessionId)) !== sessionId) continue;
-    const responder = text2(entry.responder).toLowerCase();
+    } else if (text3(payload.sessionSlug) !== sessionSlug || normalizeSessionIdHex(text3(payload.sessionId)) !== sessionId) continue;
+    const responder = text3(entry.responder).toLowerCase();
     if (!questionId || !responder) continue;
     const answers = byQuestion.get(questionId) || /* @__PURE__ */ new Map();
     const current = answers.get(responder);
@@ -39398,25 +39744,21 @@ var BINARY_VOTES = Object.freeze({
   0: "Unsure"
 });
 var validValue = (question, entry) => {
-  const payloadType = text2(entry?.payload?.type);
+  const payloadType = text3(entry?.payload?.type);
   if (payloadType && payloadType !== question.type) return void 0;
   const value = rawValue(entry);
   if (value === void 0 || value === null || value === "*") return void 0;
   switch (question.type) {
     case "binary": {
       const scalar = Array.isArray(value) && value.every((item) => ["string", "number"].includes(typeof item)) ? value.join(",") : value;
-      const key = typeof scalar === "boolean" || typeof scalar === "number" ? String(scalar) : text2(scalar).toLowerCase();
+      const key = typeof scalar === "boolean" || typeof scalar === "number" ? String(scalar) : text3(scalar).toLowerCase();
       return Object.hasOwn(BINARY_VOTES, key) ? BINARY_VOTES[key] : void 0;
     }
-    case "rating": {
-      if (typeof value !== "number" && !(typeof value === "string" && value.trim())) return void 0;
-      const number = Number(value);
-      const scale = ratingScaleFor(question);
-      return Number.isFinite(number) && number >= scale.min && number <= scale.max ? number : void 0;
-    }
+    case "rating":
+      return normalizeRatingAnswer(value, question) ?? void 0;
     case "multichoice": {
-      const options = (Array.isArray(question.options) ? question.options : []).map(text2).filter(Boolean);
-      const picks = (Array.isArray(value) ? value : [value]).map(text2);
+      const options = (Array.isArray(question.options) ? question.options : []).map(text3).filter(Boolean);
+      const picks = (Array.isArray(value) ? value : [value]).map(text3);
       if (!picks.length || picks.some((pick) => !pick)) return void 0;
       const canonical = options.length ? picks.map((pick) => options.find((option) => option.toLowerCase() === pick.toLowerCase()) || "") : picks;
       if (canonical.some((pick) => !pick)) return void 0;
@@ -39467,7 +39809,7 @@ var summarizeQuestion = (question, answersByResponder = /* @__PURE__ */ new Map(
       return { ...summary, scale: { min: scale.min, max: scale.max }, mean, histogram };
     }
     case "multichoice": {
-      const counts = new Map((Array.isArray(question.options) ? question.options : []).map(text2).filter(Boolean).map((option) => [option, 0]));
+      const counts = new Map((Array.isArray(question.options) ? question.options : []).map(text3).filter(Boolean).map((option) => [option, 0]));
       answered.forEach((entry) => validValue(question, entry).forEach((option) => counts.set(option, (counts.get(option) || 0) + 1)));
       return { ...summary, counts: Object.fromEntries(counts) };
     }
@@ -39517,12 +39859,12 @@ var REVEAL_WAIT_MS = 9e4;
 var POLL_MS = 2e3;
 var GAS_HEADROOM_PERCENT = 130;
 var PASSWORD_CLAIM_GAS_BUDGET = 4e5;
-var trim5 = (value) => typeof value === "string" ? value.trim() : typeof value === "number" ? String(value) : "";
-var isRecord5 = (value) => !!value && typeof value === "object" && !Array.isArray(value);
+var trim7 = (value) => typeof value === "string" ? value.trim() : typeof value === "number" ? String(value) : "";
+var isRecord6 = (value) => !!value && typeof value === "object" && !Array.isArray(value);
 var defaultSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 var { deriveGroupPasswordWallet } = createGroupPasswordDerivation(import_ethers6.ethers);
 var normalizeGroupPasswordInput = (raw) => {
-  const compact = trim5(raw).replace(/\s+/g, "");
+  const compact = trim7(raw).replace(/\s+/g, "");
   if (!compact) return "";
   if (import_ethers6.ethers.utils.isHexString(compact)) {
     try {
@@ -39534,14 +39876,14 @@ var normalizeGroupPasswordInput = (raw) => {
   return compact;
 };
 var decodeInviteCode = (raw) => {
-  let code = trim5(raw);
+  let code = trim7(raw);
   const lower = code.toLowerCase();
   if (lower.startsWith("inv:")) code = code.slice(4).trim();
   else if (lower.startsWith("invite:")) code = code.slice(7).trim();
   if (!code || code.length > 4096) return null;
   try {
     const parsed = JSON.parse(Buffer.from(code.replace(/-/g, "+").replace(/_/g, "/"), "base64").toString("utf8"));
-    if (!isRecord5(parsed) || Object.keys(parsed).sort().join(",") !== "a,c,n,s") return null;
+    if (!isRecord6(parsed) || Object.keys(parsed).sort().join(",") !== "a,c,n,s") return null;
     const chainId = import_ethers6.ethers.BigNumber.from(String(parsed.c));
     const slot = import_ethers6.ethers.BigNumber.from(String(parsed.n));
     const sbtAddress = import_ethers6.ethers.utils.getAddress(String(parsed.a));
@@ -39562,13 +39904,13 @@ var accessConditionsOf = (config) => [
   config?.sessionModeProfile?.encryption?.accessConditions,
   config?.storageProfile?.payloadAccessControl?.accessConditions
 ].flatMap((document) => Array.isArray(document?.conditions) ? document.conditions : []);
-var conditionAddresses = (condition) => [condition?.contract, condition?.address, ...Array.isArray(condition?.sbtAddresses) ? condition.sbtAddresses : []].map((value) => trim5(value).toLowerCase()).filter(Boolean);
+var conditionAddresses = (condition) => [condition?.contract, condition?.address, ...Array.isArray(condition?.sbtAddresses) ? condition.sbtAddresses : []].map((value) => trim7(value).toLowerCase()).filter(Boolean);
 var positiveChainId = (value) => {
   const number = typeof value === "number" ? value : typeof value === "string" && value.trim() ? Number(value) : NaN;
   return Number.isSafeInteger(number) && number > 0 ? number : 0;
 };
 var resolveSbtChainId = (config, sbtAddress) => {
-  const target = trim5(sbtAddress).toLowerCase();
+  const target = trim7(sbtAddress).toLowerCase();
   const condition = accessConditionsOf(config).find(
     (entry) => entry?.kind === "sbt_onchain" && conditionAddresses(entry).includes(target) && positiveChainId(entry.chainId)
   );
@@ -39586,19 +39928,13 @@ var listSessionSbts = (config) => {
   return [...seen.values()];
 };
 var defaultCreateProvider = (rpcOverride) => (chainId) => {
-  const url = trim5(rpcOverride) || import_rpcDefaults3.default.getPublicRpcUrls(chainId)[0] || import_rpcDefaults3.default.getPathRpcUrl(chainId);
+  const url = trim7(rpcOverride) || import_rpcDefaults3.default.getPublicRpcUrls(chainId)[0] || import_rpcDefaults3.default.getPathRpcUrl(chainId);
   if (!url) throw new Error(`No public RPC is known for chain ${chainId}; set CE_MCP_RPC_URL.`);
   return new import_ethers6.ethers.providers.StaticJsonRpcProvider(url, chainId);
 };
 var ClaimError = class extends Error {
 };
-var SAFE_REASON_RE = /^[A-Za-z][\w .,'()-]{0,119}$/;
-var safeMessage = (error, fallback) => {
-  if (error instanceof ClaimError) return error.message;
-  const reason = [error?.reason, error?.errorName, error?.error?.reason].map((value) => typeof value === "string" ? value.replace(/^execution reverted:?\s*/i, "").trim() : "").find((value) => SAFE_REASON_RE.test(value));
-  const code = typeof error?.code === "string" && /^[A-Z_]{3,40}$/.test(error.code) ? error.code : "";
-  return [fallback, reason || code].filter(Boolean).join(": ");
-};
+var safeMessage = (error, fallback) => error instanceof ClaimError ? error.message : [fallback, safeErrorReason(error) || safeErrorCode(error)].filter(Boolean).join(": ");
 var createSbtClaimer = ({
   config = {},
   wallet,
@@ -39711,7 +40047,7 @@ var createSbtClaimer = ({
   const claimWithGroupPassword = async ({ ctx, provider, chainId, contract, sbtAddress, password }) => {
     const normalized2 = normalizeGroupPasswordInput(password);
     if (!normalized2) throw new ClaimError("This SBT needs a group password.");
-    const expectedHash = trim5(await contract.groupPasswordHash()).toLowerCase();
+    const expectedHash = trim7(await contract.groupPasswordHash()).toLowerCase();
     if (!expectedHash || expectedHash === import_ethers6.ethers.constants.HashZero) throw new ClaimError("This SBT has no group password set.");
     const groupWallet = await deriveGroupPasswordWallet({ password: normalized2, sbtAddress });
     if (import_ethers6.ethers.utils.solidityKeccak256(["address"], [groupWallet.address]) !== expectedHash) {
@@ -39745,7 +40081,7 @@ var createSbtClaimer = ({
       signal = callSignal;
       let address;
       try {
-        address = import_ethers6.ethers.utils.getAddress(trim5(sbtAddress));
+        address = import_ethers6.ethers.utils.getAddress(trim7(sbtAddress));
       } catch {
         throw new ClaimError("Pass the SBT contract address (0x\u2026).");
       }
@@ -39778,7 +40114,7 @@ var createSbtClaimer = ({
         const args = { ctx, provider, chainId, contract, sbtAddress: address };
         let transactions;
         if (mode === "public") transactions = [(await send({ ...args, method: "claim", args: [] })).transactionHash];
-        else if (mode === "password") transactions = await claimWithCommitReveal({ ...args, password: trim5(claimPassword) || trim5(groupPassword) });
+        else if (mode === "password") transactions = await claimWithCommitReveal({ ...args, password: trim7(claimPassword) || trim7(groupPassword) });
         else if (mode === "group_password") transactions = await claimWithGroupPassword({ ...args, password: groupPassword });
         else transactions = await claimWithInviteCode({ ...args, code: inviteCode || groupPassword });
         return { ...base, mode, status: "claimed", transactions };
@@ -39804,11 +40140,9 @@ var MAX_CACHED_RECORDS = 2e4;
 var MISSING_RECORD_RETRY_MS = 6e4;
 var MAX_OWN_ANSWER_ITEMS = 5e3;
 var MAX_TITLE_LENGTH = 120;
-var MAX_CONTEXT_PARAGRAPHS = 4;
-var MAX_CONTEXT_LENGTH = 2e3;
-var MAX_CONTEXT_LINKS = 4;
-var trim6 = (value) => typeof value === "string" ? value.trim() : typeof value === "number" ? String(value) : "";
-var isRecord6 = (value) => !!value && typeof value === "object" && !Array.isArray(value);
+var MAX_DESCRIPTION_LENGTH = 2e3;
+var trim8 = (value) => typeof value === "string" ? value.trim() : typeof value === "number" ? String(value) : "";
+var isRecord7 = (value) => !!value && typeof value === "object" && !Array.isArray(value);
 var sessionKey = (info) => info.kind === "registry" ? `registry ${info.chainId || 11155420} ${info.slug}` : `${info.workerOrigin} ${info.slug}`;
 var mapLimit = async (items, limit, task) => {
   const results = new Array(items.length);
@@ -39824,10 +40158,10 @@ var mapLimit = async (items, limit, task) => {
   return results;
 };
 var contextOf = (config) => {
-  const context = isRecord6(config?.sessionContext) ? config.sessionContext : {};
-  const paragraphs = (Array.isArray(context.paragraphs) ? context.paragraphs.map(text) : [text(context.body)]).filter(Boolean).slice(0, MAX_CONTEXT_PARAGRAPHS).map((paragraph) => paragraph.slice(0, MAX_CONTEXT_LENGTH));
-  const links = (Array.isArray(context.links) ? context.links : []).filter((link) => isRecord6(link) && /^https?:\/\//i.test(text(link.url))).slice(0, MAX_CONTEXT_LINKS).map((link) => ({ label: (text(link.label) || text(link.url)).slice(0, 200), url: text(link.url).slice(0, 2e3) }));
-  return { title: text(context.title).slice(0, 200), paragraphs, links };
+  const { html, ...context } = normalizeSessionContext(config?.sessionContext);
+  if (!html) return context;
+  const words = htmlToPlainText(html);
+  return { ...context, paragraphs: words ? [words] : [] };
 };
 var idList = (value) => new Set((Array.isArray(value) ? value : []).map((id) => text(id).toLowerCase()).filter(Boolean));
 var stringOptions = (payload) => Array.isArray(payload.options) ? payload.options.filter((option) => typeof option === "string") : [];
@@ -39836,9 +40170,9 @@ var finiteNumber = (value) => {
   if (typeof value === "string" && value.trim() && Number.isFinite(Number(value))) return Number(value);
   return void 0;
 };
-var SCALE_KEYS = ["min", "minimum", "max", "maximum", "minLabel", "lowLabel", "maxLabel", "highLabel"];
+var SCALE_KEYS = ["step", "min", "minimum", "max", "maximum", "minLabel", "lowLabel", "maxLabel", "highLabel"];
 var cleanScale = (record) => {
-  if (!isRecord6(record)) return {};
+  if (!isRecord7(record)) return {};
   const out = {};
   SCALE_KEYS.forEach((key) => {
     if (typeof record[key] === "string" || typeof record[key] === "number" && Number.isFinite(record[key])) out[key] = record[key];
@@ -39868,18 +40202,10 @@ var sanitizeQuestion = (payload, id) => {
   ratingScaleFor(question);
   return question;
 };
-var contentId = (question) => generateQuestionId(question.type, question.prompt, stringOptions(question), isSingleSelect(question), question.voiceCredits ?? 99);
-var chooseQuestionVersion = (versions) => {
-  const admin = versions.filter((version) => version.uploaderIsAdmin);
-  if (admin.length) return admin.sort((left, right) => left.createdAt < right.createdAt ? 1 : -1)[0];
-  const ranked = [...versions].sort((left, right) => {
-    const leftMatches = left.contentMatches === true ? 0 : 1;
-    const rightMatches = right.contentMatches === true ? 0 : 1;
-    if (leftMatches !== rightMatches) return leftMatches - rightMatches;
-    return left.createdAt < right.createdAt ? -1 : left.createdAt > right.createdAt ? 1 : 0;
-  });
-  return ranked[0];
-};
+var chooseQuestionVersion = (versions) => versions.reduce(
+  (chosen, candidate) => isPreferredStorageVersion(candidate, chosen) ? candidate : chosen,
+  null
+);
 var describeQuestion = (question, myAnswer) => {
   const options = stringOptions(question);
   const entry = {
@@ -39915,7 +40241,9 @@ var sameAuthoringInputs = (stored, record) => {
 var progressNotes = (questions, mine) => ({
   ...questions.locked ? { lockedQuestions: questions.locked } : {},
   ...questions.complete === false ? { questionsComplete: false } : {},
-  ...mine.complete === false ? { myAnswersComplete: false, note: "This session is large: answers made outside this agent may not all be listed." } : {}
+  ...questions.unread ? { unreadQuestions: questions.unread } : {},
+  ...mine.unread ? { unreadMyAnswers: mine.unread } : {},
+  ...mine.complete === false ? { myAnswersComplete: false, note: "Some answers could not be read or the scan is unfinished; the answers shown may be incomplete." } : {}
 });
 var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = () => Date.now(), sbt = null, createProvider, sleep, registry = {} }) => {
   const requestTestEth = createTestEthRequester({ config, wallet, createProvider, now, sleep });
@@ -39941,9 +40269,9 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
     state = await updateAgentState(config.stateDir, mutate);
   };
   const profile = () => ({
-    displayName: trim6(state?.profile?.displayName ?? config.profile.displayName),
-    modelId: trim6(state?.profile?.modelId ?? config.profile.modelId),
-    platform: trim6(state?.profile?.platform ?? config.profile.platform)
+    displayName: trim8(state?.profile?.displayName ?? config.profile.displayName),
+    modelId: trim8(state?.profile?.modelId ?? config.profile.modelId),
+    platform: trim8(state?.profile?.platform ?? config.profile.platform)
   });
   const trustedOriginsFor = (preferred) => config.trustedAppOrigins.includes(preferred) ? [preferred, ...config.trustedAppOrigins.filter((origin) => origin !== preferred)] : config.trustedAppOrigins;
   const openSession = async (info) => {
@@ -39971,7 +40299,7 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
   };
   const remember = (ctx, title, recruitmentSource) => saveState((fresh) => {
     const key = sessionKey(ctx.info);
-    const stored = isRecord6(fresh.sessions[key]) ? fresh.sessions[key] : {};
+    const stored = isRecord7(fresh.sessions[key]) ? fresh.sessions[key] : {};
     const previous = stored.sessionId && stored.sessionId !== ctx.client.sessionId ? {} : stored;
     fresh.sessions[key] = {
       ...previous,
@@ -39988,24 +40316,25 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
   });
   const sessionState = (ctx) => {
     const entry = state?.sessions?.[sessionKey(ctx.info)];
-    return isRecord6(entry) ? entry : {};
+    return isRecord7(entry) ? entry : {};
   };
   const rememberAnswers = (ctx, answered) => saveState((fresh) => {
     const entry = fresh.sessions[sessionKey(ctx.info)];
-    if (!isRecord6(entry) || entry.sessionId !== ctx.client.sessionId) return;
-    entry.answers = isRecord6(entry.answers) ? entry.answers : {};
-    answered.forEach(({ questionId, record, answeredAt, chainOrder }) => {
+    if (!isRecord7(entry) || entry.sessionId !== ctx.client.sessionId) return;
+    entry.answers = isRecord7(entry.answers) ? entry.answers : {};
+    answered.forEach(({ questionId, record, answeredAt, chainOrder, requestId }) => {
       entry.answers[questionId] = {
         value: record.answer.value,
         comment: record.additional.value,
         answeredAt,
         ...ctx.registry && chainOrder ? chainOrder : {}
       };
+      if (requestId && entry.pendingUploads?.[questionId]?.requestId === requestId) delete entry.pendingUploads[questionId];
     });
   });
   const resolveSession = async (session) => {
     await loadState();
-    const ref = trim6(session);
+    const ref = trim8(session);
     if (/^https?:\/\//i.test(ref)) {
       const parsed = parseSessionLink(ref, { allowLocalWorkers: config.allowLocalWorkers });
       const key2 = sessionKey(parsed);
@@ -40021,7 +40350,7 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
       if (!key) throw new Error(`No joined session named "${slug}". Join it first with join_session.`);
     }
     const entry = state.sessions[key];
-    if (!key || !isRecord6(entry)) throw new Error("No session joined yet. Call join_session with a session link.");
+    if (!key || !isRecord7(entry)) throw new Error("No session joined yet. Call join_session with a session link.");
     return openSession({
       workerOrigin: normalizeWorkerOrigin(entry.workerOrigin, { allowLocalWorkers: config.allowLocalWorkers }),
       slug: normalizeSessionSlug(entry.slug),
@@ -40041,33 +40370,27 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
   };
   const readCached = async (ctx, storageId) => {
     if (ctx.records.has(storageId)) return ctx.records.get(storageId);
-    if (now() - (ctx.missing.get(storageId) ?? -Infinity) < MISSING_RECORD_RETRY_MS) return null;
-    let payload = null;
+    if (now() - (ctx.missing.get(storageId) ?? -Infinity) < MISSING_RECORD_RETRY_MS) return void 0;
     try {
-      payload = await ctx.client.read(storageId);
+      const payload = await ctx.client.read(storageId);
+      ctx.missing.delete(storageId);
+      cacheRecord(ctx, storageId, payload);
+      return payload;
     } catch (error) {
       if (!(error instanceof WorkerRequestError) || error.status !== 404) throw error;
-    }
-    if (payload === null) {
       ctx.missing.set(storageId, now());
       if (ctx.missing.size > MAX_CACHED_RECORDS) ctx.missing.delete(ctx.missing.keys().next().value);
-    } else {
-      ctx.missing.delete(storageId);
-      cacheRecord(ctx, storageId, payload);
+      return void 0;
     }
-    return payload;
   };
   const readMany = async (ctx, storageIds) => {
     const deadline = now() + READ_DEADLINE_MS;
-    let complete = true;
     const payloads = await mapLimit(storageIds, READ_CONCURRENCY, async (storageId) => {
-      if (!ctx.records.has(storageId) && (now() >= deadline || signal?.aborted)) {
-        complete = false;
-        return void 0;
-      }
-      return readCached(ctx, storageId);
+      if (!ctx.records.has(storageId) && (now() >= deadline || signal?.aborted)) return void 0;
+      return readCached(ctx, storageId).catch(() => void 0);
     });
-    return { payloads, complete };
+    const unread = payloads.filter((payload) => payload === void 0).length;
+    return { payloads, complete: unread === 0, unread };
   };
   const loadQuestions = async (ctx) => {
     const sessionConfig = await ensureReady(ctx);
@@ -40077,7 +40400,7 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
       const all2 = [];
       for (const row of result.items) {
         try {
-          if (!isRecord6(row.payload) || typeof row.payload.type !== "string") continue;
+          if (!isRecord7(row.payload) || typeof row.payload.type !== "string") continue;
           const payload = isLockedQuestion(row.payload) ? { ...row.payload, prompt: "[encrypted]", locked: true } : row.payload;
           if (typeof payload.prompt !== "string") continue;
           all2.push({
@@ -40098,15 +40421,15 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
     }
     const { items, complete } = await ctx.client.listAll("questions", { maxItems: MAX_QUESTIONS2, signal });
     const hidden = new Set(items.filter((item) => item.hidden === true).map((item) => text(item.metadata?.resourceId).toLowerCase()));
-    const rows = items.filter((item) => item.hidden !== true && text(item.storageRef?.id));
-    const { payloads, complete: readComplete } = await readMany(ctx, rows.map((item) => text(item.storageRef.id)));
     const blocked = idList(sessionConfig.BLOCKED_QUESTION_IDS);
+    const rows = items.filter((item) => item.hidden !== true && text(item.storageRef?.id) && !hidden.has(text(item.metadata?.resourceId).toLowerCase()) && !blocked.has(text(item.metadata?.resourceId).toLowerCase()));
+    const { payloads, complete: readComplete, unread } = await readMany(ctx, rows.map((item) => text(item.storageRef.id)));
     const highlighted = idList(sessionConfig.HIGHLIGHTED_QUESTION_IDS);
     const versions = /* @__PURE__ */ new Map();
     rows.forEach((item, index) => {
       try {
         const payload = payloads[index];
-        if (!isRecord6(payload) || typeof payload.prompt !== "string" || typeof payload.type !== "string") return;
+        if (!isRecord7(payload) || typeof payload.prompt !== "string" || typeof payload.type !== "string") return;
         if (text(payload.sessionSlug) !== ctx.info.slug) return;
         if (text(payload.sessionId) && normalizeSessionIdHex(text(payload.sessionId)) !== ctx.client.sessionId) return;
         const id = (text(payload.id) || text(item.metadata?.resourceId)).toLowerCase();
@@ -40116,8 +40439,9 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
         list.push({
           payload: question,
           createdAt: text(item.metadata?.createdAt),
-          uploaderIsAdmin: item.metadata?.uploaderIsAdmin === true,
-          contentMatches: question.locked ? null : contentId(question) === id
+          createdAtMs: Date.parse(text(item.metadata?.createdAt)) || 0,
+          storageRefId: text(item.storageRef.id),
+          uploadAuthority: item.metadata?.uploadAuthority
         });
         versions.set(id, list);
       } catch {
@@ -40142,11 +40466,12 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
     questions.locked = all.length - questions.length;
     questions.lockedIds = new Set(all.filter((question) => isLockedQuestion(question)).map((question) => question.id));
     questions.complete = complete && readComplete;
+    questions.unread = unread;
     return questions;
   };
   const toEntries = async (ctx, items) => {
-    const rows = items.filter((item) => text(item.storageRef?.id));
-    const { payloads, complete } = await readMany(ctx, rows.map((item) => text(item.storageRef.id)));
+    const rows = items.filter((item) => item.hidden !== true && text(item.storageRef?.id));
+    const { payloads, complete, unread } = await readMany(ctx, rows.map((item) => text(item.storageRef.id)));
     const entries = rows.map((item, index) => ({
       storageId: text(item.storageRef.id),
       createdAt: text(item.metadata?.createdAt) || text(item.storageRef?.createdAt),
@@ -40154,22 +40479,23 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
       payload: payloads[index]
     }));
     entries.complete = complete;
+    entries.unread = unread;
     return entries;
   };
   const scanMyAnswers = async (ctx) => {
-    if (ctx.ownScan && (!ctx.registry || ctx.ownScan.complete) && now() - ctx.ownScan.at < OWN_ANSWER_SCAN_MAX_AGE_MS && ctx.ownScan.sessionId === ctx.client.sessionId) {
+    if (ctx.ownScan && ctx.ownScan.complete && now() - ctx.ownScan.at < OWN_ANSWER_SCAN_MAX_AGE_MS && ctx.ownScan.sessionId === ctx.client.sessionId && ctx.ownScan.windowKey === ctx.registry?.windowKey) {
       return ctx.ownScan;
     }
     if (ctx.registry) {
       const questions = await loadQuestions(ctx);
       const questionIds = new Set(questions.map((question) => question.id));
-      const { entries: entries2, complete: complete2, chainOrders } = await ctx.registry.readAnswers({ questionIds, maxRecords: MAX_OWN_ANSWER_ITEMS, mine: true, signal });
+      const { entries: entries2, complete: complete2, chainOrders, unreadAnswers } = await ctx.registry.readAnswers({ questionIds, maxRecords: MAX_OWN_ANSWER_ITEMS, mine: true, signal });
       const latest2 = latestAnswersByQuestion(entries2, { registryConfig: ctx.client.config, questionIds });
       const answers2 = /* @__PURE__ */ new Map();
       latest2.forEach((byResponder, id) => {
         if (byResponder.has(wallet.address.toLowerCase())) answers2.set(id, byResponder.get(wallet.address.toLowerCase()));
       });
-      ctx.ownScan = { at: now(), sessionId: ctx.client.sessionId, answers: answers2, complete: complete2, chainOrders };
+      ctx.ownScan = { at: now(), sessionId: ctx.client.sessionId, windowKey: ctx.registry.windowKey, answers: answers2, complete: complete2, chainOrders, unread: unreadAnswers };
       return ctx.ownScan;
     }
     const { items, complete: listed } = await ctx.client.listAll("responses", {
@@ -40188,36 +40514,41 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
       const entry = byResponder.get(self2);
       if (entry) answers.set(questionId, entry);
     });
-    ctx.ownScan = { at: now(), sessionId: ctx.client.sessionId, answers, complete };
+    ctx.ownScan = { at: now(), sessionId: ctx.client.sessionId, answers, complete, unread: entries.unread };
     return ctx.ownScan;
   };
   const loadMyAnswers = async (ctx) => {
     await ensureReady(ctx);
     const scan = await scanMyAnswers(ctx);
     const mine = new Map(scan.answers);
-    const complete = scan.complete;
+    let complete = scan.complete;
+    const blocks = /* @__PURE__ */ new Map();
     await loadState();
-    const local = sessionState(ctx).sessionId === ctx.client.sessionId && isRecord6(sessionState(ctx).answers) ? sessionState(ctx).answers : {};
-    Object.entries(local).forEach(([questionId, answer]) => {
-      if (!isRecord6(answer)) return;
-      if (ctx.registry && !complete) return;
+    const local = sessionState(ctx).sessionId === ctx.client.sessionId && isRecord7(sessionState(ctx).answers) ? sessionState(ctx).answers : {};
+    for (const [questionId, answer] of Object.entries(local)) {
+      if (!isRecord7(answer)) continue;
+      if (ctx.registry && (!scan.complete || !ctx.registry.containsBlock(answer.blockNumber))) continue;
       const known = mine.get(questionId);
       const chainOrder = scan.chainOrders?.get(questionId);
-      if (ctx.registry && chainOrder && compareChainOrder(answer, chainOrder) < 0) return;
+      if (ctx.registry && chainOrder && compareChainOrder(answer, chainOrder) < 0) continue;
       const newer = ctx.registry ? !known || compareChainOrder(answer, known) > 0 : !known || text(answer.answeredAt) > known.createdAt;
-      if (newer) {
+      if (!newer) continue;
+      const replaced = ctx.registry ? await ctx.registry.replacedWrite(answer, blocks) : false;
+      if (replaced === null) complete = false;
+      if (!replaced) {
         mine.set(questionId, {
           createdAt: text(answer.answeredAt),
           ...ctx.registry ? { blockNumber: answer.blockNumber, transactionIndex: answer.transactionIndex, logIndex: answer.logIndex } : {},
           payload: { answer: { value: answer.value }, additional: { value: answer.comment } }
         });
       }
-    });
+    }
     [...mine.entries()].forEach(([questionId, entry]) => {
       const value = entry?.payload?.answer?.value;
       if (value === "" || value === null || value === void 0 || Array.isArray(value) && !value.length) mine.delete(questionId);
     });
     mine.complete = complete;
+    mine.unread = scan.unread;
     return mine;
   };
   const sessionSummary = (ctx, sessionConfig) => ({
@@ -40233,7 +40564,7 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
         address: wallet.address,
         profile: profile(),
         currentSession: state.sessions[state.current]?.slug || null,
-        sessions: await mapLimit(Object.values(state.sessions).filter(isRecord6), READ_CONCURRENCY, async (entry) => ({
+        sessions: await mapLimit(Object.values(state.sessions).filter(isRecord7), READ_CONCURRENCY, async (entry) => ({
           session: entry.slug,
           title: entry.title || entry.slug,
           webUrl: buildSessionWebUrl(entry),
@@ -40254,9 +40585,9 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
     },
     async joinSession({ link, worker, session, inviteCode, groupPassword, claimPassword } = {}) {
       let parsed;
-      if (trim6(link)) {
+      if (trim8(link)) {
         parsed = parseSessionLink(link, { allowLocalWorkers: config.allowLocalWorkers });
-      } else if (trim6(worker) && trim6(session)) {
+      } else if (trim8(worker) && trim8(session)) {
         parsed = {
           appOrigin: config.appOrigin,
           slug: normalizeSessionSlug(session),
@@ -40277,9 +40608,9 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
       const offered = parsed.sbtClaims.filter((claim) => !claim.auto).map((claim) => claim.sbt);
       if (offered.length) outcome.sbtsToClaimWithClaimSbt = offered;
       const separateCodes = {
-        inviteCode: trim6(inviteCode),
-        groupPassword: trim6(groupPassword),
-        claimPassword: trim6(claimPassword)
+        inviteCode: trim8(inviteCode),
+        groupPassword: trim8(groupPassword),
+        claimPassword: trim8(claimPassword)
       };
       const hasSeparateCodes = Object.values(separateCodes).some(Boolean);
       if (hasSeparateCodes && claims.length !== 1) {
@@ -40309,7 +40640,7 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
               })
             );
           } catch (error) {
-            outcome.sbtClaims.push({ sbt: claim.sbt, status: "failed", error: error.message });
+            outcome.sbtClaims.push({ sbt: claim.sbt, status: "failed", error: describeError(error) });
           }
         }
         tokenClaims = await ctx.client.login().then((claims2) => {
@@ -40320,22 +40651,22 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
       outcome.testEth = await ctx.client.describeTestEth();
       outcome.signedIn = !loginError;
       if (loginError) {
-        outcome.readOnlyReason = loginError.message;
+        outcome.readOnlyReason = describeError(loginError);
         outcome.note = "Joined read-only: public questions and results are available, but uploads, answers, statements, and faucet requests need Worker access.";
       }
-      const scopes = isRecord6(tokenClaims?.scopes) ? tokenClaims.scopes : {};
+      const scopes = isRecord7(tokenClaims?.scopes) ? tokenClaims.scopes : {};
       outcome.scopes = Object.keys(scopes).filter((scope) => scopes[scope] === true);
       if (parsed.joinGroupId) {
         checkpoint();
         try {
           if (ctx.registry) throw new Error("Worker groups are not available in on-chain sessions.");
-          await ctx.client.joinGroup(parsed.joinGroupId);
+          await ctx.client.joinGroup(parsed.joinGroupId, { signal });
           outcome.joinedGroup = parsed.joinGroupId;
         } catch (error) {
-          outcome.groupJoinError = error.message;
+          outcome.groupJoinError = describeError(error);
         }
       }
-      outcome.description = text(sessionConfig.sessionInfo).slice(0, MAX_CONTEXT_LENGTH);
+      outcome.description = text(sessionConfig.sessionInfo).slice(0, MAX_DESCRIPTION_LENGTH);
       outcome.context = contextOf(sessionConfig);
       const sessionSbts = listSessionSbts(sessionConfig);
       if (sessionSbts.length) outcome.sessionSbts = sessionSbts;
@@ -40355,7 +40686,7 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
       return {
         ...sessionSummary(ctx, sessionConfig),
         testEth: await ctx.client.describeTestEth(),
-        description: text(sessionConfig.sessionInfo).slice(0, MAX_CONTEXT_LENGTH),
+        description: text(sessionConfig.sessionInfo).slice(0, MAX_DESCRIPTION_LENGTH),
         context: contextOf(sessionConfig),
         ...endsAt ? { endsAt } : {},
         ...sessionSbts.length ? { sessionSbts } : {},
@@ -40393,10 +40724,12 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
       const results = [];
       const answered = [];
       const pendingAnswers = [];
+      const operationId = randomUUID2();
       let txHash;
+      let reconciliationRequired = false;
       const seen = /* @__PURE__ */ new Set();
       for (const item of answers) {
-        const questionId = trim6(item?.questionId).toLowerCase();
+        const questionId = trim8(item?.questionId).toLowerCase();
         if (seen.has(questionId)) {
           results.push({ questionId, ok: false, error: "This question appears more than once in the call; send one answer per question." });
           continue;
@@ -40436,12 +40769,24 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
           continue;
         }
         try {
-          const storageRef = await ctx.client.upload({ resource: "responses", data: JSON.stringify(built.record) });
+          const data = JSON.stringify(built.record);
+          const digest = createHash("sha256").update(data).digest("hex");
+          let requestId;
+          await saveState((fresh) => {
+            const entry = fresh.sessions[sessionKey(ctx.info)];
+            if (!isRecord7(entry) || entry.sessionId !== ctx.client.sessionId) throw new Error("Session identity changed; join again before answering.");
+            entry.pendingUploads = isRecord7(entry.pendingUploads) ? entry.pendingUploads : {};
+            const previous = entry.pendingUploads[questionId];
+            requestId = previous?.payloadDigest === digest && trim8(previous.requestId) ? previous.requestId : `answer:v1:${operationId}:${questionId}`;
+            entry.pendingUploads[questionId] = { payloadDigest: digest, requestId };
+          });
+          checkpoint();
+          const storageRef = await ctx.client.upload({ resource: "responses", data, requestId, signal });
           if (text(storageRef?.id)) cacheRecord(ctx, text(storageRef.id), built.record);
-          answered.push({ questionId, record: built.record, answeredAt: text(storageRef?.createdAt) || new Date(now()).toISOString() });
+          answered.push({ questionId, requestId, record: built.record, answeredAt: text(storageRef?.createdAt) || new Date(now()).toISOString() });
           results.push({ questionId, ok: true, answer: built.record.answer.value });
         } catch (error) {
-          results.push({ questionId, ok: false, error: error.message });
+          results.push({ questionId, ok: false, error: describeError(error) });
         }
       }
       if (pendingAnswers.length) {
@@ -40456,19 +40801,32 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
           pendingAnswers.forEach(({ questionId, record }) => {
             answered.push({ questionId, record, answeredAt: new Date(now()).toISOString(), chainOrder: {
               blockNumber: submitted.receipt.blockNumber,
+              blockHash: submitted.receipt.blockHash,
               transactionIndex: submitted.receipt.transactionIndex,
               logIndex: submitted.receipt.logs.at(-1)?.logIndex || 0
             } });
             results.push({ questionId, ok: true, answer: record.answer.value });
           });
         } catch (error) {
-          pendingAnswers.forEach(({ questionId }) => results.push({ questionId, ok: false, error: error.message }));
+          if (typeof error.txHash === "string" && /^0x[0-9a-f]{64}$/i.test(error.txHash)) txHash = error.txHash;
+          reconciliationRequired = error.reconciliationRequired === true;
+          pendingAnswers.forEach(({ questionId }) => results.push({ questionId, ok: false, error: describeError(error) }));
+        }
+      }
+      let warning;
+      if (answered.length) {
+        try {
+          await rememberAnswers(ctx, answered);
+        } catch {
+          ctx.ownScan = null;
+          warning = "Answers were submitted, but the local answer history could not be saved. Do not resubmit them to fix this warning.";
         }
       }
-      if (answered.length) await rememberAnswers(ctx, answered);
       return {
         session: ctx.info.slug,
         ...txHash ? { txHash } : {},
+        ...reconciliationRequired ? { reconciliationRequired: true } : {},
+        ...warning ? { warning } : {},
         submitted: results.filter((result) => result.ok).length,
         failed: results.filter((result) => !result.ok).length,
         results
@@ -40510,7 +40868,7 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
       ];
       checkpoint();
       try {
-        const storageRef = await ctx.client.upload({ resource: "questions", data: built.record, tags: tagList });
+        const storageRef = await ctx.client.upload({ resource: "questions", data: built.record, tags: tagList, signal });
         if (text(storageRef?.id)) cacheRecord(ctx, text(storageRef.id), built.record);
         return { session: ctx.info.slug, questionId: built.id, created: true, prompt: built.record.prompt };
       } catch (error) {
@@ -40554,18 +40912,21 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
       let entries;
       let complete;
       let listedCount;
+      let unreadAnswers;
       const knownIds = new Set(questions.map((question) => question.id));
       if (ctx.registry) {
         const result = await ctx.registry.readAnswers({ questionIds: knownIds, maxRecords: cap, signal });
         entries = result.entries;
         complete = result.complete;
         listedCount = entries.length;
+        unreadAnswers = result.unreadAnswers;
       } else {
         const result = await ctx.client.listAll("responses", { maxItems: MAX_RESULT_RECORDS, signal });
         const listed = result.items.filter((item) => text(item.storageRef?.id)).sort((left, right) => text(left.metadata?.createdAt) < text(right.metadata?.createdAt) ? 1 : -1);
         entries = await toEntries(ctx, listed.slice(0, cap));
         complete = result.complete;
         listedCount = listed.length;
+        unreadAnswers = entries.unread;
       }
       const latest = latestAnswersByQuestion(entries, {
         sessionSlug: ctx.info.slug,
@@ -40578,6 +40939,7 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
         resultsPublic: true,
         webUrl: buildSessionWebUrl(ctx.info),
         participants: participants.size,
+        unreadAnswers,
         partial: !complete || listedCount > cap || questions.complete === false || entries.complete === false,
         questions: questions.filter((question) => !wanted || wanted.has(question.id)).map((question) => summarizeQuestion(question, latest.get(question.id)))
       };
@@ -40586,10 +40948,10 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
       const ctx = await resolveSession(session);
       if (ctx.registry) throw new Error("Worker groups are not available in on-chain sessions.");
       await ensureReady(ctx);
-      const id = trim6(groupId);
+      const id = trim8(groupId);
       if (!/^[A-Za-z0-9._:-]{1,128}$/.test(id)) throw new Error("Pass a valid group id.");
       checkpoint();
-      await ctx.client.joinGroup(id);
+      await ctx.client.joinGroup(id, { signal });
       return { session: ctx.info.slug, joinedGroup: id };
     },
     async claimSbt({ session, sbt: sbtAddress, inviteCode, groupPassword, claimPassword } = {}) {
@@ -40601,10 +40963,10 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
       });
       const result = await sbt.claim({
         ctx,
-        sbtAddress: trim6(sbtAddress),
-        inviteCode: trim6(inviteCode),
-        groupPassword: trim6(groupPassword),
-        claimPassword: trim6(claimPassword),
+        sbtAddress: trim8(sbtAddress),
+        inviteCode: trim8(inviteCode),
+        groupPassword: trim8(groupPassword),
+        claimPassword: trim8(claimPassword),
         signal
       });
       await ctx.client.login().catch(() => {
@@ -40628,7 +40990,7 @@ var sessionParam = {
   type: "string",
   description: "Session slug or link. Defaults to the session joined most recently."
 };
-var text3 = (description, extra = {}) => ({ type: "string", description, ...extra });
+var text4 = (description, extra = {}) => ({ type: "string", description, ...extra });
 var READ = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true };
 var WRITE = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true };
 var SPENDS = { ...WRITE, destructiveHint: true };
@@ -40648,9 +41010,9 @@ var buildTools = (participant) => [
     inputSchema: {
       type: "object",
       properties: {
-        displayName: text3("Name shown in reports; up to 80 characters. Empty string clears it."),
-        modelId: text3("Model identifier, for example the model you run on."),
-        platform: text3("Agent platform or harness.")
+        displayName: text4("Name shown in reports; up to 80 characters. Empty string clears it."),
+        modelId: text4("Model identifier, for example the model you run on."),
+        platform: text4("Agent platform or harness.")
       },
       additionalProperties: false
     },
@@ -40664,12 +41026,12 @@ var buildTools = (participant) => [
     inputSchema: {
       type: "object",
       properties: {
-        link: text3("Session link, including any invite parameters."),
-        worker: text3("Worker origin, when you have no link."),
-        session: text3("Session slug, when you have no link."),
-        inviteCode: text3("SBT invite code, if one was given separately from the link."),
-        groupPassword: text3("SBT group password, if one was given separately."),
-        claimPassword: text3("SBT claim password, if one was given separately.")
+        link: text4("Session link, including any invite parameters."),
+        worker: text4("Worker origin, when you have no link."),
+        session: text4("Session slug, when you have no link."),
+        inviteCode: text4("SBT invite code, if one was given separately from the link."),
+        groupPassword: text4("SBT group password, if one was given separately."),
+        claimPassword: text4("SBT claim password, if one was given separately.")
       },
       additionalProperties: false
     },
@@ -40695,7 +41057,7 @@ var buildTools = (participant) => [
   {
     name: "list_questions",
     title: "List questions",
-    description: "List the session\u2019s statements and questions with their type, options or scale, and your latest answer. Unanswered ones come first by default.",
+    description: "List the session\u2019s statements and questions with their type, options or scale, and your latest answer. Unanswered ones come first by default. questionsComplete or myAnswersComplete is false when listing or payload reads are unfinished; unreadQuestions and unreadMyAnswers count listed payloads that could not be read.",
     inputSchema: {
       type: "object",
       properties: {
@@ -40711,7 +41073,7 @@ var buildTools = (participant) => [
   {
     name: "answer",
     title: "Answer questions",
-    description: 'Submit answers. Values by type: binary "Agree" | "Unsure" | "Disagree"; rating a whole number on the question\u2019s scale; multichoice the option text (an array when several are allowed); quadratic one signed whole-number vote per option whose squares sum within the credit budget; freeform text. Answering again replaces your previous answer.',
+    description: 'Submit answers. Values by type: binary "Agree" | "Unsure" | "Disagree"; rating a number on the question\u2019s scale and step grid (default step 1); multichoice the option text (an array when several are allowed); quadratic one signed whole-number vote per option whose squares sum within the credit budget; freeform text. Answering again replaces your previous answer.',
     inputSchema: {
       type: "object",
       properties: {
@@ -40723,9 +41085,9 @@ var buildTools = (participant) => [
           items: {
             type: "object",
             properties: {
-              questionId: text3("Question id from list_questions."),
+              questionId: text4("Question id from list_questions."),
               value: { description: "The answer value; see the tool description for each type." },
-              comment: text3("Optional reasoning shown with your answer (up to 4000 characters)."),
+              comment: text4("Optional reasoning shown with your answer (up to 4000 characters)."),
               importance: { type: "integer", minimum: 0, maximum: 10, description: "How much this question matters to you." },
               conviction: { type: "integer", minimum: 0, maximum: 10, description: "How sure you are of your answer." }
             },
@@ -40748,7 +41110,7 @@ var buildTools = (participant) => [
       type: "object",
       properties: {
         session: sessionParam,
-        prompt: text3("The statement or question text."),
+        prompt: text4("The statement or question text."),
         type: { type: "string", enum: ["binary", "rating", "multichoice", "quadratic", "freeform"] },
         options: { type: "array", items: { type: "string" }, description: "Options for multichoice or quadratic." },
         singleSelect: { type: "boolean", description: "Multichoice: allow only one option." },
@@ -40764,7 +41126,7 @@ var buildTools = (participant) => [
   {
     name: "get_results",
     title: "Get results",
-    description: "Summarize everyone\u2019s latest answers per question when the session publishes results: agree/unsure/disagree counts, rating means, option counts, and how many answers came from self-declared agents.",
+    description: "Summarize everyone\u2019s latest answers per question when the session publishes results: agree/unsure/disagree counts, rating means, option counts, and how many answers came from self-declared agents. partial is true when a scan is unfinished, capped, or any listed question or answer payload could not be read. unreadAnswers counts the selected listed answer records that could not be read; readable older answers may still appear until those records recover.",
     inputSchema: {
       type: "object",
       properties: {
@@ -40783,7 +41145,7 @@ var buildTools = (participant) => [
     description: "Join an open group in the session by its id (from a ?joinGroup= link).",
     inputSchema: {
       type: "object",
-      properties: { session: sessionParam, groupId: text3("Group id.") },
+      properties: { session: sessionParam, groupId: text4("Group id.") },
       required: ["groupId"],
       additionalProperties: false
     },
@@ -40798,10 +41160,10 @@ var buildTools = (participant) => [
       type: "object",
       properties: {
         session: sessionParam,
-        sbt: text3("SBT contract address."),
-        inviteCode: text3("Invite code, when the SBT uses invites."),
-        groupPassword: text3("Group password, when the SBT uses one."),
-        claimPassword: text3("Claim password, when the SBT uses per-claim passwords.")
+        sbt: text4("SBT contract address."),
+        inviteCode: text4("Invite code, when the SBT uses invites."),
+        groupPassword: text4("Group password, when the SBT uses one."),
+        claimPassword: text4("Claim password, when the SBT uses per-claim passwords.")
       },
       required: ["sbt"],
       additionalProperties: false