@riddledc/riddle-proof 0.7.91 → 0.7.93

package/dist/{chunk-6RQGBHJ5.js → chunk-OI57LO6Y.js}

@@ -48,12 +48,13 @@ async function riddleRequestJson(config, pathname, init = {}) {
   if (!response.ok) throw new RiddleApiError(pathname, response.status, text);
   return json ?? text;
 }
-async function deployRiddleStaticPreview(config, directory, label) {
+async function deployRiddlePreview(config, directory, label, framework = "static") {
   if (!directory?.trim()) throw new Error("directory is required");
   if (!label?.trim()) throw new Error("label is required");
+  if (framework !== "spa" && framework !== "static") throw new Error("framework must be spa or static");
   const created = await riddleRequestJson(config, "/v1/preview", {
     method: "POST",
-    body: JSON.stringify({ framework: "static", label })
+    body: JSON.stringify({ framework, label })
   });
   const id = String(created.id || "");
   const uploadUrl = String(created.upload_url || "");
@@ -80,6 +81,7 @@ async function deployRiddleStaticPreview(config, directory, label) {
     ok: true,
     id: String(published.id || id),
     label,
+    framework,
     preview_url: String(published.preview_url || ""),
     file_count: typeof published.file_count === "number" ? published.file_count : void 0,
     total_bytes: typeof published.total_bytes === "number" ? published.total_bytes : void 0,
@@ -87,6 +89,9 @@ async function deployRiddleStaticPreview(config, directory, label) {
     raw: published
   };
 }
+async function deployRiddleStaticPreview(config, directory, label) {
+  return deployRiddlePreview(config, directory, label, "static");
+}
 function createTarball(directory, label, exclude = []) {
   const scratch = mkdtempSync(path.join(tmpdir(), "riddle-upload-"));
   const tarball = path.join(scratch, `${label}.tar.gz`);
@@ -318,6 +323,7 @@ async function pollRiddleJob(config, jobId, options = {}) {
 function createRiddleApiClient(config = {}) {
   return {
     requestJson: (pathname, init) => riddleRequestJson(config, pathname, init),
+    deployPreview: (directory, label, framework = "static") => deployRiddlePreview(config, directory, label, framework),
     deployStaticPreview: (directory, label) => deployRiddleStaticPreview(config, directory, label),
     runScript: (input) => runRiddleScript(config, input),
     runServerPreview: (input) => runRiddleServerPreview(config, input),
@@ -331,6 +337,7 @@ export {
   RiddleApiError,
   resolveRiddleApiKey,
   riddleRequestJson,
+  deployRiddlePreview,
   deployRiddleStaticPreview,
   parseRiddleViewport,
   runRiddleServerPreview,

package/dist/{chunk-2SGLFPFX.js → chunk-QLBOFUON.js}

@@ -4437,6 +4437,16 @@ async function findInventoryLinkIndex(check, expectedPath) {
   }
   return -1;
 }
+async function waitForInventoryLinkIndex(check, expectedPath) {
+  const timeout = Math.min(inventoryCheckTimeout(check), 15000);
+  const started = Date.now();
+  let index = await findInventoryLinkIndex(check, expectedPath);
+  while (index < 0 && Date.now() - started < timeout) {
+    await page.waitForTimeout(250);
+    index = await findInventoryLinkIndex(check, expectedPath);
+  }
+  return index;
+}
 async function collectRouteInventory(check, viewport) {
   const expectedRoutes = check.expected_routes || [];
   const expectedPaths = expectedRoutes.map((route) => normalizeRoutePath(route.path));
@@ -4493,7 +4503,7 @@ async function collectRouteInventory(check, viewport) {
         if (profile.target.wait_for_selector) {
           await waitForAnyVisibleSelector(page, profile.target.wait_for_selector, 15000).catch(() => {});
         }
-        const index = await findInventoryLinkIndex(check, expectedRoute.path);
+        const index = await waitForInventoryLinkIndex(check, expectedRoute.path);
         if (index < 0) {
           result.error = "source_link_not_found";
           failures.push({ code: "source_link_clickthrough_missing", name: expectedRoute.name || null, path: expectedRoute.path });

package/dist/cli.cjs

@@ -6609,12 +6609,13 @@ async function riddleRequestJson(config, pathname, init = {}) {
   if (!response.ok) throw new RiddleApiError(pathname, response.status, text);
   return json ?? text;
 }
-async function deployRiddleStaticPreview(config, directory, label) {
+async function deployRiddlePreview(config, directory, label, framework = "static") {
   if (!directory?.trim()) throw new Error("directory is required");
   if (!label?.trim()) throw new Error("label is required");
+  if (framework !== "spa" && framework !== "static") throw new Error("framework must be spa or static");
   const created = await riddleRequestJson(config, "/v1/preview", {
     method: "POST",
-    body: JSON.stringify({ framework: "static", label })
+    body: JSON.stringify({ framework, label })
   });
   const id = String(created.id || "");
   const uploadUrl = String(created.upload_url || "");
@@ -6641,6 +6642,7 @@ async function deployRiddleStaticPreview(config, directory, label) {
     ok: true,
     id: String(published.id || id),
     label,
+    framework,
     preview_url: String(published.preview_url || ""),
     file_count: typeof published.file_count === "number" ? published.file_count : void 0,
     total_bytes: typeof published.total_bytes === "number" ? published.total_bytes : void 0,
@@ -6648,6 +6650,9 @@ async function deployRiddleStaticPreview(config, directory, label) {
     raw: published
   };
 }
+async function deployRiddleStaticPreview(config, directory, label) {
+  return deployRiddlePreview(config, directory, label, "static");
+}
 function createTarball(directory, label, exclude = []) {
   const scratch = (0, import_node_fs5.mkdtempSync)(import_node_path5.default.join((0, import_node_os2.tmpdir)(), "riddle-upload-"));
   const tarball = import_node_path5.default.join(scratch, `${label}.tar.gz`);
@@ -6879,6 +6884,7 @@ async function pollRiddleJob(config, jobId, options = {}) {
 function createRiddleApiClient(config = {}) {
   return {
     requestJson: (pathname, init) => riddleRequestJson(config, pathname, init),
+    deployPreview: (directory, label, framework = "static") => deployRiddlePreview(config, directory, label, framework),
     deployStaticPreview: (directory, label) => deployRiddleStaticPreview(config, directory, label),
     runScript: (input) => runRiddleScript(config, input),
     runServerPreview: (input) => runRiddleServerPreview(config, input),
@@ -11308,6 +11314,16 @@ async function findInventoryLinkIndex(check, expectedPath) {
   }
   return -1;
 }
+async function waitForInventoryLinkIndex(check, expectedPath) {
+  const timeout = Math.min(inventoryCheckTimeout(check), 15000);
+  const started = Date.now();
+  let index = await findInventoryLinkIndex(check, expectedPath);
+  while (index < 0 && Date.now() - started < timeout) {
+    await page.waitForTimeout(250);
+    index = await findInventoryLinkIndex(check, expectedPath);
+  }
+  return index;
+}
 async function collectRouteInventory(check, viewport) {
   const expectedRoutes = check.expected_routes || [];
   const expectedPaths = expectedRoutes.map((route) => normalizeRoutePath(route.path));
@@ -11364,7 +11380,7 @@ async function collectRouteInventory(check, viewport) {
         if (profile.target.wait_for_selector) {
           await waitForAnyVisibleSelector(page, profile.target.wait_for_selector, 15000).catch(() => {});
         }
-        const index = await findInventoryLinkIndex(check, expectedRoute.path);
+        const index = await waitForInventoryLinkIndex(check, expectedRoute.path);
         if (index < 0) {
           result.error = "source_link_not_found";
           failures.push({ code: "source_link_clickthrough_missing", name: expectedRoute.name || null, path: expectedRoute.path });
@@ -11821,7 +11837,7 @@ function usage() {
     "  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>|--output-dir <dir>] [--quiet]",
-    "  riddle-proof-loop riddle-preview-deploy <build-dir> <label>",
+    "  riddle-proof-loop riddle-preview-deploy <build-dir> <label> [--framework spa|static]",
     "  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]",
     "  riddle-proof-loop riddle-poll <job-id> [--wait] [--attempts n] [--quiet]",
@@ -11885,6 +11901,11 @@ function optionNumber(options, ...keys) {
 function profileOutputDirOption(options) {
   return optionString(options, "output") ?? optionString(options, "outputDir");
 }
+function previewFrameworkOption(options) {
+  const framework = optionString(options, "framework") ?? "static";
+  if (framework === "spa" || framework === "static") return framework;
+  throw new Error("--framework must be spa or static.");
+}
 function readStdin() {
   return (0, import_node_fs6.readFileSync)(0, "utf-8");
 }
@@ -12597,7 +12618,7 @@ async function main() {
   if (command === "riddle-preview-deploy") {
     const buildDir = positional[1];
     const label = positional[2];
-    const result = await createRiddleApiClient(riddleClientConfig(options)).deployStaticPreview(buildDir, label);
+    const result = await createRiddleApiClient(riddleClientConfig(options)).deployPreview(buildDir, label, previewFrameworkOption(options));
     process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);
     return;

package/dist/cli.js

@@ -10,11 +10,11 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-2SGLFPFX.js";
+} from "./chunk-QLBOFUON.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport
-} from "./chunk-6RQGBHJ5.js";
+} from "./chunk-OI57LO6Y.js";
 import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
@@ -45,7 +45,7 @@ function usage() {
     "  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>|--output-dir <dir>] [--quiet]",
-    "  riddle-proof-loop riddle-preview-deploy <build-dir> <label>",
+    "  riddle-proof-loop riddle-preview-deploy <build-dir> <label> [--framework spa|static]",
     "  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]",
     "  riddle-proof-loop riddle-poll <job-id> [--wait] [--attempts n] [--quiet]",
@@ -109,6 +109,11 @@ function optionNumber(options, ...keys) {
 function profileOutputDirOption(options) {
   return optionString(options, "output") ?? optionString(options, "outputDir");
 }
+function previewFrameworkOption(options) {
+  const framework = optionString(options, "framework") ?? "static";
+  if (framework === "spa" || framework === "static") return framework;
+  throw new Error("--framework must be spa or static.");
+}
 function readStdin() {
   return readFileSync(0, "utf-8");
 }
@@ -821,7 +826,7 @@ async function main() {
   if (command === "riddle-preview-deploy") {
     const buildDir = positional[1];
     const label = positional[2];
-    const result = await createRiddleApiClient(riddleClientConfig(options)).deployStaticPreview(buildDir, label);
+    const result = await createRiddleApiClient(riddleClientConfig(options)).deployPreview(buildDir, label, previewFrameworkOption(options));
     process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);
     return;

package/dist/index.cjs

@@ -2968,6 +2968,7 @@ __export(index_exports, {
   createRunResult: () => createRunResult,
   createRunState: () => createRunState,
   createRunStatusSnapshot: () => createRunStatusSnapshot,
+  deployRiddlePreview: () => deployRiddlePreview,
   deployRiddleStaticPreview: () => deployRiddleStaticPreview,
   extractBasicGameplayEvidence: () => extractBasicGameplayEvidence,
   extractPlayabilityEvidence: () => extractPlayabilityEvidence,
@@ -13165,6 +13166,16 @@ async function findInventoryLinkIndex(check, expectedPath) {
   }
   return -1;
 }
+async function waitForInventoryLinkIndex(check, expectedPath) {
+  const timeout = Math.min(inventoryCheckTimeout(check), 15000);
+  const started = Date.now();
+  let index = await findInventoryLinkIndex(check, expectedPath);
+  while (index < 0 && Date.now() - started < timeout) {
+    await page.waitForTimeout(250);
+    index = await findInventoryLinkIndex(check, expectedPath);
+  }
+  return index;
+}
 async function collectRouteInventory(check, viewport) {
   const expectedRoutes = check.expected_routes || [];
   const expectedPaths = expectedRoutes.map((route) => normalizeRoutePath(route.path));
@@ -13221,7 +13232,7 @@ async function collectRouteInventory(check, viewport) {
         if (profile.target.wait_for_selector) {
           await waitForAnyVisibleSelector(page, profile.target.wait_for_selector, 15000).catch(() => {});
         }
-        const index = await findInventoryLinkIndex(check, expectedRoute.path);
+        const index = await waitForInventoryLinkIndex(check, expectedRoute.path);
         if (index < 0) {
           result.error = "source_link_not_found";
           failures.push({ code: "source_link_clickthrough_missing", name: expectedRoute.name || null, path: expectedRoute.path });
@@ -13718,12 +13729,13 @@ async function riddleRequestJson(config, pathname, init = {}) {
   if (!response.ok) throw new RiddleApiError(pathname, response.status, text);
   return json ?? text;
 }
-async function deployRiddleStaticPreview(config, directory, label) {
+async function deployRiddlePreview(config, directory, label, framework = "static") {
   if (!directory?.trim()) throw new Error("directory is required");
   if (!label?.trim()) throw new Error("label is required");
+  if (framework !== "spa" && framework !== "static") throw new Error("framework must be spa or static");
   const created = await riddleRequestJson(config, "/v1/preview", {
     method: "POST",
-    body: JSON.stringify({ framework: "static", label })
+    body: JSON.stringify({ framework, label })
   });
   const id = String(created.id || "");
   const uploadUrl = String(created.upload_url || "");
@@ -13750,6 +13762,7 @@ async function deployRiddleStaticPreview(config, directory, label) {
     ok: true,
     id: String(published.id || id),
     label,
+    framework,
     preview_url: String(published.preview_url || ""),
     file_count: typeof published.file_count === "number" ? published.file_count : void 0,
     total_bytes: typeof published.total_bytes === "number" ? published.total_bytes : void 0,
@@ -13757,6 +13770,9 @@ async function deployRiddleStaticPreview(config, directory, label) {
     raw: published
   };
 }
+async function deployRiddleStaticPreview(config, directory, label) {
+  return deployRiddlePreview(config, directory, label, "static");
+}
 function createTarball(directory, label, exclude = []) {
   const scratch = (0, import_node_fs5.mkdtempSync)(import_node_path5.default.join((0, import_node_os2.tmpdir)(), "riddle-upload-"));
   const tarball = import_node_path5.default.join(scratch, `${label}.tar.gz`);
@@ -13988,6 +14004,7 @@ async function pollRiddleJob(config, jobId, options = {}) {
 function createRiddleApiClient(config = {}) {
   return {
     requestJson: (pathname, init) => riddleRequestJson(config, pathname, init),
+    deployPreview: (directory, label, framework = "static") => deployRiddlePreview(config, directory, label, framework),
     deployStaticPreview: (directory, label) => deployRiddleStaticPreview(config, directory, label),
     runScript: (input) => runRiddleScript(config, input),
     runServerPreview: (input) => runRiddleServerPreview(config, input),
@@ -14065,6 +14082,7 @@ function createRiddleApiClient(config = {}) {
   createRunResult,
   createRunState,
   createRunStatusSnapshot,
+  deployRiddlePreview,
   deployRiddleStaticPreview,
   extractBasicGameplayEvidence,
   extractPlayabilityEvidence,

package/dist/index.d.cts

@@ -11,4 +11,4 @@ export { BuildVisualProofSessionInput, RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_V
 export { AssessPlayabilityOptions, RIDDLE_PROOF_PLAYABILITY_ASSESSMENT_VERSION, RIDDLE_PROOF_PLAYABILITY_VERSION, RiddleProofPlayabilityAssessment, RiddleProofPlayabilityEvidence, assessPlayabilityEvidence, extractPlayabilityEvidence, isRiddleProofPlayabilityMode } from './playability.cjs';
 export { AssessBasicGameplayOptions, AttachBasicGameplayArtifactOptions, BASIC_GAMEPLAY_ACTION_TYPES, BASIC_GAMEPLAY_PROGRESS_CHECK_TYPES, BasicGameplayActionResult, BasicGameplayActionType, BasicGameplayArtifactResolution, BasicGameplayAssessmentSummary, BasicGameplayBoundsOffender, BasicGameplayCanvasState, BasicGameplayCatchRecord, BasicGameplayChangeSummary, BasicGameplayFailureCode, BasicGameplayFixReference, BasicGameplayMetric, BasicGameplayMobileEvidence, BasicGameplayProgressCheckType, BasicGameplayProgressionCheck, BasicGameplayProofArtifact, BasicGameplayResponsiveViewportEvidence, BasicGameplayRouteReference, BasicGameplaySnapshot, BasicGameplaySuiteFailure, BasicGameplayWarningCode, CreateBasicGameplayCatchSummaryInput, RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_CATCH_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION, RiddleProofBasicGameplayAssessment, RiddleProofBasicGameplayCatchSummary, RiddleProofBasicGameplayEvidence, RiddleProofBasicGameplayRouteAssessment, RiddleProofBasicGameplayRouteEvidence, assessBasicGameplayEvidence, assessBasicGameplayProgressionCheck, assessBasicGameplayProgressionChecks, assessBasicGameplayRoute, attachBasicGameplayArtifactScreenshotHashes, augmentBasicGameplayAssessmentWithProgressionChecks, compactBasicGameplayText, createBasicGameplayCatchRecords, createBasicGameplayCatchSummary, extractBasicGameplayEvidence, resolveBasicGameplayProgressionCheckWithArtifactScreenshots, sanitizeBasicGameplayJsonString } from './basic-gameplay.cjs';
 export { NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, RiddleProofProfile, RiddleProofProfileArtifactRef, RiddleProofProfileBaselinePolicy, RiddleProofProfileBoundsOffender, RiddleProofProfileCheck, RiddleProofProfileCheckResult, RiddleProofProfileCheckType, RiddleProofProfileEvidence, RiddleProofProfileFailureAction, RiddleProofProfileNetworkMock, RiddleProofProfileNetworkMockResponse, RiddleProofProfileResult, RiddleProofProfileRouteEvidence, RiddleProofProfileRouteInventoryRoute, RiddleProofProfileRunner, RiddleProofProfileSetupAction, RiddleProofProfileSetupActionType, RiddleProofProfileStatus, RiddleProofProfileTarget, RiddleProofProfileViewport, RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult } from './profile.cjs';
-export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployResult, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, createRiddleApiClient, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from './riddle-client.cjs';
+export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployResult, RiddlePreviewFramework, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from './riddle-client.cjs';

package/dist/index.d.ts

@@ -11,4 +11,4 @@ export { BuildVisualProofSessionInput, RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_V
 export { AssessPlayabilityOptions, RIDDLE_PROOF_PLAYABILITY_ASSESSMENT_VERSION, RIDDLE_PROOF_PLAYABILITY_VERSION, RiddleProofPlayabilityAssessment, RiddleProofPlayabilityEvidence, assessPlayabilityEvidence, extractPlayabilityEvidence, isRiddleProofPlayabilityMode } from './playability.js';
 export { AssessBasicGameplayOptions, AttachBasicGameplayArtifactOptions, BASIC_GAMEPLAY_ACTION_TYPES, BASIC_GAMEPLAY_PROGRESS_CHECK_TYPES, BasicGameplayActionResult, BasicGameplayActionType, BasicGameplayArtifactResolution, BasicGameplayAssessmentSummary, BasicGameplayBoundsOffender, BasicGameplayCanvasState, BasicGameplayCatchRecord, BasicGameplayChangeSummary, BasicGameplayFailureCode, BasicGameplayFixReference, BasicGameplayMetric, BasicGameplayMobileEvidence, BasicGameplayProgressCheckType, BasicGameplayProgressionCheck, BasicGameplayProofArtifact, BasicGameplayResponsiveViewportEvidence, BasicGameplayRouteReference, BasicGameplaySnapshot, BasicGameplaySuiteFailure, BasicGameplayWarningCode, CreateBasicGameplayCatchSummaryInput, RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_CATCH_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION, RiddleProofBasicGameplayAssessment, RiddleProofBasicGameplayCatchSummary, RiddleProofBasicGameplayEvidence, RiddleProofBasicGameplayRouteAssessment, RiddleProofBasicGameplayRouteEvidence, assessBasicGameplayEvidence, assessBasicGameplayProgressionCheck, assessBasicGameplayProgressionChecks, assessBasicGameplayRoute, attachBasicGameplayArtifactScreenshotHashes, augmentBasicGameplayAssessmentWithProgressionChecks, compactBasicGameplayText, createBasicGameplayCatchRecords, createBasicGameplayCatchSummary, extractBasicGameplayEvidence, resolveBasicGameplayProgressionCheckWithArtifactScreenshots, sanitizeBasicGameplayJsonString } from './basic-gameplay.js';
 export { NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, RiddleProofProfile, RiddleProofProfileArtifactRef, RiddleProofProfileBaselinePolicy, RiddleProofProfileBoundsOffender, RiddleProofProfileCheck, RiddleProofProfileCheckResult, RiddleProofProfileCheckType, RiddleProofProfileEvidence, RiddleProofProfileFailureAction, RiddleProofProfileNetworkMock, RiddleProofProfileNetworkMockResponse, RiddleProofProfileResult, RiddleProofProfileRouteEvidence, RiddleProofProfileRouteInventoryRoute, RiddleProofProfileRunner, RiddleProofProfileSetupAction, RiddleProofProfileSetupActionType, RiddleProofProfileStatus, RiddleProofProfileTarget, RiddleProofProfileViewport, RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult } from './profile.js';
-export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployResult, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, createRiddleApiClient, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from './riddle-client.js';
+export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployResult, RiddlePreviewFramework, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from './riddle-client.js';

package/dist/index.js

@@ -58,12 +58,13 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-2SGLFPFX.js";
+} from "./chunk-QLBOFUON.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,
   RiddleApiError,
   createRiddleApiClient,
+  deployRiddlePreview,
   deployRiddleStaticPreview,
   isTerminalRiddleJobStatus,
   parseRiddleViewport,
@@ -72,7 +73,7 @@ import {
   riddleRequestJson,
   runRiddleScript,
   runRiddleServerPreview
-} from "./chunk-6RQGBHJ5.js";
+} from "./chunk-OI57LO6Y.js";
 import {
   DEFAULT_DIAGNOSTIC_ARRAY_LIMIT,
   DEFAULT_DIAGNOSTIC_HISTORY_LIMIT,
@@ -207,6 +208,7 @@ export {
   createRunResult,
   createRunState,
   createRunStatusSnapshot,
+  deployRiddlePreview,
   deployRiddleStaticPreview,
   extractBasicGameplayEvidence,
   extractPlayabilityEvidence,

package/dist/profile.cjs

@@ -4480,6 +4480,16 @@ async function findInventoryLinkIndex(check, expectedPath) {
   }
   return -1;
 }
+async function waitForInventoryLinkIndex(check, expectedPath) {
+  const timeout = Math.min(inventoryCheckTimeout(check), 15000);
+  const started = Date.now();
+  let index = await findInventoryLinkIndex(check, expectedPath);
+  while (index < 0 && Date.now() - started < timeout) {
+    await page.waitForTimeout(250);
+    index = await findInventoryLinkIndex(check, expectedPath);
+  }
+  return index;
+}
 async function collectRouteInventory(check, viewport) {
   const expectedRoutes = check.expected_routes || [];
   const expectedPaths = expectedRoutes.map((route) => normalizeRoutePath(route.path));
@@ -4536,7 +4546,7 @@ async function collectRouteInventory(check, viewport) {
         if (profile.target.wait_for_selector) {
           await waitForAnyVisibleSelector(page, profile.target.wait_for_selector, 15000).catch(() => {});
         }
-        const index = await findInventoryLinkIndex(check, expectedRoute.path);
+        const index = await waitForInventoryLinkIndex(check, expectedRoute.path);
         if (index < 0) {
           result.error = "source_link_not_found";
           failures.push({ code: "source_link_clickthrough_missing", name: expectedRoute.name || null, path: expectedRoute.path });

package/dist/profile.js

@@ -19,7 +19,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-2SGLFPFX.js";
+} from "./chunk-QLBOFUON.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/dist/riddle-client.cjs

@@ -34,6 +34,7 @@ __export(riddle_client_exports, {
   DEFAULT_RIDDLE_API_KEY_FILE: () => DEFAULT_RIDDLE_API_KEY_FILE,
   RiddleApiError: () => RiddleApiError,
   createRiddleApiClient: () => createRiddleApiClient,
+  deployRiddlePreview: () => deployRiddlePreview,
   deployRiddleStaticPreview: () => deployRiddleStaticPreview,
   isTerminalRiddleJobStatus: () => isTerminalRiddleJobStatus,
   parseRiddleViewport: () => parseRiddleViewport,
@@ -93,12 +94,13 @@ async function riddleRequestJson(config, pathname, init = {}) {
   if (!response.ok) throw new RiddleApiError(pathname, response.status, text);
   return json ?? text;
 }
-async function deployRiddleStaticPreview(config, directory, label) {
+async function deployRiddlePreview(config, directory, label, framework = "static") {
   if (!directory?.trim()) throw new Error("directory is required");
   if (!label?.trim()) throw new Error("label is required");
+  if (framework !== "spa" && framework !== "static") throw new Error("framework must be spa or static");
   const created = await riddleRequestJson(config, "/v1/preview", {
     method: "POST",
-    body: JSON.stringify({ framework: "static", label })
+    body: JSON.stringify({ framework, label })
   });
   const id = String(created.id || "");
   const uploadUrl = String(created.upload_url || "");
@@ -125,6 +127,7 @@ async function deployRiddleStaticPreview(config, directory, label) {
     ok: true,
     id: String(published.id || id),
     label,
+    framework,
     preview_url: String(published.preview_url || ""),
     file_count: typeof published.file_count === "number" ? published.file_count : void 0,
     total_bytes: typeof published.total_bytes === "number" ? published.total_bytes : void 0,
@@ -132,6 +135,9 @@ async function deployRiddleStaticPreview(config, directory, label) {
     raw: published
   };
 }
+async function deployRiddleStaticPreview(config, directory, label) {
+  return deployRiddlePreview(config, directory, label, "static");
+}
 function createTarball(directory, label, exclude = []) {
   const scratch = (0, import_node_fs.mkdtempSync)(import_node_path.default.join((0, import_node_os.tmpdir)(), "riddle-upload-"));
   const tarball = import_node_path.default.join(scratch, `${label}.tar.gz`);
@@ -363,6 +369,7 @@ async function pollRiddleJob(config, jobId, options = {}) {
 function createRiddleApiClient(config = {}) {
   return {
     requestJson: (pathname, init) => riddleRequestJson(config, pathname, init),
+    deployPreview: (directory, label, framework = "static") => deployRiddlePreview(config, directory, label, framework),
     deployStaticPreview: (directory, label) => deployRiddleStaticPreview(config, directory, label),
     runScript: (input) => runRiddleScript(config, input),
     runServerPreview: (input) => runRiddleServerPreview(config, input),
@@ -375,6 +382,7 @@ function createRiddleApiClient(config = {}) {
   DEFAULT_RIDDLE_API_KEY_FILE,
   RiddleApiError,
   createRiddleApiClient,
+  deployRiddlePreview,
   deployRiddleStaticPreview,
   isTerminalRiddleJobStatus,
   parseRiddleViewport,

package/dist/riddle-client.d.cts

@@ -32,10 +32,12 @@ interface RiddlePollJobOptions {
     progressEveryMs?: number;
     onProgress?: (snapshot: RiddlePollProgressSnapshot) => void | Promise<void>;
 }
+type RiddlePreviewFramework = "spa" | "static";
 interface RiddlePreviewDeployResult {
     ok: true;
     id: string;
     label: string;
+    framework: RiddlePreviewFramework;
     preview_url: string;
     file_count?: number;
     total_bytes?: number;
@@ -101,6 +103,7 @@ declare class RiddleApiError extends Error {
 }
 declare function resolveRiddleApiKey(config?: RiddleClientConfig): string;
 declare function riddleRequestJson<T = unknown>(config: RiddleClientConfig, pathname: string, init?: RequestInit): Promise<T>;
+declare function deployRiddlePreview(config: RiddleClientConfig, directory: string, label: string, framework?: RiddlePreviewFramework): Promise<RiddlePreviewDeployResult>;
 declare function deployRiddleStaticPreview(config: RiddleClientConfig, directory: string, label: string): Promise<RiddlePreviewDeployResult>;
 declare function parseRiddleViewport(value?: string): {
     width: number;
@@ -112,10 +115,11 @@ declare function isTerminalRiddleJobStatus(status: unknown): boolean;
 declare function pollRiddleJob(config: RiddleClientConfig, jobId: string, options?: RiddlePollJobOptions): Promise<RiddlePollJobResult>;
 declare function createRiddleApiClient(config?: RiddleClientConfig): {
     requestJson: <T = unknown>(pathname: string, init?: RequestInit) => Promise<T>;
+    deployPreview: (directory: string, label: string, framework?: RiddlePreviewFramework) => Promise<RiddlePreviewDeployResult>;
     deployStaticPreview: (directory: string, label: string) => Promise<RiddlePreviewDeployResult>;
     runScript: (input: RiddleRunScriptInput) => Promise<Record<string, unknown>>;
     runServerPreview: (input: RiddleServerPreviewInput) => Promise<RiddleServerPreviewResult>;
     pollJob: (jobId: string, options?: RiddlePollJobOptions) => Promise<RiddlePollJobResult>;
 };
 
-export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobOptions, type RiddlePollJobResult, type RiddlePollProgressSnapshot, type RiddlePollSummary, type RiddlePreviewDeployResult, type RiddleRunScriptInput, type RiddleServerPreviewInput, type RiddleServerPreviewResult, createRiddleApiClient, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview };
+export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobOptions, type RiddlePollJobResult, type RiddlePollProgressSnapshot, type RiddlePollSummary, type RiddlePreviewDeployResult, type RiddlePreviewFramework, type RiddleRunScriptInput, type RiddleServerPreviewInput, type RiddleServerPreviewResult, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview };

package/dist/riddle-client.d.ts

@@ -32,10 +32,12 @@ interface RiddlePollJobOptions {
     progressEveryMs?: number;
     onProgress?: (snapshot: RiddlePollProgressSnapshot) => void | Promise<void>;
 }
+type RiddlePreviewFramework = "spa" | "static";
 interface RiddlePreviewDeployResult {
     ok: true;
     id: string;
     label: string;
+    framework: RiddlePreviewFramework;
     preview_url: string;
     file_count?: number;
     total_bytes?: number;
@@ -101,6 +103,7 @@ declare class RiddleApiError extends Error {
 }
 declare function resolveRiddleApiKey(config?: RiddleClientConfig): string;
 declare function riddleRequestJson<T = unknown>(config: RiddleClientConfig, pathname: string, init?: RequestInit): Promise<T>;
+declare function deployRiddlePreview(config: RiddleClientConfig, directory: string, label: string, framework?: RiddlePreviewFramework): Promise<RiddlePreviewDeployResult>;
 declare function deployRiddleStaticPreview(config: RiddleClientConfig, directory: string, label: string): Promise<RiddlePreviewDeployResult>;
 declare function parseRiddleViewport(value?: string): {
     width: number;
@@ -112,10 +115,11 @@ declare function isTerminalRiddleJobStatus(status: unknown): boolean;
 declare function pollRiddleJob(config: RiddleClientConfig, jobId: string, options?: RiddlePollJobOptions): Promise<RiddlePollJobResult>;
 declare function createRiddleApiClient(config?: RiddleClientConfig): {
     requestJson: <T = unknown>(pathname: string, init?: RequestInit) => Promise<T>;
+    deployPreview: (directory: string, label: string, framework?: RiddlePreviewFramework) => Promise<RiddlePreviewDeployResult>;
     deployStaticPreview: (directory: string, label: string) => Promise<RiddlePreviewDeployResult>;
     runScript: (input: RiddleRunScriptInput) => Promise<Record<string, unknown>>;
     runServerPreview: (input: RiddleServerPreviewInput) => Promise<RiddleServerPreviewResult>;
     pollJob: (jobId: string, options?: RiddlePollJobOptions) => Promise<RiddlePollJobResult>;
 };
 
-export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobOptions, type RiddlePollJobResult, type RiddlePollProgressSnapshot, type RiddlePollSummary, type RiddlePreviewDeployResult, type RiddleRunScriptInput, type RiddleServerPreviewInput, type RiddleServerPreviewResult, createRiddleApiClient, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview };
+export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobOptions, type RiddlePollJobResult, type RiddlePollProgressSnapshot, type RiddlePollSummary, type RiddlePreviewDeployResult, type RiddlePreviewFramework, type RiddleRunScriptInput, type RiddleServerPreviewInput, type RiddleServerPreviewResult, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview };

package/dist/riddle-client.js

@@ -3,6 +3,7 @@ import {
   DEFAULT_RIDDLE_API_KEY_FILE,
   RiddleApiError,
   createRiddleApiClient,
+  deployRiddlePreview,
   deployRiddleStaticPreview,
   isTerminalRiddleJobStatus,
   parseRiddleViewport,
@@ -11,12 +12,13 @@ import {
   riddleRequestJson,
   runRiddleScript,
   runRiddleServerPreview
-} from "./chunk-6RQGBHJ5.js";
+} from "./chunk-OI57LO6Y.js";
 export {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,
   RiddleApiError,
   createRiddleApiClient,
+  deployRiddlePreview,
   deployRiddleStaticPreview,
   isTerminalRiddleJobStatus,
   parseRiddleViewport,

package/package.json

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