agentlas 1.0.26 → 1.0.28

package/engine/commands/help.cjs

@@ -44,7 +44,7 @@ ACCOUNT & OPS
   multimodal               image/video/audio provider settings
   doctor · setup · update  health check · first-run wizard · npm update check
   oberon | film <sub>      AI film render (scaffold|render|list|open)
-  hep <sub…> · netadmin    Hephaestus passthrough · local network admin
+  hep <sub…> · netadmin    Hephaestus passthrough · local agent network
   version · help
 
 IN-REPL (agentlas → interactive, Orca multi-session)

package/engine/hephaestus/runtime.cjs

@@ -644,15 +644,53 @@ function create(ctx, deps = {}) {
       process.stderr.write("Hephaestus failed: Python 3.9+ was not found.\n");
       return Promise.resolve(1);
     }
+    // Core writes nothing until its final payload. `hep search` measured 29.7s
+    // of complete silence on every stream — indistinguishable from a hang, and
+    // the command that takes longest is the one a newcomer tries first.
+    // stdout carries machine-readable JSON, so the heartbeat goes to stderr
+    // only, and only when stderr is a terminal: piping or redirecting must stay
+    // byte-identical for anything parsing this.
+    const stopHeartbeat = helpOnly ? null : startQuietChildHeartbeat(args);
     return new Promise((resolve) => {
       child.on("error", (e) => {
+        if (stopHeartbeat) stopHeartbeat();
         process.stderr.write(`Hephaestus failed: ${e.message}\n`);
         resolve(1);
       });
-      child.on("close", (code) => resolve(code == null ? 0 : code));
+      child.on("close", (code) => {
+        if (stopHeartbeat) stopHeartbeat();
+        resolve(code == null ? 0 : code);
+      });
     });
   }
 
+  /**
+   * Report elapsed time on stderr while a passthrough child stays quiet.
+   * Returns a stop function; returns null when there is nothing safe to write to.
+   */
+  function startQuietChildHeartbeat(args) {
+    if (!process.stderr.isTTY) return null;
+    const label = args.filter((a) => !String(a).startsWith("-")).slice(0, 2).join(" ") || "hephaestus";
+    const started = Date.now();
+    let painted = false;
+    const paint = () => {
+      const secs = Math.round((Date.now() - started) / 1000);
+      process.stderr.write(`\r${label} … ${secs}s`);
+      painted = true;
+    };
+    // Stay silent through the common fast case; only speak once it is slow
+    // enough that a user would start wondering.
+    const first = setTimeout(() => { paint(); }, 1500);
+    const timer = setInterval(paint, 1000);
+    if (typeof timer.unref === "function") timer.unref();
+    if (typeof first.unref === "function") first.unref();
+    return () => {
+      clearTimeout(first);
+      clearInterval(timer);
+      if (painted) process.stderr.write("\r");
+    };
+  }
+
   const HEP_USAGE = [
     "agentlas hep <hephaestus 서브커맨드…>   — 엔진 전 기능 네이티브 패스스루",
     "",

package/engine/ui/palette.cjs

@@ -79,7 +79,9 @@ const SLASH_COMMANDS = [
   { command: "/oberon", args: "[sub]", ko: "AI 필름", en: "AI film" },
   { command: "/film", args: "<sub>", ko: "필름 렌더", en: "Film render" },
   { command: "/hep", args: "<sub…>", ko: "Hephaestus 패스스루", en: "Hephaestus passthrough" },
-  { command: "/netadmin", args: "[sub]", ko: "로컬 네트워크 관리", en: "Local network admin" },
+  // "네트워크"만 쓰면 WiFi·LAN 관리로 읽힌다. 이 명령이 다루는 것은 로컬
+  // 에이전트 네트워크(init|status|reindex|bench|add-source)다.
+  { command: "/netadmin", args: "[sub]", ko: "로컬 에이전트 네트워크 관리", en: "Local agent network" },
   { command: "/update", args: "", ko: "npm 업데이트 확인", en: "npm update check" },
   { command: "/version", args: "", ko: "버전", en: "Version" },
   { command: "/logout", args: "", ko: "로그아웃", en: "Sign out" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentlas",
-  "version": "1.0.26",
+  "version": "1.0.28",
   "description": "Agentlas project terminal — run project controllers and task-scoped agent teams from the terminal. Standalone: no desktop app process required.",
   "bin": {
     "agentlas": "bin/agentlas.cjs"