@yuzc-001/grasp 0.6.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (78) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +327 -0
  3. package/README.zh-CN.md +324 -0
  4. package/examples/README.md +31 -0
  5. package/examples/claude-desktop.json +8 -0
  6. package/examples/codex-config.toml +4 -0
  7. package/grasp.skill +0 -0
  8. package/index.js +87 -0
  9. package/package.json +48 -0
  10. package/scripts/grasp_openclaw_ctl.sh +122 -0
  11. package/scripts/run-search-benchmark.mjs +287 -0
  12. package/scripts/update-star-history.mjs +274 -0
  13. package/skill/SKILL.md +61 -0
  14. package/skill/references/tools.md +306 -0
  15. package/src/cli/auto-configure.js +116 -0
  16. package/src/cli/cmd-connect.js +148 -0
  17. package/src/cli/cmd-explain.js +42 -0
  18. package/src/cli/cmd-logs.js +55 -0
  19. package/src/cli/cmd-status.js +119 -0
  20. package/src/cli/config.js +27 -0
  21. package/src/cli/detect-chrome.js +58 -0
  22. package/src/grasp/handoff/events.js +67 -0
  23. package/src/grasp/handoff/persist.js +48 -0
  24. package/src/grasp/handoff/state.js +28 -0
  25. package/src/grasp/page/capture.js +34 -0
  26. package/src/grasp/page/state.js +273 -0
  27. package/src/grasp/verify/evidence.js +40 -0
  28. package/src/grasp/verify/pipeline.js +52 -0
  29. package/src/layer1-bridge/chrome.js +416 -0
  30. package/src/layer1-bridge/webmcp.js +143 -0
  31. package/src/layer2-perception/hints.js +284 -0
  32. package/src/layer3-action/actions.js +400 -0
  33. package/src/runtime/browser-instance.js +65 -0
  34. package/src/runtime/truth/model.js +94 -0
  35. package/src/runtime/truth/snapshot.js +51 -0
  36. package/src/server/affordances.js +47 -0
  37. package/src/server/audit.js +122 -0
  38. package/src/server/boss-fast-path.js +164 -0
  39. package/src/server/boundary-guard.js +53 -0
  40. package/src/server/content.js +97 -0
  41. package/src/server/continuity.js +256 -0
  42. package/src/server/engine-selection.js +29 -0
  43. package/src/server/entry-orchestrator.js +115 -0
  44. package/src/server/error-codes.js +7 -0
  45. package/src/server/explain-share-card.js +113 -0
  46. package/src/server/fast-path-router.js +134 -0
  47. package/src/server/form-runtime.js +602 -0
  48. package/src/server/form-tasks.js +254 -0
  49. package/src/server/gateway-response.js +62 -0
  50. package/src/server/index.js +22 -0
  51. package/src/server/observe.js +52 -0
  52. package/src/server/page-projection.js +31 -0
  53. package/src/server/page-state.js +27 -0
  54. package/src/server/postconditions.js +128 -0
  55. package/src/server/prompt-assembly.js +148 -0
  56. package/src/server/responses.js +44 -0
  57. package/src/server/route-boundary.js +174 -0
  58. package/src/server/route-policy.js +168 -0
  59. package/src/server/runtime-confirmation.js +87 -0
  60. package/src/server/runtime-status.js +7 -0
  61. package/src/server/share-artifacts.js +284 -0
  62. package/src/server/state.js +132 -0
  63. package/src/server/structured-extraction.js +131 -0
  64. package/src/server/surface-prompts.js +166 -0
  65. package/src/server/task-frame.js +11 -0
  66. package/src/server/tasks/search-task.js +321 -0
  67. package/src/server/tools.actions.js +1361 -0
  68. package/src/server/tools.form.js +526 -0
  69. package/src/server/tools.gateway.js +757 -0
  70. package/src/server/tools.handoff.js +210 -0
  71. package/src/server/tools.js +20 -0
  72. package/src/server/tools.legacy.js +983 -0
  73. package/src/server/tools.strategy.js +250 -0
  74. package/src/server/tools.task-surface.js +66 -0
  75. package/src/server/tools.workspace.js +873 -0
  76. package/src/server/workspace-runtime.js +1138 -0
  77. package/src/server/workspace-tasks.js +735 -0
  78. package/start-chrome.bat +84 -0
