@wenathlan/saddle 1.8.16 → 1.8.18

package/docs/plans/11.movement.logs.json.md

@@ -1,72 +0,0 @@
-# 11 Movement Logs Json
-
-## Location
-- Directory: `docs/logs/`
-- File: `<sessionId>.json` (example: `docs/logs/examplesession.json`).
-
-## File structure
-
-```json
-{
-  "version": 1,
-  "session": {
-    "id": "sess_01J9XEXAMPLE0001",
-    "agentName": "UKA-capture",
-    "browser": "brave",
-    "originUrl": "https://accounts.hcaptcha.com/demo",
-    "seed": "session-42",
-    "personality": "careful",
-    "viewport": { "width": 1280, "height": 800 },
-    "startedAt": "2026-07-16T12:00:00.000Z",
-    "finishedAt": "2026-07-16T12:03:21.000Z",
-    "status": "passed"
-  },
-  "events": [
-    { "t": 0.0,    "type": "move",   "x": 640, "y": 60,  "tx": 640, "ty": 60 },
-    { "t": 12.4,   "type": "move",   "x": 700, "y": 420, "tx": 700, "ty": 420 },
-    { "t": 220.1,  "type": "click",  "x": 711, "y": 433, "button": "left", "target": "#checkbox" },
-    { "t": 540.0,  "type": "scroll", "dx": 0,   "dy": -120, "angle": 0 },
-    { "t": 900.5,  "type": "drag",   "x0": 100, "y0": 100, "x1": 300, "y1": 300 },
-    { "t": 1200.0, "type": "key",    "key": "Enter", "target": "#submit" }
-  ],
-  "captcha": {
-    "kind": "hcaptcha",
-    "sitekey": "a9b5fb07-92ff-493f-86fe-352a2803b3df",
-    "passed": true,
-    "solver": "vlm",
-    "evidenceUrl": "https://res.cloudinary.com/uka/sess_01J9XEXAMPLE0001/hcaptcha.png"
-  },
-  "metrics": {
-    "eventCount": 1284,
-    "durationMs": 201000,
-    "avgMouseSpeed": 2.3,
-    "clickCount": 7
-  }
-}
-```
-
-## Event fields (`events[]`)
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `t` | number | relative time in ms since start |
-| `type` | string | `move` \| `click` \| `drag` \| `scroll` \| `key` |
-| `x`,`y` | number | viewport coordinates (end of action) |
-| `tx`,`ty` | number | target coordinates (element) when applicable |
-| `button` | string | `left` \| `right` (click) |
-| `x0,y0,x1,y1` | number | start/end points (drag) |
-| `dx,dy` | number | delta (scroll) |
-| `angle` | number | rotation/scroll angle |
-| `key` | string | key (key event) |
-| `target` | string | selector/role/target (optional) |
-
-## Conventions
-- Coordinates in css pixels of the viewport.
-- `t` in ms relative (deterministic by `seed`).
-- Long move trajectories may be compacted (collapse runs) before save.
-- Every log is reproducible from `seed` + `events`.
-
-## Usage
-- `replay.js` rereads the json and redispatches events in brave (configurable speed).
-- `d3` plots the mouse trail from `events[]` for audit/debug.
-- Evidence (screenshot/mp4) referenced via `captcha.evidenceUrl` (cloudinary).

package/docs/plans/12.research.atlas.agent.browser.md

