finch-ego-lite 0.1.4 → 0.1.5

package/dist/index.js

@@ -7,6 +7,7 @@ import { promisify } from "node:util";
 var execFileAsync = promisify(execFile);
 var WEBSITE = "https://lite.ego.app/";
 var STATUS_MARKER = "__EGO_STATUS__";
+var OFFLINE_CONFIRMATIONS = 2;
 var commandQueue = Promise.resolve();
 function egoBinary() {
   const local = join(homedir(), ".local", "bin", "ego-browser");
@@ -56,6 +57,26 @@ async function installedVersion(binary) {
     return void 0;
   }
 }
+var VERSION_TTL = 5 * 6e4;
+var cachedVersion;
+async function probeVersion(binary) {
+  if (cachedVersion && Date.now() - cachedVersion.at < VERSION_TTL) return cachedVersion.value;
+  const value = await installedVersion(binary);
+  if (value) cachedVersion = { value, at: Date.now() };
+  return value;
+}
+async function probeInstall(binary, running) {
+  const version = running && cachedVersion?.value || await probeVersion(binary);
+  return { installed: running || Boolean(version), version };
+}
+async function waitForRunning(deadlineMs = 12e3) {
+  const until = Date.now() + deadlineMs;
+  for (; ; ) {
+    if (await processRunning()) return true;
+    if (Date.now() >= until) return false;
+    await new Promise((resolve) => setTimeout(resolve, 400));
+  }
+}
 function statusScript(detailed) {
   return `
 const spaces = await listTaskSpaces();
@@ -98,11 +119,10 @@ async function getStatus(detailed = false) {
     return { supported: false, installed: false, running: false, spaces: [], pageCount: 0 };
   }
   const binary = egoBinary();
-  if (!binary) return { supported: true, installed: false, running: false, spaces: [], pageCount: 0 };
-  const version = await installedVersion(binary);
-  if (!version) return { supported: true, installed: false, running: false, spaces: [], pageCount: 0 };
   const running = await processRunning();
-  if (!running) return { supported: true, installed: true, running: false, version, spaces: [], pageCount: 0 };
+  const { installed, version } = await probeInstall(binary, running);
+  const base = { supported: true, installed, running, version, spaces: [], pageCount: 0 };
+  if (!running || !version) return base;
   try {
     const output = await runCommand(binary, ["nodejs", "-e", statusScript(detailed)], 1e4);
     const spaces = parseSpaces(output);
@@ -110,19 +130,30 @@ async function getStatus(detailed = false) {
       if (space.tabs) return sum + space.tabs.length;
       return sum + (space.recentTabTitles?.length ?? 0);
     }, 0);
-    return { supported: true, installed: true, running: true, version, spaces, pageCount };
+    return { ...base, spaces, pageCount };
   } catch (error) {
     return {
-      supported: true,
-      installed: true,
-      running: true,
-      version,
-      spaces: [],
-      pageCount: 0,
+      ...base,
       error: error instanceof Error ? error.message : String(error)
     };
   }
 }
+async function probeStatus(previous) {
+  if (process.platform !== "darwin") {
+    return { supported: false, installed: false, running: false, spaces: [], pageCount: 0 };
+  }
+  const running = await processRunning();
+  const { installed, version } = await probeInstall(egoBinary(), running);
+  return {
+    supported: true,
+    installed,
+    running,
+    version: version ?? previous?.version,
+    // A cached space list is meaningless once the process is gone.
+    spaces: running ? previous?.spaces ?? [] : [],
+    pageCount: running ? previous?.pageCount ?? 0 : 0
+  };
+}
 async function launchEgo() {
   if (process.platform !== "darwin") throw new Error("Ego Lite currently supports macOS only.");
   await execFileAsync("open", ["-a", "ego lite"], { timeout: 5e3 });
@@ -299,19 +330,45 @@ function activate(ctx) {
     }
   }));
   let cachedStatus;
-  let lastRefreshAt = 0;
+  let lastDetailAt = 0;
+  let offlineMisses = 0;
+  let recheckTimer;
   let refreshInFlight;
   let pendingDetailedRefresh = false;
+  const isOnline = (status) => status?.installed === true && status.running === true;
+  const publishStatus = (next, detailed) => {
+    if (isOnline(cachedStatus) && !isOnline(next) && offlineMisses + 1 < OFFLINE_CONFIRMATIONS) {
+      offlineMisses += 1;
+      if (!recheckTimer) {
+        recheckTimer = setTimeout(() => {
+          recheckTimer = void 0;
+          void refreshStatus(false);
+        }, 600);
+      }
+      return;
+    }
+    const previousOnline = isOnline(cachedStatus);
+    const same = JSON.stringify(cachedStatus ?? null) === JSON.stringify(next);
+    offlineMisses = 0;
+    cachedStatus = next;
+    if (detailed) lastDetailAt = Date.now();
+    if (previousOnline !== isOnline(next)) {
+      ctx.logger.info("Ego online state changed", {
+        online: isOnline(next),
+        running: next.running,
+        installed: next.installed,
+        version: next.version,
+        error: next.error
+      });
+    }
+    if (!same) action.notifyUpdate();
+  };
   const refreshStatus = (detailed = false) => {
     if (refreshInFlight) {
       if (detailed) pendingDetailedRefresh = true;
       return refreshInFlight;
     }
-    refreshInFlight = getStatus(detailed).then((status) => {
-      cachedStatus = status;
-      lastRefreshAt = Date.now();
-      action.notifyUpdate();
-    }).catch((error) => ctx.logger.warn("Ego background status refresh failed", error)).finally(() => {
+    refreshInFlight = (detailed ? getStatus(true) : probeStatus(cachedStatus)).then((status) => publishStatus(status, detailed)).catch((error) => ctx.logger.warn("Ego background status refresh failed", error)).finally(() => {
       refreshInFlight = void 0;
       if (pendingDetailedRefresh) {
         pendingDetailedRefresh = false;
@@ -322,12 +379,11 @@ function activate(ctx) {
   };
   const action = ctx.composerActions.register("ego-browser", {
     async getBadge() {
-      const online = cachedStatus?.installed === true && cachedStatus.running === true && !cachedStatus.error;
       if (cachedStatus?.supported === false) return { text: t("badge.unsupported"), active: false };
-      return online ? { text: t("badge.online"), active: true } : { text: t("badge.offline"), active: false };
+      return isOnline(cachedStatus) ? { text: t("badge.online"), active: true } : { text: t("badge.offline"), active: false };
     },
     async getMenu() {
-      if (cachedStatus === void 0 || Date.now() - lastRefreshAt > 3e3) {
+      if (cachedStatus === void 0 || Date.now() - lastDetailAt > 3e3) {
         await refreshStatus(true);
       }
       if (!cachedStatus) {
@@ -394,6 +450,9 @@ function activate(ctx) {
         id: "__summary__",
         label: t("menu.summary.spaces", { count: status.spaces.length }),
         description: t("menu.summary.pages", { count: status.pageCount }),
+        // When the space read fails while Ego is up, say so here instead of
+        // showing an empty list with no explanation.
+        hoverText: status.error ? t("status.error", { error: status.error }) : void 0,
         iconName: "ext:ego-browser-icons/compass",
         disabled: true
       }, {
@@ -472,7 +531,7 @@ ${domainOf(tab.url, t("site.unknown"))}`,
           await ctx.ui.showToast({ title: t("toast.launched"), variant: "success", position: "TC" });
           cachedStatus = void 0;
           action.notifyUpdate();
-          refreshStatus(true);
+          void waitForRunning().then(() => refreshStatus(true));
           return;
         }
         if (itemId.startsWith("resume:")) {
@@ -497,13 +556,14 @@ ${domainOf(tab.url, t("site.unknown"))}`,
           const script = `const result = await completeTaskSpace(${JSON.stringify(spaceId)}, { keep: false }); cliLog(JSON.stringify(result));`;
           await runCommand(binary, ["nodejs", "-e", script], 15e3);
           action.notifyUpdate();
-          refreshStatus(true);
+          refreshStatus(false);
           await ctx.ui.showToast({ title: t("toast.closed"), variant: "success", position: "TC" });
           return;
         }
         if (itemId.startsWith("tab:")) {
           const [spaceId, targetId] = unkey(itemId.slice("tab:".length));
           await launchEgo();
+          if (!await waitForRunning()) throw new Error(t("error.launchTimeout"));
           const binary = egoBinary();
           const script = `await switchTaskSpace(${JSON.stringify(spaceId)}); await switchTab(${JSON.stringify(targetId)}); cliLog('ok');`;
           await runCommand(binary, ["nodejs", "-e", script], 1e4);
@@ -566,8 +626,7 @@ Reuse task spaces, respect user ownership, verify meaningful actions, and comple
       const actionName = request.action ?? "";
       if (actionName === "status") {
         const status = await getStatus(true);
-        cachedStatus = status;
-        action.notifyUpdate();
+        publishStatus(status, true);
         return { content: [{ type: "text", text: statusText(status, t) }], isError: !status.supported || Boolean(status.error) };
       }
       if (!ACTION_STAGES[actionName]) {
@@ -600,8 +659,8 @@ Reuse task spaces, respect user ownership, verify meaningful actions, and comple
         return { content: [{ type: "text", text: t("status.unsupported", { platform: process.platform }) }], isError: true };
       }
       const binary = egoBinary();
-      const version = binary ? await installedVersion(binary) : void 0;
-      if (!binary || !version) {
+      const version = await probeVersion(binary);
+      if (!version && !await processRunning()) {
         return {
           content: [{ type: "text", text: `Ego Lite is not installed. Install it from ${WEBSITE}, finish onboarding, then retry.` }],
           isError: true
@@ -620,7 +679,9 @@ Reuse task spaces, respect user ownership, verify meaningful actions, and comple
       if (!await processRunning()) {
         exec.progress.report({ stage: "launching", message: pickProgress(t, "launching") });
         await launchEgo();
-        await new Promise((resolve) => setTimeout(resolve, 1800));
+        if (!await waitForRunning()) {
+          return { content: [{ type: "text", text: t("error.launchTimeout") }], isError: true };
+        }
       } else {
         await focusEgo();
       }
@@ -629,8 +690,7 @@ Reuse task spaces, respect user ownership, verify meaningful actions, and comple
       exec.progress.report({ stage: ACTION_STAGES[actionName], message: pickProgress(t, ACTION_STAGES[actionName] ?? "browsing") });
       try {
         const output = await runCommand(binary, ["nodejs", "-e", script], timeout);
-        action.notifyUpdate();
-        refreshStatus(true);
+        refreshStatus(false);
         if (actionName === "screenshot") {
           const path = output.split("__EGO_SHOT__").pop()?.split("\n")[0]?.trim();
           if (!path || !existsSync(path)) {
@@ -646,15 +706,14 @@ Reuse task spaces, respect user ownership, verify meaningful actions, and comple
         }
         return { content: [{ type: "text", text: output || "ok" }] };
       } catch (error) {
-        action.notifyUpdate();
-        refreshStatus(true);
+        refreshStatus(false);
         const message = error instanceof Error ? error.message : String(error);
         return { content: [{ type: "text", text: message }], isError: true };
       }
     }
   }));
   refreshStatus(true);
-  const timer = setInterval(() => refreshStatus(true), 5e3);
+  const timer = setInterval(() => refreshStatus(false), 5e3);
   ctx.subscriptions.push({ dispose: () => clearInterval(timer) });
   ctx.logger.info("ego-browser mini tool activated", { cached: Boolean(cachedStatus) });
 }

package/i18n/en-US.json

@@ -95,7 +95,8 @@
     }
   },
   "error": {
-    "notInstalled": "Ego Browser is not installed"
+    "notInstalled": "Ego Browser is not installed",
+    "launchTimeout": "Ego Lite was launched but is not ready yet. Wait a moment and try again."
   },
   "progress": {
     "launching": "Waking up Ego Browser…|Pouring a coffee for the browser…|Ego is stretching…",

package/i18n/zh-CN.json

@@ -95,7 +95,8 @@
     }
   },
   "error": {
-    "notInstalled": "Ego Browser 未安装"
+    "notInstalled": "Ego Browser 未安装",
+    "launchTimeout": "Ego Lite 已启动但还没就绪，请稍等片刻再试。"
   },
   "progress": {
     "launching": "正在唤醒 Ego 浏览器…|给浏览器泡杯咖啡…|Ego 正在伸懒腰…",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "finch-ego-lite",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Let Finch browse the web in isolated Ego Lite task spaces while you follow every page it opens.",
   "author": {
     "name": "PuterJam",