feat: add Antigravity provider, home scope, and welcome overlay redesign

- Add Antigravity agent provider (supervisor adapter + renderer UI + icon)
- Introduce `homeScope` shared module and "Home" project support across store, actions, sidebar, and IPC
- Redesign welcome overlay with animated code wallpaper and entrance animations
- Add `browserMcp` config scope, composer add menu, and browser scope indicator in AttachmentBar
- Extend Browser MCP tool registry with `open` tool and streamline ingress/server logic
- Improve thread draft view layout, compact header polish, and add comprehensive tests
- Add `newThreadMode` and `browserMcpScope` shared settings with UI controls
- Register Antigravity in the agent registry; update all provider browser MCP builders for home scope
- Wire `getHomeScopeLocation` IPC procedure for cross-process project location queries
- Refactor session ref watcher polling and fix session resume for Claude/ACP sessions

Author: SDSLeon

src/main/browser/BrowserMcpIngress.ts

@@ -43,9 +43,7 @@ type JsonRpcResponse = JsonRpcResponseOk | JsonRpcResponseErr;
 /**
  * Single in-process MCP server. Speaks Streamable-HTTP MCP at `POST /mcp`
  * (JSON-RPC body, single JSON response). All five agent providers connect
- * here by URL — no per-thread Node child process. Also exposes legacy
- * `POST /<tool_name>` REST routes for backward compatibility with the old
- * stdio bridge until the v2 ship lands.
+ * here by URL — no per-thread Node child process.
  */
 export class BrowserMcpIngress {
   private server: Server | null = null;
@@ -189,18 +187,6 @@ export class BrowserMcpIngress {
         return;
       }
 
-      // Legacy REST: POST /<tool_name>. Retained so any older client still
-      // pointed at this endpoint continues to work during the transition.
-      if (req.method === "POST") {
-        const tool = path.replace(/^\/+/, "").replace(/\/+$/, "");
-        if (!tool) {
-          this.sendJson(res, 404, { error: "not found" });
-          return;
-        }
-        await this.handleLegacyRest(req, res, tool);
-        return;
-      }
-
       this.sendJson(res, 404, { error: "not found" });
     } catch (err) {
       this.sendJson(res, 500, { error: (err as Error).message ?? "internal" });
@@ -261,7 +247,7 @@ export class BrowserMcpIngress {
           result: {
             protocolVersion: MCP_PROTOCOL_VERSION,
             capabilities: { tools: {} },
-            serverInfo: { name: "lightcode_browser", version: "2.0.0" },
+            serverInfo: { name: "browser", version: "2.0.0" },
           },
         };
       }
@@ -329,40 +315,6 @@ export class BrowserMcpIngress {
       };
     }
   }
-
-  private async handleLegacyRest(
-    req: IncomingMessage,
-    res: ServerResponse,
-    tool: string,
-  ): Promise<void> {
-    if (!isKnownToolName(tool)) {
-      this.sendJson(res, 404, { error: `unknown tool: ${tool}` });
-      return;
-    }
-    const ctx = this.buildContext();
-    if (!ctx) {
-      this.sendJson(res, 503, { error: "browser not ready" });
-      return;
-    }
-    ctx.manager.revealPanel();
-    const raw = await this.readBody(req);
-    let args: Record<string, unknown> = {};
-    if (raw) {
-      try {
-        const parsed = JSON.parse(raw);
-        if (parsed && typeof parsed === "object") args = parsed as Record<string, unknown>;
-      } catch {
-        this.sendJson(res, 400, { error: "invalid json" });
-        return;
-      }
-    }
-    try {
-      const result = await dispatchTool(tool, args, ctx);
-      this.sendJson(res, 200, result);
-    } catch (err) {
-      this.sendJson(res, 500, { error: (err as Error).message ?? "internal" });
-    }
-  }
 }
 
 function isJsonRpcRequest(value: unknown): value is JsonRpcRequest {

src/main/browser/cdp/dialogController.ts

@@ -24,7 +24,7 @@ type Disposition = { action: "accept" | "dismiss"; promptText?: string };
 /**
  * Owns the CDP-level Page.javascriptDialogOpening lifecycle. By default, any
  * dialog is auto-dismissed (preserves the existing UX where alerts don't pop
- * a modal over the embedded view). The agent can call browser_dialog to set
+ * a modal over the embedded view). The agent can call the dialog tool to set
  * a one-shot disposition for the next dialog, allowing accept/dismiss/answer
  * flows for confirm/prompt.
  */

src/main/browser/mcp/toolRegistry.ts

@@ -67,6 +67,15 @@ export const TOOLS: ToolSpec[] = [
       },
     },
   },
