@riddledc/riddle-proof 0.7.85 → 0.7.87

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 {
@@ -11256,7 +11309,7 @@ function usage() {
     "  riddle-proof-loop respond --state-path <path> --response-json <file|json|->",
     "  riddle-proof-loop respond --state-path <path> --decision <decision> --summary <text> [--payload-json <file|json|->]",
     "  riddle-proof-loop status --state-path <path>",
-    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--strict true|false] [--poll-attempts n] [--output <dir>] [--quiet]",
+    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--strict true|false] [--poll-attempts n] [--output <dir>|--output-dir <dir>] [--quiet]",
     "  riddle-proof-loop riddle-preview-deploy <build-dir> <label>",
     "  riddle-proof-loop riddle-server-preview <directory> --script-file <file> [--path /route] [--wait-for-selector selector]",
     "  riddle-proof-loop riddle-run-script --url <url> --script-file <file> [--viewport 1280x720] [--strict true|false]",
@@ -11318,6 +11371,9 @@ function optionNumber(options, ...keys) {
   }
   return void 0;
 }
+function profileOutputDirOption(options) {
+  return optionString(options, "output") ?? optionString(options, "outputDir");
+}
 function readStdin() {
   return (0, import_node_fs6.readFileSync)(0, "utf-8");
 }
@@ -11546,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)) {
@@ -11637,6 +11697,30 @@ 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 profileSetupSummaryMarkdown(result) {
   const setupCheck = result.checks.find((check) => check.type === "setup_actions_succeeded");
   const setupSummary = cliRecord(setupCheck?.evidence?.setup_summary);
@@ -11935,7 +12019,7 @@ async function main() {
   if (command === "run-profile") {
     const profile = normalizeProfileForCli(options);
     const result = await runProfileForCli(profile, options);
-    writeProfileOutput(optionString(options, "output"), result);
+    writeProfileOutput(profileOutputDirOption(options), result);
     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
@@ -44,7 +44,7 @@ function usage() {
     "  riddle-proof-loop respond --state-path <path> --response-json <file|json|->",
     "  riddle-proof-loop respond --state-path <path> --decision <decision> --summary <text> [--payload-json <file|json|->]",
     "  riddle-proof-loop status --state-path <path>",
-    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--strict true|false] [--poll-attempts n] [--output <dir>] [--quiet]",
+    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--strict true|false] [--poll-attempts n] [--output <dir>|--output-dir <dir>] [--quiet]",
     "  riddle-proof-loop riddle-preview-deploy <build-dir> <label>",
     "  riddle-proof-loop riddle-server-preview <directory> --script-file <file> [--path /route] [--wait-for-selector selector]",
     "  riddle-proof-loop riddle-run-script --url <url> --script-file <file> [--viewport 1280x720] [--strict true|false]",
@@ -106,6 +106,9 @@ function optionNumber(options, ...keys) {
   }
   return void 0;
 }
+function profileOutputDirOption(options) {
+  return optionString(options, "output") ?? optionString(options, "outputDir");
+}
 function readStdin() {
   return readFileSync(0, "utf-8");
 }
@@ -334,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)) {
@@ -425,6 +432,30 @@ 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 profileSetupSummaryMarkdown(result) {
   const setupCheck = result.checks.find((check) => check.type === "setup_actions_succeeded");
   const setupSummary = cliRecord(setupCheck?.evidence?.setup_summary);
@@ -723,7 +754,7 @@ async function main() {
   if (command === "run-profile") {
     const profile = normalizeProfileForCli(options);
     const result = await runProfileForCli(profile, options);
-    writeProfileOutput(optionString(options, "output"), result);
+    writeProfileOutput(profileOutputDirOption(options), result);
     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/package.json

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