@riddledc/riddle-proof 0.7.151 → 0.7.153

package/dist/{chunk-M3ZTY6PQ.js → chunk-PPZ5A5MC.js}

@@ -295,12 +295,14 @@ async function pollRiddleJob(config, jobId, options = {}) {
   const attempts = Math.max(1, Math.floor(options.attempts ?? (options.wait ? 300 : 1)));
   const intervalMs = Math.max(0, Math.floor(options.intervalMs ?? 2e3));
   const progressEveryMs = Math.max(0, Math.floor(options.progressEveryMs ?? 1e4));
+  const unsubmittedTimeoutMs = Math.max(0, Math.floor(options.unsubmittedTimeoutMs ?? 0));
   const startedAt = Date.now();
   let job = null;
   let lastSnapshot = null;
   let lastProgressAt = 0;
   let lastProgressKey = "";
   let preSubmissionElapsedMs = 0;
+  let unsubmittedTimedOut = false;
   for (let index = 0; index < attempts; index += 1) {
     job = await riddleRequestJson(config, `/v1/jobs/${jobId}`);
     const observedAt = Date.now();
@@ -331,7 +333,11 @@ async function pollRiddleJob(config, jobId, options = {}) {
         await options.onProgress(lastSnapshot);
       }
     }
+    unsubmittedTimedOut = Boolean(
+      options.wait && unsubmittedTimeoutMs > 0 && lastSnapshot.running_without_submission && !lastSnapshot.created_at && !lastSnapshot.submitted_at && preSubmissionElapsedMs >= unsubmittedTimeoutMs
+    );
     if (lastSnapshot.terminal) break;
+    if (unsubmittedTimedOut) break;
     if (index + 1 < attempts) {
       await new Promise((resolve) => setTimeout(resolve, intervalMs));
     }
@@ -356,6 +362,8 @@ async function pollRiddleJob(config, jobId, options = {}) {
         ...snapshot,
         timed_out: timedOut,
         interval_ms: intervalMs,
+        unsubmitted_timeout: unsubmittedTimedOut || void 0,
+        unsubmitted_timeout_ms: unsubmittedTimedOut ? unsubmittedTimeoutMs : void 0,
         message: pollMessage(snapshot, timedOut)
       }
     };

package/dist/cli.cjs

@@ -6856,12 +6856,14 @@ async function pollRiddleJob(config, jobId, options = {}) {
   const attempts = Math.max(1, Math.floor(options.attempts ?? (options.wait ? 300 : 1)));
   const intervalMs = Math.max(0, Math.floor(options.intervalMs ?? 2e3));
   const progressEveryMs = Math.max(0, Math.floor(options.progressEveryMs ?? 1e4));
+  const unsubmittedTimeoutMs = Math.max(0, Math.floor(options.unsubmittedTimeoutMs ?? 0));
   const startedAt = Date.now();
   let job = null;
   let lastSnapshot = null;
   let lastProgressAt = 0;
   let lastProgressKey = "";
   let preSubmissionElapsedMs = 0;
+  let unsubmittedTimedOut = false;
   for (let index = 0; index < attempts; index += 1) {
     job = await riddleRequestJson(config, `/v1/jobs/${jobId}`);
     const observedAt = Date.now();
@@ -6892,7 +6894,11 @@ async function pollRiddleJob(config, jobId, options = {}) {
         await options.onProgress(lastSnapshot);
       }
     }
+    unsubmittedTimedOut = Boolean(
+      options.wait && unsubmittedTimeoutMs > 0 && lastSnapshot.running_without_submission && !lastSnapshot.created_at && !lastSnapshot.submitted_at && preSubmissionElapsedMs >= unsubmittedTimeoutMs
+    );
     if (lastSnapshot.terminal) break;
+    if (unsubmittedTimedOut) break;
     if (index + 1 < attempts) {
       await new Promise((resolve) => setTimeout(resolve, intervalMs));
     }
@@ -6917,6 +6923,8 @@ async function pollRiddleJob(config, jobId, options = {}) {
         ...snapshot,
         timed_out: timedOut,
         interval_ms: intervalMs,
+        unsubmitted_timeout: unsubmittedTimedOut || void 0,
+        unsubmitted_timeout_ms: unsubmittedTimedOut ? unsubmittedTimeoutMs : void 0,
         message: pollMessage(snapshot, timedOut)
       }
     };
