@zixt/host 0.0.83 → 0.0.84

package/dist/index.js

@@ -31,7 +31,7 @@ import { homedir as homedir3 } from "node:os";
 // package.json
 var package_default = {
   name: "@zixt/host",
-  version: "0.0.83",
+  version: "0.0.84",
   type: "module",
   exports: {
     ".": "./src/client.ts",
@@ -16805,6 +16805,7 @@ var ListTasksResponse = external_exports.object({
 // ../../packages/contracts/src/protocol.ts
 var PROTOCOL_VERSION = 8;
 var BROWSER_PROFILE_INVENTORY_PAGE_SIZE = 200;
+var HELLO_UNWOUND_ASSIGNMENT_LIMIT = 1e3;
 var TASK_CANCEL_ACK_EVENT = "zixt.task.cancel.acknowledged";
 var TASK_CREDENTIAL_ROLLOVER_ACK_EVENT = "zixt.task.credential_rollover.acknowledged";
 var UnwoundAssignmentRef = external_exports.object({
@@ -18051,7 +18052,7 @@ var HelloFrame = external_exports.object({
    * prior socket died. Optional for rolling v5 hosts; repeated references are
    * idempotent and remain presence/host/org/epoch fenced by the cloud.
    */
-  unwoundAssignments: external_exports.array(UnwoundAssignmentRef).max(1e3).optional()
+  unwoundAssignments: external_exports.array(UnwoundAssignmentRef).max(HELLO_UNWOUND_ASSIGNMENT_LIMIT).optional()
 });
 var BrowserProfileInventoryFrame = external_exports.object({
   type: external_exports.literal("browser.profile.inventory"),
@@ -18176,6 +18177,8 @@ var CLOSE_CODES = {
   replacedByNewerConnection: 4003,
   revoked: 4004
 };
+var UNSUPPORTED_PROTOCOL_CLOSE_REASON = "unsupported protocol version";
+var CLOSE_REASON_MAX_BYTES = 123;
 
 // ../../packages/contracts/src/manager.ts
 var MANAGER_DEFAULT_MODEL = "gpt-5.6-luna";
@@ -21315,6 +21318,17 @@ function operationGrantRetryCause(code) {
   }
   return "GitHub is temporarily unavailable for credential issuance";
 }
+function closeDetail(reason) {
+  if (reason === void 0) return void 0;
+  const raw = typeof reason === "string" ? reason : reason.toString("utf8");
+  let printable = "";
+  for (const character of raw) {
+    const code = character.codePointAt(0) ?? 0;
+    printable += code < 32 || code === 127 ? " " : character;
+  }
+  const text = printable.trim().slice(0, CLOSE_REASON_MAX_BYTES);
+  return text.length > 0 ? text : void 0;
+}
 var HostClient = class _HostClient {
   constructor(opts) {
     this.opts = opts;
@@ -21687,9 +21701,13 @@ var HostClient = class _HostClient {
       const inventoryConfigured = Boolean(
         this.opts.browser?.profileInventoryPages || this.opts.browser?.profileInventory
       );
-      const unwoundAssignments = [...this.pendingUnwoundAssignments.values()].sort(
+      const disclaimable = [...this.pendingUnwoundAssignments.values()].sort(
         (left, right) => left.taskId === right.taskId ? left.epoch - right.epoch : left.taskId.localeCompare(right.taskId)
       );
+      const unwoundAssignments = disclaimable.slice(0, HELLO_UNWOUND_ASSIGNMENT_LIMIT);
+      if (disclaimable.length > unwoundAssignments.length) {
+        this.opts.onDisclaimerBacklog?.(disclaimable.length, unwoundAssignments.length);
+      }
       this.send(
         {
           type: "hello",
@@ -21721,14 +21739,14 @@ var HostClient = class _HostClient {
         if (this.ws === ws) ws.terminate();
       });
     });
-    ws.on("close", (code) => {
+    ws.on("close", (code, reason) => {
       if (inventoryRetryTimer) clearTimeout(inventoryRetryTimer);
-      void this.handleClose(ws, code, closeReason, frameTail);
+      void this.handleClose(ws, code, closeReason, frameTail, closeDetail(reason));
     });
     ws.on("error", () => {
     });
   }
-  async handleClose(ws, code, closeReason, frameTail = Promise.resolve()) {
+  async handleClose(ws, code, closeReason, frameTail = Promise.resolve(), detail) {
     if (this.ws !== ws) return;
     this.ws = void 0;
     this.protocolReady = false;
@@ -21767,13 +21785,18 @@ var HostClient = class _HostClient {
       await this.unwindAllRuns("host connection was replaced by a newer client", "client_shutdown");
       return;
     }
-    if (code === CLOSE_CODES.protocolError) {
-      this.opts.onStatus?.("incompatible");
+    const versionMismatch = code === CLOSE_CODES.protocolError && detail === UNSUPPORTED_PROTOCOL_CLOSE_REASON;
+    if (versionMismatch) {
+      this.opts.onStatus?.("incompatible", detail);
       this.stopped = true;
       await this.unwindAllRuns("host protocol is incompatible", "client_shutdown");
       return;
     }
-    this.opts.onStatus?.(closeReason === "heartbeat_timeout" ? "unresponsive" : "disconnected");
+    if (code === CLOSE_CODES.protocolError) {
+      this.opts.onStatus?.("rejected", detail);
+    } else {
+      this.opts.onStatus?.(closeReason === "heartbeat_timeout" ? "unresponsive" : "disconnected");
+    }
     if (this.stopped) return;
     await this.unwindAllRuns(
       closeReason === "heartbeat_timeout" ? "Zixt Cloud stopped answering heartbeat probes" : "host connection was lost",
@@ -40411,16 +40434,26 @@ var colorOverride = forcedColor(cliOptions.color) ?? (process.env[HOST_CONSOLE_C
 var hostConsoleTail = [];
 var hostConsoleSequence = 0;
 var clientForConsole = {};
+function recordConsoleLine(line) {
+  const entry = { sequence: ++hostConsoleSequence, line };
+  hostConsoleTail.push(entry);
+  if (hostConsoleTail.length > 200) hostConsoleTail.shift();
+  clientForConsole.current?.hostConsoleLine(entry);
+}
 var log = createHostLogger({
   ...colorOverride === void 0 ? {} : { color: colorOverride },
   write: (line) => {
     console.error(line);
-    const entry = { sequence: ++hostConsoleSequence, line };
-    hostConsoleTail.push(entry);
-    if (hostConsoleTail.length > 200) hostConsoleTail.shift();
-    clientForConsole.current?.hostConsoleLine(entry);
+    recordConsoleLine(line);
   }
 });
+function replayConsoleLine(level, message, context) {
+  recordConsoleLine(
+    formatHostLogLine(level, message, context, {
+      ...colorOverride === void 0 ? {} : { color: colorOverride }
+    })
+  );
+}
 if (cliOptions.help) {
   process.stdout.write(`${hostHelpText()}
 `);
@@ -40805,6 +40838,14 @@ var client = new HostClient({
       forgetAcknowledgedAcceptedAssignments(assignments, acceptedAssignmentRoot)
     ]);
   },
+  onDisclaimerBacklog: (pending, reported) => {
+    log.warn("More unfinished Task claims than one connection can report", {
+      machine,
+      pending,
+      reported,
+      next: "The rest are reported as this Machine reconnects; report this if it does not clear"
+    });
+  },
   persistAcceptedAssignment: (assignment) => recordAcceptedAssignment(assignment, acceptedAssignmentRoot).then(() => void 0),
   forgetAcceptedAssignment: (assignment) => forgetAcceptedAssignment(assignment, acceptedAssignmentRoot),
   persistTerminalOutcome: (hostId, outcome) => recordTerminalOutcome(hostId, outcome, terminalOutcomeRoot),
@@ -40836,7 +40877,7 @@ var client = new HostClient({
   onUsableTelemetryReport: () => {
     reportWorkerReadiness();
   },
-  onStatus: (status) => {
+  onStatus: (status, detail) => {
     if (status === lastReportedStatus) return;
     lastReportedStatus = status;
     switch (status) {
@@ -40876,6 +40917,13 @@ var client = new HostClient({
         });
         queueMicrotask(() => shutdown(packagedBuild ? UPDATE_EXIT_CODE : DO_NOT_RESTART_EXIT_CODE));
         break;
+      case "rejected":
+        log.error("Zixt Cloud refused this Machine", {
+          ...connectionContext,
+          reason: detail ?? "the cloud gave no reason",
+          next: "Zixt keeps retrying; report this reason if the Machine stays offline, because no update changes it"
+        });
+        break;
     }
   },
   executor,
@@ -40893,7 +40941,7 @@ for (const { record: record2 } of reportedWorkerExits) {
     ...context,
     next: "This Machine restarted itself; report it if the same exit repeats"
   });
-  for (const line of record2.stderr) log.error("Previous worker output", { machine, line });
+  for (const line of record2.stderr) replayConsoleLine("error", "Previous worker output", { line });
 }
 log.info("Starting Zixt Host", connectionContext);
 client.start();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zixt/host",
-  "version": "0.0.83",
+  "version": "0.0.84",
   "type": "module",
   "exports": {
     ".": "./src/client.ts",