@elizaos/autonomous 2.0.0-alpha.65 → 2.0.0-alpha.66

package/data/stream/stream-settings.json

@@ -0,0 +1,3 @@
+{
+  "avatarIndex": 1
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/autonomous",
-  "version": "2.0.0-alpha.65",
+  "version": "2.0.0-alpha.66",
   "description": "Standalone autonomous agent runtime and backend server package for elizaOS.",
   "type": "module",
   "license": "MIT",

package/src/runtime/eliza.ts

@@ -4166,12 +4166,36 @@ export async function startEliza(
   //     (ActionFilterService, EmbeddingGenerationService) race ahead and use
   //     the cloud plugin's TEXT_EMBEDDING handler — which hits a paid API —
   //     because local-embedding's heavier init hasn't completed yet.
+  // Check whether the embedding model file is already downloaded.
+  // When missing, we defer local-embedding registration to after
+  // runtime.initialize() so the multi-GB download does not block
+  // startup (runtime.initialize → ensureEmbeddingDimension would hang
+  // waiting for the model).
+  let deferLocalEmbedding = false;
   if (localEmbeddingPlugin) {
     configureLocalEmbeddingPlugin(localEmbeddingPlugin.plugin, config);
-    await runtime.registerPlugin(localEmbeddingPlugin.plugin);
-    logger.info(
-      "[eliza] plugin-local-embedding pre-registered (TEXT_EMBEDDING ready)",
-    );
+
+    const embeddingModelDir =
+      process.env.MODELS_DIR ??
+      path.join(resolveStateDir(), "models");
+    const embeddingModelFile =
+      process.env.LOCAL_EMBEDDING_MODEL ?? "nomic-embed-text-v1.5.Q5_K_M.gguf";
+    const modelPath = path.join(embeddingModelDir, embeddingModelFile);
+
+    try {
+      await fs.access(modelPath);
+      // Model exists — register now so ensureEmbeddingDimension works
+      await runtime.registerPlugin(localEmbeddingPlugin.plugin);
+      logger.info(
+        "[eliza] plugin-local-embedding pre-registered (TEXT_EMBEDDING ready)",
+      );
+    } catch {
+      deferLocalEmbedding = true;
+      logger.info(
+        `[eliza] Embedding model not yet downloaded (${embeddingModelFile}). ` +
+          "Deferring local-embedding to avoid blocking startup.",
+      );
+    }
   } else {
     logger.warn(
       "[eliza] @elizaos/plugin-local-embedding not found — embeddings " +
@@ -4277,6 +4301,15 @@ export async function startEliza(
     }
   };
 
+  // Keep the event loop alive during the entire startup sequence.
+  // PGLite and the local-embedding model download may `unref()` their
+  // internal handles, causing Node to exit before the initialize() promise
+  // settles when there is nothing else keeping the loop alive (e.g.
+  // server-only mode with stdin set to "ignore").  This guard stays active
+  // until a permanent handle (API server or the serverOnly keepAlive
+  // interval) takes over.
+  const startupKeepAlive = setInterval(() => {}, 1 << 30);
+
   const initializeRuntimeServices = async (): Promise<void> => {
     // 8. Initialize the runtime (registers remaining plugins, starts services)
     await runtime.initialize();
@@ -4343,6 +4376,24 @@ export async function startEliza(
 
   installActionAliases(runtime);
 
+  // Deferred local-embedding registration — register the plugin now that
+  // runtime.initialize() has completed.  The model will be downloaded on
+  // first embedding request rather than blocking startup.
+  if (deferLocalEmbedding && localEmbeddingPlugin) {
+    void (async () => {
+      try {
+        await runtime.registerPlugin(localEmbeddingPlugin.plugin);
+        logger.info(
+          "[eliza] plugin-local-embedding registered (deferred — model will download on first use)",
+        );
+      } catch (err) {
+        logger.warn(
+          `[eliza] Deferred local-embedding registration failed: ${formatError(err)}`,
+        );
+      }
+    })();
+  }
+
   // 9. Graceful shutdown handler
   //
   // In headless mode the caller (dev-server / Electron) owns the process
@@ -4406,6 +4457,10 @@ export async function startEliza(
 
   // ── Headless mode — return runtime for API server wiring ──────────────
   if (opts?.headless) {
+    // In headless mode the caller owns the process lifecycle, so the
+    // startupKeepAlive is no longer needed — the caller's own event-loop
+    // handles (bun --watch, Electron, etc.) keep the process alive.
+    clearInterval(startupKeepAlive);
     void loadHooksSystem();
     logger.info(
       "[eliza] Runtime initialised in headless mode (autonomy enabled)",
@@ -4613,7 +4668,9 @@ export async function startEliza(
     logger.info("[eliza] Running in server-only mode (no interactive chat)");
     console.log("[eliza] Server running. Press Ctrl+C to stop.");
 
-    // Keep process alive — the API server handles all interaction
+    // The startupKeepAlive already keeps the process alive.  Replace it
+    // with a permanent interval so the cleanup handler can reference it.
+    clearInterval(startupKeepAlive);
     const keepAlive = setInterval(() => {}, 1 << 30); // ~12 days
 
     // Cleanup on exit
@@ -4634,6 +4691,9 @@ export async function startEliza(
   }
 
   // ── Interactive chat loop ────────────────────────────────────────────────
+  // The readline interface and API server keep the event loop alive from
+  // here on, so the startup guard is no longer needed.
+  clearInterval(startupKeepAlive);
   const agentName = character.name ?? "Eliza";
   const userId = crypto.randomUUID() as UUID;
   // Use `let` so the fallback path can reassign to fresh IDs.
@@ -4843,6 +4903,7 @@ export async function startInCloudMode(
     if (opts?.headless || opts?.serverOnly) {
       // In headless/server mode, start the API server with the cloud proxy.
       // The proxy exposes the same interface the API server needs.
+      clearInterval(startupKeepAlive);
       logger.info(
         `[eliza] Cloud agent connected (headless). Agent: ${proxy.agentName}`,
       );
@@ -4852,6 +4913,7 @@ export async function startInCloudMode(
     }
 
     // Interactive CLI mode — simple chat loop against the cloud agent
+    clearInterval(startupKeepAlive);
     console.log(
       `\n☁️  Connected to cloud agent "${proxy.agentName}" (${agentId})\n`,
     );