larkup 0.4.50 → 0.4.51

package/bin/larkup.js

@@ -34,7 +34,6 @@ if (command === '--version' || command === '-v') {
     process.exit(1);
   }
   await migrateLegacyRuntimeState();
-  await prepareLocalAnalysisRuntime();
   const child = spawn(process.execPath, [standaloneServer], {
     cwd: packageDir,
     stdio: 'inherit',
@@ -47,6 +46,11 @@ if (command === '--version' || command === '-v') {
   });
   child.once('exit', (code) => process.exit(code ?? 0));
 
+  // Start the browser-facing application immediately. The local analysis
+  // environment is warmed through the running server so an analysis request
+  // can share that same in-process setup instead of starting a second install.
+  void prepareLocalAnalysisRuntime(url);
+
   if (process.env.CI !== 'true' && process.env.LARKUP_NO_OPEN !== '1') {
     void openWhenReady(url);
   }
@@ -199,20 +203,43 @@ async function migrateLegacyRuntimeState() {
 }
 
 /**
- * Prepare the managed Python environment before the browser can submit an
- * analysis request. A fresh Windows install may need several minutes to fetch
- * pandas, numpy, and the other pinned wheels; doing that inside the streamed
- * chat request can outlive the model step even though installation succeeds.
+ * Warm the managed Python environment after the application starts. A fresh
+ * Windows install may need several minutes to fetch pandas, numpy, and the
+ * other pinned wheels, but that work must not block the UI from opening.
  *
- * This launcher is used only by the local npm application. Managed Cloud hosts
- * start their configured remote sandbox adapters through the server runtime
- * and never enter this path.
+ * Going through the existing sandbox API keeps setup in the server process.
+ * If chat analysis starts while warmup is running, both calls share the same
+ * cached setup promise. Managed Cloud and configured remote backends are
+ * detected by the health response and never enter the local setup path.
  */
-async function prepareLocalAnalysisRuntime() {
-  console.log(`\x1b[38;2;223;156;32mPreparing local analysis runtime…\x1b[0m`);
+async function prepareLocalAnalysisRuntime(url) {
   try {
-    const { SandboxManager } = await import('@larkup/sandbox');
-    await new SandboxManager({ backend: 'local' }).setup();
+    const health = await waitForSandboxApi(url);
+    if (!health || health.backend !== 'local') return;
+
+    console.log(`\x1b[38;2;223;156;32mPreparing local analysis runtime in the background…\x1b[0m`);
+    console.log('Larkup is ready to open; analysis tools will activate when setup finishes.');
+
+    const startedAt = Date.now();
+    const progress = setInterval(() => {
+      const elapsedSeconds = Math.floor((Date.now() - startedAt) / 1_000);
+      const elapsed =
+        elapsedSeconds < 60 ? `${elapsedSeconds}s` : `${Math.floor(elapsedSeconds / 60)} min`;
+      console.log(`Still preparing local analysis runtime (${elapsed})…`);
+    }, 30_000);
+
+    try {
+      const response = await fetch(new URL('/api/sandbox?action=setup', url), {
+        method: 'POST',
+      });
+      const result = await response.json().catch(() => ({}));
+      if (!response.ok) {
+        throw new Error(result.error || `setup request failed with HTTP ${response.status}`);
+      }
+    } finally {
+      clearInterval(progress);
+    }
+
     console.log(`\x1b[32mLocal analysis runtime ready.\x1b[0m`);
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -221,6 +248,19 @@ async function prepareLocalAnalysisRuntime() {
   }
 }
 
+async function waitForSandboxApi(url) {
+  for (let attempt = 0; attempt < 120; attempt += 1) {
+    try {
+      const response = await fetch(new URL('/api/sandbox', url));
+      if (response.ok) return await response.json();
+    } catch {
+      // The standalone server is still starting.
+    }
+    await new Promise((resolve) => setTimeout(resolve, 250));
+  }
+  return undefined;
+}
+
 async function activeProjectConfig() {
   const root = projectRoot();
   const entries = await fs.readdir(root, { withFileTypes: true }).catch(() => []);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "larkup",
-  "version": "0.4.50",
+  "version": "0.4.51",
   "engines": {
     "node": ">=22"
   },
@@ -71,9 +71,9 @@
     "zod": "^4.4.3",
     "zustand": "^5.0.14",
     "@larkup/workspace-ui": "0.2.0",
+    "@larkup/runtime-kit": "0.3.0",
     "@larkup/workspace-server": "0.2.30",
-    "@larkup/workspace-app": "0.2.12",
-    "@larkup/runtime-kit": "0.3.0"
+    "@larkup/workspace-app": "0.2.12"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.2.0",