@theharshitsingh/ao 0.10.1 → 0.10.2

package/bin/ao.js

@@ -1,41 +1,65 @@
 #!/usr/bin/env node
+// Pure-Node shim: resolve the per-platform optionalDependency that holds the
+// prebuilt Go `ao` binary for this host, then exec it transparently.
+// Zero install scripts; zero third-party deps. The binary is delivered by npm
+// installing only the matching `@theharshitsingh/ao-<platform>-<arch>` package (its
+// os/cpu fields gate the rest out).
+
 "use strict";
 
-// `ao`: open the Agent Orchestrator desktop app. Self-healing: if the bundle is
-// missing (e.g. installed with --ignore-scripts, or postinstall deferred the
-// download), fetch it first, then launch. The app is the product; this is just
-// the launcher.
-
-const { spawn } = require("node:child_process");
-const { ensureBundle, appLaunchPath } = require("../lib/bootstrap");
-
-async function main() {
-	await ensureBundle();
-	const app = appLaunchPath();
-
-	let child;
-	if (process.platform === "darwin") {
-		// `open` hands the .app to LaunchServices so it runs as a normal GUI app.
-		child = spawn("open", [app, ...process.argv.slice(2)], {
-			detached: true,
-			stdio: "ignore",
-		});
-	} else {
-		// linux: launch the packaged executable directly. Ensure the exec bit
-		// survived unzip (some unzip impls drop it).
-		const exe = `${app}/agent-orchestrator`;
-		try {
-			require("node:fs").chmodSync(exe, 0o755);
-		} catch {}
-		child = spawn(exe, process.argv.slice(2), {
-			detached: true,
-			stdio: "ignore",
-		});
-	}
-	child.unref();
+const { spawnSync } = require("node:child_process");
+const path = require("node:path");
+
+// npm cpu names match process.arch (x64/arm64); npm os names match
+// process.platform (darwin/win32/linux). Our platform packages are named
+// `@theharshitsingh/ao-<platform>-<arch>` to mirror that exactly.
+const platform = process.platform;
+const arch = process.arch;
+const pkg = `@theharshitsingh/ao-${platform}-${arch}`;
+const binName = platform === "win32" ? "ao.exe" : "ao";
+
+function resolveBinary() {
+  // require.resolve the platform package's package.json to find its install
+  // dir (works whether hoisted to a parent node_modules or nested), then join
+  // the binary path. The platform package ships the binary under bin/.
+  let pkgJsonPath;
+  try {
+    pkgJsonPath = require.resolve(`${pkg}/package.json`);
+  } catch {
+    return null;
+  }
+  return path.join(path.dirname(pkgJsonPath), "bin", binName);
+}
+
+const binary = resolveBinary();
+
+if (!binary) {
+  process.stderr.write(
+    `@theharshitsingh/ao: no prebuilt binary for ${platform}-${arch}.\n` +
+      `The optional dependency ${pkg} is not installed, which usually means\n` +
+      `this platform is unsupported. Supported: darwin-arm64, darwin-x64,\n` +
+      `win32-x64, linux-x64.\n`,
+  );
+  process.exit(1);
 }
 
-main().catch((err) => {
-	console.error(err.message);
-	process.exit(1);
-});
+const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+
+if (result.error) {
+  if (result.error.code === "ENOENT") {
+    process.stderr.write(
+      `@theharshitsingh/ao: binary not found at ${binary}.\n` +
+        `Reinstall @theharshitsingh/ao to restore the platform package.\n`,
+    );
+  } else {
+    process.stderr.write(`@theharshitsingh/ao: failed to run binary: ${result.error.message}\n`);
+  }
+  process.exit(1);
+}
+
+// Propagate signal-terminations as a conventional 128+signal code, else the
+// child's own exit code.
+if (result.signal) {
+  process.exit(1);
+}
+process.exit(result.status === null ? 1 : result.status);

package/package.json

@@ -1,41 +1,18 @@
 {
-	"name": "@theharshitsingh/ao",
-	"version": "0.10.1",
-	"description": "Bootstrapper for the Agent Orchestrator desktop app. Downloads the signed app for your platform and launches it.",
-	"license": "MIT",
-	"homepage": "https://github.com/harshitsinghbhandari/agent-orchestrator",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/harshitsinghbhandari/agent-orchestrator.git"
-	},
-	"bin": {
-		"ao": "bin/ao.js"
-	},
-	"scripts": {
-		"postinstall": "node install.js",
-		"test": "node test/selfcheck.js"
-	},
-	"files": [
-		"bin/",
-		"lib/",
-		"install.js",
-		"README.md"
-	],
-	"engines": {
-		"node": ">=20"
-	},
-	"publishConfig": {
-		"access": "public"
-	},
-	"ao": {
-		"releaseRepo": "harshitsinghbhandari/agent-orchestrator",
-		"releaseTag": "npm-bootstrap-0.10.0",
-		"checksums": "SHA256SUMS",
-		"assets": {
-			"darwin-arm64": "agent-orchestrator-darwin-arm64.zip",
-			"darwin-x64": "agent-orchestrator-darwin-x64.zip",
-			"linux-x64": "agent-orchestrator-linux-x64.zip",
-			"linux-arm64": "agent-orchestrator-linux-arm64.zip"
-		}
-	}
+  "name": "@theharshitsingh/ao",
+  "version": "0.10.2",
+  "description": "Agent Orchestrator CLI. Resolves and runs the prebuilt Go binary for your platform.",
+  "license": "MIT",
+  "bin": {
+    "ao": "bin/ao.js"
+  },
+  "files": [
+    "bin/"
+  ],
+  "optionalDependencies": {
+    "@theharshitsingh/ao-darwin-arm64": "0.10.2",
+    "@theharshitsingh/ao-darwin-x64": "0.10.2",
+    "@theharshitsingh/ao-linux-x64": "0.10.2",
+    "@theharshitsingh/ao-win32-x64": "0.10.2"
+  }
 }

