@wezzard/mcp-relay 0.17.1 → 0.18.0
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/.claude-plugin/plugin.json +1 -1
- package/README.md +8 -6
- package/dist/build-info.json +4 -3
- package/dist/doctor.mjs +1 -1
- package/dist/integrity.json +2 -2
- package/dist/server.mjs +715 -565
- package/package.json +1 -1
- package/pi-mcp.json +1 -1
package/README.md
CHANGED
|
@@ -308,10 +308,11 @@ a real Mac that machine-service exposes, such as `Build-Mac-1`. Every other
|
|
|
308
308
|
tool works on it as on a VM ([docs/durable-machines.md](docs/durable-machines.md)).
|
|
309
309
|
|
|
310
310
|
- The relay finds the instance that owns the machine as `machctl list` does:
|
|
311
|
-
the loopback instance, then every
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
311
|
+
the loopback instance, then every instance that advertises
|
|
312
|
+
`_machine-service._tcp` with Bonjour on the network, so a Mac needs nothing
|
|
313
|
+
else installed. With `MACHINE_SERVICE_DISCOVERY=consul` it asks the Consul
|
|
314
|
+
agent at `CONSUL_HTTP_ADDR` (default `http://127.0.0.1:8500`) instead. Each
|
|
315
|
+
instance found is used only once its `/health` confirms its ID.
|
|
315
316
|
- Every call carries the lease's `lease_id`, files go as bytes, and the relay
|
|
316
317
|
stages under the lease's workspace, which machine-service removes at release.
|
|
317
318
|
- Runs take snapshots only while the Mac's cua-driver daemon (`CuaDriver.app`,
|
|
@@ -371,8 +372,9 @@ keeps the VM for a retry after space is freed.
|
|
|
371
372
|
|
|
372
373
|
- `MCP_RELAY_PROJECT`: the project directory (the plugin passes Claude Code's). Evidence lands under `relay-evidence/<task>/` there. Every host file the relay reads, `relay_stage`'s `workspace` and `files[].local` and `relay_script`'s `localPath`, lies in this folder: a relative path resolves against it, an absolute path must already lie in it, and a path through a symlink is refused.
|
|
373
374
|
- `MCP_RELAY_SESSION`: an explicit session identity. By default each server process takes a fresh random one; a stable identity lets a restarted server reconcile and reattach the guests of the same identity.
|
|
374
|
-
- `MCP_RELAY_URL`: the loopback machine-service origin, default `http://localhost:6240`. Non-loopback servers and redirects are refused; a durable machine's instance on another Mac is reached only when
|
|
375
|
-
- `
|
|
375
|
+
- `MCP_RELAY_URL`: the loopback machine-service origin, default `http://localhost:6240`. Non-loopback servers and redirects are refused; a durable machine's instance on another Mac is reached only when discovery finds it.
|
|
376
|
+
- `MACHINE_SERVICE_DISCOVERY`: how durable machines' instances are found, `bonjour` (the default) or `consul`, as for machine-service and machctl.
|
|
377
|
+
- `CONSUL_HTTP_ADDR`: the Consul agent that lists machine-service instances, in Consul mode; default `http://127.0.0.1:8500`.
|
|
376
378
|
- `MCP_RELAY_GUEST_NETWORK`: the network every guest is acquired on, `nat` (the default) or `internet`. With `internet`, machine-service gives a guest that reaches the internet and reaches neither this host nor any private network; an application that hosts agents sets it. The agent cannot choose it: `relay_acquire` takes no network. Any other value stops the server at startup and refuses every acquisition, and a machine-service that cannot give `internet` refuses the acquisition with its own reason, never falling back to `nat`.
|
|
377
379
|
- `MCP_RELAY_ON_EXIT`: what the end of a session does to its guests, `pause` (the default: renewal pauses and the VMs are kept for an explicit finish or release) or `release` (every guest is released, then the server exits). An application that owns its tasks' machines, such as The Desk, sets `release`. Any other value stops the server at startup.
|
|
378
380
|
- `MCP_RELAY_CAPACITY_WAIT`: how many seconds `relay_acquire` waits when the host is at capacity, such as at machine-service's limit of two running macOS VMs, asking again every 15 s; default 1800, and 0 for not at all. Any other value stops the server at startup.
|
package/dist/build-info.json
CHANGED
|
@@ -958,7 +958,7 @@
|
|
|
958
958
|
"src/config.ts": "3fbc475596ec0a1b6122ea963bf2769420a8a2a0e62fda55e66018fb3a6d53b3",
|
|
959
959
|
"src/console.ts": "d8258173a24449c2a394289b14983b9575c5ce753ab267d4e13213f3abfcb72d",
|
|
960
960
|
"src/core.ts": "dd889fda6af982ab47b40b346e7fbc41a213b6d258d3d5fe56cd8c5373221159",
|
|
961
|
-
"src/discovery.ts": "
|
|
961
|
+
"src/discovery.ts": "cd66b470615f7e2bf1d5d2cdf8065b6e0ec601a0929f7be063bc18bfcfbc342d",
|
|
962
962
|
"src/doctor.ts": "8249e9fa78b679e9ef7fd30f617bf07848961346101d3b64c42f779cfb042671",
|
|
963
963
|
"src/downloads.ts": "4f37b5bb4fac96f9260a3a87c83bacf715b9add5ae9926d3fe0994000c70a8dd",
|
|
964
964
|
"src/environment.ts": "5770e966e49d78ae069614078c667f94e70074b150f83111049529ff613aa215",
|
|
@@ -967,8 +967,9 @@
|
|
|
967
967
|
"src/guest/receiver.ts": "92fc8d3bfe95ed56d43cfe5b46eb196034ade5e4e9f58ed202465531458f697d",
|
|
968
968
|
"src/image-presentation.ts": "64ca29a3444a04606cb783c81ac2d0f3136f9a9ac730ae9074156f0a63256c76",
|
|
969
969
|
"src/images.ts": "415bfb37966a60ef3e407236295b9aeeb314f7fb33de55a6ada512cff6661908",
|
|
970
|
-
"src/machine-service.ts": "
|
|
971
|
-
"src/manager.ts": "
|
|
970
|
+
"src/machine-service.ts": "1f7c63d295b2551728f975451bd1ab29a57cf4cab9f16510b7e3fcd1a6160205",
|
|
971
|
+
"src/manager.ts": "7bbff05dd7d3c3c98f2d71e72834e1e08b0c96a963fb76876895537d75436749",
|
|
972
|
+
"src/mdns.ts": "b85df92dfe3cd0807725a3115ecfdd21d1530a98528b6a55454370d6e4baf98c",
|
|
972
973
|
"src/owner-lock.ts": "a99cbaba67b4aff0e646dc5d5967db4497ba6dbda83fb1838c55f0bf0f6e0367",
|
|
973
974
|
"src/package.ts": "a52ed791813922e3ace9144706ddde8313a67d8580a3acd54a0799de3ebe44d2",
|
|
974
975
|
"src/probe.ts": "40a123f725aad7c22fe63707dd2de99646cb1f307d7d660927e8ca2b973e9ce0",
|
package/dist/doctor.mjs
CHANGED
|
@@ -120,7 +120,7 @@ var MachineService = class {
|
|
|
120
120
|
const host = url.hostname.replace(/^\[|\]$/g, "");
|
|
121
121
|
const loopback = host === "localhost" || host === "::1" || isIP(host) === 4 && host.startsWith("127.");
|
|
122
122
|
if (!loopback && !options.listed || !["http:", "https:"].includes(url.protocol) || url.username || url.password || url.search || url.hash || url.pathname !== "/") {
|
|
123
|
-
throw new TypeError("machine-service baseUrl must be a loopback HTTP(S) origin, or one
|
|
123
|
+
throw new TypeError("machine-service baseUrl must be a loopback HTTP(S) origin, or one discovery found, without credentials, path, query or fragment");
|
|
124
124
|
}
|
|
125
125
|
this.baseUrl = url.origin;
|
|
126
126
|
this.timeoutMs = positive(options.timeoutMs ?? 66e4, "timeoutMs");
|
package/dist/integrity.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"server.mjs": "
|
|
2
|
+
"server.mjs": "2b04c5cf78833f392f9fe8570a0099a1f276c2c24ad036dc8107f9c24371c95a",
|
|
3
3
|
"receiver.mjs": "8b5b6fdd6cb789cdc4060e367a155cb42e7cf34187044c899789bf76b7bb0e14",
|
|
4
|
-
"doctor.mjs": "
|
|
4
|
+
"doctor.mjs": "4e3d5a58ead4be3afe461691b6bff6f1f933bbde70b19fd67677f158975b6e3f",
|
|
5
5
|
"review-data.mjs": "da7b6b35d060e09cfc445df4febda02a1a0c0f23d9b854866aed8d604cbb3993"
|
|
6
6
|
}
|