@melaya/runner 1.0.81 → 1.0.83

package/dist/connection.js

@@ -64,6 +64,30 @@ export async function connect(opts) {
             console.log(chalk.yellow(`  ⚠ Luma browser bridge failed to start: ${e?.message || e}`));
         }
     };
+    // Background warm-up of the assistant Python env, once per process, so the
+    // first assistant chat spawns near-instantly. No-op on a fresh runner (no
+    // shared bundle on disk yet) — the real assistant_start installs it then.
+    let _assistantPrewarmed = false;
+    const _prewarmAssistantEnv = async () => {
+        if (_assistantPrewarmed)
+            return;
+        _assistantPrewarmed = true;
+        try {
+            const { getLocalSharedVersion } = await import("./sharedVendor.js");
+            const localVersion = getLocalSharedVersion();
+            if (!localVersion)
+                return; // nothing cached yet — let assistant_start do it
+            const { ensurePythonEnv } = await import("./pythonEnv.js");
+            await ensurePythonEnv(opts.pythonPath, localVersion, (m) => { if (opts.verbose)
+                console.log(chalk.gray(`  [assistant prewarm] ${m}`)); });
+            if (opts.verbose)
+                console.log(chalk.gray("  [assistant prewarm] ready"));
+        }
+        catch (e) {
+            if (opts.verbose)
+                console.log(chalk.gray(`  [assistant prewarm] skipped: ${e?.message || e}`));
+        }
+    };
     socket.on("connect", async () => {
         spinner.succeed(chalk.green("Connected to Melaya"));
         // Report detected models
@@ -83,6 +107,12 @@ export async function connect(opts) {
         // effort — failure here means Luma POSTs fall back to aiohttp
         // (which 403s under the bot rule) but reads still work.
         await _ensureLumaBridge();
+        // Pre-warm the assistant Python env in the BACKGROUND so the first chat
+        // message doesn't pay the venv check + one-time NLTK/cert self-heal inline
+        // (the biggest chunk of "◆ Assistant session … takes forever to spawn").
+        // We warm with the version already on disk so it hits the cache instead of
+        // reinstalling; skipped on a fresh runner (no bundle yet) to avoid churn.
+        void _prewarmAssistantEnv();
         console.log(chalk.gray("  Waiting for pipeline runs...\n"));
     });
     socket.on("connect_error", (err) => {
@@ -315,6 +345,10 @@ export async function connect(opts) {
                 PYTHONUTF8: "1",
                 ...sslEnv,
                 MEL_RUN_ID: payload.runId,
+                // Pipeline name so phone-driving runs can self-register as the phone's
+                // active run (arms the on-device working overlay + its Kill button)
+                // regardless of launch surface — desktop, native, or assistant.
+                MEL_PIPELINE_NAME: payload.pipelineName,
                 // Point agentscope hooks at the REAL server (not the browser's Vite URL).
                 // Convert wss://api.melaya.org → https://api.melaya.org so pushMessage,
                 // registerRun, and other agentscope HTTP calls reach the tRPC server.

package/dist/pythonEnv.js

@@ -320,13 +320,21 @@ async function ensureNltkData(onProgress) {
         onProgress(`(nltk check exited ${code} — Mode B vector RAG ingest may fail with "Resource 'punkt_tab' not found")`);
     }
 }
+// One-time-per-process guard for the cache-hit self-heal (NLTK + cert bundle).
+let _selfHealedThisProcess = false;
 export async function ensurePythonEnv(systemPython, expectedVersion, onProgress = (m) => console.log(chalk.gray(`  [venv] ${m}`))) {
     if (venvIsValid(expectedVersion)) {
-        // Self-heal: ensure NLTK data is present even when the venv marker
-        // says we're up to date. This is what previously broke for boxes
-        // that upgraded the runner without invalidating the marker.
-        await ensureNltkData(onProgress);
-        await _resolveAndCacheCertBundle(onProgress);
+        // Self-heal: ensure NLTK data + the cert bundle are present even when the
+        // venv marker says we're up to date (this is what previously broke for
+        // boxes that upgraded the runner without invalidating the marker). Both are
+        // stable for the process lifetime, so run them ONCE per runner process — the
+        // old code spawned two extra Python processes on EVERY assistant/pipeline
+        // start (~0.5-1.5s of pure latency on the assistant-spawn critical path).
+        if (!_selfHealedThisProcess) {
+            _selfHealedThisProcess = true;
+            await ensureNltkData(onProgress);
+            await _resolveAndCacheCertBundle(onProgress);
+        }
         return { ok: true, pythonPath: venvPython() };
     }
     if (!existsSync(AGENTSCOPE)) {

package/dist/sharedVendor.d.ts

@@ -7,5 +7,12 @@
  * runtime from the server's /api/v1/agents/shared-bundle endpoint,
  * integrity-verified via SHA-256, and cached at ~/.melaya-runner/shared/.
  */
+/**
+ * The shared-bundle version currently installed on disk (from shared-version.txt),
+ * or null if none/incomplete. Used to pre-warm the Python env on connect with the
+ * SAME version the cache already holds, so the warm-up hits the cache instead of
+ * triggering a reinstall.
+ */
+export declare function getLocalSharedVersion(): string | null;
 export declare function getSharedDir(): string;
 export declare function ensureSharedModules(serverUrl: string, expectedVersion: string, runnerToken: string): Promise<void>;

package/dist/sharedVendor.js

@@ -14,6 +14,22 @@ import { createHash, createHmac, timingSafeEqual } from "crypto";
 const CACHE_DIR = join(homedir(), ".melaya-runner");
 const SHARED_DIR = join(CACHE_DIR, "shared");
 const VERSION_FILE = join(CACHE_DIR, "shared-version.txt");
+/**
+ * The shared-bundle version currently installed on disk (from shared-version.txt),
+ * or null if none/incomplete. Used to pre-warm the Python env on connect with the
+ * SAME version the cache already holds, so the warm-up hits the cache instead of
+ * triggering a reinstall.
+ */
+export function getLocalSharedVersion() {
+    try {
+        if (existsSync(VERSION_FILE) && cacheLooksValid()) {
+            const v = readFileSync(VERSION_FILE, "utf-8").trim();
+            return v || null;
+        }
+    }
+    catch { /* best-effort */ }
+    return null;
+}
 export function getSharedDir() {
     // Return the CACHE_DIR root (not shared/ subdir) because the bundle
     // now includes agentscope/ and crews/ alongside shared/. PYTHONPATH

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@melaya/runner",
-  "version": "1.0.81",
+  "version": "1.0.83",
   "description": "Run Melaya AI pipelines locally with your own LM Studio or Ollama models",
   "license": "UNLICENSED",
   "private": false,