local-operator-ui 0.25.0 → 0.25.2

package/out/main/index.js

@@ -14216,6 +14216,51 @@ function registerDevDriverIPC(options) {
     };
   });
 }
+const LAUNCHER_MISSES_BEFORE_GONE = 2;
+function createLauncherWatch(input) {
+  const threshold = input.missesBeforeGone ?? LAUNCHER_MISSES_BEFORE_GONE;
+  let misses = 0;
+  let fired = false;
+  let stopped = false;
+  return {
+    poll: () => {
+      if (fired || stopped) return false;
+      const parent = input.parentPid();
+      const reparented = parent !== input.launcherPid;
+      misses = reparented || !input.isAlive(input.launcherPid) ? misses + 1 : 0;
+      if (misses < threshold) return false;
+      fired = true;
+      input.onLauncherGone({
+        message: `the process that launched this run (pid ${input.launcherPid}) has exited`,
+        detail: reparented ? `pid ${input.launcherPid} is gone (this process was reparented to pid ${parent})` : `pid ${input.launcherPid} is gone`
+      });
+      return true;
+    },
+    stop: () => {
+      stopped = true;
+    }
+  };
+}
+function startLauncherWatch(input) {
+  const watch = createLauncherWatch(input);
+  const timer = setInterval(() => watch.poll(), input.intervalMs);
+  timer.unref?.();
+  return {
+    poll: watch.poll,
+    stop: () => {
+      clearInterval(timer);
+      watch.stop();
+    }
+  };
+}
+function isProcessAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error) {
+    return error.code !== "ESRCH";
+  }
+}
 const lastPickedDirectory = /* @__PURE__ */ new Map();
 function withRememberedDirectory(kind, options, fallbackDirectory) {
   if (options.defaultPath) return options;
@@ -17108,15 +17153,35 @@ const AGENT_LAUNCH_FLAGS = [
   "--user-data-dir",
   "--remote-debugging-port"
 ];
+const LAUNCHER_KEEP_ALIVE_ENV = "LOCAL_OPERATOR_UI_HEADLESS_KEEP_ALIVE";
+const LAUNCHER_POLL_INTERVAL_MS = 2e3;
+const LAUNCHER_EXIT_DEADLINE_MS = 1e4;
 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 }
