@openagentsinc/pylon 0.1.3 → 0.1.5

package/README.md

@@ -3,7 +3,7 @@
 Bootstrap the latest tagged standalone `Pylon` release asset from GitHub
 Releases, fall back to a deterministic source build when no matching asset
 exists for the local platform, stream first-run status updates in the terminal,
-and open the Pylon terminal UI without Cargo when prebuilt binaries are
+and start the Pylon default earning loop without Cargo when prebuilt binaries are
 available.
 
 ## Usage
@@ -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.0.1-rc4
+npx @openagentsinc/pylon --version 0.0.1-rc10
 npx @openagentsinc/pylon --no-launch
 npx @openagentsinc/pylon --download-curated-cache --model gemma-4-e2b --diagnostic-repeats 2
 npx @openagentsinc/pylon --verbose
@@ -31,6 +31,9 @@ The launcher:
   `pylon-tui` locally when no matching release asset exists for the machine
 - 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
 - downloads the archive and published SHA-256 checksum
 - verifies the checksum before extracting
 - caches the unpacked binaries under `~/.openagents/pylon/bootstrap/`
@@ -48,11 +51,16 @@ The launcher:
   itself
 - falls back to `curl` for release metadata and asset downloads when the Node
   fetch path fails in constrained network contexts
-- opens `pylon-tui` by default after the smoke path unless `--no-launch` is set
+- starts the installed `pylon` earning loop by default after the smoke path
+  unless `--no-launch` is set
 - does not try to install or register a local runtime automatically; the
   bootstrap stays honest about the separate Ollama-compatible runtime
   prerequisite instead of mutating the host behind the user's back
 
+Set `OPENAGENTS_DISABLE_TELEMETRY=1` to disable installer telemetry, or
+`OPENAGENTS_TELEMETRY_URL=http://127.0.0.1:8000/api/telemetry/events` to point
+the launcher at a non-production telemetry endpoint.
+
 ## Publish
 
 Publish directly from this package directory:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openagentsinc/pylon",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Bootstrap the standalone OpenAgents Pylon release asset and run first-run smoke checks.",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -6,10 +6,17 @@ import {
   DEFAULT_RELEASE_REPO,
   bootstrapInstalledPylon,
   ensureReleaseInstall,
-  launchInstalledPylonTui,
+  launchInstalledPylon,
   resolveBootstrapOutcome,
+  resolvePlatformTarget,
   renderBootstrapSummary,
 } from "./index.js";
