@cloverhound/webex-cli 0.0.0-stage → 0.17.0-rc.2

package/README.md

@@ -1,3 +1,21 @@
-# Temporary Holding Version
+# @cloverhound/webex-cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The [Webex CLI](https://github.com/Cloverhound/webex-cli) packaged for npm. It manages Webex Admin, Calling, Contact Center, Devices, Meetings, and Messaging APIs from the command line, and runs as an MCP server for AI agents.
+
+```bash
+npx -y @cloverhound/webex-cli login --device
+npx -y @cloverhound/webex-cli calling people list
+```
+
+Or install it globally:
+
+```bash
+npm install -g @cloverhound/webex-cli
+webex --version
+```
+
+npm installs only the prebuilt binary for your platform (macOS, Linux, or Windows on x64 or arm64) through an optional dependency. No install script runs and nothing is downloaded from GitHub, so the package works in sandboxes that allow the npm registry but block other hosts.
+
+To run it as an MCP server, use `npx -y @cloverhound/webex-cli@<version> mcp serve` as the server command.
+
+See the [documentation](https://cloverhound.github.io/webex-cli/) for login options, including device login for machines without a browser.

package/bin/webex.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+"use strict";
+
+// Runs the webex binary from the platform package npm installed alongside this
+// one (an optionalDependency selected by its os/cpu fields).
+
+const { spawn } = require("node:child_process");
+const fs = require("node:fs");
+
+const SUPPORTED = new Set([
+  "darwin-arm64",
+  "darwin-x64",
+  "linux-arm64",
+  "linux-x64",
+  "win32-arm64",
+  "win32-x64",
+]);
+
+function fail(message) {
+  process.stderr.write(`webex-cli: ${message}\n`);
+  process.exit(1);
+}
+
+function binaryPath() {
+  const key = `${process.platform}-${process.arch}`;
+  if (!SUPPORTED.has(key)) {
+    fail(`no build for ${key}. See https://github.com/Cloverhound/webex-cli#install for other install methods.`);
+  }
+  const pkg = `@cloverhound/webex-cli-${key}`;
+  const exe = process.platform === "win32" ? "webex.exe" : "webex";
+  let bin;
+  try {
+    bin = require.resolve(`${pkg}/bin/${exe}`);
+  } catch {
+    fail(`${pkg} is not installed. Reinstall without --omit=optional or --no-optional.`);
+  }
+  if (process.platform !== "win32") {
+    try {
+      fs.accessSync(bin, fs.constants.X_OK);
+    } catch {
+      // Some package managers drop the executable bit when unpacking.
+      try {
+        fs.chmodSync(bin, 0o755);
+      } catch {}
+    }
+  }
+  return bin;
+}
+
+const child = spawn(binaryPath(), process.argv.slice(2), { stdio: "inherit" });
+
+// MCP hosts stop servers with a signal; pass it on so the binary is not orphaned.
+for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+  process.on(signal, () => {
+    if (!child.killed) child.kill(signal);
+  });
+}
+
+child.on("error", (err) => fail(err.message));
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.removeAllListeners(signal);
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code ?? 1);
+  }
+});

package/package.json

@@ -1,6 +1,35 @@
 {
   "name": "@cloverhound/webex-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.17.0-rc.2",
+  "description": "CLI and MCP server for Webex Admin, Calling, Contact Center, Devices, Meetings, and Messaging APIs",
+  "license": "MIT",
+  "homepage": "https://github.com/Cloverhound/webex-cli",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Cloverhound/webex-cli.git"
+  },
+  "keywords": [
+    "webex",
+    "cli",
+    "mcp",
+    "cisco",
+    "contact-center"
+  ],
+  "bin": {
+    "webex": "bin/webex.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@cloverhound/webex-cli-darwin-arm64": "0.17.0-rc.2",
+    "@cloverhound/webex-cli-darwin-x64": "0.17.0-rc.2",
+    "@cloverhound/webex-cli-linux-arm64": "0.17.0-rc.2",
+    "@cloverhound/webex-cli-linux-x64": "0.17.0-rc.2",
+    "@cloverhound/webex-cli-win32-arm64": "0.17.0-rc.2",
+    "@cloverhound/webex-cli-win32-x64": "0.17.0-rc.2"
+  }
+}