package/README.md

@@ -1,29 +0,0 @@
-# Agent Orchestrator (npm bootstrapper)
-
-Install the Agent Orchestrator desktop app from npm:
-
-```bash
-npm i -g @theharshitsingh/ao
-ao
-```
-
-`npm i -g` installs a small **bootstrapper**, not the app itself. On install it
-downloads the signed desktop bundle for your platform from the matching GitHub
-Release, verifies its SHA-256, and unpacks it. Running `ao` launches the app.
-
-This is a one-time delivery channel. Once the app is installed it updates itself
-through its built-in updater. `npm update` is **not** the update path.
-
-## Supported platforms
-
-This build ships macOS `darwin-arm64` (Apple Silicon) and `darwin-x64` (Intel),
-both signed + notarized, plus Linux `linux-x64` and `linux-arm64` portable bundles
-(checksum-verified; Linux has no Apple-style notarization). Other platforms,
-including Windows, fail the install with a pointer to the
-[Releases page](https://github.com/harshitsinghbhandari/agent-orchestrator/releases),
-where direct installers (`.dmg` / `.deb` / `.exe`) live.
-
-## `--ignore-scripts`
-
-If you install with `npm install --ignore-scripts`, the postinstall download is
-skipped; the first `ao` run downloads the bundle instead. Either way it works.

package/install.js

@@ -1,23 +0,0 @@
-"use strict";
-
-// postinstall: fetch the platform bundle eagerly so the first `ao` is instant.
-// On an unsupported platform we fail loudly and non-zero (no silent half-install);
-// on a transient download failure we DON'T fail the npm install, because the `ao`
-// launcher will retry the fetch on first run (this also covers --ignore-scripts).
-
-const { ensureBundle, unsupportedError, assetName } = require("./lib/bootstrap");
-
-async function main() {
-	if (!assetName()) {
-		console.error(String(unsupportedError().message));
-		process.exit(1);
-	}
-	try {
-		await ensureBundle();
-	} catch (err) {
-		console.error(`Agent Orchestrator: deferred download to first run (${err.message})`);
-		// Non-fatal: bin/ao.js will fetch on first launch.
-	}
-}
-
-main();

package/lib/bootstrap.js

@@ -1,163 +0,0 @@
-"use strict";
-
-// Shared bootstrapper logic: detect platform -> map to a GitHub Release asset ->
-// download -> verify SHA-256 -> extract -> expose the app path. Used by both the
-// postinstall (install.js) and the `ao` launcher (bin/ao.js), so a user who
-// installed with --ignore-scripts still gets a working app on first run.
-//
-// Zero runtime dependencies: Node 20+ global fetch + built-ins only.
-
-const fs = require("node:fs");
-const path = require("node:path");
-const crypto = require("node:crypto");
-const { spawnSync } = require("node:child_process");
-const { Readable } = require("node:stream");
-const { pipeline } = require("node:stream/promises");
-
-const pkg = require("../package.json");
-const cfg = pkg.ao;
-
-const packageRoot = path.resolve(__dirname, "..");
-const vendorDir = path.join(packageRoot, "vendor");
-
-function platformKey() {
-	return `${process.platform}-${process.arch}`;
-}
-
-function assetName() {
-	return cfg.assets[platformKey()];
-}
-
-function releasesPage() {
-	return `https://github.com/${cfg.releaseRepo}/releases`;
-}
-
-function downloadUrl(name) {
-	return `https://github.com/${cfg.releaseRepo}/releases/download/${cfg.releaseTag}/${name}`;
-}
-
-// The unpacked app bundle's launch target, per OS. Only darwin ships an asset
-// today; linux is mapped for when its archive lands.
-function appLaunchPath() {
-	if (process.platform === "darwin") {
-		return path.join(vendorDir, "Agent Orchestrator.app");
-	}
-	// linux: maker-zip lays down "Agent Orchestrator-linux-<arch>/" with the
-	// executable inside it.
-	return path.join(vendorDir, `Agent Orchestrator-linux-${process.arch}`);
-}
-
-function isInstalled() {
-	return fs.existsSync(appLaunchPath());
-}
-
-function unsupportedError() {
-	return new Error(
-		`Agent Orchestrator has no npm bundle for ${platformKey()}.\n` +
-			`Install the desktop app directly instead: ${releasesPage()}`,
-	);
-}
-
-// Parse a `<sha256>  <filename>` line out of a SHA256SUMS file.
-function expectedSha(sumsText, name) {
-	for (const line of sumsText.split("\n")) {
-		const m = line.trim().match(/^([0-9a-f]{64})\s+\*?(.+)$/i);
-		if (m && path.basename(m[2]) === name) return m[1].toLowerCase();
-	}
-	return null;
-}
-
-async function fetchWithRetry(url, tries = 3) {
-	let lastErr;
-	for (let i = 0; i < tries; i++) {
-		try {
-			const res = await fetch(url, { redirect: "follow" });
-			if (!res.ok) throw new Error(`HTTP ${res.status} for ${url}`);
-			return res;
-		} catch (err) {
-			lastErr = err;
-			// ponytail: linear backoff, fine for a 3-shot install download.
-			await new Promise((r) => setTimeout(r, 750 * (i + 1)));
-		}
-	}
-	throw lastErr;
-}
-// ponytail: no HTTP(S)_PROXY plumbing yet. Add an undici ProxyAgent dispatcher
-// here if corp-proxy installs need it; the GitHub CDN is reachable directly for
-// the common case.
-
-async function downloadToFile(url, dest) {
-	const res = await fetchWithRetry(url);
-	await pipeline(Readable.fromWeb(res.body), fs.createWriteStream(dest));
-}
-
-function sha256File(file) {
-	const hash = crypto.createHash("sha256");
-	hash.update(fs.readFileSync(file));
-	return hash.digest("hex");
-}
-
-function extract(archive, dest) {
-	fs.mkdirSync(dest, { recursive: true });
-	if (archive.endsWith(".zip")) {
-		// ditto preserves the code signature / xattrs of the signed .app better
-		// than unzip. Present on every macOS.
-		const tool = process.platform === "darwin" ? "ditto" : "unzip";
-		const args = tool === "ditto" ? ["-x", "-k", archive, dest] : ["-q", archive, "-d", dest];
-		const r = spawnSync(tool, args, { stdio: "inherit" });
-		if (r.status !== 0) throw new Error(`extract failed (${tool} exit ${r.status})`);
-	} else {
-		const r = spawnSync("tar", ["-xzf", archive, "-C", dest], { stdio: "inherit" });
-		if (r.status !== 0) throw new Error(`extract failed (tar exit ${r.status})`);
-	}
-}
-
-// Idempotent: returns the app path, downloading+verifying+extracting only if the
-// bundle is not already present. Throws loudly (never half-installs) on any
-// unsupported platform, missing asset, or checksum mismatch.
-async function ensureBundle({ quiet = false } = {}) {
-	if (isInstalled()) return appLaunchPath();
-
-	const name = assetName();
-	if (!name) throw unsupportedError();
-
-	const log = quiet ? () => {} : (m) => console.error(m);
-	const tmp = fs.mkdtempSync(path.join(require("node:os").tmpdir(), "ao-dl-"));
-	const archive = path.join(tmp, name);
-
-	try {
-		log(`Agent Orchestrator: downloading ${name} ...`);
-		await downloadToFile(downloadUrl(name), archive);
-
-		log("Agent Orchestrator: verifying checksum ...");
-		const sumsRes = await fetchWithRetry(downloadUrl(cfg.checksums));
-		const want = expectedSha(await sumsRes.text(), name);
-		if (!want) throw new Error(`no ${name} entry in ${cfg.checksums}`);
-		const got = sha256File(archive);
-		if (got !== want) {
-			throw new Error(`checksum mismatch for ${name}\n  expected ${want}\n  got      ${got}`);
-		}
-
-		log("Agent Orchestrator: unpacking ...");
-		fs.rmSync(vendorDir, { recursive: true, force: true });
-		extract(archive, vendorDir);
-		if (!isInstalled()) {
-			throw new Error(`unpacked archive did not contain the expected app at ${appLaunchPath()}`);
-		}
-		log("Agent Orchestrator: ready.");
-		return appLaunchPath();
-	} finally {
-		fs.rmSync(tmp, { recursive: true, force: true });
-	}
-}
-
-module.exports = {
-	ensureBundle,
-	isInstalled,
-	appLaunchPath,
-	assetName,
-	platformKey,
-	expectedSha,
-	releasesPage,
-	unsupportedError,
-};