local-operator-ui 0.38.1 → 0.39.0

package/out/main/index.js

@@ -190,6 +190,17 @@ zod.z.object({
     }).passthrough()
   }).passthrough()
 }).passthrough();
+const SIDEBAR_DESTINATION_IDS = [
+  "aida",
+  "library",
+  "projects",
+  "agents",
+  "schedules",
+  "browser",
+  "team-bridge",
+  "agent-hub",
+  "mesh"
+];
 const JOURNAL_ORDER_QUERY_BYTES = 6 * 1024;
 const JOURNAL_ORDER_ID_LIMIT = 512;
 function appendJournalOrderIds(query, path2, ids) {
@@ -488,6 +499,11 @@ const PROJECTS_SEARCH_MAX_CHARS = 256;
 const PROJECTS_SEARCH_DEFAULT_LIMIT = 100;
 const PROJECTS_SEARCH_MAX_LIMIT = 200;
 const hubItemKind = zod.z.enum(["agent", "team", "skill"]);
+const sidebarDestinationId = zod.z.enum(SIDEBAR_DESTINATION_IDS);
+const sidebarLayoutSchema = zod.z.object({
+  visible: zod.z.array(sidebarDestinationId).max(SIDEBAR_DESTINATION_IDS.length),
+  more: zod.z.array(sidebarDestinationId).max(SIDEBAR_DESTINATION_IDS.length)
+}).strict();
 const desktopRequestUnion = zod.z.discriminatedUnion("op", [
   zod.z.object({ op: zod.z.literal("capabilities") }).strict(),
   /*
@@ -2989,6 +3005,23 @@ const desktopRequestUnion = zod.z.discriminatedUnion("op", [
     op: zod.z.literal("library.librarian"),
     /** `status` is the read's own op; the other four are the writes. */
     action: zod.z.enum(["status", "open", "pause", "resume", "run"]).optional()
+  }).strict(),
+  /*
+   * THE SIDEBAR LAYOUT RESOURCE (design contract § 2, § 4). One read and one
+   * write, mirroring the two HTTP verbs: the resource is a single document, and
+   * a patch vocabulary over a nine-entry ordered list would have to invent
+   * operations for moves the client already knows how to compute.
+   *
+   * The write carries the WHOLE layout rather than a delta because the route
+   * normalises and persists a complete document (last writer wins, atomic file
+   * replace). Sending the full list is also what makes an optimistic write
+   * self-describing on the retry path: the body a retry replays is the layout
+   * the user saw, not a move that could be applied twice.
+   */
+  zod.z.object({ op: zod.z.literal("sidebar_layout.get") }).strict(),
+  zod.z.object({
+    op: zod.z.literal("sidebar_layout.set"),
+    layout: sidebarLayoutSchema
   }).strict()
 ]);
 const desktopRequestSchema = desktopRequestUnion.superRefine(
@@ -5387,6 +5420,22 @@ function desktopEndpoint(request) {
           ttl_s: request.ttlS
         }
       };
+    /*
+     * The sidebar customisation resource (design contract § 4). A GET/PUT pair
+     * on one route, with the layout in an envelope rather than as the bare body:
+     * the route answers `{layout}` and accepts `{layout}`, so a future field
+     * beside it is additive instead of a breaking shape change. The PUT sends
+     * the stored ids verbatim - the client owns the order, the route owns
+     * validation and the default fill - so nothing is re-sorted in transit.
+     */
+    case "sidebar_layout.get":
+      return { path: "/v1/desktop/sidebar-layout", method: "GET" };
+    case "sidebar_layout.set":
+      return {
+        path: "/v1/desktop/sidebar-layout",
+        method: "PUT",
+        body: { layout: request.layout }
+      };
   }
 }
 const MAX_PROBE_PATHS = 64;
@@ -28714,6 +28763,661 @@ function labelOf(account) {
   if (!account) return "an unnamed passkey";
   return account.displayName || account.name || "an unnamed passkey";
 }
