@openagentsinc/pylon 0.1.14 → 0.1.16

package/README.md

@@ -13,7 +13,7 @@ npx @openagentsinc/pylon
 bunx @openagentsinc/pylon
 npm install -g @openagentsinc/pylon && pylon
 bun install -g @openagentsinc/pylon && pylon
-npx @openagentsinc/pylon --version 0.1.13
+npx @openagentsinc/pylon --version 0.1.16
 npx @openagentsinc/pylon --no-launch
 npx @openagentsinc/pylon --no-updates
 npx @openagentsinc/pylon --download-curated-cache --model gemma-4-e2b --run-diagnostics
@@ -34,8 +34,9 @@ The launcher:
 - prompts before installing the Rust toolchain via `rustup` if a source build
   is needed and `cargo` / `rustc` are missing
 - emits best-effort anonymous installer telemetry to `openagents.com` so the
-  public stats page can show install starts, completions, source-build fallbacks,
-  Rust prompts, and smoke-test outcomes
+  public stats page can show install starts, completions, source-build
+  fallbacks, update checks, restart behavior, Rust prompts, and smoke-test
+  outcomes
 - downloads the archive and published SHA-256 checksum
 - verifies the checksum before extracting
 - caches the unpacked binaries under `~/.openagents/pylon/bootstrap/`
@@ -64,12 +65,18 @@ The launcher:
   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
