@gaiventures/pilotfish-mcp 0.1.5 → 0.1.6

package/README.md

@@ -89,7 +89,7 @@ loopback server answers only loopback `Host` headers (DNS rebinding). Set `PILOT
 | `browser_select` `{ref, values}` | Pick `<select>` option(s) by label or value. |
 | `browser_press` `{key}` | A key or shortcut (`Enter`, `Escape`, `Control+a`). |
 | `browser_scroll` `{direction}` | Scroll about one screen; returns the screen it shows. |
-| `browser_actions` `{actions}` | Up to 10 steps in one call (`click`, `type`, `select`, `press`, `scroll`, `wait` by ref), e.g. a form's fields then submit; each goes through the same checks as its own tool. Stops at the first that fails or after one that moves the page to another address. |
+| `browser_actions` `{actions}` | Up to 10 steps in one call, each `{action, …}`: `click`, `select` and `type` take a `ref`; `type` takes `text` (and `submit`), `select` `values`, `press` `key`, `scroll` `direction`, `wait` `seconds`. E.g. a form's fields then submit; each goes through the same checks as its own tool, and a step missing a field, or with another action's, is refused before any step runs. Stops at the first that fails or after one that moves the page to another address. |
 | `browser_query` `{expression}` | Read just the values you need with a read-only JavaScript expression (JSON, at most 4,000 characters): a results list, prices, counts. It runs in a world of its own where clicks, typing, submits and network writes are refused. The cheapest way to read. |
 | `browser_find` `{query}` | Refs of the elements on the whole page that match the words, best first; partial matches are marked. Several targets can be separated by commas. |
 | `browser_get_text` `{max_chars?, selector?}` | Readable text of the whole page (PDFs too), or of the first element matching `selector` (`main`, `#results`), secrets masked, up to `max_chars` (default 20,000). |
@@ -104,7 +104,9 @@ one it re-reads (a prompt-cache write against a read). So an action on a page th
 (at most 8) returns only the lines that changed (`CHANGES ONLY since the page snapshot N browser results back`), each
 under its unchanged parent line marked `~ `, with what is gone listed by ref. Refs are stable across snapshots, so the
 lines not repeated still work; a change of more than half of the screen gets the whole screen, and
-`browser_snapshot` always does.
+`browser_snapshot` always does. The same goes for what the agent reads before any page: each tool's use is said once,
+in its own description, and the server instructions keep only the two rules that span the tools (a "cheapest",
+"latest" or "most" is the site's own sort; what to do on `NEEDS A PERSON`).
 
 **Pages only a person can pass.** After every acting tool the page is classified. A sign-in with no credentials, a
 one-time code or 2FA prompt, a device approval, a sign-in link, a passkey, 3-D Secure or a CAPTCHA adds a