@openagentsinc/pylon 0.1.10 → 0.1.11

package/README.md

@@ -3,8 +3,8 @@
 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 start the Pylon default earning loop without Cargo when prebuilt binaries are
-available.
+and start the Pylon terminal UI without Cargo when prebuilt binaries are
+available. The terminal UI manages the long-lived earning worker.
 
 ## Usage
 
@@ -13,9 +13,9 @@ npx @openagentsinc/pylon
 bunx @openagentsinc/pylon
 npm install -g @openagentsinc/pylon && pylon
 bun install -g @openagentsinc/pylon && pylon
-npx @openagentsinc/pylon --version 0.1.10
+npx @openagentsinc/pylon --version 0.1.11
 npx @openagentsinc/pylon --no-launch
-npx @openagentsinc/pylon --download-curated-cache --model gemma-4-e2b --diagnostic-repeats 2
+npx @openagentsinc/pylon --download-curated-cache --model gemma-4-e2b --run-diagnostics
 npx @openagentsinc/pylon --verbose
 ```
 
@@ -45,13 +45,17 @@ The launcher:
 - ends first run with an explicit verdict such as `fully online`, `runtime
   ready`, or `installed but runtime missing`, plus exact next-step guidance
 - runs `pylon --help`, `init`, `status --json`, and `inventory --json`
-- runs `pylon gemma diagnose <model> --json`
+- skips Gemma diagnostics by default because hosted homework training does not
+  require local Gemma weights
+- only runs `pylon gemma diagnose <model> --json` when `--run-diagnostics` is
+  set
 - only runs `pylon gemma download <model>` when `--download-curated-cache` is
   set, because the optional GGUF cache does not satisfy the sellable runtime by
   itself
 - falls back to `curl` for release metadata and asset downloads when the Node
   fetch path fails in constrained network contexts
-- starts the installed `pylon` earning loop by default after the smoke path
+- starts the installed `pylon-tui` by default after the smoke path; that TUI
+  starts and supervises the earning worker
   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

package/package.json

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

package/src/cli.js

@@ -83,8 +83,9 @@ 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 start the Pylon default earning loop by default with live status
-  updates. The launcher checks GitHub for newer tagged pylon-v... releases on
+  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, but only caches the standalone binaries under the local
   bootstrap root; it does not replace your global npm or bun pylon command.
 
@@ -98,13 +99,14 @@ Options:
                                        Default: ${DEFAULT_MODEL_ID}
   --download-curated-cache             Prefetch the optional Hugging Face GGUF
                                        cache before launching pylon.
-  --diagnostic-repeats <n>             Repeat count for pylon gemma diagnose.
+  --run-diagnostics                    Run optional pylon gemma diagnose.
+  --diagnostic-repeats <n>             Repeat count when diagnostics are enabled.
                                        Default: ${DEFAULT_DIAGNOSTIC_REPEATS}
-  --diagnostic-max-output-tokens <n>   Max output tokens for diagnostics.
+  --diagnostic-max-output-tokens <n>   Max output tokens when diagnostics are enabled.
                                        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 start pylon after bootstrap.
+  --skip-diagnostics                   Keep optional pylon gemma diagnose skipped.
+  --no-launch                          Do not start pylon-tui after bootstrap.
   --verbose                            Print extra network and recovery detail.
   --debug-network                      Alias for --verbose.
   --json                               Emit a machine-readable JSON summary.
@@ -128,7 +130,7 @@ export function parseArgs(argv) {
     diagnosticRepeats: DEFAULT_DIAGNOSTIC_REPEATS,
     diagnosticMaxOutputTokens: DEFAULT_DIAGNOSTIC_MAX_OUTPUT_TOKENS,
     skipModelDownload: true,
-    skipDiagnostics: false,
+    skipDiagnostics: true,
     noLaunch: false,
     verbose: false,
     json: false,
@@ -171,6 +173,9 @@ export function parseArgs(argv) {
       case "--download-curated-cache":
         options.skipModelDownload = false;
         break;
+      case "--run-diagnostics":
+        options.skipDiagnostics = false;
+        break;
       case "--diagnostic-repeats":
         options.diagnosticRepeats = parseIntegerFlag(
           argv[++index],
@@ -321,8 +326,8 @@ export async function main(argv = process.argv.slice(2), dependencies = {}) {
         );
       } else {
         reporter?.warning(
-          "Skipped Pylon launch",
-          "pass no flag to start the default earning loop",
+          "Skipped Pylon terminal UI launch",
+          "pass no flag to open pylon-tui and start the earning worker",
         );
       }
     }

package/src/index.js

@@ -1757,6 +1757,8 @@ export async function bootstrapInstalledPylon(
     options.diagnosticRepeats ?? DEFAULT_DIAGNOSTIC_REPEATS;
   const diagnosticMaxOutputTokens =
     options.diagnosticMaxOutputTokens ?? DEFAULT_DIAGNOSTIC_MAX_OUTPUT_TOKENS;
+  const skipModelDownload = options.skipModelDownload ?? true;
+  const skipDiagnostics = options.skipDiagnostics ?? true;
   emitTelemetry(telemetryClient, "installer_smoke_test_started", {
     release_tag: options.tagName ?? `pylon-v${options.version}`,
     release_commit: options.sourceCommit ?? null,
@@ -1793,7 +1795,7 @@ export async function bootstrapInstalledPylon(
     );
 
     let download = null;
-    if (!options.skipModelDownload) {
+    if (!skipModelDownload) {
       emitStatus(onStatus, "Downloading curated model bundle", model);
       download = await runPylonJson(
         pylonPath,
@@ -1810,7 +1812,7 @@ export async function bootstrapInstalledPylon(
     }
 
     let diagnostic = null;
-    if (!options.skipDiagnostics) {
+    if (!skipDiagnostics) {
       emitStatus(onStatus, "Running first-run diagnostic", model);
       try {
         diagnostic = await runPylonJson(
@@ -1839,7 +1841,11 @@ export async function bootstrapInstalledPylon(
         );
       }
     } else {
-      emitStatus(onStatus, "Skipping first-run diagnostic", model);
+      emitStatus(
+        onStatus,
+        "Skipping optional Gemma diagnostic",
+        "use --run-diagnostics when validating local inference separately",
+      );
     }
 
     const diagnosticResult =
@@ -1917,9 +1923,13 @@ export async function launchInstalledPylon(
     onStatus = null,
   } = {},
 ) {
-  const pylonPath = path.resolve(options.pylonPath);
-  emitStatus(onStatus, "Starting Pylon default earning loop", path.basename(pylonPath));
-  return runProcessImpl(pylonPath, [], {
+  const pylonTuiPath = path.resolve(options.pylonTuiPath);
+  emitStatus(
+    onStatus,
+    "Starting Pylon terminal UI",
+    `${path.basename(pylonTuiPath)} manages the earning worker`,
+  );
+  return runProcessImpl(pylonTuiPath, [], {
     env: buildPylonEnv(options),
     stdio: "inherit",
   });
@@ -1989,7 +1999,7 @@ function renderBootstrapNextSteps(summary, outcome) {
   ];
 
   if (outcome.verdict === "fully online" || outcome.verdict === "runtime ready") {
-    lines.push("Next step: run `pylon`; it starts the default online earning loop.");
+    lines.push("Next step: run `pylon`; it opens the TUI and starts the earning worker.");
     return lines;
   }