free-computer-use 0.2.7 → 0.2.8
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.
- package/CHANGELOG.md +7 -0
- package/README.md +4 -4
- package/dist/browser/PageCompressor.js +20 -2
- package/dist/browser/PageCompressor.js.map +1 -1
- package/docs/LOCAL_VALIDATION.md +26 -0
- package/docs/MCP.md +1 -1
- package/docs/REQUIREMENTS.md +1 -1
- package/docs/SUPPORT_MATRIX.md +5 -5
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
package/README.md
CHANGED
|
@@ -24,16 +24,16 @@
|
|
|
24
24
|
|
|
25
25
|
Use an API or supported model CLI for open-ended tasks. Skip model setup for common page-reading jobs: deterministic local strategies read visible text, links and tables without a model call.
|
|
26
26
|
|
|
27
|
-
## New in 0.2.
|
|
27
|
+
## New in 0.2.8: show when table context is partial
|
|
28
28
|
|
|
29
|
-
|
|
29
|
+
When a large table exceeds the planner's context budget, the agent keeps complete JSON rows and marks the summary as partial. It no longer cuts JSON mid-row and leaves a misleading result. Page metadata also stays bounded so controls remain visible, and follow-up plans retain unchanged controls and page text.
|
|
30
30
|
|
|
31
31
|
## No model key needed
|
|
32
32
|
|
|
33
33
|
Install the release and start the local dashboard:
|
|
34
34
|
|
|
35
35
|
```bash
|
|
36
|
-
npm install --global free-computer-use@0.2.
|
|
36
|
+
npm install --global free-computer-use@0.2.8
|
|
37
37
|
FCU_BROWSER_CHANNEL=chrome agent doctor
|
|
38
38
|
FCU_BROWSER_CHANNEL=chrome agent ui
|
|
39
39
|
```
|
|
@@ -77,7 +77,7 @@ Requires Node.js 22.13+, npm and an installed browser. The verified setup select
|
|
|
77
77
|
### Install from npm
|
|
78
78
|
|
|
79
79
|
```bash
|
|
80
|
-
npm install --global free-computer-use@0.2.
|
|
80
|
+
npm install --global free-computer-use@0.2.8
|
|
81
81
|
FCU_BROWSER_CHANNEL=chrome agent doctor
|
|
82
82
|
FCU_BROWSER_CHANNEL=chrome agent ui
|
|
83
83
|
```
|
|
@@ -41,8 +41,26 @@ export class PageCompressor {
|
|
|
41
41
|
lines.push(`[${ranked.length - retained} controls omitted]`);
|
|
42
42
|
if (state.dialogs.length)
|
|
43
43
|
lines.push('DIALOGS', ...state.dialogs);
|
|
44
|
-
if (state.tables.length)
|
|
45
|
-
|
|
44
|
+
if (state.tables.length) {
|
|
45
|
+
const tableBudget = Math.floor(max * .2), tables = state.tables.map(table => table.slice());
|
|
46
|
+
let tableText = JSON.stringify(tables), partial = false;
|
|
47
|
+
// ponytail: Re-serialize at most 125 extracted rows; stream rows if the extractor limit grows.
|
|
48
|
+
while (tableText.length > tableBudget) {
|
|
49
|
+
const last = [...tables].reverse().find(table => table.length > 1);
|
|
50
|
+
if (!last)
|
|
51
|
+
break;
|
|
52
|
+
last.pop();
|
|
53
|
+
partial = true;
|
|
54
|
+
tableText = JSON.stringify(tables);
|
|
55
|
+
}
|
|
56
|
+
if (tableText.length > tableBudget) {
|
|
57
|
+
tableText = '[]';
|
|
58
|
+
partial = true;
|
|
59
|
+
}
|
|
60
|
+
if (partial)
|
|
61
|
+
metadataTruncated = true;
|
|
62
|
+
lines.push(partial ? 'TABLES [partial; trailing rows omitted]' : 'TABLES', tableText);
|
|
63
|
+
}
|
|
46
64
|
}
|
|
47
65
|
else
|
|
48
66
|
lines.push(`INTERACTIVE COUNT ${elements.length}`, `REGIONS ${[...new Set(elements.map(e => e.region).filter(Boolean))].join(' | ')}`);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"PageCompressor.js","sourceRoot":"","sources":["../../src/browser/PageCompressor.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"PageCompressor.js","sourceRoot":"","sources":["../../src/browser/PageCompressor.ts"],"names":[],"mappings":"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"}
|
package/docs/LOCAL_VALIDATION.md
CHANGED
|
@@ -40,6 +40,32 @@ keys, cookies, or user data.
|
|
|
40
40
|
|
|
41
41
|
## Recent local gate results
|
|
42
42
|
|
|
43
|
+
The v0.2.7 source commit `1f1d698` passed `FCU_BROWSER_CHANNEL=chrome npm run
|
|
44
|
+
validate` on 27 September 2026: 140/140 tests in 181.90 seconds, type-check,
|
|
45
|
+
build, security scan (270 worktree files, 272 historical paths, 1,293
|
|
46
|
+
historical blobs; no recognized credentials or private-state paths), and npm
|
|
47
|
+
audit with zero vulnerabilities. Environment: macOS `26.6`, Apple Silicon,
|
|
48
|
+
Node `25.9.0`, npm `11.12.1`, and system Chrome `154.0.8037.57`. No live model
|
|
49
|
+
request was made.
|
|
50
|
+
|
|
51
|
+
The published 1,159,154-byte npm `0.2.7` package contains 135 files. Its
|
|
52
|
+
registry tarball and GitHub release asset match the candidate byte for byte;
|
|
53
|
+
SHA-256 is
|
|
54
|
+
`6475e541625d21cf8104aca6b9c371664b55b07986f29bd9b7599af3903e52bc`, and npm
|
|
55
|
+
integrity is
|
|
56
|
+
`sha512-0oopdeOZChCMFU2P60/SPQOyerYRsgV4rXhTWxdcsB9GapGRz0qnFfHekffMZVZfpsqT5y/BK91bueMoxd0w2A==`.
|
|
57
|
+
npm reports `0.2.7` as `latest`. A fresh-prefix install from the registry
|
|
58
|
+
tarball reports `agent --version` as `0.2.7`; `agent doctor` passes Chrome
|
|
59
|
+
launch. The read-only public practice-table task returns three rows with one
|
|
60
|
+
browser action, no failed actions and zero model calls. The GitHub release
|
|
61
|
+
checksum passes, and its two downloaded assets match the tested package and
|
|
62
|
+
checksum file.
|
|
63
|
+
|
|
64
|
+
GitHub Pages built the v0.2.7 site from commit `1f1d698`; the homepage returned
|
|
65
|
+
HTTP 200. Playwright confirmed the release copy and four v0.2.7 links, no
|
|
66
|
+
horizontal overflow at 320/390/768/1440 px, and no console errors. No workflow
|
|
67
|
+
was enabled or dispatched.
|
|
68
|
+
|
|
43
69
|
The v0.2.6 source commit `c4aacf1` passed `FCU_BROWSER_CHANNEL=chrome npm run
|
|
44
70
|
validate` on 27 September 2026: 139/139 tests in 220.32 seconds, type-check,
|
|
45
71
|
build, security scan (269 worktree files, 271 historical paths, 1,279
|
package/docs/MCP.md
CHANGED
package/docs/REQUIREMENTS.md
CHANGED
|
@@ -22,7 +22,7 @@ Chromium integration tests, real Flash runs and result-checked benchmark traces.
|
|
|
22
22
|
| 42–48: modules, validation/security/injection, goal tracking, loops/hashes | Separate replaceable modules, fixed browser API, escaped untrusted content, preserved original goal, trusted criteria, max steps/repairs/repeated states/navigation checks |
|
|
23
23
|
| 49–60: KPIs, benchmark suite, zero-call reuse, local intelligence, compact structured context | Metrics/reports; six local plus fourteen public scenarios; result oracles and provider-free compatible repeats; semantic workflows, local similarity/form mapping, JSON outputs, bounded completed-action summary |
|
|
24
24
|
| 61–63: demo, README and diagrams | Real multi-page synthetic application plus contact/demo, broader free sandbox cases, runnable README and architecture diagram, actual UI screenshots |
|
|
25
|
-
| 64–65: naming and developer experience | Existing workspace name retained; GitHub repo created; local and global npm install/config/dev, source and built CLI, browser install documented; published npm `0.2.
|
|
25
|
+
| 64–65: naming and developer experience | Existing workspace name retained; GitHub repo created; local and global npm install/config/dev, source and built CLI, browser install documented; published npm `0.2.7` install, doctor, oversized-goal rejection before a provider call and public synthetic table task verified; published `0.2.0` MCP tool discovery verified |
|
|
26
26
|
| 66–68: real tests, local website, failures | Chromium unit/integration/UI checks with local lab; missing/replaced/duplicate controls, delayed content, validation, frame/tab changes, approval rejection, schema/budget failures and repair |
|
|
27
27
|
| 69–70: incremental phases and working MVP | Incremental main commits pushed. Actual API tasks open/observe/compress/plan/execute/verify/repair, print metrics and store traces |
|
|
28
28
|
| 71–74: deterministic-first philosophy and compiler-like vision | Local strategies and workflow matching precede provider calls. Arbitrary-site permanent workflow transfer remains a longer-term goal |
|
package/docs/SUPPORT_MATRIX.md
CHANGED
|
@@ -33,13 +33,13 @@ parameters, endpoint and terms before use.
|
|
|
33
33
|
| Area | Declared or implemented | Verified evidence | Limit |
|
|
34
34
|
| --- | --- | --- | --- |
|
|
35
35
|
| MCP host integration | Local `stdio` server, MCP TypeScript SDK `2.0.0`; tools start, inspect, follow/verify and stop a browser task. | On 24 September 2026, four focused tests passed with the official TypeScript MCP client. MCP Inspector 2.8.0 connected to the built CLI, displayed site approval and declined it; the task failed with zero model calls and zero fixture requests. On 26 September, the published `free-computer-use@0.2.0` package launched from a fresh prefix on Node `22.13.0`; the official client listed all four tools over `stdio`. | The package smoke covers launch and tool discovery, not task execution through the published package. Inspector covers the built CLI. Other desktop hosts remain unverified; approvals require form elicitation. |
|
|
36
|
-
| Node.js | `package.json` declares an install floor of Node `>=22.13.0`; this does not certify every release in that range. | The v0.2.
|
|
37
|
-
| Browser engine | Playwright `1.63.0`; defaults to its matching Chromium. Optional `FCU_BROWSER_CHANNEL` selects installed Chrome/Edge to avoid a browser download. | System Chrome `154.0.8037.57` passed the full
|
|
36
|
+
| Node.js | `package.json` declares an install floor of Node `>=22.13.0`; this does not certify every release in that range. | The v0.2.7 code passed `FCU_BROWSER_CHANNEL=chrome npm run validate` with 140/140 tests on Node `25.9.0`, including type checks, build, history scan and npm audit (zero vulnerabilities). Earlier gates passed 139/139 on v0.2.6, 138/138 on v0.2.5 and 133/133 on Node `22.13.0` and `25.9.0` after proxy-cancellation changes. Runtime: macOS `26.6`, Apple Silicon and system Chrome `154.0.8037.57`. | Other Node releases and Windows/Linux have not been validated. Node `22.13.0` emits the expected experimental `node:sqlite` warning. |
|
|
37
|
+
| Browser engine | Playwright `1.63.0`; defaults to its matching Chromium. Optional `FCU_BROWSER_CHANNEL` selects installed Chrome/Edge to avoid a browser download. | System Chrome `154.0.8037.57` passed the full 140/140 serial suite on Node `25.9.0` for v0.2.7, after 139/139 on v0.2.6, 138/138 on v0.2.5, 137/137 on v0.2.4, 136/136 on v0.2.3, 135/135 on v0.2.2 and 133/133 on Node `22.13.0` and `25.9.0` after proxy-cancellation changes. `FCU_BROWSER_CHANNEL=chrome npm run demo -- --headed --contact` also completed seven local actions with zero model calls and exited cleanly on 24 September 2026. | Matching Playwright Chromium is absent. Playwright warns that non-bundled browsers may be incompatible. Other browser builds and operating systems remain unverified. No browser was downloaded. |
|
|
38
38
|
| Browser task behavior | DOM observation, bounded action plans, origin/action approvals, result checks and compatible workflow replay are implemented. A loopback-only Chromium DevTools Protocol connection attaches to page targets before navigation and checks redirect hops. A second loopback proxy enforces origin policy for HTTP(S)/WebSocket traffic, blocks private/reserved DNS answers and checks private IPv4 embedded in prefixes learned through `ipv4only.arpa`. The persistent Chromium profile disables WebRTC UDP that the proxy cannot carry. Explicit IP literals need exact origin approval. Ultra/`allowExternal` opts out of origin and private-address checks. Closing the active page cancels its run and pending approval. | On 24 September, the dashboard was changed to reuse one `Agent` and Chromium context between tasks, opening a fresh tab for each task. Regression checks confirm dashboard replay keeps the same context, all eight lab workflows replay in that context, and the persistent network proxy reapplies private-address policy when the mode changes. The clean serial full suite passed 101/101 on system Chrome `154.0.8037.57`, macOS `26.6`, Node `25.9.0`. Security cases include popup redirects, simulated DNS rebinding, reserved ranges, normal/Ultra behavior and approved/blocked WebSockets. A Chrome-originated WSS fixture returns a frame through the proxy; its generated local certificate is ignored. A separate opt-in `security:wss` smoke connected to Postman Echo with Chrome’s normal TLS validation and received its synthetic message. Synthetic DNS64 fixtures cover all six RFC 6052 prefix lengths; actual NAT64 discovery remains unverified. A local STUN receiver got no WebRTC UDP packets. | Before context reuse, relaunching Chrome `154.0.8037.57` with the same persistent profile caused a `SIGSEGV` on 23 September; the `.ips` report identifies `CrBrowserMain` and `EXC_BAD_ACCESS`. The dashboard now avoids this process boundary, and its full local regression suite passes. Reopening the same profile through a standalone Playwright process remains unverified. Matching Playwright Chromium is absent; no browser was downloaded. Live NAT64 discovery, other trusted WSS endpoints, non-HTTP traffic beyond the WebRTC STUN fixture, other browser builds, Windows/Linux and universal website success remain unverified. WebRTC services needing direct UDP may fail. |
|
|
39
39
|
| Vision and canvas | Local screenshots/preview exist. | Screenshot paths are documented as local. | Images are not sent to the model; model vision and visual-only/canvas control are not implemented. |
|
|
40
|
-
| npm package | The ESM package exposes a library and global `agent` command. | npm reports `0.2.
|
|
41
|
-
| GitHub release / archive | Public release `v0.2.
|
|
42
|
-
| GitHub Pages site | Static product homepage, lab and scenario library are served from `main /docs`. | The v0.2.
|
|
40
|
+
| npm package | The ESM package exposes a library and global `agent` command. | npm reports `0.2.7` as `latest` with integrity `sha512-0oopdeOZChCMFU2P60/SPQOyerYRsgV4rXhTWxdcsB9GapGRz0qnFfHekffMZVZfpsqT5y/BK91bueMoxd0w2A==`. The 1,159,154-byte registry tarball SHA-256 `6475e541625d21cf8104aca6b9c371664b55b07986f29bd9b7599af3903e52bc` matches the tested candidate and GitHub release asset byte for byte. A fresh-prefix install from the downloaded registry tarball on Node `25.9.0` passed `agent doctor` and Chrome launch; the public practice-table task returned three rows with one browser action and zero model calls. | Package task and runtime were checked on macOS `26.6`/Apple Silicon with system Chrome `154.0.8037.57`; other OS/browser combinations remain unverified. MCP package smoke covers discovery, not task execution or approvals. |
|
|
41
|
+
| GitHub release / archive | Public release `v0.2.7`, published 27 September 2026. | Release includes `free-computer-use-0.2.7.tgz` and `fcu-release-0.2.7-SHA256SUMS`; SHA-256 `6475e541625d21cf8104aca6b9c371664b55b07986f29bd9b7599af3903e52bc` matches the npm registry download. Both assets were downloaded; the checksum passed and the tarball matches the npm package byte for byte. A fresh-prefix install from the release asset passed `agent doctor`. | Archive requires Node.js, npm and a supported installed browser; no standalone native executable is offered. |
|
|
42
|
+
| GitHub Pages site | Static product homepage, lab and scenario library are served from `main /docs`. | The v0.2.7 Pages build completed at commit `1f1d698`; homepage returned HTTP 200. Playwright checked the updated release copy, four v0.2.7 links, widths 320/390/768/1440 and zero console errors or horizontal overflow. | This verifies one desktop Chromium environment. Windows/Linux, other browsers and assistive-technology hardware remain unverified. |
|
|
43
43
|
| GitHub Actions | No workflow files are tracked in the checkout. | `git ls-files '.github/workflows/*'` returned no workflow; no workflow was activated or dispatched. `docs/LOCAL_VALIDATION.md` records the owner instruction. | Local checks remain the validation route unless the owner changes that instruction. |
|
|
44
44
|
|
|
45
45
|
## Validation snapshot for this implementation session
|
package/package.json
CHANGED