@micsushi/agent-hotline 1.0.0 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@micsushi/agent-hotline",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Local read-aloud hooks and tray app for AI coding agents.",
   "bin": {
     "ah": "packages/backend/bin/agent-hotline.js",
@@ -14,6 +14,7 @@
     "packages/backend/bin/",
     "packages/backend/src/",
     "packages/backend/skills/",
+    "packages/backend/web/",
     "packages/backend/package.json"
   ],
   "publishConfig": {
@@ -33,6 +34,10 @@
     "install-hook": "node scripts/install-hook.js",
     "install-skill": "node scripts/install-skill.js",
     "install-hotline": "node packages/backend/bin/agent-hotline.js install",
+    "stage-web": "node scripts/stage-web.mjs",
+    "prepack": "node scripts/stage-web.mjs",
+    "build:backend-sea": "node scripts/build-backend-sea.mjs",
+    "sync-desktop-version": "node scripts/sync-desktop-version.mjs",
     "test": "npm --prefix packages/backend test && npm --workspace @agent-hotline/desktop run test",
     "lint": "eslint . && npm run rust:clippy",
     "lint:fix": "eslint . --fix",
@@ -48,8 +53,10 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
+    "esbuild": "^0.28.1",
     "eslint": "^10.5.0",
     "globals": "^17.6.0",
+    "postject": "^1.0.0-alpha.6",
     "prettier": "^3.8.4"
   },
   "repository": {

package/packages/backend/src/server.js

@@ -15,7 +15,7 @@ const { createAudioCacheStore } = require("./audio-cache-store");
 const PORT = Number(process.env.AGENT_HOTLINE_PORT || process.env.VOICE_QUESTION_LOOP_PORT || 4777);
 const HOST = "127.0.0.1";
 const ROOT = path.resolve(__dirname, "..");
-const DATA_DIR = path.join(ROOT, "data");
+const DATA_DIR = process.env.AGENT_HOTLINE_DATA_DIR || path.join(ROOT, "data");
 const QUESTIONS_FILE = process.env.QUESTION_FILE || path.join(DATA_DIR, "questions.json");
 const REQUEST_LIMIT_BYTES = 1_000_000;
 const AUDIO_BODY_LIMIT_BYTES = 96 * 1024 * 1024;
@@ -463,6 +463,68 @@ function getPathname(req) {
   return new URL(req.url, "http://127.0.0.1").pathname;
 }
 
+// Built desktop UI, served so `agent-hotline run` opens the full app in a
+// browser. The npm package ships a pruned copy under web/ (no heavy local-TTS
+// assets); a source checkout uses the full desktop/dist build. Absent in either
+// case, routes fall back to the inline page() console.
+const WEB_CANDIDATES = [
+  path.resolve(__dirname, "../web"),
+  path.resolve(__dirname, "../../desktop/dist")
+];
+
+function webDir() {
+  for (const dir of WEB_CANDIDATES) {
+    try {
+      if (fs.statSync(path.join(dir, "index.html")).isFile()) return dir;
+    } catch {
+      // try next candidate
+    }
+  }
+  return null;
+}
+
+const STATIC_CONTENT_TYPES = {
+  ".html": "text/html; charset=utf-8",
+  ".js": "text/javascript; charset=utf-8",
+  ".mjs": "text/javascript; charset=utf-8",
+  ".css": "text/css; charset=utf-8",
+  ".json": "application/json; charset=utf-8",
+  ".svg": "image/svg+xml",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".webp": "image/webp",
+  ".ico": "image/x-icon",
+  ".woff": "font/woff",
+  ".woff2": "font/woff2",
+  ".ttf": "font/ttf",
+  ".wasm": "application/wasm",
+  ".map": "application/json; charset=utf-8"
+};
+
+// Resolve a request path to a file inside the active web dir, refusing anything
+// that escapes the directory. Returns the absolute path or null.
+function resolveStaticFile(pathname) {
+  const root = webDir();
+  if (!root) return null;
+  const rel = decodeURIComponent(pathname).replace(/^\/+/, "");
+  const target = path.resolve(root, rel);
+  if (target !== root && !target.startsWith(root + path.sep)) return null;
+  try {
+    if (fs.statSync(target).isFile()) return target;
+  } catch {
+    return null;
+  }
+  return null;
+}
+
+function serveStaticFile(res, filePath) {
+  const type =
+    STATIC_CONTENT_TYPES[path.extname(filePath).toLowerCase()] || "application/octet-stream";
+  res.writeHead(200, { "Content-Type": type });
+  fs.createReadStream(filePath).pipe(res);
+}
+
 function page() {
   return `<!doctype html>
 <html lang="en">
@@ -584,22 +646,23 @@ function page() {
 }
 
 function createServer(options = {}) {
+  const dataDir = options.dataDir || DATA_DIR;
   const settingsStore =
     options.settingsStore ||
     createSettingsStore({
-      dataDir: options.dataDir,
+      dataDir,
       settingsPath: options.settingsPath
     });
   const queueStore =
     options.queueStore ||
     createSpeechQueueStore({
-      dataDir: options.dataDir,
+      dataDir,
       filePath: options.queuePath
     });
   const questionStore =
     options.questionStore ||
     createQuestionStore({
-      dataDir: options.questionDataDir || options.dataDir,
+      dataDir: options.questionDataDir || dataDir,
       questionsFile: options.questionsFile,
       answersFile: options.answersFile,
       ensureFiles: options.ensureQuestionFiles
@@ -608,7 +671,7 @@ function createServer(options = {}) {
   const audioCacheStore =
     options.audioCacheStore ||
     createAudioCacheStore({
-      dataDir: options.dataDir,
+      dataDir,
       cacheDir: options.audioCacheDir,
       maxBytes: options.audioMaxBytes,
       getMaxBytes: options.audioMaxBytes
@@ -617,8 +680,7 @@ function createServer(options = {}) {
     });
 
   const spoolStore =
-    options.spoolStore ||
-    createSpoolStore({ dataDir: options.dataDir, filePath: options.spoolPath });
+    options.spoolStore || createSpoolStore({ dataDir, filePath: options.spoolPath });
   try {
     spoolStore.drain((item) => queueStore.enqueue(item));
   } catch {}
@@ -634,11 +696,25 @@ function createServer(options = {}) {
       const pathname = getPathname(req);
 
       if (req.method === "GET" && pathname === "/") {
+        const index = resolveStaticFile("/index.html");
+        if (index) {
+          serveStaticFile(res, index);
+          return;
+        }
         res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
         res.end(page());
         return;
       }
 
+      // Tell the browser-served UI to call this same origin for the API, so a
+      // custom --port still works. The bundled static config.json (used by the
+      // packaged desktop app) is overridden here only for HTTP requests.
+      if (req.method === "GET" && pathname === "/config.json") {
+        const host = req.headers.host || `${HOST}:${PORT}`;
+        sendJson(res, 200, { backendUrl: `http://${host}` });
+        return;
+      }
+
       if (req.method === "GET" && (pathname === "/health" || pathname === "/api/health")) {
         sendJson(res, 200, { ok: true, service: "agent-hotline", host: HOST });
         return;
@@ -901,6 +977,16 @@ function createServer(options = {}) {
         return;
       }
 
+      // Static assets for the built UI (JS/CSS/fonts/etc). API paths never reach
+      // here, so this only serves the desktop dist bundle.
+      if (req.method === "GET" && !pathname.startsWith("/api/")) {
+        const file = resolveStaticFile(pathname);
+        if (file) {
+          serveStaticFile(res, file);
+          return;
+        }
+      }
+
       throw createHttpError(404, "not_found", "Not found");
     } catch (error) {
       if (!error.status && /Queue item not found/.test(error.message)) {

package/packages/backend/src/settings-store.js

@@ -8,6 +8,7 @@ const READ_BEHAVIORS = new Set(["manual", "auto"]);
 const TTS_ENGINES = new Set(["webview", "kokoro", "kokoro-ts"]);
 const NOTIFICATION_OPENS = new Set(["full", "mini"]);
 const AUDIO_CACHE_LIMIT_MAX_MB = 100000;
+const DEFAULT_RATE = 0.9;
 
 const DEFAULT_SETTINGS = Object.freeze({
   readBehavior: "manual",
@@ -16,7 +17,7 @@ const DEFAULT_SETTINGS = Object.freeze({
   voice: "",
   audioOutputDeviceId: "",
   kokoroVoice: "af_heart",
-  rate: 0.92,
+  rate: DEFAULT_RATE,
   volume: 1,
   skipRules: Object.freeze({
     codeBlocks: true,
@@ -32,7 +33,9 @@ const DEFAULT_SETTINGS = Object.freeze({
   notifyOnNewReply: false,
   notificationOpens: "full",
   highlightSpokenText: false,
-  audioCacheLimitMb: 1024
+  audioCacheLimitMb: 1024,
+  startupSplash: true,
+  startupJingle: true
 });
 
 function getDefaultDataDir(env = process.env, platform = process.platform) {
@@ -79,6 +82,11 @@ function numberInRangeOrDefault(value, fallback, min, max) {
   return number >= min && number <= max ? number : fallback;
 }
 
+function normalizeRate(value, fallback) {
+  const rate = numberInRangeOrDefault(value, fallback, 0.1, 10);
+  return rate === 0.92 ? DEFAULT_RATE : rate;
+}
+
 function normalizeSettings(input) {
   const source = isPlainObject(input) ? input : {};
   const defaults = DEFAULT_SETTINGS;
@@ -93,7 +101,7 @@ function normalizeSettings(input) {
     voice: stringOrDefault(source.voice, defaults.voice),
     audioOutputDeviceId: stringOrDefault(source.audioOutputDeviceId, defaults.audioOutputDeviceId),
     kokoroVoice: stringOrDefault(source.kokoroVoice, defaults.kokoroVoice),
-    rate: numberInRangeOrDefault(source.rate, defaults.rate, 0.1, 10),
+    rate: normalizeRate(source.rate, defaults.rate),
     volume: numberInRangeOrDefault(source.volume, defaults.volume, 0, 1),
     skipRules: {
       codeBlocks: booleanOrDefault(sourceSkipRules.codeBlocks, defaults.skipRules.codeBlocks),
@@ -119,7 +127,9 @@ function normalizeSettings(input) {
       defaults.audioCacheLimitMb,
       10,
       AUDIO_CACHE_LIMIT_MAX_MB
-    )
+    ),
+    startupSplash: booleanOrDefault(source.startupSplash, defaults.startupSplash),
+    startupJingle: booleanOrDefault(source.startupJingle, defaults.startupJingle)
   };
 }