@riddledc/riddle-proof 0.7.150 → 0.7.152

package/dist/cli.cjs

@@ -15064,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}`,
@@ -15080,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";
@@ -15088,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"}`
     );
   }
@@ -15112,6 +15118,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;
@@ -15145,9 +15165,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);
@@ -15734,7 +15754,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,
@@ -15742,6 +15763,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,
@@ -15804,13 +15871,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)),
@@ -15933,6 +16002,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

@@ -16,6 +16,7 @@ import {
 } 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"}`
     );
   }
@@ -478,6 +485,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;
@@ -511,9 +532,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);
@@ -1100,7 +1121,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,
@@ -1108,6 +1130,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,
@@ -1170,13 +1238,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)),
@@ -1299,6 +1369,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/profile.d.cts

@@ -391,6 +391,7 @@ interface RiddleProofProfileResult {
         attempt?: number;
         attempts?: number;
         timed_out?: boolean;
+        artifact_recovery?: boolean;
         split_jobs?: Array<{
             viewport: string;
             job_id?: string;
@@ -402,6 +403,7 @@ interface RiddleProofProfileResult {
             attempt?: number;
             attempts?: number;
             timed_out?: boolean;
+            artifact_recovery?: boolean;
         }>;
     };
     environment_blocker?: Record<string, JsonValue>;

package/dist/profile.d.ts

@@ -391,6 +391,7 @@ interface RiddleProofProfileResult {
         attempt?: number;
         attempts?: number;
         timed_out?: boolean;
+        artifact_recovery?: boolean;
         split_jobs?: Array<{
             viewport: string;
             job_id?: string;
@@ -402,6 +403,7 @@ interface RiddleProofProfileResult {
             attempt?: number;
             attempts?: number;
             timed_out?: boolean;
+            artifact_recovery?: boolean;
         }>;
     };
     environment_blocker?: Record<string, JsonValue>;

package/package.json

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