npm - @remodex/rmx - Versions diffs - 1.0.2 → 1.0.4 - Mend

@remodex/rmx 1.0.2 → 1.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (27) hide show

package/README.md +32 -10
package/bin/ocx.mjs +73 -14
package/gui/dist/assets/index-1SDbgh2-.css +1 -0
package/gui/dist/assets/{index-CkETtt7P.js → index-D3MaPif3.js} +13 -13
package/gui/dist/index.html +2 -2
package/package.json +5 -5
package/src/android-remote/cloudflare-tunnel.ts +30 -8
package/src/cli/help.ts +28 -6
package/src/cli/index.ts +47 -74
package/src/cli/init.ts +7 -1
package/src/cli/internal-dispatch.ts +0 -6
package/src/cli/onboard.ts +599 -0
package/src/cli/system-command.ts +37 -84
package/src/codex/inject.ts +8 -1
package/src/codex/sync.ts +3 -0
package/src/lib/config-ownership.ts +5 -0
package/src/lib/remodex-home.ts +5 -0
package/src/server/management/android-remote-routes.ts +1 -1
package/src/server/management/config-routes.ts +0 -80
package/src/server/management/context.ts +0 -4
package/src/tray/windows-tray.ps1 +109 -66
package/src/tray/windows.ts +7 -1
package/src/update/auto-scheduler.ts +1671 -0
package/src/update/job.ts +72 -13
package/src/update/notify.ts +2 -2
package/gui/dist/assets/index-CZqebSPQ.css +0 -1
package/src/update/desktop-release.ts +0 -1620

package/gui/dist/index.html CHANGED Viewed

@@ -16,8 +16,8 @@
         } catch (e) {}
       })();
     </script>
-    <script type="module" crossorigin src="/assets/index-CkETtt7P.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-CZqebSPQ.css">
+    <script type="module" crossorigin src="/assets/index-D3MaPif3.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-1SDbgh2-.css">
   </head>
   <body>
     <div id="root"></div>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@remodex/rmx",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Remodex universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code",
   "displayName": "Remodex",
   "type": "module",
@@ -13,10 +13,10 @@
     "./package.json": "./package.json"
   },
   "bin": {
-    "rmx": "./bin/ocx.mjs",
-    "remodex": "./bin/ocx.mjs",
-    "opencodex": "./bin/ocx.mjs",
-    "ocx": "./bin/ocx.mjs"
+    "rmx": "bin/ocx.mjs",
+    "remodex": "bin/ocx.mjs",
+    "opencodex": "bin/ocx.mjs",
+    "ocx": "bin/ocx.mjs"
   },
   "files": [
     "bin",

package/src/android-remote/cloudflare-tunnel.ts CHANGED Viewed

@@ -8,7 +8,23 @@ import { resolveCloudflared, type CloudflaredExecutable } from "./cloudflared";
 const QUICK_TUNNEL_URL = /https:\/\/[a-z0-9-]+\.trycloudflare\.com/iu;
 const QUICK_URL_TIMEOUT_MS = 30_000;
 const VERIFY_TIMEOUT_MS = 5_000;
-const RETRY_DELAYS_MS = [1_000, 2_500, 5_000, 10_000, 30_000] as const;
+const PROCESS_RETRY_DELAYS_MS = [1_000, 2_500, 5_000, 10_000, 30_000] as const;
+// A freshly-created Quick Tunnel URL and a newly-written Named Tunnel DNS route
+// can be visible in cloudflared output before Cloudflare's edge can serve it.
+// Keep that expected propagation neutral in the UI for almost two minutes. If
+// it still is not reachable, expose the failure but continue probing the same
+// child and URL so late propagation can recover without generating a new URL.
+const VERIFY_PROPAGATION_DELAYS_MS = [
+  1_000,
+  2_000,
+  3_000,
+  5_000,
+  8_000,
+  13_000,
+  20_000,
+  30_000,
+  30_000,
+] as const;
 export type AndroidRemoteCloudflareFailure =
   | "cloudflared_unavailable"
@@ -175,8 +191,8 @@ async function verifiedPublicGateway(
   try {
     const signal = AbortSignal.timeout(VERIFY_TIMEOUT_MS);
     const [healthResponse, descriptorResponse] = await Promise.all([
-      fetchImpl(new URL("/healthz", baseUrl), { signal }),
-      fetchImpl(new URL("/.well-known/t3/environment", baseUrl), { signal }),
+      fetchImpl(new URL("/healthz", baseUrl), { signal, cache: "no-store" }),
+      fetchImpl(new URL("/.well-known/t3/environment", baseUrl), { signal, cache: "no-store" }),
     ]);
     if (!healthResponse.ok || !descriptorResponse.ok) return false;
     const health = await healthResponse.json() as Record<string, unknown>;
@@ -218,7 +234,9 @@ export class ManagedAndroidRemoteCloudflareTunnel implements AndroidRemoteCloudf
     }
     return {
       mode: settings.tunnelMode,
-      ...(settings.namedTunnelHostname ? { namedHostname: settings.namedTunnelHostname } : {}),
+      ...(settings.tunnelMode === "named" && settings.namedTunnelHostname
+        ? { namedHostname: settings.namedTunnelHostname }
+        : {}),
       hasNamedTunnelToken: this.hasNamedTunnelToken,
     };
   }
@@ -322,7 +340,7 @@ export class ManagedAndroidRemoteCloudflareTunnel implements AndroidRemoteCloudf
         publicUrl: null,
         error: result,
       });
