@gaiventures/pilotfish-mcp-managed 0.1.23 → 0.1.24
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 +31 -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 one of the organization's API keys instead. The app's **
|
|
44
|
+
servers and shared agents use one of the organization's API keys instead. 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,11 @@ 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
|
|
163
|
-
page: it acts as them, in their Personal project, for their own scripts. A member
|
|
164
|
-
|
|
162
|
+
**Personal MCP keys.** Admins (the primary admin included) can also make a key of their own on the app's **MCP**
|
|
163
|
+
page: it acts as them, in their Personal project, for their own scripts. A member can have them too once an admin turns
|
|
164
|
+
on **Allow personal MCP keys** on the member's page (Org settings → the person); turning it off revokes their keys at
|
|
165
|
+
once. Until then a member is told whom to ask, and connects their AI tool by signing in (no key needed). Admins see
|
|
166
|
+
each person's key usage.
|
|
165
167
|
|
|
166
168
|
## Projects
|
|
167
169
|
|
|
@@ -214,13 +216,33 @@ the start: each saved account, **Use another login**, **Create a new account** o
|
|
|
214
216
|
scheduled run never asks: it takes the default, else the main account. Set a default with `manage_login {action: "set_default"}` (Personal)
|
|
215
217
|
or `identities {action: "set_default", credential}`.
|
|
216
218
|
|
|
219
|
+
### Updating a login
|
|
220
|
+
|
|
221
|
+
When an end user changes a password, send them a new login link for that site (and account, if it has a name):
|
|
222
|
+
`identities {action: "login_link", id, sites: ["linkedin.com"], account: "work"}`. What they type replaces the saved
|
|
223
|
+
login, and its credential id stays the same. Your own server can do the same with
|
|
224
|
+
`POST /identities/:id/credentials` (same site and account). A signed-in session the site keeps is used as long as it
|
|
225
|
+
lasts; the saved login signs in again when it ends.
|
|
226
|
+
|
|
227
|
+
### Usage per project
|
|
228
|
+
|
|
229
|
+
Admins see every shared project's API keys, identities and this month's spend in Org settings → Projects, or with
|
|
230
|
+
`projects {action: "list"}`; `projects {action: "usage", id, days}` gives one project's spend by kind and per key
|
|
231
|
+
(`GET /org/projects`, `GET /org/projects/:id/usage?days=`).
|
|
232
|
+
|
|
217
233
|
### What each task cost
|
|
218
234
|
|
|
219
|
-
Every
|
|
235
|
+
Every result has the same layout: the outcome first (`SUCCESS`, `PARTLY DONE` or `NOT DONE`), the answer, then
|
|
236
|
+
the job, its cost by kind and where it ran:
|
|
220
237
|
|
|
221
238
|
```text
|
|
239
|
+
SUCCESS
|
|
240
|
+
Result: Applied to 3 roles: …
|
|
241
|
+
Job: job_Ab12… · 14 steps
|
|
222
242
|
Cost: $0.0213 (model $0.0081, residential IP $0.0104, browser $0.0020, CAPTCHA $0.0008)
|
|
223
|
-
Project:
|
|
243
|
+
Project: Acme HR app (prj_acme)
|
|
244
|
+
Identity: idn_7Hq2…
|
|
245
|
+
Open in pilotfish: https://…/tasks/job_Ab12…
|
|
224
246
|
```
|
|
225
247
|
|
|
226
248
|
`identities {action: "get"}` and `GET /identities/:id/usage?since=` give an identity's totals (tasks; model,
|
|
@@ -254,7 +276,7 @@ Everyone is in one organization, and its credits pay for every task its people a
|
|
|
254
276
|
| Monthly limit and overage | Yes | Yes | No |
|
|
255
277
|
| Invite people, change roles, set allowances | Yes | Yes | No |
|
|
256
278
|
| Create and manage API keys, and shared projects | Yes | Yes | No |
|
|
257
|
-
| A personal
|
|
279
|
+
| A personal MCP key | Yes | Yes | When an admin turns it on (else they sign in from their client) |
|
|
258
280
|
| See everyone's tasks and spending | Yes | Yes | No: their own, and their allowance |
|
|
259
281
|
| Hand the primary admin role to someone else | Yes | No | No |
|
|
260
282
|
|
|
@@ -302,6 +324,7 @@ the monthly limit and spending by category and by model.
|
|
|
302
324
|
| `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
325
|
| `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
326
|
| `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. |
|
|
327
|
+
| `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
328
|
| `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
329
|
| `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
330
|
| `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 +382,7 @@ Only for this package (the relay). Clients that connect to the URL need none.
|
|
|
359
382
|
|
|
360
383
|
| Variable | Default | Meaning |
|
|
361
384
|
| --- | --- | --- |
|
|
362
|
-
| `PILOTFISH_KEY` | | An API key (`pf_…`): one of your organization's, or an admin
|
|
385
|
+
| `PILOTFISH_KEY` | | An API key (`pf_…`): one of your organization's, or a personal key (admins, and members an admin allowed). Required. |
|
|
363
386
|
| `PILOTFISH_URL` | `https://pilotfish-be.gai.ventures` | The pilotfish API, or its `/mcp` URL. |
|
|
364
387
|
|
|
365
388
|
## 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.24" : "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.24",
|
|
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",
|