@openagentsinc/pylon 0.1.16 → 0.2.2

package/README.md

@@ -16,6 +16,7 @@ bun install -g @openagentsinc/pylon && pylon
 npx @openagentsinc/pylon --version 0.1.16
 npx @openagentsinc/pylon --no-launch
 npx @openagentsinc/pylon --no-updates
+npx @openagentsinc/pylon status --json
 npx @openagentsinc/pylon --download-curated-cache --model gemma-4-e2b --run-diagnostics
 npx @openagentsinc/pylon --verbose
 ```
@@ -27,8 +28,9 @@ The launcher:
 - checks GitHub for the latest tagged `pylon-v...` release on each default run,
   or resolves a specific tagged `Pylon` version when `--version` is provided
 - only installs releases initiated by `AtlantisPleb` in GitHub Releases
-- resolves the correct `pylon-v<version>-<os>-<arch>.tar.gz` asset for the
-  current machine
+- resolves the correct release asset for the current machine:
+  `pylon-v<version>-<os>-<arch>.tar.gz` on darwin/linux and
+  `pylon-v<version>-windows-x86_64.zip` on native Windows x86_64
 - falls back to the exact tagged source checkout and builds `pylon` plus
   `pylon-tui` locally when no matching release asset exists for the machine
 - prompts before installing the Rust toolchain via `rustup` if a source build
@@ -60,23 +62,31 @@ The launcher:
 - starts the installed `pylon-tui` by default after the smoke path; that TUI
   starts and supervises the earning worker
   unless `--no-launch` is set
+- forwards CLI subcommands such as `pylon status --json` to the installed
+  `pylon` binary after bootstrap instead of opening `pylon-tui`
+- on native Windows x86_64, installs `pylon.exe` and `pylon-tui.exe` from the
+  Windows `.zip` release asset and forwards CLI subcommands to `pylon.exe`
 - while the TUI is running on the default release track, checks GitHub Releases
-  every 30 seconds and restarts the TUI from a newer trusted cached release
+  on a six-hour cadence and restarts the TUI from a newer trusted cached release
   without replacing the global npm/bun command
 - use `--no-updates` to keep the current installed release running without
-  background GitHub release checks; `--version` remains a pinned release run
+  background GitHub release checks; `--version` remains a pinned release run.
+  Set `GITHUB_TOKEN` or `GH_TOKEN` when you want authenticated GitHub release
+  lookups.
 - owns the current auto-update contract. Directly extracted GitHub release
   assets do not contain a native updater today; if an operator runs
   `./pylon` from an unpacked archive, that process stays on its compiled
   version until the operator manually replaces the archive or switches back to
   the npm/bun launcher.
-- for hosted homework/training work, use launcher `0.1.16` or newer so the
+- for hosted homework/training work, use launcher `0.1.17` or newer so the
   cached standalone binary auto-updates while the dashboard is open. The
   `pylon-v0.1.16` standalone binary keeps the long hosted homework ID hashing
   from `0.1.14`, refuses to seal terminal training windows until the worker
   contribution artifact bundle has uploaded and verified for validator replay,
   and packages the minimal Psionic training runtime so standalone installs can
-  advertise homework-worker capability.
+  advertise homework-worker capability. Launcher `0.1.17` adds CLI subcommand
+  forwarding and bounds background GitHub release checks to avoid
+  unauthenticated rate-limit churn.
 - does not try to install or register a local runtime automatically; the
   bootstrap stays honest about the separate local Gemma runtime
   prerequisite instead of mutating the host behind the user's back

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@openagentsinc/pylon",
-  "version": "0.1.16",
+  "version": "0.2.2",
   "description": "Bootstrap the standalone OpenAgents Pylon release asset and run first-run smoke checks.",
   "type": "module",
   "bin": {
-    "pylon": "./bin/pylon"
+    "pylon": "bin/pylon"
   },
   "files": [
     "bin",
@@ -16,7 +16,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/OpenAgentsInc/openagents.git",
+    "url": "git+https://github.com/OpenAgentsInc/openagents.git",
     "directory": "packages/pylon-bootstrap"
   },
   "scripts": {

package/src/cli.js

@@ -6,11 +6,11 @@ import {
   DEFAULT_RELEASE_REPO,
   bootstrapInstalledPylon,
   ensureReleaseInstall,
-  launchInstalledPylon,
   launchInstalledPylonWithUpdates,
   resolveBootstrapOutcome,
   resolvePlatformTarget,
   renderBootstrapSummary,
+  runInstalledPylonCli,
 } from "./index.js";
 import {
   createTelemetryClient,
@@ -78,6 +78,8 @@ export function usage() {
   npx @openagentsinc/pylon [options]
   bunx @openagentsinc/pylon [options]
   pylon [options]
+  pylon [options] <pylon-command> [pylon-options]
+  pylon [options] -- <pylon-command> [pylon-options]
 
 Description:
   Download the latest tagged standalone Pylon release asset for this machine,
@@ -86,11 +88,15 @@ Description:
   and build it locally instead. Cache the binaries, run the first-run smoke
   path, and then start the Pylon terminal UI by default. The terminal UI manages
   the earning worker and keeps live status visible. The launcher checks GitHub
-  for newer tagged pylon-v... releases on each default run and every 30 seconds
+  for newer tagged pylon-v... releases on each default run and periodically
   while the dashboard is open. Only releases initiated by AtlantisPleb are
   accepted. New standalone binaries are cached under the local bootstrap root;
   the global npm or bun pylon command is not replaced.
 
+  When a Pylon command is provided, the launcher bootstraps the managed release
+  and forwards that command to the installed pylon binary instead of opening
+  pylon-tui. For example: pylon status --json.
+
 Options:
   --version <x.y.z>                    Resolve a specific Pylon release.
   --install-root <path>                Override the launcher cache/install root.
@@ -109,7 +115,7 @@ Options:
   --skip-model-download                Keep the curated GGUF cache skipped.
   --skip-diagnostics                   Keep optional pylon gemma diagnose skipped.
   --no-launch                          Do not start pylon-tui after bootstrap.
-  --no-updates                         Disable 30-second GitHub release polling
+  --no-updates                         Disable background GitHub release polling
                                        and dashboard restart while pylon runs.
   --verbose                            Print extra network and recovery detail.
   --debug-network                      Alias for --verbose.
@@ -140,10 +146,19 @@ export function parseArgs(argv) {
     verbose: false,
     json: false,
     help: false,
+    pylonArgs: [],
   };
 
   for (let index = 0; index < argv.length; index += 1) {
     const arg = argv[index];
+    if (arg === "--") {
+      options.pylonArgs = argv.slice(index + 1);
+      break;
+    }
+    if (!arg.startsWith("-")) {
+      options.pylonArgs = argv.slice(index);
+      break;
+    }
     switch (arg) {
       case "--version":
         options.version = argv[++index];
@@ -241,6 +256,7 @@ export async function main(argv = process.argv.slice(2), dependencies = {}) {
     ensureReleaseInstallImpl = ensureReleaseInstall,
     bootstrapInstalledPylonImpl = bootstrapInstalledPylon,
     launchInstalledPylonImpl = launchInstalledPylonWithUpdates,
+    runInstalledPylonCliImpl = runInstalledPylonCli,
     createTelemetryClientImpl = createTelemetryClient,
   } = dependencies;
   const options = parseArgs(argv);
@@ -320,7 +336,21 @@ export async function main(argv = process.argv.slice(2), dependencies = {}) {
         reporter?.warning(`Pylon ${outcome.verdict}`, outcome.detail);
       }
       console.log(renderBootstrapSummary(summary));
-      if (!options.noLaunch) {
+      if (options.pylonArgs.length > 0) {
+        await runInstalledPylonCliImpl(
+          {
+            ...options,
+            ...install,
+            version: install.version,
+          },
+          options.pylonArgs,
+          {
+            ...dependencies,
+            onStatus: reporter?.status,
+            telemetryClient,
+          },
+        );
+      } else if (!options.noLaunch) {
         await launchInstalledPylonImpl(
           {
             ...options,

package/src/index.js

@@ -20,7 +20,7 @@ export const DEFAULT_MODEL_ID = "gemma-4-e4b";
 export const DEFAULT_DIAGNOSTIC_REPEATS = 3;
 export const DEFAULT_DIAGNOSTIC_MAX_OUTPUT_TOKENS = 96;
 export const DEFAULT_FETCH_TIMEOUT_MS = 15_000;
-export const DEFAULT_UPDATE_CHECK_INTERVAL_MS = 30_000;
+export const DEFAULT_UPDATE_CHECK_INTERVAL_MS = 6 * 60 * 60 * 1000;
 export const DEFAULT_TRUSTED_RELEASE_AUTHOR = "AtlantisPleb";
 const PYLON_RELEASE_TAG_PREFIX = "pylon-v";
 const RELEASE_ASSET_INSTALL_METHOD = "release_asset";
@@ -30,6 +30,18 @@ const LEGACY_SOURCE_BUILD_SIBLING_REPOSITORIES = {
   "spark-sdk": "https://github.com/AtlantisPleb/spark-sdk.git",
 };
 
+function archiveExtensionForTarget(target) {
+  return target?.os === "windows" ? ".zip" : ".tar.gz";
+}
+
+function binaryExtensionForTarget(target) {
+  return target?.os === "windows" ? ".exe" : "";
+}
+
+function binaryNameForTarget(binaryName, target) {
+  return `${binaryName}${binaryExtensionForTarget(target)}`;
+}
+
 function emitStatus(onStatus, message, detail = null) {
   if (typeof onStatus === "function") {
     onStatus({ message, detail });
@@ -215,8 +227,9 @@ function requestHeaders() {
     accept: "application/vnd.github+json",
     "user-agent": "@openagentsinc/pylon bootstrap",
   };
-  if (process.env.GITHUB_TOKEN) {
-    headers.authorization = `Bearer ${process.env.GITHUB_TOKEN}`;
+  const githubToken = process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN;
+  if (githubToken) {
+    headers.authorization = `Bearer ${githubToken}`;
   }
   return headers;
 }
@@ -389,10 +402,11 @@ export function resolvePlatformTarget(
     {
       darwin: "darwin",
       linux: "linux",
+      win32: "windows",
     }[platform] ?? null;
   if (!osLabel) {
     throw new Error(
-      `Unsupported platform \`${platform}\`. The npm launcher only supports darwin and linux in v1.`,
+      `Unsupported platform \`${platform}\`. The npm launcher only supports darwin, linux, and native Windows in v1.`,
     );
   }
 
