@riddledc/riddle-proof 0.7.153 → 0.7.155

package/dist/{chunk-QJJ3ISMK.js → chunk-YB3LNLZB.js}

@@ -480,6 +480,8 @@ function profileSetupWindowCallReceipts(results) {
     };
     if (result.returned !== void 0) receipt.returned = result.returned;
     if (result.expected_return !== void 0) receipt.expected_return = result.expected_return;
+    const returnSummary = profileSetupReturnSummary(result);
+    if (returnSummary.length) receipt.return_summary = returnSummary;
     return receipt;
   });
 }
@@ -495,6 +497,40 @@ function profileSetupWindowEvalReceipts(results) {
     };
     if (result.returned !== void 0) receipt.returned = result.returned;
     if (result.expected_return !== void 0) receipt.expected_return = result.expected_return;
+    const returnSummary = profileSetupReturnSummary(result);
+    if (returnSummary.length) receipt.return_summary = returnSummary;
+    return receipt;
+  });
+}
+function profileSetupReturnSummaryFields(result) {
+  const input = result.return_summary_fields;
+  if (!Array.isArray(input)) return [];
+  const fields = [];
+  for (const item of input) {
+    if (typeof item === "string") {
+      const path2 = item.trim();
+      if (path2) fields.push({ path: path2 });
+      continue;
+    }
+    if (!isRecord(item)) continue;
+    const path = stringValue(item.path) ?? stringValue(item.key) ?? stringValue(item.json_path) ?? stringValue(item.jsonPath);
+    if (!path) continue;
+    const label = stringValue(item.label) ?? stringValue(item.name) ?? stringValue(item.title);
+    fields.push(label ? { path, label } : { path });
+  }
+  return fields;
+}
+function profileSetupReturnSummary(result) {
+  if (result.returned === void 0) return [];
+  return profileSetupReturnSummaryFields(result).map((field) => {
+    const resolved = resolveJsonPath(result.returned, field.path);
+    const receipt = {
+      label: field.label || field.path,
+      path: field.path,
+      exists: resolved.exists
+    };
+    if (resolved.exists) receipt.value = toJsonValue(resolved.value);
+    if (resolved.error) receipt.reason = resolved.error;
     return receipt;
   });
 }
@@ -683,6 +719,37 @@ function normalizeSetupActionArgs(input, index) {
   }
   return argsInput.map(toJsonValue);
 }
+function normalizeReturnSummaryFields(input, index) {
+  const fieldsInput = valueFromOwn(
+    input,
+    "return_summary_fields",
+    "returnSummaryFields",
+    "summary_fields",
+    "summaryFields",
+    "receipt_fields",
+    "receiptFields",
+    "return_receipt_fields",
+    "returnReceiptFields"
+  );
+  if (fieldsInput === void 0) return void 0;
+  if (!Array.isArray(fieldsInput)) {
+    throw new Error(`target.setup_actions[${index}].return_summary_fields must be an array.`);
+  }
+  return fieldsInput.map((field, fieldIndex) => {
+    if (typeof field === "string") {
+      const path2 = field.trim();
+      if (!path2) throw new Error(`target.setup_actions[${index}].return_summary_fields[${fieldIndex}] requires path.`);
+      return { path: path2 };
+    }
+    if (!isRecord(field)) {
+      throw new Error(`target.setup_actions[${index}].return_summary_fields[${fieldIndex}] must be a string path or object.`);
+    }
+    const path = stringFromOwn(field, "path", "key", "json_path", "jsonPath");
+    if (!path) throw new Error(`target.setup_actions[${index}].return_summary_fields[${fieldIndex}] requires path.`);
+    const label = stringFromOwn(field, "label", "name", "title");
+    return label ? { path, label } : { path };
+  });
+}
 function normalizeSetupActionRepeat(input, index) {
   const repeat = numberValue(valueFromOwn(input, "repeat", "repeat_count", "repeatCount", "times"));
   if (repeat === void 0) return void 0;
@@ -904,6 +971,7 @@ function normalizeSetupAction(input, index) {
     expect_return: hasExpectedReturn ? toJsonValue(valueFromOwn(input, "expect_return", "expectReturn", "expected_return", "expectedReturn")) : void 0,
     store_return_to: storeReturnTo,
     capture_return: captureReturn,
+    return_summary_fields: normalizeReturnSummaryFields(input, index),
     until_path: untilPath,
     until_expected_value: hasUntilExpectedValue ? toJsonValue(valueFromOwn(input, "until_expected_value", "untilExpectedValue", "until_expected", "untilExpected", "until_value", "untilValue", "expected_value", "expectedValue", "expected")) : void 0,
     max_calls: maxCalls,
@@ -3942,6 +4010,8 @@ function profileSetupWindowCallReceipts(results) {
       };
       if (result.returned !== undefined) receipt.returned = result.returned;
       if (result.expected_return !== undefined) receipt.expected_return = result.expected_return;
+      const returnSummary = profileSetupReturnSummary(result);
+      if (returnSummary.length) receipt.return_summary = returnSummary;
       return receipt;
     });
 }
@@ -3959,9 +4029,43 @@ function profileSetupWindowEvalReceipts(results) {
       };
       if (result.returned !== undefined) receipt.returned = result.returned;
       if (result.expected_return !== undefined) receipt.expected_return = result.expected_return;
+      const returnSummary = profileSetupReturnSummary(result);
+      if (returnSummary.length) receipt.return_summary = returnSummary;
       return receipt;
     });
 }
+function profileSetupReturnSummaryFields(result) {
+  const input = result && result.return_summary_fields;
+  if (!Array.isArray(input)) return [];
+  const fields = [];
+  for (const item of input) {
+    if (typeof item === "string") {
+      const path = item.trim();
+      if (path) fields.push({ path });
+      continue;
+    }
+    if (!item || typeof item !== "object" || Array.isArray(item)) continue;
+    const path = String(item.path || item.key || item.json_path || item.jsonPath || "").trim();
+    if (!path) continue;
+    const label = String(item.label || item.name || item.title || "").trim();
+    fields.push(label ? { path, label } : { path });
+  }
+  return fields;
+}
+function profileSetupReturnSummary(result) {
+  if (!result || result.returned === undefined) return [];
+  return profileSetupReturnSummaryFields(result).map((field) => {
+    const resolved = resolveJsonProbePath(result.returned, field.path);
+    const receipt = {
+      label: field.label || field.path,
+      path: field.path,
+      exists: Boolean(resolved.exists),
+    };
+    if (resolved.exists) receipt.value = setupJsonValue(resolved.value);
+    if (resolved.error) receipt.reason = resolved.error;
+    return receipt;
+  });
+}
 function profileSetupRangeValueReceipts(results) {
   return (results || [])
     .filter((result) => result && profileSetupResultAction(result) === "set_range_value")
@@ -5696,6 +5800,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       const script = String(action.script || action.code || action.source || action.body || "");
       const args = Array.isArray(action.args) ? action.args : [];
       const storeReturnTo = String(action.store_return_to || action.storeReturnTo || action.save_return_to || action.saveReturnTo || action.assign_return_to || action.assignReturnTo || action.return_state_path || action.returnStatePath || "").trim();
+      const returnSummaryFields = Array.isArray(action.return_summary_fields) ? action.return_summary_fields : [];
       if (!script.trim()) return { ...base, reason: "missing_script" };
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
@@ -5725,6 +5830,7 @@ async function executeSetupAction(action, ordinal, viewport) {
         return_captured: captureReturn,
         expected_return: hasExpectation ? setupJsonValue(expected) : undefined,
         return_stored_to: result.return_stored_to || storeReturnTo || undefined,
+        return_summary_fields: returnSummaryFields.length ? setupJsonValue(returnSummaryFields) : undefined,
         reason: result.ok ? (expectationMet ? undefined : "unexpected_return_value") : result.reason,
         store_reason: result.store_reason || undefined,
         error: result.error || undefined,
@@ -5734,6 +5840,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       const path = String(action.path || action.function_path || action.functionPath || "");
       const args = Array.isArray(action.args) ? action.args : [];
       const storeReturnTo = String(action.store_return_to || action.storeReturnTo || action.save_return_to || action.saveReturnTo || action.assign_return_to || action.assignReturnTo || action.return_state_path || action.returnStatePath || "").trim();
+      const returnSummaryFields = Array.isArray(action.return_summary_fields) ? action.return_summary_fields : [];
       if (!path) return { ...base, path, reason: "missing_path" };
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
@@ -5763,6 +5870,7 @@ async function executeSetupAction(action, ordinal, viewport) {
         return_captured: captureReturn,
         expected_return: hasExpectation ? setupJsonValue(expected) : undefined,
         return_stored_to: result.return_stored_to || storeReturnTo || undefined,
+        return_summary_fields: returnSummaryFields.length ? setupJsonValue(returnSummaryFields) : undefined,
         reason: result.ok ? (expectationMet ? undefined : "unexpected_return_value") : result.reason,
         store_reason: result.store_reason || undefined,
         error: result.error || undefined,

package/dist/cli.cjs

@@ -7437,6 +7437,8 @@ function profileSetupWindowCallReceipts(results) {
     };
     if (result.returned !== void 0) receipt.returned = result.returned;
     if (result.expected_return !== void 0) receipt.expected_return = result.expected_return;
+    const returnSummary = profileSetupReturnSummary(result);
+    if (returnSummary.length) receipt.return_summary = returnSummary;
     return receipt;
   });
 }
@@ -7452,6 +7454,40 @@ function profileSetupWindowEvalReceipts(results) {
     };
     if (result.returned !== void 0) receipt.returned = result.returned;
     if (result.expected_return !== void 0) receipt.expected_return = result.expected_return;
