@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.
Files changed (3) hide show
  1. package/README.md +32 -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 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.** 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 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 `browser_task` and `follow_up` result ends with the task's cost by kind and where it ran:
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: prj_acme; identity: idn_7Hq2…
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 | No: they sign in from their client, or ask an admin |
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's personal key. Required. |
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.23" : "0.0.0-dev";
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.23",
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",