@riddledc/riddle-proof 0.7.150 → 0.7.151

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"}`
     );
   }
@@ -15734,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,
@@ -15742,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,
@@ -15804,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)),
@@ -15933,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

@@ -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"}`
     );
   }
@@ -1100,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,
@@ -1108,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,
@@ -1170,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)),
@@ -1299,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,

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.151",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",