@agalmic/contextengine 0.1.2 → 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;
         }
@@ -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(trim8);
+          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 trim8(str) {
+    function trim9(str) {
       return str.trim();
     }
   }
@@ -36406,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.`);
   }
@@ -36425,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.");
   }
@@ -36494,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);
@@ -36631,9 +36640,9 @@ var DIAGNOSTICS = /\[ See: |\((?=\w+=)|\b(?:requestBody|body|url|transaction|dat
 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 text4 = String(error?.message || error || "").slice(0, MAX_ERROR_LENGTH);
-  const cut = text4.search(DIAGNOSTICS);
-  return (cut < 0 ? text4 : text4.slice(0, cut)).trimEnd().replace(URLS, hostOnly) || "Unknown 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 = ({
@@ -36656,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;
     }
@@ -36752,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."));
     }
@@ -36905,6 +36914,7 @@ var createTestEthRequester = ({
     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 }
     });
@@ -36961,6 +36971,17 @@ 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: {
@@ -38202,40 +38223,6 @@ function summarizeQuadraticAllocations(responses, question) {
   return { options, totalResponders, excludedResponses };
 }
 
-// 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 = (text4) => (text4 || "").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 });
-};
-
 // shared/questions/ratingScale.mjs
 var trim2 = (value) => String(value == null ? "" : value).trim();
 var isObj = (value) => !!value && typeof value === "object" && !Array.isArray(value);
@@ -38290,39 +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, questionIdMatchesContent } = createQuestionIdDerivation(import_ethers3.ethers);
-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": {
@@ -38331,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 };
     }
@@ -38361,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,
@@ -38382,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 = ({
@@ -38397,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 : "",
@@ -38429,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);
@@ -38455,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 };
 };
 
@@ -38476,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;
 };
@@ -38501,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);
@@ -38521,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>.");
   }
@@ -38534,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"),
@@ -38710,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}`, {
@@ -38741,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 });
@@ -38859,15 +38910,16 @@ var createWorkerClient = ({ workerOrigin, slug, trustedOrigins, wallet, fetchImp
     }
     return data;
   };