@@ -0,0 +1,84 @@
1
+ @echo off
2
+ echo ===================================================
3
+ echo Grasp - Starting Chrome with Remote Debug Port
4
+ echo ===================================================
5
+ echo.
6
+
7
+ :: Step 1: Check port 9222 and verify browser has visible tabs
8
+ :: Edge/Chrome keeps background processes alive after closing all windows,
9
+ :: leaving port 9222 occupied by zombie processes - a bare port check is not enough.
10
+ powershell -NoProfile -Command "try { $r=[System.Net.WebRequest]::Create('http://localhost:9222/json'); $r.Timeout=5000; $s=New-Object IO.StreamReader($r.GetResponse().GetResponseStream()); $j=$s.ReadToEnd(); $s.Close(); if($j -match '\"type\":\s*\"page\"'){exit 0}else{exit 1} } catch { exit 2 }"
11
+
12
+ if %errorlevel%==0 (
13
+ echo [OK] Grasp Chrome is already running. Ready!
14
+ goto :done
15
+ )
16
+ if %errorlevel%==2 goto :find_chrome
17
+
18
+ :: Port responds but no visible page tabs - stale background processes
19
+ echo [*] Browser closed but background processes still running. Cleaning up...
20
+ powershell -NoProfile -Command "Get-CimInstance Win32_Process | Where-Object { $_.CommandLine -like '*chrome-grasp*' } | ForEach-Object { Stop-Process -Id $_.ProcessId -Force -ErrorAction SilentlyContinue }"
21
+ timeout /t 2 /nobreak >nul
22
+ echo [OK] Stale processes cleaned.
23
+ echo.
24
+
25
+ :: Step 2: Find Chrome or Edge executable
26
+ :find_chrome
27
+ set "CHROME_EXE="
28
+
29
+ if exist "C:\Program Files\Google\Chrome\Application\chrome.exe" (
30
+ set "CHROME_EXE=C:\Program Files\Google\Chrome\Application\chrome.exe"
31
+ goto :found
32
+ )
33
+
34
+ if exist "C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" (
35
+ set "CHROME_EXE=C:\Program Files (x86)\Google\Chrome\Application\chrome.exe"
36
+ goto :found
37
+ )
38
+
39
+ if exist "%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe" (
40
+ set "CHROME_EXE=%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe"
41
+ goto :found
42
+ )
43
+
44
+ if exist "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" (
45
+ set "CHROME_EXE=C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe"
46
+ goto :found
47
+ )
48
+
49
+ if exist "C:\Program Files\Microsoft\Edge\Application\msedge.exe" (
50
+ set "CHROME_EXE=C:\Program Files\Microsoft\Edge\Application\msedge.exe"
51
+ goto :found
52
+ )
53
+
54
+ echo [ERROR] Chrome/Edge not found. Please install Chrome or Edge, or set CHROME_EXE manually.
55
+ pause
56
+ exit /b 1
57
+
58
+ :found
59
+ echo [OK] Found Chrome: %CHROME_EXE%
60
+ echo [*] Starting Grasp Chrome (dedicated profile)...
61
+ echo.
62
+
63
+ :: Step 3: Launch Chrome with remote debugging
64
+ start "" "%CHROME_EXE%" --remote-debugging-port=9222 --user-data-dir="%USERPROFILE%\chrome-grasp" --no-first-run --no-default-browser-check --start-maximized
65
+
66
+ :: Step 4: Wait for port to be ready (max 30 seconds)
67
+ echo [*] Waiting for Chrome to be ready...
68
+ powershell -NoProfile -Command "for($i=0;$i -lt 30;$i++){Start-Sleep 1;try{$r=[System.Net.WebRequest]::Create('http://localhost:9222/json/version');$r.Timeout=5000;$null=$r.GetResponse();exit 0}catch{}}; exit 1"
69
+
70
+ if errorlevel 1 (
71
+ echo [ERROR] Chrome did not start in time.
72
+ pause
73
+ exit /b 1
74
+ )
75
+
76
+ :: Step 5: Success
77
+ echo [OK] Grasp Chrome is ready!
78
+ echo.
79
+ echo NOTE: This is a dedicated browser window for AI control.
80
+ echo First time? Please log in to your accounts here - logins are saved permanently.
81
+
82
+ :done
83
+ echo.
84
+ pause