@nanlogic/saccade

Node.js-only Saccade Broker, MCP adapter, and setup CLI.

npx -y @nanlogic/saccade install

Setup configures supported local Agent clients to run:

npx -y @nanlogic/saccade mcp

The MCP adapter starts or joins the loopback Broker automatically. The browser Extension connects to 127.0.0.1:32177; no binary download, Native Messaging registration, platform driver, administrator access, signing, or install hook is used.

Broker crash recovery writes only hashed session proofs, exact Tab lease metadata, and value-free command occurrence to ~/.saccade/broker-state.json. The MCP adapter keeps the usable proof only in memory and rotates it after a successful resume. Page Truth, form values, action payloads, tokens, cookies, and credentials are not persisted. A command that may have been dispatched before transport loss returns outcome_unknown and is never replayed.

Commands:

saccade mcp
saccade broker
saccade install
saccade update
saccade doctor
saccade uninstall [--purge]

Requires Node.js 18 or newer. Chrome and Edge use the same package and Extension candidate.

0.2.5: experimental object click attempts

Use with Extension 0.4.22. On eligible, precisely bound objects, click_attempt allows one software click even if the browser did not classify a control. The observed role is preserved. Use an explicit single-object operation; it is not a form-batch or reflex action. A dispatch without a verified page effect returns outcome_unknown; inspect the page before any deliberate new attempt. Never automatically replay it.

The Extension keeps up to 128 document-local attempt records in memory. Truth reports attempt_count and last_attempt without input values or page contents. Reconfiguration/revocation clears these records. Past attempts do not grant access to other tabs or bypass current disabled/hidden/protected state checks.

This release is published under an owner-approved experimental exception. Complete same-candidate interruption, revocation and performance acceptance is unfinished. Chrome and Edge Mixamo checks reached Big Vegas page content after one click attempt, but the action receipts remained dispatched and unverified. This is not a claim that every card, editor or upload control now works.

Experimental observation

Use with the matching Saccade Extension for screenshots, sampled video frames and loaded captions, and short 3D sequences from applications using the Saccade scene bridge. One observation approval covers this Agent's authorized tabs for its live session. Other Agents and unshared tabs are excluded; Stop sharing revokes access to a tab.

Video sampling may pause or seek playback. Sparse frames can miss brief events; audio is not transcribed. Scene state is application-reported, not independent proof of a correct animation. Screenshots and frames can contain personal information and are not persisted in Saccade diagnostics.

Video and 3D observation are experimental. Comparative visual-accuracy evaluation is incomplete; no accuracy, speed advantage or token savings are claimed. Low-level WebGL rendering diagnostics remain a separate prototype.

Version 0.2.4 also supports the Extension's experimental browser-native Accessibility semantics, with explicit source and degraded-mode reporting. Broader same-candidate Chrome/Edge lifecycle and performance release gates remain incomplete; this release does not establish browser-first readiness.