@riddledc/riddle-proof 0.7.179 → 0.7.181

package/README.md

@@ -192,6 +192,10 @@ riddle-proof-loop run-profile \
 Hosted profile runs emit Riddle poll progress to stderr while waiting. Use
 `--quiet` to suppress progress lines, or `--progress-every-ms` to tune the
 heartbeat cadence for long route-inventory or workflow profiles.
+By default, `run-profile` writes the full JSON result to stdout for automation.
+For agent loops where the saved artifacts are the source of truth, use
+`--result-format summary` to print the same compact Markdown summary that is
+written to `summary.md`, or `--result-format none` to leave stdout empty.
 Hosted `run-profile` submits package-generated profile scripts with
 `strict=false` by default because the generated runner is larger than Riddle's
 generic inline-script warning threshold. Use `--strict=true` when you
@@ -413,6 +417,8 @@ stable enough for Playwright's default click actionability checks. Use `press`
 with a Playwright key name, such as `Enter`, `Space`, or `ArrowLeft`,
 when a route's intended browser control is keyboard-driven; omit `selector` for
 a page-level key press, or provide `selector` to press against a focused element.
+For canvas games that read key state rather than keypress events, add `hold_ms`
+or `holdMs` to keep the key down before releasing it.
 Use `click_count` / `clickCount` / `clicks` from 1 to 10 on a single `click`
 action for atomic double-click or double-submit contracts where modeling the
 interaction as repeated setup actions would incorrectly require the target to

package/dist/{chunk-62JD4MJA.js → chunk-T664I6R3.js}

@@ -618,6 +618,7 @@ function profileSetupPressReceipts(results) {
     selector: result.selector ?? null,
     frame_selector: result.frame_selector ?? null,
     key: result.key ?? null,
+    hold_ms: result.hold_ms ?? null,
     reason: result.reason ?? result.error ?? null
   }));
 }
@@ -1083,6 +1084,11 @@ function normalizeSetupAction(input, index) {
   const toY = numberValue(valueFromOwn(input, "to_y", "toY", "end_y", "endY", "y2"));
   const coordinateMode = normalizeSetupActionCoordinateMode(valueFromOwn(input, "coordinate_mode", "coordinateMode", "coords", "units"), index);
   const pointerType = normalizeSetupActionPointerType(valueFromOwn(input, "pointer_type", "pointerType", "input_type", "inputType"), type, index);
+  const durationMs = numberValue(input.duration_ms) ?? numberValue(input.durationMs);
+  const holdMs = type === "press" ? normalizeSetupActionNonNegativeNumber(input, index, "hold_ms", "hold_ms", "holdMs", "key_down_ms", "keyDownMs", "down_ms", "downMs") ?? durationMs : void 0;
+  if (type === "press" && holdMs !== void 0 && (holdMs < 0 || holdMs > 3e4)) {
+    throw new Error(`target.setup_actions[${index}].hold_ms must be a finite number from 0 to 30000.`);
+  }
   if (type === "click") {
     const hasClickCoordinate = fromX !== void 0 || fromY !== void 0;
     if (hasClickCoordinate && (fromX === void 0 || fromY === void 0)) {
@@ -1249,9 +1255,10 @@ function normalizeSetupAction(input, index) {
     from_y: fromY,
     to_x: toX,
     to_y: toY,
-    duration_ms: numberValue(input.duration_ms) ?? numberValue(input.durationMs),
+    duration_ms: durationMs,
     steps,
     key,
+    hold_ms: holdMs,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
     random_queue: randomQueue,
@@ -4496,6 +4503,7 @@ function profileSetupPressReceipts(results) {
       selector: result.selector ?? null,
       frame_selector: result.frame_selector ?? null,
       key: result.key ?? null,
+      hold_ms: result.hold_ms ?? null,
       reason: result.reason || result.error || null,
     }));
 }
@@ -6432,9 +6440,22 @@ async function executeSetupAction(action, ordinal, viewport) {
     if (type === "press") {
       const key = String(action.key || "").trim();
       if (!key) return { ...base, reason: "missing_key" };
+      const holdMs = Math.min(30000, Math.max(0, Math.floor(setupNumber(action.hold_ms ?? action.holdMs ?? action.key_down_ms ?? action.keyDownMs ?? action.down_ms ?? action.downMs ?? action.duration_ms ?? action.durationMs, 0) || 0)));
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
       if (!action.selector) {
+        if (holdMs > 0) {
+          if (scope.frame_selector) {
+            await scope.context.locator("body").focus({ timeout }).catch(() => {});
+          }
+          await page.keyboard.down(key);
+          try {
+            await page.waitForTimeout(holdMs);
+          } finally {
+            await page.keyboard.up(key).catch(() => {});
+          }
+          return { ...base, ...setupScopeEvidence(scope), ok: true, key, hold_ms: holdMs };
+        }
         if (scope.frame_selector) {
           await scope.context.locator("body").press(key, { timeout });
         } else {
@@ -6447,6 +6468,16 @@ async function executeSetupAction(action, ordinal, viewport) {
       if (!count) return { ...base, reason: "selector_not_found", count, key };
       const targetIndex = Number.isInteger(action.index) ? action.index : 0;
       if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex, key };
+      if (holdMs > 0) {
+        await locator.nth(targetIndex).focus({ timeout });
+        await page.keyboard.down(key);
+        try {
+          await page.waitForTimeout(holdMs);
+        } finally {
+          await page.keyboard.up(key).catch(() => {});
+        }
+        return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, key, hold_ms: holdMs };
+      }
       await locator.nth(targetIndex).press(key, { timeout });
       return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, key };
     }

package/dist/cli.cjs

@@ -7575,6 +7575,7 @@ function profileSetupPressReceipts(results) {
     selector: result.selector ?? null,
     frame_selector: result.frame_selector ?? null,
     key: result.key ?? null,
+    hold_ms: result.hold_ms ?? null,
     reason: result.reason ?? result.error ?? null
   }));
 }
