crewly 1.20.421 → 1.20.423

package/dist/cli/backend/src/utils/local-api-url.utils.js

@@ -18,15 +18,28 @@
  * consulted: a backend launched from inside an agent shell inherits that
  * agent's URL, which points at a different instance.
  *
+ * The host is an IP literal, never `localhost`. Node resolves every hostname
+ * (`localhost` included) with `getaddrinfo` on the libuv threadpool; during
+ * the 2026-10-26 Wi-Fi drop the pool was full of hanging Cloud lookups, so
+ * the reconciler's own `…/members/start` and the dispatcher's
+ * `/api/terminal/:name/write` calls to this very process timed out for
+ * twenty minutes ("fetch failed" after 10 s, axios 45 s). An IP literal
+ * skips the lookup, so a self-call never waits on DNS.
+ *
  * @module utils/local-api-url
  */
+import { isIP } from 'net';
 import { WEB_CONSTANTS } from '../constants.js';
-/** Host agents use to reach the backend on the same machine. */
-const LOCAL_API_HOST = 'localhost';
+/** Loopback IPv4 literal: reaches a server bound to `0.0.0.0`, `::` (dual-stack) or `localhost` */
+const LOOPBACK_HOST = '127.0.0.1';
+/** Bind addresses that mean "every interface" — loopback reaches them */
+const WILDCARD_BIND_HOSTS = new Set(['0.0.0.0', '::']);
 /** Largest valid TCP port. */
 const MAX_TCP_PORT = 65535;
 /** Port recorded by the running server, or null before it is known. */
 let runningPort = null;
+/** The host self-calls use, derived from the bind host at construction */
+let runningHost = null;
 /**
  * Parse a port value, rejecting anything that is not an integer in 1..65535.
  *
@@ -38,18 +51,49 @@ export function parsePort(value) {
     return Number.isInteger(n) && n >= 1 && n <= MAX_TCP_PORT ? n : null;
 }
 /**
- * Record the port this server listens on. Called once by the server with its
- * resolved `webPort` (from `-p` / `WEB_PORT` / default).
+ * Record the port (and bind host) this server listens on, at construction.
  *
- * @param port - The listen port
- * @throws {Error} When the port is not a valid TCP port
+ * @param port - The resolved listen port
+ * @param bindHost - The address the server binds to; a specific IP literal
+ *   becomes the self-call host, anything else (wildcard, hostname, absent)
+ *   means loopback
+ * @throws Error when the port is not a valid TCP port
  */
-export function setLocalApiPort(port) {
+export function setLocalApiPort(port, bindHost) {
     const parsed = parsePort(port);
     if (parsed === null) {
         throw new Error(`Invalid Crewly API port: ${String(port)}`);
     }
     runningPort = parsed;
+    runningHost = selfCallHost(bindHost);
+}
+/**
+ * The host self-calls and agents use for a server bound to `bindHost`: an IP
+ * literal always (no DNS lookup, see the module note), so a specific bind
+ * address is used as is (IPv6 bracketed) and a wildcard or hostname bind
+ * (`0.0.0.0`, `::`, `localhost`) is reached over `127.0.0.1`.
+ *
+ * @param bindHost - The server's bind address, if any
+ * @returns Host part of the base URL
+ */
+export function selfCallHost(bindHost) {
+    const host = (bindHost ?? '').trim();
+    if (host === '' || WILDCARD_BIND_HOSTS.has(host))
+        return LOOPBACK_HOST;
+    const family = isIP(host);
+    if (family === 4)
+        return host;
+    if (family === 6)
+        return `[${host}]`;
+    return LOOPBACK_HOST;
+}
+/**
+ * Host part of this instance's API URL.
+ *
+ * @returns An IP literal (IPv6 bracketed)
+ */
+export function getLocalApiHost() {
+    return runningHost ?? LOOPBACK_HOST;
 }
 /**
  * The port this Crewly instance's API is served on.
@@ -62,19 +106,20 @@ export function getLocalApiPort() {
     return parsePort(process.env.WEB_PORT) ?? WEB_CONSTANTS.PORTS.BACKEND;
 }
 /**
- * Base URL of this instance's API, e.g. `http://localhost:8797` — the value
+ * Base URL of this instance's API, e.g. `http://127.0.0.1:8797` — the value
  * agents receive as `CREWLY_API_URL`. Paths are appended by the caller
  * (`${getLocalApiBaseUrl()}/api/teams`).
  *
  * @returns The base URL without a trailing slash
  */
 export function getLocalApiBaseUrl() {
-    return `http://${LOCAL_API_HOST}:${getLocalApiPort()}`;
+    return `http://${getLocalApiHost()}:${getLocalApiPort()}`;
 }
 /**
  * Forget the recorded port (tests only).
  */
 export function resetLocalApiPortForTesting() {
     runningPort = null;
+    runningHost = null;
 }
 //# sourceMappingURL=local-api-url.utils.js.map

package/dist/cli/backend/src/utils/local-api-url.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-api-url.utils.js","sourceRoot":"","sources":["../../../../../backend/src/utils/local-api-url.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,gEAAgE;AAChE,MAAM,cAAc,GAAG,WAAW,CAAC;AAEnC,8BAA8B;AAC9B,MAAM,YAAY,GAAG,KAAK,CAAC;AAE3B,uEAAuE;AACvE,IAAI,WAAW,GAAkB,IAAI,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,MAAM,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACrH,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,4BAA4B,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,WAAW,GAAG,MAAM,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IAC7C,OAAO,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC;AACxE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,UAAU,cAAc,IAAI,eAAe,EAAE,EAAE,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B;IACzC,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC"}
+{"version":3,"file":"local-api-url.utils.js","sourceRoot":"","sources":["../../../../../backend/src/utils/local-api-url.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,mGAAmG;AACnG,MAAM,aAAa,GAAG,WAAW,CAAC;AAClC,yEAAyE;AACzE,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;AAEvD,8BAA8B;AAC9B,MAAM,YAAY,GAAG,KAAK,CAAC;AAE3B,uEAAuE;AACvE,IAAI,WAAW,GAAkB,IAAI,CAAC;AACtC,0EAA0E;AAC1E,IAAI,WAAW,GAAkB,IAAI,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,MAAM,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACrH,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,QAAiB;IAC7D,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,4BAA4B,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,WAAW,GAAG,MAAM,CAAC;IACrB,WAAW,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,QAA4B;IACvD,MAAM,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,IAAI,KAAK,EAAE,IAAI,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,aAAa,CAAC;IACvE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,IAAI,GAAG,CAAC;IACrC,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,WAAW,IAAI,aAAa,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IAC7C,OAAO,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC;AACxE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,UAAU,eAAe,EAAE,IAAI,eAAe,EAAE,EAAE,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B;IACzC,WAAW,GAAG,IAAI,CAAC;IACnB,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "crewly",
-  "version": "1.20.421",
+  "version": "1.20.423",
   "type": "module",
   "description": "Multi-agent orchestration platform for AI coding teams — coordinates Claude Code, Gemini CLI, and Codex agents with a real-time web dashboard",
   "workspaces": [