lark-agent-bot 0.3.11 → 0.3.13

package/README.md

@@ -12,6 +12,12 @@ npm install -g lark-agent-bot
 The postinstall step downloads the prebuilt binary for your platform from
 [GitHub Releases](https://github.com/ClaymanTwinkle/lark-agent-bot/releases).
 
+If `ffmpeg` is not on your `PATH`, it also downloads a static ffmpeg build
+([ffmpeg-static](https://github.com/eugeneware/ffmpeg-static), checksum-verified)
+to `~/.lark-agent-bot/bin`, outside the package so upgrades keep it; voice
+messages and video covers need it. Set `LARK_AGENT_BOT_SKIP_FFMPEG=1` to skip
+this step.
+
 ## Usage
 
 ```bash

package/install.js

@@ -2,8 +2,10 @@
 
 "use strict";
 
-const { execSync } = require("child_process");
+const { execFileSync, execSync } = require("child_process");
+const crypto = require("crypto");
 const fs = require("fs");
+const os = require("os");
 const path = require("path");
 const https = require("https");
 const http = require("http");
@@ -15,6 +17,22 @@ const NAME = "lark-agent-bot";
 
 const GITHUB_REPO = "ClaymanTwinkle/lark-agent-bot";
 
+// Voice messages and video covers need ffmpeg. When it isn't on PATH, a
+// static build from ffmpeg-static goes to ~/.lark-agent-bot/bin, where
+// lark-agent-bot also looks. That directory is outside the npm package, so
+// upgrades (which replace the package directory) keep it. Set
+// LARK_AGENT_BOT_SKIP_FFMPEG=1 to skip.
+const FFMPEG_REPO = "eugeneware/ffmpeg-static";
+const FFMPEG_RELEASE = "b6.1.1";
+// SHA-256 of each ffmpeg-<platform>-<arch>.gz asset in FFMPEG_RELEASE.
+const FFMPEG_SHA256 = {
+  "darwin-arm64": "8923876afa8db5585022d7860ec7e589af192f441c56793971276d450ed3bbfa",
+  "darwin-x64": "929b375c1182d956c51f7ac25e0b2b0411fb01f6f407aa15c9758efeb4242106",
+  "linux-arm64": "754a678672298bc68156adff58aa7385a592c2b30b1d0ae8750c45c915c4bac0",
+  "linux-x64": "bfe8a8fc511530457b528c48d77b5737527b504a3797a9bc4866aeca69c2dffa",
+  "win32-x64": "8883a3dffbd0a16cf4ef95206ea05283f78908dbfb118f73c83f4951dcc06d77",
+};
+
 const PLATFORM_MAP = {
   darwin: "darwin",
   linux: "linux",
@@ -149,11 +167,91 @@ function isNewerOrEqual(installed, expected) {
   return a.preNum >= b.preNum;
 }
 
+function hasFFmpegOnPath() {
+  try {
+    execFileSync("ffmpeg", ["-version"], { stdio: "ignore", timeout: 10000 });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function ffmpegToolDir() {
+  return path.join(os.homedir(), ".lark-agent-bot", "bin");
+}
+
+function ffmpegHint(toolDir) {
+  return (
+    "[lark-agent-bot] Voice messages and video covers need ffmpeg. Install it yourself:\n" +
+    "  Windows: winget install Gyan.FFmpeg\n" +
+    "  macOS:   brew install ffmpeg\n" +
+    "  Linux:   sudo apt install ffmpeg (or your distro's package manager)\n" +
+    `  or put an ffmpeg executable in ${toolDir}`
+  );
+}
+
+// installFFmpeg never fails the install: without ffmpeg lark-agent-bot still
+// works, it only loses voice conversion and video covers.
+async function installFFmpeg(toolDir) {
+  if (process.env.LARK_AGENT_BOT_SKIP_FFMPEG) {
+    console.log("[lark-agent-bot] LARK_AGENT_BOT_SKIP_FFMPEG is set, skipping ffmpeg.");
+    return;
+  }
+  const ffmpegPath = path.join(toolDir, process.platform === "win32" ? "ffmpeg.exe" : "ffmpeg");
+  if (fs.existsSync(ffmpegPath)) {
+    console.log(`[lark-agent-bot] ffmpeg already at ${ffmpegPath}, skipping.`);
+    return;
+  }
+  if (hasFFmpegOnPath()) {
+    console.log("[lark-agent-bot] ffmpeg found on PATH, skipping.");
+    return;
+  }
+
+  const key = `${process.platform}-${process.arch}`;
+  const sha256 = FFMPEG_SHA256[key];
+  if (!sha256) {
+    console.warn(`[lark-agent-bot] No prebuilt ffmpeg for ${key}.`);
+    console.warn(ffmpegHint(toolDir));
+    return;
+  }
+
+  const url = `https://github.com/${FFMPEG_REPO}/releases/download/${FFMPEG_RELEASE}/ffmpeg-${key}.gz`;
+  const tmpPath = `${ffmpegPath}.download`;
+  try {
+    console.log(`[lark-agent-bot] ffmpeg not found, downloading from ${url}`);
+    const gz = await fetch(url);
+    fs.mkdirSync(toolDir, { recursive: true });
+    const actual = crypto.createHash("sha256").update(gz).digest("hex");
+    if (actual !== sha256) {
+      throw new Error(`checksum mismatch: got ${actual}, want ${sha256}`);
+    }
+    fs.writeFileSync(tmpPath, zlib.gunzipSync(gz), { mode: 0o755 });
+    fs.renameSync(tmpPath, ffmpegPath);
+    if (process.platform === "darwin") {
+      try {
+        execSync(`xattr -d com.apple.quarantine "${ffmpegPath}"`, { stdio: "pipe" });
+      } catch {
+        // xattr fails if the attribute doesn't exist, which is fine
+      }
+    }
+    console.log(`[lark-agent-bot] Installed ffmpeg to ${ffmpegPath}`);
+  } catch (err) {
+    try { fs.unlinkSync(tmpPath); } catch {}
+    console.warn(`[lark-agent-bot] Could not install ffmpeg: ${err.message}`);
+    console.warn(ffmpegHint(toolDir));
+  }
+}
+
 async function main() {
+  const binDir = path.join(__dirname, "bin");
+  await installBinary(binDir);
+  await installFFmpeg(ffmpegToolDir());
+}
+
+async function installBinary(binDir) {
   const { platform, arch, ext, filename } = getPlatformInfo();
   console.log(`[lark-agent-bot] Platform: ${platform}/${arch}`);
 
-  const binDir = path.join(__dirname, "bin");
   fs.mkdirSync(binDir, { recursive: true });
 
   const binaryName = platform === "windows" ? `${NAME}.exe` : NAME;
@@ -206,11 +304,15 @@ async function main() {
   console.log(`[lark-agent-bot] Installed to ${binaryPath}`);
 }
 
-main().catch((err) => {
-  console.error(err.message);
-  console.error(
-    "[lark-agent-bot] Installation failed. You can install manually:\n" +
-      `  https://github.com/${GITHUB_REPO}/releases/tag/${VERSION}`
-  );
-  process.exit(1);
-});
+if (require.main === module) {
+  main().catch((err) => {
+    console.error(err.message);
+    console.error(
+      "[lark-agent-bot] Installation failed. You can install manually:\n" +
+        `  https://github.com/${GITHUB_REPO}/releases/tag/${VERSION}`
+    );
+    process.exit(1);
+  });
+}
+
+module.exports = { installFFmpeg };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lark-agent-bot",
-  "version": "0.3.11",
+  "version": "0.3.13",
   "description": "Bridge local AI coding agents (Claude Code, Codex, Cursor, Gemini CLI, ...) to Feishu / Lark",
   "keywords": [
     "feishu",