+    const returnSummary = profileSetupReturnSummary(result);
+    if (returnSummary.length) receipt.return_summary = returnSummary;
+    return receipt;
+  });
+}
+function profileSetupReturnSummaryFields(result) {
+  const input = result.return_summary_fields;
+  if (!Array.isArray(input)) return [];
+  const fields = [];
+  for (const item of input) {
+    if (typeof item === "string") {
+      const path8 = item.trim();
+      if (path8) fields.push({ path: path8 });
+      continue;
+    }
+    if (!isRecord(item)) continue;
+    const path7 = stringValue2(item.path) ?? stringValue2(item.key) ?? stringValue2(item.json_path) ?? stringValue2(item.jsonPath);
+    if (!path7) continue;
+    const label = stringValue2(item.label) ?? stringValue2(item.name) ?? stringValue2(item.title);
+    fields.push(label ? { path: path7, label } : { path: path7 });
+  }
+  return fields;
+}
+function profileSetupReturnSummary(result) {
+  if (result.returned === void 0) return [];
+  return profileSetupReturnSummaryFields(result).map((field) => {
+    const resolved = resolveJsonPath(result.returned, field.path);
+    const receipt = {
+      label: field.label || field.path,
+      path: field.path,
+      exists: resolved.exists
+    };
+    if (resolved.exists) receipt.value = toJsonValue(resolved.value);
+    if (resolved.error) receipt.reason = resolved.error;
     return receipt;
   });
 }
@@ -7640,6 +7676,37 @@ function normalizeSetupActionArgs(input, index) {
   }
   return argsInput.map(toJsonValue);
 }
+function normalizeReturnSummaryFields(input, index) {
+  const fieldsInput = valueFromOwn(
+    input,
+    "return_summary_fields",
+    "returnSummaryFields",
+    "summary_fields",
+    "summaryFields",
+    "receipt_fields",
+    "receiptFields",
+    "return_receipt_fields",
+    "returnReceiptFields"
+  );
+  if (fieldsInput === void 0) return void 0;
+  if (!Array.isArray(fieldsInput)) {
+    throw new Error(`target.setup_actions[${index}].return_summary_fields must be an array.`);
+  }
+  return fieldsInput.map((field, fieldIndex) => {
+    if (typeof field === "string") {
+      const path8 = field.trim();
+      if (!path8) throw new Error(`target.setup_actions[${index}].return_summary_fields[${fieldIndex}] requires path.`);
+      return { path: path8 };
+    }
+    if (!isRecord(field)) {
+      throw new Error(`target.setup_actions[${index}].return_summary_fields[${fieldIndex}] must be a string path or object.`);
+    }
+    const path7 = stringFromOwn(field, "path", "key", "json_path", "jsonPath");
+    if (!path7) throw new Error(`target.setup_actions[${index}].return_summary_fields[${fieldIndex}] requires path.`);
+    const label = stringFromOwn(field, "label", "name", "title");
+    return label ? { path: path7, label } : { path: path7 };
+  });
+}
 function normalizeSetupActionRepeat(input, index) {
   const repeat = numberValue(valueFromOwn(input, "repeat", "repeat_count", "repeatCount", "times"));
   if (repeat === void 0) return void 0;
@@ -7861,6 +7928,7 @@ function normalizeSetupAction(input, index) {
     expect_return: hasExpectedReturn ? toJsonValue(valueFromOwn(input, "expect_return", "expectReturn", "expected_return", "expectedReturn")) : void 0,
     store_return_to: storeReturnTo,
     capture_return: captureReturn,
+    return_summary_fields: normalizeReturnSummaryFields(input, index),
     until_path: untilPath,
     until_expected_value: hasUntilExpectedValue ? toJsonValue(valueFromOwn(input, "until_expected_value", "untilExpectedValue", "until_expected", "untilExpected", "until_value", "untilValue", "expected_value", "expectedValue", "expected")) : void 0,
     max_calls: maxCalls,
@@ -10883,6 +10951,8 @@ function profileSetupWindowCallReceipts(results) {
       };
       if (result.returned !== undefined) receipt.returned = result.returned;
       if (result.expected_return !== undefined) receipt.expected_return = result.expected_return;
+      const returnSummary = profileSetupReturnSummary(result);
+      if (returnSummary.length) receipt.return_summary = returnSummary;
       return receipt;
     });
 }
@@ -10900,9 +10970,43 @@ function profileSetupWindowEvalReceipts(results) {
       };
       if (result.returned !== undefined) receipt.returned = result.returned;
       if (result.expected_return !== undefined) receipt.expected_return = result.expected_return;
+      const returnSummary = profileSetupReturnSummary(result);
+      if (returnSummary.length) receipt.return_summary = returnSummary;
       return receipt;
     });
 }
