@gaiventures/pilotfish-mcp-managed 0.1.41 → 0.1.42

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 +33 -15
  2. package/cli.js +1 -1
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -291,8 +291,8 @@ Admins see every shared project's API keys, identities and this month's spend in
291
291
 
292
292
  ### What each task cost
293
293
 
294
- Every result has the same layout: the outcome first (`SUCCESS`, `PARTLY DONE` or `NOT DONE`), the answer, then
295
- the job, its cost by kind and where it ran:
294
+ Every result has the same layout: the outcome first (`SUCCESS`, `PARTLY DONE`, `NOT DONE`…), the answer, then
295
+ the job, its cost by kind (kinds that cost nothing left out) and where it ran:
296
296
 
297
297
  ```text
298
298
  SUCCESS
@@ -393,20 +393,33 @@ the monthly limit and spending by category and by model.
393
393
 
394
394
  ## What a job returns
395
395
 
396
- A finished job starts with `SUCCESS`, `PARTLY DONE` or `NOT DONE`. One that did not fully pass lists what of the task
397
- is done, what is not (each with its evidence) and why it stopped. Every finished job ends with a `Cost:` line (model,
398
- residential IP, browser, CAPTCHA), a `Project:` line naming its project, and an `Identity:` line when it ran as one. A
399
- job still running says `Still running after 120 s; the job carries on` (50 s for a client that takes no progress
400
- updates), and your agent waits again with `get_job`. A tool call that is cancelled or times out leaves the job running
401
- too: `get_job` (or `list_jobs`, for its id) gets it, and only `cancel_job` stops it. A job that needs a person shows the question,
402
- a `Question <id>` line saying how to answer it, and the answer link.
396
+ Every job reply starts with one status word on its own line:
397
+
398
+ | First line | Meaning |
399
+ | --- | --- |
400
+ | `SUCCESS` | Done, and the final check confirmed the result. |
401
+ | `PARTLY DONE` | Not fully done, but there is an answer: it lists what is done, what is not (each with its evidence) and why it stopped. |
402
+ | `NOT DONE` | Nothing usable; `Why it stopped:` says why when that is known. |
403
+ | `PAUSED (<reason>)` | Stopped resumably: a spend check-in (`cost_cap`), a question nobody answered (`no_answer`), the residential IP down (`residential_down`), or the machine running it stopped or was replaced (`machine_lost`, `machine_reclaimed`). |
404
+ | `NEEDS YOU` | Waiting for a person: the question, a `Question <id>` line saying how to answer it, and the answer link. |
405
+ | `RUNNING` / `QUEUED` | Still going, or waiting for a free browser. |
406
+ | `ERROR <code>` | The call was refused: `ERROR <code>: <message>`, the figures that matter, and a `Docs:` link when a person has to act (add credits, ask an admin, switch project). |
407
+
408
+ Labelled lines follow (`Result:`, `Done:`, `Not done:`, `Why it stopped:`, `Job: <id> · N steps`). A finished job then
409
+ has a `Cost:` line (only the kinds it spent on: model, residential IP, browser, CAPTCHA), a `Project:` line, and an
410
+ `Identity:` line when it ran as one. The last line is `Next:` only when your agent has something to do, for example
411
+ `Next: follow_up {"id":"job_…","text":"Continue"} picks it up from where it left off.` for a paused job, or
412
+ `Next: get_job {"id":"job_…"} to wait for it.` for one still running.
413
+
414
+ A call returns within 120 s (50 s for a client that takes no progress updates) with `Still running after 120 s; the job
415
+ carries on`, and your agent waits again with `get_job`. A tool call that is cancelled or times out leaves the job running
416
+ too: `get_job` (or `list_jobs`, for its id) gets it, and only `cancel_job` stops it.
403
417
 
404
418
  When every browser is busy, a job says `QUEUED`: it starts by itself as one frees up, each organization taking its turn
405
419
  (at most 5 tasks running at once per organization while others wait). One that cannot start within 15 minutes ends
406
- `NOT DONE` with `fleet_busy`: nothing ran and nothing was charged, so send it again. A job interrupted because the
407
- machine running it stopped or was replaced says `PAUSED` (`machine_lost`, `machine_reclaimed`), as a spend check-in
408
- does: `follow_up` with the text "Continue" picks it up from where it left off, in a new browser. A job whose machine
409
- stopped before it did anything on a site starts again by itself, once.
420
+ `NOT DONE` with `Next: rerun_job …`: nothing ran and nothing was charged, so send it again. A paused job picks up from
421
+ where it left off with `follow_up` and the text "Continue" (in a new browser when its machine was lost). A job whose
422
+ machine stopped before it did anything on a site starts again by itself, once.
410
423
 
411
424
  ## Writing tasks
412
425
 
@@ -462,8 +475,13 @@ Only for this package (the relay). Clients that connect to the URL need none.
462
475
  - **`shared_project` or `personal_project`:** saved logins and saved tasks are in Personal, identities in a shared
463
476
  project: `switch_project` to the right one (an organization API key stays in its own).
464
477
  - **`identity_busy`:** that identity already has a task running; wait for it or stop it.
465
- - **A task is refused:** the reason and whom to ask are in the result; the table under "Organizations, members and
466
- money" above lists each one.
478
+ - **A task is refused (`ERROR no_credits`, `allocation_used`, `org_limit`):** the reason and whom to ask are in the
479
+ result, with the page to fix it; the table under "Organizations, members and money" above lists each one.
480
+ - **`ERROR not_found: no job … of yours`:** the id is wrong, the session was deleted, or the job is another person's
481
+ (an organization key reaches only the tasks it started). `list_jobs` lists yours.
482
+ - **`ERROR not_running` from `cancel_job`:** the job has already ended; nothing to stop.
483
+ - **`ERROR start_rate`, `queue_full` or `rate_limited`:** too many tasks or requests at once; the `Next:` line says when
484
+ to try again.
467
485
 
468
486
  ## License
469
487
 
package/cli.js CHANGED
@@ -15,7 +15,7 @@ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
15
15
  import { isJSONRPCRequest, isJSONRPCResultResponse } from "@modelcontextprotocol/sdk/types.js";
16
16
 
17
17
  // packages/mcp-managed/dist/version.js
18
- var VERSION = true ? "0.1.41" : "0.0.0-dev";
18
+ var VERSION = true ? "0.1.42" : "0.0.0-dev";
19
19
 
20
20
  // packages/mcp-managed/dist/bridge.js
21
21
  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.41",
3
+ "version": "0.1.42",
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",