@multiplayer-app/sandbox 7.0.0 → 7.0.1

package/README.md

@@ -21,10 +21,12 @@ for the public worker endpoint. Create one with the control plane's
 defaults to the machine hostname; set it explicitly when multiple workers could
 report the same hostname.
 `SANDBOX_URL` is optional and defaults to
-`https://api.sandbox.filingramp.com/v0`; set it explicitly for local or
-self-hosted control planes. Its pathname selects the API base: `/v0` uses the
-public authenticated worker endpoint, while `/internal/v0` uses the private
-tokenless endpoint.
+`https://api.sandbox.filingramp.com/v0/gapi`; set it explicitly for local or
+self-hosted control planes. Its pathname is the sole source of the worker
+socket path — `/workers/ws` is appended to it verbatim, so the full base
+(including the `/gapi` segment) must be included: `/v0/gapi` selects the
+public authenticated worker endpoint, while `/internal/v0/gapi` selects the
+private tokenless endpoint.
 
 The sandbox worker exposes probes on `SANDBOX_HEALTH_PORT` (default `3000`)
 under `API_PREFIX` (default `/v0/api`): `GET /v0/api/healthz` is its
@@ -42,23 +44,24 @@ WORKER_TOKEN=<token> sandbox start
 
 For a trusted deployment on the same Kubernetes cluster or private Docker
 Compose network, leave `WORKER_TOKEN` unset and set
-`SANDBOX_URL=http://builder-api-service:3000/internal/v0`. This resolves to
-`/internal/v0/sapi/workers/ws`, which does not require a token and must not be
-exposed by the public ingress. A client URL such as
-`https://api.sandbox.filingramp.com/v0` resolves to `/v0/sapi/workers/ws`, which
-requires a valid, user-created API key as `WORKER_TOKEN`.
+`SANDBOX_URL=http://builder-gateway-service:3000/internal/v0/gapi`. This
+resolves to `/internal/v0/gapi/workers/ws`, which does not require a token and
+must not be exposed by the public ingress. A client URL such as
+`https://api.sandbox.filingramp.com/v0/gapi` resolves to
+`/v0/gapi/workers/ws`, which requires a valid, user-created API key as
+`WORKER_TOKEN`.
 
 The published runtime bundles the repository's internal `builder-types` and
 `logger` libraries, so installing the CLI does not require those workspace
 packages to be published separately.
 
 The worker ID defaults to the hostname and the control-plane URL defaults to
-`https://api.sandbox.filingramp.com/v0`. Both can be overridden with environment
+`https://api.sandbox.filingramp.com/v0/gapi`. Both can be overridden with environment
 variables or flags:
 
 ```sh
 sandbox start --token <token> --worker-id worker-eu-01 \
-  --sandbox-url http://localhost:3011/v0 --max-vms 5
+  --sandbox-url http://localhost:3011/v0/gapi --max-vms 5
 ```
 
 ## Run as a Docker container

package/dist/cli.js

@@ -28,7 +28,7 @@ var import_config5 = require("dotenv/config");
 var import_commander = require("commander");
 
 // package.json
-var version = "7.0.0";
+var version = "7.0.1";
 
 // src/config.ts
 var import_os2 = __toESM(require("os"));
@@ -207,22 +207,23 @@ function parseArnList(raw) {
   const arns = raw.split(",").map((s) => s.trim()).filter(Boolean);
   return arns.length ? arns : void 0;
 }
-function resolveSandboxEndpoint(rawUrl, explicitSocketPath) {
+function resolveSandboxEndpoint(rawUrl) {
   const url = new URL(rawUrl);
-  const basePath = url.pathname.replace(/\/+$/, "") || "/v0";
+  const basePath = url.pathname.replace(/\/+$/, "");
   return {
     // Socket.IO treats a URL pathname as a namespace, so connect to the origin
-    // and pass the derived HTTP transport path separately.
+    // and pass the derived HTTP transport path separately. SANDBOX_URL's pathname is the
+    // sole source of truth for the socket path — it must include whatever base the control
+    // plane expects (e.g. "/v0/gapi" or "/internal/v0/gapi"), and "/workers/ws" is appended.
     sandboxUrl: url.origin,
-    workerSocketPath: explicitSocketPath ?? `${basePath}/sapi/workers/ws`
+    workerSocketPath: `${basePath}/workers/ws`
   };
 }
 function loadWorkerConfigFromEnv(env = process.env) {
   const workerId = env.WORKER_ID?.trim() || import_os2.default.hostname();
   const token = env.WORKER_TOKEN?.trim() || void 0;
   const sandboxEndpoint = resolveSandboxEndpoint(
-    env.SANDBOX_URL ?? "https://api.sandbox.filingramp.com/v0",
-    env.WORKER_SOCKET_PATH
+    env.SANDBOX_URL ?? "https://api.sandbox.filingramp.com/v0/gapi"
   );
   return {
     workerId,