@telepath-computer/television 0.1.189 → 0.1.191

package/dist/cli.cjs

@@ -51781,6 +51781,71 @@ function pad2(value) {
   return String(value).padStart(2, "0");
 }
 
+// ../server/src/startup-bind-failure.ts
+var STARTUP_BIND_EXIT_STATUS = 69;
+var IPV4_OCTET_COUNT = 4;
+var CGNAT_SECOND_OCTET_MIN = 64;
+var CGNAT_SECOND_OCTET_MAX = 127;
+var StartupBindError = class extends Error {
+  exitStatus = STARTUP_BIND_EXIT_STATUS;
+  constructor(attempts) {
+    const failures = attempts.filter((attempt) => attempt.outcome === "failed").map((attempt) => `${attempt.address}:${attempt.port} (${attempt.error.message})`).join(", ");
+    super(`Television could not bind all required listeners: ${failures}`);
+    this.name = "StartupBindError";
+  }
+};
+function buildStartupBindFailureRecord(attempts) {
+  return {
+    reason: "required-listener-bind-failed",
+    exitStatus: STARTUP_BIND_EXIT_STATUS,
+    outcomes: attempts.map((attempt) => {
+      if (attempt.outcome === "bound") return attempt;
+      const serializedError = serializeError(attempt.error);
+      const code = typeof serializedError.code === "string" ? serializedError.code : void 0;
+      return {
+        address: attempt.address,
+        port: attempt.port,
+        outcome: attempt.outcome,
+        ...code === void 0 ? {} : { code },
+        ...typeof serializedError.syscall === "string" ? { syscall: serializedError.syscall } : {},
+        cause: bindFailureCause(attempt, code),
+        hint: bindFailureHint(attempt, code)
+      };
+    })
+  };
+}
+function bindFailureCause(attempt, code) {
+  if (code === "EADDRNOTAVAIL") {
+    return `Cannot bind ${attempt.address}:${attempt.port} because the address is not assigned to this host.`;
+  }
+  if (code === "EADDRINUSE") {
+    return `Cannot bind ${attempt.address}:${attempt.port} because the address and port are already in use.`;
+  }
+  if (code === "EACCES" || code === "EPERM") {
+    return `Cannot bind ${attempt.address}:${attempt.port} because the process does not have permission.`;
+  }
+  return `Cannot bind ${attempt.address}:${attempt.port}: ${attempt.error.message}`;
+}
+function bindFailureHint(attempt, code) {
+  if (code === "EADDRNOTAVAIL" && isCgnatAddress(attempt.address)) {
+    return `Address ${attempt.address} is not assigned to any interface. If this is a Tailscale IP, tailscaled may not be up yet (transient at boot), or the tailnet IP may have changed (permanent until \`tv serve --persist\` is re-run to refresh the configured address). The service manager will retry.`;
+  }
+  if (code === "EADDRNOTAVAIL") {
+    return `Confirm that ${attempt.address} is assigned to a local interface, then retry.`;
+  }
+  if (code === "EADDRINUSE") {
+    return `Stop the process using ${attempt.address}:${attempt.port}, or choose another port, then retry.`;
+  }
+  if (code === "EACCES" || code === "EPERM") {
+    return "Choose an address and port this process is permitted to bind, then retry.";
+  }
+  return "Check that the address and port are available, then retry.";
+}
+function isCgnatAddress(address) {
+  const octets = address.split(".").map(Number);
+  return octets.length === IPV4_OCTET_COUNT && octets[0] === 100 && octets[1] !== void 0 && octets[1] >= CGNAT_SECOND_OCTET_MIN && octets[1] <= CGNAT_SECOND_OCTET_MAX;
+}
+
 // ../server/src/telemetry/emitters.ts
 var MEDIAN_PAIR_DIVISOR = 2;
 function createServerStoreTelemetryHooks(store, capture2) {
@@ -52493,7 +52558,7 @@ function disabledTelemetryRuntime() {
 
 // ../server/src/updates/version.ts
 function readVersionStamp() {
-  if ("0.1.189".length > 0) return "0.1.189";
+  if ("0.1.191".length > 0) return "0.1.191";
   return void 0;
 }
 function resolveUpdateReleaseVersion(env = process.env, stamp = readVersionStamp()) {
@@ -52672,7 +52737,6 @@ var Server = class {
   authMode;
   bindAddresses;
   telemetryOptions;
-  bindFailures = [];
   telemetryRuntime = null;
   updateChannel = null;
   listeningPort;
@@ -52776,9 +52840,11 @@ var Server = class {
     }
   }
   async start() {
-    this.bindFailures.length = 0;
     this.baseURLs = [];
     let resolvedPort = this.port;
+    const attempts = [];
+    const boundServers = [];
+    const pendingBaseURLs = [];
     for (const [index, server] of this.httpServers.entries()) {
       const address = this.bindAddresses[index];
       const port = index === 0 ? this.port : resolvedPort;
@@ -52788,21 +52854,26 @@ var Server = class {
         if (typeof serverAddress === "object" && serverAddress) {
           resolvedPort = serverAddress.port;
         }
-        this.listeningPort = resolvedPort;
         const baseURL = buildServerURL(address, resolvedPort);
-        this.baseURLs.push(baseURL);
-        log(this.store.storagePath, `bound ${address}:${resolvedPort}`, { address, port: resolvedPort, baseURL });
+        attempts.push({ address, port: resolvedPort, outcome: "bound" });
+        boundServers.push(server);
+        pendingBaseURLs.push(baseURL);
       } catch (error48) {
         const bindError = error48 instanceof Error ? error48 : new Error(String(error48));
-        this.bindFailures.push({ address, port, error: bindError });
+        attempts.push({ address, port, outcome: "failed", error: bindError });
         console.error(`Television failed to bind ${address}:${port}: ${bindError.message}`);
-        log(this.store.storagePath, `bind failed on ${address}:${port}`, { address, port, error: bindError });
       }
     }
-    if (this.baseURLs.length === 0) {
-      const message = `Television failed to bind every requested address: ${this.bindFailures.map((failure) => `${failure.address}:${failure.port} (${failure.error.message})`).join(", ")}`;
-      log(this.store.storagePath, message, { reason: "all bind addresses failed", snapshot: this.configurationSnapshot() });
-      throw new Error(message);
+    if (attempts.some((attempt) => attempt.outcome === "failed")) {
+      log(this.store.storagePath, "server startup failed", buildStartupBindFailureRecord(attempts));
+      await Promise.allSettled(boundServers.map((server) => this.closeServer(server)));
+      throw new StartupBindError(attempts);
+    }
+    this.listeningPort = resolvedPort;
+    this.baseURLs = pendingBaseURLs;
+    for (const [index, baseURL] of this.baseURLs.entries()) {
+      const address = this.bindAddresses[index];
+      log(this.store.storagePath, `bound ${address}:${resolvedPort}`, { address, port: resolvedPort, baseURL });
     }
     await this.startTelemetry();
     this.startUpdateChannel();
@@ -52828,9 +52899,6 @@ var Server = class {
   getBaseURLs() {
     return [...this.baseURLs];
   }
-  getBindFailures() {
-    return [...this.bindFailures];
-  }
   getAuthToken() {
     return this.store.authToken;
   }
@@ -52953,11 +53021,6 @@ var Server = class {
       port: this.getListeningPort(),
       bindAddresses: this.bindAddresses,
       boundURLs: this.baseURLs,
-      bindFailures: this.bindFailures.map((failure) => ({
-        address: failure.address,
-        port: failure.port,
-        error: serializeError(failure.error)
-      })),
       authMode: this.authMode
     };
   }
@@ -52995,8 +53058,8 @@ var Server = class {
   };
 };
 function readServerPackageVersion() {
-  if ("0.1.189".length > 0) {
-    return telemetryVersion("0.1.189");
+  if ("0.1.191".length > 0) {
+    return telemetryVersion("0.1.191");
   }
   const packageJsonPath = import_node_path11.default.resolve(import_node_path11.default.dirname((0, import_node_url.fileURLToPath)(import_meta.url)), "..", "package.json");
   if (!(0, import_node_fs9.existsSync)(packageJsonPath)) return telemetryVersion("0.0.0");
@@ -54513,6 +54576,7 @@ var DAEMON_NAME = "com.television.server";
 var TELEMETRY_LAUNCH_MODE_ENV = "TELEVISION_LAUNCH_MODE";
 var SKILL_INSTALL_TELEMETRY_TIMEOUT_MS2 = 1e3;
 var MAX_PORT = 65535;
+var MAX_PROCESS_EXIT_STATUS = 255;
 var HTTP_UNAUTHORIZED_STATUS2 = 401;
 var HELP_POINTER = "Television ships bundled skills. The main skill is `television` \u2014 keep its guidance available for screens, lifecycle, the `tv` CLI, and artifact workflow. Re-read it only if it is not already in context or you know the installed skill changed. Additional `tv-*` skills cover specialized artifact types and theming. Install all bundled skills with `tv skills install <path>` (e.g. ~/.openclaw/skills) or `tv skills install -i`.";
 var CLIDirectiveError = class extends Error {
@@ -54572,8 +54636,8 @@ function resolveVercelSkillsInstallerBin() {
   return localRequire.resolve("skills/bin/cli.mjs");
 }
 function readCLIVersion() {
-  if ("0.1.189".length > 0) {
-    return "0.1.189";
+  if ("0.1.191".length > 0) {
+    return "0.1.191";
   }
   const devPackageJsonPath = import_node_path17.default.join(getDevPackageDir(), "package.json");
   if (!(0, import_node_fs14.existsSync)(devPackageJsonPath)) {
@@ -54634,6 +54698,11 @@ function storagePathFromArgv(argv) {
   }
   return void 0;
 }
+function exitStatusFromError(error48) {
+  if (typeof error48 !== "object" || error48 === null || !("exitStatus" in error48)) return void 0;
+  const exitStatus = error48.exitStatus;
+  return typeof exitStatus === "number" && Number.isInteger(exitStatus) && exitStatus > 0 && exitStatus <= MAX_PROCESS_EXIT_STATUS ? exitStatus : void 0;
+}
 function formatCLIError(error48, argv = []) {
   if (error48 instanceof CLIDirectiveError) {
     return error48.message;
@@ -55325,7 +55394,7 @@ async function runCLI(argv, environment = {}) {
     }
     env.stderr.write(`${formatCLIError(error48, argv)}
 `);
-    return 1;
+    return exitStatusFromError(error48) ?? 1;
   }
 }
 if (!isVitestRuntime()) {