@gaiventures/pilotfish-mcp-managed 0.1.23 → 0.1.25
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 +32 -8
- package/cli.js +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -41,7 +41,7 @@ Want a browser on your own computer for free, driven by your agent's own model,
|
|
|
41
41
|
from $10, with optional auto reload). Members run tasks on the organization's credits within any allowance an
|
|
42
42
|
admin sets for them.
|
|
43
43
|
3. **Connect your agent** (below). The simplest way is to sign in from your client, which then acts as you. Scripts,
|
|
44
|
-
servers and shared agents use
|
|
44
|
+
servers and shared agents use an API key instead (Org settings → API keys). The app's **MCP** page
|
|
45
45
|
(`https://pilotfish.gai.ventures/connect`) has the endpoint and every client's setup.
|
|
46
46
|
|
|
47
47
|
## Connect
|
|
@@ -159,9 +159,12 @@ working at once; rotate a key when someone who had it leaves. Each key has its o
|
|
|
159
159
|
through the MCP and the API, and its sessions. An admin can give a key an allowance: a spending limit on the
|
|
160
160
|
organization's credits, with an optional automatic top-up.
|
|
161
161
|
|
|
162
|
-
**Personal API keys.**
|
|
163
|
-
|
|
164
|
-
|
|
162
|
+
**Personal API keys.** An API key always belongs to a project. For your own scripts and tools that can't sign in,
|
|
163
|
+
make one in the app's **Org settings → API keys** and pick the project **Personal (you)**: it acts as you, in your
|
|
164
|
+
Personal project, with your own saved logins, and only you can see or manage it. Admins (the primary admin included)
|
|
165
|
+
can always do this; a member can once an admin turns on **Allow personal API keys** on the member's page (turning it
|
|
166
|
+
off revokes their keys at once), and then finds their keys on their Org settings page. Admins see each person's key
|
|
167
|
+
usage, never the keys. Most people need no key at all: Claude Code, the Claude app, Cursor and VS Code sign in.
|
|
165
168
|
|
|
166
169
|
## Projects
|
|
167
170
|
|
|
@@ -214,13 +217,33 @@ the start: each saved account, **Use another login**, **Create a new account** o
|
|
|
214
217
|
scheduled run never asks: it takes the default, else the main account. Set a default with `manage_login {action: "set_default"}` (Personal)
|
|
215
218
|
or `identities {action: "set_default", credential}`.
|
|
216
219
|
|
|
220
|
+
### Updating a login
|
|
221
|
+
|
|
222
|
+
When an end user changes a password, send them a new login link for that site (and account, if it has a name):
|
|
223
|
+
`identities {action: "login_link", id, sites: ["linkedin.com"], account: "work"}`. What they type replaces the saved
|
|
224
|
+
login, and its credential id stays the same. Your own server can do the same with
|
|
225
|
+
`POST /identities/:id/credentials` (same site and account). A signed-in session the site keeps is used as long as it
|
|
226
|
+
lasts; the saved login signs in again when it ends.
|
|
227
|
+
|
|
228
|
+
### Usage per project
|
|
229
|
+
|
|
230
|
+
Admins see every shared project's API keys, identities and this month's spend in Org settings → Projects, or with
|
|
231
|
+
`projects {action: "list"}`; `projects {action: "usage", id, days}` gives one project's spend by kind and per key
|
|
232
|
+
(`GET /org/projects`, `GET /org/projects/:id/usage?days=`).
|
|
233
|
+
|
|
217
234
|
### What each task cost
|
|
218
235
|
|
|
219
|
-
Every
|
|
236
|
+
Every result has the same layout: the outcome first (`SUCCESS`, `PARTLY DONE` or `NOT DONE`), the answer, then
|
|
237
|
+
the job, its cost by kind and where it ran:
|
|
220
238
|
|
|
221
239
|
```text
|
|
240
|
+
SUCCESS
|
|
241
|
+
Result: Applied to 3 roles: …
|
|
242
|
+
Job: job_Ab12… · 14 steps
|
|
222
243
|
Cost: $0.0213 (model $0.0081, residential IP $0.0104, browser $0.0020, CAPTCHA $0.0008)
|
|
223
|
-
Project:
|
|
244
|
+
Project: Acme HR app (prj_acme)
|
|
245
|
+
Identity: idn_7Hq2…
|
|
246
|
+
Open in pilotfish: https://…/tasks/job_Ab12…
|
|
224
247
|
```
|
|
225
248
|
|
|
226
249
|
`identities {action: "get"}` and `GET /identities/:id/usage?since=` give an identity's totals (tasks; model,
|
|
@@ -254,7 +277,7 @@ Everyone is in one organization, and its credits pay for every task its people a
|
|
|
254
277
|
| Monthly limit and overage | Yes | Yes | No |
|
|
255
278
|
| Invite people, change roles, set allowances | Yes | Yes | No |
|
|
256
279
|
| Create and manage API keys, and shared projects | Yes | Yes | No |
|
|
257
|
-
| A personal API key | Yes | Yes |
|
|
280
|
+
| A personal API key | Yes | Yes | When an admin turns it on (else they sign in from their client) |
|
|
258
281
|
| See everyone's tasks and spending | Yes | Yes | No: their own, and their allowance |
|
|
259
282
|
| Hand the primary admin role to someone else | Yes | No | No |
|
|
260
283
|
|
|
@@ -302,6 +325,7 @@ the monthly limit and spending by category and by model.
|
|
|
302
325
|
| `delete_session` `{id}` | Delete a session from your history: it no longer shows or opens anywhere; its record and cost are kept for billing. Logins, saved tasks and spending stay. Only with the person's say-so. |
|
|
303
326
|
| `list_logins` | Sites with saved logins in your Personal project: which accounts, whether a password and authenticator key are stored, what recent runs met there. Never a password or code. |
|
|
304
327
|
| `manage_login` `{action, site, account?}` | Your Personal logins. `add`: a link to the app where you type the login yourself (never in the chat). `set_default`: the account tasks use on a site with several when they don't say. `delete`: forget one. `save_offered` / `discard_offered`: a sign-in a run offered for saving. |
|
|
328
|
+
| `projects` `{action, id?, name?, days?}` | Admins: your organization's shared projects. `list` (each with its API keys, identities and this month's spend), `create`, `rename`, `delete` (wipes its identities, revokes its keys; its tasks' cost stays), `usage` (one project's spend by kind and per key over `days`), `keys` (its keys and what each spent). New API keys are made in the app (Org settings → API keys): a key's value never passes through a chat. |
|
|
305
329
|
| `switch_project` `{project?}` | Which project your tasks run in: `personal`, `default` or a project's id or name. No argument lists them. Remembered for your next connections; an organization API key stays in its own. |
|
|
306
330
|
| `identities` `{action, id?, external_user_id?, label?, query?, country?, device_os?, email?, save_logins?, sites?, account?, credential?}` | Your end users in a shared project. `list` (by `external_user_id` or `query`), `create`, `get` (logins by credential id, masked; signed-in sites; cost so far), `update`, `delete` (wipes logins, sessions and device; costs stay), `login_link` (`sites`: a one-time page for the user to type their own login), `set_default` and `delete_login` (by `credential`). |
|
|
307
331
|
| `get_settings` / `update_site_settings` `{site, residential?, stealth?, solve?}` | Your sites and their settings, and change one site's: residential IP (`auto`, `always` or `never`), stealth browsing, CAPTCHA solving. A change applies to every later task on that site. |
|
|
@@ -359,7 +383,7 @@ Only for this package (the relay). Clients that connect to the URL need none.
|
|
|
359
383
|
|
|
360
384
|
| Variable | Default | Meaning |
|
|
361
385
|
| --- | --- | --- |
|
|
362
|
-
| `PILOTFISH_KEY` | | An API key (`pf_…`): one of your organization's, or an admin
|
|
386
|
+
| `PILOTFISH_KEY` | | An API key (`pf_…`): one of your organization's, or a personal key (admins, and members an admin allowed). Required. |
|
|
363
387
|
| `PILOTFISH_URL` | `https://pilotfish-be.gai.ventures` | The pilotfish API, or its `/mcp` URL. |
|
|
364
388
|
|
|
365
389
|
## Troubleshooting
|
package/cli.js
CHANGED
|
@@ -10,7 +10,7 @@ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
|
|
|
10
10
|
import { isJSONRPCRequest, isJSONRPCResultResponse } from "@modelcontextprotocol/sdk/types.js";
|
|
11
11
|
|
|
12
12
|
// packages/mcp-managed/dist/version.js
|
|
13
|
-
var VERSION = true ? "0.1.
|
|
13
|
+
var VERSION = true ? "0.1.25" : "0.0.0-dev";
|
|
14
14
|
|
|
15
15
|
// packages/mcp-managed/dist/bridge.js
|
|
16
16
|
var DEFAULT_URL = "https://pilotfish-be.gai.ventures";
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@gaiventures/pilotfish-mcp-managed",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.25",
|
|
4
4
|
"description": "Whole browser tasks done in pilotfish's cloud for any MCP agent, signed in with your saved logins. mcprush.com-37c48d491684ec6011385ea5",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|