@@ -14741,6 +14749,8 @@ function runProfileStrictOption(options) {
 function runProfileSplitViewportsOption(options) {
   return optionBoolean(options, "splitViewports") ?? false;
 }
+var DEFAULT_PROFILE_UNSUBMITTED_RETRY_TIMEOUT_MS = 9e4;
+var DEFAULT_PROFILE_UNSUBMITTED_RETRIES = 1;
 function optionNumber(options, ...keys) {
   for (const key of keys) {
     const value = optionString(options, key);
@@ -14748,6 +14758,11 @@ function optionNumber(options, ...keys) {
   }
   return void 0;
 }
+function optionInteger(options, fallback, ...keys) {
+  const value = optionNumber(options, ...keys);
+  if (value === void 0 || !Number.isFinite(value)) return fallback;
+  return Math.floor(value);
+}
 function profileOutputDirOption(options) {
   return optionString(options, "output") ?? optionString(options, "outputDir");
 }
@@ -15065,6 +15080,8 @@ function profileRiddleJobMarkdown(result) {
   const submittedAt = cliString(riddle.submitted_at);
   const completedAt = cliString(riddle.completed_at);
   const artifactRecovery = riddle.artifact_recovery === true;
+  const retryCount = cliFiniteNumber(riddle.retry_count);
+  const staleJobIds = Array.isArray(riddle.stale_job_ids) ? riddle.stale_job_ids.map((value) => cliString(value)).filter((value) => Boolean(value)) : [];
   const parts = [
     mode ? `mode ${markdownInlineCode(mode)}` : "",
     jobCount === void 0 ? "" : `jobs ${jobCount}`,
@@ -15084,6 +15101,9 @@ function profileRiddleJobMarkdown(result) {
   if (artifactRecovery) {
     lines.push("- artifact recovery: used artifacts endpoint after non-terminal poll");
   }
+  if (retryCount !== void 0 && retryCount > 0) {
+    lines.push(`- retry recovery: replaced ${retryCount} unsubmitted job${retryCount === 1 ? "" : "s"}${staleJobIds.length ? ` (${staleJobIds.map((value) => markdownInlineCode(value)).join(", ")})` : ""}`);
+  }
   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";
@@ -15093,6 +15113,7 @@ function profileRiddleJobMarkdown(result) {
     const splitElapsedMs = cliFiniteNumber(job.elapsed_ms);
     const splitPreSubmissionElapsedMs = cliFiniteNumber(job.pre_submission_elapsed_ms);
     const splitArtifactRecovery = job.artifact_recovery === true;
+    const splitRetryCount = cliFiniteNumber(job.retry_count);
     lines.push(
       `- ${viewport}: ${[
         splitJobId ? `job ${markdownInlineCode(splitJobId)}` : "",
@@ -15100,6 +15121,7 @@ function profileRiddleJobMarkdown(result) {
         splitTerminal === void 0 ? "" : `terminal ${splitTerminal ? "true" : "false"}`,
         splitElapsedMs === void 0 ? "" : `elapsed ${formatPollDuration(splitElapsedMs)}`,
         splitPreSubmissionElapsedMs === void 0 || splitPreSubmissionElapsedMs < 1e3 ? "" : `pre-submit ${formatPollDuration(splitPreSubmissionElapsedMs)}`,
+        splitRetryCount === void 0 || splitRetryCount <= 0 ? "" : `retries ${splitRetryCount}`,
         splitArtifactRecovery ? "artifact recovery" : ""
       ].filter(Boolean).join(", ") || "job metadata unavailable"}`
     );
@@ -15118,6 +15140,20 @@ function profileCheckTextTarget(evidence) {
   const pattern = cliString(evidence.pattern);
   return pattern ? `pattern ${markdownInlineCode(pattern)}` : void 0;
 }
+function observeWithinMarkdownReceipt(evidence) {
+  const viewports = Array.isArray(evidence.viewports) ? evidence.viewports.map(cliRecord).filter((viewport) => Boolean(viewport)) : [];
+  if (!viewports.length) return void 0;
+  const receipts = viewports.slice(0, 4).map((viewport) => {
+    const name = cliString(viewport.viewport) || cliString(viewport.name) || "viewport";
+    const matched = viewport.matched === true ? "matched" : viewport.matched === false ? "missed" : "observed";
+    const elapsedMs3 = cliFiniteNumber(viewport.elapsed_ms);
+    const attempts = cliFiniteNumber(viewport.attempts);
+    const sample = cliString(viewport.sample);
+    return `${name} ${matched}${elapsedMs3 === void 0 ? "" : ` in ${elapsedMs3}ms`}${attempts === void 0 ? "" : `, ${attempts} attempt${attempts === 1 ? "" : "s"}`}${sample ? `, sample ${markdownInlineCode(sample, 70)}` : ""}`;
+  });
+  if (viewports.length > receipts.length) receipts.push(`${viewports.length - receipts.length} more viewport${viewports.length - receipts.length === 1 ? "" : "s"}`);
+  return receipts.join("; ");
+}
 function profileCheckMarkdownTarget(check) {
   const evidence = cliRecord(check.evidence);
   if (!evidence) return void 0;
@@ -15151,9 +15187,9 @@ function profileCheckMarkdownTarget(check) {
     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;
+    const receipt = observeWithinMarkdownReceipt(evidence);
+    const base = selector && textTarget ? `${markdownInlineCode(selector)} observes ${textTarget} ${withinLabel}` : selector ? `${markdownInlineCode(selector)} visible ${withinLabel}` : textTarget ? `${textTarget} ${withinLabel}` : withinLabel;
+    return receipt ? `${base}; ${receipt}` : base;
   }
   if (check.type === "text_visible" || check.type === "text_absent") {
     return profileCheckTextTarget(evidence);
@@ -15725,6 +15761,7 @@ async function profileResultFromRiddleArtifacts(profile, artifacts, fallbackInpu
 }
 function withRiddleMetadata(result, input) {
   const poll = input.poll;
+  const staleJobIds = input.staleJobIds?.filter(Boolean);
   return {
     ...result,
     riddle: {
@@ -15741,6 +15778,8 @@ function withRiddleMetadata(result, input) {
       attempt: poll?.attempt ?? result.riddle?.attempt,
       attempts: poll?.attempts ?? result.riddle?.attempts,
       timed_out: poll?.timed_out ?? result.riddle?.timed_out,
+      retry_count: input.retryCount ?? result.riddle?.retry_count,
+      stale_job_ids: staleJobIds?.length ? staleJobIds : result.riddle?.stale_job_ids,
       artifact_recovery: input.artifactRecovery ?? result.riddle?.artifact_recovery
     },
     artifacts: {
@@ -15811,6 +15850,40 @@ function riddleMetadataFromPoll(jobId, poll) {
     timed_out: poll.poll?.timed_out
   };
 }
+function profileUnsubmittedRetryTimeoutMs(options) {
+  return Math.max(0, optionInteger(
+    options,
+    DEFAULT_PROFILE_UNSUBMITTED_RETRY_TIMEOUT_MS,
+    "unsubmittedTimeoutMs",
+    "unsubmittedJobTimeoutMs",
+    "submitTimeoutMs"
+  ));
+}
+function profileUnsubmittedRetryLimit(options) {
+  return Math.max(0, optionInteger(
+    options,
+    DEFAULT_PROFILE_UNSUBMITTED_RETRIES,
+    "unsubmittedRetries",
+    "unsubmittedJobRetries",
+    "submitRetries"
+  ));
+}
+function shouldRetryUnsubmittedRiddleJob(poll) {
+  return poll.terminal !== true && poll.poll?.unsubmitted_timeout === true && !poll.poll.created_at && !poll.poll.submitted_at;
+}
+function riddlePollOptionsForProfile(options) {
+  return {
+    wait: true,
+    attempts: optionNumber(options, "pollAttempts", "attempts"),
+    intervalMs: optionNumber(options, "intervalMs"),
+    progressEveryMs: optionNumber(options, "progressEveryMs"),
+    unsubmittedTimeoutMs: profileUnsubmittedRetryTimeoutMs(options),
+    onProgress: options.quiet !== true ? (snapshot) => {
+      process.stderr.write(`${riddlePollProgressLine(snapshot)}
+`);
+    } : void 0
+  };
+}
 function profileForSplitViewport(profile, viewport) {
   return {
     ...profile,
@@ -15858,6 +15931,8 @@ function splitViewportRiddleMetadata(childRuns) {
     attempt: result.riddle?.attempt,
     attempts: result.riddle?.attempts,
     timed_out: result.riddle?.timed_out,
+    retry_count: result.riddle?.retry_count,
+    stale_job_ids: result.riddle?.stale_job_ids,
     artifact_recovery: result.riddle?.artifact_recovery
   }));
   return {
@@ -15869,6 +15944,8 @@ function splitViewportRiddleMetadata(childRuns) {
     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)),
+    retry_count: splitJobs.reduce((sum, job) => sum + (typeof job.retry_count === "number" && Number.isFinite(job.retry_count) ? job.retry_count : 0), 0),
+    stale_job_ids: splitJobs.flatMap((job) => Array.isArray(job.stale_job_ids) ? job.stale_job_ids : []),
     split_jobs: splitJobs
   };
 }
@@ -15956,37 +16033,48 @@ async function runSingleRiddleProfileForCli(profile, options, input) {
   const { client, runner } = input;
   const targetUrl = resolveRiddleProofProfileTargetUrl(profile);
   let created;
-  try {
-    created = await client.runScript({
-      url: targetUrl,
-      script: buildRiddleProofProfileScript(profile),
-      viewport: profile.target.viewports[0],
-      timeoutSec: resolveRiddleProofProfileTimeoutSec(
-        profile,
-        optionString(options, "timeout") ? Number(optionString(options, "timeout")) : void 0
-      ),
-      strict: runProfileStrictOption(options),
-      sync: options.sync === true ? true : void 0
-    });
-  } catch (error) {
-    return createRiddleProofProfileEnvironmentBlockedResult({ profile, runner, error });
+  let poll;
+  let jobId = "";
+  const staleJobIds = [];
+  const retryLimit = profileUnsubmittedRetryLimit(options);
+  const pollOptions = riddlePollOptionsForProfile(options);
+  for (let attempt = 0; attempt <= retryLimit; attempt += 1) {
+    try {
+      created = await client.runScript({
+        url: targetUrl,
+        script: buildRiddleProofProfileScript(profile),
+        viewport: profile.target.viewports[0],
+        timeoutSec: resolveRiddleProofProfileTimeoutSec(
+          profile,
+          optionString(options, "timeout") ? Number(optionString(options, "timeout")) : void 0
+        ),
+        strict: runProfileStrictOption(options),
+        sync: options.sync === true ? true : void 0
+      });
+    } catch (error) {
+      return createRiddleProofProfileEnvironmentBlockedResult({ profile, runner, error });
+    }
+    jobId = typeof created.job_id === "string" ? created.job_id : typeof created.id === "string" ? created.id : "";
+    if (!jobId) {
+      const directResult = extractRiddleProofProfileResult(created);
+      return directResult ? withRiddleMetadata(directResult, { artifacts: collectRiddleProfileArtifactRefs(created) }) : createRiddleProofProfileInsufficientResult({ profile, runner, error: "Riddle run response was missing job_id.", artifacts: collectRiddleProfileArtifactRefs(created) });
+    }
+    poll = await client.pollJob(jobId, pollOptions);
+    if (attempt < retryLimit && shouldRetryUnsubmittedRiddleJob(poll)) {
+      staleJobIds.push(jobId);
+      if (options.quiet !== true) {
+        process.stderr.write(`[riddle-poll] ${jobId} stayed unsubmitted for ${formatPollDuration(poll.poll?.pre_submission_elapsed_ms)}; retrying hosted run ${attempt + 1}/${retryLimit}
+`);
+      }
+      continue;
+    }
+    break;
   }
-  const jobId = typeof created.job_id === "string" ? created.job_id : typeof created.id === "string" ? created.id : "";
-  if (!jobId) {
-    const directResult = extractRiddleProofProfileResult(created);
-    return directResult ? withRiddleMetadata(directResult, { artifacts: collectRiddleProfileArtifactRefs(created) }) : createRiddleProofProfileInsufficientResult({ profile, runner, error: "Riddle run response was missing job_id.", artifacts: collectRiddleProfileArtifactRefs(created) });
+  if (!poll) {
+    return createRiddleProofProfileEnvironmentBlockedResult({ profile, runner, error: "Riddle job polling did not produce a result." });
   }
-  const poll = await client.pollJob(jobId, {
-    wait: true,
-    attempts: optionNumber(options, "pollAttempts", "attempts"),
-    intervalMs: optionNumber(options, "intervalMs"),
-    progressEveryMs: optionNumber(options, "progressEveryMs"),
-    onProgress: options.quiet !== true ? (snapshot) => {
-      process.stderr.write(`${riddlePollProgressLine(snapshot)}
-`);
-    } : void 0
-  });
   const artifacts = collectRiddleProfileArtifactRefs(poll.artifacts);
+  const retryCount = staleJobIds.length || void 0;
   if (!poll.ok || !poll.terminal) {
     const recoveredResult = await recoverProfileResultFromRiddleArtifacts(profile, {
       client,
@@ -15994,12 +16082,18 @@ async function runSingleRiddleProfileForCli(profile, options, input) {
       jobId,
       poll
     });
-    if (recoveredResult) return recoveredResult;
+    if (recoveredResult) {
+      return withRiddleMetadata(recoveredResult, { retryCount, staleJobIds });
+    }
     return createRiddleProofProfileEnvironmentBlockedResult({
       profile,
       runner,
       error: `Riddle job ${jobId} ended with status ${poll.status || "unknown"}.`,
-      riddle: riddleMetadataFromPoll(jobId, poll),
+      riddle: {
+        ...riddleMetadataFromPoll(jobId, poll),
+        retry_count: retryCount,
+        stale_job_ids: staleJobIds.length ? staleJobIds : void 0
+      },
       artifacts
     });
   }
@@ -16017,7 +16111,9 @@ async function runSingleRiddleProfileForCli(profile, options, input) {
     status: poll.status,
     terminal: poll.terminal,
     poll: poll.poll,
-    artifacts
+    artifacts,
+    retryCount,
+    staleJobIds
   });
 }
 async function runSplitViewportProfileForCli(profile, options, input) {

package/dist/cli.js

@@ -18,7 +18,7 @@ import {
   createRiddleApiClient,
   isTerminalRiddleJobStatus,
   parseRiddleViewport
-} from "./chunk-M3ZTY6PQ.js";
+} from "./chunk-PPZ5A5MC.js";
 import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
@@ -108,6 +108,8 @@ function runProfileStrictOption(options) {
 function runProfileSplitViewportsOption(options) {
   return optionBoolean(options, "splitViewports") ?? false;
 }
+var DEFAULT_PROFILE_UNSUBMITTED_RETRY_TIMEOUT_MS = 9e4;
+var DEFAULT_PROFILE_UNSUBMITTED_RETRIES = 1;
 function optionNumber(options, ...keys) {
   for (const key of keys) {
     const value = optionString(options, key);
@@ -115,6 +117,11 @@ function optionNumber(options, ...keys) {
   }
   return void 0;
 }
+function optionInteger(options, fallback, ...keys) {
+  const value = optionNumber(options, ...keys);
+  if (value === void 0 || !Number.isFinite(value)) return fallback;
+  return Math.floor(value);
+}
 function profileOutputDirOption(options) {
   return optionString(options, "output") ?? optionString(options, "outputDir");
 }
@@ -432,6 +439,8 @@ function profileRiddleJobMarkdown(result) {
   const submittedAt = cliString(riddle.submitted_at);
   const completedAt = cliString(riddle.completed_at);
   const artifactRecovery = riddle.artifact_recovery === true;
+  const retryCount = cliFiniteNumber(riddle.retry_count);
+  const staleJobIds = Array.isArray(riddle.stale_job_ids) ? riddle.stale_job_ids.map((value) => cliString(value)).filter((value) => Boolean(value)) : [];
   const parts = [
     mode ? `mode ${markdownInlineCode(mode)}` : "",
     jobCount === void 0 ? "" : `jobs ${jobCount}`,
@@ -451,6 +460,9 @@ function profileRiddleJobMarkdown(result) {
   if (artifactRecovery) {
     lines.push("- artifact recovery: used artifacts endpoint after non-terminal poll");
   }
+  if (retryCount !== void 0 && retryCount > 0) {
+    lines.push(`- retry recovery: replaced ${retryCount} unsubmitted job${retryCount === 1 ? "" : "s"}${staleJobIds.length ? ` (${staleJobIds.map((value) => markdownInlineCode(value)).join(", ")})` : ""}`);
+  }
   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";
@@ -460,6 +472,7 @@ function profileRiddleJobMarkdown(result) {
     const splitElapsedMs = cliFiniteNumber(job.elapsed_ms);
     const splitPreSubmissionElapsedMs = cliFiniteNumber(job.pre_submission_elapsed_ms);
     const splitArtifactRecovery = job.artifact_recovery === true;
+    const splitRetryCount = cliFiniteNumber(job.retry_count);
     lines.push(
       `- ${viewport}: ${[
         splitJobId ? `job ${markdownInlineCode(splitJobId)}` : "",
@@ -467,6 +480,7 @@ function profileRiddleJobMarkdown(result) {
         splitTerminal === void 0 ? "" : `terminal ${splitTerminal ? "true" : "false"}`,
         splitElapsedMs === void 0 ? "" : `elapsed ${formatPollDuration(splitElapsedMs)}`,
         splitPreSubmissionElapsedMs === void 0 || splitPreSubmissionElapsedMs < 1e3 ? "" : `pre-submit ${formatPollDuration(splitPreSubmissionElapsedMs)}`,
+        splitRetryCount === void 0 || splitRetryCount <= 0 ? "" : `retries ${splitRetryCount}`,
         splitArtifactRecovery ? "artifact recovery" : ""
       ].filter(Boolean).join(", ") || "job metadata unavailable"}`
     );
@@ -485,6 +499,20 @@ function profileCheckTextTarget(evidence) {
   const pattern = cliString(evidence.pattern);
   return pattern ? `pattern ${markdownInlineCode(pattern)}` : void 0;
 }
+function observeWithinMarkdownReceipt(evidence) {
+  const viewports = Array.isArray(evidence.viewports) ? evidence.viewports.map(cliRecord).filter((viewport) => Boolean(viewport)) : [];
+  if (!viewports.length) return void 0;
+  const receipts = viewports.slice(0, 4).map((viewport) => {
+    const name = cliString(viewport.viewport) || cliString(viewport.name) || "viewport";
+    const matched = viewport.matched === true ? "matched" : viewport.matched === false ? "missed" : "observed";
+    const elapsedMs = cliFiniteNumber(viewport.elapsed_ms);
+    const attempts = cliFiniteNumber(viewport.attempts);
+    const sample = cliString(viewport.sample);
+    return `${name} ${matched}${elapsedMs === void 0 ? "" : ` in ${elapsedMs}ms`}${attempts === void 0 ? "" : `, ${attempts} attempt${attempts === 1 ? "" : "s"}`}${sample ? `, sample ${markdownInlineCode(sample, 70)}` : ""}`;
+  });
+  if (viewports.length > receipts.length) receipts.push(`${viewports.length - receipts.length} more viewport${viewports.length - receipts.length === 1 ? "" : "s"}`);
+  return receipts.join("; ");
+}
 function profileCheckMarkdownTarget(check) {
   const evidence = cliRecord(check.evidence);
   if (!evidence) return void 0;
@@ -518,9 +546,9 @@ function profileCheckMarkdownTarget(check) {
     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;
+    const receipt = observeWithinMarkdownReceipt(evidence);
+    const base = selector && textTarget ? `${markdownInlineCode(selector)} observes ${textTarget} ${withinLabel}` : selector ? `${markdownInlineCode(selector)} visible ${withinLabel}` : textTarget ? `${textTarget} ${withinLabel}` : withinLabel;
+    return receipt ? `${base}; ${receipt}` : base;
   }
   if (check.type === "text_visible" || check.type === "text_absent") {
     return profileCheckTextTarget(evidence);
@@ -1092,6 +1120,7 @@ async function profileResultFromRiddleArtifacts(profile, artifacts, fallbackInpu
 }
 function withRiddleMetadata(result, input) {
   const poll = input.poll;
+  const staleJobIds = input.staleJobIds?.filter(Boolean);
   return {
     ...result,
     riddle: {
@@ -1108,6 +1137,8 @@ function withRiddleMetadata(result, input) {
       attempt: poll?.attempt ?? result.riddle?.attempt,
       attempts: poll?.attempts ?? result.riddle?.attempts,
       timed_out: poll?.timed_out ?? result.riddle?.timed_out,
+      retry_count: input.retryCount ?? result.riddle?.retry_count,
+      stale_job_ids: staleJobIds?.length ? staleJobIds : result.riddle?.stale_job_ids,
       artifact_recovery: input.artifactRecovery ?? result.riddle?.artifact_recovery
     },
     artifacts: {
@@ -1178,6 +1209,40 @@ function riddleMetadataFromPoll(jobId, poll) {
     timed_out: poll.poll?.timed_out
   };
 }
+function profileUnsubmittedRetryTimeoutMs(options) {
+  return Math.max(0, optionInteger(
+    options,
+    DEFAULT_PROFILE_UNSUBMITTED_RETRY_TIMEOUT_MS,
+    "unsubmittedTimeoutMs",
+    "unsubmittedJobTimeoutMs",
+    "submitTimeoutMs"
+  ));
+}
+function profileUnsubmittedRetryLimit(options) {
+  return Math.max(0, optionInteger(
+    options,
+    DEFAULT_PROFILE_UNSUBMITTED_RETRIES,
+    "unsubmittedRetries",
+    "unsubmittedJobRetries",
+    "submitRetries"
+  ));
+}
+function shouldRetryUnsubmittedRiddleJob(poll) {
+  return poll.terminal !== true && poll.poll?.unsubmitted_timeout === true && !poll.poll.created_at && !poll.poll.submitted_at;
+}
+function riddlePollOptionsForProfile(options) {
+  return {
+    wait: true,
+    attempts: optionNumber(options, "pollAttempts", "attempts"),
+    intervalMs: optionNumber(options, "intervalMs"),
+    progressEveryMs: optionNumber(options, "progressEveryMs"),
+    unsubmittedTimeoutMs: profileUnsubmittedRetryTimeoutMs(options),
+    onProgress: options.quiet !== true ? (snapshot) => {
+      process.stderr.write(`${riddlePollProgressLine(snapshot)}
+`);
+    } : void 0
+  };
+}
 function profileForSplitViewport(profile, viewport) {
   return {
     ...profile,
@@ -1225,6 +1290,8 @@ function splitViewportRiddleMetadata(childRuns) {
     attempt: result.riddle?.attempt,
     attempts: result.riddle?.attempts,
     timed_out: result.riddle?.timed_out,
+    retry_count: result.riddle?.retry_count,
+    stale_job_ids: result.riddle?.stale_job_ids,
     artifact_recovery: result.riddle?.artifact_recovery
   }));
   return {
@@ -1236,6 +1303,8 @@ function splitViewportRiddleMetadata(childRuns) {
     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)),
+    retry_count: splitJobs.reduce((sum, job) => sum + (typeof job.retry_count === "number" && Number.isFinite(job.retry_count) ? job.retry_count : 0), 0),
+    stale_job_ids: splitJobs.flatMap((job) => Array.isArray(job.stale_job_ids) ? job.stale_job_ids : []),
     split_jobs: splitJobs
   };
 }
@@ -1323,37 +1392,48 @@ async function runSingleRiddleProfileForCli(profile, options, input) {
   const { client, runner } = input;
   const targetUrl = resolveRiddleProofProfileTargetUrl(profile);
   let created;
-  try {
-    created = await client.runScript({
-      url: targetUrl,
-      script: buildRiddleProofProfileScript(profile),
-      viewport: profile.target.viewports[0],
-      timeoutSec: resolveRiddleProofProfileTimeoutSec(
-        profile,
-        optionString(options, "timeout") ? Number(optionString(options, "timeout")) : void 0
-      ),
-      strict: runProfileStrictOption(options),
-      sync: options.sync === true ? true : void 0
-    });
-  } catch (error) {
-    return createRiddleProofProfileEnvironmentBlockedResult({ profile, runner, error });
+  let poll;
+  let jobId = "";
+  const staleJobIds = [];
+  const retryLimit = profileUnsubmittedRetryLimit(options);
+  const pollOptions = riddlePollOptionsForProfile(options);
+  for (let attempt = 0; attempt <= retryLimit; attempt += 1) {
+    try {
+      created = await client.runScript({
+        url: targetUrl,
+        script: buildRiddleProofProfileScript(profile),
+        viewport: profile.target.viewports[0],
+        timeoutSec: resolveRiddleProofProfileTimeoutSec(
+          profile,
+          optionString(options, "timeout") ? Number(optionString(options, "timeout")) : void 0
+        ),
+        strict: runProfileStrictOption(options),
+        sync: options.sync === true ? true : void 0
+      });
+    } catch (error) {
+      return createRiddleProofProfileEnvironmentBlockedResult({ profile, runner, error });
+    }
+    jobId = typeof created.job_id === "string" ? created.job_id : typeof created.id === "string" ? created.id : "";
+    if (!jobId) {
+      const directResult = extractRiddleProofProfileResult(created);
+      return directResult ? withRiddleMetadata(directResult, { artifacts: collectRiddleProfileArtifactRefs(created) }) : createRiddleProofProfileInsufficientResult({ profile, runner, error: "Riddle run response was missing job_id.", artifacts: collectRiddleProfileArtifactRefs(created) });
+    }
+    poll = await client.pollJob(jobId, pollOptions);
+    if (attempt < retryLimit && shouldRetryUnsubmittedRiddleJob(poll)) {
+      staleJobIds.push(jobId);
+      if (options.quiet !== true) {
+        process.stderr.write(`[riddle-poll] ${jobId} stayed unsubmitted for ${formatPollDuration(poll.poll?.pre_submission_elapsed_ms)}; retrying hosted run ${attempt + 1}/${retryLimit}
+`);
+      }
+      continue;
+    }
+    break;
   }
-  const jobId = typeof created.job_id === "string" ? created.job_id : typeof created.id === "string" ? created.id : "";
-  if (!jobId) {
-    const directResult = extractRiddleProofProfileResult(created);
-    return directResult ? withRiddleMetadata(directResult, { artifacts: collectRiddleProfileArtifactRefs(created) }) : createRiddleProofProfileInsufficientResult({ profile, runner, error: "Riddle run response was missing job_id.", artifacts: collectRiddleProfileArtifactRefs(created) });
+  if (!poll) {
+    return createRiddleProofProfileEnvironmentBlockedResult({ profile, runner, error: "Riddle job polling did not produce a result." });
   }
-  const poll = await client.pollJob(jobId, {
-    wait: true,
-    attempts: optionNumber(options, "pollAttempts", "attempts"),
-    intervalMs: optionNumber(options, "intervalMs"),
-    progressEveryMs: optionNumber(options, "progressEveryMs"),
-    onProgress: options.quiet !== true ? (snapshot) => {
-      process.stderr.write(`${riddlePollProgressLine(snapshot)}
-`);
-    } : void 0
-  });
   const artifacts = collectRiddleProfileArtifactRefs(poll.artifacts);
+  const retryCount = staleJobIds.length || void 0;
   if (!poll.ok || !poll.terminal) {
     const recoveredResult = await recoverProfileResultFromRiddleArtifacts(profile, {
       client,
@@ -1361,12 +1441,18 @@ async function runSingleRiddleProfileForCli(profile, options, input) {
       jobId,
       poll
     });
-    if (recoveredResult) return recoveredResult;
+    if (recoveredResult) {
+      return withRiddleMetadata(recoveredResult, { retryCount, staleJobIds });
+    }
     return createRiddleProofProfileEnvironmentBlockedResult({
       profile,
       runner,
       error: `Riddle job ${jobId} ended with status ${poll.status || "unknown"}.`,
-      riddle: riddleMetadataFromPoll(jobId, poll),
+      riddle: {
+        ...riddleMetadataFromPoll(jobId, poll),
+        retry_count: retryCount,
+        stale_job_ids: staleJobIds.length ? staleJobIds : void 0
+      },
       artifacts
     });
   }
@@ -1384,7 +1470,9 @@ async function runSingleRiddleProfileForCli(profile, options, input) {
     status: poll.status,
     terminal: poll.terminal,
     poll: poll.poll,
-    artifacts
+    artifacts,
+    retryCount,
+    staleJobIds
   });
 }
 async function runSplitViewportProfileForCli(profile, options, input) {

package/dist/index.cjs

@@ -16769,12 +16769,14 @@ async function pollRiddleJob(config, jobId, options = {}) {
   const attempts = Math.max(1, Math.floor(options.attempts ?? (options.wait ? 300 : 1)));
   const intervalMs = Math.max(0, Math.floor(options.intervalMs ?? 2e3));
   const progressEveryMs = Math.max(0, Math.floor(options.progressEveryMs ?? 1e4));
+  const unsubmittedTimeoutMs = Math.max(0, Math.floor(options.unsubmittedTimeoutMs ?? 0));
   const startedAt = Date.now();
   let job = null;
   let lastSnapshot = null;
   let lastProgressAt = 0;
   let lastProgressKey = "";
   let preSubmissionElapsedMs = 0;
+  let unsubmittedTimedOut = false;
   for (let index = 0; index < attempts; index += 1) {
     job = await riddleRequestJson(config, `/v1/jobs/${jobId}`);
     const observedAt = Date.now();
@@ -16805,7 +16807,11 @@ async function pollRiddleJob(config, jobId, options = {}) {
         await options.onProgress(lastSnapshot);
       }
     }
+    unsubmittedTimedOut = Boolean(
+      options.wait && unsubmittedTimeoutMs > 0 && lastSnapshot.running_without_submission && !lastSnapshot.created_at && !lastSnapshot.submitted_at && preSubmissionElapsedMs >= unsubmittedTimeoutMs
+    );
     if (lastSnapshot.terminal) break;
+    if (unsubmittedTimedOut) break;
     if (index + 1 < attempts) {
       await new Promise((resolve) => setTimeout(resolve, intervalMs));
     }
@@ -16830,6 +16836,8 @@ async function pollRiddleJob(config, jobId, options = {}) {
         ...snapshot,
         timed_out: timedOut,
         interval_ms: intervalMs,
+        unsubmitted_timeout: unsubmittedTimedOut || void 0,
+        unsubmitted_timeout_ms: unsubmittedTimedOut ? unsubmittedTimeoutMs : void 0,
         message: pollMessage(snapshot, timedOut)
       }
     };

package/dist/index.js

@@ -77,7 +77,7 @@ import {
   riddleRequestJson,
   runRiddleScript,
   runRiddleServerPreview
-} from "./chunk-M3ZTY6PQ.js";
+} from "./chunk-PPZ5A5MC.js";
 import {
   DEFAULT_DIAGNOSTIC_ARRAY_LIMIT,
   DEFAULT_DIAGNOSTIC_HISTORY_LIMIT,

package/dist/profile.d.cts

@@ -391,6 +391,8 @@ interface RiddleProofProfileResult {
         attempt?: number;
         attempts?: number;
         timed_out?: boolean;
+        retry_count?: number;
+        stale_job_ids?: string[];
         artifact_recovery?: boolean;
         split_jobs?: Array<{
             viewport: string;
@@ -403,6 +405,8 @@ interface RiddleProofProfileResult {
             attempt?: number;
             attempts?: number;
             timed_out?: boolean;
+            retry_count?: number;
+            stale_job_ids?: string[];
             artifact_recovery?: boolean;
         }>;
     };

package/dist/profile.d.ts

@@ -391,6 +391,8 @@ interface RiddleProofProfileResult {
         attempt?: number;
         attempts?: number;
         timed_out?: boolean;
+        retry_count?: number;
+        stale_job_ids?: string[];
         artifact_recovery?: boolean;
         split_jobs?: Array<{
             viewport: string;
@@ -403,6 +405,8 @@ interface RiddleProofProfileResult {
             attempt?: number;
             attempts?: number;
             timed_out?: boolean;
+            retry_count?: number;
+            stale_job_ids?: string[];
             artifact_recovery?: boolean;
         }>;
     };

package/dist/riddle-client.cjs

@@ -341,12 +341,14 @@ async function pollRiddleJob(config, jobId, options = {}) {
   const attempts = Math.max(1, Math.floor(options.attempts ?? (options.wait ? 300 : 1)));
   const intervalMs = Math.max(0, Math.floor(options.intervalMs ?? 2e3));
   const progressEveryMs = Math.max(0, Math.floor(options.progressEveryMs ?? 1e4));
+  const unsubmittedTimeoutMs = Math.max(0, Math.floor(options.unsubmittedTimeoutMs ?? 0));
   const startedAt = Date.now();
   let job = null;
   let lastSnapshot = null;
   let lastProgressAt = 0;
   let lastProgressKey = "";
   let preSubmissionElapsedMs = 0;
+  let unsubmittedTimedOut = false;
   for (let index = 0; index < attempts; index += 1) {
     job = await riddleRequestJson(config, `/v1/jobs/${jobId}`);
     const observedAt = Date.now();
@@ -377,7 +379,11 @@ async function pollRiddleJob(config, jobId, options = {}) {
         await options.onProgress(lastSnapshot);
       }
     }
+    unsubmittedTimedOut = Boolean(
+      options.wait && unsubmittedTimeoutMs > 0 && lastSnapshot.running_without_submission && !lastSnapshot.created_at && !lastSnapshot.submitted_at && preSubmissionElapsedMs >= unsubmittedTimeoutMs
+    );
     if (lastSnapshot.terminal) break;
+    if (unsubmittedTimedOut) break;
     if (index + 1 < attempts) {
       await new Promise((resolve) => setTimeout(resolve, intervalMs));
     }
@@ -402,6 +408,8 @@ async function pollRiddleJob(config, jobId, options = {}) {
         ...snapshot,
         timed_out: timedOut,
         interval_ms: intervalMs,
+        unsubmitted_timeout: unsubmittedTimedOut || void 0,
+        unsubmitted_timeout_ms: unsubmittedTimedOut ? unsubmittedTimeoutMs : void 0,
         message: pollMessage(snapshot, timedOut)
       }
     };

package/dist/riddle-client.d.cts

@@ -24,6 +24,8 @@ interface RiddlePollProgressSnapshot {
 interface RiddlePollSummary extends RiddlePollProgressSnapshot {
     timed_out: boolean;
     interval_ms: number;
+    unsubmitted_timeout?: boolean;
+    unsubmitted_timeout_ms?: number;
     message?: string;
 }
 interface RiddlePollJobOptions {
@@ -31,6 +33,7 @@ interface RiddlePollJobOptions {
     attempts?: number;
     intervalMs?: number;
     progressEveryMs?: number;
+    unsubmittedTimeoutMs?: number;
     onProgress?: (snapshot: RiddlePollProgressSnapshot) => void | Promise<void>;
 }
 type RiddlePreviewFramework = "spa" | "static";

package/dist/riddle-client.d.ts

@@ -24,6 +24,8 @@ interface RiddlePollProgressSnapshot {
 interface RiddlePollSummary extends RiddlePollProgressSnapshot {
     timed_out: boolean;
     interval_ms: number;
+    unsubmitted_timeout?: boolean;
+    unsubmitted_timeout_ms?: number;
     message?: string;
 }
 interface RiddlePollJobOptions {
@@ -31,6 +33,7 @@ interface RiddlePollJobOptions {
     attempts?: number;
     intervalMs?: number;
     progressEveryMs?: number;
+    unsubmittedTimeoutMs?: number;
     onProgress?: (snapshot: RiddlePollProgressSnapshot) => void | Promise<void>;
 }
 type RiddlePreviewFramework = "spa" | "static";

package/dist/riddle-client.js

@@ -12,7 +12,7 @@ import {
   riddleRequestJson,
   runRiddleScript,
   runRiddleServerPreview
-} from "./chunk-M3ZTY6PQ.js";
+} from "./chunk-PPZ5A5MC.js";
 export {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/package.json

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