@riddledc/riddle-proof 0.7.86 → 0.7.88

package/dist/{chunk-3Y35UIZO.js → chunk-CEBHV23V.js}

@@ -1703,6 +1703,7 @@ function createRiddleProofProfileConfigurationError(name, error, runner = "riddl
 }
 function createRiddleProofProfileEnvironmentBlockedResult(input) {
   const message = input.error instanceof Error ? input.error.message : input.error ? String(input.error) : "Riddle runner did not complete successfully.";
+  const environmentBlocker = extractRiddleRunnerBlocker(message);
   return {
     version: RIDDLE_PROOF_PROFILE_RESULT_VERSION,
     profile_name: input.profile.name,
@@ -1712,12 +1713,64 @@ function createRiddleProofProfileEnvironmentBlockedResult(input) {
     route: { requested: resolveRiddleProofProfileTargetUrl(input.profile), observed: "", matched: false, error: message },
     artifacts: { screenshots: [], proof_json: "proof.json", riddle_artifacts: input.artifacts },
     checks: [],
-    summary: `${input.profile.name} could not collect reliable evidence because the runner was blocked.`,
+    summary: summarizeEnvironmentBlockedRunner(input.profile.name, environmentBlocker),
     captured_at: (/* @__PURE__ */ new Date()).toISOString(),
     riddle: input.riddle,
+    environment_blocker: environmentBlocker,
     error: message
   };
 }
+function extractRiddleRunnerBlocker(message) {
+  const apiError = message.match(/^Riddle API\s+(\S+)\s+failed HTTP\s+(\d+):\s+(\{[\s\S]*\})$/);
+  if (!apiError) return void 0;
+  const details = {
+    source: "riddle_api",
+    endpoint: apiError[1],
+    http_status: Number(apiError[2])
+  };
+  let payload;
+  try {
+    const parsed = JSON.parse(apiError[3]);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      payload = parsed;
+    }
+  } catch {
+    payload = void 0;
+  }
+  const copyScalar = (key) => {
+    const value = payload?.[key];
+    if (typeof value === "string" || typeof value === "boolean") details[key] = value;
+    if (typeof value === "number" && Number.isFinite(value)) details[key] = value;
+  };
+  for (const key of ["error", "required_seconds", "available_seconds", "deficit_seconds", "minimum_purchase_dollars"]) {
+    copyScalar(key);
+  }
+  const httpStatus = typeof details.http_status === "number" ? details.http_status : void 0;
+  const errorText = typeof details.error === "string" ? details.error.toLowerCase() : "";
+  if (httpStatus === 402 && errorText.includes("balance")) {
+    details.reason = "insufficient_balance";
+  }
+  return details;
+}
+function summarizeEnvironmentBlockedRunner(profileName, blocker) {
+  if (blocker?.reason === "insufficient_balance") {
+    const required = typeof blocker.required_seconds === "number" ? blocker.required_seconds : void 0;
+    const available = typeof blocker.available_seconds === "number" ? blocker.available_seconds : void 0;
+    const deficit = typeof blocker.deficit_seconds === "number" ? blocker.deficit_seconds : void 0;
+    const parts = [
+      required === void 0 ? "" : `required ${required}s`,
+      available === void 0 ? "" : `available ${available}s`,
+      deficit === void 0 ? "" : `deficit ${deficit}s`
+    ].filter(Boolean);
+    return `${profileName} could not start because Riddle balance was insufficient${parts.length ? ` (${parts.join(", ")})` : ""}.`;
+  }
+  if (blocker?.source === "riddle_api") {
+    const endpoint = typeof blocker.endpoint === "string" ? blocker.endpoint : "Riddle API";
+    const status = typeof blocker.http_status === "number" ? blocker.http_status : void 0;
+    return `${profileName} could not start because ${endpoint} returned${status === void 0 ? "" : ` HTTP ${status}`}.`;
+  }
+  return `${profileName} could not collect reliable evidence because the runner was blocked.`;
+}
 function createRiddleProofProfileInsufficientResult(input) {
   const message = input.error instanceof Error ? input.error.message : input.error ? String(input.error) : "No proof.json profile result artifact was found.";
   return {

package/dist/cli.cjs

@@ -8574,6 +8574,7 @@ function profileStatusExitCode(profile, status) {
 }
 function createRiddleProofProfileEnvironmentBlockedResult(input) {
   const message = input.error instanceof Error ? input.error.message : input.error ? String(input.error) : "Riddle runner did not complete successfully.";
+  const environmentBlocker = extractRiddleRunnerBlocker(message);
   return {
     version: RIDDLE_PROOF_PROFILE_RESULT_VERSION,
     profile_name: input.profile.name,
@@ -8583,12 +8584,64 @@ function createRiddleProofProfileEnvironmentBlockedResult(input) {
     route: { requested: resolveRiddleProofProfileTargetUrl(input.profile), observed: "", matched: false, error: message },
     artifacts: { screenshots: [], proof_json: "proof.json", riddle_artifacts: input.artifacts },
     checks: [],
-    summary: `${input.profile.name} could not collect reliable evidence because the runner was blocked.`,
+    summary: summarizeEnvironmentBlockedRunner(input.profile.name, environmentBlocker),
     captured_at: (/* @__PURE__ */ new Date()).toISOString(),
     riddle: input.riddle,
+    environment_blocker: environmentBlocker,
     error: message
   };
 }
+function extractRiddleRunnerBlocker(message) {
+  const apiError = message.match(/^Riddle API\s+(\S+)\s+failed HTTP\s+(\d+):\s+(\{[\s\S]*\})$/);
+  if (!apiError) return void 0;
+  const details = {
+    source: "riddle_api",
+    endpoint: apiError[1],
+    http_status: Number(apiError[2])
+  };
+  let payload;
+  try {
+    const parsed = JSON.parse(apiError[3]);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      payload = parsed;
+    }
+  } catch {
+    payload = void 0;
+  }
+  const copyScalar = (key) => {
+    const value = payload?.[key];
+    if (typeof value === "string" || typeof value === "boolean") details[key] = value;
+    if (typeof value === "number" && Number.isFinite(value)) details[key] = value;
+  };
+  for (const key of ["error", "required_seconds", "available_seconds", "deficit_seconds", "minimum_purchase_dollars"]) {
+    copyScalar(key);
+  }
+  const httpStatus = typeof details.http_status === "number" ? details.http_status : void 0;
+  const errorText = typeof details.error === "string" ? details.error.toLowerCase() : "";
+  if (httpStatus === 402 && errorText.includes("balance")) {
+    details.reason = "insufficient_balance";
+  }
+  return details;
+}
+function summarizeEnvironmentBlockedRunner(profileName, blocker) {
+  if (blocker?.reason === "insufficient_balance") {
+    const required = typeof blocker.required_seconds === "number" ? blocker.required_seconds : void 0;
+    const available = typeof blocker.available_seconds === "number" ? blocker.available_seconds : void 0;
+    const deficit = typeof blocker.deficit_seconds === "number" ? blocker.deficit_seconds : void 0;
+    const parts = [
+      required === void 0 ? "" : `required ${required}s`,
+      available === void 0 ? "" : `available ${available}s`,
+      deficit === void 0 ? "" : `deficit ${deficit}s`
+    ].filter(Boolean);
+    return `${profileName} could not start because Riddle balance was insufficient${parts.length ? ` (${parts.join(", ")})` : ""}.`;
+  }
+  if (blocker?.source === "riddle_api") {
+    const endpoint = typeof blocker.endpoint === "string" ? blocker.endpoint : "Riddle API";
+    const status = typeof blocker.http_status === "number" ? blocker.http_status : void 0;
+    return `${profileName} could not start because ${endpoint} returned${status === void 0 ? "" : ` HTTP ${status}`}.`;
+  }
+  return `${profileName} could not collect reliable evidence because the runner was blocked.`;
+}
 function createRiddleProofProfileInsufficientResult(input) {
   const message = input.error instanceof Error ? input.error.message : input.error ? String(input.error) : "No proof.json profile result artifact was found.";
   return {
@@ -11549,6 +11602,10 @@ function profileResultMarkdown(result) {
   if (routeInventorySummaryLines.length) {
     lines.push("", "## Route Inventory", "", ...routeInventorySummaryLines);
   }
+  const environmentBlockerLines = profileEnvironmentBlockerMarkdown(result);
+  if (environmentBlockerLines.length) {
+    lines.push("", "## Environment Blocker", "", ...environmentBlockerLines);
+  }
   if (result.artifacts.riddle_artifacts?.length) {
     lines.push("", "## Riddle Artifacts", "");
     for (const artifact of result.artifacts.riddle_artifacts.slice(0, 40)) {
@@ -11640,6 +11697,52 @@ function cliString(value) {
 function cliStringArray(value) {
   return Array.isArray(value) ? value.filter((entry) => typeof entry === "string" && Boolean(entry.trim())) : [];
 }
+function profileEnvironmentBlockerMarkdown(result) {
+  const blocker = cliRecord(result.environment_blocker);
+  if (!blocker) return [];
+  const lines = [];
+  const reason = cliString(blocker.reason);
+  const source = cliString(blocker.source);
+  const endpoint = cliString(blocker.endpoint);
+  const httpStatus = cliFiniteNumber(blocker.http_status);
+  const error = cliString(blocker.error);
+  const requiredSeconds = cliFiniteNumber(blocker.required_seconds);
+  const availableSeconds = cliFiniteNumber(blocker.available_seconds);
+  const deficitSeconds = cliFiniteNumber(blocker.deficit_seconds);
+  const minimumPurchaseDollars = cliFiniteNumber(blocker.minimum_purchase_dollars);
+  if (reason) lines.push(`- reason: ${reason}`);
+  if (source || endpoint || httpStatus !== void 0) {
+    lines.push(`- source: ${source || "runner"}${endpoint ? ` ${endpoint}` : ""}${httpStatus === void 0 ? "" : ` HTTP ${httpStatus}`}`);
+  }
+  if (error) lines.push(`- error: ${error}`);
+  if (requiredSeconds !== void 0 || availableSeconds !== void 0 || deficitSeconds !== void 0) {
+    lines.push(`- seconds: required ${requiredSeconds ?? "unknown"}, available ${availableSeconds ?? "unknown"}, deficit ${deficitSeconds ?? "unknown"}`);
+  }
+  if (minimumPurchaseDollars !== void 0) lines.push(`- minimum purchase: $${minimumPurchaseDollars}`);
+  return lines;
+}
+function profileCliDiagnosticLine(result) {
+  if (result.status !== "environment_blocked") return void 0;
+  const blocker = cliRecord(result.environment_blocker);
+  if (blocker?.reason === "insufficient_balance") {
+    const requiredSeconds = cliFiniteNumber(blocker.required_seconds);
+    const availableSeconds = cliFiniteNumber(blocker.available_seconds);
+    const deficitSeconds = cliFiniteNumber(blocker.deficit_seconds);
+    const parts = [
+      requiredSeconds === void 0 ? "" : `required=${requiredSeconds}s`,
+      availableSeconds === void 0 ? "" : `available=${availableSeconds}s`,
+      deficitSeconds === void 0 ? "" : `deficit=${deficitSeconds}s`
+    ].filter(Boolean);
+    return `[riddle-profile] environment_blocked insufficient_balance${parts.length ? ` ${parts.join(" ")}` : ""}`;
+  }
+  const source = cliString(blocker?.source);
+  const endpoint = cliString(blocker?.endpoint);
+  const httpStatus = cliFiniteNumber(blocker?.http_status);
+  if (source || endpoint || httpStatus !== void 0) {
+    return `[riddle-profile] environment_blocked${source ? ` source=${source}` : ""}${endpoint ? ` endpoint=${endpoint}` : ""}${httpStatus === void 0 ? "" : ` http_status=${httpStatus}`}`;
+  }
+  return `[riddle-profile] environment_blocked ${result.summary}`;
+}
 function profileSetupSummaryMarkdown(result) {
   const setupCheck = result.checks.find((check) => check.type === "setup_actions_succeeded");
   const setupSummary = cliRecord(setupCheck?.evidence?.setup_summary);
@@ -11939,6 +12042,11 @@ async function main() {
     const profile = normalizeProfileForCli(options);
     const result = await runProfileForCli(profile, options);
     writeProfileOutput(profileOutputDirOption(options), result);
+    const diagnosticLine = profileCliDiagnosticLine(result);
+    if (diagnosticLine && optionBoolean(options, "quiet") !== true) {
+      process.stderr.write(`${diagnosticLine}
+`);
+    }
     process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);
     process.exitCode = profileStatusExitCode(profile, result.status);

package/dist/cli.js

@@ -10,7 +10,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-3Y35UIZO.js";
+} from "./chunk-CEBHV23V.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport
@@ -337,6 +337,10 @@ function profileResultMarkdown(result) {
   if (routeInventorySummaryLines.length) {
     lines.push("", "## Route Inventory", "", ...routeInventorySummaryLines);
   }
+  const environmentBlockerLines = profileEnvironmentBlockerMarkdown(result);
+  if (environmentBlockerLines.length) {
+    lines.push("", "## Environment Blocker", "", ...environmentBlockerLines);
+  }
   if (result.artifacts.riddle_artifacts?.length) {
     lines.push("", "## Riddle Artifacts", "");
     for (const artifact of result.artifacts.riddle_artifacts.slice(0, 40)) {
@@ -428,6 +432,52 @@ function cliString(value) {
 function cliStringArray(value) {
   return Array.isArray(value) ? value.filter((entry) => typeof entry === "string" && Boolean(entry.trim())) : [];
 }
+function profileEnvironmentBlockerMarkdown(result) {
+  const blocker = cliRecord(result.environment_blocker);
+  if (!blocker) return [];
+  const lines = [];
+  const reason = cliString(blocker.reason);
+  const source = cliString(blocker.source);
+  const endpoint = cliString(blocker.endpoint);
+  const httpStatus = cliFiniteNumber(blocker.http_status);
+  const error = cliString(blocker.error);
+  const requiredSeconds = cliFiniteNumber(blocker.required_seconds);
+  const availableSeconds = cliFiniteNumber(blocker.available_seconds);
+  const deficitSeconds = cliFiniteNumber(blocker.deficit_seconds);
+  const minimumPurchaseDollars = cliFiniteNumber(blocker.minimum_purchase_dollars);
+  if (reason) lines.push(`- reason: ${reason}`);
+  if (source || endpoint || httpStatus !== void 0) {
+    lines.push(`- source: ${source || "runner"}${endpoint ? ` ${endpoint}` : ""}${httpStatus === void 0 ? "" : ` HTTP ${httpStatus}`}`);
+  }
+  if (error) lines.push(`- error: ${error}`);
+  if (requiredSeconds !== void 0 || availableSeconds !== void 0 || deficitSeconds !== void 0) {
+    lines.push(`- seconds: required ${requiredSeconds ?? "unknown"}, available ${availableSeconds ?? "unknown"}, deficit ${deficitSeconds ?? "unknown"}`);
+  }
+  if (minimumPurchaseDollars !== void 0) lines.push(`- minimum purchase: $${minimumPurchaseDollars}`);
+  return lines;
+}
+function profileCliDiagnosticLine(result) {
+  if (result.status !== "environment_blocked") return void 0;
+  const blocker = cliRecord(result.environment_blocker);
+  if (blocker?.reason === "insufficient_balance") {
+    const requiredSeconds = cliFiniteNumber(blocker.required_seconds);
+    const availableSeconds = cliFiniteNumber(blocker.available_seconds);
+    const deficitSeconds = cliFiniteNumber(blocker.deficit_seconds);
+    const parts = [
+      requiredSeconds === void 0 ? "" : `required=${requiredSeconds}s`,
+      availableSeconds === void 0 ? "" : `available=${availableSeconds}s`,
+      deficitSeconds === void 0 ? "" : `deficit=${deficitSeconds}s`
+    ].filter(Boolean);
+    return `[riddle-profile] environment_blocked insufficient_balance${parts.length ? ` ${parts.join(" ")}` : ""}`;
+  }
+  const source = cliString(blocker?.source);
+  const endpoint = cliString(blocker?.endpoint);
+  const httpStatus = cliFiniteNumber(blocker?.http_status);
+  if (source || endpoint || httpStatus !== void 0) {
+    return `[riddle-profile] environment_blocked${source ? ` source=${source}` : ""}${endpoint ? ` endpoint=${endpoint}` : ""}${httpStatus === void 0 ? "" : ` http_status=${httpStatus}`}`;
+  }
+  return `[riddle-profile] environment_blocked ${result.summary}`;
+}
 function profileSetupSummaryMarkdown(result) {
   const setupCheck = result.checks.find((check) => check.type === "setup_actions_succeeded");
   const setupSummary = cliRecord(setupCheck?.evidence?.setup_summary);
@@ -727,6 +777,11 @@ async function main() {
     const profile = normalizeProfileForCli(options);
     const result = await runProfileForCli(profile, options);
     writeProfileOutput(profileOutputDirOption(options), result);
+    const diagnosticLine = profileCliDiagnosticLine(result);
+    if (diagnosticLine && optionBoolean(options, "quiet") !== true) {
+      process.stderr.write(`${diagnosticLine}
+`);
+    }
     process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);
     process.exitCode = profileStatusExitCode(profile, result.status);

package/dist/index.cjs

@@ -10431,6 +10431,7 @@ function createRiddleProofProfileConfigurationError(name, error, runner = "riddl
 }
 function createRiddleProofProfileEnvironmentBlockedResult(input) {
   const message = input.error instanceof Error ? input.error.message : input.error ? String(input.error) : "Riddle runner did not complete successfully.";
+  const environmentBlocker = extractRiddleRunnerBlocker(message);
   return {
     version: RIDDLE_PROOF_PROFILE_RESULT_VERSION,
     profile_name: input.profile.name,
@@ -10440,12 +10441,64 @@ function createRiddleProofProfileEnvironmentBlockedResult(input) {
     route: { requested: resolveRiddleProofProfileTargetUrl(input.profile), observed: "", matched: false, error: message },
     artifacts: { screenshots: [], proof_json: "proof.json", riddle_artifacts: input.artifacts },
     checks: [],
-    summary: `${input.profile.name} could not collect reliable evidence because the runner was blocked.`,
+    summary: summarizeEnvironmentBlockedRunner(input.profile.name, environmentBlocker),
     captured_at: (/* @__PURE__ */ new Date()).toISOString(),
     riddle: input.riddle,
+    environment_blocker: environmentBlocker,
     error: message
   };
 }
+function extractRiddleRunnerBlocker(message) {
+  const apiError = message.match(/^Riddle API\s+(\S+)\s+failed HTTP\s+(\d+):\s+(\{[\s\S]*\})$/);
+  if (!apiError) return void 0;
+  const details = {
+    source: "riddle_api",
+    endpoint: apiError[1],
+    http_status: Number(apiError[2])
+  };
+  let payload;
+  try {
+    const parsed = JSON.parse(apiError[3]);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      payload = parsed;
+    }
+  } catch {
+    payload = void 0;
+  }
+  const copyScalar = (key) => {
+    const value = payload?.[key];
+    if (typeof value === "string" || typeof value === "boolean") details[key] = value;
+    if (typeof value === "number" && Number.isFinite(value)) details[key] = value;
+  };
+  for (const key of ["error", "required_seconds", "available_seconds", "deficit_seconds", "minimum_purchase_dollars"]) {
+    copyScalar(key);
+  }
+  const httpStatus = typeof details.http_status === "number" ? details.http_status : void 0;
+  const errorText = typeof details.error === "string" ? details.error.toLowerCase() : "";
+  if (httpStatus === 402 && errorText.includes("balance")) {
+    details.reason = "insufficient_balance";
+  }
+  return details;
+}
+function summarizeEnvironmentBlockedRunner(profileName, blocker) {
+  if (blocker?.reason === "insufficient_balance") {
+    const required = typeof blocker.required_seconds === "number" ? blocker.required_seconds : void 0;
+    const available = typeof blocker.available_seconds === "number" ? blocker.available_seconds : void 0;
+    const deficit = typeof blocker.deficit_seconds === "number" ? blocker.deficit_seconds : void 0;
+    const parts = [
+      required === void 0 ? "" : `required ${required}s`,
+      available === void 0 ? "" : `available ${available}s`,
+      deficit === void 0 ? "" : `deficit ${deficit}s`
+    ].filter(Boolean);
+    return `${profileName} could not start because Riddle balance was insufficient${parts.length ? ` (${parts.join(", ")})` : ""}.`;
+  }
+  if (blocker?.source === "riddle_api") {
+    const endpoint = typeof blocker.endpoint === "string" ? blocker.endpoint : "Riddle API";
+    const status = typeof blocker.http_status === "number" ? blocker.http_status : void 0;
+    return `${profileName} could not start because ${endpoint} returned${status === void 0 ? "" : ` HTTP ${status}`}.`;
+  }
+  return `${profileName} could not collect reliable evidence because the runner was blocked.`;
+}
 function createRiddleProofProfileInsufficientResult(input) {
   const message = input.error instanceof Error ? input.error.message : input.error ? String(input.error) : "No proof.json profile result artifact was found.";
   return {

package/dist/index.js

@@ -58,7 +58,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-3Y35UIZO.js";
+} from "./chunk-CEBHV23V.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -1746,6 +1746,7 @@ function createRiddleProofProfileConfigurationError(name, error, runner = "riddl
 }
 function createRiddleProofProfileEnvironmentBlockedResult(input) {
   const message = input.error instanceof Error ? input.error.message : input.error ? String(input.error) : "Riddle runner did not complete successfully.";
+  const environmentBlocker = extractRiddleRunnerBlocker(message);
   return {
     version: RIDDLE_PROOF_PROFILE_RESULT_VERSION,
     profile_name: input.profile.name,
@@ -1755,12 +1756,64 @@ function createRiddleProofProfileEnvironmentBlockedResult(input) {
     route: { requested: resolveRiddleProofProfileTargetUrl(input.profile), observed: "", matched: false, error: message },
     artifacts: { screenshots: [], proof_json: "proof.json", riddle_artifacts: input.artifacts },
     checks: [],
-    summary: `${input.profile.name} could not collect reliable evidence because the runner was blocked.`,
+    summary: summarizeEnvironmentBlockedRunner(input.profile.name, environmentBlocker),
     captured_at: (/* @__PURE__ */ new Date()).toISOString(),
     riddle: input.riddle,
+    environment_blocker: environmentBlocker,
     error: message
   };
 }
+function extractRiddleRunnerBlocker(message) {
+  const apiError = message.match(/^Riddle API\s+(\S+)\s+failed HTTP\s+(\d+):\s+(\{[\s\S]*\})$/);
+  if (!apiError) return void 0;
+  const details = {
+    source: "riddle_api",
+    endpoint: apiError[1],
+    http_status: Number(apiError[2])
+  };
+  let payload;
+  try {
+    const parsed = JSON.parse(apiError[3]);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      payload = parsed;
+    }
+  } catch {
+    payload = void 0;
+  }
+  const copyScalar = (key) => {
+    const value = payload?.[key];
+    if (typeof value === "string" || typeof value === "boolean") details[key] = value;
+    if (typeof value === "number" && Number.isFinite(value)) details[key] = value;
+  };
+  for (const key of ["error", "required_seconds", "available_seconds", "deficit_seconds", "minimum_purchase_dollars"]) {
+    copyScalar(key);
+  }
+  const httpStatus = typeof details.http_status === "number" ? details.http_status : void 0;
+  const errorText = typeof details.error === "string" ? details.error.toLowerCase() : "";
+  if (httpStatus === 402 && errorText.includes("balance")) {
+    details.reason = "insufficient_balance";
+  }
+  return details;
+}
+function summarizeEnvironmentBlockedRunner(profileName, blocker) {
+  if (blocker?.reason === "insufficient_balance") {
+    const required = typeof blocker.required_seconds === "number" ? blocker.required_seconds : void 0;
+    const available = typeof blocker.available_seconds === "number" ? blocker.available_seconds : void 0;
+    const deficit = typeof blocker.deficit_seconds === "number" ? blocker.deficit_seconds : void 0;
+    const parts = [
+      required === void 0 ? "" : `required ${required}s`,
+      available === void 0 ? "" : `available ${available}s`,
+      deficit === void 0 ? "" : `deficit ${deficit}s`
+    ].filter(Boolean);
+    return `${profileName} could not start because Riddle balance was insufficient${parts.length ? ` (${parts.join(", ")})` : ""}.`;
+  }
+  if (blocker?.source === "riddle_api") {
+    const endpoint = typeof blocker.endpoint === "string" ? blocker.endpoint : "Riddle API";
+    const status = typeof blocker.http_status === "number" ? blocker.http_status : void 0;
+    return `${profileName} could not start because ${endpoint} returned${status === void 0 ? "" : ` HTTP ${status}`}.`;
+  }
+  return `${profileName} could not collect reliable evidence because the runner was blocked.`;
+}
 function createRiddleProofProfileInsufficientResult(input) {
   const message = input.error instanceof Error ? input.error.message : input.error ? String(input.error) : "No proof.json profile result artifact was found.";
   return {

package/dist/profile.d.cts

@@ -253,6 +253,7 @@ interface RiddleProofProfileResult {
         status?: string | null;
         terminal?: boolean;
     };
+    environment_blocker?: Record<string, JsonValue>;
     error?: string;
 }
 interface RiddleProofProfileArtifactRef {

package/dist/profile.d.ts

@@ -253,6 +253,7 @@ interface RiddleProofProfileResult {
         status?: string | null;
         terminal?: boolean;
     };
+    environment_blocker?: Record<string, JsonValue>;
     error?: string;
 }
 interface RiddleProofProfileArtifactRef {

package/dist/profile.js

@@ -19,7 +19,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-3Y35UIZO.js";
+} from "./chunk-CEBHV23V.js";
 export {
   RIDDLE_PROOF_PROFILE_CHECK_TYPES,
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,

package/dist/proof-run-engine.d.cts

@@ -292,7 +292,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     blocking?: boolean;
     details?: Record<string, unknown>;
     ok: boolean;
-    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     summary: string;
@@ -382,7 +382,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     continueWithStage?: WorkflowStage | null;
     blocking?: boolean;
     details?: Record<string, unknown>;
-    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     checkpoint: string;
@@ -659,7 +659,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     error?: undefined;
 } | {
     ok: boolean;
-    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     summary: string;

package/dist/proof-run-engine.d.ts

@@ -292,7 +292,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     blocking?: boolean;
     details?: Record<string, unknown>;
     ok: boolean;
-    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     summary: string;
@@ -382,7 +382,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     continueWithStage?: WorkflowStage | null;
     blocking?: boolean;
     details?: Record<string, unknown>;
-    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     checkpoint: string;
@@ -659,7 +659,7 @@ declare function executeWorkflow(params: WorkflowParams, pluginConfig: any, reso
     error?: undefined;
 } | {
     ok: boolean;
-    action: "author" | "recon" | "ship" | "implement" | "verify" | "setup" | "run";
+    action: "setup" | "recon" | "author" | "implement" | "verify" | "ship" | "run";
     state_path: string;
     stage: any;
     summary: string;

package/package.json

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