@riddledc/riddle-proof 0.7.180 → 0.7.181

package/README.md

@@ -417,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 };
     }
@@ -16679,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) => {

package/dist/cli.js

@@ -13,7 +13,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-62JD4MJA.js";
+} from "./chunk-T664I6R3.js";
 import {
   createRiddleApiClient,
   isTerminalRiddleJobStatus,
@@ -962,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) => {

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