+const ADDRESS_OVERLAY_S1_ENV = "LOCAL_OPERATOR_UI_BROWSER_ADDRESS_OVERLAY_S1";
+const ADDRESS_OVERLAY_DOCUMENT = "browser-address-overlay.html";
+const ADDRESS_OVERLAY_MAX_HEIGHT_DIP = 160;
+const ADDRESS_OVERLAY_READY_TIMEOUT_MS = 5e3;
+const DIP_INT32_MAX = 2 ** 31 - 1;
+const INDEX_DOCUMENT_SUFFIX$2 = /\/?index\.html(\?.*)?$/;
+const TRAILING_SLASH$1 = /\/$/;
+function addressOverlayDocumentUrlFor(rendererUrl) {
+  return INDEX_DOCUMENT_SUFFIX$2.test(rendererUrl) ? rendererUrl.replace(INDEX_DOCUMENT_SUFFIX$2, `/${ADDRESS_OVERLAY_DOCUMENT}`) : `${rendererUrl.replace(TRAILING_SLASH$1, "")}/${ADDRESS_OVERLAY_DOCUMENT}`;
+}
+function resolveAddressOverlayGate(input) {
+  const raw = input.env[ADDRESS_OVERLAY_S1_ENV];
+  if (raw === void 0 || raw.trim() === "") {
+    return { asked: false, enabled: false, reason: null };
+  }
+  const asked = true;
+  if (raw.trim() !== "1") {
+    return {
+      asked,
+      enabled: false,
+      reason: `${ADDRESS_OVERLAY_S1_ENV}=${raw.trim()} is not an opt-in (accepted: 1); the address overlay stayed off`
+    };
+  }
+  if (!input.devDriverArmed) {
+    return {
+      asked,
+      enabled: false,
+      reason: "the address overlay needs the armed renderer dev driver; it has no user-facing trigger in S1"
+    };
+  }
+  if (input.windowMode !== "headless") {
+    return {
+      asked,
+      enabled: false,
+      reason: `the address overlay refused to arm in a "${input.windowMode}" window; S1 has no user-facing path, so use --window-mode=headless`
+    };
+  }
+  return { asked, enabled: true, reason: null };
+}
+function int32(value) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return null;
+  const rounded = Math.round(value);
+  return Math.abs(rounded) > DIP_INT32_MAX ? null : rounded;
+}
+function overlayBoundsFor(contentRect, owner) {
+  if (contentRect === null) return null;
+  const x = int32(contentRect.x);
+  const y = int32(contentRect.y);
+  const width = int32(contentRect.width);
+  const height = int32(contentRect.height);
+  const ownerWidth = int32(owner.width);
+  const ownerHeight = int32(owner.height);
+  if (x === null || y === null || width === null || height === null || ownerWidth === null || ownerHeight === null)
+    return null;
+  if (width <= 0 || height <= 0 || ownerWidth <= 0 || ownerHeight <= 0) {
+    return null;
+  }
+  const left = Math.max(0, x);
+  const top = Math.max(0, y);
+  const right = Math.min(ownerWidth, x + width);
+  const bottom = Math.min(
+    ownerHeight,
+    y + Math.min(height, ADDRESS_OVERLAY_MAX_HEIGHT_DIP)
+  );
+  if (right <= left || bottom <= top) return null;
+  return { x: left, y: top, width: right - left, height: bottom - top };
+}
+function copyLayout(snapshot2) {
+  return {
+    activeTabId: snapshot2.activeTabId,
+    presented: snapshot2.presented,
+    contentRect: snapshot2.contentRect ? {
+      x: snapshot2.contentRect.x,
+      y: snapshot2.contentRect.y,
+      width: snapshot2.contentRect.width,
+      height: snapshot2.contentRect.height
+    } : null,
+    revision: snapshot2.revision
+  };
+}
+function layoutKeyOf(snapshot2) {
+  const rect = snapshot2.contentRect;
+  return `${snapshot2.activeTabId}:${snapshot2.presented ? 1 : 0}:${rect ? `${rect.x},${rect.y},${rect.width},${rect.height}` : "null"}`;
+}
+const OVERLAY_BACKGROUND = "#1b1f24";
+function createHardenedView() {
+  const partition = `address-overlay-${node_crypto.randomUUID()}`;
+  const childSession = electron.session.fromPartition(partition);
+  childSession.setPermissionRequestHandler(
+    (_contents, _permission, callback) => {
+      callback(false);
+    }
+  );
+  childSession.setPermissionCheckHandler(() => false);
+  childSession.on("will-download", (event) => {
+    event.preventDefault();
+  });
+  const view = new electron.WebContentsView({
+    webPreferences: {
+      partition,
+      sandbox: true,
+      contextIsolation: true,
+      nodeIntegration: false,
+      webSecurity: true,
+      allowRunningInsecureContent: false,
+      // No `preload`, and no script in the document: nothing can ask for a
+      // bridge, and the renderer never runs JavaScript even if the document
+      // changes by accident.
+      javascript: false
+    }
+  });
+  view.webContents.setWindowOpenHandler(() => ({ action: "deny" }));
+  view.setBackgroundColor(OVERLAY_BACKGROUND);
+  return view;
+}
+class AddressOverlayController {
+  window;
+  documentUrl;
+  createView;
+  readinessTimeoutMs;
+  log;
+  now;
+  appMetrics;
+  view;
+  childWebContentsId;
+  state;
+  failedReason;
+  hiddenReason;
+  generation;
+  childCreatedCount;
+  shownCount;
+  lastShow;
+  layout;
+  layoutKey;
+  boundTabId;
+  domReady;
+  finished;
+  loadStartedAt;
+  loadMs;
+  readyWaiter;
+  readinessTimer;
+  showInFlight;
+  disposingChild;
+  disposed;
+  ownerListeners;
+  childListeners;
+  constructor(deps) {
+    this.window = deps.window;
+    this.documentUrl = deps.documentUrl;
+    this.createView = deps.createView ?? createHardenedView;
+    this.readinessTimeoutMs = deps.readinessTimeoutMs ?? ADDRESS_OVERLAY_READY_TIMEOUT_MS;
+    this.log = deps.log ?? (() => {
+    });
+    this.now = deps.now ?? (() => Date.now());
+    this.appMetrics = deps.appMetrics ?? null;
+    this.view = null;
+    this.childWebContentsId = null;
+    this.state = "absent";
+    this.failedReason = null;
+    this.hiddenReason = null;
+    this.generation = 0;
+    this.childCreatedCount = 0;
+    this.shownCount = 0;
+    this.lastShow = null;
+    this.layout = {
+      activeTabId: null,
+      presented: false,
+      contentRect: null,
+      revision: 0
+    };
+    this.layoutKey = "none";
+    this.boundTabId = null;
+    this.domReady = false;
+    this.finished = false;
+    this.loadStartedAt = null;
+    this.loadMs = null;
+    this.readyWaiter = null;
+    this.readinessTimer = null;
+    this.showInFlight = null;
+    this.disposingChild = false;
+    this.disposed = false;
+    this.ownerListeners = [];
+    this.childListeners = [];
+    this.attachOwnerListeners();
+  }
+  // ---- observer hooks ------------------------------------------------------
+  /**
+   * The registry's post-layout hook. Called after every page layout pass,
+   * including null and suppressed ones.
+   *
+   * A changed key (tab, presentation or rectangle) hides and invalidates first:
+   * a moved page must never keep a stale rectangle floating over it, and a
+   * resized window invalidates old geometry until a fresh renderer rect
+   * arrives. An unchanged key is the background-page-creation case: the layout
+   * pass may have added a page above the child, so the child is re-added last
+   * and given the same rectangle. It never re-opens by itself; showing again is
+   * always an explicit probe call.
+   */
+  onLayout(snapshot2) {
+    if (this.disposed) return;
+    const next = copyLayout(snapshot2);
+    const nextKey = layoutKeyOf(next);
+    const previousKey = this.layoutKey;
+    this.layout = next;
+    this.layoutKey = nextKey;
+    if (previousKey !== nextKey) {
+      this.hide("layout");
+      return;
+    }
+    if (this.state !== "shown") return;
+    const view = this.view;
+    if (!view || this.viewUsable(view) === false) return;
+    const bounds = overlayBoundsFor(next.contentRect, this.ownerSize());
+    if (bounds === null || !next.presented) {
+      this.hide("layout_invalid");
+      return;
+    }
+    try {
+      view.setBounds(bounds);
+      this.raiseChild(view);
+    } catch (error) {
+      this.releaseChild("layout_error");
+      this.log(`[browser] address overlay layout failed: ${String(error)}`);
+    }
+  }
+  /** The bound page is going away. Dispose the child before the page release. */
+  onTabReleased(tabId) {
+    if (this.disposed) return;
+    if (this.boundTabId !== tabId) return;
+    this.releaseChild("bound-tab-released");
+  }
+  /** The bound page's renderer died but its webContents survives (a crashed tab).
+   * The child is bound to that page's rectangle, so it goes with the renderer; a
+   * later explicit show may create a fresh one. */
+  onPageGone(tabId) {
+    if (this.disposed) return;
+    if (this.boundTabId !== tabId) return;
+    this.releaseChild("page-crash");
+  }
+  // ---- probe surface ------------------------------------------------------
+  async showOverlay() {
+    if (this.showInFlight) return this.showInFlight;
+    const pending = this.showOnce();
+    this.showInFlight = pending;
+    void pending.then(
+      () => {
+        if (this.showInFlight === pending) this.showInFlight = null;
+      },
+      () => {
+        if (this.showInFlight === pending) this.showInFlight = null;
+      }
+    );
+    return pending;
+  }
+  hide(reason = "hide") {
+    if (this.disposed) return;
+    this.generation += 1;
+    this.settleReady(false);
+    this.hiddenReason = reason;
+    const view = this.view;
+    if (view && this.viewUsable(view)) {
+      try {
+        view.setVisible(false);
+      } catch {
+      }
+    }
+    if (this.state === "shown") {
+      this.state = this.failedReason ? "failed" : this.domReady && this.finished ? "ready" : "loading";
+    }
+    this.log(`[browser] address overlay hidden: ${reason}`);
+  }
+  /** Facts only: identifiers, geometry and counters. No page content. */
+  facts() {
+    const view = this.view;
+    let child = null;
+    if (view) {
+      let visible = false;
+      let bounds = null;
+      let order = -1;
+      let childCount = 0;
+      try {
+        visible = view.getVisible();
+        bounds = view.getBounds();
+        const children = this.window.contentView.children;
+        childCount = children.length;
+        order = children.indexOf(view);
+      } catch {
+      }
+      child = {
+        webContentsId: this.childWebContentsId ?? view.webContents.id,
+        visible,
+        bounds,
+        order,
+        childCount
+      };
+    }
+    let ownerDestroyed = true;
+    let contentBounds = null;
+    try {
+      ownerDestroyed = this.window.isDestroyed();
+      if (!ownerDestroyed) contentBounds = this.ownerSize();
+    } catch {
+      ownerDestroyed = true;
+    }
+    return {
+      documentUrl: this.documentUrl,
+      state: this.state,
+      failedReason: this.failedReason,
+      hiddenReason: this.hiddenReason,
+      generation: this.generation,
+      childCreatedCount: this.childCreatedCount,
+      shownCount: this.shownCount,
+      lastShow: this.lastShow,
+      readiness: {
+        domReady: this.domReady,
+        finished: this.finished,
+        loadMs: this.loadMs
+      },
+      child,
+      owner: {
+        windowId: typeof this.window.id === "number" ? this.window.id : null,
+        destroyed: ownerDestroyed,
+        contentBounds
+      },
+      layout: copyLayout(this.layout),
+      listeners: {
+        owner: this.ownerListeners.length,
+        child: this.childListeners.length
+      },
+      pendingShow: this.showInFlight !== null,
+      readinessTimer: this.readinessTimer !== null,
+      metrics: this.appMetrics ? this.appMetrics() : null
+    };
+  }
+  async probe(action) {
+    if (action === "show") {
+      await this.showOverlay();
+      return this.facts();
+    }
+    if (action === "hide") {
+      this.hide("probe");
+      return this.facts();
+    }
+    return this.facts();
+  }
+  /**
+   * Idempotent teardown for the host's stop/rollback/window-close paths.
+   * Closing the webContents before detaching is required: removing a
+   * `WebContentsView` does not release its renderer.
+   */
+  dispose(reason) {
+    if (this.disposed) return;
+    this.disposed = true;
+    this.generation += 1;
+    this.settleReady(false);
+    this.detachOwnerListeners();
+    this.destroyChild();
+    this.state = "disposed";
+    this.hiddenReason = reason;
+    this.log(`[browser] address overlay disposed: ${reason}`);
+  }
+  get isDisposed() {
+    return this.disposed;
+  }
+  // ---- show path ----------------------------------------------------------
+  async showOnce() {
+    const refuse = (reason) => {
+      this.lastShow = { shown: false, reason, bounds: null, at: this.now() };
+      return { shown: false, reason, bounds: null };
+    };
+    try {
+      if (this.disposed) return refuse("disposed");
+      if (this.failedReason) return refuse(this.failedReason);
+      if (this.ownerUnavailable()) {
+        this.releaseChild("owner_unavailable");
+        return refuse("owner_unavailable");
+      }
+      const snapshot2 = this.layout;
+      const bounds = overlayBoundsFor(snapshot2.contentRect, this.ownerSize());
+      if (snapshot2.activeTabId === null || !snapshot2.presented || bounds === null) {
+        return refuse("no_layout");
+      }
+      this.generation += 1;
+      const generation = this.generation;
+      this.boundTabId = snapshot2.activeTabId;
+      if (!this.view) {
+        const created = this.createChild(bounds);
+        if (!created) return refuse(this.failedReason ?? "child_create_failed");
+      }
+      if (!(this.domReady && this.finished)) {
+        this.state = "loading";
+        const ready = await this.waitForReady();
+        if (!ready) return refuse(this.failedReason ?? "invalidated");
+      }
+      if (this.disposed || generation !== this.generation) {
+        return refuse("invalidated");
+      }
+      if (this.ownerUnavailable()) {
+        this.releaseChild("owner_unavailable");
+        return refuse("owner_unavailable");
+      }
+      const view = this.view;
+      if (!view) return refuse("child_missing");
+      const finalBounds = overlayBoundsFor(
+        this.layout.contentRect,
+        this.ownerSize()
+      );
+      if (finalBounds === null || this.layout.activeTabId === null || !this.layout.presented || this.layout.activeTabId !== this.boundTabId) {
+        return refuse("invalidated");
+      }
+      view.setBounds(finalBounds);
+      this.raiseChild(view);
+      view.setVisible(true);
+      this.state = "shown";
+      this.hiddenReason = null;
+      this.shownCount += 1;
+      this.lastShow = {
+        shown: true,
+        reason: null,
+        bounds: finalBounds,
+        at: this.now()
+      };
+      this.log(
+        `[browser] address overlay shown tab=${this.boundTabId} bounds=${finalBounds.x},${finalBounds.y},${finalBounds.width},${finalBounds.height} generation=${generation}`
+      );
+      return { shown: true, reason: null, bounds: finalBounds };
+    } catch (error) {
+      this.failChild(`show_error:${String(error)}`);
+      return refuse("child_error");
+    }
+  }
+  createChild(bounds) {
+    let view;
+    try {
+      view = this.createView();
+    } catch (error) {
+      this.failChild(`child_create_failed:${String(error)}`);
+      return false;
+    }
+    this.view = view;
+    this.childWebContentsId = view.webContents.id;
+    this.childCreatedCount += 1;
+    this.domReady = false;
+    this.finished = false;
+    this.loadMs = null;
+    this.loadStartedAt = null;
+    try {
+      this.window.contentView.addChildView(view);
+      view.setBounds(bounds);
+      view.setVisible(false);
+    } catch (error) {
+      this.failChild(`child_attach_failed:${String(error)}`);
+      return false;
+    }
+    this.wireChild(view);
+    this.loadStartedAt = this.now();
+    try {
+      const loading = view.webContents.loadURL(this.documentUrl);
+      void Promise.resolve(loading).catch((error) => {
+        if (this.disposed || this.view !== view) return;
+        this.failChild(`load_failed:${String(error)}`);
+      });
+    } catch (error) {
+      this.failChild(`load_failed:${String(error)}`);
+      return false;
+    }
+    this.log(
+      `[browser] address overlay child created wc=${view.webContents.id}`
+    );
+    return true;
+  }
+  waitForReady() {
+    if (this.domReady && this.finished) return Promise.resolve(true);
+    if (this.readyWaiter) {
+      return Promise.resolve(false);
+    }
+    return new Promise((resolve) => {
+      this.readyWaiter = resolve;
+      this.readinessTimer = setTimeout(() => {
+        this.readinessTimer = null;
+        if (this.readyWaiter) this.failChild("load_timeout");
+      }, this.readinessTimeoutMs);
+    });
+  }
+  settleReady(ok) {
+    if (this.readinessTimer !== null) {
+      clearTimeout(this.readinessTimer);
+      this.readinessTimer = null;
+    }
+    const waiter = this.readyWaiter;
+    this.readyWaiter = null;
+    if (waiter) waiter(ok);
+  }
+  maybeReady() {
+    if (!(this.domReady && this.finished)) return;
+    if (this.loadStartedAt !== null && this.loadMs === null) {
+      this.loadMs = this.now() - this.loadStartedAt;
+    }
+    if (this.state === "loading" || this.state === "absent") {
+      this.state = this.readyWaiter ? this.state : "ready";
+    }
+    this.settleReady(true);
+  }
+  // ---- child wiring -------------------------------------------------------
+  wireChild(view) {
+    const contents = view.webContents;
+    const on = (target2, event, listener) => {
+      const emitter = target2;
+      emitter.on(event, listener);
+      this.childListeners.push(() => {
+        try {
+          emitter.removeListener(event, listener);
+        } catch {
+        }
+      });
+    };
+    on(contents, "dom-ready", () => {
+      if (this.view !== view) return;
+      this.domReady = true;
+      this.maybeReady();
+    });
+    on(contents, "did-finish-load", () => {
+      if (this.view !== view) return;
+      this.finished = true;
+      this.maybeReady();
+    });
+    on(contents, "did-fail-load", (...args) => {
+      if (this.view !== view) return;
+      const code = typeof args[1] === "number" ? args[1] : 0;
+      const isMainFrame = args[4] !== false;
+      if (!isMainFrame || code === -3) return;
+      this.failChild(`load_failed:${code}`);
+    });
+    on(contents, "render-process-gone", () => {
+      if (this.view !== view) return;
+      this.failChild("child_crash");
+    });
+    on(contents, "destroyed", () => {
+      if (this.view !== view) return;
+      if (this.disposingChild) return;
+      this.failChild("child_destroyed");
+    });
+    on(contents, "will-navigate", (...args) => {
+      const url = typeof args[1] === "string" ? args[1] : "";
+      const event = args[0];
+      if (url === this.documentUrl) return;
+      event?.preventDefault?.();
+      this.log(`[browser] address overlay refused navigation to ${url}`);
+    });
+    on(contents, "will-redirect", (...args) => {
+      const url = typeof args[1] === "string" ? args[1] : "";
+      const event = args[0];
+      if (url === this.documentUrl) return;
+      event?.preventDefault?.();
+      this.log(`[browser] address overlay refused redirect to ${url}`);
+    });
+  }
+  /** Terminal for this host lifetime: a broken document must not be retried. */
+  failChild(reason) {
+    if (this.failedReason) return;
+    this.failedReason = reason;
+    this.state = "failed";
+    this.settleReady(false);
+    this.destroyChild();
+    this.log(`[browser] address overlay failed: ${reason}`);
+  }
+  /** Recoverable: the child goes, a later explicit show may lazily recreate one. */
+  releaseChild(reason) {
+    this.generation += 1;
+    this.settleReady(false);
+    this.destroyChild();
+    if (!this.failedReason) this.state = "absent";
+    this.boundTabId = null;
+    this.domReady = false;
+    this.finished = false;
+    this.loadStartedAt = null;
+    this.log(`[browser] address overlay child released: ${reason}`);
+  }
+  destroyChild() {
+    const view = this.view;
+    if (!view) return;
+    this.view = null;
+    this.childWebContentsId = null;
+    this.disposingChild = true;
+    for (const remove of this.childListeners.splice(0)) remove();
+    try {
+      if (!view.webContents.isDestroyed()) view.webContents.close();
+    } catch {
+    }
+    try {
+      this.window.contentView.removeChildView(view);
+    } catch {
+    }
+    this.disposingChild = false;
+  }
+  raiseChild(view) {
+    this.window.contentView.addChildView(view);
+  }
+  viewUsable(view) {
+    try {
+      return !view.webContents.isDestroyed();
+    } catch {
+      return false;
+    }
+  }
+  // ---- owner wiring -------------------------------------------------------
+  attachOwnerListeners() {
+    const on = (target2, event, listener) => {
+      const emitter = target2;
+      emitter.on(event, listener);
+      this.ownerListeners.push(() => {
+        try {
+          emitter.removeListener(event, listener);
+        } catch {
+        }
+      });
+    };
+    on(this.window, "blur", () => {
+      this.hide("window_blur");
+    });
+    on(this.window, "minimize", () => {
+      this.hide("window_minimize");
+    });
+    on(this.window, "closed", () => {
+      this.dispose("window_closed");
+    });
+    const contents = this.window.webContents;
+    on(contents, "render-process-gone", () => {
+      this.releaseChild("owner_crash");
+    });
+    on(contents, "destroyed", () => {
+      this.dispose("owner_destroyed");
+    });
+    on(contents, "did-start-navigation", (...args) => {
+      const details = args[0];
+      if (details?.isMainFrame && details.isSameDocument !== true) {
+        this.releaseChild("owner_navigation");
+      }
+    });
+  }
+  detachOwnerListeners() {
+    for (const remove of this.ownerListeners.splice(0)) remove();
+  }
+  ownerSize() {
+    const bounds = this.window.getContentBounds();
+    return { width: bounds.width, height: bounds.height };
+  }
+  ownerUnavailable() {
+    try {
+      return this.window.isDestroyed() || this.window.webContents.isDestroyed();
+    } catch {
+      return true;
+    }
+  }
+}
 const PRIVATE_FILE_MODE = 384;
 const PRIVATE_DIR_MODE = 448;
 function writeJsonAtomic(path2, value) {
@@ -34003,7 +34707,7 @@ const enUiCommandPalette = {
   "ui.command_palette.palette_search.unread": "Unread",
   "ui.command_palette.palette_search.untitled_chat": "Untitled chat",
   "ui.command_palette.use_palette_sources.agent_chat": "Agent chat",
-  "ui.command_palette.use_palette_sources.agent_hub": "Agent hub",
+  "ui.command_palette.use_palette_sources.agent_hub": "Agent Hub",
   "ui.command_palette.use_palette_sources.agent_settings": "Agent settings",
   "ui.command_palette.use_palette_sources.analytics": "Analytics",
   "ui.command_palette.use_palette_sources.app_backend_and_environment": "App, backend and environment",
@@ -36509,7 +37213,7 @@ const enUiSettingsUpdates = {
 const enUiShell = {
   "ui.shell.collapsible_app_logo.local_operator": "Local Operator",
   "ui.shell.panel_rail.panels": "Panels",
-  "ui.shell.sidebar_navigation.agent_hub": "Agent hub",
+  "ui.shell.sidebar_navigation.agent_hub": "Agent Hub",
   "ui.shell.sidebar_navigation.agents": "Agents",
   "ui.shell.sidebar_navigation.aida_missed": "{name}, {count, plural, one {{count, number, ::group-off} missed message} other {{count, number, ::group-off} missed messages}}",
   "ui.shell.sidebar_navigation.aida_working": "{name}, working",
@@ -36517,17 +37221,31 @@ const enUiShell = {
   "ui.shell.sidebar_navigation.browser_waiting": "Browser, {count, plural, one {{countText} waiting} other {{countText} waiting}}",
   "ui.shell.sidebar_navigation.close_sidebar": "Close sidebar",
   "ui.shell.sidebar_navigation.collapse_sidebar": "Collapse sidebar",
+  "ui.shell.sidebar_navigation.drag_armed": "Moving {name}. Press Escape to cancel.",
   "ui.shell.sidebar_navigation.expand_sidebar": "Expand sidebar",
   "ui.shell.sidebar_navigation.mesh": "Mesh",
   "ui.shell.sidebar_navigation.mesh_waiting": "Mesh, {count, plural, one {{countText} waiting} other {{countText} waiting}}",
+  "ui.shell.sidebar_navigation.more_waiting": "More, {count, plural, one {{countText} waiting} other {{countText} waiting}}",
+  "ui.shell.sidebar_navigation.more_working": "More, working",
+  "ui.shell.sidebar_navigation.move_down": "Move down",
+  "ui.shell.sidebar_navigation.move_note": "Moved {name} to position {position} of {total}.",
+  "ui.shell.sidebar_navigation.move_to_more": "Move to More",
+  "ui.shell.sidebar_navigation.move_to_more_note": "{name} moved to More.",
+  "ui.shell.sidebar_navigation.move_up": "Move up",
   "ui.shell.sidebar_navigation.new_chat": "New chat",
   "ui.shell.sidebar_navigation.new_chat_shortcut": "New chat ({shortcut})",
   "ui.shell.sidebar_navigation.projects": "Projects",
+  "ui.shell.sidebar_navigation.reset_layout": "Reset sidebar layout",
+  "ui.shell.sidebar_navigation.reset_note": "Sidebar layout reset.",
+  "ui.shell.sidebar_navigation.row_actions": "Actions for {name}",
+  "ui.shell.sidebar_navigation.save_failed": "Could not save the sidebar layout.",
   "ui.shell.sidebar_navigation.schedules": "Schedules",
   "ui.shell.sidebar_navigation.search": "Search",
   "ui.shell.sidebar_navigation.search_accessible": "Search ({everything}) — chats ({chats})",
   "ui.shell.sidebar_navigation.search_tooltip": "Search everything ({everything}) · your chats ({chats})",
   "ui.shell.sidebar_navigation.settings": "Settings",
+  "ui.shell.sidebar_navigation.show_in_sidebar": "Show in sidebar",
+  "ui.shell.sidebar_navigation.show_in_sidebar_note": "{name} shown in the sidebar.",
   "ui.shell.user_profile_sidebar.account_settings": "Account settings",
   "ui.shell.user_profile_sidebar.account_unavailable": "Account unavailable",
   "ui.shell.user_profile_sidebar.checking_account": "Checking account…",
@@ -40081,17 +40799,31 @@ const esUiShell = {
   "ui.shell.sidebar_navigation.browser_waiting": "Navegador, {count, plural, one {{countText} en espera} many {{countText} en espera} other {{countText} en espera}}",
   "ui.shell.sidebar_navigation.close_sidebar": "Cerrar barra lateral",
   "ui.shell.sidebar_navigation.collapse_sidebar": "Contraer barra lateral",
+  "ui.shell.sidebar_navigation.drag_armed": "Moviendo {name}. Pulsa Esc para cancelar.",
   "ui.shell.sidebar_navigation.expand_sidebar": "Expandir barra lateral",
   "ui.shell.sidebar_navigation.mesh": "Mesh",
   "ui.shell.sidebar_navigation.mesh_waiting": "Mesh, {count, plural, one {{countText} en espera} many {{countText} en espera} other {{countText} en espera}}",
+  "ui.shell.sidebar_navigation.more_waiting": "Más, {count, plural, one {{countText} en espera} many {{countText} en espera} other {{countText} en espera}}",
+  "ui.shell.sidebar_navigation.more_working": "Más, trabajando",
+  "ui.shell.sidebar_navigation.move_down": "Bajar",
+  "ui.shell.sidebar_navigation.move_note": "Se movió {name} a la posición {position} de {total}.",
+  "ui.shell.sidebar_navigation.move_to_more": "Mover a Más",
+  "ui.shell.sidebar_navigation.move_to_more_note": "{name} se movió a Más.",
+  "ui.shell.sidebar_navigation.move_up": "Subir",
   "ui.shell.sidebar_navigation.new_chat": "Nuevo chat",
   "ui.shell.sidebar_navigation.new_chat_shortcut": "Nuevo chat ({shortcut})",
   "ui.shell.sidebar_navigation.projects": "Proyectos",
+  "ui.shell.sidebar_navigation.reset_layout": "Restablecer la disposición",
+  "ui.shell.sidebar_navigation.reset_note": "Disposición de la barra lateral restablecida.",
+  "ui.shell.sidebar_navigation.row_actions": "Acciones para {name}",
+  "ui.shell.sidebar_navigation.save_failed": "No se pudo guardar la disposición de la barra lateral.",
   "ui.shell.sidebar_navigation.schedules": "Programaciones",
   "ui.shell.sidebar_navigation.search": "Buscar",
   "ui.shell.sidebar_navigation.search_accessible": "Buscar en todo ({everything}) — chats ({chats})",
   "ui.shell.sidebar_navigation.search_tooltip": "Buscar en todo ({everything}) · tus chats ({chats})",
   "ui.shell.sidebar_navigation.settings": "Ajustes",
+  "ui.shell.sidebar_navigation.show_in_sidebar": "Mostrar en la barra lateral",
+  "ui.shell.sidebar_navigation.show_in_sidebar_note": "{name} ahora aparece en la barra lateral.",
   "ui.shell.user_profile_sidebar.account_settings": "Ajustes de cuenta",
   "ui.shell.user_profile_sidebar.account_unavailable": "Cuenta no disponible",
   "ui.shell.user_profile_sidebar.checking_account": "Comprobando la cuenta…",
@@ -43645,17 +44377,31 @@ const frUiShell = {
   "ui.shell.sidebar_navigation.browser_waiting": "Navigateur, {count, plural, one {{countText} approbation en attente} many {{countText} d’approbations en attente} other {{countText} approbations en attente}}",
   "ui.shell.sidebar_navigation.close_sidebar": "Fermer la barre latérale",
   "ui.shell.sidebar_navigation.collapse_sidebar": "Réduire la barre latérale",
+  "ui.shell.sidebar_navigation.drag_armed": "Déplacement de {name}. Appuyez sur Esc pour annuler.",
   "ui.shell.sidebar_navigation.expand_sidebar": "Développer la barre latérale",
   "ui.shell.sidebar_navigation.mesh": "Maillage",
   "ui.shell.sidebar_navigation.mesh_waiting": "Mesh, {count, plural, one {{countText} demande en attente} many {{countText} de demandes en attente} other {{countText} demandes en attente}}",
+  "ui.shell.sidebar_navigation.more_waiting": "Plus, {count, plural, one {{countText} en attente} many {{countText} en attente} other {{countText} en attente}}",
+  "ui.shell.sidebar_navigation.more_working": "Plus, en cours",
+  "ui.shell.sidebar_navigation.move_down": "Déplacer vers le bas",
+  "ui.shell.sidebar_navigation.move_note": "{name} est maintenant en position {position} sur {total}.",
+  "ui.shell.sidebar_navigation.move_to_more": "Déplacer vers Plus",
+  "ui.shell.sidebar_navigation.move_to_more_note": "{name} fait maintenant partie de Plus.",
+  "ui.shell.sidebar_navigation.move_up": "Déplacer vers le haut",
   "ui.shell.sidebar_navigation.new_chat": "Nouvelle conversation",
   "ui.shell.sidebar_navigation.new_chat_shortcut": "Nouvelle conversation ({shortcut})",
   "ui.shell.sidebar_navigation.projects": "Projets",
+  "ui.shell.sidebar_navigation.reset_layout": "Réinitialiser la disposition",
+  "ui.shell.sidebar_navigation.reset_note": "Disposition de la barre latérale réinitialisée.",
+  "ui.shell.sidebar_navigation.row_actions": "Actions pour {name}",
+  "ui.shell.sidebar_navigation.save_failed": "Impossible d’enregistrer la disposition de la barre latérale.",
   "ui.shell.sidebar_navigation.schedules": "Planifications",
   "ui.shell.sidebar_navigation.search": "Rechercher",
   "ui.shell.sidebar_navigation.search_accessible": "Rechercher ({everything}) — conversations ({chats})",
   "ui.shell.sidebar_navigation.search_tooltip": "Tout rechercher ({everything}) · vos conversations ({chats})",
   "ui.shell.sidebar_navigation.settings": "Paramètres",
+  "ui.shell.sidebar_navigation.show_in_sidebar": "Afficher dans la barre latérale",
+  "ui.shell.sidebar_navigation.show_in_sidebar_note": "{name} apparaît maintenant dans la barre latérale.",
   "ui.shell.user_profile_sidebar.account_settings": "Paramètres du compte",
   "ui.shell.user_profile_sidebar.account_unavailable": "Compte indisponible",
   "ui.shell.user_profile_sidebar.checking_account": "Vérification du compte…",
@@ -47167,17 +47913,31 @@ const hiUiShell = {
   "ui.shell.sidebar_navigation.browser_waiting": "ब्राउज़र, {count, plural, one {{countText} इंतज़ार में} other {{countText} इंतज़ार में}}",
   "ui.shell.sidebar_navigation.close_sidebar": "साइडबार बंद करें",
   "ui.shell.sidebar_navigation.collapse_sidebar": "साइडबार समेटें",
+  "ui.shell.sidebar_navigation.drag_armed": "{name} को ले जाया जा रहा है। रद्द करने के लिए Esc दबाएँ।",
   "ui.shell.sidebar_navigation.expand_sidebar": "साइडबार फैलाएँ",
   "ui.shell.sidebar_navigation.mesh": "मेश",
   "ui.shell.sidebar_navigation.mesh_waiting": "मेश, {count, plural, one {{countText} इंतज़ार में} other {{countText} इंतज़ार में}}",
+  "ui.shell.sidebar_navigation.more_waiting": "और, {count, plural, one {{countText} इंतज़ार में} other {{countText} इंतज़ार में}}",
+  "ui.shell.sidebar_navigation.more_working": "और, काम जारी है",
+  "ui.shell.sidebar_navigation.move_down": "नीचे ले जाएँ",
+  "ui.shell.sidebar_navigation.move_note": "{name} को कुल {total} में से स्थान {position} पर ले जाया गया।",
+  "ui.shell.sidebar_navigation.move_to_more": "और सेक्शन में ले जाएँ",
+  "ui.shell.sidebar_navigation.move_to_more_note": "{name} को और सेक्शन में ले जाया गया।",
+  "ui.shell.sidebar_navigation.move_up": "ऊपर ले जाएँ",
   "ui.shell.sidebar_navigation.new_chat": "नई चैट",
   "ui.shell.sidebar_navigation.new_chat_shortcut": "नई चैट ({shortcut})",
   "ui.shell.sidebar_navigation.projects": "प्रोजेक्ट",
+  "ui.shell.sidebar_navigation.reset_layout": "साइडबार लेआउट रीसेट करें",
+  "ui.shell.sidebar_navigation.reset_note": "साइडबार लेआउट रीसेट हो गया।",
+  "ui.shell.sidebar_navigation.row_actions": "{name} की कार्रवाइयाँ",
+  "ui.shell.sidebar_navigation.save_failed": "साइडबार लेआउट सहेजा नहीं जा सका।",
   "ui.shell.sidebar_navigation.schedules": "शेड्यूल",
   "ui.shell.sidebar_navigation.search": "खोजें",
   "ui.shell.sidebar_navigation.search_accessible": "खोजें ({everything}) — चैट ({chats})",
   "ui.shell.sidebar_navigation.search_tooltip": "सब कुछ खोजें ({everything}) · आपकी चैट ({chats})",
   "ui.shell.sidebar_navigation.settings": "सेटिंग्स",
+  "ui.shell.sidebar_navigation.show_in_sidebar": "साइडबार में दिखाएँ",
+  "ui.shell.sidebar_navigation.show_in_sidebar_note": "{name} अब साइडबार में है।",
   "ui.shell.user_profile_sidebar.account_settings": "खाते की सेटिंग्स",
   "ui.shell.user_profile_sidebar.account_unavailable": "खाता उपलब्ध नहीं",
   "ui.shell.user_profile_sidebar.checking_account": "खाता जाँचा जा रहा है…",
@@ -50528,17 +51288,31 @@ const ruUiShell = {
   "ui.shell.sidebar_navigation.browser_waiting": "Браузер, {count, plural, one {ожидает {countText}} few {ожидают {countText}} many {ожидают {countText}} other {ожидают {countText}}}",
   "ui.shell.sidebar_navigation.close_sidebar": "Закрыть боковую панель",
   "ui.shell.sidebar_navigation.collapse_sidebar": "Свернуть боковую панель",
+  "ui.shell.sidebar_navigation.drag_armed": "Перемещение: {name}. Нажмите Esc, чтобы отменить.",
   "ui.shell.sidebar_navigation.expand_sidebar": "Развернуть боковую панель",
   "ui.shell.sidebar_navigation.mesh": "Меш-сеть",
   "ui.shell.sidebar_navigation.mesh_waiting": "Меш-сеть, {count, plural, one {ожидает {countText}} few {ожидают {countText}} many {ожидают {countText}} other {ожидают {countText}}}",
+  "ui.shell.sidebar_navigation.more_waiting": "Ещё, {count, plural, one {ожидает {countText}} few {ожидают {countText}} many {ожидают {countText}} other {ожидают {countText}}}",
+  "ui.shell.sidebar_navigation.more_working": "Ещё, идёт работа",
+  "ui.shell.sidebar_navigation.move_down": "Переместить ниже",
+  "ui.shell.sidebar_navigation.move_note": "{name} теперь на позиции {position} из {total}.",
+  "ui.shell.sidebar_navigation.move_to_more": "Переместить в «Ещё»",
+  "ui.shell.sidebar_navigation.move_to_more_note": "{name} теперь в «Ещё».",
+  "ui.shell.sidebar_navigation.move_up": "Переместить выше",
   "ui.shell.sidebar_navigation.new_chat": "Новый чат",
   "ui.shell.sidebar_navigation.new_chat_shortcut": "Новый чат ({shortcut})",
   "ui.shell.sidebar_navigation.projects": "Проекты",
+  "ui.shell.sidebar_navigation.reset_layout": "Сбросить расположение боковой панели",
+  "ui.shell.sidebar_navigation.reset_note": "Расположение боковой панели сброшено.",
+  "ui.shell.sidebar_navigation.row_actions": "Действия для {name}",
+  "ui.shell.sidebar_navigation.save_failed": "Не удалось сохранить расположение боковой панели.",
   "ui.shell.sidebar_navigation.schedules": "Расписания",
   "ui.shell.sidebar_navigation.search": "Поиск",
   "ui.shell.sidebar_navigation.search_accessible": "Поиск ({everything}) — чаты ({chats})",
   "ui.shell.sidebar_navigation.search_tooltip": "Поиск по всему ({everything}) · ваши чаты ({chats})",
   "ui.shell.sidebar_navigation.settings": "Настройки",
+  "ui.shell.sidebar_navigation.show_in_sidebar": "Показать на боковой панели",
+  "ui.shell.sidebar_navigation.show_in_sidebar_note": "{name} теперь отображается на боковой панели.",
   "ui.shell.user_profile_sidebar.account_settings": "Настройки учётной записи",
   "ui.shell.user_profile_sidebar.account_unavailable": "Учётная запись недоступна",
   "ui.shell.user_profile_sidebar.checking_account": "Проверка учётной записи…",
@@ -53975,17 +54749,31 @@ const urUiShell = {
   "ui.shell.sidebar_navigation.browser_waiting": "براؤزر، {count, plural, one {{countText} منتظر} other {{countText} منتظر}}",
   "ui.shell.sidebar_navigation.close_sidebar": "سائیڈ بار بند کریں",
   "ui.shell.sidebar_navigation.collapse_sidebar": "سائیڈ بار سمیٹیں",
+  "ui.shell.sidebar_navigation.drag_armed": "{name} منتقل کیا جا رہا ہے۔ منسوخ کرنے کے لیے Esc دبائیں۔",
   "ui.shell.sidebar_navigation.expand_sidebar": "سائیڈ بار پھیلائیں",
   "ui.shell.sidebar_navigation.mesh": "Mesh",
   "ui.shell.sidebar_navigation.mesh_waiting": "Mesh، {count, plural, one {{countText} منتظر} other {{countText} منتظر}}",
+  "ui.shell.sidebar_navigation.more_waiting": "مزید، {count, plural, one {{countText} منتظر} other {{countText} منتظر}}",
+  "ui.shell.sidebar_navigation.more_working": "مزید، کام جاری ہے",
+  "ui.shell.sidebar_navigation.move_down": "نیچے کریں",
+  "ui.shell.sidebar_navigation.move_note": "{name} کو {total} میں سے {position} مقام پر منتقل کر دیا گیا۔",
+  "ui.shell.sidebar_navigation.move_to_more": "مزید حصے میں منتقل کریں",
+  "ui.shell.sidebar_navigation.move_to_more_note": "{name} کو مزید حصے میں منتقل کر دیا گیا۔",
+  "ui.shell.sidebar_navigation.move_up": "اوپر کریں",
   "ui.shell.sidebar_navigation.new_chat": "نئی چیٹ",
   "ui.shell.sidebar_navigation.new_chat_shortcut": "نئی چیٹ — {shortcut}",
   "ui.shell.sidebar_navigation.projects": "پروجیکٹس",
+  "ui.shell.sidebar_navigation.reset_layout": "سائیڈ بار کا لے آؤٹ ری سیٹ کریں",
+  "ui.shell.sidebar_navigation.reset_note": "سائیڈ بار کا لے آؤٹ ری سیٹ ہو گیا۔",
+  "ui.shell.sidebar_navigation.row_actions": "{name} کے لیے اقدامات",
+  "ui.shell.sidebar_navigation.save_failed": "سائیڈ بار کا لے آؤٹ محفوظ نہیں ہو سکا۔",
   "ui.shell.sidebar_navigation.schedules": "شیڈول",
   "ui.shell.sidebar_navigation.search": "تلاش کریں",
   "ui.shell.sidebar_navigation.search_accessible": "تلاش — {everything} — چیٹس — {chats}",
   "ui.shell.sidebar_navigation.search_tooltip": "سب کچھ تلاش کریں — {everything} · آپ کی چیٹس — {chats}",
   "ui.shell.sidebar_navigation.settings": "ترتیبات",
+  "ui.shell.sidebar_navigation.show_in_sidebar": "سائیڈ بار میں دکھائیں",
+  "ui.shell.sidebar_navigation.show_in_sidebar_note": "{name} اب سائیڈ بار میں ہے۔",
   "ui.shell.user_profile_sidebar.account_settings": "اکاؤنٹ کی ترتیبات",
   "ui.shell.user_profile_sidebar.account_unavailable": "اکاؤنٹ دستیاب نہیں",
   "ui.shell.user_profile_sidebar.checking_account": "اکاؤنٹ کی جانچ ہو رہی ہے…",
@@ -57145,17 +57933,31 @@ const viUiShell = {
   "ui.shell.sidebar_navigation.browser_waiting": "Trình duyệt, {count, plural, other {{countText} đang chờ}}",
   "ui.shell.sidebar_navigation.close_sidebar": "Đóng thanh bên",
   "ui.shell.sidebar_navigation.collapse_sidebar": "Thu gọn thanh bên",
+  "ui.shell.sidebar_navigation.drag_armed": "Đang chuyển {name}. Nhấn Esc để hủy.",
   "ui.shell.sidebar_navigation.expand_sidebar": "Mở rộng thanh bên",
   "ui.shell.sidebar_navigation.mesh": "Mạng lưới",
   "ui.shell.sidebar_navigation.mesh_waiting": "Mạng lưới, {count, plural, other {{countText} đang chờ}}",
+  "ui.shell.sidebar_navigation.more_waiting": "Khác, {count, plural, other {{countText} đang chờ}}",
+  "ui.shell.sidebar_navigation.more_working": "Khác, đang làm việc",
+  "ui.shell.sidebar_navigation.move_down": "Chuyển xuống",
+  "ui.shell.sidebar_navigation.move_note": "Đã chuyển {name} đến vị trí {position} trên {total}.",
+  "ui.shell.sidebar_navigation.move_to_more": "Chuyển vào mục Khác",
+  "ui.shell.sidebar_navigation.move_to_more_note": "Đã chuyển {name} vào mục Khác.",
+  "ui.shell.sidebar_navigation.move_up": "Chuyển lên",
   "ui.shell.sidebar_navigation.new_chat": "Cuộc trò chuyện mới",
   "ui.shell.sidebar_navigation.new_chat_shortcut": "Cuộc trò chuyện mới ({shortcut})",
   "ui.shell.sidebar_navigation.projects": "Dự án",
+  "ui.shell.sidebar_navigation.reset_layout": "Đặt lại bố cục thanh bên",
+  "ui.shell.sidebar_navigation.reset_note": "Đã đặt lại bố cục thanh bên.",
+  "ui.shell.sidebar_navigation.row_actions": "Thao tác cho {name}",
+  "ui.shell.sidebar_navigation.save_failed": "Không lưu được bố cục thanh bên.",
   "ui.shell.sidebar_navigation.schedules": "Lịch chạy",
   "ui.shell.sidebar_navigation.search": "Tìm kiếm",
   "ui.shell.sidebar_navigation.search_accessible": "Tìm kiếm ({everything}) — cuộc trò chuyện ({chats})",
   "ui.shell.sidebar_navigation.search_tooltip": "Tìm mọi thứ ({everything}) · cuộc trò chuyện của bạn ({chats})",
   "ui.shell.sidebar_navigation.settings": "Cài đặt",
+  "ui.shell.sidebar_navigation.show_in_sidebar": "Hiện trong thanh bên",
+  "ui.shell.sidebar_navigation.show_in_sidebar_note": "{name} đã được hiển thị trong thanh bên.",
   "ui.shell.user_profile_sidebar.account_settings": "Cài đặt tài khoản",
   "ui.shell.user_profile_sidebar.account_unavailable": "Không truy cập được tài khoản",
   "ui.shell.user_profile_sidebar.checking_account": "Đang kiểm tra tài khoản…",
@@ -60614,17 +61416,31 @@ const zhCNUiShell = {
   "ui.shell.sidebar_navigation.browser_waiting": "浏览器，{count, plural, other {{countText}项待处理}}",
   "ui.shell.sidebar_navigation.close_sidebar": "关闭侧边栏",
   "ui.shell.sidebar_navigation.collapse_sidebar": "收起侧边栏",
+  "ui.shell.sidebar_navigation.drag_armed": "正在移动{name}。按Esc取消。",
   "ui.shell.sidebar_navigation.expand_sidebar": "展开侧边栏",
   "ui.shell.sidebar_navigation.mesh": "网格",
   "ui.shell.sidebar_navigation.mesh_waiting": "网格，{count, plural, other {{countText}项待处理}}",
+  "ui.shell.sidebar_navigation.more_waiting": "更多，{count, plural, other {{countText}项待处理}}",
+  "ui.shell.sidebar_navigation.more_working": "更多，工作中",
+  "ui.shell.sidebar_navigation.move_down": "下移",
+  "ui.shell.sidebar_navigation.move_note": "已将{name}移至第{position}位，共{total}个。",
+  "ui.shell.sidebar_navigation.move_to_more": "移至更多",
+  "ui.shell.sidebar_navigation.move_to_more_note": "{name}已移至更多。",
+  "ui.shell.sidebar_navigation.move_up": "上移",
   "ui.shell.sidebar_navigation.new_chat": "新建对话",
   "ui.shell.sidebar_navigation.new_chat_shortcut": "新建对话（{shortcut}）",
   "ui.shell.sidebar_navigation.projects": "项目",
+  "ui.shell.sidebar_navigation.reset_layout": "重置侧边栏布局",
+  "ui.shell.sidebar_navigation.reset_note": "侧边栏布局已重置。",
+  "ui.shell.sidebar_navigation.row_actions": "{name}的操作",
+  "ui.shell.sidebar_navigation.save_failed": "无法保存侧边栏布局。",
   "ui.shell.sidebar_navigation.schedules": "定时任务",
   "ui.shell.sidebar_navigation.search": "搜索",
   "ui.shell.sidebar_navigation.search_accessible": "搜索（{everything}）—对话（{chats}）",
   "ui.shell.sidebar_navigation.search_tooltip": "搜索全部内容（{everything}）·搜索对话（{chats}）",
   "ui.shell.sidebar_navigation.settings": "设置",
+  "ui.shell.sidebar_navigation.show_in_sidebar": "在侧边栏中显示",
+  "ui.shell.sidebar_navigation.show_in_sidebar_note": "{name}已显示在侧边栏中。",
   "ui.shell.user_profile_sidebar.account_settings": "账户设置",
   "ui.shell.user_profile_sidebar.account_unavailable": "账户不可用",
   "ui.shell.user_profile_sidebar.checking_account": "正在检查账户……",
@@ -62955,10 +63771,29 @@ function mintNonce() {
   return node_crypto.randomBytes(16).toString("hex");
 }
 class TabRegistry {
-  constructor(viewFactory, onRemove, onChanged) {
+  /**
+   * The fourth callback is a post-layout observer, optional and defaulted so
+   * every existing three-argument construction is unchanged.
+   *
+   * WHY IT EXISTS: a native child positioned over a page has to know that the
+   * presented tab, its presentation bit or the content rectangle moved. Polling
+   * the registry would read a rectangle that is already stale, and `onChanged`
+   * is deliberately NOT that signal (`setContentRect` does not call it). The
+   * snapshot is copied and delivered after every pass — including null and
+   * suppressed layouts — because "nothing is presented now" is exactly when a
+   * stale overlay must hide.
+   *
+   * WHY IT CANNOT FAIL THE LAYOUT: page geometry is the product's behaviour and
+   * an observer is infrastructure around it. A throwing observer is swallowed
+   * here (the controller logs its own failure) so one experimental child can
+   * never leave pages unlaid-out.
+   */
+  constructor(viewFactory, onRemove, onChanged, onLayout = () => {
+  }) {
     this.viewFactory = viewFactory;
     this.onRemove = onRemove;
     this.onChanged = onChanged;
+    this.onLayout = onLayout;
   }
   tabs = /* @__PURE__ */ new Map();
   nextTabId = 1;
@@ -62968,6 +63803,9 @@ class TabRegistry {
   /** Tabs with a command in flight, keyed by tabId. See `lane`. */
   busy = /* @__PURE__ */ new Set();
   epochListeners = [];
+  /** Monotone count of layout passes, for an observer that needs identity, not
+   * just values (S1's address overlay). */
+  layoutRevision = 0;
   // ---- creation, addressing, listing ---------------------------------------
   /**
    * Create a tab. A user tab becomes active (the user asked for it); an AGENT
@@ -63270,6 +64108,22 @@ class TabRegistry {
       );
       record.view.setVisible(record.presented);
     }
+    this.layoutRevision += 1;
+    const rect = this.contentRect;
+    try {
+      this.onLayout({
+        activeTabId: this.activeTabId,
+        presented: active?.presented === true,
+        contentRect: rect ? {
+          x: rect.x,
+          y: rect.y,
+          width: rect.width,
+          height: rect.height
+        } : null,
+        revision: this.layoutRevision
+      });
+    } catch {
+    }
   }
   // ---- removal -------------------------------------------------------------
   /**
@@ -66365,6 +67219,58 @@ function restrictMode(path2, log2) {
     );
   }
 }
+const DEV_DRIVER_ENV = "LOCAL_OPERATOR_UI_DEV_DRIVER";
+const DEV_DRIVER_OUT_ENV = "LOCAL_OPERATOR_UI_DEV_DRIVER_OUT";
+const DEV_DRIVER_ARG = "--lo-dev-driver";
+const DEV_DRIVER_CAPTURE = "dev-driver-capture";
+const DEV_DRIVER_FACTS = "dev-driver-facts";
+const DEV_DRIVER_ADDRESS_OVERLAY = "dev-driver-address-overlay";
+const TRUTHY = /* @__PURE__ */ new Set(["1", "true"]);
+function readOptIn(env) {
+  const raw = env[DEV_DRIVER_ENV];
+  if (raw === void 0 || raw.trim() === "")
+    return { asked: false, value: null };
+  return { asked: true, value: raw.trim() };
+}
+function resolveDevDriverArming(input) {
+  const off = (problems = []) => ({
+    armed: false,
+    outDir: null,
+    problems
+  });
+  const optIn = readOptIn(input.env);
+  if (!optIn.asked) return off();
+  if (!TRUTHY.has(optIn.value.toLowerCase())) {
+    return off([
+      `${DEV_DRIVER_ENV}=${optIn.value} is not an opt-in (accepted: 1, true); the renderer dev driver stayed off`
+    ]);
+  }
+  if (input.windowMode !== "headless" && input.windowMode !== "inactive") {
+    return off([
+      `the renderer dev driver refused to arm in a "${input.windowMode}" window; it never raises one, so use --window-mode=headless (or inactive)`
+    ]);
+  }
+  const outDir = input.env[DEV_DRIVER_OUT_ENV]?.trim() ?? "";
+  if (outDir === "" || !outDir.startsWith("/")) {
+    return off([
+      `${DEV_DRIVER_ENV} was set but ${DEV_DRIVER_OUT_ENV} is ${outDir === "" ? "missing" : `"${outDir}"`}; an absolute frames directory is required, so the driver did not arm`
+    ]);
+  }
+  return { armed: true, outDir, problems: [] };
+}
+function headlessExerciserAllowed(input) {
+  return input.arming.armed && input.windowMode === "headless";
+}
+function devDriverArgument(outDir) {
+  return `${DEV_DRIVER_ARG}=${outDir}`;
+}
+function describeDevDriverArming(arming) {
+  if (arming.armed) {
+    return `[dev-driver] ARMED; frames are written to ${arming.outDir}`;
+  }
+  if (arming.problems.length === 0) return null;
+  return `[dev-driver] not armed: ${arming.problems.join("; ")}`;
+}
 class StartupRollback {
   owners = [];
   add(cleanup) {
@@ -66460,7 +67366,14 @@ const BROWSER_IPC_CHANNELS = [
   "browser-reveal-downloads",
   /** The user's own recovery click on the `unavailable` state (round 1, D1a).
    * Named here so the namespace stays the one place that lists its channels. */
-  "browser-retry"
+  "browser-retry",
+  /**
+   * S1's probe-only channel. Listed here for unregistration only: the handler
+   * below is registered only when the launch gate passed, and this entry makes
+   * `unregisterBrowserIpc` remove it on a stop/retry like every other channel
+   * (removing an unregistered handler is a no-op).
+   */
+  DEV_DRIVER_ADDRESS_OVERLAY
 ];
 function registerBrowserIpc(options) {
   function authorizeSender(event) {
@@ -66706,6 +67619,23 @@ function registerBrowserIpc(options) {
     await options.retry();
     return { retried: true };
   });
+  if (options.addressOverlayProbe) {
+    electron.ipcMain.handle(DEV_DRIVER_ADDRESS_OVERLAY, (event, action) => {
+      authorizeSender(event);
+      if (action !== "show" && action !== "hide" && action !== "facts") {
+        throw new Error(
+          "address_overlay_invalid_action: expected 'show', 'hide' or 'facts'."
+        );
+      }
+      const probe = options.addressOverlayProbe;
+      if (!probe) {
+        throw new Error(
+          "address_overlay_unavailable: the overlay probe is not running."
+        );
+      }
+      return probe(action);
+    });
+  }
 }
 function unregisterBrowserIpc() {
   for (const channel of BROWSER_IPC_CHANNELS) electron.ipcMain.removeHandler(channel);
@@ -68683,6 +69613,22 @@ function startBrowserHost(options) {
       await startBrowserHost(options).catch(() => {
       });
     },
+    /*
+     * S1's probe channel is registered ONLY when this launch's gate passed, and
+     * then it reads the current attempt's callback through `bindings` (a retry
+     * replaces it) rather than capturing a controller here.
+     */
+    ...options.addressOverlay?.enabled ? {
+      addressOverlayProbe: (action) => {
+        const probe = bindings.addressOverlayProbe;
+        if (!probe) {
+          throw new Error(
+            "address_overlay_unavailable: the overlay controller is not running."
+          );
+        }
+        return probe(action);
+      }
+    } : {},
     log: options.log
   });
   starting = startWithRetries({
@@ -68719,6 +69665,7 @@ async function initializeBrowserHost(options, bindings) {
   };
   try {
     let releaseTab = function(tabId, webContentsId) {
+      addressOverlay?.onTabReleased(tabId);
       const view = views.get(tabId);
       views.delete(tabId);
       downloads.forget(tabId);
@@ -68870,6 +69817,9 @@ async function initializeBrowserHost(options, bindings) {
       });
       contents.on("did-stop-loading", notifyChrome);
       contents.on("page-title-updated", notifyChrome);
+      contents.on("render-process-gone", () => {
+        addressOverlay?.onPageGone(tabId);
+      });
       contents.on(
         "did-fail-load",
         (_event, code, description, url, isMainFrame) => {
@@ -69064,6 +70014,15 @@ async function initializeBrowserHost(options, bindings) {
     const views = /* @__PURE__ */ new Map();
     const releases = /* @__PURE__ */ new Set();
     let stateWriter = null;
+    const addressOverlay = options.addressOverlay?.enabled === true ? new AddressOverlayController({
+      window: options.window,
+      documentUrl: options.addressOverlay.documentUrl,
+      log: log2,
+      appMetrics: () => electron.app.getAppMetrics().map((metric) => ({
+        pid: metric.pid,
+        type: metric.type
+      }))
+    }) : null;
     const sessionStore = new BrowserSessionStore({
       dir: path$1.join(options.userDataDir, "browser"),
       log: log2
@@ -69104,7 +70063,9 @@ async function initializeBrowserHost(options, bindings) {
     };
     const notifyChanged = () => {
       stateWriter?.publishNow();
-      options.window.webContents.send("browser-state-changed");
+      if (!options.window.isDestroyed() && !options.window.webContents.isDestroyed()) {
+        options.window.webContents.send("browser-state-changed");
+      }
       captureSession();
     };
     const registry = new TabRegistry(
@@ -69115,7 +70076,8 @@ async function initializeBrowserHost(options, bindings) {
         return view;
       },
       releaseTab,
-      notifyChanged
+      notifyChanged,
+      (snapshot2) => addressOverlay?.onLayout(snapshot2)
     );
     registryForDownloads = registry;
     rollback.add(async () => {
@@ -69124,6 +70086,7 @@ async function initializeBrowserHost(options, bindings) {
       registry.destroyAll();
       await Promise.allSettled([...releases]);
     });
+    rollback.add(() => addressOverlay?.dispose("startup-rollback"));
     const ownership = new OwnershipLedger({
       mayAdopt: (token, requester) => {
         const record = registry.requireSurface(token);
@@ -69150,7 +70113,9 @@ async function initializeBrowserHost(options, bindings) {
     const approvals = new ApprovalStore({
       dir: path$1.join(options.userDataDir, "browser"),
       onChanged: () => {
-        options.window.webContents.send("browser-consent-changed");
+        if (!options.window.isDestroyed() && !options.window.webContents.isDestroyed()) {
+          options.window.webContents.send("browser-consent-changed");
+        }
         consentNotifier.announce(approvals.pendingEntries());
       },
       log: log2
@@ -69232,6 +70197,7 @@ async function initializeBrowserHost(options, bindings) {
       host.clearPageFocus();
     };
     const resetMenuShortcutSuppression = () => {
+      if (options.window.isDestroyed()) return;
       if (!options.window.webContents.isDestroyed())
         options.window.webContents.setIgnoreMenuShortcuts(false);
     };
@@ -69249,6 +70215,7 @@ async function initializeBrowserHost(options, bindings) {
     options.window.webContents.on("render-process-gone", resetChordFocus);
     const detachChords = () => {
       host.clearChordState();
+      if (options.window.isDestroyed()) return;
       options.window.webContents.removeListener(
         "before-input-event",
         onChromeInput
@@ -69358,6 +70325,25 @@ async function initializeBrowserHost(options, bindings) {
     );
     rollback.add(() => stateWriter?.clear());
     stateWriter.start(server.port, sessionKey);
+    const probeAddressOverlay = async (action) => {
+      if (!addressOverlay) {
+        throw new Error(
+          "address_overlay_unavailable: this host owns no controller."
+        );
+      }
+      const facts2 = await addressOverlay.probe(action);
+      const record = registry.activeTab;
+      const page = record ? {
+        tabId: record.tabId,
+        presented: record.presented,
+        bounds: record.view.getBounds?.() ?? null,
+        visible: record.view.getVisible?.() ?? false
+      } : null;
+      return { ...facts2, page };
+    };
+    if (addressOverlay) {
+      bindings.addressOverlayProbe = probeAddressOverlay;
+    }
     Object.assign(bindings, {
       window: () => options.window,
       expectedUrl: options.expectedUrl,
@@ -69387,6 +70373,7 @@ async function initializeBrowserHost(options, bindings) {
       profileDir,
       agentTabs: () => registry.agentTabCount(),
       sessionCookies: () => restoreReport,
+      ...addressOverlay ? { addressOverlay: probeAddressOverlay } : {},
       stop: async () => {
         detachChords();
         const atStop = captureTabs(
@@ -69401,6 +70388,7 @@ async function initializeBrowserHost(options, bindings) {
           );
         }
         sessionStore.flush();
+        addressOverlay?.dispose("host-stop");
         registry.destroyAll();
         await Promise.allSettled([...releases]);
         await cdp.close();
@@ -70419,57 +71407,6 @@ class DesktopNotifier {
     notification.show();
   }
 }
-const DEV_DRIVER_ENV = "LOCAL_OPERATOR_UI_DEV_DRIVER";
-const DEV_DRIVER_OUT_ENV = "LOCAL_OPERATOR_UI_DEV_DRIVER_OUT";
-const DEV_DRIVER_ARG = "--lo-dev-driver";
-const DEV_DRIVER_CAPTURE = "dev-driver-capture";
-const DEV_DRIVER_FACTS = "dev-driver-facts";
-const TRUTHY = /* @__PURE__ */ new Set(["1", "true"]);
-function readOptIn(env) {
-  const raw = env[DEV_DRIVER_ENV];
-  if (raw === void 0 || raw.trim() === "")
-    return { asked: false, value: null };
-  return { asked: true, value: raw.trim() };
-}
-function resolveDevDriverArming(input) {
-  const off = (problems = []) => ({
-    armed: false,
-    outDir: null,
-    problems
-  });
-  const optIn = readOptIn(input.env);
-  if (!optIn.asked) return off();
-  if (!TRUTHY.has(optIn.value.toLowerCase())) {
-    return off([
-      `${DEV_DRIVER_ENV}=${optIn.value} is not an opt-in (accepted: 1, true); the renderer dev driver stayed off`
-    ]);
-  }
-  if (input.windowMode !== "headless" && input.windowMode !== "inactive") {
-    return off([
-      `the renderer dev driver refused to arm in a "${input.windowMode}" window; it never raises one, so use --window-mode=headless (or inactive)`
-    ]);
-  }
-  const outDir = input.env[DEV_DRIVER_OUT_ENV]?.trim() ?? "";
-  if (outDir === "" || !outDir.startsWith("/")) {
-    return off([
-      `${DEV_DRIVER_ENV} was set but ${DEV_DRIVER_OUT_ENV} is ${outDir === "" ? "missing" : `"${outDir}"`}; an absolute frames directory is required, so the driver did not arm`
-    ]);
-  }
-  return { armed: true, outDir, problems: [] };
-}
-function headlessExerciserAllowed(input) {
-  return input.arming.armed && input.windowMode === "headless";
-}
-function devDriverArgument(outDir) {
-  return `${DEV_DRIVER_ARG}=${outDir}`;
-}
-function describeDevDriverArming(arming) {
-  if (arming.armed) {
-    return `[dev-driver] ARMED; frames are written to ${arming.outDir}`;
-  }
-  if (arming.problems.length === 0) return null;
-  return `[dev-driver] not armed: ${arming.problems.join("; ")}`;
-}
 const FRAME_LABEL = /^[a-z0-9][a-z0-9_-]{0,63}$/;
 function registerDevDriverIPC(options) {
   const { window, expectedUrl, outDir, identity: identity2 } = options;
@@ -80764,6 +81701,16 @@ const devDriverArming = resolveDevDriverArming({
 });
 const devDriverLine = describeDevDriverArming(devDriverArming);
 if (devDriverLine) console.log(devDriverLine);
+const addressOverlayGate = resolveAddressOverlayGate({
+  env: launchEnv,
+  devDriverArmed: devDriverArming.armed,
+  windowMode: windowLaunch.mode
+});
+if (addressOverlayGate.asked) {
+  console.log(
+    addressOverlayGate.enabled ? "[address-overlay] ARMED (S1 probe: native child, no product path)" : `[address-overlay] not armed: ${addressOverlayGate.reason}`
+  );
+}
 const devDriverWebPreferences = devDriverArming.armed && devDriverArming.outDir ? { additionalArguments: [devDriverArgument(devDriverArming.outDir)] } : {};
 const telemetryWebPreferences = {
   additionalArguments: [telemetryArgument(telemetryLaunch.enabled)]
@@ -81167,6 +82114,7 @@ electron.app.whenReady().then(async () => {
   });
   const rendererUrl = rendererDocumentUrl();
   const consoleCaptureUrl = consoleCaptureUrlFor(rendererUrl);
+  const addressOverlayDocumentUrl = addressOverlayDocumentUrlFor(rendererUrl);
   backendService.observeDesktopFeed(
     (frame) => {
       if (frame.type === "notification") {
@@ -81975,6 +82923,14 @@ electron.app.whenReady().then(async () => {
         // document, and the preload every renderer in this app gets, which is what
         // lets main feed the reconstruction to it.
         consoleCaptureUrl,
+        // S1: only a gated headless probe arm gets this option at all. The
+        // URL is this app's own packaged document, not a caller's string.
+        ...addressOverlayGate.enabled ? {
+          addressOverlay: {
+            enabled: true,
+            documentUrl: addressOverlayDocumentUrl
+          }
+        } : {},
         preloadPath: path$1.join(__dirname, "../preload/index.js"),
         /*
          * The console's surfaces are handed the user's own PATH, from the same