finch-ego-lite 0.1.4 → 0.2.0

package/README.md

@@ -33,12 +33,12 @@ Task spaces are isolated from your everyday browser windows while still being ab
 
 ## Get started
 
-1. Install and launch [Ego Lite](https://lite.ego.app/) on macOS. Ego Lite is a browser designed for collaboration between people and AI Agents, and provides the web environment used by this mini tool.
-2. Enable this mini tool in Finch.
+1. Install and launch [Ego Lite](https://lite.ego.app/) on macOS or Windows. Ego Lite is a browser designed for collaboration between people and AI Agents, and provides the web environment used by this mini tool.
+2. Finish Ego Lite's first-time setup so it registers the `ego-browser` command, then enable this mini tool in Finch. If Finch was already running while you installed Ego Lite, restart Finch so it picks up the new command.
 3. Tell Finch which website to visit and what you want done.
 4. Use the Ego button beside the Composer to follow progress, open pages, or take control.
 
-> Ego Lite currently supports macOS only. On Windows or Linux, this mini tool explains that the platform is not supported and provides a link to the Ego Lite website for future updates.
+> Ego Lite currently runs on macOS and Windows. On other platforms, this mini tool explains that the platform is not supported and provides a link to the Ego Lite website.
 
 ## About Finch
 
@@ -83,12 +83,12 @@ Finch 会在 Ego Lite 的独立任务空间中打开网页。你不需要学习
 
 ## 开始使用
 
-1. 在 macOS 上安装并启动 [Ego Lite](https://lite.ego.app/)。Ego Lite 是专为人与 AI Agent 协作设计的浏览器，也是本小工具连接网页的运行环境。
-2. 在 Finch 中启用本小工具。
+1. 在 macOS 或 Windows 上安装并启动 [Ego Lite](https://lite.ego.app/)。Ego Lite 是专为人与 AI Agent 协作设计的浏览器，也是本小工具连接网页的运行环境。
+2. 完成 Ego Lite 的首次引导，让它注册 `ego-browser` 命令，然后在 Finch 中启用本小工具。如果安装 Ego Lite 时 Finch 已经开着，重启一次 Finch 才能读到新命令。
 3. 直接告诉 Finch 想访问的网站和要完成的事情。
 4. 通过输入框旁的 Ego 按钮查看进度、打开页面或接管操作。
 
-> Ego Lite 目前仅支持 macOS。在 Windows 或 Linux 上，本小工具会显示平台暂不支持，并提供 Ego Lite 官网入口了解后续进展。
+> Ego Lite 目前可在 macOS 和 Windows 上运行。其他平台上，本小工具会提示平台暂不支持，并提供 Ego Lite 官网入口。
 
 ## 关于 Finch
 

package/dist/index.js

@@ -2,21 +2,59 @@
 import { execFile } from "node:child_process";
 import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
-import { join } from "node:path";
+import { delimiter, join } from "node:path";
 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();
+var SUPPORTED_PLATFORMS = /* @__PURE__ */ new Set(["darwin", "win32"]);
+function isSupportedPlatform() {
+  return SUPPORTED_PLATFORMS.has(process.platform);
+}
+function localBinDir() {
+  return join(homedir(), ".local", "bin");
+}
 function egoBinary() {
-  const local = join(homedir(), ".local", "bin", "ego-browser");
-  if (existsSync(local)) return local;
+  const names = process.platform === "win32" ? ["ego-browser.exe", "ego-browser"] : ["ego-browser"];
+  for (const name of names) {
+    const local = join(localBinDir(), name);
+    if (existsSync(local)) return local;
+  }
   return "ego-browser";
 }
+function egoAppPath() {
+  if (process.platform !== "win32") return void 0;
+  const env = process.env;
+  const roots = [
+    env.ProgramFiles,
+    env["ProgramFiles(x86)"],
+    env.LOCALAPPDATA ? join(env.LOCALAPPDATA, "Programs") : void 0,
+    env.LOCALAPPDATA
+  ].filter((root) => Boolean(root));
+  const layouts = [
+    ["Citro Labs", "ego lite", "Application", "ego.exe"],
+    ["ego lite", "Application", "ego.exe"],
+    ["Citro Labs", "ego lite", "ego.exe"],
+    ["ego lite", "ego.exe"]
+  ];
+  for (const root of roots) {
+    for (const layout of layouts) {
+      const candidate = join(root, ...layout);
+      if (existsSync(candidate)) return candidate;
+    }
+  }
+  return void 0;
+}
 async function processRunning() {
-  if (process.platform !== "darwin") return false;
+  if (!isSupportedPlatform()) return false;
   const probe = async () => {
     try {
+      if (process.platform === "win32") {
+        const { stdout } = await execFileAsync("tasklist", ["/FI", "IMAGENAME eq ego.exe", "/NH"], { timeout: 3e3 });
+        return /\bego\.exe\b/i.test(stdout);
+      }
       await execFileAsync("pgrep", ["-f", "/ego lite.app/Contents/MacOS/ego lite"], { timeout: 2e3 });
       return true;
     } catch {
@@ -33,7 +71,7 @@ async function runCommand(file, args, timeout = 2e4) {
     const child = execFile(file, args, {
       timeout,
       maxBuffer: 10 * 1024 * 1024,
-      env: { ...process.env, PATH: `${join(homedir(), ".local", "bin")}:${process.env.PATH ?? ""}` }
+      env: { ...process.env, PATH: `${localBinDir()}${delimiter}${process.env.PATH ?? ""}` }
     }, (error, stdout, stderr) => {
       const output = [stdout, stderr].filter(Boolean).join("\n").trim();
       if (error) {
@@ -56,6 +94,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();
@@ -94,15 +152,14 @@ function parseSpaces(output) {
   return JSON.parse(json);
 }
 async function getStatus(detailed = false) {
-  if (process.platform !== "darwin") {
+  if (!isSupportedPlatform()) {
     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,27 +167,57 @@ 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 (!isSupportedPlatform()) {
+    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 });
+  if (process.platform === "darwin") {
+    await execFileAsync("open", ["-a", "ego lite"], { timeout: 5e3 });
+    return;
+  }
+  if (process.platform === "win32") {
+    const exe = egoAppPath();
+    if (!exe) {
+      throw new Error(`The ego lite app was not found on this PC. Open it from the Start menu, or reinstall it from ${WEBSITE}.`);
+    }
+    await execFileAsync("cmd", ["/c", "start", "", exe], { timeout: 5e3 });
+    return;
+  }
+  throw new Error(`Ego Lite does not run on this platform (${process.platform}).`);
 }
 async function focusEgo() {
-  if (process.platform !== "darwin") return;
-  await execFileAsync("open", ["-a", "ego lite"], { timeout: 5e3 }).catch(() => {
-  });
+  if (process.platform === "darwin") {
+    await execFileAsync("open", ["-a", "ego lite"], { timeout: 5e3 }).catch(() => {
+    });
+    return;
+  }
+  if (process.platform === "win32") {
+    const exe = egoAppPath();
+    if (!exe) return;
+    await execFileAsync("cmd", ["/c", "start", "", exe], { timeout: 5e3 }).catch(() => {
+    });
+  }
 }
 async function openWebsite() {
   const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open";
@@ -299,19 +386,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 +435,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 +506,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 +587,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 +612,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 +682,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]) {
@@ -596,14 +711,14 @@ Reuse task spaces, respect user ownership, verify meaningful actions, and comple
       if (actionName === "switch_tab" && !request.target_id) {
         return { content: [{ type: "text", text: "action=switch_tab requires target_id from action=status." }], isError: true };
       }
-      if (process.platform !== "darwin") {
+      if (!isSupportedPlatform()) {
         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.` }],
+          content: [{ type: "text", text: t("status.notInstalled", { website: WEBSITE }) }],
           isError: true
         };
       }
@@ -620,7 +735,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 +746,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 +762,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

@@ -13,7 +13,7 @@
   "badge": {
     "online": "Ego online",
     "offline": "Ego offline",
-    "unsupported": "macOS only"
+    "unsupported": "Not supported"
   },
   "menu": {
     "checking": {
@@ -27,9 +27,9 @@
       "label": "Learn about Ego Lite"
     },
     "unsupported": {
-      "label": "Ego Lite requires macOS",
+      "label": "Ego Lite needs macOS or Windows",
       "description": "This device is not supported",
-      "hover": "Ego Lite currently runs on macOS only. Current platform: {platform}."
+      "hover": "Ego Lite currently runs on macOS and Windows. Current platform: {platform}."
     },
     "install": {
       "label": "Install Ego Lite",
@@ -72,7 +72,7 @@
     "user": "User control"
   },
   "status": {
-    "unsupported": "Ego Lite currently supports macOS only. Current platform: {platform}.",
+    "unsupported": "Ego Lite currently supports macOS and Windows. Current platform: {platform}.",
     "notInstalled": "Ego Lite is not installed. Install it from {website} and finish first-time setup.",
     "notRunning": "Ego Lite {version} is installed but not running.",
     "error": "Ego Lite is running, but its status could not be read: {error}"
@@ -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

@@ -13,7 +13,7 @@
   "badge": {
     "online": "Ego 在线",
     "offline": "Ego 离线",
-    "unsupported": "仅支持 macOS"
+    "unsupported": "平台不支持"
   },
   "menu": {
     "checking": {
@@ -27,9 +27,9 @@
       "label": "了解 Ego Lite"
     },
     "unsupported": {
-      "label": "Ego Lite 仅支持 macOS",
+      "label": "Ego Lite 支持 macOS 与 Windows",
       "description": "当前设备暂不可用",
-      "hover": "Ego Lite 目前只能在 macOS 上运行。当前平台：{platform}。"
+      "hover": "Ego Lite 目前可在 macOS 和 Windows 上运行。当前平台：{platform}。"
     },
     "install": {
       "label": "安装 Ego Lite",
@@ -72,7 +72,7 @@
     "user": "用户控制"
   },
   "status": {
-    "unsupported": "Ego Lite 目前仅支持 macOS。当前平台：{platform}。",
+    "unsupported": "Ego Lite 目前支持 macOS 和 Windows。当前平台：{platform}。",
     "notInstalled": "Ego Lite 未安装。请从 {website} 安装并完成首次引导。",
     "notRunning": "Ego Lite 已安装（{version}），当前未运行。",
     "error": "Ego Lite 正在运行，但状态读取失败：{error}"
@@ -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.2.0",
   "description": "Let Finch browse the web in isolated Ego Lite task spaces while you follow every page it opens.",
   "author": {
     "name": "PuterJam",
@@ -21,6 +21,7 @@
   "scripts": {
     "build": "esbuild src/index.ts --bundle --platform=node --format=esm --target=node18 --outfile=dist/index.js",
     "typecheck": "tsc --noEmit",
+    "smoke": "node tools/smoke.mjs",
     "prepublishOnly": "npm run typecheck && npm run build && npx @finchtoys/minitools doctor ."
   },
   "finch": {