finch-ego-lite 0.1.5 → 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,22 +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 {
@@ -34,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) {
@@ -115,7 +152,7 @@ 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();
@@ -139,7 +176,7 @@ async function getStatus(detailed = false) {
   }
 }
 async function probeStatus(previous) {
-  if (process.platform !== "darwin") {
+  if (!isSupportedPlatform()) {
     return { supported: false, installed: false, running: false, spaces: [], pageCount: 0 };
   }
   const running = await processRunning();
@@ -155,13 +192,32 @@ async function probeStatus(previous) {
   };
 }
 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";
@@ -655,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 = 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
         };
       }

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}"

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}"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "finch-ego-lite",
-  "version": "0.1.5",
+  "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": {