@gaiventures/pilotfish-mcp-managed 0.1.26 → 0.1.28

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 +15 -2
  2. package/cli.js +1 -1
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -220,6 +220,19 @@ the start: each saved account, **Use another login**, **Create a new account** o
220
220
  scheduled run never asks: it takes the default, else the main account. Set a default with `manage_login {action: "set_default"}` (Personal)
221
221
  or `identities {action: "set_default", credential}`.
222
222
 
223
+ ### Codes and sign-ins for your end users
224
+
225
+ When a site asks an identity's task for something only its end user has, the task waits on them, never on you:
226
+
227
+ - **An authenticator app code:** save the identity's authenticator key with its login (the login link's
228
+ "Two-step sign-in" field, or `totp` in `POST /identities/:id/credentials`) and pilotfish types the code itself.
229
+ - **A code sent by text or email, a sign-in, a security check:** the task pauses with a question. The reply from
230
+ `browser_task` or `get_job` reads `Waiting for the end user of identity idn_…` with an `Answer here:` link; the
231
+ `job.needs_input` webhook carries the `identity` and the question. Send that link to the end user: they type the
232
+ code or their sign-in on pilotfish's page (no account needed, the link is the capability) and the task carries on.
233
+ A sign-in typed there is kept as the identity's credential when it keeps sign-ins (`saveLogins`).
234
+ - Codes and passwords never pass through your agent, your servers' task calls, events or webhooks.
235
+
223
236
  ### Updating a login
224
237
 
225
238
  When an end user changes a password, send them a new login link for that site (and account, if it has a name):
@@ -314,11 +327,11 @@ the monthly limit and spending by category and by model.
314
327
  | `get_file` `{id, file_id}` | One of the session's files, attached or downloaded. Up to 5 MB comes back in the result (an image as an image, text as text); larger files are linked in the app. |
315
328
  | `list_jobs` `{status?, limit?}` | Your recent jobs, newest first, with their cost; `[replay]` marks recorded ones. `status`: `queued`, `running`, `needs_input`, `done`, `failed` or `cancelled`. |
316
329
  | `follow_up` `{id, text, model?, region?, files?, wait?, wait_seconds?}` | Carry on in the same session: the same browser while it is kept, the same sign-ins, what earlier turns found ("now also…", "open the second one", "try again with…"). `model` changes this turn's model (`auto` routes again). `region` runs the turn from another country, in a new browser session there. The session keeps its project and identity. |
317
- | `rerun_job` `{id, wait?, wait_seconds?}` | Run the same task again with the same settings, as a new job. |
330
+ | `rerun_job` `{id, wait?, wait_seconds?}` | Run the same task again with the same settings, as a new job in a new session. To change the instructions or carry on, use `follow_up`. |
318
331
  | `answer_job` `{id, question_id, answer}` | Answer a job's question: `yes`, `no`, `done` (handled in the browser), `cancel`, or text. The id is in the job's `Question …` line, which also says what answer it takes. Codes and passwords go on the answer page, never here. |
319
332
  | `message_job` `{id, text}` | Pass on what the person says while a job runs ("take the cheaper one", a detail it asked for), in their words. It reads the message before its next step, and the person's newest words win over the task; sent while the job waits on a question, it answers it. |
320
333
  | `take_control` `{id}` / `hand_back` `{id}` | Pause a running job and get a link to drive its browser yourself, then let it carry on from where you left it. |
321
- | `cancel_job` `{id}` | Stop a job. It is the only way to: a tool call that is cancelled or times out stops waiting, and the job carries on. |
334
+ | `cancel_job` `{id}` | Stop a queued, running or waiting job for good: it can't be resumed, and what it spent stays charged. It is the only way to stop one: a tool call that is cancelled or times out stops waiting, and the job carries on. |
322
335
  | `get_replay` `{id}` | The job's steps with timings and what got in the way, and a link to its replay video (valid for an hour) when one was recorded. |
323
336
  | `list_saved_tasks` | Your saved tasks: id, name, settings, how often and when they last ran, and what their last run needed. |
324
337
  | `run_saved_task` `{id, extra_instructions?, start_url?, region?, sites?, stealth?, solve?, wait?, wait_seconds?}` | Run a saved task with its saved settings, with optional changes for this run only. |
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.26" : "0.0.0-dev";
13
+ var VERSION = true ? "0.1.28" : "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.26",
3
+ "version": "0.1.28",
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",