@@ -1,79 +0,0 @@
-# 12 research atlas agent browser
-
-date: 2026-07-16
-status: research-complete
-classification: computer use / agent browser / captcha bypass / sandbox
-
-## summary
-
-atlas is a real browser with 30 modes whose primary job is to bypass hcaptcha so the uka agent can act, and to serve the agent and the sandbox. it ships with our own database on vercel and netlify. this document surveys public repositories with the same classification so we can mirror proven patterns and avoid dead ends.
-
-## axis used for comparison
-
-- computer use / agent browser
-- stealth (fingerprint, tls, behavior)
-- captcha bypass (hcaptcha / recaptcha / turnstile)
-- sandbox (microvm, isolation)
-- own backend + database
-
-## a agent browsers and computer use
-
-| repository | stars | language | stealth | captcha | notes |
-|---|---|---|---|---|---|
-| vercel-labs/agent-browser | ~38k | rust | plugin (stealth) | plugin (captcha) | fast native cli, mcp, serverless vercel sandbox, plugin system for captcha/stealth/vault |
-| jcpsimmons/agent-browser | low | rust | on by default | - | fork of vercel-labs/agent-browser with stealth enabled by default |
-| AshtonVaughan/agentbrowser | low | typescript | webgl/canvas/audio noise | 2captcha / hcaptcha / turnstile | visible svg cursor via cdp, traces to jsonl, audit trail, verify pipeline |
-| gokul2507/Agent-Browser | low | typescript | - | - | dual engine lightpanda + chromium, 60 mcp tools, rest api, js/python sdks, web dashboard |
-| ykshah1309/stealth-agent-browser-mcp | low | typescript | rebrowser-playwright | capsolver / 2captcha | stealth chromium mcp, hybrid aom + set-of-mark vision, human mouse (ghost-cursor) |
-| AVANT-ICONIC/Talox | low | typescript | 19-layer js stack | challenge detect | local browser runtime, humanmouse (bezier + fitts), single json contract, overlay |
-| clark-labs-inc/clark-browser | ~116 | python / c++ | patched chromium source | - | stealth chromium built from ungoogled-chromium fork, fingerprint fixes in browser source |
-| shayuc137/agentcloak | low | typescript | cloakbrowser 57 patches | - | stealth browser toolkit, cli + mcp, remotebridge to real chrome |
-| runagent-dev/runagent-superbrowser | low | typescript / python | persistent profiles | 2captcha / nopecha / human | browser your agent won't get blocked on, human handoff via live-view url |
-| VirixLabs/humanbrowser | low | typescript | patchright / camoufox | included (many types) | cloud chromium, residential proxy pool, a2a 1.0 + mcp endpoints |
-| browser-use/browser-use | high | python | cloud option | cloud option | leading open-source browser agent, 1000+ integrations, cloud for stealth |
-| yoloshii/better-browser-use | low | python | tiered (cloak / patchright / camoufox) | capsolver / 2captcha | aria snapshots, 3 stealth tiers, humanization, webmcp |
-| andyless/human-browser-use | low | python | stealth js | - | human behavior extension for browser-use (bezier mouse, lognormal typing) |
-| Huzy85/fantoma | low | python | camoufox / patchright | detect + solve | accessibility-api browser agent, zero pointer telemetry, 25 real sites |
-| cyberranger93/mcp-browser | low | typescript | fingerprint spoof | - | stealth browser mcp, origin allowlist, network trace |
-
-## b captcha bypass and hcaptcha solvers
-
-| repository | language | captcha types | method |
-|---|---|---|---|
-| QIN2DIM/hcaptcha-challenger | python | hcaptcha (binary/area/drag) | multimodal llm, onnx models (resnet / yolo v8 / vit) |
-| interfluve-wav/auto-captcha-solver | python | hcaptcha, recaptcha v2/v3, turnstile | nopecha token api, mcp server, cli |
-| multibot-solver/hcaptcha-click-solver | python | hcaptcha (checkbox/grid/canvas/drag) | multibot api classification + exact mouse path replay |
-| ScremerMemer/hCaptcha-Solver | python | hcaptcha | camoufox hsw token + groq vision + multibot mouse generation |
-| rishugren03/computer-agent | python | recaptcha v2 | patchright + deepseek/gemini vision, bezier mouse |
-| clawdbrunner/captcha-solver | python | 30+ types | cloakbrowser prevention + 2captcha/capsolver fallback |
-
-## c sandbox for ai (microvm isolation)
-
-| repository | tech | notes |
-|---|---|---|
-| vercel/sandbox | firecracker microvm | ephemeral compute primitive, @vercel/sandbox sdk, credential brokering |
-| vercel-labs/ai-sdk-computer-use | vercel sandbox + next.js | claude computer use inside sandbox with chrome, novnc streaming |
-| vercel-labs/sandcastle | vercel sandbox | web linux desktop, neon postgres + drizzle orm, @vercel/sandbox |
-| firecracker-microvm/firecracker | firecracker (rust) | microvm tech behind vercel sandbox and aws lambda |
-| mattbucci/agent-sandbox | firecracker (kvm) | one vm per agent, xfce desktop + chromium, per-vm domain filtering, novnc |
-| vercel-labs/agent-browser | vercel sandbox | agent-browser + chrome inside ephemeral microvm, no external server |
-
-## how atlas differentiates
-
-atlas sits at the intersection of the three groups above with two rare-together differentiators:
-
-1. real browser across 30 modes. most competitors are a cli (vercel-labs/agent-browser), a python library (browser-use), or a patched chromium (clark-browser). atlas is a library that works with/without across computer, browser, cli, binary, headless and the other modes in 01-architecture.
-2. own backend + database. unlike cloud-only tools (humanbrowser, browser-use cloud), uka deploys its own site to vercel/netlify with drizzle + mysql2 + prisma and cloudinary, and talks to it over https post/get. movement logs and captcha evidence persist in our db, not a third party.
-
-captcha bypass in atlas follows the proven pattern from the survey: stealth (fingerprint + behavior) as primary layer, hcaptcha solving (vlm or token api) as fallback for the ~1-5 percent of sessions that still get flagged, exactly the p1/p2/p3 layering used by stealth-agent-browser-mcp.
-
-## positioning of uka / atlas
-
-atlas sits at the intersection of the three groups above with two rare-together differentiators:
-
-1. real browser across 30 modes. most competitors are a cli (vercel-labs/agent-browser), a python library (browser-use), or a patched chromium (clark-browser). atlas is a library that works with/without across computer, browser, cli, binary, headless and the other modes in 01-architecture.
-2. own backend + database. unlike cloud-only tools (humanbrowser, browser-use cloud), uka deploys its own site to vercel/netlify with drizzle + mysql2 + prisma and cloudinary, and talks to it over https post/get. movement logs and captcha evidence persist in our db, not a third party.
-
-## references
-
-github repositories listed above, accessed 2026-07-16. prior research in 02-research-computer-use.md, 03-research-captcha-bypass.md, 04-research-sandbox-ai.md.