+import {
+  createTelemetryClient,
+  detectPackageInvoker,
+  installSourceForTelemetry,
+  telemetryFailureContext,
+} from "./telemetry.js";
 
 function parseIntegerFlag(value, label) {
   const parsed = Number.parseInt(value, 10);
@@ -76,7 +83,7 @@ Description:
   or a specific tagged Pylon version when --version is set. If no matching
   asset exists for the local platform, fetch the exact tagged source checkout
   and build it locally instead. Cache the binaries, run the first-run smoke
-  path, and then open the Pylon terminal UI by default with live status
+  path, and then start the Pylon default earning loop by default with live status
   updates. The launcher checks GitHub for newer tagged pylon-v... releases on
   each default run, but only caches the standalone binaries under the local
   bootstrap root; it does not replace your global npm or bun pylon command.
@@ -90,14 +97,14 @@ Options:
                                        prefetch into the local GGUF cache.
                                        Default: ${DEFAULT_MODEL_ID}
   --download-curated-cache             Prefetch the optional Hugging Face GGUF
-                                       cache before opening the TUI.
+                                       cache before launching pylon.
   --diagnostic-repeats <n>             Repeat count for pylon gemma diagnose.
                                        Default: ${DEFAULT_DIAGNOSTIC_REPEATS}
   --diagnostic-max-output-tokens <n>   Max output tokens for diagnostics.
                                        Default: ${DEFAULT_DIAGNOSTIC_MAX_OUTPUT_TOKENS}
   --skip-model-download                Keep the curated GGUF cache skipped.
   --skip-diagnostics                   Skip pylon gemma diagnose.
-  --no-launch                          Do not open pylon-tui after bootstrap.
+  --no-launch                          Do not start pylon after bootstrap.
   --verbose                            Print extra network and recovery detail.
   --debug-network                      Alias for --verbose.
   --json                               Emit a machine-readable JSON summary.
@@ -220,7 +227,8 @@ export async function main(argv = process.argv.slice(2), dependencies = {}) {
   const {
     ensureReleaseInstallImpl = ensureReleaseInstall,
     bootstrapInstalledPylonImpl = bootstrapInstalledPylon,
-    launchInstalledPylonTuiImpl = launchInstalledPylonTui,
+    launchInstalledPylonImpl = launchInstalledPylon,
+    createTelemetryClientImpl = createTelemetryClient,
   } = dependencies;
   const options = parseArgs(argv);
   if (options.help) {
@@ -229,51 +237,109 @@ export async function main(argv = process.argv.slice(2), dependencies = {}) {
   }
 
   const reporter = options.json ? null : createReporter();
+  const startedAt = Date.now();
+  const target = (() => {
+    try {
+      return resolvePlatformTarget(options.platform, options.arch);
+    } catch {
+      return {
+        os: process.platform,
+        arch: process.arch,
+      };
+    }
+  })();
+  const telemetryClient =
+    dependencies.telemetryClient ??
+    createTelemetryClientImpl({
+      fetchImpl: dependencies.fetchImpl ?? globalThis.fetch,
+    });
+  const sharedTelemetry = {
+    requested_version: options.version ?? "latest",
+    os: target.os,
+    arch: target.arch,
+    platform_key: `${target.os}-${target.arch}`,
+    npm_or_bun_invoker: detectPackageInvoker(),
+  };
 
-  const install = await ensureReleaseInstallImpl(options, {
-    ...dependencies,
-    onStatus: reporter?.status,
-  });
-  const summary = await bootstrapInstalledPylonImpl(
-    {
-      ...options,
-      ...install,
-      version: install.version,
-    },
-    {
+  telemetryClient?.emit?.("installer_started", sharedTelemetry);
+
+  let install = null;
+
+  try {
+    install = await ensureReleaseInstallImpl(options, {
       ...dependencies,
       onStatus: reporter?.status,
-    },
-  );
+      telemetryClient,
+    });
+    const summary = await bootstrapInstalledPylonImpl(
+      {
+        ...options,
+        ...install,
+        version: install.version,
+      },
+      {
+        ...dependencies,
+        onStatus: reporter?.status,
+        telemetryClient,
+      },
+    );
 
-  if (options.json) {
-    console.log(JSON.stringify(summary, null, 2));
-  } else {
-    const outcome = resolveBootstrapOutcome(summary);
-    if (outcome.level === "success") {
-      reporter?.success(`Pylon ${outcome.verdict}`, outcome.detail);
-    } else {
-      reporter?.warning(`Pylon ${outcome.verdict}`, outcome.detail);
-    }
-    console.log(renderBootstrapSummary(summary));
-    if (!options.noLaunch) {
-      await launchInstalledPylonTuiImpl(
-        {
-          ...options,
-          ...install,
-          version: install.version,
-        },
-        {
-          ...dependencies,
-          onStatus: reporter?.status,
-        },
-      );
+    telemetryClient?.emit?.("installer_finished", {
+      ...sharedTelemetry,
+      release_tag: summary.tagName,
+      release_commit: install.sourceCommit ?? null,
+      duration_ms: Date.now() - startedAt,
+      result: "success",
+      install_source: installSourceForTelemetry(
+        summary.installMethod ?? install.installMethod,
+        Boolean(summary.cached),
+      ),
+    });
+    await telemetryClient?.flush?.();
+
+    if (options.json) {
+      console.log(JSON.stringify(summary, null, 2));
     } else {
-      reporter?.warning(
-        "Skipped Pylon terminal UI launch",
-        "pass no flag to open pylon-tui by default",
-      );
+      const outcome = resolveBootstrapOutcome(summary);
+      if (outcome.level === "success") {
+        reporter?.success(`Pylon ${outcome.verdict}`, outcome.detail);
+      } else {
+        reporter?.warning(`Pylon ${outcome.verdict}`, outcome.detail);
+      }
+      console.log(renderBootstrapSummary(summary));
+      if (!options.noLaunch) {
+        await launchInstalledPylonImpl(
+          {
+            ...options,
+            ...install,
+            version: install.version,
+          },
+          {
+            ...dependencies,
+            onStatus: reporter?.status,
+          },
+        );
+      } else {
+        reporter?.warning(
+          "Skipped Pylon launch",
+          "pass no flag to start the default earning loop",
+        );
+      }
     }
+    return summary;
+  } catch (error) {
+    telemetryClient?.emit?.("installer_finished", {
+      ...sharedTelemetry,
+      release_tag: install?.tagName ?? null,
+      release_commit: install?.sourceCommit ?? null,
+      duration_ms: Date.now() - startedAt,
+      result: "failed",
+      install_source: install
+        ? installSourceForTelemetry(install.installMethod, Boolean(install.cached))
+        : null,
+      ...telemetryFailureContext(error, "launcher"),
+    });
+    await telemetryClient?.flush?.();
+    throw error;
   }
-  return summary;
 }