local-operator-ui 0.19.1 → 0.19.2

package/out/main/index.js

@@ -4047,6 +4047,22 @@ function registerDesktopIPC(window, expectedUrl, request, streams, media, notifi
     });
   }
 }
+function presentWindow(window, show) {
+  if (show === "never") return;
+  if (window.isMinimized()) window.restore();
+  if (show === "inactive") window.showInactive();
+  else window.show();
+}
+function raiseWindow(window, show) {
+  if (show === "never") return;
+  if (window.isMinimized()) window.restore();
+  if (show === "inactive") {
+    window.showInactive();
+    return;
+  }
+  window.show();
+  window.focus();
+}
 const NOTIFY_TTL_MS = 10 * 60 * 1e3;
 const MAX_DEDUPE_KEYS = 2048;
 const CONTRACT_PROBE_ATTEMPTS = 3;
@@ -4065,9 +4081,10 @@ function gateBody(kind, gateTitle, gateDetail) {
   return subject || GATE_BODIES[kind] || GATE_BODIES.approval;
 }
 class DesktopNotifier {
-  constructor(window, request) {
+  constructor(window, request, windowRaise = "focus") {
     this.window = window;
     this.request = request;
+    this.windowRaise = windowRaise;
   }
   delivered = /* @__PURE__ */ new Map();
   /** Last known frontend epoch per session, to key dedupe on owner epoch. */
@@ -4256,6 +4273,7 @@ class DesktopNotifier {
   /** Called by the stream relay for every parsed frame it forwards. */
   observe(sessionId2, frame) {
     if (!this.canNotify) return;
+    if (this.windowRaise === "never") return;
     if (frame.type === "snapshot") {
       this.epochs.set(sessionId2, frame.payload.frontend.epoch);
       const gate = frame.payload.frontend.snapshot.pending_gate;
@@ -4479,9 +4497,7 @@ class DesktopNotifier {
     notification.on("click", () => {
       const target2 = this.window();
       if (!target2) return;
-      if (target2.isMinimized()) target2.restore();
-      target2.show();
-      target2.focus();
+      raiseWindow(target2, this.windowRaise);
       target2.webContents.send("desktop-open-conversation", { sessionId: sessionId2 });
     });
     notification.show();
@@ -7522,6 +7538,105 @@ ${pipRun.stderr.trim()}`,
     }
   }
 }
+const WINDOW_MODES = ["normal", "headless", "inactive"];
+const WINDOW_MODE_ENV = "LOCAL_OPERATOR_UI_WINDOW_MODE";
+const WINDOW_SIZE_ENV = "LOCAL_OPERATOR_UI_WINDOW_SIZE";
+const WINDOW_MODE_FLAG = "--window-mode";
+const WINDOW_SIZE_FLAG = "--window-size";
+const WINDOW_MIN_WIDTH = 800;
+const WINDOW_MIN_HEIGHT = 600;
+const WINDOW_MAX_EDGE = 16384;
+const DEFAULT_WINDOW_WIDTH = 1380;
+const DEFAULT_WINDOW_HEIGHT = 900;
+const WINDOW_BEHAVIOUR = {
+  normal: { show: "focus", focusable: true, backgroundThrottling: true },
+  inactive: { show: "inactive", focusable: true, backgroundThrottling: false },
+  headless: { show: "never", focusable: false, backgroundThrottling: false }
+};
+function readFlag(argv, name) {
+  for (let index = 0; index < argv.length; index += 1) {
+    const argument = argv[index];
+    if (argument === name) {
+      const next = argv[index + 1];
+      return { found: true, value: next?.startsWith("--") ? void 0 : next };
+    }
+    if (argument.startsWith(`${name}=`)) {
+      return { found: true, value: argument.slice(name.length + 1) };
+    }
+  }
+  return { found: false, value: void 0 };
+}
+function parseWindowMode(value) {
+  if (value === void 0) return null;
+  const normalized = value.trim().toLowerCase();
+  return WINDOW_MODES.includes(normalized) ? normalized : null;
+}
+const WINDOW_SIZE_PATTERN = /^(\d+)\s*[x×]\s*(\d+)$/i;
+function parseWindowSize(value) {
+  if (value === void 0) return null;
+  const match = value.trim().match(WINDOW_SIZE_PATTERN);
+  if (!match) return null;
+  const width = Number(match[1]);
+  const height = Number(match[2]);
+  if (width <= 0 || height <= 0) return null;
+  return { width, height };
+}
+function resolveWindowLaunchPlan(input = {}) {
+  const env = input.env ?? {};
+  const argv = input.argv ?? [];
+  const problems = [];
+  const modeFlag = readFlag(argv, WINDOW_MODE_FLAG);
+  const modeRaw = modeFlag.found ? modeFlag.value : env[WINDOW_MODE_ENV];
+  const parsedMode = parseWindowMode(modeRaw);
+  if (modeFlag.found && modeFlag.value === void 0) {
+    problems.push(
+      `${WINDOW_MODE_FLAG} needs a value: ${WINDOW_MODES.join("|")}`
+    );
+  } else if (parsedMode === null && modeRaw !== void 0) {
+    problems.push(
+      `${modeFlag.found ? WINDOW_MODE_FLAG : WINDOW_MODE_ENV}="${modeRaw}" is not one of ${WINDOW_MODES.join("|")}; using normal`
+    );
+  }
+  const mode = parsedMode ?? "normal";
+  const sizeFlag = readFlag(argv, WINDOW_SIZE_FLAG);
+  const sizeRaw = sizeFlag.found ? sizeFlag.value : env[WINDOW_SIZE_ENV];
+  const parsedSize = parseWindowSize(sizeRaw);
+  if (sizeFlag.found && sizeFlag.value === void 0) {
+    problems.push(`${WINDOW_SIZE_FLAG} needs a value: <width>x<height>`);
+  } else if (parsedSize === null && sizeRaw !== void 0) {
+    problems.push(
+      `${sizeFlag.found ? WINDOW_SIZE_FLAG : WINDOW_SIZE_ENV}="${sizeRaw}" is not <width>x<height>; using ${DEFAULT_WINDOW_WIDTH}x${DEFAULT_WINDOW_HEIGHT}`
+    );
+  }
+  const requested = parsedSize ?? {
+    width: DEFAULT_WINDOW_WIDTH,
+    height: DEFAULT_WINDOW_HEIGHT
+  };
+  const width = Math.min(
+    Math.max(requested.width, WINDOW_MIN_WIDTH),
+    WINDOW_MAX_EDGE
+  );
+  const height = Math.min(
+    Math.max(requested.height, WINDOW_MIN_HEIGHT),
+    WINDOW_MAX_EDGE
+  );
+  if (width !== requested.width || height !== requested.height) {
+    problems.push(
+      `window size ${requested.width}x${requested.height} clamped to ${width}x${height} (floor ${WINDOW_MIN_WIDTH}x${WINDOW_MIN_HEIGHT}, ceiling ${WINDOW_MAX_EDGE})`
+    );
+  }
+  return {
+    mode,
+    ...WINDOW_BEHAVIOUR[mode],
+    width,
+    height,
+    problems
+  };
+}
+function describeWindowLaunch(plan) {
+  const behaviour = plan.show === "never" ? "window created and never shown" : plan.show === "inactive" ? "window shown without activating the app" : "window shown and focused";
+  return `window mode ${plan.mode}: ${plan.width}x${plan.height}, ${behaviour}, page throttling ${plan.backgroundThrottling ? "on" : "off"}`;
+}
 const BASE64_FILE_EXTENSIONS = ["csv", "tsv", "xls", "xlsx", "ods"];
 electron.app.setName("Local Operator");
 const image = electron.nativeImage.createFromPath(icon);
@@ -7659,16 +7774,28 @@ function createApplicationMenu() {
 }
 function createWindow() {
   const mainWindow2 = new electron.BrowserWindow({
-    width: 1380,
-    height: 900,
+    width: windowLaunch.width,
+    height: windowLaunch.height,
     // The layout is verified down to 800x600 and not below: the app rail,
     // the per-route list pane and the canvas all have their own minimums,
     // and past this point they start taking room from each other rather
     // than from the window. The auth popup below sets its own floor the
-    // same way.
-    minWidth: 800,
-    minHeight: 600,
+    // same way. The floor lives in `window-mode.ts` because that is what
+    // clamps a requested `--window-size` to it.
+    minWidth: WINDOW_MIN_WIDTH,
+    minHeight: WINDOW_MIN_HEIGHT,
     show: false,
+    /*
+     * `headless` is never shown, so no key window can be made out of it; this
+     * keeps that true of the window object itself rather than of the code
+     * path. It is NOT a safety net against a stray `show()`: on macOS
+     * `NativeWindowMac::Show()` activates the app for any non-panel window
+     * whatever `focusable` says (measured — a non-focusable window, shown,
+     * made the app frontmost while `isFocused()` still read false). The guard
+     * against a window being raised is that `window-raise.ts` is the only
+     * module that raises one, and this flag is the second line of defence.
+     */
+    focusable: windowLaunch.focusable,
     autoHideMenuBar: true,
     title: "Local Operator",
     icon,
@@ -7682,7 +7809,17 @@ function createWindow() {
       nodeIntegration: false,
       contextIsolation: true,
       webSecurity: true,
-      allowRunningInsecureContent: false
+      allowRunningInsecureContent: false,
+      // Chromium throttles timers and animation frames in a window it
+      // believes nobody is looking at, which would make a headless test
+      // run measure a different app than the one users get. Measured on
+      // Electron 35 / macOS: a `show: false` window does keep
+      // `visibilityState` at "visible" and keeps rAF ticking, but that
+      // comes from Electron's MacWebContentsOcclusion default rather
+      // than from anything this app controls, so hold the page at full
+      // rate explicitly instead of trusting the platform. `normal`
+      // keeps Electron's own default.
+      backgroundThrottling: windowLaunch.backgroundThrottling
     }
   });
   mainWindow2.webContents.on("console-message", (_event, level, message) => {
@@ -7691,7 +7828,16 @@ function createWindow() {
     write.call(logger, `[renderer] ${message}`, LogFileType.BACKEND);
   });
   mainWindow2.on("ready-to-show", () => {
-    mainWindow2.show();
+    presentWindow(mainWindow2, windowLaunch.show);
+    if (windowLaunch.mode === "normal") return;
+    setTimeout(() => {
+      if (!mainWindow2 || mainWindow2.isDestroyed()) return;
+      const [width, height] = mainWindow2.getSize();
+      const [contentWidth, contentHeight] = mainWindow2.getContentSize();
+      console.log(
+        `[window-mode] state: visible=${mainWindow2.isVisible()} focused=${mainWindow2.isFocused()} focusable=${mainWindow2.isFocusable()} size=${width}x${height} content=${contentWidth}x${contentHeight}`
+      );
+    }, 1500);
   });
   mainWindow2.webContents.setWindowOpenHandler((details) => {
     const url = new URL(details.url);
@@ -7762,6 +7908,17 @@ function createWindow() {
 }
 const backendService = new BackendServiceManager();
 const backendInstaller = new BackendInstaller();
+const windowLaunch = resolveWindowLaunchPlan({
+  env: process.env,
+  argv: process.argv
+});
+for (const problem of windowLaunch.problems) {
+  logger.warn(`[window-mode] ${problem}`, LogFileType.BACKEND);
+  console.log(`[window-mode] ${problem}`);
+}
+if (windowLaunch.mode !== "normal") {
+  console.log(`[window-mode] ${describeWindowLaunch(windowLaunch)}`);
+}
 let mainWindow = null;
 const zoomInFromEvent = () => {
   if (mainWindow) {
@@ -7789,8 +7946,7 @@ if (!gotTheLock) {
 } else {
   electron.app.on("second-instance", (_event, commandLine) => {
     if (mainWindow) {
-      if (mainWindow.isMinimized()) mainWindow.restore();
-      mainWindow.focus();
+      raiseWindow(mainWindow, windowLaunch.show);
     }
   });
 }
@@ -7810,7 +7966,11 @@ electron.app.whenReady().then(async () => {
     () => mainWindow,
     (input) => backendService.requestDesktop(input)
   );
-  const desktopNotifier = new DesktopNotifier(() => mainWindow, sendDesktop);
+  const desktopNotifier = new DesktopNotifier(
+    () => mainWindow,
+    sendDesktop,
+    windowLaunch.show
+  );
   backendService.onBackendReady(() => {
     void desktopNotifier.refreshNotificationContract();
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "local-operator-ui",
-  "version": "0.19.1",
+  "version": "0.19.2",
   "productName": "Local Operator",
   "description": "User interface for AI agent assistants that run Python code safely on your device through an intuitive chat interface. Supports local and cloud LLM models with built-in security features.",
   "main": "./out/main/index.js",
@@ -50,7 +50,9 @@
   },
   "scripts": {
     "start": "electron-vite preview",
+    "app:headless": "LOCAL_OPERATOR_UI_WINDOW_MODE=headless electron .",
     "dev": "npx dotenv-cli -e .env -- bash -c 'export $(grep -v '^#' .env | xargs) && electron-vite dev'",
+    "dev:headless": "LOCAL_OPERATOR_UI_WINDOW_MODE=headless pnpm dev",
     "build": "electron-vite build",
     "prebuild:npm": "rm -rf out/main out/preload",
     "build:npm": "LOCAL_OPERATOR_UI_NO_BYTECODE=true electron-vite build",
@@ -65,7 +67,7 @@
     "check-types:main": "tsc --noEmit -p tsconfig.node.json",
     "check-types:renderer": "tsc --noEmit -p tsconfig.app.json",
     "check-types": "pnpm run check-types:main && pnpm run check-types:renderer",
-"test:desktop": "node --test scripts/linux-sandbox.test.mjs scripts/capture-evidence.test.mjs scripts/desktop-contract.test.mjs scripts/transcript-reducer.test.mjs scripts/transcript-paging.test.mjs scripts/provider-state.test.mjs scripts/stale-agent.test.mjs scripts/desktop-renderer-transport.test.mjs scripts/provider-grid-error-copy.test.mjs scripts/settings-time-to-error.test.mjs scripts/backend-error-surfaces.test.mjs scripts/canonical-chat.test.mjs scripts/run-detail-model.test.mjs scripts/chat-title.test.mjs scripts/tool-row.test.mjs scripts/attachment-url.test.mjs scripts/desktop-notifier.test.mjs scripts/python-bytecode-cache.test.mjs scripts/update-robustness.test.mjs scripts/usage-view.test.mjs scripts/usage-container.test.mjs scripts/session-status.test.mjs scripts/evidence-manifest.test.mjs",
+"test:desktop": "node --test scripts/linux-sandbox.test.mjs scripts/capture-evidence.test.mjs scripts/desktop-contract.test.mjs scripts/transcript-reducer.test.mjs scripts/transcript-paging.test.mjs scripts/provider-state.test.mjs scripts/stale-agent.test.mjs scripts/desktop-renderer-transport.test.mjs scripts/provider-grid-error-copy.test.mjs scripts/settings-time-to-error.test.mjs scripts/backend-error-surfaces.test.mjs scripts/canonical-chat.test.mjs scripts/run-detail-model.test.mjs scripts/chat-title.test.mjs scripts/tool-row.test.mjs scripts/attachment-url.test.mjs scripts/desktop-notifier.test.mjs scripts/python-bytecode-cache.test.mjs scripts/update-robustness.test.mjs scripts/usage-view.test.mjs scripts/usage-container.test.mjs scripts/session-status.test.mjs scripts/window-mode.test.mjs scripts/evidence-manifest.test.mjs",
     "check-themes": "node scripts/generate-theme-css.mjs --check && node scripts/contrast-contract.mjs",
     "check-evidence": "node scripts/check-evidence.mjs",
     "check-edit-diffs": "node scripts/check-edit-diffs.mjs",