@boxcompute/cli 0.2.1 → 0.2.2

package/README.md

@@ -61,9 +61,11 @@ Deploy the server release with both Sandbox API v1 and v2 before publishing CLI
 contract. After that, clients need only upgrade the package:
 
 ```sh
-npm install --global @boxcompute/cli@latest
+bxc update
 ```
 
-The installation refreshes untouched managed skills before the client's next
-agent session. The new CLI uses v2 for multi-instance sandboxes and gives a
-server-first upgrade message if it reaches an older deployment.
+`bxc up` is the short alias. If the automatic update cannot invoke npm, use
+`npm install --global @boxcompute/cli@latest` manually. Updating preserves the
+saved BoxCompute credential and refreshes untouched managed skills before the
+client's next agent session. The new CLI uses v2 for multi-instance sandboxes
+and gives a server-first upgrade message if it reaches an older deployment.

package/dist/cli.d.ts

@@ -13,6 +13,7 @@ export type CliDependencies = {
     now?: () => number;
     sleep?: (milliseconds: number) => Promise<void>;
     openBrowser?: (url: string) => void;
+    installUpdate?: (version: string) => Promise<void>;
     loadConnection?: (env: NodeJS.ProcessEnv) => Promise<Connection>;
     loadSavedUrl?: (env: NodeJS.ProcessEnv) => Promise<string | null>;
     saveConnection?: (url: string, token: string, env: NodeJS.ProcessEnv) => Promise<void>;

package/dist/cli.js

@@ -15,6 +15,7 @@ Usage: bxc [options] [command]
 Commands:
 
   version                         Print the version number and exit
+  update                          [alias: up] Update the CLI to the latest npm release
   login                           Log in through BoxCompute in your browser
   logout                          Revoke and remove the saved CLI credential
   auth                            [alias: login] Authentication commands
@@ -48,6 +49,7 @@ Login options:
 Examples:
 
   $ bxc login
+  $ bxc update
   $ bxc skill detect
   $ bxc skill install
   $ bxc workspaces
@@ -133,6 +135,77 @@ export function openBrowser(url, runtime = {}) {
         // polling so headless shells and restricted WSL interop can authenticate.
     }
 }
+function releaseVersion(value) {
+    if (typeof value !== "string")
+        return null;
+    const match = /^(\d+)\.(\d+)\.(\d+)$/.exec(value);
+    if (!match)
+        return null;
+    const parts = match.slice(1).map(Number);
+    return parts.every(Number.isSafeInteger) ? parts : null;
+}
+function compareReleaseVersions(left, right) {
+    for (let index = 0; index < left.length; index += 1) {
+        if (left[index] !== right[index])
+            return left[index] - right[index];
+    }
+    return 0;
+}
+async function installCliUpdate(version) {
+    const executable = platform() === "win32" ? "npm.cmd" : "npm";
+    await new Promise((resolve, reject) => {
+        let child;
+        try {
+            child = spawn(executable, ["install", "--global", `@boxcompute/cli@${version}`], {
+                stdio: ["ignore", "ignore", "inherit"],
+            });
+        }
+        catch (error) {
+            reject(error);
+            return;
+        }
+        child.once("error", reject);
+        child.once("exit", (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`npm exited with code ${code ?? "unknown"}`));
+        });
+    });
+}
+async function updateCli(dependencies) {
+    let response;
+    try {
+        response = await dependencies.fetch("https://registry.npmjs.org/%40boxcompute%2Fcli/latest", {
+            headers: { accept: "application/json" },
+        });
+    }
+    catch (error) {
+        throw new Error(`Could not check npm for updates: ${error?.message ?? String(error)}`);
+    }
+    if (!response.ok)
+        throw new Error(`Could not check npm for updates (HTTP ${response.status})`);
+    const latest = (await response.json()).version;
+    const currentParts = releaseVersion(CLI_VERSION);
+    const latestParts = releaseVersion(latest);
+    if (!currentParts || !latestParts || typeof latest !== "string") {
+        throw new Error("npm returned an invalid BoxCompute CLI version");
+    }
+    if (compareReleaseVersions(latestParts, currentParts) <= 0) {
+        emit(dependencies.io, dependencies.json, { updated: false, version: CLI_VERSION }, `BoxCompute CLI is already up to date (${CLI_VERSION}).\n`);
+        return 0;
+    }
+    write(dependencies.io.stderr, `Updating BoxCompute CLI from ${CLI_VERSION} to ${latest}…\n`);
+    try {
+        await dependencies.install(latest);
+    }
+    catch (error) {
+        throw new Error(`Could not install @boxcompute/cli@${latest}: ${error?.message ?? String(error)}. ` +
+            `Run \`npm install --global @boxcompute/cli@${latest}\` manually.`);
+    }
+    emit(dependencies.io, dependencies.json, { updated: true, previousVersion: CLI_VERSION, version: latest }, `Updated BoxCompute CLI to ${latest}.\n`);
+    return 0;
+}
 const delay = (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds));
 const write = (stream, value) => { stream.write(value); };
 const emit = (io, json, value, human) => {
@@ -272,6 +345,7 @@ export async function runCli(argv, supplied = {}) {
     const now = supplied.now ?? Date.now;
     const sleep = supplied.sleep ?? delay;
     const openBrowserImpl = supplied.openBrowser ?? openBrowser;
+    const installUpdate = supplied.installUpdate ?? installCliUpdate;
     const load = supplied.loadConnection ?? loadConnection;
     const savedUrl = supplied.loadSavedUrl ?? loadSavedUrl;
     const save = supplied.saveConnection ?? saveConnection;
@@ -297,6 +371,8 @@ export async function runCli(argv, supplied = {}) {
     let command = args.shift();
     if (command === "login")
         command = "auth";
+    if (command === "up")
+        command = "update";
     if (command === "skills")
         command = "skill";
     if (command === "list" || command === "ls")
@@ -345,6 +421,11 @@ export async function runCli(argv, supplied = {}) {
         }
         return authenticate(args, { env, io, json, fetch: fetchImpl, now, sleep, openBrowser: openBrowserImpl, loadSavedUrl: savedUrl, saveConnection: save });
     }
+    if (command === "update") {
+        if (args.length)
+            throw new UsageError("update takes no options");
+        return updateCli({ fetch: fetchImpl, install: installUpdate, io, json });
+    }
     if (command === "skill") {
         let action = args.shift();
         if (!action) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boxcompute/cli",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Connect local AI agents to BoxCompute sandboxes",
   "keywords": [
     "boxcompute",