-- for hosted homework/training work, use launcher `0.1.14` or newer so the
-  cached standalone binary auto-updates while the dashboard is open. The latest
-  trusted standalone binary still carries the `0.1.13` and `0.1.12` runtime
-  fixes: no legacy runtime wording, explicit runtime management, current
-  `target/release/psionic-train` preference, and `cargo run --release`
-  fallback instead of debug `cargo run`
+- 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
+  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.
 - 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,6 +1,6 @@
 {
   "name": "@openagentsinc/pylon",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Bootstrap the standalone OpenAgents Pylon release asset and run first-run smoke checks.",
   "type": "module",
   "bin": {

package/src/index.js

@@ -2023,10 +2023,41 @@ export async function launchInstalledPylonWithUpdates(
     spawnProcessImpl = spawn,
     updateCheckIntervalMs = DEFAULT_UPDATE_CHECK_INTERVAL_MS,
     onStatus = null,
+    telemetryClient = null,
     ...dependencies
   } = {},
 ) {
+  const currentReleaseTag =
+    options.tagName ?? `pylon-v${normalizeVersion(options.version)}`;
+  const updateTelemetryBase = {
+    current_release_tag: currentReleaseTag,
+    current_version: normalizeVersion(options.version),
+    os: options.target?.os ?? null,
+    arch: options.target?.arch ?? null,
+    platform_key:
+      options.target?.os && options.target?.arch
+        ? `${options.target.os}-${options.target.arch}`
+        : null,
+    install_source: installSourceForTelemetry(
+      options.installMethod,
+      Boolean(options.cached),
+    ),
+    update_check_interval_ms: updateCheckIntervalMs,
+  };
+
   if (options.noUpdates || options.pinnedVersion) {
+    emitTelemetry(
+      telemetryClient,
+      options.noUpdates
+        ? "installer_update_disabled"
+        : "installer_update_pinned_run",
+      {
+        ...updateTelemetryBase,
+        update_mode: options.noUpdates ? "no_updates" : "pinned_version",
+        update_reason: options.noUpdates ? "--no-updates" : "--version",
+      },
+    );
+    await telemetryClient?.flush?.();
     return launchInstalledPylon(options, { ...dependencies, onStatus });
   }
 
@@ -2035,6 +2066,7 @@ export async function launchInstalledPylonWithUpdates(
     version: normalizeVersion(options.version),
   };
   let lastUpdateError = null;
+  let pendingRestartTelemetry = null;
 
   while (true) {
     const pylonTuiPath = path.resolve(current.pylonTuiPath);
@@ -2043,6 +2075,14 @@ export async function launchInstalledPylonWithUpdates(
       "Starting Pylon terminal UI",
       `${path.basename(pylonTuiPath)} manages the earning worker`,
     );
+    if (pendingRestartTelemetry) {
+      emitTelemetry(telemetryClient, "installer_update_restart_succeeded", {
+        ...pendingRestartTelemetry,
+        restarted_release_tag: current.tagName,
+        restarted_version: current.version,
+      });
+      pendingRestartTelemetry = null;
+    }
     const child = spawnPylonTui(pylonTuiPath, current, spawnProcessImpl);
     const childExit = waitForChildExit(child);
     let restartForUpdate = false;
@@ -2065,6 +2105,12 @@ export async function launchInstalledPylonWithUpdates(
         );
       }
 
+      emitTelemetry(telemetryClient, "installer_update_check_started", {
+        ...updateTelemetryBase,
+        observed_release_tag: current.tagName,
+        observed_version: current.version,
+      });
+
       try {
         const install = await ensureReleaseInstallImpl(
           {
@@ -2080,12 +2126,70 @@ export async function launchInstalledPylonWithUpdates(
         if (!isNewerPylonVersion(install.version, current.version)) {
           continue;
         }
+        emitTelemetry(telemetryClient, "installer_update_available", {
+          ...updateTelemetryBase,
+          observed_release_tag: current.tagName,
+          observed_version: current.version,
+          available_release_tag: install.tagName,
+          available_version: install.version,
+          available_install_source: installSourceForTelemetry(
+            install.installMethod,
+            Boolean(install.cached),
+          ),
+        });
+        if (
+          install.installMethod === RELEASE_ASSET_INSTALL_METHOD &&
+          !install.cached
+        ) {
+          emitTelemetry(telemetryClient, "installer_update_downloaded", {
+            ...updateTelemetryBase,
+            observed_release_tag: current.tagName,
+            observed_version: current.version,
+            available_release_tag: install.tagName,
+            available_version: install.version,
+          });
+          emitTelemetry(telemetryClient, "installer_update_verified", {
+            ...updateTelemetryBase,
+            observed_release_tag: current.tagName,
+            observed_version: current.version,
+            available_release_tag: install.tagName,
+            available_version: install.version,
+          });
+        }
+        emitTelemetry(telemetryClient, "installer_update_applied", {
+          ...updateTelemetryBase,
+          previous_release_tag: current.tagName,
+          previous_version: current.version,
+          applied_release_tag: install.tagName,
+          applied_version: install.version,
+          applied_install_source: installSourceForTelemetry(
+            install.installMethod,
+            Boolean(install.cached),
+          ),
+        });
         emitStatus(
           onStatus,
           "Installed newer Pylon release",
           `${install.tagName}; restarting dashboard`,
         );
+        emitTelemetry(telemetryClient, "installer_update_restart_attempted", {
+          ...updateTelemetryBase,
+          previous_release_tag: current.tagName,
+          previous_version: current.version,
+          restart_target_release_tag: install.tagName,
+          restart_target_version: install.version,
+        });
         await stopChild(child);
+        pendingRestartTelemetry = {
+          previous_release_tag: current.tagName,
+          previous_version: current.version,
+          applied_release_tag: install.tagName,
+          applied_version: install.version,
+          applied_install_source: installSourceForTelemetry(
+            install.installMethod,
+            Boolean(install.cached),
+          ),
+        };
         current = {
           ...options,
           ...install,
@@ -2094,6 +2198,12 @@ export async function launchInstalledPylonWithUpdates(
         restartForUpdate = true;
       } catch (error) {
         const message = error instanceof Error ? error.message : String(error);
+        emitTelemetry(telemetryClient, "installer_update_failed", {
+          ...updateTelemetryBase,
+          observed_release_tag: current.tagName,
+          observed_version: current.version,
+          ...telemetryFailureContext(error, "update_check"),
+        });
         if (message !== lastUpdateError) {
           emitStatus(onStatus, "Pylon update check failed", message);
           lastUpdateError = message;