orkestrator 2.22.3 → 2.23.0

package/README.md

@@ -146,5 +146,10 @@ fixture project/environment lifecycle through the installed client, confirms
 only one backend ran, and stops it. It needs network access, which is why it is
 a publish gate rather than part of `mise run test`.
 
+The npm dist-tag follows the version's update channel: `2.23.0` publishes as
+`latest`, `2.23.0-beta` as `beta` and `2.23.0-alpha` as `alpha`, so
+`bunx orkestrator` only ever gets a stable release. Try a prerelease with
+`bunx orkestrator@beta` or `bunx orkestrator@alpha`.
+
 `dist/client.js` is the client bundle the launcher imports first; it must stay
 free of backend imports so client commands never initialize a service.

package/dist/client.js

@@ -6560,6 +6560,14 @@ var PUBLIC_ACTIONS = {
     milestone: "D",
     summary: "Read the host's Orkestrator version, its updater, the last check and the update job."
   },
+  "host.update.channel": {
+    version: 1,
+    mutation: true,
+    effects: ["metadata"],
+    observation: "receipt",
+    milestone: "D",
+    summary: "Choose the host update channel and request a fresh check."
+  },
   "host.update.check": {
     version: 1,
     mutation: true,
@@ -9559,6 +9567,36 @@ var environmentCommands = [
   ...settingsCommands("environment")
 ];
 
+// ../protocol/src/host-maintenance.ts
+var HOST_UPDATE_IDLE_WAIT = Object.freeze({
+  defaultSeconds: 3600,
+  minSeconds: 60,
+  maxSeconds: 86400
+});
+var HOST_UPDATE_CHANNELS = ["stable", "beta", "unstable"];
+var HOST_UPDATE_CHANNEL_TAGS = Object.freeze({ stable: "latest", beta: "beta", unstable: "alpha" });
+function isHostUpdateChannel(value) {
+  return HOST_UPDATE_CHANNELS.includes(value);
+}
+var ACTIVE_HOST_UPDATE_JOB_STATES = new Set([
+  "requested",
+  "downloading",
+  "waiting-for-idle",
+  "awaiting-restart",
+  "restarting"
+]);
+var CANCELLABLE_HOST_UPDATE_JOB_STATES = new Set([
+  "requested",
+  "downloading",
+  "waiting-for-idle",
+  "awaiting-restart"
+]);
+var HOST_MAINTENANCE_LIMITS = Object.freeze({
+  idMaxChars: 100,
+  versionMaxChars: 64,
+  errorMaxChars: 500
+});
+
 // src/client/commands/host.ts
 var WAIT_OPTION = {
   name: "wait",
@@ -9567,7 +9605,7 @@ var WAIT_OPTION = {
 };
 function hostLines(host) {
   const updater = host.updater;
-  const lines = [`Version: ${host.version}`];
+  const lines = [`Version: ${host.version}`, `Update channel: ${host.updateChannel}`];
   lines.push(updater.available ? `Updater: ${updater.kind}` : `Updater: unavailable${updater.reason ? ` (${updater.reason})` : ""}`);
   if (updater.checkedAt) {
     const found = updater.latestVersion ?? "unknown";
@@ -9697,6 +9735,26 @@ var hostCommands = [
       };
     }
   },
+  {
+    path: ["host", "update", "channel"],
+    summary: "Choose the host's update channel: stable, beta or unstable.",
+    positionals: [{ name: "channel", required: true, description: "stable, beta or unstable" }],
+    options: [REQUEST_ID_OPTION],
+    async run(context, parsed) {
+      const channel = parsed.positionals.channel;
+      if (!isHostUpdateChannel(channel))
+        throw new CliError("invalid-input", "channel must be stable, beta or unstable");
+      const { session, result, receipt, warnings } = await submit(context, "host.update.channel", { channel }, parsed.options);
+      return {
+        action: "host.update.channel",
+        result,
+        receipt,
+        warnings,
+        connection: session.identity,
+        human: hostLines(result.host)
+      };
+    }
+  },
   {
     path: ["host", "update", "check"],
     summary: "Ask the backend's computer to check for an Orkestrator update.",
@@ -9860,7 +9918,7 @@ import path7 from "path";
 // ../../apps/backend/package.json
 var package_default = {
   name: "@orkestrator/backend",
-  version: "2.22.3",
+  version: "2.23.0",
   private: true,
   type: "module",
   exports: {