unbrowse 11.1.8 → 11.1.9
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/README.md +8 -10
- package/package.json +1 -1
- package/runtime/cli.js +809 -933
- package/runtime/mcp.js +795 -920
- package/vendor/kuri/darwin-arm64/libkuri_ffi.dylib +0 -0
- package/vendor/kuri/darwin-x64/libkuri_ffi.dylib +0 -0
- package/vendor/kuri/linux-x64/kuri +0 -0
- package/vendor/kuri/linux-x64/libkuri_ffi.so +0 -0
- package/vendor/kuri/manifest.json +6 -6
- package/vendor/kuri/win-x64/kuri.exe +0 -0
package/README.md
CHANGED
|
@@ -3,15 +3,14 @@
|
|
|
3
3
|
**Get one internet result from one typed hole; index the route when the runtime has to discover it.** The agent
|
|
4
4
|
supplies intent plus optional URL/params/approval. Unbrowse chooses the cheapest capable
|
|
5
5
|
layer — route graph, installed skill, adapter, local primitive, browser capture with local
|
|
6
|
-
cookies/HAR — and returns a
|
|
6
|
+
cookies/HAR — and returns a structured result. If it had to discover a route, that
|
|
7
7
|
route can be indexed so every later agent gets the fast path.
|
|
8
8
|
|
|
9
9
|
One agent learns a site once. Every later agent gets the fast path.
|
|
10
10
|
|
|
11
|
-
> **Primary surface:
|
|
12
|
-
> agents to ask for one result, not juggle a dozen route/debug verbs. The
|
|
13
|
-
> `
|
|
14
|
-
> the SDK expression is `createHole().fill(...)`. Old
|
|
11
|
+
> **Primary surface: one task-shaped request.** `SKILL.md` (shipped in this package) teaches
|
|
12
|
+
> agents to ask for one result, not juggle a dozen route/debug verbs. The CLI expression is
|
|
13
|
+
> `unbrowse "task" [--url <url>]`; the SDK expression is `createHole().fill(...)`. Old
|
|
15
14
|
> `resolve`/`execute`/`go`/`snap` CLI verbs remain as advanced compatibility and debugging
|
|
16
15
|
> surfaces. **MCP is legacy** — still supported, but no longer the recommended path.
|
|
17
16
|
|
|
@@ -29,7 +28,6 @@ forage "top stories" --url https://news.ycombinator.com # pollen · waggle ·
|
|
|
29
28
|
```
|
|
30
29
|
|
|
31
30
|
```bash
|
|
32
|
-
curl https://beta-api.unbrowse.ai/v1/contract/surface # inspect the current hole/contract bridge
|
|
33
31
|
unbrowse "top stories with points"
|
|
34
32
|
unbrowse "top stories with points" --url https://news.ycombinator.com
|
|
35
33
|
```
|
|
@@ -43,7 +41,7 @@ Unbrowse is a **local, stateless CLI**. Each invocation runs an in-process runti
|
|
|
43
41
|
only when a task actually needs a live browser. Credentials and sensitive inputs never leave
|
|
44
42
|
your machine; only sanitized route metadata is shared when you publish.
|
|
45
43
|
|
|
46
|
-
###
|
|
44
|
+
### One Request, Cheapest-Capable Descent
|
|
47
45
|
|
|
48
46
|
The client exposes holes only:
|
|
49
47
|
|
|
@@ -51,10 +49,10 @@ The client exposes holes only:
|
|
|
51
49
|
- `account_proof` — the identity/authorization proof.
|
|
52
50
|
- `approval` — human approval for mutations or policy-sensitive actions.
|
|
53
51
|
- `local_capability_result` — what the local dispatcher returned after invoking a local tool.
|
|
54
|
-
- `typed_pointer` — server-owned pointer to a result
|
|
52
|
+
- `typed_pointer` — server-owned pointer to a result, not a secret payload.
|
|
55
53
|
|
|
56
54
|
The runtime walks the graph cheapest-capable-first and stops at the first settled witness.
|
|
57
|
-
The browser is not the agent-facing
|
|
55
|
+
The browser is not the agent-facing interface; it is the deepest fallback and the capture
|
|
58
56
|
oracle for missing routes.
|
|
59
57
|
|
|
60
58
|
### SDK: the one tool
|
|
@@ -119,7 +117,7 @@ unbrowse act upgrade
|
|
|
119
117
|
|
|
120
118
|
## Command reference
|
|
121
119
|
|
|
122
|
-
**Current path:** bare CLI ·
|
|
120
|
+
**Current path:** bare CLI · SDK `createHole().fill(...)`
|
|
123
121
|
**Advanced compatibility:** `resolve` · `execute` · `run` · `fetch` · `search` · `explain`
|
|
124
122
|
**Browse session:** `go` · `snap` · `click` · `fill` · `type` · `press` · `select` · `scroll` ·
|
|
125
123
|
`submit` · `screenshot` · `text` · `markdown` · `eval` · `back` · `forward` · `sync` · `close` ·
|