@@ -419,10 +433,12 @@ export function buildArchiveBasename(version, target) {
 
 export function buildAssetNames(version, target) {
   const archiveBasename = buildArchiveBasename(version, target);
+  const archiveExtension = archiveExtensionForTarget(target);
+  const archiveName = `${archiveBasename}${archiveExtension}`;
   return {
     archiveBasename,
-    archiveName: `${archiveBasename}.tar.gz`,
-    checksumName: `${archiveBasename}.tar.gz.sha256`,
+    archiveName,
+    checksumName: `${archiveName}.sha256`,
   };
 }
 
@@ -761,8 +777,8 @@ export function buildInstallPaths(installRoot, version, target) {
     archivePath: path.join(downloadsDir, archiveName),
     checksumPath: path.join(downloadsDir, checksumName),
     manifestPath: path.join(installDir, "install.json"),
-    pylonPath: path.join(installDir, "pylon"),
-    pylonTuiPath: path.join(installDir, "pylon-tui"),
+    pylonPath: path.join(installDir, binaryNameForTarget("pylon", target)),
+    pylonTuiPath: path.join(installDir, binaryNameForTarget("pylon-tui", target)),
   };
 }
 
@@ -1218,8 +1234,18 @@ async function installSourceBuild(
       stdio: "inherit",
     });
 