@@ -8040,6 +8041,11 @@ function normalizeSetupAction(input, index) {
   const toY = numberValue(valueFromOwn(input, "to_y", "toY", "end_y", "endY", "y2"));
   const coordinateMode = normalizeSetupActionCoordinateMode(valueFromOwn(input, "coordinate_mode", "coordinateMode", "coords", "units"), index);
   const pointerType = normalizeSetupActionPointerType(valueFromOwn(input, "pointer_type", "pointerType", "input_type", "inputType"), type, index);
+  const durationMs = numberValue(input.duration_ms) ?? numberValue(input.durationMs);
+  const holdMs = type === "press" ? normalizeSetupActionNonNegativeNumber(input, index, "hold_ms", "hold_ms", "holdMs", "key_down_ms", "keyDownMs", "down_ms", "downMs") ?? durationMs : void 0;
+  if (type === "press" && holdMs !== void 0 && (holdMs < 0 || holdMs > 3e4)) {
+    throw new Error(`target.setup_actions[${index}].hold_ms must be a finite number from 0 to 30000.`);
+  }
   if (type === "click") {
     const hasClickCoordinate = fromX !== void 0 || fromY !== void 0;
     if (hasClickCoordinate && (fromX === void 0 || fromY === void 0)) {
@@ -8206,9 +8212,10 @@ function normalizeSetupAction(input, index) {
     from_y: fromY,
     to_x: toX,
     to_y: toY,
-    duration_ms: numberValue(input.duration_ms) ?? numberValue(input.durationMs),
+    duration_ms: durationMs,
     steps,
     key,
+    hold_ms: holdMs,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
     random_queue: randomQueue,
@@ -11437,6 +11444,7 @@ function profileSetupPressReceipts(results) {
       selector: result.selector ?? null,
       frame_selector: result.frame_selector ?? null,
       key: result.key ?? null,
+      hold_ms: result.hold_ms ?? null,
       reason: result.reason || result.error || null,
     }));
 }
@@ -13373,9 +13381,22 @@ async function executeSetupAction(action, ordinal, viewport) {
     if (type === "press") {
       const key = String(action.key || "").trim();
       if (!key) return { ...base, reason: "missing_key" };
+      const holdMs = Math.min(30000, Math.max(0, Math.floor(setupNumber(action.hold_ms ?? action.holdMs ?? action.key_down_ms ?? action.keyDownMs ?? action.down_ms ?? action.downMs ?? action.duration_ms ?? action.durationMs, 0) || 0)));
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
       if (!action.selector) {
+        if (holdMs > 0) {
+          if (scope.frame_selector) {
+            await scope.context.locator("body").focus({ timeout }).catch(() => {});
+          }
+          await page.keyboard.down(key);
+          try {
+            await page.waitForTimeout(holdMs);
+          } finally {
+            await page.keyboard.up(key).catch(() => {});
+          }
+          return { ...base, ...setupScopeEvidence(scope), ok: true, key, hold_ms: holdMs };
+        }
         if (scope.frame_selector) {
           await scope.context.locator("body").press(key, { timeout });
         } else {
@@ -13388,6 +13409,16 @@ async function executeSetupAction(action, ordinal, viewport) {
       if (!count) return { ...base, reason: "selector_not_found", count, key };
       const targetIndex = Number.isInteger(action.index) ? action.index : 0;
       if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex, key };
+      if (holdMs > 0) {
+        await locator.nth(targetIndex).focus({ timeout });
+        await page.keyboard.down(key);
+        try {
+          await page.waitForTimeout(holdMs);
+        } finally {
+          await page.keyboard.up(key).catch(() => {});
+        }
+        return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, key, hold_ms: holdMs };
+      }
       await locator.nth(targetIndex).press(key, { timeout });
       return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, key };
     }
@@ -15765,7 +15796,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; default false] [--split-viewports true|false; default false] [--poll-attempts n] [--output <dir>|--output-dir <dir>] [--quiet]",
+    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--strict true|false; default false] [--split-viewports true|false; default false] [--poll-attempts n] [--output <dir>|--output-dir <dir>] [--result-format json|summary|none; default json] [--quiet]",
     "  riddle-proof-loop profile-body-assertions --artifact <file|url|-> --candidates-json <file|json|-> [--required-json <file|json|->] [--format json|body-contains]",
     "  riddle-proof-loop profile-http-status-preflight --profile <file|json|-> --url <base-url> [--format json|summary]",
     "  riddle-proof-loop riddle-preview-deploy <build-dir> <label> [--framework spa|static]",