-      const delay = RETRY_DELAYS_MS[Math.min(attempt, RETRY_DELAYS_MS.length - 1)]!;
+      const delay = PROCESS_RETRY_DELAYS_MS[Math.min(attempt, PROCESS_RETRY_DELAYS_MS.length - 1)]!;
       attempt += 1;
       await this.deps.sleep(delay);
     }
@@ -444,7 +462,7 @@ export class ManagedAndroidRemoteCloudflareTunnel implements AndroidRemoteCloudf
         return "tunnel_failed";
       }
       verificationFailures += 1;
-      if (verificationFailures >= 5) {
+      if (verificationFailures > VERIFY_PROPAGATION_DELAYS_MS.length) {
         this.publish({
           mode,
           status: "error",
@@ -452,7 +470,9 @@ export class ManagedAndroidRemoteCloudflareTunnel implements AndroidRemoteCloudf
           error: "verification_failed",
         });
       }
-      const delay = RETRY_DELAYS_MS[Math.min(verificationFailures - 1, RETRY_DELAYS_MS.length - 1)]!;
+      const delay = VERIFY_PROPAGATION_DELAYS_MS[
+        Math.min(verificationFailures - 1, VERIFY_PROPAGATION_DELAYS_MS.length - 1)
+      ]!;
       const wait = await Promise.race([
         this.deps.sleep(delay).then(() => "retry" as const),
         child.exited.then(() => "exit" as const),
@@ -473,7 +493,9 @@ export class DisabledAndroidRemoteCloudflareTunnel implements AndroidRemoteCloud
   async configuration(settings: AndroidRemoteSettings): Promise<AndroidRemoteCloudflareConfiguration> {
     return {
       mode: settings.tunnelMode,
-      ...(settings.namedTunnelHostname ? { namedHostname: settings.namedTunnelHostname } : {}),
+      ...(settings.tunnelMode === "named" && settings.namedTunnelHostname
+        ? { namedHostname: settings.namedTunnelHostname }
+        : {}),
       hasNamedTunnelToken: false,
     };
   }

package/src/cli/help.ts CHANGED Viewed

@@ -20,6 +20,15 @@ function canonicalCommand(value: string): string {
 }
 const helpEntries: Record<string, HelpEntry> = {
+  onboard: {
+    usage: "rmx onboard [--verbose] [--json] [--no-open]",
+    summary: "Configure Codex, Android Remote, the background service, and a verified phone link.",
+    details: [
+      "Safe to rerun: existing providers and custom-domain tunnels are preserved.",
+      "Fresh users get Quick Tunnel; Windows also installs the status tray.",
+      "--verbose shows inner command diagnostics; --json implies --no-open.",
+    ],
+  },
   init: { usage: "rmx init", summary: "Interactive setup for providers and Codex config injection." },
   setup: { usage: "rmx setup", summary: "Interactive setup for providers and Codex config injection (alias of init)." },
   start: { usage: "rmx start [--port <port>]", summary: "Start the proxy server and sync models to Codex." },
@@ -104,10 +113,17 @@ const helpEntries: Record<string, HelpEntry> = {
   },
   login: { usage: "rmx login <provider>", summary: "OAuth or API-key login for a provider." },
   logout: { usage: "rmx logout <provider>", summary: "Remove a stored provider login." },
-  gui: { usage: "rmx gui", summary: "Open the Remodex dashboard." },
+  gui: {
+    usage: "rmx gui [--update]",
+    summary: "Open the Remodex dashboard; --update opens the npm package updater.",
+  },
   update: {
     usage: "rmx update [--tag latest|preview]",
     summary: "Update Remodex. Preview installs stay on the preview tag unless overridden.",
+    details: [
+      "Automatic updates are enabled by default for global installs.",
+      "Use `rmx system update auto off` to disable them, or `rmx system update auto status` to inspect the scheduler.",
+    ],
   },
   provider: {
     usage: "rmx provider <list|add|edit|test|remove|show|set-default|selected|quota|presets|account-mode>",
@@ -194,13 +210,15 @@ const helpEntries: Record<string, HelpEntry> = {
   grok: { usage: "rmx grok <status|exclude|include|set|clear|apply> ...", summary: "Manage and apply the Grok Build model fence." },
   integration: { usage: "rmx integration <claude|grok|client> ...", summary: "Manage supported client integrations." },
   system: {
-    usage: "rmx system <status|settings|startup|diagnostics|sync|update|desktop-update> ...",
+    usage: "rmx system <status|settings|startup|diagnostics|sync|update> ...",
     summary: "Manage headless runtime settings, startup, sync, diagnostics, and updates.",
     details: [
-      "desktop-update check [--channel latest|preview]  Check the native desktop release manifest.",
-      "desktop-update run [--channel latest|preview]    Download and verify a native desktop update.",
-      "desktop-update status                            Show shared tray/dashboard update state.",
-      "Headless commands never install a native package; installation requires the desktop shell.",
+      "update check [--channel latest|preview]  Check the @remodex/rmx package on npm.",
+      "update run [--channel latest|preview] --yes  Install the npm package update.",
+      "update auto on [--channel latest|preview]  Enable the daily unattended package updater (enabled by default for global installs).",
+      "update auto off                         Disable unattended package updates.",
+      "update auto status                      Show scheduler, last result, and rollback information.",
+      "Changelogs come from the matching GitHub Release (v<version>).",
     ],
   },
   config: {
@@ -295,6 +313,8 @@ export function printUsage(): void {
   const canonical = `Remodex (rmx) — Universal provider proxy for Codex
 Usage:
+  rmx                         Install/update and start the background service
+  rmx onboard                 Complete first-time setup and open the phone pairing QR
   rmx setup                   Interactive setup (alias: init)
   rmx start [--port <port>]   Start the proxy server (auto-syncs models to Codex)
   rmx stop                    Stop the proxy AND restore native Codex (plain codex works again)
@@ -340,6 +360,8 @@ Usage:
   rmx --version | -v          Print version
 Examples:
+  rmx                        Install/update and start the background service
+  rmx onboard                Set up Codex, the service, and Android Remote
   rmx init                    Set up provider and inject into Codex
   rmx start                   Start on default port (10100)
   rmx start --port 8080       Start on custom port

package/src/cli/index.ts CHANGED Viewed

@@ -59,15 +59,6 @@ import { maybeShowUpdatePrompt } from "../update/notify";
 import { syncModelsToCodex } from "../codex/sync";
 import { setIntegrationEnabled, shouldSyncCodexOnStart, shouldSyncGrokOnStart, syncCodexOnStartIfEnabled } from "../codex/desired-state";
 import { normalizeUpdateChannel, runGuiUpdateWorker } from "../update/job";
-import { currentVersion } from "../update/index";
-import {
-  desktopUpdateInstallAction,
-  readDesktopUpdateState,
-  runAutomaticDesktopUpdateCheck,
-  runDesktopUpdateWorker,
-  startDesktopUpdateJob,
-  type DesktopReleaseChannel,
-} from "../update/desktop-release";
 import { collectOrcaCodexHomeDiagnostic } from "../codex/home";
 import { removeOwnedConfigState } from "../lib/config-ownership";
 import { withProcessRuntimeProvenance } from "../lib/bun-runtime";
@@ -460,6 +451,10 @@ async function handleStart(options: { block?: boolean } = {}) {
     // to explain it. Name the failure and the one command that repairs it.
     console.error(`⚠️  ${grokSyncFailureMessage(err)}`);
   }
+  try {
+    const { ensureDefaultAutoUpdateScheduler } = await import("../update/auto-scheduler");
+    ensureDefaultAutoUpdateScheduler();
+  } catch { /* default updater provisioning must never block proxy startup */ }
   if (options.block ?? true) {
     setInterval(() => {}, 60_000);
     await new Promise<void>(() => {});
@@ -477,6 +472,12 @@ function detachedStartEnvironment(): NodeJS.ProcessEnv {
 async function handleEnsure(options: { existingIsSuccess?: boolean } = {}): Promise<boolean> {
   if (!currentExternalCodexModelProvider()) reconcileJournal();
   const config = loadConfig();
+  // Provision the daily updater for global installs during the first normal
+  // bootstrap. The helper skips service children and the updater worker itself.
+  try {
+    const { ensureDefaultAutoUpdateScheduler } = await import("../update/auto-scheduler");
+    ensureDefaultAutoUpdateScheduler();
+  } catch { /* automatic updates must never block proxy startup */ }
   if (!codexAutoStartEnabled(config)) {
     console.log("Codex autostart is disabled.");
     return false;
@@ -653,56 +654,6 @@ async function handleTrayProxyRestart(): Promise<void> {
   await handleProxyRestart(() => handleTrayProxyStart(false));
 }
-/**
- * Fixed desktop-shell action used by the tray.  A first click checks and
- * downloads a verified artifact; once the tray shows "ready", the next click
- * hands it to the platform installer.  No caller-selected command or path is
- * accepted here.
- */
-async function handleDesktopUpdateRequest(requestArgs: string[] = []): Promise<void> {
-  let expectedReady: { id: string; channel: DesktopReleaseChannel } | undefined;
-  if (requestArgs.length > 0) {
-    const [mode, id, channel] = requestArgs;
-    if (
-      requestArgs.length !== 3
-      || mode !== "--install-ready"
-      || !id
-      || !/^desktop-\d+-[a-z0-9]{1,32}$/.test(id)
-      || (channel !== "latest" && channel !== "preview")
-    ) {
-      console.error("Invalid desktop update request.");
-      process.exitCode = 64;
-      return;
-    }
-    expectedReady = { id, channel };
-  }
-  const previous = readDesktopUpdateState();
-  const install = expectedReady !== undefined || desktopUpdateInstallAction(previous);
-  const channel: DesktopReleaseChannel = expectedReady?.channel
-    ?? previous?.channel
-    ?? (currentVersion().includes("-") ? "preview" : "latest");
-  try {
-    const job = startDesktopUpdateJob(channel, {
-      install,
-      ...(expectedReady ? { expectedReady } : {}),
-    });
-    console.log(
-      install
-        ? `Desktop update installation started (${job.latestVersion ?? "latest"}).`
-        : "Desktop update check started.",
-    );
-  } catch (error) {
-    console.error(error instanceof Error ? error.message : "Desktop update could not start.");
-    process.exitCode = 1;
-  }
-}
-async function handleAutomaticDesktopUpdateCheck(): Promise<void> {
-  const channel: DesktopReleaseChannel = currentVersion().includes("-") ? "preview" : "latest";
-  const result = await runAutomaticDesktopUpdateCheck(channel);
-  console.log(JSON.stringify(result));
-}
 async function handleRestartStartWhenStopped(): Promise<boolean | "skipped"> {
   if (!codexAutoStartEnabled(loadConfig())) {
     console.log("Codex autostart is disabled; no proxy was started.");
@@ -872,6 +823,17 @@ async function handleUninstall() {
     }
   };
+  await runStep("automatic updater removed", async () => {
+    const {
+      disableAutoUpdates,
+      readAutoUpdateStatus,
+    } = await import("../update/auto-scheduler");
+    const status = readAutoUpdateStatus();
+    if (status.scheduler === "absent" && !status.state) return false;
+    disableAutoUpdates();
+    return true;
+  });
   await runStep("service stopped", () => stopServiceIfInstalled());
   await runStep("proxy stopped", async () => {
@@ -1059,6 +1021,11 @@ async function handleReady(args: ReadyArgs): Promise<never> {
 }
 switch (command) {
+  case "onboard": {
+    const { runOnboardCommand } = await import("./onboard");
+    process.exitCode = await runOnboardCommand(args.slice(1));
+    break;
+  }
   case "init":
   case "setup": {
     const { runInit } = await import("./init");
@@ -1251,6 +1218,13 @@ switch (command) {
     break;
   }
   case "gui": {
+    const guiArgs = args.slice(1);
+    const openUpdate = guiArgs.length === 1 && guiArgs[0] === "--update";
+    if (guiArgs.length > (openUpdate ? 1 : 0)) {
+      console.error("Usage: rmx gui [--update]");
+      process.exitCode = 64;
+      break;
+    }
     const cfg = await import("../config");
     const config = cfg.loadConfig();
     // Identity-checked liveness (not the pid file + a fixed sleep): finds a fallback-port
@@ -1274,15 +1248,23 @@ switch (command) {
     // Open the host the proxy actually binds — `localhost` only answers for
     // loopback/wildcard binds, not a concrete LAN/IPv6 hostname.
     const guiHost = probeHostname(live?.hostname ?? config.hostname);
-    const guiUrl = `http://${guiHost === "127.0.0.1" ? "localhost" : guiHost}:${live?.port ?? config.port}`;
+    const guiUrl = `http://${guiHost === "127.0.0.1" ? "localhost" : guiHost}:${live?.port ?? config.port}${openUpdate ? "/#dashboard/update" : ""}`;
     console.log(`Opening ${guiUrl}`);
     const { openUrl } = await import("../lib/open-url");
     openUrl(guiUrl);
     break;
   }
-  case "service":
+  case "service": {
+    const serviceSubcommand = args[1] ?? "install";
     await serviceCommand(...args.slice(1));
+    if (!["status", "stop", "uninstall", "remove"].includes(serviceSubcommand)) {
+      try {
+        const { ensureDefaultAutoUpdateScheduler } = await import("../update/auto-scheduler");
+        ensureDefaultAutoUpdateScheduler();
+      } catch { /* default updater provisioning must not block service commands */ }
+    }
     break;
+  }
   case "tray": {
     const { windowsTrayCommand } = await import("../tray/windows");
     await windowsTrayCommand(args.slice(1));
@@ -1335,19 +1317,12 @@ switch (command) {
     await refreshVersionCache(channel);
     break;
   }
-  case "__desktop-update-worker": {
-    const id = args[1];
-    const mode = args[2];
-    if (!id || !/^desktop-\d+-[a-z0-9]+$/.test(id) || (mode !== "download" && mode !== "install")) {
-      console.error("Invalid desktop update worker arguments.");
-      process.exitCode = 64;
-      break;
-    }
-    await runDesktopUpdateWorker(id, mode === "install");
+  case "__auto-update": {
+    const { runAutomaticUpdateWorker } = await import("../update/auto-scheduler");
+    const result = await runAutomaticUpdateWorker();
+    if (!result.ok) process.exitCode = 1;
     break;
   }
-  case "__desktop-update":
-  case "__desktop-auto-update-check":
   case "__tray-start":
   case "__tray-restart":
   case "__startup-health":
@@ -1356,8 +1331,6 @@ switch (command) {
     await dispatchInternalCliCommand(command as InternalCliCommand, {
       trayStart: async () => { await handleTrayProxyStart(); },
       trayRestart: handleTrayProxyRestart,
-      desktopUpdate: () => handleDesktopUpdateRequest(args.slice(1)),
-      desktopAutoUpdateCheck: handleAutomaticDesktopUpdateCheck,
       startupHealth: async () => {
         const { collectStartupHealth } = await import("../codex/autostart-health");
         console.log(JSON.stringify(collectStartupHealth(loadConfig())));

package/src/cli/init.ts CHANGED Viewed

@@ -1,6 +1,7 @@
 import * as readline from "node:readline";
 import { constants as fsConstants, copyFileSync, existsSync, readFileSync, unlinkSync } from "node:fs";
 import { injectCodexConfig } from "../codex/inject";
+import { CODEX_CONFIG_PATH } from "../codex/paths";
 import { classifyOpenAiTierBackup, getConfigPath, getDefaultConfig, isValidProviderName, saveConfig } from "../config";
 import { enrichProviderFromCatalog } from "../oauth/key-providers";
 import { deriveInitProviders } from "../providers/derive";
@@ -189,13 +190,18 @@ export async function runInit(): Promise<void> {
     // preserved by renaming it out of the collision path (sol review 260722).
     cleanupOpenAiTierBackupAfterInit();
     console.log(`\n✅ Config saved to ${getConfigPath()}`);
+    console.log(`   Codex config target: ${CODEX_CONFIG_PATH}`);
     if (oauthHint) console.log(`🔐 Authenticate this provider with:  rmx login ${providerName}`);
     const injectAnswer = await prompt.ask("Inject into Codex config.toml? [Y/n]: ");
     if (injectAnswer.trim().toLowerCase() !== "n") {
       console.log("Fetching available models from provider...");
       const result = await injectCodexConfig(port, config);
-      console.log(result.success ? `✅ ${result.message}` : `⚠️  ${result.message}`);
+      const routed = result.success && result.routingApplied !== false;
+      console.log(routed ? `✅ ${result.message}` : `⚠️  ${result.message}`);
+      if (!routed) {
+        console.log(`   Remodex did not take ownership of plain Codex routing. Review the reason above, then run 'rmx sync'.`);
+      }
     }
     const shimAnswer = await prompt.ask("Install Codex autostart shim? [Y/n]: ");

package/src/cli/internal-dispatch.ts CHANGED Viewed

@@ -2,8 +2,6 @@ export type InternalCliCommand =
   | "__tray-start"
   | "__tray-restart"
   | "__startup-health"
-  | "__desktop-update"
-  | "__desktop-auto-update-check"
   | "__desktop-restart-codex"
   | "__desktop-restart-client";
@@ -11,8 +9,6 @@ export interface InternalCliHandlers {
   trayStart: () => void | Promise<void>;
   trayRestart: () => void | Promise<void>;
   startupHealth: () => void | Promise<void>;
-  desktopUpdate: () => void | Promise<void>;
-  desktopAutoUpdateCheck: () => void | Promise<void>;
   desktopRestartCodex: () => void | Promise<void>;
   desktopRestartClient: () => void | Promise<void>;
 }
@@ -26,8 +22,6 @@ export async function dispatchInternalCliCommand(
     case "__tray-start": return void await handlers.trayStart();
     case "__tray-restart": return void await handlers.trayRestart();
     case "__startup-health": return void await handlers.startupHealth();
-    case "__desktop-update": return void await handlers.desktopUpdate();
-    case "__desktop-auto-update-check": return void await handlers.desktopAutoUpdateCheck();
     case "__desktop-restart-codex": return void await handlers.desktopRestartCodex();
     case "__desktop-restart-client": return void await handlers.desktopRestartClient();
     default: throw new Error(`Unsupported internal CLI command: ${String(command)}`);