+  {
+    name: "open",
+    description: "Open a URL in the active Lightcode browser tab, creating a tab if needed.",
+    inputSchema: {
+      type: "object",
+      required: ["url"],
+      properties: { tabId: { type: "string" }, url: { type: "string" } },
+    },
+  },
   {
     name: "activate_tab",
     description: "Make the given tab the active visible tab.",
@@ -200,6 +209,19 @@ export const TOOLS: ToolSpec[] = [
       },
     },
   },
+  {
+    name: "inspect",
+    description:
+      "Inspect the page with a structured snapshot of visible interactive elements, roles, text, refs, and bounds.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        tabId: { type: "string" },
+        maxNodes: { type: "number" },
+        includeHidden: { type: "boolean" },
+      },
+    },
+  },
   {
     name: "get",
     description:
@@ -459,13 +481,13 @@ export const TOOLS: ToolSpec[] = [
 
 export const TOOL_NAMES = new Set(TOOLS.map((t) => t.name));
 
+const TOOL_ALIASES = new Map([
+  ["open", "navigate"],
+  ["inspect", "snapshot"],
+]);
+
 export function normalizeToolName(name: string): string {
-  if (TOOL_NAMES.has(name)) return name;
-  if (name.startsWith("browser_")) {
-    const stripped = name.slice("browser_".length);
-    if (TOOL_NAMES.has(stripped)) return stripped;
-  }
-  return name;
+  return TOOL_ALIASES.get(name) ?? name;
 }
 
 export function isKnownToolName(name: string): boolean {

src/main/ipc/localHandlers.ts

@@ -1,3 +1,4 @@
+import { homedir } from "node:os";
 import { clipboard, dialog, nativeImage, shell, type BrowserWindow } from "electron";
 import type { BrowserPanelManager } from "../browser";
 import {
@@ -101,6 +102,10 @@ export function createLocalIpcHandlers(
       }
       win.focus();
     },
+    getHomeScopeLocation: () =>
+      process.platform === "win32"
+        ? { kind: "windows", path: homedir() }
+        : { kind: "posix", path: homedir() },
     getKeybindings: () => readKeybindingsFile(options.requireLightcodePaths().keybindingsPath),
     revealProjectEntry: async (payload) => {
       shell.showItemInFolder(resolveProjectFsPath(payload));

src/main/sharedSettingsFile.test.ts

@@ -66,6 +66,7 @@ describe("sharedSettingsFile", () => {
       closeToTray: true,
       threadRemoveAction: "archive",
       newThreadMode: "page",
+      homeScopeEnabled: true,
       autoShowTerminalPanel: true,
       gitReviewMode: "panel",
       providerConfigs: {},
@@ -82,7 +83,7 @@ describe("sharedSettingsFile", () => {
       favoriteModels: [],
       recentModels: [],
       agentHookSupport: {},
-      browser: { mcpEnabled: true, allowEval: false, allowDataAccess: false },
+      browser: { allowEval: false, allowDataAccess: false },
     });
 
     expect(readSharedSettingsFile(settingsPath)).toEqual({
@@ -125,6 +126,7 @@ describe("sharedSettingsFile", () => {
       closeToTray: true,
       threadRemoveAction: "archive",
       newThreadMode: "page",
+      homeScopeEnabled: true,
       autoShowTerminalPanel: true,
       gitReviewMode: "panel",
       providerConfigs: {},
@@ -141,7 +143,7 @@ describe("sharedSettingsFile", () => {
       favoriteModels: [],
       recentModels: [],
       agentHookSupport: {},
-      browser: { mcpEnabled: true, allowEval: false, allowDataAccess: false },
+      browser: { allowEval: false, allowDataAccess: false },
     });
     expect(readFileSync(settingsPath, "utf8")).toContain('"themeMode": "dark"');
   });

src/renderer/actions/projectActions.ts

@@ -1,10 +1,33 @@
+import type { Project, ProjectLocation } from "@/shared/contracts";
 import { readBridge } from "@/renderer/bridge";
 import { useAppStore } from "@/renderer/state/appStore";
 import { useDevTerminalStore } from "@/renderer/state/devTerminalStore";
 import { useFileEditorStore } from "@/renderer/state/fileEditorStore";
 import { useGitStore } from "@/renderer/state/gitStore";
 import { usePanelStore } from "@/renderer/state/panelStore";
 
+// The home dir doesn't change at runtime, so cache the single IPC roundtrip
+// and reuse it across callers (MainView mount effect + WelcomeOverlay
+// "Ask Question" path).
+let homeScopeLocationPromise: Promise<ProjectLocation> | null = null;
+
+export function loadHomeScopeLocation(): Promise<ProjectLocation> {
+  if (!homeScopeLocationPromise) {
+    homeScopeLocationPromise = readBridge()
+      .getHomeScopeLocation()
+      .catch((err) => {
+        homeScopeLocationPromise = null;
+        throw err;
+      });
+  }
+  return homeScopeLocationPromise;
+}
+
+export async function ensureHomeScopeProject(): Promise<Project> {
+  const location = await loadHomeScopeLocation();
+  return useAppStore.getState().ensureHomeProject(location);
+}
+
 export function setProjectDisabled(projectId: string, disabled: boolean): void {
   const store = useAppStore.getState();
   const project = store.projects.find((p) => p.id === projectId);

src/renderer/actions/threadActions.ts

@@ -1,4 +1,5 @@
 import { startTransition } from "react";
+import { isHomeProject } from "@/shared/homeScope";
 import { isDraftPaneId } from "@/shared/paneId";
 import { readBridge } from "@/renderer/bridge";
 import { useAppStore } from "@/renderer/state/appStore";
@@ -20,7 +21,13 @@ let openThreadRequestId = 0;
 export function openNewThread(projectId?: string): void {
   openThreadRequestId += 1;
   const store = useAppStore.getState();
-  const targetProjectId = projectId ?? getCurrentProjectId() ?? store.projects[0]?.id;
+  const targetProjectId =
+    projectId ??
+    getCurrentProjectId() ??
+    (useSharedSettings.getState().homeScopeEnabled
+      ? store.projects.find(isHomeProject)?.id
+      : undefined) ??
+    store.projects.find((project) => !project.disabled && !isHomeProject(project))?.id;
   startTransition(() => {
     if (!targetProjectId) {
       useAppStore.getState().openHome();

src/renderer/app.test.tsx

@@ -14,6 +14,9 @@ const { bridge } = vi.hoisted(() => ({
       .fn<() => Promise<{ windows: unknown[]; wsl: unknown[]; fromCache: boolean }>>()
       .mockResolvedValue({ windows: [], wsl: [], fromCache: false }),
     getThreadSnapshots: vi.fn<() => Promise<unknown[]>>().mockResolvedValue([]),
+    getHomeScopeLocation: vi
+      .fn<() => Promise<{ kind: "windows"; path: string }>>()
+      .mockResolvedValue({ kind: "windows", path: "C:\\Users\\demo" }),
     dbGetThreadRuntimeItems: vi
       .fn<(threadId: string) => Promise<unknown[]>>()
       .mockResolvedValue([]),

src/renderer/components/common/ProviderModelMenu/ProviderModelMenu.tsx

@@ -58,7 +58,11 @@ export interface ProviderModelMenuProps {
   hideLabelOnWrap?: boolean;
   forceHideLabel?: boolean;
   openSignal?: number;
-  onChange: (next: { agentKind: string; model: string }) => void;
+  onChange: (next: {
+    agentKind: string;
+    model: string;
+    presentationMode?: ThreadPresentationMode;
+  }) => void;
   onOpenChange?: (open: boolean) => void;
 }
 
@@ -320,7 +324,11 @@ export function ProviderModelMenu(props: ProviderModelMenuProps) {
     // context/fast resolution doesn't block the close animation.
     handleOpenChange(false);
     startTransition(() => {
-      onChange({ agentKind: selected.providerKind, model: selected.modelId });
+      onChange({
+        agentKind: selected.providerKind,
+        model: selected.modelId,
+        ...(selected.presentationMode ? { presentationMode: selected.presentationMode } : {}),
+      });
     });
   }
 
@@ -409,8 +417,12 @@ export function ProviderModelMenu(props: ProviderModelMenuProps) {
               items={items}
               selectedKeys={selectedKeys}
               scrollRef={windowedListRef}
-              toggleFavorite={(providerKind, modelId) =>
-                toggleFavoriteModel(providerKind, modelId, presentationMode ?? "terminal")
+              toggleFavorite={(providerKind, modelId, rowPresentationMode) =>
+                toggleFavoriteModel(
+                  providerKind,
+                  modelId,
+                  rowPresentationMode ?? presentationMode ?? "terminal",
+                )
               }
               onSelect={handleSelect}
             />
@@ -426,7 +438,11 @@ function WindowedProviderModelList(props: {
   items: ProviderModelItem[];
   selectedKeys: Set<string>;
   scrollRef: RefObject<HTMLDivElement | null>;
-  toggleFavorite: (providerKind: string, modelId: string) => void;
+  toggleFavorite: (
+    providerKind: string,
+    modelId: string,
+    presentationMode: ThreadPresentationMode | undefined,
+  ) => void;
   onSelect: (itemId: string) => void;
 }) {
   const { domIdPrefix, items, selectedKeys, scrollRef, toggleFavorite, onSelect } = props;
@@ -748,7 +764,7 @@ function WindowedProviderModelList(props: {
                 onPointerUp={(event) => event.stopPropagation()}
                 onClick={(event) => {
                   event.stopPropagation();
-                  toggleFavorite(item.providerKind, item.modelId);
+                  toggleFavorite(item.providerKind, item.modelId, item.presentationMode);
                 }}
               >
                 <Star className="size-3.5" fill={item.isFavorite ? "currentColor" : "none"} />

src/renderer/components/common/ProviderModelMenu/parts/buildItems.ts

@@ -6,6 +6,7 @@ export interface ProviderModelMenuProvider {
   kind: string;
   label: string;
   icon?: string;
+  presentationMode?: ThreadPresentationMode;
   capabilities: AgentCapability;
 }
 
@@ -58,6 +59,7 @@ const PROVIDER_ORDER: readonly string[] = [
   "claude",
   "codex",
   "gemini",
+  "antigravity",
   "opencode",
   "cursor",
   "copilot",
@@ -357,6 +359,7 @@ export function buildProviderModelItems(input: BuildProviderModelItemsInput): Pr
         providerKind: m.ref.agentKind,
         modelId: m.ref.modelId,
         label: m.label,
+        ...(m.ref.presentationMode ? { presentationMode: m.ref.presentationMode } : {}),
         ...(providerIcon ? { providerIcon } : {}),
         ...(m.subProviderLabel ? { subProviderLabel: m.subProviderLabel } : {}),
         ...modelHintProps(m),
@@ -419,6 +422,7 @@ export function buildProviderModelItems(input: BuildProviderModelItemsInput): Pr
           providerKind: provider.kind,
           modelId: m.id,
           label: m.label,
+          ...(provider.presentationMode ? { presentationMode: provider.presentationMode } : {}),
           ...(provider.icon ? { providerIcon: provider.icon } : {}),
           ...(m.subLabel ? { subProviderLabel: m.subLabel } : {}),
           ...modelHintProps(m),
@@ -452,6 +456,7 @@ export function buildProviderModelItems(input: BuildProviderModelItemsInput): Pr
         providerKind: provider.kind,
         modelId: m.id,
         label: m.label,
+        ...(provider.presentationMode ? { presentationMode: provider.presentationMode } : {}),
         ...(provider.icon ? { providerIcon: provider.icon } : {}),
         ...modelHintProps(m),
         ...(m.tooltipDescription ? { tooltipDescription: m.tooltipDescription } : {}),
@@ -478,6 +483,7 @@ export function buildProviderModelItems(input: BuildProviderModelItemsInput): Pr
           providerKind: provider.kind,
           modelId: m.id,
           label: m.label,
+          ...(provider.presentationMode ? { presentationMode: provider.presentationMode } : {}),
           ...(provider.icon ? { providerIcon: provider.icon } : {}),
           ...modelHintProps(m),
           ...(m.tooltipDescription ? { tooltipDescription: m.tooltipDescription } : {}),