@runcofactor/cli 0.17.0 → 0.18.0

package/dist/{dist-WW2S733L.js → dist-4COOAKY3.js}

@@ -3,8 +3,12 @@ import {
   BROWSER_LIFECYCLE_TOOLS,
   BrowserToolExecutor,
   CdpScreencastManager,
+  CpuOffloadPool,
+  CpuOffloadTimeoutError,
+  CpuOffloadWorkerError,
   CursorOverlay,
   DEFAULTS,
+  DEFAULT_CPU_OFFLOAD_TIMEOUT_MS,
   DEFAULT_VIEWPORT,
   FfmpegProcess,
   LARGE_GRID_CHAR_THRESHOLD,
@@ -34,9 +38,11 @@ import {
   compareEditingContexts,
   compareSnapshots,
   computeFingerprint,
+  configureCpuOffload,
   consoleLogger,
   cropImage,
   decodeV2Value,
+  defaultCpuOffloadSize,
   detectGrid,
   detectModal,
   detectModalFromYaml,
@@ -82,6 +88,7 @@ import {
   formatGridRow,
   formatSemanticDiff,
   formatSemanticSnapshot,
+  formatSnapshotMaybeOffloaded,
   getBrowserToolDefinitions,
   getBrowserToolDefinitionsWithLifecycle,
   getConsolidatedBrowserToolDefinitions,
@@ -92,6 +99,7 @@ import {
   hashFingerprint,
   highlightElement,
   identifyLargeGridRefs,
+  isCpuOffloadEnabled,
   isFfmpegAvailable,
   isMCPContentWithImages,
   isStableElement,
@@ -107,17 +115,19 @@ import {
   populateSearchContext,
   reconcileCellColumn,
   renderIfTimeout,
+  resolveCpuOffloadWorkerPath,
   restoreIndexedDB,
   searchElements,
   setCdpScreencastLogger,
   setPdfExtractLogger,
   setSnapshotAnalyzerLogger,
+  shutdownCpuOffload,
   sortMatchesByContext,
   withBrowserLaunchRetry,
   withRecoveryNotice,
   withRecoveryNoticeMCP,
   withToolTimeout
-} from "./chunk-MO5G5TP5.js";
+} from "./chunk-7OO3RJYR.js";
 import "./chunk-JWHYXEA2.js";
 import "./chunk-GZVCNYR4.js";
 import "./chunk-6LEZCKKV.js";
@@ -126,8 +136,12 @@ export {
   BROWSER_LIFECYCLE_TOOLS,
   BrowserToolExecutor,
   CdpScreencastManager,
+  CpuOffloadPool,
+  CpuOffloadTimeoutError,
+  CpuOffloadWorkerError,
   CursorOverlay,
   DEFAULTS,
+  DEFAULT_CPU_OFFLOAD_TIMEOUT_MS,
   DEFAULT_VIEWPORT,
   FfmpegProcess,
   LARGE_GRID_CHAR_THRESHOLD,
@@ -158,9 +172,11 @@ export {
   compareEditingContexts,
   compareSnapshots,
   computeFingerprint,
+  configureCpuOffload,
   consoleLogger,
   cropImage,
   decodeV2Value,
+  defaultCpuOffloadSize,
   detectGrid,
   detectModal,
   detectModalFromYaml,
@@ -206,6 +222,7 @@ export {
   formatGridRow,
   formatSemanticDiff,
   formatSemanticSnapshot,
+  formatSnapshotMaybeOffloaded,
   getBrowserToolDefinitions,
   getBrowserToolDefinitionsWithLifecycle,
   getConsolidatedBrowserToolDefinitions,
@@ -216,6 +233,7 @@ export {
   hashFingerprint,
   highlightElement,
   identifyLargeGridRefs,
+  isCpuOffloadEnabled,
   isFfmpegAvailable,
   isMCPContentWithImages,
   isStableElement,
@@ -231,15 +249,17 @@ export {
   populateSearchContext,
   reconcileCellColumn,
   renderIfTimeout,
+  resolveCpuOffloadWorkerPath,
   restoreIndexedDB,
   searchElements,
   setCdpScreencastLogger,
   setPdfExtractLogger,
   setSnapshotAnalyzerLogger,
+  shutdownCpuOffload,
   sortMatchesByContext,
   withBrowserLaunchRetry,
   withRecoveryNotice,
   withRecoveryNoticeMCP,
   withToolTimeout
 };
-//# sourceMappingURL=dist-WW2S733L.js.map
+//# sourceMappingURL=dist-4COOAKY3.js.map

package/dist/index.js

@@ -477,10 +477,10 @@ async function recordCliInstrumentationFailure(argv, cliVersion, stage, error) {
 }
 
 // src/index.ts
-var loadMcp = () => import("./mcp-V4GKEL2J.js").then((m) => m.runMcp);
+var loadMcp = () => import("./mcp-57VVZTXM.js").then((m) => m.runMcp);
 var loadDebugWorkflow = () => import("./debug-workflow-ZNP5XZQF.js").then((m) => m.runDebugWorkflow);
-var loadRecord = () => import("./record-LDNKS42Y.js").then((m) => m.runRecord);
-var loadSession = () => import("./session-Y6RO7GFC.js").then((m) => m.runSession);
+var loadRecord = () => import("./record-RWVGZZSW.js").then((m) => m.runRecord);
+var loadSession = () => import("./session-GDCMTNB3.js").then((m) => m.runSession);
 var loadLocal = () => import("./local-NSKOZHHA.js").then((m) => m.runLocal);
 function printVersion() {
   console.log(`canary v${version}`);
@@ -908,7 +908,7 @@ async function executeCommand(command, rest) {
     return;
   }
   if (command === "workflow") {
-    const { runWorkflow } = await import("./workflow-76EKT3DS.js");
+    const { runWorkflow } = await import("./workflow-5BFRS4CE.js");
     await runWorkflow(rest);
     return;
   }
@@ -973,7 +973,7 @@ async function executeCommand(command, rest) {
     return;
   }
   if (command === "sandbox") {
-    const { runSandbox } = await import("./sandbox-PLYUNOFX.js");
+    const { runSandbox } = await import("./sandbox-6D54ZQCG.js");
     await runSandbox(rest);
     return;
   }
@@ -993,7 +993,7 @@ async function executeCommand(command, rest) {
     return;
   }
   if (command === "trace") {
-    const { runTrace } = await import("./trace-BCSP7PCX.js");
+    const { runTrace } = await import("./trace-7LRHSPWN.js");
     await runTrace(rest);
     return;
   }

package/dist/{mcp-V4GKEL2J.js → mcp-57VVZTXM.js}

@@ -6,7 +6,7 @@ import {
 import {
   LocalBrowserHost,
   USER_PAUSED_ERROR
-} from "./chunk-JZWJFG4M.js";
+} from "./chunk-2R6544Z3.js";
 import {
   callTool,
   createSession,
@@ -35,7 +35,7 @@ import {
 } from "./chunk-32P26BZT.js";
 import {
   getBrowserToolDefinitionsWithLifecycle
-} from "./chunk-MO5G5TP5.js";
+} from "./chunk-7OO3RJYR.js";
 import "./chunk-JWHYXEA2.js";
 import "./chunk-GZVCNYR4.js";
 import "./chunk-6LEZCKKV.js";
@@ -1951,4 +1951,4 @@ async function runMcp(_argv) {
 export {
   runMcp
 };
-//# sourceMappingURL=mcp-V4GKEL2J.js.map
+//# sourceMappingURL=mcp-57VVZTXM.js.map

package/dist/{record-LDNKS42Y.js → record-RWVGZZSW.js}

@@ -86,7 +86,7 @@ async function runRecord(argv) {
     );
   }
   console.log("Launching browser...");
-  const { PlaywrightClient, consoleLogger, captureElementAtPoint } = await import("./dist-WW2S733L.js");
+  const { PlaywrightClient, consoleLogger, captureElementAtPoint } = await import("./dist-4COOAKY3.js");
   const client = new PlaywrightClient({ logger: consoleLogger });
   await client.connect({
     browserMode: "headed",
@@ -229,4 +229,4 @@ Output directory: ${outDir}`);
 export {
   runRecord
 };
-//# sourceMappingURL=record-LDNKS42Y.js.map
+//# sourceMappingURL=record-RWVGZZSW.js.map

package/dist/{sandbox-PLYUNOFX.js → sandbox-6D54ZQCG.js}

@@ -2,7 +2,7 @@ import { createRequire as __cr } from "module"; const require = __cr(import.meta
 import {
   SANDBOX_GUIDE_SECTIONS,
   printGuide
-} from "./chunk-FGB6PS2T.js";
+} from "./chunk-A6TH5VUI.js";
 import {
   apiRequest,
   selectProperty
@@ -2088,4 +2088,4 @@ export {
   parseDockerPs,
   runSandbox
 };
-//# sourceMappingURL=sandbox-PLYUNOFX.js.map
+//# sourceMappingURL=sandbox-6D54ZQCG.js.map

package/dist/{session-Y6RO7GFC.js → session-GDCMTNB3.js}

@@ -12,7 +12,7 @@ import "./chunk-PWZ4ULCB.js";
 import {
   LocalBrowserHost,
   USER_PAUSED_ERROR
-} from "./chunk-JZWJFG4M.js";
+} from "./chunk-2R6544Z3.js";
 import {
   callTool,
   createSession,
@@ -39,7 +39,7 @@ import {
   consoleLogger,
   dispatchBrowserTool,
   dispatchBrowserToolWithTimeout
-} from "./chunk-MO5G5TP5.js";
+} from "./chunk-7OO3RJYR.js";
 import "./chunk-JWHYXEA2.js";
 import "./chunk-GZVCNYR4.js";
 import "./chunk-6LEZCKKV.js";
@@ -2476,4 +2476,4 @@ export {
   buildToolArgs,
   runSession
 };
-//# sourceMappingURL=session-Y6RO7GFC.js.map
+//# sourceMappingURL=session-GDCMTNB3.js.map

package/dist/skills/optimize-cache/SKILL.md

@@ -82,6 +82,13 @@ gap. Core actions are:
 - **Mutations**: click, fill/type, select, check/uncheck, press, hover-to-open,
   navigate, file upload, drag.
 - **Assertions**: explicit verify steps and inline assertions the node declares.
+  Absence checks ("no error", "not present", "not shown", "hidden") are
+  assertions too; do not treat them as automatic gaps just because they are
+  negative. Cache them as `text_absent`, selector-backed `element_hidden`, or
+  `evaluate` when the trace DOM gives a stable predicate. Cached
+  `browser_assert` steps must include `cache.assertion.condition`; for
+  selector-backed visibility assertions, the condition may be the human target
+  label because the locator is the actual selector.
 - **Captures**: values the agent saved for downstream steps (e.g.
   `browser_evaluate` with `saveAs`). These become context extractors on the
   cache row — `declaredOutputs` stay reserved for DOM-captured values.
@@ -201,6 +208,24 @@ A verified-offline locator can still fail live (reconstructed DOMs lack JS
 state and cross-origin frames) — that is what replay healing is for. An
 UNVERIFIED locator must never be committed.
 
+Bound your effort per step. Make at most ONE alternate locator attempt for a
+step (a corrected ref, the builder, or a single hand-written chain). If the
+second offline verification still fails, STOP: mark that step a gap with a
+short reason and move to the next pending step. Never re-verify the same step
+again, and never chase a "functionally correct but the verifier is strict"
+locator across many attempts — a gapped step replays live, and finishing the
+node with finish_node always matters more than caching every step. The tool
+enforces this: once you hit the cap, verify_locator returns an `escalation`
+instruction to gap and move on; follow it immediately.
+
+For selector-backed `element_hidden` assertions, verify against the
+after-state where the element should be absent or hidden. There is no target
+ref for absence; the verifier passes when the locator resolves to zero visible
+elements in that reconstructed DOM. This is the right shape for "no error
+banner/message is shown" checks. If the absence target is broad, a broad
+locator such as `locator('text=/error/i')` is acceptable when it matches the
+configured assertion intent and verifies hidden in the after-state.
+
 
 ## Commit rules — one node, one recipe
 

package/dist/{src-ECFPDE5X.js → src-5YXGM2KB.js}

@@ -2,7 +2,7 @@ import { createRequire as __cr } from "module"; const require = __cr(import.meta
 import {
   parseTraceActions,
   reconstructSnapshots
-} from "./chunk-A4ISG3VX.js";
+} from "./chunk-U7OMQJ7V.js";
 import "./chunk-VKVL7WBN.js";
 
 // ../diagnostic-workspace/src/assemble-workspace.ts
@@ -1537,4 +1537,4 @@ export {
   writeStepRollups,
   writeSummary
 };
-//# sourceMappingURL=src-ECFPDE5X.js.map
+//# sourceMappingURL=src-5YXGM2KB.js.map

package/dist/{src-PDYXACRP.js → src-B7CPYFLS.js}

@@ -3,19 +3,21 @@ import {
   cleanupTrace,
   downloadTrace,
   filterMutationActions,
+  mergeTraceArchives,
   parseTraceActions,
   parseTraceGroups,
   reconstructSnapshots,
   toMutationIndex
-} from "./chunk-A4ISG3VX.js";
+} from "./chunk-U7OMQJ7V.js";
 import "./chunk-VKVL7WBN.js";
 export {
   cleanupTrace,
   downloadTrace,
   filterMutationActions,
+  mergeTraceArchives,
   parseTraceActions,
   parseTraceGroups,
   reconstructSnapshots,
   toMutationIndex
 };
-//# sourceMappingURL=src-PDYXACRP.js.map
+//# sourceMappingURL=src-B7CPYFLS.js.map

package/dist/{src-OWPS5DCK.js → src-GRO2QR7U.js}

@@ -3,7 +3,7 @@ import {
   parseTraceActions,
   reconstructSnapshots,
   toMutationIndex
-} from "./chunk-A4ISG3VX.js";
+} from "./chunk-U7OMQJ7V.js";
 import {
   buildLocatorString
 } from "./chunk-5GD47G2D.js";
@@ -12,7 +12,7 @@ import {
   captureSubstrateV2,
   consoleLogger,
   parseSnapshot
-} from "./chunk-MO5G5TP5.js";
+} from "./chunk-7OO3RJYR.js";
 import "./chunk-JWHYXEA2.js";
 import {
   MACRO_PATTERN,
@@ -6002,4 +6002,4 @@ export {
   verifySelectorAgainstRef,
   waitForTraceDomHydration
 };
-//# sourceMappingURL=src-OWPS5DCK.js.map
+//# sourceMappingURL=src-GRO2QR7U.js.map

package/dist/{trace-BCSP7PCX.js → trace-7LRHSPWN.js}

@@ -1,10 +1,10 @@
 import { createRequire as __cr } from "module"; const require = __cr(import.meta.url);
 import {
   runTrace
-} from "./chunk-HGPZ2QWV.js";
+} from "./chunk-E2FUQJVO.js";
 import "./chunk-VYTIJ6HJ.js";
 import "./chunk-32P26BZT.js";
-import "./chunk-MO5G5TP5.js";
+import "./chunk-7OO3RJYR.js";
 import "./chunk-JWHYXEA2.js";
 import "./chunk-GZVCNYR4.js";
 import "./chunk-6LEZCKKV.js";
@@ -12,4 +12,4 @@ import "./chunk-VKVL7WBN.js";
 export {
   runTrace
 };
-//# sourceMappingURL=trace-BCSP7PCX.js.map
+//# sourceMappingURL=trace-7LRHSPWN.js.map

package/dist/{workflow-76EKT3DS.js → workflow-5BFRS4CE.js}

@@ -1,7 +1,7 @@
 import { createRequire as __cr } from "module"; const require = __cr(import.meta.url);
 import {
   printGuide
-} from "./chunk-FGB6PS2T.js";
+} from "./chunk-A6TH5VUI.js";
 import {
   workflowToSpec
 } from "./chunk-7YJTQCPX.js";
@@ -3671,7 +3671,7 @@ async function runWorkflow(argv) {
     return;
   }
   if (subCommand === "debug" && hasFlag(rest, "--help", "-h")) {
-    const { handleWorkflowDebug } = await import("./workflow-debug-WO7D32EI.js");
+    const { handleWorkflowDebug } = await import("./workflow-debug-XGOHNZ4E.js");
     await handleWorkflowDebug(rest, "", "");
     return;
   }
@@ -3757,12 +3757,12 @@ async function runWorkflow(argv) {
       await handleWorkflowApiSequence(rest, apiUrl, token);
       break;
     case "cache": {
-      const { handleWorkflowCache } = await import("./workflow-cache-UDTTNIHT.js");
+      const { handleWorkflowCache } = await import("./workflow-cache-VVP3SPFM.js");
       await handleWorkflowCache(rest, apiUrl, token);
       break;
     }
     case "debug": {
-      const { handleWorkflowDebug } = await import("./workflow-debug-WO7D32EI.js");
+      const { handleWorkflowDebug } = await import("./workflow-debug-XGOHNZ4E.js");
       await handleWorkflowDebug(rest, apiUrl, token);
       break;
     }
@@ -3775,4 +3775,4 @@ async function runWorkflow(argv) {
 export {
   runWorkflow
 };
-//# sourceMappingURL=workflow-76EKT3DS.js.map
+//# sourceMappingURL=workflow-5BFRS4CE.js.map

package/dist/{workflow-cache-UDTTNIHT.js → workflow-cache-VVP3SPFM.js}

@@ -270,7 +270,7 @@ async function handleSubstrate(argv) {
     process.exit(1);
   }
   const actionIndex = Number(actionIndexRaw);
-  const { SubstrateMaterializer } = await import("./src-OWPS5DCK.js");
+  const { SubstrateMaterializer } = await import("./src-GRO2QR7U.js");
   const path = await import("path");
   const materializer = new SubstrateMaterializer({
     traceZipPath: path.join(workspace, "browser", "trace.zip"),
@@ -306,8 +306,8 @@ async function handleLocator(argv) {
     }
   }
   const actionIndex = Number(actionIndexRaw);
-  const { HeadlessDomSession, SubstrateMaterializer, LocatorVerifier, buildLocator } = await import("./src-OWPS5DCK.js");
-  const { parseSnapshot } = await import("./dist-WW2S733L.js");
+  const { HeadlessDomSession, SubstrateMaterializer, LocatorVerifier, buildLocator } = await import("./src-GRO2QR7U.js");
+  const { parseSnapshot } = await import("./dist-4COOAKY3.js");
   const path = await import("path");
   const session = new HeadlessDomSession();
   const materializer = new SubstrateMaterializer({
@@ -396,4 +396,4 @@ export {
   buildCacheClearBody,
   handleWorkflowCache
 };
-//# sourceMappingURL=workflow-cache-UDTTNIHT.js.map
+//# sourceMappingURL=workflow-cache-VVP3SPFM.js.map

package/dist/{workflow-debug-WO7D32EI.js → workflow-debug-XGOHNZ4E.js}

@@ -1,7 +1,7 @@
 import { createRequire as __cr } from "module"; const require = __cr(import.meta.url);
 import {
   runTrace
-} from "./chunk-HGPZ2QWV.js";
+} from "./chunk-E2FUQJVO.js";
 import {
   apiRequest
 } from "./chunk-PVWG3V62.js";
@@ -11,7 +11,7 @@ import {
   hasFlag
 } from "./chunk-VYTIJ6HJ.js";
 import "./chunk-32P26BZT.js";
-import "./chunk-MO5G5TP5.js";
+import "./chunk-7OO3RJYR.js";
 import "./chunk-JWHYXEA2.js";
 import "./chunk-GZVCNYR4.js";
 import "./chunk-6LEZCKKV.js";
@@ -874,7 +874,7 @@ async function handleMaterialize(argv, apiUrl, token) {
   const runId = requireRunId(argv);
   const workflowId = await resolveWorkflowId(argv, runId, apiUrl, token);
   const outDir = getArgValue(argv, "--out") ?? `./diag-${runId}`;
-  const { assembleWorkspace } = await import("./src-ECFPDE5X.js");
+  const { assembleWorkspace } = await import("./src-5YXGM2KB.js");
   const dataUrl = `${apiUrl}/workflows/${encodeURIComponent(workflowId)}/runs/${encodeURIComponent(runId)}/debug/materialize-data`;
   const dataRes = await fetch(dataUrl, { headers: { Authorization: `Bearer ${token}` } });
   if (!dataRes.ok) {
@@ -924,4 +924,4 @@ async function handleMaterialize(argv, apiUrl, token) {
 export {
   handleWorkflowDebug
 };
-//# sourceMappingURL=workflow-debug-WO7D32EI.js.map
+//# sourceMappingURL=workflow-debug-XGOHNZ4E.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runcofactor/cli",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -39,7 +39,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "eventsource-parser": "^3.0.0",
-    "playwright": "1.60.0",
+    "playwright": "1.61.0",
     "yaml": "^2.8.2",
     "zod": "^4.4.3"
   },
@@ -58,7 +58,7 @@
     "@chatsdet/user-events": "workspace:*",
     "@chatsdet/workflow-cache": "workspace:*",
     "@chatsdet/workflow-diff": "workspace:*",
-    "@playwright/test": "1.60.0",
+    "@playwright/test": "1.61.0",
     "@types/node": "^25.8.0",
     "tsup": "^8.5.0",
     "typescript": "^6.0.3"