-  const upload = async ({ resource, data, tags = [], requestId = "" }) => {
+  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, ...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) {
@@ -39101,6 +39153,7 @@ 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)}`);
@@ -39117,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(),
@@ -39163,6 +39216,7 @@ var createRegistryWriter = ({ provider, chainId, wallet, surveys, slug, remember
     for (const record of records) pointers.push(await upload(client, "responses", record.questionID, record, signal));
     stopped(signal);
     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));
@@ -39177,6 +39231,7 @@ var createRegistryWriter = ({ provider, chainId, wallet, surveys, slug, remember
     const pointer = await upload(client, "questions", record.id, record, signal);
     stopped(signal);
     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);
@@ -39240,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();
@@ -39247,9 +39307,23 @@ 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 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.");
@@ -39277,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 chainRequest(() => 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;
   };
@@ -39311,14 +39406,14 @@ var createRegistrySession = async ({ info, config, wallet, fetchImpl = globalThi
     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);
-  let questionMark = null;
   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));
+    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 };
@@ -39335,7 +39430,7 @@ var createRegistrySession = async ({ info, config, wallet, fetchImpl = globalThi
       if (replaced2) questions.delete(id);
     }
     if (pending.size < MAX_CACHE && questions.size < MAX_QUESTIONS) {
-      const head = await readHeadMark(await chainRequest(() => provider.getBlockNumber()), blocks);
+      const head = await readHeadMark(end, blocks);
       if (head) {
         const scanned = await scanRegistryLogs({
           provider,
@@ -39389,7 +39484,7 @@ var createRegistrySession = async ({ info, config, wallet, fetchImpl = globalThi
     let verified = true;
     const responseFilter = filter("ResponsesSubmitted");
     if (mine) responseFilter.topics.push(import_ethers5.ethers.utils.hexZeroPad(wallet.address, 32));
-    const head = await chainRequest(() => provider.getBlockNumber());
+    const head = await readWindowEnd();
     const scope = [...known].sort().join(",");
     let state = answerScans.get(mine);
     const replaced = !!state && state.scope === scope && head >= state.head && await historyReplaced(state.mark, blocks);
@@ -39397,7 +39492,7 @@ var createRegistrySession = async ({ info, config, wallet, fetchImpl = globalThi
       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)) continue;
+        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);
@@ -39407,7 +39502,8 @@ var createRegistrySession = async ({ info, config, wallet, fetchImpl = globalThi
       return {
         entries: [...held.values()].sort((a, b) => compareChainOrder(b, a)).slice(0, maxRecords),
         complete: false,
-        chainOrders: chainOrders2
+        chainOrders: chainOrders2,
+        unreadAnswers: state.result?.unreadAnswers || 0
       };
     }
     if (!state || state.scope !== scope || head < state.head || replaced) {
@@ -39473,7 +39569,7 @@ var createRegistrySession = async ({ info, config, wallet, fetchImpl = globalThi
     const scannedAll = !state.ranges.length && !state.capped;
     const latest = new Map(state.latest);
     for (const [id, entry] of localAnswers) {
-      if (!known.has(entry.questionId)) continue;
+      if (!known.has(entry.questionId) || !containsBlock(entry.blockNumber)) continue;
       const replaced2 = await replacedWrite(entry, blocks);
       if (replaced2 === null) verified = false;
       if (replaced2) {
@@ -39488,6 +39584,7 @@ var createRegistrySession = async ({ info, config, wallet, fetchImpl = globalThi
     const chainOrders = new Map(candidates.filter((entry) => normalized(entry.responder) === normalized(wallet.address)).map((entry) => [entry.questionId, entry]));
     const entries = [];
     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 () => {
@@ -39498,7 +39595,16 @@ var createRegistrySession = async ({ info, config, wallet, fetchImpl = globalThi
         }
         const entry = selected[next++];
         try {
-          const pointer = entry.local ? entry.storageId : await chainRequest(() => 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;
@@ -39508,10 +39614,12 @@ var createRegistrySession = async ({ info, config, wallet, fetchImpl = globalThi
           entries.push({ ...entry, storageId: pointer, createdAt, payload });
         } catch {
           complete = false;
+          unreadAnswers++;
         }
       }
     }));
-    state.result = { 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) => {
@@ -39531,15 +39639,17 @@ var createRegistrySession = async ({ info, config, wallet, fetchImpl = globalThi
     if (resource === "questions") questions.set(id, { ...entry, local: true });
     else localAnswers.set(id, entry);
   } });
-  return { loadConfig, loadQuestions, readAnswers, replacedWrite, ...writer, get config() {
+  return { loadConfig, loadQuestions, readAnswers, replacedWrite, containsBlock, get windowKey() {
+    return windowKey;
+  }, ...writer, get config() {
     return sessionConfig;
   }, workerOrigin };
 };
 
 // shared/storage/canonicalStorageVersions.mjs
-var trim5 = (value) => (typeof value === "string" ? value : value == null ? "" : String(value)).trim();
+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(trim5(left.storageRefId), trim5(right.storageRefId));
+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;
@@ -39550,8 +39660,46 @@ var isPreferredStorageVersion = (candidate, current) => {
   return candidateAdmin ? age > 0 : age < 0;
 };
 
-// mcp/lib/results.mjs
+// 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;
@@ -39560,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);
@@ -39596,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;
@@ -39665,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) };
     }
@@ -39715,12 +39859,12 @@ var REVEAL_WAIT_MS = 9e4;
 var POLL_MS = 2e3;
 var GAS_HEADROOM_PERCENT = 130;
 var PASSWORD_CLAIM_GAS_BUDGET = 4e5;
-var trim6 = (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 = trim6(raw).replace(/\s+/g, "");
+  const compact = trim7(raw).replace(/\s+/g, "");
   if (!compact) return "";
   if (import_ethers6.ethers.utils.isHexString(compact)) {
     try {
@@ -39732,14 +39876,14 @@ var normalizeGroupPasswordInput = (raw) => {
   return compact;
 };
 var decodeInviteCode = (raw) => {
-  let code = trim6(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));
@@ -39760,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) => trim6(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 = trim6(sbtAddress).toLowerCase();
+  const target = trim7(sbtAddress).toLowerCase();
   const condition = accessConditionsOf(config).find(
     (entry) => entry?.kind === "sbt_onchain" && conditionAddresses(entry).includes(target) && positiveChainId(entry.chainId)
   );
@@ -39784,7 +39928,7 @@ var listSessionSbts = (config) => {
   return [...seen.values()];
 };
 var defaultCreateProvider = (rpcOverride) => (chainId) => {
-  const url = trim6(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);
 };
@@ -39903,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 = trim6(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) {
@@ -39937,7 +40081,7 @@ var createSbtClaimer = ({
       signal = callSignal;
       let address;
       try {
-        address = import_ethers6.ethers.utils.getAddress(trim6(sbtAddress));
+        address = import_ethers6.ethers.utils.getAddress(trim7(sbtAddress));
       } catch {
         throw new ClaimError("Pass the SBT contract address (0x\u2026).");
       }
@@ -39970,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: trim6(claimPassword) || trim6(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 };
@@ -39996,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 trim7 = (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);
@@ -40016,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") : [];
@@ -40028,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];
@@ -40099,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 });
@@ -40125,9 +40269,9 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
     state = await updateAgentState(config.stateDir, mutate);
   };
   const profile = () => ({
-    displayName: trim7(state?.profile?.displayName ?? config.profile.displayName),
-    modelId: trim7(state?.profile?.modelId ?? config.profile.modelId),
-    platform: trim7(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) => {
@@ -40155,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,
@@ -40172,12 +40316,12 @@ 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 : {};
+    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,
@@ -40190,7 +40334,7 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
   });
   const resolveSession = async (session) => {
     await loadState();
-    const ref = trim7(session);
+    const ref = trim8(session);
     if (/^https?:\/\//i.test(ref)) {
       const parsed = parseSessionLink(ref, { allowLocalWorkers: config.allowLocalWorkers });
       const key2 = sessionKey(parsed);
@@ -40206,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),
@@ -40226,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);
@@ -40262,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({
@@ -40283,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();
@@ -40328,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),
@@ -40340,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", {
@@ -40374,7 +40514,7 @@ 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) => {
@@ -40384,10 +40524,10 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
     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 : {};
+    const local = sessionState(ctx).sessionId === ctx.client.sessionId && isRecord7(sessionState(ctx).answers) ? sessionState(ctx).answers : {};
     for (const [questionId, answer] of Object.entries(local)) {
-      if (!isRecord6(answer)) continue;
-      if (ctx.registry && !scan.complete) continue;
+      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) continue;
@@ -40408,6 +40548,7 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
       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) => ({
@@ -40423,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),
@@ -40444,9 +40585,9 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
     },
     async joinSession({ link, worker, session, inviteCode, groupPassword, claimPassword } = {}) {
       let parsed;
-      if (trim7(link)) {
+      if (trim8(link)) {
         parsed = parseSessionLink(link, { allowLocalWorkers: config.allowLocalWorkers });
-      } else if (trim7(worker) && trim7(session)) {
+      } else if (trim8(worker) && trim8(session)) {
         parsed = {
           appOrigin: config.appOrigin,
           slug: normalizeSessionSlug(session),
@@ -40467,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: trim7(inviteCode),
-        groupPassword: trim7(groupPassword),
-        claimPassword: trim7(claimPassword)
+        inviteCode: trim8(inviteCode),
+        groupPassword: trim8(groupPassword),
+        claimPassword: trim8(claimPassword)
       };
       const hasSeparateCodes = Object.values(separateCodes).some(Boolean);
       if (hasSeparateCodes && claims.length !== 1) {
@@ -40513,19 +40654,19 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
         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 = 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;
@@ -40545,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 } : {},
@@ -40588,7 +40729,7 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
       let reconciliationRequired = false;
       const seen = /* @__PURE__ */ new Set();
       for (const item of answers) {
-        const questionId = trim7(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;
@@ -40633,13 +40774,14 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
           let requestId;
           await saveState((fresh) => {
             const entry = fresh.sessions[sessionKey(ctx.info)];
-            if (!isRecord6(entry) || entry.sessionId !== ctx.client.sessionId) throw new Error("Session identity changed; join again before answering.");
-            entry.pendingUploads = isRecord6(entry.pendingUploads) ? entry.pendingUploads : {};
+            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 && trim7(previous.requestId) ? previous.requestId : `answer:v1:${operationId}:${questionId}`;
+            requestId = previous?.payloadDigest === digest && trim8(previous.requestId) ? previous.requestId : `answer:v1:${operationId}:${questionId}`;
             entry.pendingUploads[questionId] = { payloadDigest: digest, requestId };
           });
-          const storageRef = await ctx.client.upload({ resource: "responses", data, 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, requestId, record: built.record, answeredAt: text(storageRef?.createdAt) || new Date(now()).toISOString() });
           results.push({ questionId, ok: true, answer: built.record.answer.value });
@@ -40726,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) {
@@ -40770,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,
@@ -40794,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)))
       };
@@ -40802,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 = trim7(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 } = {}) {
@@ -40817,10 +40963,10 @@ var createParticipant = ({ config, wallet, fetchImpl = globalThis.fetch, now = (
       });
       const result = await sbt.claim({
         ctx,
-        sbtAddress: trim7(sbtAddress),
-        inviteCode: trim7(inviteCode),
-        groupPassword: trim7(groupPassword),
-        claimPassword: trim7(claimPassword),
+        sbtAddress: trim8(sbtAddress),
+        inviteCode: trim8(inviteCode),
+        groupPassword: trim8(groupPassword),
+        claimPassword: trim8(claimPassword),
         signal
       });
       await ctx.client.login().catch(() => {
@@ -40844,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 };
@@ -40864,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
     },
@@ -40880,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
     },
@@ -40911,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: {
@@ -40927,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: {
@@ -40939,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." }
             },
@@ -40964,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." },
@@ -40980,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: {
@@ -40999,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
     },
@@ -41014,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