summrise-agent 1.2.453 → 1.2.455

package/bin/summrise.js

@@ -60,6 +60,13 @@ exports.latestCdnVersion = latestCdnVersion;
 exports.latestNpmVersion = latestNpmVersion;
 exports.newestOf = newestOf;
 exports.latestReleaseVersion = latestReleaseVersion;
+exports.cdnBase = cdnBase;
+exports.componentUrl = componentUrl;
+exports.componentKey = componentKey;
+exports.componentPins = componentPins;
+exports.sha256File = sha256File;
+exports.resolveComponent = resolveComponent;
+exports.ensureElectron = ensureElectron;
 exports.statusReport = statusReport;
 exports.isBehind = isBehind;
 exports.behindBy = behindBy;
@@ -81,6 +88,7 @@ exports.rollbackVersionOk = rollbackVersionOk;
 const child_process_1 = require("child_process");
 const crypto = __importStar(require("crypto"));
 const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 const EXE_SRC = path.join(__dirname, "..", "summrise-agent.exe");
 // C1 (2026-08-28): the registry is the single source of truth for the install
@@ -797,6 +805,133 @@ function newestOf(a, b) {
 function latestReleaseVersion() {
     return newestOf(latestCdnVersion(), latestNpmVersion());
 }
+/** The release host this CLI already trusts for version checks. */
+function cdnBase() {
+    return (process.env.SUMMRISE_CDN || "https://agent.saisi.online").replace(/\/+$/, "");
+}
+/** Where a boxed component lives on that host. Pure — the tests pin it. */
+function componentUrl(name) {
+    return `${cdnBase()}/summrise-agent/${name}`;
+}
+/** The release manifest's key for a component's FILE name (they are not the same string). */
+function componentKey(fileName) {
+    if (fileName.startsWith("summrise-playwright"))
+        return "playwright";
+    if (fileName.startsWith("electron-"))
+        return "electron";
+    if (fileName.startsWith("cloudflared"))
+        return "cloudflared";
+    return null; // a file this release does not pin (e.g. fix-tunnel.ps1)
+}
+/** The manifest's component pins, or {} when it carries none (an older release). */
+function componentPins() {
+    const r = (0, child_process_1.spawnSync)("curl", ["-s", "-m", "5", `${cdnBase()}/api/version`], {
+        encoding: "utf8",
+        timeout: 8000,
+    });
+    if (r.status !== 0 || !r.stdout)
+        return {};
+    try {
+        const j = JSON.parse(r.stdout);
+        const c = j && typeof j.components === "object" ? j.components : null;
+        return c || {};
+    }
+    catch {
+        return {};
+    }
+}
+/** sha256 of a file. Read whole: the electron runtime is 115 MB and node's heap is fine with it. */
+function sha256File(p) {
+    return crypto.createHash("sha256").update(fs.readFileSync(p)).digest("hex");
+}
+/**
+ * A boxed component's local path: the copy inside the package if it is there,
+ * otherwise the release host's route for it, downloaded to a temp file.
+ *
+ * WHY THIS EXISTS (2026-09-23). The npm package carries NONE of the big
+ * binaries on purpose (cloudflared 54 MB, playwright 31 MB, electron 234 MB), so
+ * "not in the package" used to mean "you do not get it, ever" — setup printed a
+ * line and moved on. The same shape for cloudflared left a freshly migrated
+ * device with no tunnel, and a device with no tunnel is INVISIBLE TO THE
+ * CONSOLE while looking perfectly healthy from inside: an hour of that is what
+ * this function is for. The release host serves all three, and for cloudflared
+ * it proxies a PINNED upstream asset, which the agent's own sha256 pin then
+ * checks again on the path it uses.
+ *
+ * `null` when neither source works: every component here is optional to the
+ * AGENT, and a failed fetch must not fail the install.
+ */
+function resolveComponent(name, pkgPath) {
+    if (fs.existsSync(pkgPath))
+        return pkgPath;
+    const dest = path.join(fs.mkdtempSync(path.join(os.tmpdir(), "summrise-comp-")), name);
+    // -f: an HTTP error is a FAILURE, not a 404 page written to disk (the
+    // HTML-polluted download that round-54 exists to remember).
+    const r = (0, child_process_1.spawnSync)("curl", ["-fsSL", "-m", "300", "-o", dest, componentUrl(name)], { encoding: "utf8", timeout: 320000 });
+    if (r.status !== 0 || !fs.existsSync(dest) || fs.statSync(dest).size === 0) {
+        return null;
+    }
+    // VERIFY WHAT WAS FETCHED (grilling Q4). Until this existed, a worker serving
+    // different bytes would have been staged without complaint — the components are
+    // executed or loaded, so "the host said so" is not an anchor. The manifest that
+    // /api/version serves carries a sha256 per component (index/components.json,
+    // copied in at publish time); a pin that does not match REFUSES the component,
+    // because the failure it prevents is a device running bytes nobody published.
+    // No pin at all (an older release) is a warning, not a refusal: it must not make
+    // an install impossible.
+    const key = componentKey(name);
+    const pin = key ? (componentPins()[key] || {}).sha256 || "" : "";
+    if (pin) {
+        const got = sha256File(dest);
+        if (got !== pin) {
+            console.error(`setup: REFUSING ${name} — sha256 ${got.slice(0, 12)}… does not match the release manifest's ${pin.slice(0, 12)}… (the host served different bytes than it published)`);
+            return null;
+        }
+        console.log(`setup: ${name} verified against the release manifest (${pin.slice(0, 12)}…)`);
+    }
+    else if (key) {
+        console.log(`setup: ${name} fetched WITHOUT a manifest pin — not verified`);
+    }
+    console.log(`setup: ${name} fetched from the release host (not in the package)`);
+    return dest;
+}
+/**
+ * Ensure the desktop shell's electron RUNTIME. The shell's sources are ~90 KB
+ * and ship in the package; the runtime is 234 MB and deliberately does not.
+ *
+ * WHY IT IS FETCHED AND NOT `npx electron`: the release host serves a PINNED
+ * upstream proxy of the official build (v33.4.11 when this was written), so a
+ * device behind the GFW needs no GitHub access and no ELECTRON_MIRROR — the two
+ * things that made the hand-install on 2026-09-23 need a mirror variable at all.
+ * `npx electron` would also mean rewriting the launcher, which calls
+ * `<shell>\node_modules\electron\dist\electron.exe` directly.
+ *
+ * The zip's ROOT is the dist contents (`LICENSES.chromium.html` is its first
+ * entry — measured through the route, not assumed), so it expands into `dist`.
+ * Idempotent, and non-fatal: an install without a window still installs an agent.
+ */
+function ensureElectron() {
+    const elDir = path.join(DESK_DIR, "node_modules", "electron");
+    const dist = path.join(elDir, "dist");
+    if (fs.existsSync(path.join(dist, "electron.exe")))
+        return dist;
+    const zip = resolveComponent("electron-win32-x64.zip", path.join(__dirname, "..", "electron-win32-x64.zip"));
+    if (!zip)
+        return null;
+    fs.mkdirSync(dist, { recursive: true });
+    sh(`powershell -NoProfile -Command "Expand-Archive -Force -Path '${(0, exports.psq)(zip)}' -DestinationPath '${(0, exports.psq)(dist)}'"`);
+    if (!fs.existsSync(path.join(dist, "electron.exe")))
+        return null;
+    try {
+        // The electron package's own lookup file; the launcher does not need it, but
+        // anything that resolves the package the npm way will.
+        fs.writeFileSync(path.join(elDir, "path.txt"), "electron.exe");
+    }
+    catch {
+        /* best-effort */
+    }
+    return dist;
+}
 function statusReport(f) {
     const out = [];
     out.push(f.agentRunning === null
@@ -1467,8 +1602,8 @@ const commands = {
         // B2: stage the boxed playwright bundle (node_modules ONLY — node.exe is
         // NOT bundled; the system node detected below runs it). Single small
         // artifact in the npm package, Summrise version-locked.
-        const PW_ZIP = path.join(__dirname, "..", "summrise-playwright.zip");
-        if (fs.existsSync(PW_ZIP)) {
+        const PW_ZIP = resolveComponent("summrise-playwright.zip", path.join(__dirname, "..", "summrise-playwright.zip"));
+        if (PW_ZIP) {
             const pwDir = PW_DIR;
             fs.mkdirSync(pwDir, { recursive: true });
             sh(`powershell -NoProfile -Command "Expand-Archive -Force -Path '${(0, exports.psq)(PW_ZIP)}' -DestinationPath '${(0, exports.psq)(COMPONENTS_DIR)}'"`);
@@ -1503,7 +1638,7 @@ const commands = {
             }
         }
         else {
-            console.log("setup: summrise-playwright.zip not in package (browser tools disabled)");
+            console.error("setup: WARNING -- the playwright bundle could not be obtained (not in the package, and the release host did not serve it); browser tools stay disabled.");
         }
         // Node runtime: the device has node (npm works), but the agent runs as
         // SYSTEM which may not see the user PATH — resolve the ABSOLUTE node path
@@ -1526,12 +1661,19 @@ const commands = {
         }
         // C2: stage the boxed cloudflared binary into components/ (optional — local
         // mode works without it; only used when the user opts into public access).
-        const CF_SRC = path.join(__dirname, "..", "cloudflared.exe");
-        if (fs.existsSync(CF_SRC)) {
+        const CF_SRC = resolveComponent("cloudflared.exe", path.join(__dirname, "..", "cloudflared.exe"));
+        if (CF_SRC) {
             fs.mkdirSync(COMPONENTS_DIR, { recursive: true });
             fs.copyFileSync(CF_SRC, path.join(COMPONENTS_DIR, "cloudflared.exe"));
             console.log("setup: cloudflared staged (tunnel optional -- `summrise tunnel install` to enable)");
         }
+        else {
+            // This branch used to be SILENT, and that silence is what the 2026-09-23
+            // migration cost an hour of: a device with no cloudflared has no tunnel,
+            // and a device with no tunnel cannot be reached from the console at all
+            // while `summrise status` reports it healthy from inside.
+            console.error("setup: WARNING -- cloudflared could NOT be staged (not in the package, and the release host did not serve it); this device will be unreachable from the console until the binary can be fetched.");
+        }
         // P2-4: record the boxed-component versions (never fail-closed).
         writeBoxedVersions(DIR, path.join(__dirname, ".."));
         // round-330: Tauri summrise-desktop staging removed (retired).
@@ -1544,6 +1686,75 @@ const commands = {
         console.log(deskStaged > 0
             ? `setup: summrise-desktop-electron sources staged (${deskStaged} files)`
             : "setup: summrise-desktop-electron sources NOT staged -- the package did not ship them; the desktop shell will not update");
+        // …and the runtime those sources need. Sources without a runtime is a shell
+        // that cannot start: no window, and (before this) nothing in the output said
+        // why — the operator saw only an absent window.
+        const elDist = ensureElectron();
+        console.log(elDist
+            ? "setup: electron runtime ready for the desktop shell"
+            : "setup: WARNING -- the electron runtime could not be obtained (not in the package, and the release host did not serve it); start-desktop.ps1 will not open a window until it can be fetched.");
+        // ── Q9: leave a `summrise` COMMAND behind ──────────────────────────────────
+        // `npx summrise-agent setup` installs the service and nothing puts the CLI on
+        // PATH, so the very commands this output recommends (`summrise update`,
+        // `summrise status`) are command-not-found — measured on d1 on 2026-09-23.
+        // Installing THIS version by name keeps it deterministic and uses npm's own
+        // shims rather than hand-written ones; when npm cannot, say the command.
+        {
+            const selfVer = String(require("../package.json").version || "");
+            const pfx = (0, child_process_1.spawnSync)("npm", ["prefix", "-g"], { encoding: "utf8", shell: true });
+            const pre = pfx.status === 0 ? String(pfx.stdout || "").trim() : "";
+            if (selfVer && pre) {
+                const inst = (0, child_process_1.spawnSync)("npm", [
+                    "i",
+                    "-g",
+                    `summrise-agent@${selfVer}`,
+                    "--prefix",
+                    pre,
+                    "--registry=https://registry.npmjs.org/",
+                    "--no-audit",
+                    "--no-fund",
+                ], { encoding: "utf8", shell: true, timeout: 300000 });
+                console.log(inst.status === 0
+                    ? `setup: ${selfVer} installed globally -- \`summrise status\` works from any shell`
+                    : `setup: WARNING -- could not install the CLI globally; run: npm i -g summrise-agent@${selfVer}`);
+            }
+            else {
+                console.log(`setup: WARNING -- could not resolve npm's global prefix; run: npm i -g summrise-agent@${selfVer || "<version>"}`);
+            }
+        }
+        // ── the desktop shell's task: ONLOGON + a 5-minute watchdog ────────────────
+        // `summrise autostart` has always said "the desktop task comes from the
+        // installer", and the NSIS installer is RETIRED — so NOTHING created it. Measured
+        // on d1: the window vanished with the console that launched it and
+        // SummriseDesktop did not exist at all. The shape is the app's own, written to a
+        // .ps1 so it can be read rather than escaped into one unreadable line:
+        // ensure-desktop.ps1 exits when electron is already alive (the watchdog never
+        // steals focus), the .vbs wrapper runs it with no console flash, and the 5-minute
+        // repetition is what reborns a dead shell.
+        try {
+            const reg = path.join(SCRIPTS_DIR, "register-desktop-task.ps1");
+            fs.writeFileSync(reg, [
+                "# written by `summrise setup` -- the desktop shell's ONLOGON task + watchdog.",
+                "$ErrorActionPreference = 'Stop'",
+                `$q = '${(0, exports.psq)(DIR)}'`,
+                `$en = Join-Path $q 'scripts\\ensure-desktop.ps1'`,
+                `$vb = Join-Path $q 'scripts\\desktop-pulse.vbs'`,
+                `Set-Content -Path $en -Value ('if (Get-Process electron -ErrorAction SilentlyContinue) { exit }; & powershell -NoProfile -ExecutionPolicy Bypass -File "' + $q + '\\scripts\\start-desktop.ps1"') -Force`,
+                `Set-Content -Path $vb -Value ('CreateObject("WScript.Shell").Run "powershell -NoProfile -ExecutionPolicy Bypass -File " & Chr(34) & "' + $en + '" & Chr(34), 0, False') -Force`,
+                `$da = New-ScheduledTaskAction -Execute 'wscript.exe' -Argument ('"' + $vb + '"') -WorkingDirectory $q`,
+                `$dt1 = New-ScheduledTaskTrigger -AtLogOn`,
+                `$dw1 = New-ScheduledTaskTrigger -Once -At (Get-Date).AddMinutes(3) -RepetitionInterval (New-TimeSpan -Minutes 5)`,
+                `$pr = New-ScheduledTaskPrincipal -UserId ('{0}\\{1}' -f $env:USERDOMAIN, $env:USERNAME) -LogonType Interactive -RunLevel Highest`,
+                `$st = New-ScheduledTaskSettingsSet -ExecutionTimeLimit (New-TimeSpan -Minutes 10) -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -StartWhenAvailable -MultipleInstances IgnoreNew`,
+                `Register-ScheduledTask SummriseDesktop -Action $da -Trigger @($dt1,$dw1) -Principal $pr -Settings $st -Force | Out-Null`,
+                `Start-ScheduledTask -TaskName SummriseDesktop`,
+            ].join("\r\n") + "\r\n");
+            sh(`powershell -NoProfile -ExecutionPolicy Bypass -File '${(0, exports.psq)(reg)}'`);
+            console.log("setup: SummriseDesktop registered (logon + a 5-minute watchdog) and started");
+        }
+        catch {
+            console.log(`setup: WARNING -- could not register SummriseDesktop; run: powershell -File "${SCRIPTS_DIR}\\register-desktop-task.ps1"`);
+        }
         // Layout v2: write the start-desktop.ps1 launcher into scripts\ (the
         // SummriseDesktop onlogon task + desktop Summrise.lnk both call it). Was never
         // written before — a real gap that left the shell unlaunchable.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "summrise-agent",
-  "version": "1.2.453",
+  "version": "1.2.455",
   "description": "Summrise Agent — Windows device MCP server (terminal/SSH/serial) + panel. Self-hosted npm distribution.",
   "//build": "唯一构建路径：在本目录执行 npm run build。它是自包含的：经 npm exec 按需拉取 typescript@5，无需预装任何 node_modules（干净检出可跑；旧脚本引用 ../summrise-desktop-electron/node_modules/.bin/tsc，干净检出必 ENOENT）。必须用 npm exec --package … -- tsc 的形式：npx 会吃掉传给 tsc 的 -p/--outDir 等参数（round-435：npx 写法从未真正跑通过）。先编 electron TS（--noCheck 纯 emit，与 release.yml 一致）同步两处 src/*.js，再编 src/summrise.ts 到 bin/summrise.js 并校验 round-298 标记（弱 oracle，只证某次构建发生，新鲜性由 publish-release.sh 的 tsc 重编 + cmp 门保证）。",
   "bin": {