@quanta-intellect/vessel-browser 0.1.120 → 0.1.123

package/out/main/index.js

@@ -52,10 +52,43 @@ function createLogger(scope) {
     error: (...args) => writeLog("error", scope, args)
   };
 }
+const SIDEBAR_MIN_WIDTH = 240;
+const SIDEBAR_MAX_WIDTH = 800;
+const SIDEBAR_RESIZE_HANDLE_OVERLAP = 6;
+const DETACHED_SIDEBAR_MIN_WIDTH = 360;
+const DETACHED_SIDEBAR_MIN_HEIGHT = 480;
+const DETACHED_SIDEBAR_DEFAULT_WIDTH = 420;
+const DETACHED_SIDEBAR_DEFAULT_HEIGHT = 760;
+function clampSidebarWidth(width) {
+  return Math.max(
+    SIDEBAR_MIN_WIDTH,
+    Math.min(SIDEBAR_MAX_WIDTH, Math.round(width))
+  );
+}
+function sanitizeSidebarPanelMode(value) {
+  return value === "closed" || value === "docked" || value === "detached" ? value : "docked";
+}
+function sanitizeSidebarDetachedBounds(value) {
+  if (!value || typeof value !== "object") return null;
+  const bounds = value;
+  const width = Number(bounds.width);
+  const height = Number(bounds.height);
+  if (!Number.isFinite(width) || !Number.isFinite(height)) return null;
+  const x = Number(bounds.x);
+  const y = Number(bounds.y);
+  return {
+    ...Number.isFinite(x) ? { x: Math.round(x) } : {},
+    ...Number.isFinite(y) ? { y: Math.round(y) } : {},
+    width: Math.max(DETACHED_SIDEBAR_MIN_WIDTH, Math.round(width)),
+    height: Math.max(DETACHED_SIDEBAR_MIN_HEIGHT, Math.round(height))
+  };
+}
 const defaults = {
   defaultUrl: "https://start.duckduckgo.com",
   theme: "dark",
+  sidebarPanelMode: "docked",
   sidebarWidth: 400,
+  sidebarDetachedBounds: null,
   mcpPort: 3100,
   autoRestoreSession: true,
   clearBookmarksOnLaunch: false,
@@ -258,6 +291,10 @@ function loadSettings() {
         mergeChatProviderSecret(parsed.chatProvider ?? null)
       ),
       mcpPort: sanitizePort(parsed.mcpPort ?? defaults.mcpPort),
+      sidebarPanelMode: sanitizeSidebarPanelMode(parsed.sidebarPanelMode),
+      sidebarDetachedBounds: sanitizeSidebarDetachedBounds(
+        parsed.sidebarDetachedBounds
+      ),
       sourceDoNotAllowList: sanitizeStringList(
         parsed.sourceDoNotAllowList ?? defaults.sourceDoNotAllowList
       ),
@@ -305,6 +342,10 @@ function setSetting(key2, value) {
   loadSettings();
   if (key2 === "mcpPort") {
     settings.mcpPort = sanitizePort(value);
+  } else if (key2 === "sidebarPanelMode") {
+    settings.sidebarPanelMode = sanitizeSidebarPanelMode(value);
+  } else if (key2 === "sidebarDetachedBounds") {
+    settings.sidebarDetachedBounds = sanitizeSidebarDetachedBounds(value);
   } else if (key2 === "sourceDoNotAllowList") {
     settings.sourceDoNotAllowList = sanitizeStringList(value);
   } else if (key2 === "chatProvider") {
@@ -343,8 +384,43 @@ function setSetting(key2, value) {
 function flushPersist$5() {
   return saveDirty ? persistNow() : Promise.resolve();
 }
+function isAirGapped() {
+  const hasAirGapSwitch = typeof electron.app?.commandLine?.hasSwitch === "function" && electron.app.commandLine.hasSwitch("air-gapped");
+  return hasAirGapSwitch || process.env.VESSEL_AIR_GAPPED === "1";
+}
+const LOCAL_PROVIDER_IDS = /* @__PURE__ */ new Set(["ollama", "llama_cpp"]);
+function isLocalProvider(providerId) {
+  return LOCAL_PROVIDER_IDS.has(providerId);
+}
+function isLocalHostname(hostname) {
+  const normalized = hostname.toLowerCase();
+  return normalized === "localhost" || normalized === "127.0.0.1" || normalized === "::1" || normalized === "[::1]";
+}
+function isLocalBaseUrl(baseUrl) {
+  if (!baseUrl) return false;
+  try {
+    return isLocalHostname(new URL(baseUrl).hostname);
+  } catch {
+    return false;
+  }
+}
+function getAirGapBlockReason(url) {
+  if (!isAirGapped()) return null;
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    return null;
+  }
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+    return null;
+  }
+  return isLocalHostname(parsed.hostname) ? null : `Air-gapped mode blocked network access to ${parsed.hostname}.`;
+}
 function checkDomainPolicy(url) {
   if (!url || url.startsWith("about:")) return null;
+  const airGapBlockReason = getAirGapBlockReason(url);
+  if (airGapBlockReason) return airGapBlockReason;
   const settings2 = loadSettings();
   const policy = settings2.domainPolicy;
   if (policy.allowedDomains.length === 0 && policy.blockedDomains.length === 0) {
@@ -3441,6 +3517,9 @@ const Channels = {
   SIDEBAR_RESIZE: "ui:sidebar-resize",
   SIDEBAR_RESIZE_START: "ui:sidebar-resize-start",
   SIDEBAR_RESIZE_COMMIT: "ui:sidebar-resize-commit",
+  SIDEBAR_POPOUT: "ui:sidebar-popout",
+  SIDEBAR_DOCK: "ui:sidebar-dock",
+  SIDEBAR_STATE_UPDATE: "ui:sidebar-state-update",
   SIDEBAR_CONTEXT_MENU: "ui:sidebar-context-menu",
   FOCUS_MODE_TOGGLE: "ui:focus-mode-toggle",
   SETTINGS_VISIBILITY: "ui:settings-visibility",
@@ -4691,6 +4770,9 @@ function assertFeatureUnlocked(featureName, featureLabel = featureName) {
   }
 }
 async function getCheckoutUrl(email) {
+  if (isAirGapped()) {
+    return errorResult("Checkout is unavailable in air-gapped mode.");
+  }
   try {
     const params = new URLSearchParams();
     if (email) params.set("email", email);
@@ -4709,6 +4791,9 @@ async function getCheckoutUrl(email) {
   }
 }
 async function getPortalUrl() {
+  if (isAirGapped()) {
+    return errorResult("Billing portal is unavailable in air-gapped mode.");
+  }
   const current = loadSettings().premium;
   const identifier = current.verificationToken;
   if (!identifier) {
@@ -4736,6 +4821,9 @@ async function getPortalUrl() {
   }
 }
 async function verifySubscription$1(identifier) {
+  if (isAirGapped()) {
+    return loadSettings().premium;
+  }
   const current = loadSettings().premium;
   const verificationIdentifier = identifier || current.verificationToken || current.customerId;
   if (!verificationIdentifier) {
@@ -4773,6 +4861,9 @@ async function verifySubscription$1(identifier) {
   }
 }
 async function requestActivationCode(email) {
+  if (isAirGapped()) {
+    return errorResult("Activation codes are unavailable in air-gapped mode.");
+  }
   const normalizedEmail = email.trim().toLowerCase();
   if (!normalizedEmail) {
     return errorResult("Email is required");
@@ -4796,6 +4887,11 @@ async function requestActivationCode(email) {
   }
 }
 async function verifyActivationCode(email, code, challengeToken) {
+  if (isAirGapped()) {
+    return errorResult("Activation codes are unavailable in air-gapped mode.", {
+      state: getPremiumState()
+    });
+  }
   const normalizedEmail = email.trim().toLowerCase();
   const trimmedCode = code.trim();
   if (!normalizedEmail) {
@@ -4844,6 +4940,7 @@ async function verifyActivationCode(email, code, challengeToken) {
 let revalidationTimer = null;
 function startBackgroundRevalidation() {
   if (revalidationTimer) return;
+  if (isAirGapped()) return;
   const { premium } = loadSettings();
   const identifier = premium.verificationToken || premium.customerId;
   if (identifier) {
@@ -4919,6 +5016,7 @@ let eventQueue = [];
 let flushTimer = null;
 let sessionStartedAt = null;
 function isEnabled() {
+  if (isAirGapped()) return false;
   if (POSTHOG_API_KEY === "YOUR_POSTHOG_KEY_HERE") return false;
   if (process.env.VESSEL_DEV === "1") return false;
   return loadSettings().telemetryEnabled !== false;
@@ -6577,6 +6675,159 @@ function schedulePageSnapshotCapture(wc, sendToRendererViews, delayMs = 0, optio
   }
   scheduleTimerAt(wc, sendToRendererViews, nextDueAt, options);
 }
+function setSidebarPanelMode(state2, mode, reason = "user") {
+  state2.uiState.sidebarPanelMode = mode;
+  if (reason === "user") {
+    setSetting("sidebarPanelMode", mode);
+  }
+}
+function persistDetachedBounds(state2) {
+  const sidebarWindow = state2.sidebarWindow;
+  if (!sidebarWindow || sidebarWindow.isDestroyed()) return;
+  const bounds = sidebarWindow.getBounds();
+  state2.uiState.sidebarDetachedBounds = {
+    x: bounds.x,
+    y: bounds.y,
+    width: bounds.width,
+    height: bounds.height
+  };
+  setSetting("sidebarDetachedBounds", state2.uiState.sidebarDetachedBounds);
+}
+function closeDetachedSidebarWindow(state2) {
+  const sidebarWindow = state2.sidebarWindow;
+  if (!sidebarWindow) return false;
+  state2.sidebarWindow = null;
+  state2.sidebarWindowClosing = true;
+  sidebarWindow.once("closed", () => {
+    state2.sidebarWindowClosing = false;
+  });
+  sidebarWindow.close();
+  return true;
+}
+function moveSidebarToMainWindow(state2) {
+  state2.sidebarWindow?.contentView.removeChildView(state2.sidebarView);
+  state2.mainWindow.contentView.addChildView(state2.sidebarView);
+}
+function getSidebarPanelState(state2) {
+  return {
+    open: state2.uiState.sidebarPanelMode !== "closed",
+    width: state2.uiState.sidebarWidth,
+    detached: state2.uiState.sidebarPanelMode === "detached"
+  };
+}
+function emitSidebarPanelState(state2) {
+  const panelState = getSidebarPanelState(state2);
+  if (!state2.chromeView.webContents.isDestroyed()) {
+    state2.chromeView.webContents.send(Channels.SIDEBAR_STATE_UPDATE, panelState);
+  }
+  if (!state2.sidebarView.webContents.isDestroyed()) {
+    state2.sidebarView.webContents.send(
+      Channels.SIDEBAR_STATE_UPDATE,
+      panelState
+    );
+  }
+  return panelState;
+}
+function isSidebarAttached(state2) {
+  return state2.uiState.sidebarPanelMode === "docked";
+}
+function isSidebarDetached(state2) {
+  return state2.uiState.sidebarPanelMode === "detached";
+}
+function closeSidebar(state2, relayout, reason = "user") {
+  if (state2.sidebarWindow) {
+    moveSidebarToMainWindow(state2);
+    closeDetachedSidebarWindow(state2);
+  }
+  setSidebarPanelMode(state2, "closed", reason);
+  relayout();
+  return emitSidebarPanelState(state2);
+}
+function openDockedSidebar(state2, relayout) {
+  setSidebarPanelMode(state2, "docked");
+  relayout();
+  return emitSidebarPanelState(state2);
+}
+function toggleDockedSidebar(state2, relayout) {
+  if (isSidebarDetached(state2)) {
+    state2.sidebarWindow?.focus();
+    return getSidebarPanelState(state2);
+  }
+  setSidebarPanelMode(
+    state2,
+    state2.uiState.sidebarPanelMode === "docked" ? "closed" : "docked"
+  );
+  relayout();
+  return emitSidebarPanelState(state2);
+}
+function layoutDetachedSidebar(state2) {
+  if (!state2.sidebarWindow) return;
+  const [width, height] = state2.sidebarWindow.getContentSize();
+  state2.sidebarView.setBounds({ x: 0, y: 0, width, height });
+}
+function detachSidebar(state2, hooks) {
+  if (state2.sidebarWindow) {
+    state2.sidebarWindow.focus();
+    return getSidebarPanelState(state2);
+  }
+  const detachedBounds = state2.uiState.sidebarDetachedBounds;
+  const detachedWidth = detachedBounds?.width ?? Math.max(DETACHED_SIDEBAR_DEFAULT_WIDTH, state2.uiState.sidebarWidth);
+  const detachedHeight = detachedBounds?.height ?? DETACHED_SIDEBAR_DEFAULT_HEIGHT;
+  const sidebarWindow = new electron.BaseWindow({
+    ...typeof detachedBounds?.x === "number" ? { x: detachedBounds.x } : {},
+    ...typeof detachedBounds?.y === "number" ? { y: detachedBounds.y } : {},
+    width: Math.max(DETACHED_SIDEBAR_MIN_WIDTH, Math.round(detachedWidth)),
+    height: Math.max(DETACHED_SIDEBAR_MIN_HEIGHT, Math.round(detachedHeight)),
+    minWidth: DETACHED_SIDEBAR_MIN_WIDTH,
+    minHeight: DETACHED_SIDEBAR_MIN_HEIGHT,
+    frame: true,
+    show: false,
+    backgroundColor: "#1a1a1e",
+    title: "Vessel Agent",
+    icon: hooks.getWindowIconPath()
+  });
+  state2.mainWindow.contentView.removeChildView(state2.sidebarView);
+  sidebarWindow.contentView.addChildView(state2.sidebarView);
+  state2.sidebarWindow = sidebarWindow;
+  setSidebarPanelMode(state2, "detached");
+  sidebarWindow.on("resize", () => {
+    layoutDetachedSidebar(state2);
+    persistDetachedBounds(state2);
+  });
+  sidebarWindow.on("move", () => persistDetachedBounds(state2));
+  sidebarWindow.on("close", (event) => {
+    if (state2.sidebarWindowClosing) return;
+    event.preventDefault();
+    dockSidebar(state2, hooks);
+  });
+  sidebarWindow.on("closed", () => {
+    if (state2.sidebarWindow !== sidebarWindow) return;
+    state2.sidebarWindow = null;
+    setSidebarPanelMode(state2, "docked");
+    state2.mainWindow.contentView.addChildView(state2.sidebarView);
+    hooks.relayout();
+    emitSidebarPanelState(state2);
+  });
+  hooks.relayout();
+  layoutDetachedSidebar(state2);
+  sidebarWindow.show();
+  sidebarWindow.focus();
+  return emitSidebarPanelState(state2);
+}
+function dockSidebar(state2, hooks) {
+  const sidebarWindow = state2.sidebarWindow;
+  if (!sidebarWindow) {
+    setSidebarPanelMode(state2, "docked");
+    hooks.relayout();
+    return emitSidebarPanelState(state2);
+  }
+  setSidebarPanelMode(state2, "docked");
+  moveSidebarToMainWindow(state2);
+  hooks.relayout();
+  closeDetachedSidebarWindow(state2);
+  state2.mainWindow.focus();
+  return emitSidebarPanelState(state2);
+}
 function enableClipboardShortcuts(view) {
   view.webContents.on("before-input-event", (event, input) => {
     if (!input.control && !input.meta) return;
@@ -6757,10 +7008,6 @@ function createMainWindow(onTabStateChange) {
     }
   });
   sidebarView.setBackgroundColor("#00000000");
-  sidebarView.webContents.on("context-menu", (event, params) => {
-    event.preventDefault();
-    void showSidebarContextMenu(mainWindow, sidebarView, params);
-  });
   mainWindow.contentView.addChildView(sidebarView);
   const devtoolsPanelView = new electron.WebContentsView({
     webPreferences: {
@@ -6778,8 +7025,9 @@ function createMainWindow(onTabStateChange) {
   enableClipboardShortcuts(devtoolsPanelView);
   const settings2 = loadSettings();
   const uiState = {
-    sidebarOpen: true,
+    sidebarPanelMode: settings2.sidebarPanelMode === "detached" ? "docked" : settings2.sidebarPanelMode,
     sidebarWidth: settings2.sidebarWidth,
+    sidebarDetachedBounds: settings2.sidebarDetachedBounds,
     focusMode: false,
     settingsOpen: false,
     devtoolsPanelOpen: false,
@@ -6797,6 +7045,8 @@ function createMainWindow(onTabStateChange) {
   });
   const state2 = {
     mainWindow,
+    sidebarWindow: null,
+    sidebarWindowClosing: false,
     chromeView,
     sidebarView,
     devtoolsPanelView,
@@ -6806,7 +7056,21 @@ function createMainWindow(onTabStateChange) {
   mainWindow.on("resize", () => layoutViews(state2));
   mainWindow.on("show", () => layoutViews(state2));
   mainWindow.on("focus", () => layoutViews(state2));
+  mainWindow.on("closed", () => {
+    closeDetachedSidebarWindow(state2);
+  });
+  sidebarView.webContents.on("context-menu", (event, params) => {
+    event.preventDefault();
+    void showSidebarContextMenu(
+      state2.sidebarWindow ?? state2.mainWindow,
+      sidebarView,
+      params
+    );
+  });
   layoutViews(state2);
+  if (settings2.sidebarPanelMode === "detached") {
+    detachSidebar(state2, { relayout: () => layoutViews(state2), getWindowIconPath });
+  }
   return state2;
 }
 function layoutViews(state2) {
@@ -6820,7 +7084,8 @@ function layoutViews(state2) {
   } = state2;
   const [width, height] = mainWindow.getContentSize();
   const chromeHeight = uiState.focusMode ? 0 : CHROME_HEIGHT;
-  const sidebarWidth = uiState.sidebarOpen ? uiState.sidebarWidth : 0;
+  const sidebarAttached = isSidebarAttached(state2);
+  const sidebarWidth = sidebarAttached ? uiState.sidebarWidth : 0;
   const devtoolsHeight = uiState.devtoolsPanelOpen ? uiState.devtoolsPanelHeight : 0;
   const chromeNeedsFullHeight = uiState.settingsOpen;
   if (chromeNeedsFullHeight) {
@@ -6828,15 +7093,14 @@ function layoutViews(state2) {
   } else {
     chromeView.setBounds({ x: 0, y: 0, width, height: chromeHeight });
   }
-  const resizeHandleOverlap = 6;
-  if (uiState.sidebarOpen) {
+  if (sidebarAttached) {
     sidebarView.setBounds({
-      x: width - sidebarWidth - resizeHandleOverlap,
+      x: width - sidebarWidth - SIDEBAR_RESIZE_HANDLE_OVERLAP,
       y: chromeHeight,
-      width: sidebarWidth + resizeHandleOverlap,
+      width: sidebarWidth + SIDEBAR_RESIZE_HANDLE_OVERLAP,
       height: height - chromeHeight
     });
-  } else {
+  } else if (uiState.sidebarPanelMode === "closed") {
     sidebarView.setBounds({ x: width, y: 0, width: 0, height: 0 });
   }
   const contentWidth = width - sidebarWidth;
@@ -6852,8 +7116,10 @@ function layoutViews(state2) {
   }
   mainWindow.contentView.removeChildView(chromeView);
   mainWindow.contentView.addChildView(chromeView);
-  mainWindow.contentView.removeChildView(sidebarView);
-  mainWindow.contentView.addChildView(sidebarView);
+  if (uiState.sidebarPanelMode !== "detached") {
+    mainWindow.contentView.removeChildView(sidebarView);
+    mainWindow.contentView.addChildView(sidebarView);
+  }
   mainWindow.contentView.removeChildView(devtoolsPanelView);
   mainWindow.contentView.addChildView(devtoolsPanelView);
   const activeTab = tabManager.getActiveTab();
@@ -6870,16 +7136,17 @@ function resizeSidebarViews(state2) {
   const { mainWindow, sidebarView, devtoolsPanelView, tabManager, uiState } = state2;
   const [width, height] = mainWindow.getContentSize();
   const chromeHeight = uiState.focusMode ? 0 : CHROME_HEIGHT;
-  const sidebarWidth = uiState.sidebarOpen ? uiState.sidebarWidth : 0;
+  const sidebarWidth = isSidebarAttached(state2) ? uiState.sidebarWidth : 0;
   const devtoolsHeight = uiState.devtoolsPanelOpen ? uiState.devtoolsPanelHeight : 0;
-  const resizeHandleOverlap = 6;
   const contentWidth = width - sidebarWidth;
-  sidebarView.setBounds({
-    x: width - sidebarWidth - resizeHandleOverlap,
-    y: chromeHeight,
-    width: sidebarWidth + resizeHandleOverlap,
-    height: height - chromeHeight
-  });
+  if (uiState.sidebarPanelMode !== "detached") {
+    sidebarView.setBounds({
+      x: width - sidebarWidth - SIDEBAR_RESIZE_HANDLE_OVERLAP,
+      y: chromeHeight,
+      width: sidebarWidth + SIDEBAR_RESIZE_HANDLE_OVERLAP,
+      height: height - chromeHeight
+    });
+  }
   if (uiState.devtoolsPanelOpen) {
     devtoolsPanelView.setBounds({
       x: 0,
@@ -7020,6 +7287,7 @@ const state$3 = {
   userDataPath: "",
   settingsPath: "",
   startupIssues: [],
+  airGapped: isAirGapped(),
   mcp: {
     configuredPort: 3100,
     activePort: null,
@@ -7047,6 +7315,7 @@ function getRuntimeHealth() {
     userDataPath: state$3.userDataPath,
     settingsPath: state$3.settingsPath,
     startupIssues: state$3.startupIssues.map((issue) => ({ ...issue })),
+    airGapped: state$3.airGapped,
     mcp: { ...state$3.mcp }
   };
 }
@@ -7577,8 +7846,8 @@ function isLoopbackBaseUrl(baseUrl) {
 }
 function resolveAgentToolProfile(config) {
   const providerId = config.id;
-  const isLocalProvider = providerId === "ollama" || providerId === "llama_cpp" || providerId === "custom" && isLoopbackBaseUrl(config.baseUrl);
-  if (!isLocalProvider) return "default";
+  const isLocalProvider2 = providerId === "ollama" || providerId === "llama_cpp" || providerId === "custom" && isLoopbackBaseUrl(config.baseUrl);
+  if (!isLocalProvider2) return "default";
   const sizeInBillions = parseModelSizeInBillions(config.model);
   if (sizeInBillions === null) {
     return "compact";
@@ -9379,6 +9648,15 @@ function validateProviderConnection(config, options = { requireModel: true }) {
   if (!meta) {
     return "Selected AI provider is not supported.";
   }
+  if (isAirGapped()) {
+    if (meta.id === "custom") {
+      if (!isLocalBaseUrl(normalized.baseUrl)) {
+        return "Air-gapped mode only allows local AI providers. Use a localhost base URL for custom providers.";
+      }
+    } else if (!isLocalProvider(meta.id)) {
+      return `Air-gapped mode only allows local AI providers (Ollama, llama.cpp). ${meta.name} requires internet access.`;
+    }
+  }
   if (meta.type !== "codex_oauth" && meta.requiresApiKey && !normalized.apiKey) {
     return `${meta.name} requires an API key. Open settings (Ctrl+,) to add one.`;
   }
@@ -11820,7 +12098,7 @@ const TOOL_DEFINITIONS = [
   {
     name: "select_option",
     title: "Select Option",
-    description: "Select an option in a <select> dropdown by visible label or option value. Only works on <select> elements — for checkboxes or radio buttons use click instead.",
+    description: "Select an option in a <select> dropdown by visible label or option value. Only works on <select> elements. For checkboxes or radio buttons use click instead.",
     inputSchema: {
       index: zod.z.number().optional().describe("The select element index number"),
       selector: zod.z.string().optional().describe("CSS selector as fallback"),
@@ -11945,7 +12223,7 @@ const TOOL_DEFINITIONS = [
         "full",
         "debug"
       ]).optional().describe(
-        "Read mode: glance (fastest — viewport snapshot, no JS extraction, ideal for heavy pages), visible_only/results_only/forms_only/summary/text_only for narrow reads, full/debug for the complete page dump"
+        "Read mode: glance (fastest: viewport snapshot, no JS extraction, ideal for heavy pages), visible_only/results_only/forms_only/summary/text_only for narrow reads, full/debug for the complete page dump"
       )
     },
     tier: 0
@@ -11953,7 +12231,7 @@ const TOOL_DEFINITIONS = [
   {
     name: "screenshot",
     title: "Screenshot",
-    description: "Take a screenshot of the current page — see exactly what the user sees. Returns the image for visual analysis. Use when you need to verify visual layout, check what's actually rendered on screen, or when text extraction fails on heavy pages.",
+    description: "Take a screenshot of the current page. Returns the image for visual analysis. Use when you need to verify visual layout, check what's actually rendered on screen, or when text extraction fails on heavy pages.",
     inputSchema: {},
     tier: 1
   },
@@ -12287,7 +12565,7 @@ const TOOL_DEFINITIONS = [
     inputSchema: {
       index: zod.z.number().optional().describe("Element index of the table to extract"),
       selector: zod.z.string().optional().describe(
-        "CSS selector for the table (auto-detected if omitted — uses first table)"
+        "CSS selector for the table (auto-detected if omitted; uses first table)"
       )
     },
     tier: 1,
@@ -26500,6 +26778,12 @@ function getAdBlockDecision(details) {
 }
 let installed = false;
 const defaultSessionTabManagers = /* @__PURE__ */ new Set();
+function getRequestFilterDecision(details, adBlockingEnabled) {
+  if (getAirGapBlockReason(details.url)) {
+    return { cancel: true };
+  }
+  return adBlockingEnabled ? getAdBlockDecision(details) : null;
+}
 function installAdBlocking(tabManager) {
   defaultSessionTabManagers.add(tabManager);
   if (installed) return;
@@ -26507,17 +26791,18 @@ function installAdBlocking(tabManager) {
   electron.session.defaultSession.webRequest.onBeforeRequest((details, callback) => {
     const webContentsId = typeof details.webContentsId === "number" ? details.webContentsId : null;
     if (webContentsId == null) {
-      callback({});
+      callback(getRequestFilterDecision(details, false) ?? {});
       return;
     }
     const manager = [...defaultSessionTabManagers].find(
       (candidate) => candidate.findTabByWebContentsId(webContentsId)
     );
-    if (!manager?.isAdBlockingEnabledForWebContents(webContentsId)) {
-      callback({});
-      return;
-    }
-    callback(getAdBlockDecision(details));
+    callback(
+      getRequestFilterDecision(
+        details,
+        manager?.isAdBlockingEnabledForWebContents(webContentsId) ?? false
+      ) ?? {}
+    );
   });
 }
 function unregisterAdBlockingTabManager(tabManager) {
@@ -26527,14 +26812,15 @@ function installAdBlockingForSession(ses, tabManager) {
   ses.webRequest.onBeforeRequest((details, callback) => {
     const webContentsId = typeof details.webContentsId === "number" ? details.webContentsId : null;
     if (webContentsId == null) {
-      callback({});
-      return;
-    }
-    if (!tabManager.isAdBlockingEnabledForWebContents(webContentsId)) {
-      callback({});
+      callback(getRequestFilterDecision(details, false) ?? {});
       return;
     }
-    callback(getAdBlockDecision(details));
+    callback(
+      getRequestFilterDecision(
+        details,
+        tabManager.isAdBlockingEnabledForWebContents(webContentsId)
+      ) ?? {}
+    );
   });
 }
 const filePath$1 = () => path$1.join(electron.app.getPath("userData"), "vessel-downloads.json");
@@ -27865,6 +28151,12 @@ const logger$7 = createLogger("CodexIPC");
 function registerCodexHandlers() {
   electron.ipcMain.handle(Channels.CODEX_START_AUTH, async (event) => {
     assertTrustedIpcSender(event);
+    if (isAirGapped()) {
+      return {
+        ok: false,
+        error: "Codex authentication is unavailable in air-gapped mode."
+      };
+    }
     const wc = event.sender;
     if (!wc || wc.isDestroyed()) {
       return {
@@ -27975,6 +28267,12 @@ const logger$5 = createLogger("OpenRouterIPC");
 function registerOpenRouterHandlers(applySettingChange) {
   electron.ipcMain.handle(Channels.OPENROUTER_START_AUTH, async (event) => {
     assertTrustedIpcSender(event);
+    if (isAirGapped()) {
+      return {
+        ok: false,
+        error: "OpenRouter authentication is unavailable in air-gapped mode."
+      };
+    }
     const wc = event.sender;
     if (!wc || wc.isDestroyed()) {
       return {
@@ -28019,6 +28317,116 @@ function registerOpenRouterHandlers(applySettingChange) {
     return { ok: true };
   });
 }
+function registerSidebarHandlers(windowState, requireTrusted) {
+  let sidebarResizeRecoveryTimer = null;
+  let sidebarResizeActive = false;
+  const relayout = () => layoutViews(windowState);
+  const clearSidebarResizeRecoveryTimer = () => {
+    if (!sidebarResizeRecoveryTimer) return;
+    clearTimeout(sidebarResizeRecoveryTimer);
+    sidebarResizeRecoveryTimer = null;
+  };
+  const stopSidebarResize = () => {
+    sidebarResizeActive = false;
+    clearSidebarResizeRecoveryTimer();
+  };
+  const restoreSidebarLayoutAfterResize = () => {
+    clearSidebarResizeRecoveryTimer();
+    if (!sidebarResizeActive) return;
+    sidebarResizeActive = false;
+    relayout();
+  };
+  const scheduleSidebarResizeRecovery = () => {
+    clearSidebarResizeRecoveryTimer();
+    sidebarResizeRecoveryTimer = setTimeout(() => {
+      restoreSidebarLayoutAfterResize();
+    }, 1200);
+  };
+  windowState.mainWindow.once("closed", stopSidebarResize);
+  electron.ipcMain.handle(Channels.SIDEBAR_TOGGLE, (event) => {
+    requireTrusted(event);
+    return toggleDockedSidebar(windowState, relayout);
+  });
+  electron.ipcMain.handle(Channels.SIDEBAR_NAVIGATE, (event, tab) => {
+    requireTrusted(event);
+    assertString(tab, "tab");
+    if (windowState.uiState.sidebarPanelMode === "closed") {
+      openDockedSidebar(windowState, relayout);
+    }
+    if (!windowState.sidebarView.webContents.isDestroyed()) {
+      windowState.sidebarView.webContents.send(Channels.SIDEBAR_NAVIGATE, tab);
+    }
+    windowState.sidebarWindow?.focus();
+    return emitSidebarPanelState(windowState);
+  });
+  electron.ipcMain.handle(Channels.SIDEBAR_RESIZE_START, (event) => {
+    requireTrusted(event);
+    if (isSidebarDetached(windowState)) return;
+    sidebarResizeActive = true;
+    clearSidebarResizeRecoveryTimer();
+    const [width, height] = windowState.mainWindow.getContentSize();
+    const chromeHeight = windowState.uiState.focusMode ? 0 : CHROME_HEIGHT;
+    const sidebarWidth = windowState.uiState.sidebarWidth;
+    windowState.sidebarView.setBounds({
+      x: width - sidebarWidth - SIDEBAR_RESIZE_HANDLE_OVERLAP,
+      y: chromeHeight,
+      width: sidebarWidth + SIDEBAR_RESIZE_HANDLE_OVERLAP,
+      height: height - chromeHeight
+    });
+    scheduleSidebarResizeRecovery();
+  });
+  electron.ipcMain.handle(Channels.SIDEBAR_RESIZE, (event, width) => {
+    requireTrusted(event);
+    assertNumber(width, "width");
+    if (isSidebarDetached(windowState)) {
+      return windowState.uiState.sidebarWidth;
+    }
+    const clamped = clampSidebarWidth(width);
+    windowState.uiState.sidebarWidth = clamped;
+    resizeSidebarViews(windowState);
+    emitSidebarPanelState(windowState);
+    return clamped;
+  });
+  electron.ipcMain.handle(Channels.SIDEBAR_RESIZE_COMMIT, (event) => {
+    requireTrusted(event);
+    if (isSidebarDetached(windowState)) return;
+    stopSidebarResize();
+    setSetting("sidebarWidth", windowState.uiState.sidebarWidth);
+    relayout();
+  });
+  electron.ipcMain.handle(Channels.SIDEBAR_POPOUT, (event) => {
+    requireTrusted(event);
+    stopSidebarResize();
+    return detachSidebar(windowState, {
+      relayout,
+      getWindowIconPath
+    });
+  });
+  electron.ipcMain.handle(Channels.SIDEBAR_DOCK, (event) => {
+    requireTrusted(event);
+    stopSidebarResize();
+    return dockSidebar(windowState, { relayout });
+  });
+  electron.ipcMain.on(
+    Channels.RENDERER_VIEW_READY,
+    (event, view) => {
+      requireTrusted(event);
+      if (view !== "sidebar") return;
+      emitSidebarPanelState(windowState);
+    }
+  );
+  electron.ipcMain.handle(Channels.SETTINGS_VISIBILITY, (event, open) => {
+    requireTrusted(event);
+    windowState.uiState.settingsOpen = open;
+    if (open) {
+      closeSidebar(windowState, relayout, "temporary");
+    } else {
+      relayout();
+      emitSidebarPanelState(windowState);
+    }
+    return windowState.uiState.settingsOpen;
+  });
+}
 const SUPPORT_API = process.env.VESSEL_SUPPORT_API || process.env.VESSEL_PREMIUM_API || "https://vesselpremium.quantaintellect.com";
 const MAX_FEEDBACK_MESSAGE_LENGTH = 5e3;
 const FEEDBACK_REQUEST_TIMEOUT_MS = 15e3;
@@ -28026,6 +28434,9 @@ function isValidEmail(email) {
   return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
 }
 async function submitFeedback(payload) {
+  if (isAirGapped()) {
+    return errorResult("Feedback submission is disabled in air-gapped mode.");
+  }
   const email = payload.email.trim().toLowerCase();
   const message = payload.message.trim();
   if (!isValidEmail(email)) {
@@ -28222,6 +28633,15 @@ function compareVersions(a, b) {
 async function checkForUpdates() {
   const currentVersion = electron.app.getVersion();
   const checkedAt = (/* @__PURE__ */ new Date()).toISOString();
+  if (isAirGapped()) {
+    return {
+      currentVersion,
+      latestVersion: null,
+      updateAvailable: false,
+      checkedAt,
+      error: "Update checks are disabled in air-gapped mode."
+    };
+  }
   try {
     const response = await fetch(GITHUB_LATEST_RELEASE_API_URL, {
       headers: { accept: "application/vnd.github+json", "user-agent": `Vessel/${currentVersion}` }
@@ -28252,6 +28672,9 @@ async function checkForUpdates() {
   }
 }
 async function openUpdateDownload() {
+  if (isAirGapped()) {
+    throw new Error("Update downloads are unavailable in air-gapped mode.");
+  }
   await openExternalAllowlisted(RELEASES_URL, { hosts: ["github.com"] });
 }
 let activeChatProvider = null;
@@ -28317,27 +28740,8 @@ function registerIpcHandlers(windowState, runtime2) {
     requireTrusted(event);
     return false;
   });
-  let sidebarResizeRecoveryTimer = null;
-  let sidebarResizeActive = false;
   let runtimeUpdateTimer = null;
   let pendingRuntimeState = null;
-  const clearSidebarResizeRecoveryTimer = () => {
-    if (!sidebarResizeRecoveryTimer) return;
-    clearTimeout(sidebarResizeRecoveryTimer);
-    sidebarResizeRecoveryTimer = null;
-  };
-  const restoreSidebarLayoutAfterResize = () => {
-    clearSidebarResizeRecoveryTimer();
-    if (!sidebarResizeActive) return;
-    sidebarResizeActive = false;
-    layoutViews(windowState);
-  };
-  const scheduleSidebarResizeRecovery = () => {
-    clearSidebarResizeRecoveryTimer();
-    sidebarResizeRecoveryTimer = setTimeout(() => {
-      restoreSidebarLayoutAfterResize();
-    }, 1200);
-  };
   const flushRuntimeUpdate = () => {
     runtimeUpdateTimer = null;
     if (!pendingRuntimeState) return;
@@ -28652,87 +29056,12 @@ function registerIpcHandlers(windowState, runtime2) {
       );
     }
   });
-  electron.ipcMain.handle(Channels.SIDEBAR_TOGGLE, (event) => {
-    requireTrusted(event);
-    windowState.uiState.sidebarOpen = !windowState.uiState.sidebarOpen;
-    layoutViews(windowState);
-    return {
-      open: windowState.uiState.sidebarOpen,
-      width: windowState.uiState.sidebarWidth
-    };
-  });
-  electron.ipcMain.handle(Channels.SIDEBAR_NAVIGATE, (event, tab) => {
-    requireTrusted(event);
-    assertString(tab, "tab");
-    if (!windowState.uiState.sidebarOpen) {
-      windowState.uiState.sidebarOpen = true;
-      layoutViews(windowState);
-    }
-    if (!sidebarView.webContents.isDestroyed()) {
-      sidebarView.webContents.send(Channels.SIDEBAR_NAVIGATE, tab);
-    }
-    return {
-      open: windowState.uiState.sidebarOpen,
-      width: windowState.uiState.sidebarWidth
-    };
-  });
-  electron.ipcMain.handle(Channels.SIDEBAR_RESIZE_START, (event) => {
-    requireTrusted(event);
-    sidebarResizeActive = true;
-    clearSidebarResizeRecoveryTimer();
-    const [width, height] = windowState.mainWindow.getContentSize();
-    const chromeHeight = windowState.uiState.focusMode ? 0 : CHROME_HEIGHT;
-    const sidebarWidth = windowState.uiState.sidebarWidth;
-    const resizeHandleOverlap = 6;
-    windowState.sidebarView.setBounds({
-      x: width - sidebarWidth - resizeHandleOverlap,
-      y: chromeHeight,
-      width: sidebarWidth + resizeHandleOverlap,
-      height: height - chromeHeight
-    });
-    scheduleSidebarResizeRecovery();
-  });
-  electron.ipcMain.handle(Channels.SIDEBAR_RESIZE, (event, width) => {
-    requireTrusted(event);
-    assertNumber(width, "width");
-    const clamped = Math.max(240, Math.min(800, Math.round(width)));
-    windowState.uiState.sidebarWidth = clamped;
-    resizeSidebarViews(windowState);
-    return clamped;
-  });
-  electron.ipcMain.handle(Channels.SIDEBAR_RESIZE_COMMIT, (event) => {
-    requireTrusted(event);
-    sidebarResizeActive = false;
-    clearSidebarResizeRecoveryTimer();
-    setSetting("sidebarWidth", windowState.uiState.sidebarWidth);
-    layoutViews(windowState);
-  });
-  electron.ipcMain.on(
-    Channels.RENDERER_VIEW_READY,
-    (event, view) => {
-      requireTrusted(event);
-      if (view !== "sidebar") return;
-      if (!windowState.uiState.sidebarOpen) {
-        windowState.uiState.sidebarOpen = true;
-        layoutViews(windowState);
-      }
-    }
-  );
   electron.ipcMain.handle(Channels.FOCUS_MODE_TOGGLE, (event) => {
     requireTrusted(event);
     windowState.uiState.focusMode = !windowState.uiState.focusMode;
     layoutViews(windowState);
     return windowState.uiState.focusMode;
   });
-  electron.ipcMain.handle(Channels.SETTINGS_VISIBILITY, (event, open) => {
-    requireTrusted(event);
-    windowState.uiState.settingsOpen = open;
-    if (open) {
-      windowState.uiState.sidebarOpen = false;
-    }
-    layoutViews(windowState);
-    return windowState.uiState.settingsOpen;
-  });
   electron.ipcMain.handle(Channels.SETTINGS_GET, (event) => {
     requireTrusted(event);
     return getRendererSettings();
@@ -28948,6 +29277,7 @@ function registerIpcHandlers(windowState, runtime2) {
   registerWindowControlHandlers(mainWindow);
   registerCodexHandlers();
   registerOpenRouterHandlers(applySettingChange);
+  registerSidebarHandlers(windowState, requireTrusted);
   electron.ipcMain.handle(Channels.AUTOMATION_GET_INSTALLED, (event) => {
     requireTrusted(event);
     return getInstalledKits();