@riddledc/riddle-proof 0.7.149 → 0.7.151

package/dist/cli.cjs

@@ -6975,6 +6975,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
   "selector_text_visible",
   "selector_text_absent",
   "selector_text_order",
+  "observe_within",
   "frame_text_visible",
   "frame_url_equals",
   "frame_url_matches",
@@ -8297,7 +8298,7 @@ function normalizeCheck(input, index) {
     throw new Error(`checks[${index}].type ${type} is not supported. Supported checks: ${RIDDLE_PROOF_PROFILE_CHECK_TYPES.join(", ")}`);
   }
   const isDialogCountCheck = isDialogCountCheckType(type);
-  if ((type === "selector_visible" || type === "selector_absent" || type === "selector_count_at_least" || type === "selector_count_equals" || type === "selector_count_equal" || type === "selector_count_eq" || type === "selector_text_visible" || type === "selector_text_absent") && !stringValue2(input.selector)) {
+  if ((type === "selector_visible" || type === "selector_absent" || type === "selector_count_at_least" || type === "selector_count_equals" || type === "selector_count_equal" || type === "selector_count_eq" || type === "selector_text_visible" || type === "selector_text_absent" || type === "observe_within" && !stringValue2(input.text) && !stringValue2(input.pattern)) && !stringValue2(input.selector)) {
     throw new Error(`checks[${index}] ${type} requires selector.`);
   }
   if ((type === "frame_text_visible" || type === "frame_url_equals" || type === "frame_url_matches" || type === "frame_no_horizontal_overflow") && !stringValue2(input.selector)) {
@@ -8438,7 +8439,7 @@ function normalizeCheck(input, index) {
     allowed_content_types: allowedContentTypes,
     allow_get_fallback: isLinkStatusCheck ? input.allow_get_fallback === false || input.allowGetFallback === false ? false : true : void 0,
     max_overflow_px: numberValue(input.max_overflow_px),
-    timeout_ms: numberValue(input.timeout_ms) ?? numberValue(input.timeoutMs),
+    timeout_ms: numberValue(input.timeout_ms) ?? numberValue(input.timeoutMs) ?? numberValue(input.within_ms) ?? numberValue(input.withinMs),
     run_direct_routes: input.run_direct_routes === false || input.runDirectRoutes === false ? false : true,
     run_clickthroughs: input.run_clickthroughs === false || input.runClickthroughs === false ? false : true,
     run_all_viewports: input.run_all_viewports === true || input.runAllViewports === true,
@@ -8956,6 +8957,16 @@ function summarizeLinkStatusEvidence(viewport, check) {
 function textKey(check) {
   return check.pattern ? `pattern:${check.pattern}/${check.flags || ""}` : `text:${check.text || ""}`;
 }
+function observeWithinTimeoutMs(check) {
+  const raw = check.timeout_ms;
+  if (typeof raw === "number" && Number.isFinite(raw) && raw > 0) return Math.min(Math.round(raw), 6e4);
+  return 2e3;
+}
+function observeWithinKey(check) {
+  const target = check.selector ? `selector:${check.selector}` : "page";
+  const expectation = check.pattern ? `pattern:${check.pattern}/${check.flags || ""}` : check.text ? `text:${check.text}` : "visible";
+  return `${target}|${expectation}|within:${observeWithinTimeoutMs(check)}`;
+}
 function textSequenceForCheck(viewport, check) {
   const key = selectorKey(check);
   const sequence = viewport.text_sequences?.[key];
@@ -9462,6 +9473,40 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed ? `Selector ${key} text order failed in ${failed} viewport(s).` : void 0
     };
   }
+  if (check.type === "observe_within") {
+    const key = observeWithinKey(check);
+    const timeoutMs = observeWithinTimeoutMs(check);
+    const results = viewports.map((viewport) => {
+      const observation = viewport.observations?.[key];
+      const matched = observation?.matched === true;
+      return {
+        viewport: viewport.name,
+        matched,
+        elapsed_ms: numberValue(observation?.elapsed_ms) ?? null,
+        timeout_ms: numberValue(observation?.timeout_ms) ?? timeoutMs,
+        attempts: numberValue(observation?.attempts) ?? null,
+        selector_count: numberValue(observation?.selector_count) ?? null,
+        visible_count: numberValue(observation?.visible_count) ?? null,
+        matched_count: numberValue(observation?.matched_count) ?? null,
+        sample: stringValue2(observation?.sample) ?? null,
+        error: stringValue2(observation?.error) ?? null
+      };
+    });
+    const failed = results.filter((result) => !result.matched).length;
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed ? "failed" : "passed",
+      evidence: {
+        selector: check.selector || null,
+        text: check.text || null,
+        pattern: check.pattern || null,
+        timeout_ms: timeoutMs,
+        viewports: results.map((result) => toJsonValue(result))
+      },
+      message: failed ? `Observation did not match within ${timeoutMs}ms in ${failed} viewport(s).` : void 0
+    };
+  }
   if (check.type === "frame_text_visible") {
     const key = selectorKey(check);
     const results = viewports.map((viewport) => {
@@ -11355,6 +11400,36 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "observe_within") {
+      const key = observeWithinKey(check);
+      const timeoutMs = observeWithinTimeoutMs(check);
+      const results = checkViewports.map((viewport) => {
+        const observation = viewport.observations && viewport.observations[key] && typeof viewport.observations[key] === "object"
+          ? viewport.observations[key]
+          : {};
+        return {
+          viewport: viewport.name,
+          matched: observation.matched === true,
+          elapsed_ms: typeof observation.elapsed_ms === "number" && Number.isFinite(observation.elapsed_ms) ? observation.elapsed_ms : null,
+          timeout_ms: typeof observation.timeout_ms === "number" && Number.isFinite(observation.timeout_ms) ? observation.timeout_ms : timeoutMs,
+          attempts: typeof observation.attempts === "number" && Number.isFinite(observation.attempts) ? observation.attempts : null,
+          selector_count: typeof observation.selector_count === "number" && Number.isFinite(observation.selector_count) ? observation.selector_count : null,
+          visible_count: typeof observation.visible_count === "number" && Number.isFinite(observation.visible_count) ? observation.visible_count : null,
+          matched_count: typeof observation.matched_count === "number" && Number.isFinite(observation.matched_count) ? observation.matched_count : null,
+          sample: typeof observation.sample === "string" && observation.sample.trim() ? observation.sample.trim() : null,
+          error: typeof observation.error === "string" && observation.error.trim() ? observation.error.trim() : null,
+        };
+      });
+      const failed = results.filter((result) => !result.matched).length;
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed ? "failed" : "passed",
+        evidence: { selector: check.selector || null, text: check.text || null, pattern: check.pattern || null, timeout_ms: timeoutMs, viewports: results },
+        message: failed ? "Observation did not match within " + timeoutMs + "ms in " + failed + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "frame_text_visible") {
       const selector = check.selector || "";
       const results = checkViewports.map((viewport) => {
@@ -11787,6 +11862,19 @@ function ensureDialogHandler() {
 function textKey(check) {
   return check.pattern ? "pattern:" + check.pattern + "/" + (check.flags || "") : "text:" + (check.text || "");
 }
+function observeWithinTimeoutMs(check) {
+  const raw = Number(check && check.timeout_ms);
+  return Number.isFinite(raw) && raw > 0 ? Math.min(Math.round(raw), 60000) : 2000;
+}
+function observeWithinKey(check) {
+  const target = check && check.selector ? "selector:" + check.selector : "page";
+  const expectation = check && check.pattern
+    ? "pattern:" + check.pattern + "/" + (check.flags || "")
+    : check && check.text
+      ? "text:" + check.text
+      : "visible";
+  return target + "|" + expectation + "|within:" + observeWithinTimeoutMs(check);
+}
 function textMatches(sample, check) {
   if (check.pattern) {
     try { return new RegExp(check.pattern, check.flags || "").test(sample || ""); } catch { return false; }
@@ -13102,6 +13190,104 @@ async function selectorTextSequence(selector) {
     };
   }).catch((error) => ({ count: 0, visible_count: 0, texts: [], visible_texts: [], match_texts: [], visible_match_texts: [], error: String(error && error.message ? error.message : error).slice(0, 500) }));
 }
+async function observeWithinSnapshot(check) {
+  const payload = {
+    selector: check.selector || "",
+    text: check.text || "",
+    pattern: check.pattern || "",
+    flags: check.flags || "",
+    wants_text: Boolean(check.text || check.pattern),
+  };
+  if (payload.selector) {
+    return page.locator(payload.selector).evaluateAll((elements, input) => {
+      const compact = (value) => String(value || "").replace(/\s+/g, " ").trim();
+      const matchText = (value) => {
+        const source = compact(value);
+        if (input.pattern) {
+          try { return new RegExp(input.pattern, input.flags || "").test(source); } catch { return false; }
+        }
+        return source.includes(input.text || "");
+      };
+      const isVisible = (element) => {
+        const style = window.getComputedStyle(element);
+        const rect = element.getBoundingClientRect();
+        return style && style.visibility !== "hidden" && style.display !== "none" && rect.width > 0 && rect.height > 0;
+      };
+      const rows = elements.map((element, index) => {
+        const text = compact(element.innerText || element.textContent || "");
+        const visible = isVisible(element);
+        return { index, text, visible, matched: input.wants_text ? matchText(text) : visible };
+      });
+      const visibleRows = rows.filter((row) => row.visible);
+      const matches = input.wants_text ? visibleRows.filter((row) => row.matched) : visibleRows;
+      const sampleRow = matches[0] || visibleRows[0] || rows[0] || null;
+      return {
+        selector: input.selector,
+        text: input.text || null,
+        pattern: input.pattern || null,
+        selector_count: rows.length,
+        visible_count: visibleRows.length,
+        matched_count: matches.length,
+        matched: matches.length > 0,
+        sample: sampleRow && sampleRow.text ? sampleRow.text.slice(0, 240) : null,
+      };
+    }, payload).catch((error) => ({
+      selector: payload.selector,
+      text: payload.text || null,
+      pattern: payload.pattern || null,
+      selector_count: 0,
+      visible_count: 0,
+      matched_count: 0,
+      matched: false,
+      sample: null,
+      error: String(error && error.message ? error.message : error).slice(0, 500),
+    }));
+  }
+  return page.evaluate((input) => {
+    const compact = (value) => String(value || "").replace(/\s+/g, " ").trim();
+    const sample = compact(document.body ? document.body.innerText || document.body.textContent || "" : "");
+    let matched = false;
+    if (input.pattern) {
+      try { matched = new RegExp(input.pattern, input.flags || "").test(sample); } catch { matched = false; }
+    } else {
+      matched = sample.includes(input.text || "");
+    }
+    return {
+      selector: null,
+      text: input.text || null,
+      pattern: input.pattern || null,
+      matched,
+      matched_count: matched ? 1 : 0,
+      sample: sample.slice(0, 240),
+    };
+  }, payload).catch((error) => ({
+    selector: null,
+    text: payload.text || null,
+    pattern: payload.pattern || null,
+    matched: false,
+    matched_count: 0,
+    sample: null,
+    error: String(error && error.message ? error.message : error).slice(0, 500),
+  }));
+}
+async function observeWithin(check) {
+  const timeoutMs = observeWithinTimeoutMs(check);
+  const startedAt = Date.now();
+  let attempts = 0;
+  let last = null;
+  while (true) {
+    attempts += 1;
+    last = await observeWithinSnapshot(check);
+    const elapsedMs = Date.now() - startedAt;
+    if (last && last.matched === true) {
+      return { ...last, timeout_ms: timeoutMs, elapsed_ms: elapsedMs, attempts };
+    }
+    if (elapsedMs >= timeoutMs) {
+      return { ...(last || {}), matched: false, timeout_ms: timeoutMs, elapsed_ms: elapsedMs, attempts };
+    }
+    await page.waitForTimeout(Math.min(100, Math.max(25, timeoutMs - elapsedMs)));
+  }
+}
 function linkProbeMaxLinks(check) {
   const value = Number(check.max_links || check.maxLinks || check.limit || 100);
   return Number.isInteger(value) && value > 0 ? Math.min(value, 500) : 100;
@@ -14154,6 +14340,7 @@ async function captureViewport(viewport) {
   const text_matches = {};
   const text_match_samples = {};
   const text_case_insensitive_samples = {};
+  const observations = {};
   const http_statuses = {};
   const link_statuses = {};
   for (const check of profile.checks || []) {
@@ -14174,6 +14361,10 @@ async function captureViewport(viewport) {
       selectors[check.selector] = selectors[check.selector] || await selectorStats(check.selector);
       text_sequences[check.selector] = await selectorTextSequence(check.selector);
     }
+    if (check.type === "observe_within") {
+      const key = observeWithinKey(check);
+      observations[key] = observations[key] || await observeWithin(check);
+    }
     if ((check.type === "text_visible" || check.type === "text_absent") && (check.text || check.pattern)) {
       const key = textKey(check);
       const sample = dom.body_text || dom.body_text_sample || "";
@@ -14267,6 +14458,7 @@ async function captureViewport(viewport) {
     text_matches,
     text_match_samples,
     text_case_insensitive_samples,
+    observations,
     http_statuses,
     link_statuses,
     route_inventory: routeInventory,
@@ -14872,6 +15064,7 @@ function profileRiddleJobMarkdown(result) {
   const attempts = cliFiniteNumber(riddle.attempts);
   const submittedAt = cliString(riddle.submitted_at);
   const completedAt = cliString(riddle.completed_at);
+  const artifactRecovery = riddle.artifact_recovery === true;
   const parts = [
     mode ? `mode ${markdownInlineCode(mode)}` : "",
     jobCount === void 0 ? "" : `jobs ${jobCount}`,
@@ -14888,6 +15081,9 @@ function profileRiddleJobMarkdown(result) {
   if (submittedAt || completedAt) {
     lines.push(`- timing:${submittedAt ? ` submitted ${markdownInlineCode(submittedAt)}` : ""}${completedAt ? ` completed ${markdownInlineCode(completedAt)}` : ""}`);
   }
+  if (artifactRecovery) {
+    lines.push("- artifact recovery: used artifacts endpoint after non-terminal poll");
+  }
   const splitJobs = Array.isArray(riddle.split_jobs) ? riddle.split_jobs.map(cliRecord).filter((job) => Boolean(job)) : [];
   for (const job of splitJobs.slice(0, 12)) {
     const viewport = cliString(job.viewport) || "viewport";
@@ -14896,13 +15092,15 @@ function profileRiddleJobMarkdown(result) {
     const splitTerminal = typeof job.terminal === "boolean" ? job.terminal : void 0;
     const splitElapsedMs = cliFiniteNumber(job.elapsed_ms);
     const splitPreSubmissionElapsedMs = cliFiniteNumber(job.pre_submission_elapsed_ms);
+    const splitArtifactRecovery = job.artifact_recovery === true;
     lines.push(
       `- ${viewport}: ${[
         splitJobId ? `job ${markdownInlineCode(splitJobId)}` : "",
         splitStatus ? `status ${markdownInlineCode(splitStatus)}` : "",
         splitTerminal === void 0 ? "" : `terminal ${splitTerminal ? "true" : "false"}`,
         splitElapsedMs === void 0 ? "" : `elapsed ${formatPollDuration(splitElapsedMs)}`,
-        splitPreSubmissionElapsedMs === void 0 || splitPreSubmissionElapsedMs < 1e3 ? "" : `pre-submit ${formatPollDuration(splitPreSubmissionElapsedMs)}`
+        splitPreSubmissionElapsedMs === void 0 || splitPreSubmissionElapsedMs < 1e3 ? "" : `pre-submit ${formatPollDuration(splitPreSubmissionElapsedMs)}`,
+        splitArtifactRecovery ? "artifact recovery" : ""
       ].filter(Boolean).join(", ") || "job metadata unavailable"}`
     );
   }
@@ -14949,6 +15147,14 @@ function profileCheckMarkdownTarget(check) {
   if (check.type === "selector_text_order") {
     return selector ? `${markdownInlineCode(selector)} text order` : void 0;
   }
+  if (check.type === "observe_within") {
+    const textTarget = profileCheckTextTarget(evidence);
+    const timeoutMs = cliFiniteNumber(evidence.timeout_ms);
+    const withinLabel = timeoutMs === void 0 ? "within timeout" : `within ${timeoutMs}ms`;
+    if (selector && textTarget) return `${markdownInlineCode(selector)} observes ${textTarget} ${withinLabel}`;
+    if (selector) return `${markdownInlineCode(selector)} visible ${withinLabel}`;
+    return textTarget ? `${textTarget} ${withinLabel}` : withinLabel;
+  }
   if (check.type === "text_visible" || check.type === "text_absent") {
     return profileCheckTextTarget(evidence);
   }
@@ -15534,7 +15740,8 @@ function withRiddleMetadata(result, input) {
       elapsed_ms: poll?.elapsed_ms ?? result.riddle?.elapsed_ms,
       attempt: poll?.attempt ?? result.riddle?.attempt,
       attempts: poll?.attempts ?? result.riddle?.attempts,
-      timed_out: poll?.timed_out ?? result.riddle?.timed_out
+      timed_out: poll?.timed_out ?? result.riddle?.timed_out,
+      artifact_recovery: input.artifactRecovery ?? result.riddle?.artifact_recovery
     },
     artifacts: {
       ...result.artifacts,
@@ -15542,6 +15749,52 @@ function withRiddleMetadata(result, input) {
     }
   };
 }
+function riddleArtifactsPayloadStatus(payload) {
+  const record = cliRecord(payload);
+  return cliString(record?.status) ?? cliString(cliRecord(record?.job)?.status);
+}
+async function recoverProfileResultFromRiddleArtifacts(profile, input) {
+  if (input.poll.poll?.timed_out !== true) return void 0;
+  let artifactPayload;
+  try {
+    artifactPayload = await input.client.requestJson(`/v1/jobs/${input.jobId}/artifacts`);
+  } catch {
+    return void 0;
+  }
+  const artifacts = collectRiddleProfileArtifactRefs(artifactPayload);
+  if (!artifacts.length) return void 0;
+  const artifactStatus = riddleArtifactsPayloadStatus(artifactPayload);
+  const terminal = artifactStatus ? isTerminalRiddleJobStatus(artifactStatus) : true;
+  const recoveredPoll = input.poll.poll ? {
+    ...input.poll.poll,
+    status: artifactStatus ?? input.poll.poll.status,
+    terminal
+  } : void 0;
+  const artifactResult = await profileResultFromRiddleArtifacts(profile, artifacts, [artifactPayload, input.poll.job]);
+  if (artifactResult) {
+    return withRiddleMetadata(artifactResult, {
+      job_id: input.jobId,
+      status: artifactStatus ?? input.poll.status,
+      terminal,
+      poll: recoveredPoll,
+      artifacts,
+      artifactRecovery: true
+    });
+  }
+  if (!terminal) return void 0;
+  return createRiddleProofProfileInsufficientResult({
+    profile,
+    runner: input.runner,
+    error: `Riddle job ${input.jobId} timed out in status ${input.poll.status || "unknown"}, but artifacts were recovered without a proof result.`,
+    riddle: {
+      ...riddleMetadataFromPoll(input.jobId, input.poll),
+      status: artifactStatus ?? input.poll.status,
+      terminal,
+      artifact_recovery: true
+    },
+    artifacts
+  });
+}
 function riddleMetadataFromPoll(jobId, poll) {
   return {
     job_id: jobId,
@@ -15604,13 +15857,15 @@ function splitViewportRiddleMetadata(childRuns) {
     elapsed_ms: result.riddle?.elapsed_ms,
     attempt: result.riddle?.attempt,
     attempts: result.riddle?.attempts,
-    timed_out: result.riddle?.timed_out
+    timed_out: result.riddle?.timed_out,
+    artifact_recovery: result.riddle?.artifact_recovery
   }));
   return {
     mode: "split-viewports",
     job_count: childRuns.length,
     status: "split-viewports",
     terminal: childRuns.every(({ result }) => result.riddle?.terminal !== false),
+    artifact_recovery: childRuns.some(({ result }) => result.riddle?.artifact_recovery === true),
     queue_elapsed_ms: sumDefinedNumbers(splitJobs.map((job) => job.queue_elapsed_ms)),
     pre_submission_elapsed_ms: sumDefinedNumbers(splitJobs.map((job) => job.pre_submission_elapsed_ms)),
     elapsed_ms: sumDefinedNumbers(splitJobs.map((job) => job.elapsed_ms)),
@@ -15733,6 +15988,13 @@ async function runSingleRiddleProfileForCli(profile, options, input) {
   });
   const artifacts = collectRiddleProfileArtifactRefs(poll.artifacts);
   if (!poll.ok || !poll.terminal) {
+    const recoveredResult = await recoverProfileResultFromRiddleArtifacts(profile, {
+      client,
+      runner,
+      jobId,
+      poll
+    });
+    if (recoveredResult) return recoveredResult;
     return createRiddleProofProfileEnvironmentBlockedResult({
       profile,
       runner,

package/dist/cli.js

@@ -13,9 +13,10 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-QXQCG3WB.js";
+} from "./chunk-QJJ3ISMK.js";
 import {
   createRiddleApiClient,
+  isTerminalRiddleJobStatus,
   parseRiddleViewport
 } from "./chunk-M3ZTY6PQ.js";
 import {
@@ -430,6 +431,7 @@ function profileRiddleJobMarkdown(result) {
   const attempts = cliFiniteNumber(riddle.attempts);
   const submittedAt = cliString(riddle.submitted_at);
   const completedAt = cliString(riddle.completed_at);
+  const artifactRecovery = riddle.artifact_recovery === true;
   const parts = [
     mode ? `mode ${markdownInlineCode(mode)}` : "",
     jobCount === void 0 ? "" : `jobs ${jobCount}`,
@@ -446,6 +448,9 @@ function profileRiddleJobMarkdown(result) {
   if (submittedAt || completedAt) {
     lines.push(`- timing:${submittedAt ? ` submitted ${markdownInlineCode(submittedAt)}` : ""}${completedAt ? ` completed ${markdownInlineCode(completedAt)}` : ""}`);
   }
+  if (artifactRecovery) {
+    lines.push("- artifact recovery: used artifacts endpoint after non-terminal poll");
+  }
   const splitJobs = Array.isArray(riddle.split_jobs) ? riddle.split_jobs.map(cliRecord).filter((job) => Boolean(job)) : [];
   for (const job of splitJobs.slice(0, 12)) {
     const viewport = cliString(job.viewport) || "viewport";
@@ -454,13 +459,15 @@ function profileRiddleJobMarkdown(result) {
     const splitTerminal = typeof job.terminal === "boolean" ? job.terminal : void 0;
     const splitElapsedMs = cliFiniteNumber(job.elapsed_ms);
     const splitPreSubmissionElapsedMs = cliFiniteNumber(job.pre_submission_elapsed_ms);
+    const splitArtifactRecovery = job.artifact_recovery === true;
     lines.push(
       `- ${viewport}: ${[
         splitJobId ? `job ${markdownInlineCode(splitJobId)}` : "",
         splitStatus ? `status ${markdownInlineCode(splitStatus)}` : "",
         splitTerminal === void 0 ? "" : `terminal ${splitTerminal ? "true" : "false"}`,
         splitElapsedMs === void 0 ? "" : `elapsed ${formatPollDuration(splitElapsedMs)}`,
-        splitPreSubmissionElapsedMs === void 0 || splitPreSubmissionElapsedMs < 1e3 ? "" : `pre-submit ${formatPollDuration(splitPreSubmissionElapsedMs)}`
+        splitPreSubmissionElapsedMs === void 0 || splitPreSubmissionElapsedMs < 1e3 ? "" : `pre-submit ${formatPollDuration(splitPreSubmissionElapsedMs)}`,
+        splitArtifactRecovery ? "artifact recovery" : ""
       ].filter(Boolean).join(", ") || "job metadata unavailable"}`
     );
   }
@@ -507,6 +514,14 @@ function profileCheckMarkdownTarget(check) {
   if (check.type === "selector_text_order") {
     return selector ? `${markdownInlineCode(selector)} text order` : void 0;
   }
+  if (check.type === "observe_within") {
+    const textTarget = profileCheckTextTarget(evidence);
+    const timeoutMs = cliFiniteNumber(evidence.timeout_ms);
+    const withinLabel = timeoutMs === void 0 ? "within timeout" : `within ${timeoutMs}ms`;
+    if (selector && textTarget) return `${markdownInlineCode(selector)} observes ${textTarget} ${withinLabel}`;
+    if (selector) return `${markdownInlineCode(selector)} visible ${withinLabel}`;
+    return textTarget ? `${textTarget} ${withinLabel}` : withinLabel;
+  }
   if (check.type === "text_visible" || check.type === "text_absent") {
     return profileCheckTextTarget(evidence);
   }
@@ -1092,7 +1107,8 @@ function withRiddleMetadata(result, input) {
       elapsed_ms: poll?.elapsed_ms ?? result.riddle?.elapsed_ms,
       attempt: poll?.attempt ?? result.riddle?.attempt,
       attempts: poll?.attempts ?? result.riddle?.attempts,
-      timed_out: poll?.timed_out ?? result.riddle?.timed_out
+      timed_out: poll?.timed_out ?? result.riddle?.timed_out,
+      artifact_recovery: input.artifactRecovery ?? result.riddle?.artifact_recovery
     },
     artifacts: {
       ...result.artifacts,
@@ -1100,6 +1116,52 @@ function withRiddleMetadata(result, input) {
     }
   };
 }
+function riddleArtifactsPayloadStatus(payload) {
+  const record = cliRecord(payload);
+  return cliString(record?.status) ?? cliString(cliRecord(record?.job)?.status);
+}
+async function recoverProfileResultFromRiddleArtifacts(profile, input) {
+  if (input.poll.poll?.timed_out !== true) return void 0;
+  let artifactPayload;
+  try {
+    artifactPayload = await input.client.requestJson(`/v1/jobs/${input.jobId}/artifacts`);
+  } catch {
+    return void 0;
+  }
+  const artifacts = collectRiddleProfileArtifactRefs(artifactPayload);
+  if (!artifacts.length) return void 0;
+  const artifactStatus = riddleArtifactsPayloadStatus(artifactPayload);
+  const terminal = artifactStatus ? isTerminalRiddleJobStatus(artifactStatus) : true;
+  const recoveredPoll = input.poll.poll ? {
+    ...input.poll.poll,
+    status: artifactStatus ?? input.poll.poll.status,
+    terminal
+  } : void 0;
+  const artifactResult = await profileResultFromRiddleArtifacts(profile, artifacts, [artifactPayload, input.poll.job]);
+  if (artifactResult) {
+    return withRiddleMetadata(artifactResult, {
+      job_id: input.jobId,
+      status: artifactStatus ?? input.poll.status,
+      terminal,
+      poll: recoveredPoll,
+      artifacts,
+      artifactRecovery: true
+    });
+  }
+  if (!terminal) return void 0;
+  return createRiddleProofProfileInsufficientResult({
+    profile,
+    runner: input.runner,
+    error: `Riddle job ${input.jobId} timed out in status ${input.poll.status || "unknown"}, but artifacts were recovered without a proof result.`,
+    riddle: {
+      ...riddleMetadataFromPoll(input.jobId, input.poll),
+      status: artifactStatus ?? input.poll.status,
+      terminal,
+      artifact_recovery: true
+    },
+    artifacts
+  });
+}
 function riddleMetadataFromPoll(jobId, poll) {
   return {
     job_id: jobId,
@@ -1162,13 +1224,15 @@ function splitViewportRiddleMetadata(childRuns) {
     elapsed_ms: result.riddle?.elapsed_ms,
     attempt: result.riddle?.attempt,
     attempts: result.riddle?.attempts,
-    timed_out: result.riddle?.timed_out
+    timed_out: result.riddle?.timed_out,
+    artifact_recovery: result.riddle?.artifact_recovery
   }));
   return {
     mode: "split-viewports",
     job_count: childRuns.length,
     status: "split-viewports",
     terminal: childRuns.every(({ result }) => result.riddle?.terminal !== false),
+    artifact_recovery: childRuns.some(({ result }) => result.riddle?.artifact_recovery === true),
     queue_elapsed_ms: sumDefinedNumbers(splitJobs.map((job) => job.queue_elapsed_ms)),
     pre_submission_elapsed_ms: sumDefinedNumbers(splitJobs.map((job) => job.pre_submission_elapsed_ms)),
     elapsed_ms: sumDefinedNumbers(splitJobs.map((job) => job.elapsed_ms)),
@@ -1291,6 +1355,13 @@ async function runSingleRiddleProfileForCli(profile, options, input) {
   });
   const artifacts = collectRiddleProfileArtifactRefs(poll.artifacts);
   if (!poll.ok || !poll.terminal) {
+    const recoveredResult = await recoverProfileResultFromRiddleArtifacts(profile, {
+      client,
+      runner,
+      jobId,
+      poll
+    });
+    if (recoveredResult) return recoveredResult;
     return createRiddleProofProfileEnvironmentBlockedResult({
       profile,
       runner,