+function profileSetupReturnSummaryFields(result) {
+  const input = result && result.return_summary_fields;
+  if (!Array.isArray(input)) return [];
+  const fields = [];
+  for (const item of input) {
+    if (typeof item === "string") {
+      const path = item.trim();
+      if (path) fields.push({ path });
+      continue;
+    }
+    if (!item || typeof item !== "object" || Array.isArray(item)) continue;
+    const path = String(item.path || item.key || item.json_path || item.jsonPath || "").trim();
+    if (!path) continue;
+    const label = String(item.label || item.name || item.title || "").trim();
+    fields.push(label ? { path, label } : { path });
+  }
+  return fields;
+}
+function profileSetupReturnSummary(result) {
+  if (!result || result.returned === undefined) return [];
+  return profileSetupReturnSummaryFields(result).map((field) => {
+    const resolved = resolveJsonProbePath(result.returned, field.path);
+    const receipt = {
+      label: field.label || field.path,
+      path: field.path,
+      exists: Boolean(resolved.exists),
+    };
+    if (resolved.exists) receipt.value = setupJsonValue(resolved.value);
+    if (resolved.error) receipt.reason = resolved.error;
+    return receipt;
+  });
+}
 function profileSetupRangeValueReceipts(results) {
   return (results || [])
     .filter((result) => result && profileSetupResultAction(result) === "set_range_value")
@@ -12637,6 +12741,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       const script = String(action.script || action.code || action.source || action.body || "");
       const args = Array.isArray(action.args) ? action.args : [];
       const storeReturnTo = String(action.store_return_to || action.storeReturnTo || action.save_return_to || action.saveReturnTo || action.assign_return_to || action.assignReturnTo || action.return_state_path || action.returnStatePath || "").trim();
+      const returnSummaryFields = Array.isArray(action.return_summary_fields) ? action.return_summary_fields : [];
       if (!script.trim()) return { ...base, reason: "missing_script" };
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
@@ -12666,6 +12771,7 @@ async function executeSetupAction(action, ordinal, viewport) {
         return_captured: captureReturn,
         expected_return: hasExpectation ? setupJsonValue(expected) : undefined,
         return_stored_to: result.return_stored_to || storeReturnTo || undefined,
+        return_summary_fields: returnSummaryFields.length ? setupJsonValue(returnSummaryFields) : undefined,
         reason: result.ok ? (expectationMet ? undefined : "unexpected_return_value") : result.reason,
         store_reason: result.store_reason || undefined,
         error: result.error || undefined,
@@ -12675,6 +12781,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       const path = String(action.path || action.function_path || action.functionPath || "");
       const args = Array.isArray(action.args) ? action.args : [];
       const storeReturnTo = String(action.store_return_to || action.storeReturnTo || action.save_return_to || action.saveReturnTo || action.assign_return_to || action.assignReturnTo || action.return_state_path || action.returnStatePath || "").trim();
+      const returnSummaryFields = Array.isArray(action.return_summary_fields) ? action.return_summary_fields : [];
       if (!path) return { ...base, path, reason: "missing_path" };
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
@@ -12704,6 +12811,7 @@ async function executeSetupAction(action, ordinal, viewport) {
         return_captured: captureReturn,
         expected_return: hasExpectation ? setupJsonValue(expected) : undefined,
         return_stored_to: result.return_stored_to || storeReturnTo || undefined,
+        return_summary_fields: returnSummaryFields.length ? setupJsonValue(returnSummaryFields) : undefined,
         reason: result.ok ? (expectationMet ? undefined : "unexpected_return_value") : result.reason,
         store_reason: result.store_reason || undefined,
         error: result.error || undefined,
@@ -15276,6 +15384,42 @@ function cliValueLabel(value) {
     return String(value);
   }
 }
+function cliReturnSummaryLabel(value) {
+  if (!Array.isArray(value)) return void 0;
+  const parts = value.map(cliRecord).filter((item) => Boolean(item)).map((item) => {
+    const label = cliString(item.label) || cliString(item.path) || "value";
+    const observed = item.exists === false ? "missing" : cliValueLabel(item.value);
+    return `${label}=${observed ?? "null"}`;
+  }).filter(Boolean);
+  return parts.length ? parts.join(", ") : void 0;
+}
+function balancedSetupReceiptDetails(groups, limit) {
+  if (limit <= 0) return [];
+  const total = groups.reduce((sum, group) => sum + group.length, 0);
+  if (total <= limit) return groups.flat();
+  const selected = [];
+  const indexes = new Array(groups.length).fill(0);
+  const nonEmptyIndexes = groups.map((group, index) => group.length ? index : -1).filter((index) => index >= 0);
+  for (const index of nonEmptyIndexes) {
+    if (selected.length >= limit) return selected;
+    selected.push(groups[index][0]);
+    indexes[index] = 1;
+  }
+  while (selected.length < limit) {
+    let progressed = false;
+    for (const index of nonEmptyIndexes) {
+      const nextIndex = indexes[index];
+      const next = groups[index][nextIndex];
+      if (!next) continue;
+      selected.push(next);
+      indexes[index] = nextIndex + 1;
+      progressed = true;
+      if (selected.length >= limit) break;
+    }
+    if (!progressed) break;
+  }
+  return selected;
+}
 function cliStringArray(value) {
   return Array.isArray(value) ? value.filter((entry) => typeof entry === "string" && Boolean(entry.trim())) : [];
 }
@@ -15421,12 +15565,14 @@ function profileSetupSummaryMarkdown(result) {
     const observedPath = cliString(viewport.observed_path);
     lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${rangeValueActions ? `, ${rangeValueActions} set_range_value action(s)` : ""}${windowCallActions ? `, ${windowCallActions} window_call action(s), ${windowCallStored} stored return(s), ${windowCallCaptured} captured return(s)` : ""}${windowEvalActions ? `, ${windowEvalActions} window_eval action(s), ${windowEvalStored} stored return(s), ${windowEvalCaptured} captured return(s)` : ""}${windowCallUntilActions ? `, ${windowCallUntilActions} window_call_until action(s), ${windowCallUntilCalls} call(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
   }
-  const rangeValueDetails = viewports.flatMap((viewport) => {
+  const rangeValueGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
     const receipts = Array.isArray(viewport.set_range_value) ? viewport.set_range_value.map(cliRecord).filter((item) => Boolean(item)) : [];
     return receipts.map((receipt) => ({ name, receipt }));
   });
-  for (const { name, receipt } of rangeValueDetails.slice(0, 12)) {
+  const rangeValueDetails = rangeValueGroups.flat();
+  const sampledRangeValueDetails = balancedSetupReceiptDetails(rangeValueGroups, 12);
+  for (const { name, receipt } of sampledRangeValueDetails) {
     const selector = cliString(receipt.selector) || "input[type=range]";
     const requested = cliValueLabel(receipt.requested_value);
     const actual = cliValueLabel(receipt.actual_value);
@@ -15439,45 +15585,53 @@ function profileSetupSummaryMarkdown(result) {
     const reason = cliString(receipt.reason);
     lines.push(`- ${name} set_range_value: ${ok}, ${markdownInlineCode(selector)}${requested === void 0 ? "" : ` requested ${markdownInlineCode(requested, 80)}`}${actual === void 0 ? "" : ` -> ${markdownInlineCode(actual, 80)}`}${before === void 0 ? "" : `, before ${markdownInlineCode(before, 80)}`}${valueAsNumber === void 0 ? "" : `, number ${valueAsNumber}`}${min === void 0 && max === void 0 ? "" : `, range ${min === void 0 ? "?" : markdownInlineCode(min, 40)}..${max === void 0 ? "?" : markdownInlineCode(max, 40)}`}${step === void 0 ? "" : ` step ${markdownInlineCode(step, 40)}`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
   }
-  if (rangeValueDetails.length > 12) lines.push(`- ${rangeValueDetails.length - 12} additional set_range_value receipt(s) omitted.`);
-  const windowCallDetails = viewports.flatMap((viewport) => {
+  if (rangeValueDetails.length > sampledRangeValueDetails.length) lines.push(`- ${rangeValueDetails.length - sampledRangeValueDetails.length} additional set_range_value receipt(s) omitted.`);
+  const windowCallGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
     const receipts = Array.isArray(viewport.window_call) ? viewport.window_call.map(cliRecord).filter((item) => Boolean(item)) : [];
     return receipts.map((receipt) => ({ name, receipt }));
   });
-  for (const { name, receipt } of windowCallDetails.slice(0, 12)) {
+  const windowCallDetails = windowCallGroups.flat();
+  const sampledWindowCallDetails = balancedSetupReceiptDetails(windowCallGroups, 12);
+  for (const { name, receipt } of sampledWindowCallDetails) {
     const path7 = cliString(receipt.path) || "window_function";
     const storedTo = cliString(receipt.return_stored_to);
     const returned = cliValueLabel(receipt.returned);
     const expected = cliValueLabel(receipt.expected_return);
+    const returnSummary = cliReturnSummaryLabel(receipt.return_summary);
     const captured = receipt.return_captured === true ? "captured" : receipt.return_captured === false ? "not captured" : "capture unknown";
     const ok = receipt.ok === false ? "failed" : "ok";
     const reason = cliString(receipt.reason);
-    lines.push(`- ${name} window_call: ${ok}, ${markdownInlineCode(path7)}${storedTo ? `, stored ${markdownInlineCode(storedTo)}` : ""}, return ${captured}${expected === void 0 ? "" : `, expected ${markdownInlineCode(expected, 80)}`}${returned === void 0 ? "" : `, returned ${markdownInlineCode(returned, 80)}`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
+    lines.push(`- ${name} window_call: ${ok}, ${markdownInlineCode(path7)}${storedTo ? `, stored ${markdownInlineCode(storedTo)}` : ""}, return ${captured}${expected === void 0 ? "" : `, expected ${markdownInlineCode(expected, 80)}`}${returnSummary ? `, summary ${markdownInlineCode(returnSummary, 140)}` : ""}${returned === void 0 ? "" : `, returned ${markdownInlineCode(returned, 80)}`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
   }
-  if (windowCallDetails.length > 12) lines.push(`- ${windowCallDetails.length - 12} additional window_call receipt(s) omitted.`);
-  const windowEvalDetails = viewports.flatMap((viewport) => {
+  if (windowCallDetails.length > sampledWindowCallDetails.length) lines.push(`- ${windowCallDetails.length - sampledWindowCallDetails.length} additional window_call receipt(s) omitted.`);
+  const windowEvalGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
     const receipts = Array.isArray(viewport.window_eval) ? viewport.window_eval.map(cliRecord).filter((item) => Boolean(item)) : [];
     return receipts.map((receipt) => ({ name, receipt }));
   });
-  for (const { name, receipt } of windowEvalDetails.slice(0, 12)) {
+  const windowEvalDetails = windowEvalGroups.flat();
+  const sampledWindowEvalDetails = balancedSetupReceiptDetails(windowEvalGroups, 12);
+  for (const { name, receipt } of sampledWindowEvalDetails) {
     const scriptLength = cliFiniteNumber(receipt.script_length);
     const storedTo = cliString(receipt.return_stored_to);
     const returned = cliValueLabel(receipt.returned);
     const expected = cliValueLabel(receipt.expected_return);
+    const returnSummary = cliReturnSummaryLabel(receipt.return_summary);
     const captured = receipt.return_captured === true ? "captured" : receipt.return_captured === false ? "not captured" : "capture unknown";
     const ok = receipt.ok === false ? "failed" : "ok";
     const reason = cliString(receipt.reason);
-    lines.push(`- ${name} window_eval: ${ok}${scriptLength === void 0 ? "" : `, script ${scriptLength} chars`}${storedTo ? `, stored ${markdownInlineCode(storedTo)}` : ""}, return ${captured}${expected === void 0 ? "" : `, expected ${markdownInlineCode(expected, 80)}`}${returned === void 0 ? "" : `, returned ${markdownInlineCode(returned, 80)}`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
+    lines.push(`- ${name} window_eval: ${ok}${scriptLength === void 0 ? "" : `, script ${scriptLength} chars`}${storedTo ? `, stored ${markdownInlineCode(storedTo)}` : ""}, return ${captured}${expected === void 0 ? "" : `, expected ${markdownInlineCode(expected, 80)}`}${returnSummary ? `, summary ${markdownInlineCode(returnSummary, 140)}` : ""}${returned === void 0 ? "" : `, returned ${markdownInlineCode(returned, 80)}`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
   }
-  if (windowEvalDetails.length > 12) lines.push(`- ${windowEvalDetails.length - 12} additional window_eval receipt(s) omitted.`);
-  const windowCallUntilDetails = viewports.flatMap((viewport) => {
+  if (windowEvalDetails.length > sampledWindowEvalDetails.length) lines.push(`- ${windowEvalDetails.length - sampledWindowEvalDetails.length} additional window_eval receipt(s) omitted.`);
+  const windowCallUntilGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
     const receipts = Array.isArray(viewport.window_call_until) ? viewport.window_call_until.map(cliRecord).filter((item) => Boolean(item)) : [];
     return receipts.map((receipt) => ({ name, receipt }));
   });
-  for (const { name, receipt } of windowCallUntilDetails.slice(0, 12)) {
+  const windowCallUntilDetails = windowCallUntilGroups.flat();
+  const sampledWindowCallUntilDetails = balancedSetupReceiptDetails(windowCallUntilGroups, 12);
+  for (const { name, receipt } of sampledWindowCallUntilDetails) {
     const path7 = cliString(receipt.path) || "window_function";
     const untilPath = cliString(receipt.until_path) || "until_path";
     const expected = cliValueLabel(receipt.until_expected_value);
@@ -15489,7 +15643,7 @@ function profileSetupSummaryMarkdown(result) {
     const callText = callCount === void 0 ? "" : ` in ${callCount}${maxCalls === void 0 ? "" : `/${maxCalls}`} call(s)`;
     lines.push(`- ${name} window_call_until: ${ok}, ${markdownInlineCode(path7)} until ${markdownInlineCode(untilPath)}${expected === void 0 ? "" : ` == ${markdownInlineCode(expected, 80)}`}${callText}${actual === void 0 ? "" : `, observed ${markdownInlineCode(actual, 80)}`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
   }
-  if (windowCallUntilDetails.length > 12) lines.push(`- ${windowCallUntilDetails.length - 12} additional window_call_until receipt(s) omitted.`);
+  if (windowCallUntilDetails.length > sampledWindowCallUntilDetails.length) lines.push(`- ${windowCallUntilDetails.length - sampledWindowCallUntilDetails.length} additional window_call_until receipt(s) omitted.`);
   const failedDetails = viewports.flatMap((viewport) => {
     const name = cliString(viewport.name) || "viewport";
     const failed = Array.isArray(viewport.failed) ? viewport.failed.map(cliRecord).filter((item) => Boolean(item)) : [];

package/dist/cli.js

@@ -13,7 +13,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-QJJ3ISMK.js";
+} from "./chunk-YB3LNLZB.js";
 import {
   createRiddleApiClient,
   isTerminalRiddleJobStatus,
@@ -635,6 +635,42 @@ function cliValueLabel(value) {
     return String(value);
   }
 }
+function cliReturnSummaryLabel(value) {
+  if (!Array.isArray(value)) return void 0;
+  const parts = value.map(cliRecord).filter((item) => Boolean(item)).map((item) => {
+    const label = cliString(item.label) || cliString(item.path) || "value";
+    const observed = item.exists === false ? "missing" : cliValueLabel(item.value);
+    return `${label}=${observed ?? "null"}`;
+  }).filter(Boolean);
+  return parts.length ? parts.join(", ") : void 0;
+}
+function balancedSetupReceiptDetails(groups, limit) {
+  if (limit <= 0) return [];
+  const total = groups.reduce((sum, group) => sum + group.length, 0);
+  if (total <= limit) return groups.flat();
+  const selected = [];
+  const indexes = new Array(groups.length).fill(0);
+  const nonEmptyIndexes = groups.map((group, index) => group.length ? index : -1).filter((index) => index >= 0);
+  for (const index of nonEmptyIndexes) {
+    if (selected.length >= limit) return selected;
+    selected.push(groups[index][0]);
+    indexes[index] = 1;
+  }
+  while (selected.length < limit) {
+    let progressed = false;
+    for (const index of nonEmptyIndexes) {
+      const nextIndex = indexes[index];
+      const next = groups[index][nextIndex];
+      if (!next) continue;
+      selected.push(next);
+      indexes[index] = nextIndex + 1;
+      progressed = true;
+      if (selected.length >= limit) break;
+    }
+    if (!progressed) break;
+  }
+  return selected;
+}
 function cliStringArray(value) {
   return Array.isArray(value) ? value.filter((entry) => typeof entry === "string" && Boolean(entry.trim())) : [];
 }
@@ -780,12 +816,14 @@ function profileSetupSummaryMarkdown(result) {
     const observedPath = cliString(viewport.observed_path);
     lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${rangeValueActions ? `, ${rangeValueActions} set_range_value action(s)` : ""}${windowCallActions ? `, ${windowCallActions} window_call action(s), ${windowCallStored} stored return(s), ${windowCallCaptured} captured return(s)` : ""}${windowEvalActions ? `, ${windowEvalActions} window_eval action(s), ${windowEvalStored} stored return(s), ${windowEvalCaptured} captured return(s)` : ""}${windowCallUntilActions ? `, ${windowCallUntilActions} window_call_until action(s), ${windowCallUntilCalls} call(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
   }
-  const rangeValueDetails = viewports.flatMap((viewport) => {
+  const rangeValueGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
     const receipts = Array.isArray(viewport.set_range_value) ? viewport.set_range_value.map(cliRecord).filter((item) => Boolean(item)) : [];
     return receipts.map((receipt) => ({ name, receipt }));
   });
-  for (const { name, receipt } of rangeValueDetails.slice(0, 12)) {
+  const rangeValueDetails = rangeValueGroups.flat();
+  const sampledRangeValueDetails = balancedSetupReceiptDetails(rangeValueGroups, 12);
+  for (const { name, receipt } of sampledRangeValueDetails) {
     const selector = cliString(receipt.selector) || "input[type=range]";
     const requested = cliValueLabel(receipt.requested_value);
     const actual = cliValueLabel(receipt.actual_value);
@@ -798,45 +836,53 @@ function profileSetupSummaryMarkdown(result) {
     const reason = cliString(receipt.reason);
     lines.push(`- ${name} set_range_value: ${ok}, ${markdownInlineCode(selector)}${requested === void 0 ? "" : ` requested ${markdownInlineCode(requested, 80)}`}${actual === void 0 ? "" : ` -> ${markdownInlineCode(actual, 80)}`}${before === void 0 ? "" : `, before ${markdownInlineCode(before, 80)}`}${valueAsNumber === void 0 ? "" : `, number ${valueAsNumber}`}${min === void 0 && max === void 0 ? "" : `, range ${min === void 0 ? "?" : markdownInlineCode(min, 40)}..${max === void 0 ? "?" : markdownInlineCode(max, 40)}`}${step === void 0 ? "" : ` step ${markdownInlineCode(step, 40)}`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
   }
-  if (rangeValueDetails.length > 12) lines.push(`- ${rangeValueDetails.length - 12} additional set_range_value receipt(s) omitted.`);
-  const windowCallDetails = viewports.flatMap((viewport) => {
+  if (rangeValueDetails.length > sampledRangeValueDetails.length) lines.push(`- ${rangeValueDetails.length - sampledRangeValueDetails.length} additional set_range_value receipt(s) omitted.`);
+  const windowCallGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
     const receipts = Array.isArray(viewport.window_call) ? viewport.window_call.map(cliRecord).filter((item) => Boolean(item)) : [];
     return receipts.map((receipt) => ({ name, receipt }));
   });
-  for (const { name, receipt } of windowCallDetails.slice(0, 12)) {
+  const windowCallDetails = windowCallGroups.flat();
+  const sampledWindowCallDetails = balancedSetupReceiptDetails(windowCallGroups, 12);
+  for (const { name, receipt } of sampledWindowCallDetails) {
     const path2 = cliString(receipt.path) || "window_function";
     const storedTo = cliString(receipt.return_stored_to);
     const returned = cliValueLabel(receipt.returned);
     const expected = cliValueLabel(receipt.expected_return);
+    const returnSummary = cliReturnSummaryLabel(receipt.return_summary);
     const captured = receipt.return_captured === true ? "captured" : receipt.return_captured === false ? "not captured" : "capture unknown";
     const ok = receipt.ok === false ? "failed" : "ok";
     const reason = cliString(receipt.reason);
-    lines.push(`- ${name} window_call: ${ok}, ${markdownInlineCode(path2)}${storedTo ? `, stored ${markdownInlineCode(storedTo)}` : ""}, return ${captured}${expected === void 0 ? "" : `, expected ${markdownInlineCode(expected, 80)}`}${returned === void 0 ? "" : `, returned ${markdownInlineCode(returned, 80)}`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
+    lines.push(`- ${name} window_call: ${ok}, ${markdownInlineCode(path2)}${storedTo ? `, stored ${markdownInlineCode(storedTo)}` : ""}, return ${captured}${expected === void 0 ? "" : `, expected ${markdownInlineCode(expected, 80)}`}${returnSummary ? `, summary ${markdownInlineCode(returnSummary, 140)}` : ""}${returned === void 0 ? "" : `, returned ${markdownInlineCode(returned, 80)}`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
   }
-  if (windowCallDetails.length > 12) lines.push(`- ${windowCallDetails.length - 12} additional window_call receipt(s) omitted.`);
-  const windowEvalDetails = viewports.flatMap((viewport) => {
+  if (windowCallDetails.length > sampledWindowCallDetails.length) lines.push(`- ${windowCallDetails.length - sampledWindowCallDetails.length} additional window_call receipt(s) omitted.`);
+  const windowEvalGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
     const receipts = Array.isArray(viewport.window_eval) ? viewport.window_eval.map(cliRecord).filter((item) => Boolean(item)) : [];
     return receipts.map((receipt) => ({ name, receipt }));
   });
-  for (const { name, receipt } of windowEvalDetails.slice(0, 12)) {
+  const windowEvalDetails = windowEvalGroups.flat();
+  const sampledWindowEvalDetails = balancedSetupReceiptDetails(windowEvalGroups, 12);
+  for (const { name, receipt } of sampledWindowEvalDetails) {
     const scriptLength = cliFiniteNumber(receipt.script_length);
     const storedTo = cliString(receipt.return_stored_to);
     const returned = cliValueLabel(receipt.returned);
     const expected = cliValueLabel(receipt.expected_return);
+    const returnSummary = cliReturnSummaryLabel(receipt.return_summary);
     const captured = receipt.return_captured === true ? "captured" : receipt.return_captured === false ? "not captured" : "capture unknown";
     const ok = receipt.ok === false ? "failed" : "ok";
     const reason = cliString(receipt.reason);
-    lines.push(`- ${name} window_eval: ${ok}${scriptLength === void 0 ? "" : `, script ${scriptLength} chars`}${storedTo ? `, stored ${markdownInlineCode(storedTo)}` : ""}, return ${captured}${expected === void 0 ? "" : `, expected ${markdownInlineCode(expected, 80)}`}${returned === void 0 ? "" : `, returned ${markdownInlineCode(returned, 80)}`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
+    lines.push(`- ${name} window_eval: ${ok}${scriptLength === void 0 ? "" : `, script ${scriptLength} chars`}${storedTo ? `, stored ${markdownInlineCode(storedTo)}` : ""}, return ${captured}${expected === void 0 ? "" : `, expected ${markdownInlineCode(expected, 80)}`}${returnSummary ? `, summary ${markdownInlineCode(returnSummary, 140)}` : ""}${returned === void 0 ? "" : `, returned ${markdownInlineCode(returned, 80)}`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
   }
-  if (windowEvalDetails.length > 12) lines.push(`- ${windowEvalDetails.length - 12} additional window_eval receipt(s) omitted.`);
-  const windowCallUntilDetails = viewports.flatMap((viewport) => {
+  if (windowEvalDetails.length > sampledWindowEvalDetails.length) lines.push(`- ${windowEvalDetails.length - sampledWindowEvalDetails.length} additional window_eval receipt(s) omitted.`);
+  const windowCallUntilGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
     const receipts = Array.isArray(viewport.window_call_until) ? viewport.window_call_until.map(cliRecord).filter((item) => Boolean(item)) : [];
     return receipts.map((receipt) => ({ name, receipt }));
   });
-  for (const { name, receipt } of windowCallUntilDetails.slice(0, 12)) {
+  const windowCallUntilDetails = windowCallUntilGroups.flat();
+  const sampledWindowCallUntilDetails = balancedSetupReceiptDetails(windowCallUntilGroups, 12);
+  for (const { name, receipt } of sampledWindowCallUntilDetails) {
     const path2 = cliString(receipt.path) || "window_function";
     const untilPath = cliString(receipt.until_path) || "until_path";
     const expected = cliValueLabel(receipt.until_expected_value);
@@ -848,7 +894,7 @@ function profileSetupSummaryMarkdown(result) {
     const callText = callCount === void 0 ? "" : ` in ${callCount}${maxCalls === void 0 ? "" : `/${maxCalls}`} call(s)`;
     lines.push(`- ${name} window_call_until: ${ok}, ${markdownInlineCode(path2)} until ${markdownInlineCode(untilPath)}${expected === void 0 ? "" : ` == ${markdownInlineCode(expected, 80)}`}${callText}${actual === void 0 ? "" : `, observed ${markdownInlineCode(actual, 80)}`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
   }
-  if (windowCallUntilDetails.length > 12) lines.push(`- ${windowCallUntilDetails.length - 12} additional window_call_until receipt(s) omitted.`);
+  if (windowCallUntilDetails.length > sampledWindowCallUntilDetails.length) lines.push(`- ${windowCallUntilDetails.length - sampledWindowCallUntilDetails.length} additional window_call_until receipt(s) omitted.`);
   const failedDetails = viewports.flatMap((viewport) => {
     const name = cliString(viewport.name) || "viewport";
     const failed = Array.isArray(viewport.failed) ? viewport.failed.map(cliRecord).filter((item) => Boolean(item)) : [];

package/dist/index.cjs

@@ -9213,6 +9213,8 @@ function profileSetupWindowCallReceipts(results) {
     };
     if (result.returned !== void 0) receipt.returned = result.returned;
     if (result.expected_return !== void 0) receipt.expected_return = result.expected_return;
+    const returnSummary = profileSetupReturnSummary(result);
+    if (returnSummary.length) receipt.return_summary = returnSummary;
     return receipt;
   });
 }
@@ -9228,6 +9230,40 @@ function profileSetupWindowEvalReceipts(results) {
     };
     if (result.returned !== void 0) receipt.returned = result.returned;
     if (result.expected_return !== void 0) receipt.expected_return = result.expected_return;
+    const returnSummary = profileSetupReturnSummary(result);
+    if (returnSummary.length) receipt.return_summary = returnSummary;
+    return receipt;
+  });
+}
+function profileSetupReturnSummaryFields(result) {
+  const input = result.return_summary_fields;
+  if (!Array.isArray(input)) return [];
+  const fields = [];
+  for (const item of input) {
+    if (typeof item === "string") {
+      const path7 = item.trim();
+      if (path7) fields.push({ path: path7 });
+      continue;
+    }
+    if (!isRecord2(item)) continue;
+    const path6 = stringValue5(item.path) ?? stringValue5(item.key) ?? stringValue5(item.json_path) ?? stringValue5(item.jsonPath);
+    if (!path6) continue;
+    const label = stringValue5(item.label) ?? stringValue5(item.name) ?? stringValue5(item.title);
+    fields.push(label ? { path: path6, label } : { path: path6 });
+  }
+  return fields;
+}
+function profileSetupReturnSummary(result) {
+  if (result.returned === void 0) return [];
+  return profileSetupReturnSummaryFields(result).map((field) => {
+    const resolved = resolveJsonPath(result.returned, field.path);
+    const receipt = {
+      label: field.label || field.path,
+      path: field.path,
+      exists: resolved.exists
+    };
+    if (resolved.exists) receipt.value = toJsonValue(resolved.value);
+    if (resolved.error) receipt.reason = resolved.error;
     return receipt;
   });
 }
@@ -9416,6 +9452,37 @@ function normalizeSetupActionArgs(input, index) {
   }
   return argsInput.map(toJsonValue);
 }
+function normalizeReturnSummaryFields(input, index) {
+  const fieldsInput = valueFromOwn(
+    input,
+    "return_summary_fields",
+    "returnSummaryFields",
+    "summary_fields",
+    "summaryFields",
+    "receipt_fields",
+    "receiptFields",
+    "return_receipt_fields",
+    "returnReceiptFields"
+  );
+  if (fieldsInput === void 0) return void 0;
+  if (!Array.isArray(fieldsInput)) {
+    throw new Error(`target.setup_actions[${index}].return_summary_fields must be an array.`);
+  }
+  return fieldsInput.map((field, fieldIndex) => {
+    if (typeof field === "string") {
+      const path7 = field.trim();
+      if (!path7) throw new Error(`target.setup_actions[${index}].return_summary_fields[${fieldIndex}] requires path.`);
+      return { path: path7 };
+    }
+    if (!isRecord2(field)) {
+      throw new Error(`target.setup_actions[${index}].return_summary_fields[${fieldIndex}] must be a string path or object.`);
+    }
+    const path6 = stringFromOwn(field, "path", "key", "json_path", "jsonPath");
+    if (!path6) throw new Error(`target.setup_actions[${index}].return_summary_fields[${fieldIndex}] requires path.`);
+    const label = stringFromOwn(field, "label", "name", "title");
+    return label ? { path: path6, label } : { path: path6 };
+  });
+}
 function normalizeSetupActionRepeat(input, index) {
   const repeat = numberValue3(valueFromOwn(input, "repeat", "repeat_count", "repeatCount", "times"));
   if (repeat === void 0) return void 0;
@@ -9637,6 +9704,7 @@ function normalizeSetupAction(input, index) {
     expect_return: hasExpectedReturn ? toJsonValue(valueFromOwn(input, "expect_return", "expectReturn", "expected_return", "expectedReturn")) : void 0,
     store_return_to: storeReturnTo,
     capture_return: captureReturn,
+    return_summary_fields: normalizeReturnSummaryFields(input, index),
     until_path: untilPath,
     until_expected_value: hasUntilExpectedValue ? toJsonValue(valueFromOwn(input, "until_expected_value", "untilExpectedValue", "until_expected", "untilExpected", "until_value", "untilValue", "expected_value", "expectedValue", "expected")) : void 0,
     max_calls: maxCalls,
@@ -12675,6 +12743,8 @@ function profileSetupWindowCallReceipts(results) {
       };
       if (result.returned !== undefined) receipt.returned = result.returned;
       if (result.expected_return !== undefined) receipt.expected_return = result.expected_return;
+      const returnSummary = profileSetupReturnSummary(result);
+      if (returnSummary.length) receipt.return_summary = returnSummary;
       return receipt;
     });
 }
@@ -12692,9 +12762,43 @@ function profileSetupWindowEvalReceipts(results) {
       };
       if (result.returned !== undefined) receipt.returned = result.returned;
       if (result.expected_return !== undefined) receipt.expected_return = result.expected_return;
+      const returnSummary = profileSetupReturnSummary(result);
+      if (returnSummary.length) receipt.return_summary = returnSummary;
       return receipt;
     });
 }
+function profileSetupReturnSummaryFields(result) {
+  const input = result && result.return_summary_fields;
+  if (!Array.isArray(input)) return [];
+  const fields = [];
+  for (const item of input) {
+    if (typeof item === "string") {
+      const path = item.trim();
+      if (path) fields.push({ path });
+      continue;
+    }
+    if (!item || typeof item !== "object" || Array.isArray(item)) continue;
+    const path = String(item.path || item.key || item.json_path || item.jsonPath || "").trim();
+    if (!path) continue;
+    const label = String(item.label || item.name || item.title || "").trim();
+    fields.push(label ? { path, label } : { path });
+  }
+  return fields;
+}
+function profileSetupReturnSummary(result) {
+  if (!result || result.returned === undefined) return [];
+  return profileSetupReturnSummaryFields(result).map((field) => {
+    const resolved = resolveJsonProbePath(result.returned, field.path);
+    const receipt = {
+      label: field.label || field.path,
+      path: field.path,
+      exists: Boolean(resolved.exists),
+    };
+    if (resolved.exists) receipt.value = setupJsonValue(resolved.value);
+    if (resolved.error) receipt.reason = resolved.error;
+    return receipt;
+  });
+}
 function profileSetupRangeValueReceipts(results) {
   return (results || [])
     .filter((result) => result && profileSetupResultAction(result) === "set_range_value")
@@ -14429,6 +14533,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       const script = String(action.script || action.code || action.source || action.body || "");
       const args = Array.isArray(action.args) ? action.args : [];
       const storeReturnTo = String(action.store_return_to || action.storeReturnTo || action.save_return_to || action.saveReturnTo || action.assign_return_to || action.assignReturnTo || action.return_state_path || action.returnStatePath || "").trim();
+      const returnSummaryFields = Array.isArray(action.return_summary_fields) ? action.return_summary_fields : [];
       if (!script.trim()) return { ...base, reason: "missing_script" };
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
@@ -14458,6 +14563,7 @@ async function executeSetupAction(action, ordinal, viewport) {
         return_captured: captureReturn,
         expected_return: hasExpectation ? setupJsonValue(expected) : undefined,
         return_stored_to: result.return_stored_to || storeReturnTo || undefined,
+        return_summary_fields: returnSummaryFields.length ? setupJsonValue(returnSummaryFields) : undefined,
         reason: result.ok ? (expectationMet ? undefined : "unexpected_return_value") : result.reason,
         store_reason: result.store_reason || undefined,
         error: result.error || undefined,
@@ -14467,6 +14573,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       const path = String(action.path || action.function_path || action.functionPath || "");
       const args = Array.isArray(action.args) ? action.args : [];
       const storeReturnTo = String(action.store_return_to || action.storeReturnTo || action.save_return_to || action.saveReturnTo || action.assign_return_to || action.assignReturnTo || action.return_state_path || action.returnStatePath || "").trim();
+      const returnSummaryFields = Array.isArray(action.return_summary_fields) ? action.return_summary_fields : [];
       if (!path) return { ...base, path, reason: "missing_path" };
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
@@ -14496,6 +14603,7 @@ async function executeSetupAction(action, ordinal, viewport) {
         return_captured: captureReturn,
         expected_return: hasExpectation ? setupJsonValue(expected) : undefined,
         return_stored_to: result.return_stored_to || storeReturnTo || undefined,
+        return_summary_fields: returnSummaryFields.length ? setupJsonValue(returnSummaryFields) : undefined,
         reason: result.ok ? (expectationMet ? undefined : "unexpected_return_value") : result.reason,
         store_reason: result.store_reason || undefined,
         error: result.error || undefined,

package/dist/index.d.cts

@@ -10,5 +10,5 @@ export { CreateCaptureDiagnosticInput, DEFAULT_DIAGNOSTIC_ARRAY_LIMIT, DEFAULT_D
 export { BuildVisualProofSessionInput, RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION, RIDDLE_PROOF_VISUAL_SESSION_VERSION, VisualProofSessionMismatch, buildVisualProofSession, compareVisualProofSessionFingerprint, parseVisualProofSession, visualSessionFingerprint, visualSessionFingerprintBasis } from './proof-session.cjs';
 export { AssessPlayabilityOptions, RIDDLE_PROOF_PLAYABILITY_ASSESSMENT_VERSION, RIDDLE_PROOF_PLAYABILITY_VERSION, RiddleProofPlayabilityAssessment, RiddleProofPlayabilityEvidence, assessPlayabilityEvidence, extractPlayabilityEvidence, isRiddleProofPlayabilityMode } from './playability.cjs';
 export { AssessBasicGameplayOptions, AttachBasicGameplayArtifactOptions, BASIC_GAMEPLAY_ACTION_TYPES, BASIC_GAMEPLAY_PROGRESS_CHECK_TYPES, BasicGameplayActionResult, BasicGameplayActionType, BasicGameplayArtifactResolution, BasicGameplayAssessmentSummary, BasicGameplayBoundsOffender, BasicGameplayCanvasState, BasicGameplayCatchRecord, BasicGameplayChangeSummary, BasicGameplayFailureCode, BasicGameplayFixReference, BasicGameplayMetric, BasicGameplayMobileEvidence, BasicGameplayProgressCheckType, BasicGameplayProgressionCheck, BasicGameplayProofArtifact, BasicGameplayResponsiveViewportEvidence, BasicGameplayRouteReference, BasicGameplaySnapshot, BasicGameplaySuiteFailure, BasicGameplayWarningCode, CreateBasicGameplayCatchSummaryInput, RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_CATCH_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION, RiddleProofBasicGameplayAssessment, RiddleProofBasicGameplayCatchSummary, RiddleProofBasicGameplayEvidence, RiddleProofBasicGameplayRouteAssessment, RiddleProofBasicGameplayRouteEvidence, assessBasicGameplayEvidence, assessBasicGameplayProgressionCheck, assessBasicGameplayProgressionChecks, assessBasicGameplayRoute, attachBasicGameplayArtifactScreenshotHashes, augmentBasicGameplayAssessmentWithProgressionChecks, compactBasicGameplayText, createBasicGameplayCatchRecords, createBasicGameplayCatchSummary, extractBasicGameplayEvidence, resolveBasicGameplayProgressionCheckWithArtifactScreenshots, sanitizeBasicGameplayJsonString } from './basic-gameplay.cjs';
-export { NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_NETWORK_ABORT_ERROR_CODES, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, RiddleProofArtifactBodyAssertionInput, RiddleProofArtifactBodyAssertionResult, RiddleProofProfile, RiddleProofProfileArtifactRef, RiddleProofProfileBaselinePolicy, RiddleProofProfileBoundsOffender, RiddleProofProfileCheck, RiddleProofProfileCheckResult, RiddleProofProfileCheckType, RiddleProofProfileEvidence, RiddleProofProfileFailureAction, RiddleProofProfileHttpStatusBodyJsonAssertion, RiddleProofProfileHttpStatusBodyJsonAssertionResult, RiddleProofProfileHttpStatusPreflightCheckResult, RiddleProofProfileHttpStatusPreflightFetch, RiddleProofProfileHttpStatusPreflightFetchResponse, RiddleProofProfileHttpStatusPreflightOptions, RiddleProofProfileHttpStatusPreflightResult, RiddleProofProfileJsonValueType, RiddleProofProfileNetworkAbortErrorCode, RiddleProofProfileNetworkMock, RiddleProofProfileNetworkMockResponse, RiddleProofProfileResult, RiddleProofProfileRouteEvidence, RiddleProofProfileRouteInventoryRoute, RiddleProofProfileRunner, RiddleProofProfileSetupAction, RiddleProofProfileSetupActionType, RiddleProofProfileStatus, RiddleProofProfileTarget, RiddleProofProfileViewport, RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, collectRiddleProofProfileWarnings, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, deriveRiddleProofArtifactBodyAssertions, extractRiddleProofProfileResult, normalizeRiddleProofProfile, preflightRiddleProofProfileHttpStatusChecks, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult } from './profile.cjs';
+export { NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_NETWORK_ABORT_ERROR_CODES, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, RiddleProofArtifactBodyAssertionInput, RiddleProofArtifactBodyAssertionResult, RiddleProofProfile, RiddleProofProfileArtifactRef, RiddleProofProfileBaselinePolicy, RiddleProofProfileBoundsOffender, RiddleProofProfileCheck, RiddleProofProfileCheckResult, RiddleProofProfileCheckType, RiddleProofProfileEvidence, RiddleProofProfileFailureAction, RiddleProofProfileHttpStatusBodyJsonAssertion, RiddleProofProfileHttpStatusBodyJsonAssertionResult, RiddleProofProfileHttpStatusPreflightCheckResult, RiddleProofProfileHttpStatusPreflightFetch, RiddleProofProfileHttpStatusPreflightFetchResponse, RiddleProofProfileHttpStatusPreflightOptions, RiddleProofProfileHttpStatusPreflightResult, RiddleProofProfileJsonValueType, RiddleProofProfileNetworkAbortErrorCode, RiddleProofProfileNetworkMock, RiddleProofProfileNetworkMockResponse, RiddleProofProfileResult, RiddleProofProfileReturnSummaryField, RiddleProofProfileRouteEvidence, RiddleProofProfileRouteInventoryRoute, RiddleProofProfileRunner, RiddleProofProfileSetupAction, RiddleProofProfileSetupActionType, RiddleProofProfileStatus, RiddleProofProfileTarget, RiddleProofProfileViewport, RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, collectRiddleProofProfileWarnings, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, deriveRiddleProofArtifactBodyAssertions, extractRiddleProofProfileResult, normalizeRiddleProofProfile, preflightRiddleProofProfileHttpStatusChecks, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult } from './profile.cjs';
 export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployResult, RiddlePreviewFramework, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from './riddle-client.cjs';

package/dist/index.d.ts

@@ -10,5 +10,5 @@ export { CreateCaptureDiagnosticInput, DEFAULT_DIAGNOSTIC_ARRAY_LIMIT, DEFAULT_D
 export { BuildVisualProofSessionInput, RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_VERSION, RIDDLE_PROOF_VISUAL_SESSION_VERSION, VisualProofSessionMismatch, buildVisualProofSession, compareVisualProofSessionFingerprint, parseVisualProofSession, visualSessionFingerprint, visualSessionFingerprintBasis } from './proof-session.js';
 export { AssessPlayabilityOptions, RIDDLE_PROOF_PLAYABILITY_ASSESSMENT_VERSION, RIDDLE_PROOF_PLAYABILITY_VERSION, RiddleProofPlayabilityAssessment, RiddleProofPlayabilityEvidence, assessPlayabilityEvidence, extractPlayabilityEvidence, isRiddleProofPlayabilityMode } from './playability.js';
 export { AssessBasicGameplayOptions, AttachBasicGameplayArtifactOptions, BASIC_GAMEPLAY_ACTION_TYPES, BASIC_GAMEPLAY_PROGRESS_CHECK_TYPES, BasicGameplayActionResult, BasicGameplayActionType, BasicGameplayArtifactResolution, BasicGameplayAssessmentSummary, BasicGameplayBoundsOffender, BasicGameplayCanvasState, BasicGameplayCatchRecord, BasicGameplayChangeSummary, BasicGameplayFailureCode, BasicGameplayFixReference, BasicGameplayMetric, BasicGameplayMobileEvidence, BasicGameplayProgressCheckType, BasicGameplayProgressionCheck, BasicGameplayProofArtifact, BasicGameplayResponsiveViewportEvidence, BasicGameplayRouteReference, BasicGameplaySnapshot, BasicGameplaySuiteFailure, BasicGameplayWarningCode, CreateBasicGameplayCatchSummaryInput, RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_CATCH_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION, RiddleProofBasicGameplayAssessment, RiddleProofBasicGameplayCatchSummary, RiddleProofBasicGameplayEvidence, RiddleProofBasicGameplayRouteAssessment, RiddleProofBasicGameplayRouteEvidence, assessBasicGameplayEvidence, assessBasicGameplayProgressionCheck, assessBasicGameplayProgressionChecks, assessBasicGameplayRoute, attachBasicGameplayArtifactScreenshotHashes, augmentBasicGameplayAssessmentWithProgressionChecks, compactBasicGameplayText, createBasicGameplayCatchRecords, createBasicGameplayCatchSummary, extractBasicGameplayEvidence, resolveBasicGameplayProgressionCheckWithArtifactScreenshots, sanitizeBasicGameplayJsonString } from './basic-gameplay.js';
-export { NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_NETWORK_ABORT_ERROR_CODES, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, RiddleProofArtifactBodyAssertionInput, RiddleProofArtifactBodyAssertionResult, RiddleProofProfile, RiddleProofProfileArtifactRef, RiddleProofProfileBaselinePolicy, RiddleProofProfileBoundsOffender, RiddleProofProfileCheck, RiddleProofProfileCheckResult, RiddleProofProfileCheckType, RiddleProofProfileEvidence, RiddleProofProfileFailureAction, RiddleProofProfileHttpStatusBodyJsonAssertion, RiddleProofProfileHttpStatusBodyJsonAssertionResult, RiddleProofProfileHttpStatusPreflightCheckResult, RiddleProofProfileHttpStatusPreflightFetch, RiddleProofProfileHttpStatusPreflightFetchResponse, RiddleProofProfileHttpStatusPreflightOptions, RiddleProofProfileHttpStatusPreflightResult, RiddleProofProfileJsonValueType, RiddleProofProfileNetworkAbortErrorCode, RiddleProofProfileNetworkMock, RiddleProofProfileNetworkMockResponse, RiddleProofProfileResult, RiddleProofProfileRouteEvidence, RiddleProofProfileRouteInventoryRoute, RiddleProofProfileRunner, RiddleProofProfileSetupAction, RiddleProofProfileSetupActionType, RiddleProofProfileStatus, RiddleProofProfileTarget, RiddleProofProfileViewport, RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, collectRiddleProofProfileWarnings, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, deriveRiddleProofArtifactBodyAssertions, extractRiddleProofProfileResult, normalizeRiddleProofProfile, preflightRiddleProofProfileHttpStatusChecks, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult } from './profile.js';
+export { NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_NETWORK_ABORT_ERROR_CODES, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, RiddleProofArtifactBodyAssertionInput, RiddleProofArtifactBodyAssertionResult, RiddleProofProfile, RiddleProofProfileArtifactRef, RiddleProofProfileBaselinePolicy, RiddleProofProfileBoundsOffender, RiddleProofProfileCheck, RiddleProofProfileCheckResult, RiddleProofProfileCheckType, RiddleProofProfileEvidence, RiddleProofProfileFailureAction, RiddleProofProfileHttpStatusBodyJsonAssertion, RiddleProofProfileHttpStatusBodyJsonAssertionResult, RiddleProofProfileHttpStatusPreflightCheckResult, RiddleProofProfileHttpStatusPreflightFetch, RiddleProofProfileHttpStatusPreflightFetchResponse, RiddleProofProfileHttpStatusPreflightOptions, RiddleProofProfileHttpStatusPreflightResult, RiddleProofProfileJsonValueType, RiddleProofProfileNetworkAbortErrorCode, RiddleProofProfileNetworkMock, RiddleProofProfileNetworkMockResponse, RiddleProofProfileResult, RiddleProofProfileReturnSummaryField, RiddleProofProfileRouteEvidence, RiddleProofProfileRouteInventoryRoute, RiddleProofProfileRunner, RiddleProofProfileSetupAction, RiddleProofProfileSetupActionType, RiddleProofProfileStatus, RiddleProofProfileTarget, RiddleProofProfileViewport, RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, collectRiddleProofProfileWarnings, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, deriveRiddleProofArtifactBodyAssertions, extractRiddleProofProfileResult, normalizeRiddleProofProfile, preflightRiddleProofProfileHttpStatusChecks, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult } from './profile.js';
 export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployResult, RiddlePreviewFramework, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from './riddle-client.js';

package/dist/index.js

@@ -62,7 +62,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-QJJ3ISMK.js";
+} from "./chunk-YB3LNLZB.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -527,6 +527,8 @@ function profileSetupWindowCallReceipts(results) {
     };
     if (result.returned !== void 0) receipt.returned = result.returned;
     if (result.expected_return !== void 0) receipt.expected_return = result.expected_return;
+    const returnSummary = profileSetupReturnSummary(result);
+    if (returnSummary.length) receipt.return_summary = returnSummary;
     return receipt;
   });
 }
@@ -542,6 +544,40 @@ function profileSetupWindowEvalReceipts(results) {
     };
     if (result.returned !== void 0) receipt.returned = result.returned;
     if (result.expected_return !== void 0) receipt.expected_return = result.expected_return;
+    const returnSummary = profileSetupReturnSummary(result);
+    if (returnSummary.length) receipt.return_summary = returnSummary;
+    return receipt;
+  });
+}
+function profileSetupReturnSummaryFields(result) {
+  const input = result.return_summary_fields;
+  if (!Array.isArray(input)) return [];
+  const fields = [];
+  for (const item of input) {
+    if (typeof item === "string") {
+      const path2 = item.trim();
+      if (path2) fields.push({ path: path2 });
+      continue;
+    }
+    if (!isRecord(item)) continue;
+    const path = stringValue(item.path) ?? stringValue(item.key) ?? stringValue(item.json_path) ?? stringValue(item.jsonPath);
+    if (!path) continue;
+    const label = stringValue(item.label) ?? stringValue(item.name) ?? stringValue(item.title);
+    fields.push(label ? { path, label } : { path });
+  }
+  return fields;
+}
+function profileSetupReturnSummary(result) {
+  if (result.returned === void 0) return [];
+  return profileSetupReturnSummaryFields(result).map((field) => {
+    const resolved = resolveJsonPath(result.returned, field.path);
+    const receipt = {
+      label: field.label || field.path,
+      path: field.path,
+      exists: resolved.exists
+    };
+    if (resolved.exists) receipt.value = toJsonValue(resolved.value);
+    if (resolved.error) receipt.reason = resolved.error;
     return receipt;
   });
 }
@@ -730,6 +766,37 @@ function normalizeSetupActionArgs(input, index) {
   }
   return argsInput.map(toJsonValue);
 }
+function normalizeReturnSummaryFields(input, index) {
+  const fieldsInput = valueFromOwn(
+    input,
+    "return_summary_fields",
+    "returnSummaryFields",
+    "summary_fields",
+    "summaryFields",
+    "receipt_fields",
+    "receiptFields",
+    "return_receipt_fields",
+    "returnReceiptFields"
+  );
+  if (fieldsInput === void 0) return void 0;
+  if (!Array.isArray(fieldsInput)) {
+    throw new Error(`target.setup_actions[${index}].return_summary_fields must be an array.`);
+  }
+  return fieldsInput.map((field, fieldIndex) => {
+    if (typeof field === "string") {
+      const path2 = field.trim();
+      if (!path2) throw new Error(`target.setup_actions[${index}].return_summary_fields[${fieldIndex}] requires path.`);
+      return { path: path2 };
+    }
+    if (!isRecord(field)) {
+      throw new Error(`target.setup_actions[${index}].return_summary_fields[${fieldIndex}] must be a string path or object.`);
+    }
+    const path = stringFromOwn(field, "path", "key", "json_path", "jsonPath");
+    if (!path) throw new Error(`target.setup_actions[${index}].return_summary_fields[${fieldIndex}] requires path.`);
+    const label = stringFromOwn(field, "label", "name", "title");
+    return label ? { path, label } : { path };
+  });
+}
 function normalizeSetupActionRepeat(input, index) {
   const repeat = numberValue(valueFromOwn(input, "repeat", "repeat_count", "repeatCount", "times"));
   if (repeat === void 0) return void 0;
@@ -951,6 +1018,7 @@ function normalizeSetupAction(input, index) {
     expect_return: hasExpectedReturn ? toJsonValue(valueFromOwn(input, "expect_return", "expectReturn", "expected_return", "expectedReturn")) : void 0,
     store_return_to: storeReturnTo,
     capture_return: captureReturn,
+    return_summary_fields: normalizeReturnSummaryFields(input, index),
     until_path: untilPath,
     until_expected_value: hasUntilExpectedValue ? toJsonValue(valueFromOwn(input, "until_expected_value", "untilExpectedValue", "until_expected", "untilExpected", "until_value", "untilValue", "expected_value", "expectedValue", "expected")) : void 0,
     max_calls: maxCalls,
@@ -3989,6 +4057,8 @@ function profileSetupWindowCallReceipts(results) {
       };
       if (result.returned !== undefined) receipt.returned = result.returned;
       if (result.expected_return !== undefined) receipt.expected_return = result.expected_return;
+      const returnSummary = profileSetupReturnSummary(result);
+      if (returnSummary.length) receipt.return_summary = returnSummary;
       return receipt;
     });
 }
@@ -4006,9 +4076,43 @@ function profileSetupWindowEvalReceipts(results) {
       };
       if (result.returned !== undefined) receipt.returned = result.returned;
       if (result.expected_return !== undefined) receipt.expected_return = result.expected_return;
+      const returnSummary = profileSetupReturnSummary(result);
+      if (returnSummary.length) receipt.return_summary = returnSummary;
       return receipt;
     });
 }
+function profileSetupReturnSummaryFields(result) {
+  const input = result && result.return_summary_fields;
+  if (!Array.isArray(input)) return [];
+  const fields = [];
+  for (const item of input) {
+    if (typeof item === "string") {
+      const path = item.trim();
+      if (path) fields.push({ path });
+      continue;
+    }
+    if (!item || typeof item !== "object" || Array.isArray(item)) continue;
+    const path = String(item.path || item.key || item.json_path || item.jsonPath || "").trim();
+    if (!path) continue;
+    const label = String(item.label || item.name || item.title || "").trim();
+    fields.push(label ? { path, label } : { path });
+  }
+  return fields;
+}
+function profileSetupReturnSummary(result) {
+  if (!result || result.returned === undefined) return [];
+  return profileSetupReturnSummaryFields(result).map((field) => {
+    const resolved = resolveJsonProbePath(result.returned, field.path);
+    const receipt = {
+      label: field.label || field.path,
+      path: field.path,
+      exists: Boolean(resolved.exists),
+    };
+    if (resolved.exists) receipt.value = setupJsonValue(resolved.value);
+    if (resolved.error) receipt.reason = resolved.error;
+    return receipt;
+  });
+}
 function profileSetupRangeValueReceipts(results) {
   return (results || [])
     .filter((result) => result && profileSetupResultAction(result) === "set_range_value")
@@ -5743,6 +5847,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       const script = String(action.script || action.code || action.source || action.body || "");
       const args = Array.isArray(action.args) ? action.args : [];
       const storeReturnTo = String(action.store_return_to || action.storeReturnTo || action.save_return_to || action.saveReturnTo || action.assign_return_to || action.assignReturnTo || action.return_state_path || action.returnStatePath || "").trim();
+      const returnSummaryFields = Array.isArray(action.return_summary_fields) ? action.return_summary_fields : [];
       if (!script.trim()) return { ...base, reason: "missing_script" };
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
@@ -5772,6 +5877,7 @@ async function executeSetupAction(action, ordinal, viewport) {
         return_captured: captureReturn,
         expected_return: hasExpectation ? setupJsonValue(expected) : undefined,
         return_stored_to: result.return_stored_to || storeReturnTo || undefined,
+        return_summary_fields: returnSummaryFields.length ? setupJsonValue(returnSummaryFields) : undefined,
         reason: result.ok ? (expectationMet ? undefined : "unexpected_return_value") : result.reason,
         store_reason: result.store_reason || undefined,
         error: result.error || undefined,
@@ -5781,6 +5887,7 @@ async function executeSetupAction(action, ordinal, viewport) {
       const path = String(action.path || action.function_path || action.functionPath || "");
       const args = Array.isArray(action.args) ? action.args : [];
       const storeReturnTo = String(action.store_return_to || action.storeReturnTo || action.save_return_to || action.saveReturnTo || action.assign_return_to || action.assignReturnTo || action.return_state_path || action.returnStatePath || "").trim();
+      const returnSummaryFields = Array.isArray(action.return_summary_fields) ? action.return_summary_fields : [];
       if (!path) return { ...base, path, reason: "missing_path" };
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
@@ -5810,6 +5917,7 @@ async function executeSetupAction(action, ordinal, viewport) {
         return_captured: captureReturn,
         expected_return: hasExpectation ? setupJsonValue(expected) : undefined,
         return_stored_to: result.return_stored_to || storeReturnTo || undefined,
+        return_summary_fields: returnSummaryFields.length ? setupJsonValue(returnSummaryFields) : undefined,
         reason: result.ok ? (expectationMet ? undefined : "unexpected_return_value") : result.reason,
         store_reason: result.store_reason || undefined,
         error: result.error || undefined,

package/dist/profile.d.cts

@@ -133,6 +133,7 @@ interface RiddleProofProfileSetupAction {
     expect_return?: JsonValue;
     store_return_to?: string;
     capture_return?: boolean;
+    return_summary_fields?: RiddleProofProfileReturnSummaryField[];
     until_path?: string;
     until_expected_value?: JsonValue;
     max_calls?: number;
@@ -159,6 +160,10 @@ interface RiddleProofProfileSetupAction {
     optional?: boolean;
     continue_on_failure?: boolean;
 }
+interface RiddleProofProfileReturnSummaryField {
+    path: string;
+    label?: string;
+}
 interface RiddleProofProfileNetworkMockResponse {
     label?: string;
     status: number;
@@ -464,4 +469,4 @@ declare function buildRiddleProofProfileScript(profile: RiddleProofProfile): str
 declare function collectRiddleProfileArtifactRefs(input: unknown): RiddleProofProfileArtifactRef[];
 declare function extractRiddleProofProfileResult(input: unknown): RiddleProofProfileResult | undefined;
 
-export { type NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_NETWORK_ABORT_ERROR_CODES, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, type RiddleProofArtifactBodyAssertionInput, type RiddleProofArtifactBodyAssertionResult, type RiddleProofProfile, type RiddleProofProfileArtifactRef, type RiddleProofProfileBaselinePolicy, type RiddleProofProfileBoundsOffender, type RiddleProofProfileCheck, type RiddleProofProfileCheckResult, type RiddleProofProfileCheckType, type RiddleProofProfileEvidence, type RiddleProofProfileFailureAction, type RiddleProofProfileHttpStatusBodyJsonAssertion, type RiddleProofProfileHttpStatusBodyJsonAssertionResult, type RiddleProofProfileHttpStatusPreflightCheckResult, type RiddleProofProfileHttpStatusPreflightFetch, type RiddleProofProfileHttpStatusPreflightFetchResponse, type RiddleProofProfileHttpStatusPreflightOptions, type RiddleProofProfileHttpStatusPreflightResult, type RiddleProofProfileJsonValueType, type RiddleProofProfileNetworkAbortErrorCode, type RiddleProofProfileNetworkMock, type RiddleProofProfileNetworkMockResponse, type RiddleProofProfileResult, type RiddleProofProfileRouteEvidence, type RiddleProofProfileRouteInventoryRoute, type RiddleProofProfileRunner, type RiddleProofProfileSetupAction, type RiddleProofProfileSetupActionType, type RiddleProofProfileStatus, type RiddleProofProfileTarget, type RiddleProofProfileViewport, type RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, collectRiddleProofProfileWarnings, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, deriveRiddleProofArtifactBodyAssertions, extractRiddleProofProfileResult, normalizeRiddleProofProfile, preflightRiddleProofProfileHttpStatusChecks, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult };
+export { type NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_NETWORK_ABORT_ERROR_CODES, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, type RiddleProofArtifactBodyAssertionInput, type RiddleProofArtifactBodyAssertionResult, type RiddleProofProfile, type RiddleProofProfileArtifactRef, type RiddleProofProfileBaselinePolicy, type RiddleProofProfileBoundsOffender, type RiddleProofProfileCheck, type RiddleProofProfileCheckResult, type RiddleProofProfileCheckType, type RiddleProofProfileEvidence, type RiddleProofProfileFailureAction, type RiddleProofProfileHttpStatusBodyJsonAssertion, type RiddleProofProfileHttpStatusBodyJsonAssertionResult, type RiddleProofProfileHttpStatusPreflightCheckResult, type RiddleProofProfileHttpStatusPreflightFetch, type RiddleProofProfileHttpStatusPreflightFetchResponse, type RiddleProofProfileHttpStatusPreflightOptions, type RiddleProofProfileHttpStatusPreflightResult, type RiddleProofProfileJsonValueType, type RiddleProofProfileNetworkAbortErrorCode, type RiddleProofProfileNetworkMock, type RiddleProofProfileNetworkMockResponse, type RiddleProofProfileResult, type RiddleProofProfileReturnSummaryField, type RiddleProofProfileRouteEvidence, type RiddleProofProfileRouteInventoryRoute, type RiddleProofProfileRunner, type RiddleProofProfileSetupAction, type RiddleProofProfileSetupActionType, type RiddleProofProfileStatus, type RiddleProofProfileTarget, type RiddleProofProfileViewport, type RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, collectRiddleProofProfileWarnings, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, deriveRiddleProofArtifactBodyAssertions, extractRiddleProofProfileResult, normalizeRiddleProofProfile, preflightRiddleProofProfileHttpStatusChecks, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult };

package/dist/profile.d.ts

@@ -133,6 +133,7 @@ interface RiddleProofProfileSetupAction {
     expect_return?: JsonValue;
     store_return_to?: string;
     capture_return?: boolean;
+    return_summary_fields?: RiddleProofProfileReturnSummaryField[];
     until_path?: string;
     until_expected_value?: JsonValue;
     max_calls?: number;
@@ -159,6 +160,10 @@ interface RiddleProofProfileSetupAction {
     optional?: boolean;
     continue_on_failure?: boolean;
 }
+interface RiddleProofProfileReturnSummaryField {
+    path: string;
+    label?: string;
+}
 interface RiddleProofProfileNetworkMockResponse {
     label?: string;
     status: number;
@@ -464,4 +469,4 @@ declare function buildRiddleProofProfileScript(profile: RiddleProofProfile): str
 declare function collectRiddleProfileArtifactRefs(input: unknown): RiddleProofProfileArtifactRef[];
 declare function extractRiddleProofProfileResult(input: unknown): RiddleProofProfileResult | undefined;
 
-export { type NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_NETWORK_ABORT_ERROR_CODES, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, type RiddleProofArtifactBodyAssertionInput, type RiddleProofArtifactBodyAssertionResult, type RiddleProofProfile, type RiddleProofProfileArtifactRef, type RiddleProofProfileBaselinePolicy, type RiddleProofProfileBoundsOffender, type RiddleProofProfileCheck, type RiddleProofProfileCheckResult, type RiddleProofProfileCheckType, type RiddleProofProfileEvidence, type RiddleProofProfileFailureAction, type RiddleProofProfileHttpStatusBodyJsonAssertion, type RiddleProofProfileHttpStatusBodyJsonAssertionResult, type RiddleProofProfileHttpStatusPreflightCheckResult, type RiddleProofProfileHttpStatusPreflightFetch, type RiddleProofProfileHttpStatusPreflightFetchResponse, type RiddleProofProfileHttpStatusPreflightOptions, type RiddleProofProfileHttpStatusPreflightResult, type RiddleProofProfileJsonValueType, type RiddleProofProfileNetworkAbortErrorCode, type RiddleProofProfileNetworkMock, type RiddleProofProfileNetworkMockResponse, type RiddleProofProfileResult, type RiddleProofProfileRouteEvidence, type RiddleProofProfileRouteInventoryRoute, type RiddleProofProfileRunner, type RiddleProofProfileSetupAction, type RiddleProofProfileSetupActionType, type RiddleProofProfileStatus, type RiddleProofProfileTarget, type RiddleProofProfileViewport, type RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, collectRiddleProofProfileWarnings, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, deriveRiddleProofArtifactBodyAssertions, extractRiddleProofProfileResult, normalizeRiddleProofProfile, preflightRiddleProofProfileHttpStatusChecks, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult };
+export { type NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_NETWORK_ABORT_ERROR_CODES, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, type RiddleProofArtifactBodyAssertionInput, type RiddleProofArtifactBodyAssertionResult, type RiddleProofProfile, type RiddleProofProfileArtifactRef, type RiddleProofProfileBaselinePolicy, type RiddleProofProfileBoundsOffender, type RiddleProofProfileCheck, type RiddleProofProfileCheckResult, type RiddleProofProfileCheckType, type RiddleProofProfileEvidence, type RiddleProofProfileFailureAction, type RiddleProofProfileHttpStatusBodyJsonAssertion, type RiddleProofProfileHttpStatusBodyJsonAssertionResult, type RiddleProofProfileHttpStatusPreflightCheckResult, type RiddleProofProfileHttpStatusPreflightFetch, type RiddleProofProfileHttpStatusPreflightFetchResponse, type RiddleProofProfileHttpStatusPreflightOptions, type RiddleProofProfileHttpStatusPreflightResult, type RiddleProofProfileJsonValueType, type RiddleProofProfileNetworkAbortErrorCode, type RiddleProofProfileNetworkMock, type RiddleProofProfileNetworkMockResponse, type RiddleProofProfileResult, type RiddleProofProfileReturnSummaryField, type RiddleProofProfileRouteEvidence, type RiddleProofProfileRouteInventoryRoute, type RiddleProofProfileRunner, type RiddleProofProfileSetupAction, type RiddleProofProfileSetupActionType, type RiddleProofProfileStatus, type RiddleProofProfileTarget, type RiddleProofProfileViewport, type RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, collectRiddleProofProfileWarnings, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, deriveRiddleProofArtifactBodyAssertions, extractRiddleProofProfileResult, normalizeRiddleProofProfile, preflightRiddleProofProfileHttpStatusChecks, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult };

package/dist/profile.js

@@ -23,7 +23,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-QJJ3ISMK.js";
+} from "./chunk-YB3LNLZB.js";
 export {
   RIDDLE_PROOF_PROFILE_CHECK_TYPES,
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riddledc/riddle-proof",
-  "version": "0.7.153",
+  "version": "0.7.155",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",