@@ -15842,6 +15873,21 @@ function optionInteger(options, fallback, ...keys) {
 function profileOutputDirOption(options) {
   return optionString(options, "output") ?? optionString(options, "outputDir");
 }
+function runProfileResultFormatOption(options) {
+  const format = optionString(options, "resultFormat") ?? "json";
+  if (format === "json" || format === "summary" || format === "none") return format;
+  throw new Error("--result-format must be json, summary, or none.");
+}
+function writeRunProfileResult(result, options) {
+  const format = runProfileResultFormatOption(options);
+  if (format === "none") return;
+  if (format === "summary") {
+    process.stdout.write(profileResultMarkdown(result));
+    return;
+  }
+  process.stdout.write(`${JSON.stringify(result, null, 2)}
+`);
+}
 function previewFrameworkOption(options) {
   const framework = optionString(options, "framework") ?? "static";
   if (framework === "spa" || framework === "static") return framework;
@@ -16664,9 +16710,10 @@ function profileSetupSummaryMarkdown(result) {
     const key = cliString(receipt.key) || "key";
     const selector = cliString(receipt.selector);
     const frameSelector = cliString(receipt.frame_selector);
+    const holdMs = cliFiniteNumber(receipt.hold_ms);
     const ok = receipt.ok === false ? "failed" : "ok";
     const reason = cliString(receipt.reason);
-    lines.push(`- ${name} press: ${ok}, ${markdownInlineCode(key)}${selector ? ` on ${markdownInlineCode(selector)}` : ""}${frameSelector ? ` in frame ${markdownInlineCode(frameSelector)}` : ""}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
+    lines.push(`- ${name} press: ${ok}, ${markdownInlineCode(key)}${selector ? ` on ${markdownInlineCode(selector)}` : ""}${frameSelector ? ` in frame ${markdownInlineCode(frameSelector)}` : ""}${holdMs === void 0 ? "" : `, held ${holdMs}ms`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
   }
   if (pressDetails.length > sampledPressDetails.length) lines.push(`- ${pressDetails.length - sampledPressDetails.length} additional press receipt(s) omitted.`);
   const canvasSignatureGroups = viewports.map((viewport) => {
@@ -17600,8 +17647,7 @@ async function main() {
       process.stderr.write(`${diagnosticLine}
 `);
     }
-    process.stdout.write(`${JSON.stringify(result, null, 2)}
-`);
+    writeRunProfileResult(result, options);
     process.exitCode = profileStatusExitCode(profile, result.status);
     return;
   }

package/dist/cli.js

@@ -13,7 +13,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-62JD4MJA.js";
+} from "./chunk-T664I6R3.js";
 import {
   createRiddleApiClient,
   isTerminalRiddleJobStatus,
@@ -48,7 +48,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; default false] [--split-viewports true|false; default false] [--poll-attempts n] [--output <dir>|--output-dir <dir>] [--quiet]",
+    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--strict true|false; default false] [--split-viewports true|false; default false] [--poll-attempts n] [--output <dir>|--output-dir <dir>] [--result-format json|summary|none; default json] [--quiet]",
     "  riddle-proof-loop profile-body-assertions --artifact <file|url|-> --candidates-json <file|json|-> [--required-json <file|json|->] [--format json|body-contains]",
     "  riddle-proof-loop profile-http-status-preflight --profile <file|json|-> --url <base-url> [--format json|summary]",
     "  riddle-proof-loop riddle-preview-deploy <build-dir> <label> [--framework spa|static]",
@@ -125,6 +125,21 @@ function optionInteger(options, fallback, ...keys) {
 function profileOutputDirOption(options) {
   return optionString(options, "output") ?? optionString(options, "outputDir");
 }
+function runProfileResultFormatOption(options) {
+  const format = optionString(options, "resultFormat") ?? "json";
+  if (format === "json" || format === "summary" || format === "none") return format;
+  throw new Error("--result-format must be json, summary, or none.");
+}
+function writeRunProfileResult(result, options) {
+  const format = runProfileResultFormatOption(options);
+  if (format === "none") return;
+  if (format === "summary") {
+    process.stdout.write(profileResultMarkdown(result));
+    return;
+  }
+  process.stdout.write(`${JSON.stringify(result, null, 2)}
+`);
+}
 function previewFrameworkOption(options) {
   const framework = optionString(options, "framework") ?? "static";
   if (framework === "spa" || framework === "static") return framework;
@@ -947,9 +962,10 @@ function profileSetupSummaryMarkdown(result) {
     const key = cliString(receipt.key) || "key";
     const selector = cliString(receipt.selector);
     const frameSelector = cliString(receipt.frame_selector);
+    const holdMs = cliFiniteNumber(receipt.hold_ms);
     const ok = receipt.ok === false ? "failed" : "ok";
     const reason = cliString(receipt.reason);
-    lines.push(`- ${name} press: ${ok}, ${markdownInlineCode(key)}${selector ? ` on ${markdownInlineCode(selector)}` : ""}${frameSelector ? ` in frame ${markdownInlineCode(frameSelector)}` : ""}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
+    lines.push(`- ${name} press: ${ok}, ${markdownInlineCode(key)}${selector ? ` on ${markdownInlineCode(selector)}` : ""}${frameSelector ? ` in frame ${markdownInlineCode(frameSelector)}` : ""}${holdMs === void 0 ? "" : `, held ${holdMs}ms`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
   }
   if (pressDetails.length > sampledPressDetails.length) lines.push(`- ${pressDetails.length - sampledPressDetails.length} additional press receipt(s) omitted.`);
   const canvasSignatureGroups = viewports.map((viewport) => {
@@ -1883,8 +1899,7 @@ async function main() {
       process.stderr.write(`${diagnosticLine}
 `);
     }
-    process.stdout.write(`${JSON.stringify(result, null, 2)}
-`);
+    writeRunProfileResult(result, options);
     process.exitCode = profileStatusExitCode(profile, result.status);
     return;
   }

package/dist/index.cjs

@@ -9351,6 +9351,7 @@ function profileSetupPressReceipts(results) {
     selector: result.selector ?? null,
     frame_selector: result.frame_selector ?? null,
     key: result.key ?? null,
+    hold_ms: result.hold_ms ?? null,
     reason: result.reason ?? result.error ?? null
   }));
 }
@@ -9816,6 +9817,11 @@ function normalizeSetupAction(input, index) {
   const toY = numberValue3(valueFromOwn(input, "to_y", "toY", "end_y", "endY", "y2"));
   const coordinateMode = normalizeSetupActionCoordinateMode(valueFromOwn(input, "coordinate_mode", "coordinateMode", "coords", "units"), index);
   const pointerType = normalizeSetupActionPointerType(valueFromOwn(input, "pointer_type", "pointerType", "input_type", "inputType"), type, index);
+  const durationMs = numberValue3(input.duration_ms) ?? numberValue3(input.durationMs);
+  const holdMs = type === "press" ? normalizeSetupActionNonNegativeNumber(input, index, "hold_ms", "hold_ms", "holdMs", "key_down_ms", "keyDownMs", "down_ms", "downMs") ?? durationMs : void 0;
+  if (type === "press" && holdMs !== void 0 && (holdMs < 0 || holdMs > 3e4)) {
+    throw new Error(`target.setup_actions[${index}].hold_ms must be a finite number from 0 to 30000.`);
+  }
   if (type === "click") {
     const hasClickCoordinate = fromX !== void 0 || fromY !== void 0;
     if (hasClickCoordinate && (fromX === void 0 || fromY === void 0)) {
@@ -9982,9 +9988,10 @@ function normalizeSetupAction(input, index) {
     from_y: fromY,
     to_x: toX,
     to_y: toY,
-    duration_ms: numberValue3(input.duration_ms) ?? numberValue3(input.durationMs),
+    duration_ms: durationMs,
     steps,
     key,
+    hold_ms: holdMs,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
     random_queue: randomQueue,
@@ -13229,6 +13236,7 @@ function profileSetupPressReceipts(results) {
       selector: result.selector ?? null,
       frame_selector: result.frame_selector ?? null,
       key: result.key ?? null,
+      hold_ms: result.hold_ms ?? null,
       reason: result.reason || result.error || null,
     }));
 }
@@ -15165,9 +15173,22 @@ async function executeSetupAction(action, ordinal, viewport) {
     if (type === "press") {
       const key = String(action.key || "").trim();
       if (!key) return { ...base, reason: "missing_key" };
+      const holdMs = Math.min(30000, Math.max(0, Math.floor(setupNumber(action.hold_ms ?? action.holdMs ?? action.key_down_ms ?? action.keyDownMs ?? action.down_ms ?? action.downMs ?? action.duration_ms ?? action.durationMs, 0) || 0)));
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
       if (!action.selector) {
+        if (holdMs > 0) {
+          if (scope.frame_selector) {
+            await scope.context.locator("body").focus({ timeout }).catch(() => {});
+          }
+          await page.keyboard.down(key);
+          try {
+            await page.waitForTimeout(holdMs);
+          } finally {
+            await page.keyboard.up(key).catch(() => {});
+          }
+          return { ...base, ...setupScopeEvidence(scope), ok: true, key, hold_ms: holdMs };
+        }
         if (scope.frame_selector) {
           await scope.context.locator("body").press(key, { timeout });
         } else {
@@ -15180,6 +15201,16 @@ async function executeSetupAction(action, ordinal, viewport) {
       if (!count) return { ...base, reason: "selector_not_found", count, key };
       const targetIndex = Number.isInteger(action.index) ? action.index : 0;
       if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex, key };
+      if (holdMs > 0) {
+        await locator.nth(targetIndex).focus({ timeout });
+        await page.keyboard.down(key);
+        try {
+          await page.waitForTimeout(holdMs);
+        } finally {
+          await page.keyboard.up(key).catch(() => {});
+        }
+        return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, key, hold_ms: holdMs };
+      }
       await locator.nth(targetIndex).press(key, { timeout });
       return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, key };
     }

package/dist/index.js

@@ -62,7 +62,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-62JD4MJA.js";
+} from "./chunk-T664I6R3.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -665,6 +665,7 @@ function profileSetupPressReceipts(results) {
     selector: result.selector ?? null,
     frame_selector: result.frame_selector ?? null,
     key: result.key ?? null,
+    hold_ms: result.hold_ms ?? null,
     reason: result.reason ?? result.error ?? null
   }));
 }
@@ -1130,6 +1131,11 @@ function normalizeSetupAction(input, index) {
   const toY = numberValue(valueFromOwn(input, "to_y", "toY", "end_y", "endY", "y2"));
   const coordinateMode = normalizeSetupActionCoordinateMode(valueFromOwn(input, "coordinate_mode", "coordinateMode", "coords", "units"), index);
   const pointerType = normalizeSetupActionPointerType(valueFromOwn(input, "pointer_type", "pointerType", "input_type", "inputType"), type, index);
+  const durationMs = numberValue(input.duration_ms) ?? numberValue(input.durationMs);
+  const holdMs = type === "press" ? normalizeSetupActionNonNegativeNumber(input, index, "hold_ms", "hold_ms", "holdMs", "key_down_ms", "keyDownMs", "down_ms", "downMs") ?? durationMs : void 0;
+  if (type === "press" && holdMs !== void 0 && (holdMs < 0 || holdMs > 3e4)) {
+    throw new Error(`target.setup_actions[${index}].hold_ms must be a finite number from 0 to 30000.`);
+  }
   if (type === "click") {
     const hasClickCoordinate = fromX !== void 0 || fromY !== void 0;
     if (hasClickCoordinate && (fromX === void 0 || fromY === void 0)) {
@@ -1296,9 +1302,10 @@ function normalizeSetupAction(input, index) {
     from_y: fromY,
     to_x: toX,
     to_y: toY,
-    duration_ms: numberValue(input.duration_ms) ?? numberValue(input.durationMs),
+    duration_ms: durationMs,
     steps,
     key,
+    hold_ms: holdMs,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
     random_queue: randomQueue,
@@ -4543,6 +4550,7 @@ function profileSetupPressReceipts(results) {
       selector: result.selector ?? null,
       frame_selector: result.frame_selector ?? null,
       key: result.key ?? null,
+      hold_ms: result.hold_ms ?? null,
       reason: result.reason || result.error || null,
     }));
 }
@@ -6479,9 +6487,22 @@ async function executeSetupAction(action, ordinal, viewport) {
     if (type === "press") {
       const key = String(action.key || "").trim();
       if (!key) return { ...base, reason: "missing_key" };
+      const holdMs = Math.min(30000, Math.max(0, Math.floor(setupNumber(action.hold_ms ?? action.holdMs ?? action.key_down_ms ?? action.keyDownMs ?? action.down_ms ?? action.downMs ?? action.duration_ms ?? action.durationMs, 0) || 0)));
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
       if (!action.selector) {
+        if (holdMs > 0) {
+          if (scope.frame_selector) {
+            await scope.context.locator("body").focus({ timeout }).catch(() => {});
+          }
+          await page.keyboard.down(key);
+          try {
+            await page.waitForTimeout(holdMs);
+          } finally {
+            await page.keyboard.up(key).catch(() => {});
+          }
+          return { ...base, ...setupScopeEvidence(scope), ok: true, key, hold_ms: holdMs };
+        }
         if (scope.frame_selector) {
           await scope.context.locator("body").press(key, { timeout });
         } else {
@@ -6494,6 +6515,16 @@ async function executeSetupAction(action, ordinal, viewport) {
       if (!count) return { ...base, reason: "selector_not_found", count, key };
       const targetIndex = Number.isInteger(action.index) ? action.index : 0;
       if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex, key };
+      if (holdMs > 0) {
+        await locator.nth(targetIndex).focus({ timeout });
+        await page.keyboard.down(key);
+        try {
+          await page.waitForTimeout(holdMs);
+        } finally {
+          await page.keyboard.up(key).catch(() => {});
+        }
+        return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, key, hold_ms: holdMs };
+      }
       await locator.nth(targetIndex).press(key, { timeout });
       return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, key };
     }

package/dist/profile.d.cts

@@ -124,6 +124,7 @@ interface RiddleProofProfileSetupAction {
     duration_ms?: number;
     steps?: number;
     key?: string;
+    hold_ms?: number;
     value?: string;
     value_json?: JsonValue;
     random_queue?: number[];

package/dist/profile.d.ts

@@ -124,6 +124,7 @@ interface RiddleProofProfileSetupAction {
     duration_ms?: number;
     steps?: number;
     key?: string;
+    hold_ms?: number;
     value?: string;
     value_json?: JsonValue;
     random_queue?: number[];

package/dist/profile.js

@@ -23,7 +23,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-62JD4MJA.js";
+} from "./chunk-T664I6R3.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.179",
+  "version": "0.7.181",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",