@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.
Files changed (3) hide show
  1. package/README.md +31 -8
  2. package/cli.js +1 -1
  3. 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 **API & MCP** page
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 API keys.** Admins (the primary admin included) can also make a key of their own on the app's **API & MCP**
163
- page: it acts as them, in their Personal project, for their own scripts. A member who asks for one is told to contact
164
- their admins, and connects their AI tool by signing in instead (no key needed). Admins see each person's key usage.
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 `browser_task` and `follow_up` result ends with the task's cost by kind and where it ran:
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: prj_acme; identity: idn_7Hq2…
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 API key | Yes | Yes | No: they sign in from their client, or ask an admin |
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's personal key. Required. |
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.23" : "0.0.0-dev";
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.23",
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",