+  normal: {
+    show: "focus",
+    focusable: true,
+    backgroundThrottling: true,
+    hideDock: false
+  },
+  inactive: {
+    show: "inactive",
+    focusable: true,
+    backgroundThrottling: false,
+    // Visible on purpose, so it keeps its tile: a run somebody wants to
+    // watch has to be findable in the Dock.
+    hideDock: false
+  },
+  headless: {
+    show: "never",
+    focusable: false,
+    backgroundThrottling: false,
+    hideDock: true
+  }
 };
 function readFlag(argv, name) {
   for (let index = 0; index < argv.length; index += 1) {
@@ -17154,8 +17219,11 @@ function resolveWindowLaunchPlan(input = {}) {
   const modeValue = modeFlag.found ? modeFlag.value : env[WINDOW_MODE_ENV];
   const modeRaw = typeof modeValue === "string" && modeValue.trim() === "" ? void 0 : modeValue;
   const parsedMode = parseWindowMode(modeRaw);
-  const agentFlag = !modeFlag.found && modeRaw === void 0 ? AGENT_LAUNCH_FLAGS.find((flag) => readFlag(argv, flag).found) : void 0;
-  const assumed = agentFlag ? `${agentFlag} marks an agent-driven launch, and no window mode was named` : null;
+  const unnamed = !modeFlag.found && modeRaw === void 0;
+  const agentFlag = unnamed ? AGENT_LAUNCH_FLAGS.find((flag) => readFlag(argv, flag).found) : void 0;
+  const platform = input.platform ?? process.platform;
+  const driven = unnamed && agentFlag === void 0 && input.packaged === false && platform !== "win32" && input.stdinIsTTY !== true && input.stdoutIsTTY !== true;
+  const assumed = agentFlag ? `${agentFlag} marks an agent-driven launch, and no window mode was named` : driven ? "the launch is not a packaged app and has no terminal on either stream, so it is a driven run rather than the operator using the app" : null;
   if (modeFlag.found && modeFlag.value === void 0) {
     problems.push(
       `${WINDOW_MODE_FLAG} needs a value: ${WINDOW_MODES.join("|")}`
@@ -17206,10 +17274,45 @@ function resolveWindowLaunchPlan(input = {}) {
     problems
   };
 }
-function describeWindowLaunch(plan) {
+const KEEP_ALIVE_VALUES = ["1", "true", "yes", "on"];
+function resolveLauncherWatchPlan(input) {
+  const env = input.env ?? {};
+  const keepAlive = (env[LAUNCHER_KEEP_ALIVE_ENV] ?? "").trim().toLowerCase();
+  if (KEEP_ALIVE_VALUES.includes(keepAlive)) {
+    return {
+      watch: false,
+      launcherPid: null,
+      reason: `${LAUNCHER_KEEP_ALIVE_ENV}=${keepAlive} was set, so this run outlives its launcher`
+    };
+  }
+  if (input.mode !== "headless") {
+    return {
+      watch: false,
+      launcherPid: null,
+      reason: `window mode ${input.mode} is not launcher-bound: a person can close it`
+    };
+  }
+  if (!Number.isInteger(input.launcherPid) || input.launcherPid <= 1) {
+    return {
+      watch: false,
+      launcherPid: null,
+      reason: "headless run already detached (no launcher to outlive)"
+    };
+  }
+  return {
+    watch: true,
+    launcherPid: input.launcherPid,
+    reason: `headless run launched by pid ${input.launcherPid}; it quits when that process goes`
+  };
+}
+function describeWindowLaunch(plan, platform = process.platform) {
   const behaviour = plan.show === "never" ? "window created and never shown" : plan.show === "inactive" ? "window shown without activating the app" : "window shown and focused";
-  const assumption = plan.assumed ? ` (assumed: ${plan.assumed})` : "";
-  return `window mode ${plan.mode}${assumption}: ${plan.width}x${plan.height}, ${behaviour}, page throttling ${plan.backgroundThrottling ? "on" : "off"}`;
+  const assumption = plan.assumed ? ` (mode assumed: ${plan.assumed})` : "";
+  const extras = [
+    plan.hideDock && platform === "darwin" ? "no Dock tile" : null
+  ].filter((part) => part !== null);
+  const suffix = extras.length === 0 ? "" : `, ${extras.join(", ")}`;
+  return `window mode ${plan.mode}: ${plan.width}x${plan.height}, ${behaviour}, page throttling ${plan.backgroundThrottling ? "on" : "off"}${suffix}${assumption}`;
 }
 const BASE64_FILE_EXTENSIONS = ["csv", "tsv", "xls", "xlsx", "ods"];
 const resolveUserPath = (filePath, cwd) => {
@@ -17220,10 +17323,68 @@ const resolveUserPath = (filePath, cwd) => {
     return path$1.join(cwd.startsWith("~/") ? resolveUserPath(cwd) : cwd, filePath);
   return filePath;
 };
+const windowLaunch = resolveWindowLaunchPlan({
+  env: launchEnv,
+  argv: process.argv,
+  /*
+   * The facts that let a flagless launch be recognised as a run rather than as
+   * the operator's app — see the `driven` block in window-mode.ts for why the
+   * shape is sound and why it cannot touch the shipped app.
+   *
+   * `app.isPackaged` is read here, at module load, rather than inside the
+   * resolver: it describes the LAUNCH (the installed `.app` is packaged, a
+   * checkout and the npm CLI are not), and the resolver stays free of Electron
+   * so its rules can be tested as arithmetic instead of by booting an app.
+   *
+   * `process.stdin`/`process.stdout` are read as the process was STARTED with
+   * them, for the same reason `launchEnv` exists: a terminal attached later
+   * cannot make this a person's launch.
+   */
+  packaged: electron.app.isPackaged,
+  stdinIsTTY: process.stdin.isTTY,
+  stdoutIsTTY: process.stdout.isTTY,
+  platform: process.platform
+});
+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 headlessExitDeadline = null;
+function armHeadlessExitDeadline(why) {
+  if (headlessExitDeadline) return;
+  const deadline2 = setTimeout(() => {
+    const line = `${why}; the quit did not finish within ${LAUNCHER_EXIT_DEADLINE_MS} ms, exiting`;
+    logger.error(`[window-mode] ${line}`, LogFileType.BACKEND);
+    console.log(`[window-mode] ${line}`);
+    electron.app.exit(0);
+  }, LAUNCHER_EXIT_DEADLINE_MS);
+  deadline2.unref();
+  headlessExitDeadline = deadline2;
+}
+function endHeadlessRun(why, detail) {
+  logger.info(`[window-mode] ${why}; quitting`, LogFileType.BACKEND);
+  console.log(`[window-mode] ${why}; quitting`);
+  if (detail) {
+    logger.debug(
+      `[window-mode] launcher probe: ${detail}`,
+      LogFileType.BACKEND
+    );
+  }
+  armHeadlessExitDeadline(why);
+  electron.app.quit();
+}
+let launcherWatch = null;
 electron.app.setName("Local Operator");
 const image = electron.nativeImage.createFromPath(icon);
 if (process.platform === "darwin" && electron.app.dock) {
-  electron.app.dock.setIcon(image);
+  if (windowLaunch.hideDock) {
+    electron.app.dock.hide();
+  } else {
+    electron.app.dock.setIcon(image);
+  }
 }
 const posthogClient = new posthogNode.PostHog(backendConfig.VITE_PUBLIC_POSTHOG_KEY, {
   host: backendConfig.VITE_PUBLIC_POSTHOG_HOST,
@@ -17545,17 +17706,6 @@ const reportBackendFailure = (message, fileType) => {
   }
   electron.dialog.showErrorBox("Backend Error", message);
 };
-const windowLaunch = resolveWindowLaunchPlan({
-  env: launchEnv,
-  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)}`);
-}
 const devDriverArming = resolveDevDriverArming({
   env: launchEnv,
   windowMode: windowLaunch.mode
@@ -17656,6 +17806,29 @@ electron.app.whenReady().then(async () => {
     electron.app.exit(0);
     return;
   }
+  const launcher = resolveLauncherWatchPlan({
+    mode: windowLaunch.mode,
+    launcherPid: process.ppid,
+    env: launchEnv
+  });
+  logger.info(`[window-mode] ${launcher.reason}`, LogFileType.BACKEND);
+  if (windowLaunch.mode !== "normal") {
+    console.log(`[window-mode] ${launcher.reason}`);
+  }
+  if (launcher.watch && launcher.launcherPid !== null) {
+    launcherWatch = startLauncherWatch({
+      launcherPid: launcher.launcherPid,
+      intervalMs: LAUNCHER_POLL_INTERVAL_MS,
+      isAlive: isProcessAlive,
+      parentPid: () => process.ppid,
+      onLauncherGone: ({ message, detail }) => endHeadlessRun(message, detail)
+    });
+  }
+  if (windowLaunch.mode === "headless") {
+    for (const signal of ["SIGTERM", "SIGINT"]) {
+      process.on(signal, () => endHeadlessRun(`received ${signal}`));
+    }
+  }
   electron.app.on("browser-window-created", (_, window) => {
     utils.optimizer.watchWindowShortcuts(window);
   });
@@ -18255,6 +18428,15 @@ electron.app.whenReady().then(async () => {
   electron.app.quit();
 });
 electron.app.on("window-all-closed", () => {
+  if (windowLaunch.mode === "headless") {
+    logger.info(
+      "[window-mode] all windows closed in a headless run; quitting",
+      LogFileType.BACKEND
+    );
+    console.log("[window-mode] all windows closed in a headless run; quitting");
+    electron.app.quit();
+    return;
+  }
   if (process.platform === "darwin") {
     if (activeUpdateService?.quitForInFlightInstall("last window closed")) {
       electron.app.quit();
@@ -18319,6 +18501,10 @@ const holdQuitForSessionCookieSnapshot = createSessionCookieQuitHold({
 electron.app.on("before-quit", async (event) => {
   if (await holdQuitForSessionCookieSnapshot(event)) return;
   logger.info("App is about to quit", LogFileType.BACKEND);
+  if (windowLaunch.mode === "headless") {
+    launcherWatch?.stop();
+    armHeadlessExitDeadline("the app is quitting");
+  }
   electron.globalShortcut.unregisterAll();
   activeUpdateService?.quitForInFlightInstall("app quit");
   void stopBrowserHost();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "local-operator-ui",
-  "version": "0.25.0",
+  "version": "0.25.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",
@@ -64,6 +64,8 @@
     "postinstall": "node ./bin/postinstall.js",
     "lint": "pnpm biome check src bin scripts/linux-sandbox.test.mjs",
     "lint:fix": "pnpm biome check --write src bin scripts/linux-sandbox.test.mjs",
+    "//lint:scripts": "`pnpm lint` names the paths it checks by hand, so the whole of `scripts/` - the proof harnesses, evidence rigs and release gates - sat outside the lint and formatter contracts, and a formatter error rode into a merged pull request green. This gate runs the same `biome check` over the `scripts/` files a change touches against a base ref (`origin/main` locally, the merge commit's first parent in CI), so a violation cannot ride in with the diff that introduces it, while the tree's 106 pre-existing offenders are burnt down file by file rather than turned red at once. Widening `pnpm lint` to name `scripts/` outright is the follow-up once that backlog is gone; scripts/check-scripts-lint.mjs holds the measurements and the full rationale.",
+    "lint:scripts": "node scripts/check-scripts-lint.mjs",
     "format": "pnpm biome format src",
     "format:fix": "pnpm biome format --write src",
     "prepack": "pnpm run build:npm",
@@ -71,7 +73,8 @@
     "check-types:renderer": "tsc --noEmit -p tsconfig.app.json",
     "check-types": "pnpm run check-types:main && pnpm run check-types:renderer",
     "test:session-cookies": "node scripts/session-cookie-electron.test.mjs",
-    "test:desktop": "node scripts/run-desktop-tests.mjs scripts/slash-token.test.mjs scripts/slash-rank.test.mjs scripts/slash-submit.test.mjs scripts/slash-contract.test.mjs scripts/slash-row-format.test.mjs scripts/owned-serve-lifecycle.test.mjs 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/desktop-proxy.test.mjs scripts/session-stream-token.test.mjs scripts/session-load-recovery.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/stale-caption.test.mjs scripts/desktop-watch-lease.test.mjs scripts/session-switch.test.mjs scripts/chat-search.test.mjs scripts/palette-search.test.mjs scripts/palette-shortcut.test.mjs scripts/palette-contract.test.mjs scripts/palette-panel-request.test.mjs scripts/run-detail-model.test.mjs scripts/subagent-pulse.test.mjs scripts/chat-title.test.mjs scripts/clear-search.test.mjs scripts/tool-row.test.mjs scripts/attachment-url.test.mjs scripts/desktop-notifier.test.mjs scripts/launch-session.test.mjs scripts/desktop-feed.test.mjs scripts/viewer-record.test.mjs scripts/desktop-stream.test.mjs scripts/python-bytecode-cache.test.mjs scripts/update-affirmation.test.mjs scripts/update-robustness.test.mjs scripts/prune-python-resource.test.mjs scripts/managed-python.test.mjs scripts/usage-view.test.mjs scripts/usage-container.test.mjs scripts/session-status.test.mjs scripts/composer-readings.test.mjs scripts/composer-tabs.test.mjs scripts/ask-options.test.mjs scripts/window-mode.test.mjs scripts/evidence-manifest.test.mjs scripts/canonical-notice.test.mjs scripts/evidence-run-guard.test.mjs scripts/desktop-test-concurrency.test.mjs scripts/run-desktop-tests.test.mjs scripts/mcp-foreign-config-origin.test.mjs scripts/mentioned-files.test.mjs scripts/picker-feedback.test.mjs scripts/panel-chart-motion.test.mjs scripts/panel-info-credentials.test.mjs scripts/warm-session.test.mjs scripts/submit-latency.test.mjs scripts/completion-view-ack.test.mjs scripts/echo-delivery.test.mjs scripts/check-runtime-deps.test.mjs scripts/new-chat-row.test.mjs scripts/new-chat-row-evidence.test.mjs scripts/reconnect-page-gap.test.mjs scripts/browser-host.test.mjs scripts/check-vendored.test.mjs scripts/chat-session-status.test.mjs scripts/draft-selection.test.mjs scripts/toast-lifetime.test.mjs scripts/storybook-query-fixture.test.mjs scripts/mcp-list-query.test.mjs scripts/mcp-target-resolution.test.mjs scripts/mcp-auth-surface.test.mjs scripts/mcp-failure-routing.test.mjs scripts/daemon-discovery.test.mjs scripts/daemon-health-state.test.mjs scripts/daemon-observation.test.mjs scripts/session-cookies.test.mjs scripts/move-session.test.mjs scripts/frontend-replace.test.mjs scripts/browser-chrome.test.mjs scripts/dev-driver-gate.test.mjs scripts/logger-log-dir.test.mjs scripts/draft-splash.test.mjs scripts/suggestion-stack.test.mjs scripts/suggestion-stack-react.test.mjs scripts/notifications-off.test.mjs scripts/notification-launch.test.mjs scripts/notification-spawn-sites.test.mjs scripts/interrupt-control.test.mjs",
+
+    "test:desktop": "node scripts/run-desktop-tests.mjs scripts/slash-token.test.mjs scripts/slash-rank.test.mjs scripts/slash-submit.test.mjs scripts/slash-contract.test.mjs scripts/slash-row-format.test.mjs scripts/owned-serve-lifecycle.test.mjs scripts/launcher-watch.test.mjs 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/desktop-proxy.test.mjs scripts/session-stream-token.test.mjs scripts/session-load-recovery.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/stale-caption.test.mjs scripts/desktop-watch-lease.test.mjs scripts/session-switch.test.mjs scripts/chat-search.test.mjs scripts/palette-search.test.mjs scripts/palette-shortcut.test.mjs scripts/palette-contract.test.mjs scripts/palette-panel-request.test.mjs scripts/run-detail-model.test.mjs scripts/subagent-pulse.test.mjs scripts/chat-title.test.mjs scripts/clear-search.test.mjs scripts/tool-row.test.mjs scripts/attachment-url.test.mjs scripts/desktop-notifier.test.mjs scripts/launch-session.test.mjs scripts/desktop-feed.test.mjs scripts/viewer-record.test.mjs scripts/desktop-stream.test.mjs scripts/python-bytecode-cache.test.mjs scripts/update-affirmation.test.mjs scripts/update-robustness.test.mjs scripts/prune-python-resource.test.mjs scripts/managed-python.test.mjs scripts/usage-view.test.mjs scripts/usage-container.test.mjs scripts/session-status.test.mjs scripts/composer-readings.test.mjs scripts/composer-tabs.test.mjs scripts/ask-options.test.mjs scripts/window-mode.test.mjs scripts/evidence-manifest.test.mjs scripts/canonical-notice.test.mjs scripts/evidence-run-guard.test.mjs scripts/desktop-test-concurrency.test.mjs scripts/run-desktop-tests.test.mjs scripts/mcp-foreign-config-origin.test.mjs scripts/mentioned-files.test.mjs scripts/picker-feedback.test.mjs scripts/panel-chart-motion.test.mjs scripts/panel-info-credentials.test.mjs scripts/warm-session.test.mjs scripts/submit-latency.test.mjs scripts/completion-view-ack.test.mjs scripts/echo-delivery.test.mjs scripts/check-runtime-deps.test.mjs scripts/new-chat-row.test.mjs scripts/new-chat-row-evidence.test.mjs scripts/reconnect-page-gap.test.mjs scripts/browser-host.test.mjs scripts/check-vendored.test.mjs scripts/chat-session-status.test.mjs scripts/draft-selection.test.mjs scripts/toast-lifetime.test.mjs scripts/storybook-query-fixture.test.mjs scripts/mcp-list-query.test.mjs scripts/mcp-target-resolution.test.mjs scripts/mcp-auth-surface.test.mjs scripts/mcp-failure-routing.test.mjs scripts/daemon-discovery.test.mjs scripts/daemon-health-state.test.mjs scripts/daemon-observation.test.mjs scripts/session-cookies.test.mjs scripts/move-session.test.mjs scripts/frontend-replace.test.mjs scripts/browser-chrome.test.mjs scripts/dev-driver-gate.test.mjs scripts/logger-log-dir.test.mjs scripts/draft-splash.test.mjs scripts/suggestion-stack.test.mjs scripts/suggestion-stack-react.test.mjs scripts/notifications-off.test.mjs scripts/notification-launch.test.mjs scripts/notification-spawn-sites.test.mjs scripts/chrome-keychain.test.mjs scripts/interrupt-control.test.mjs",
     "check-themes": "node scripts/generate-theme-css.mjs --check && node scripts/contrast-contract.mjs",
     "check-vendored": "node scripts/check-vendored.mjs",
     "check-evidence": "node scripts/check-evidence.mjs",