-    const builtPylonPath = path.join(repoDir, "target", "release", "pylon");
-    const builtPylonTuiPath = path.join(repoDir, "target", "release", "pylon-tui");
+    const builtPylonPath = path.join(
+      repoDir,
+      "target",
+      "release",
+      binaryNameForTarget("pylon", target),
+    );
+    const builtPylonTuiPath = path.join(
+      repoDir,
+      "target",
+      "release",
+      binaryNameForTarget("pylon-tui", target),
+    );
     if (!(await pathExists(builtPylonPath)) || !(await pathExists(builtPylonTuiPath))) {
       throw new Error(
         `Source build completed without the expected binaries at ${path.join(repoDir, "target", "release")}.`,
@@ -1314,8 +1340,11 @@ async function findLatestCachedInstall(installRoot, target) {
 
     const installDir = path.join(versionsDir, entry.name);
     const manifestPath = path.join(installDir, "install.json");
-    const pylonPath = path.join(installDir, "pylon");
-    const pylonTuiPath = path.join(installDir, "pylon-tui");
+    const pylonPath = path.join(installDir, binaryNameForTarget("pylon", target));
+    const pylonTuiPath = path.join(
+      installDir,
+      binaryNameForTarget("pylon-tui", target),
+    );
     if (
       !(await pathExists(manifestPath)) ||
       !(await pathExists(pylonPath)) ||
@@ -1446,8 +1475,34 @@ function spawnPylonTui(pylonTuiPath, options, spawnProcessImpl) {
   });
 }
 
-async function extractArchive(archivePath, destinationDir, runProcessImpl) {
+async function extractArchive(archivePath, destinationDir, target, runProcessImpl) {
   await fs.mkdir(destinationDir, { recursive: true });
+  if (target?.os === "windows") {
+    const args = [
+      "-NoProfile",
+      "-NonInteractive",
+      "-ExecutionPolicy",
+      "Bypass",
+      "-Command",
+      "& { param([string]$ArchivePath, [string]$DestinationPath) Expand-Archive -LiteralPath $ArchivePath -DestinationPath $DestinationPath -Force }",
+      archivePath,
+      destinationDir,
+    ];
+    for (const command of ["powershell.exe", "pwsh", "powershell"]) {
+      try {
+        await runProcessImpl(command, args);
+        return;
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (!message.startsWith(`Failed to start ${command}`)) {
+          throw error;
+        }
+      }
+    }
+    throw new Error(
+      "Windows archive extraction requires PowerShell (tried powershell.exe, pwsh, and powershell).",
+    );
+  }
   await runProcessImpl("tar", ["-xzf", archivePath, "-C", destinationDir]);
 }
 
@@ -1781,7 +1836,7 @@ export async function ensureReleaseInstall(
     paths.installDir,
   );
   await fs.rm(paths.installDir, { recursive: true, force: true });
-  await extractArchive(paths.archivePath, paths.versionsDir, runProcessImpl);
+  await extractArchive(paths.archivePath, paths.versionsDir, target, runProcessImpl);
 
   if (!(await pathExists(paths.pylonPath)) || !(await pathExists(paths.pylonTuiPath))) {
     throw new Error(
@@ -2016,6 +2071,26 @@ export async function launchInstalledPylon(
 
 export const launchInstalledPylonTui = launchInstalledPylon;
 
+export async function runInstalledPylonCli(
+  options,
+  args = [],
+  {
+    runProcessImpl = runProcess,
+    onStatus = null,
+  } = {},
+) {
+  const pylonPath = path.resolve(options.pylonPath);
+  emitStatus(
+    onStatus,
+    "Running Pylon CLI command",
+    [path.basename(pylonPath), ...args].join(" "),
+  );
+  return runProcessImpl(pylonPath, args, {
+    env: buildPylonEnv(options),
+    stdio: "inherit",
+  });
+}
+
 export async function launchInstalledPylonWithUpdates(
   options,
   {