@omercnet/paseo-shared-browser 3.0.0-next.284.1 → 3.0.0-next.292.1

package/OVERVIEW.md

@@ -13,7 +13,7 @@ New agents whose provider accepts external MCP servers receive a local MCP serve
 
 ## Setup
 
-- Paseo ^0.12.0 || ^0.13.0, and Node.js 24 or newer on the daemon host.
+- Paseo ^0.13.0, and Node.js 24 or newer on the daemon host.
 - Chromium is downloaded when the plugin is installed and stored in the Paseo data directory. On Linux ARM64 nothing is downloaded, and you install a non-Snap Chromium at `/usr/bin/chromium` first. `PASEO_SHARED_BROWSER_CHROMIUM_EXECUTABLE` points the plugin at a different Chromium.
 
 ## Limits

package/README.md

@@ -183,7 +183,9 @@ User-supplied `AGENT_BROWSER_*` variables are deliberately ignored.
   within the pane, scroll long lists, and dismiss with an outside press, Escape or native Back.
 - The monitor menu offers **Fit to panel** (default) and **Actual size (100%)**. Actual size
   uses browser layout pixels, not the larger JPEG dimensions of sharper phone captures.
-  This choice affects only the current viewer, without resizing the shared browser.
+  This choice affects only the current viewer, without resizing the shared browser. Each
+  Shared Browser tab remembers its choice and its selected browser page across app reloads;
+  a remembered page that no longer exists falls back to the default page.
   Desktop local scrollbars reveal overflow while wheel events on a controlled frame go to
   the remote page. Phone viewers can pan while observing; controlling sends swipes to the
   page instead. Fitting images stay centered without empty scroll ranges; a scrollbar on
@@ -422,7 +424,7 @@ runs the actual Paseo compiler on both plugin entries.
 Release Please maintains the version, changelog, component tag, and GitHub release from
 Conventional Commits in the monorepo.
 
-Both the Paseo daemon and app must satisfy `^0.12.0 || ^0.13.0`. Encoded video is opt-in on the daemon and
+Both the Paseo daemon and app must satisfy `^0.13.0`. Encoded video is opt-in on the daemon and
 requires WebCodecs in a web client; JPEG is always available. The client surface uses React
 Native primitives and works in desktop, web, iOS, and Android Paseo clients.
 

package/client/browser-chrome.tsx

@@ -1,6 +1,6 @@
 /** Public themed panel controls and notices. Leaves own only focus/hover styling, never browser authority. */
 import type { PluginWorkspacePanelProps } from "@getpaseo/plugin/client";
-import { Icon, TextInput } from "@getpaseo/plugin/client/react-native";
+import { Icon, TextInput } from "@getpaseo/plugin/client/ui";
 import { type ReactNode, useCallback, useState } from "react";
 import {
   ActivityIndicator,

package/client/browser-compose-controls.test.tsx

@@ -33,7 +33,7 @@ vi.mock("react", () => ({
     hooks.effects.push(effect);
   },
 }));
-vi.mock("@getpaseo/plugin/client/react-native", () => {
+vi.mock("@getpaseo/plugin/client/ui", () => {
   const Modal = Object.assign(() => null, { Content: () => null });
   return { Modal, TextInput: () => null };
 });

package/client/browser-compose-controls.tsx

@@ -1,6 +1,6 @@
 /** Explicit Compose draft UI, with original control/document ownership pinned until Done. */
 import type { PluginWorkspacePanelProps } from "@getpaseo/plugin/client";
-import { Modal, TextInput } from "@getpaseo/plugin/client/react-native";
+import { Modal, TextInput } from "@getpaseo/plugin/client/ui";
 import { useEffect, useRef, useState } from "react";
 import { Text, View } from "react-native";
 import { ControlButton } from "./browser-chrome";

package/client/browser-control-button.tsx

@@ -1,5 +1,5 @@
 import type { PluginWorkspacePanelProps } from "@getpaseo/plugin/client";
-import { Icon } from "@getpaseo/plugin/client/react-native";
+import { Icon } from "@getpaseo/plugin/client/ui";
 import { useCallback, useState } from "react";
 import { Pressable, Text, type TextStyle, type ViewStyle } from "react-native";
 

package/client/browser-control-dialog.tsx

@@ -1,6 +1,6 @@
 /** Confirm a one-time control request before the selected tab action continues. */
 import type { PluginWorkspacePanelProps } from "@getpaseo/plugin/client";
-import { Icon, Modal } from "@getpaseo/plugin/client/react-native";
+import { Icon, Modal } from "@getpaseo/plugin/client/ui";
 import type { BrowserState } from "../shared/browser";
 import { ControlButton } from "./browser-chrome";
 import type { ControlRequest } from "./browser-control-request";

package/client/browser-panel-state.test.ts

@@ -0,0 +1,23 @@
+import { describe, expect, it } from "vitest";
+import { browserPanelStateSchema, DEFAULT_BROWSER_PANEL_STATE } from "./browser-panel-state";
+
+describe("persisted browser panel state", () => {
+  it("round-trips a remembered tab and display mode", () => {
+    const state = { scaleMode: "actual", selectedTabId: "page-2" };
+    expect(browserPanelStateSchema.parse(state)).toEqual(state);
+  });
+
+  it("accepts its own default", () => {
+    expect(browserPanelStateSchema.safeParse(DEFAULT_BROWSER_PANEL_STATE).success).toBe(true);
+  });
+
+  it("rejects state that a newer or older plugin version could have written", () => {
+    expect(browserPanelStateSchema.safeParse(undefined).success).toBe(false);
+    expect(
+      browserPanelStateSchema.safeParse({ scaleMode: "zoom", selectedTabId: null }).success,
+    ).toBe(false);
+    expect(browserPanelStateSchema.safeParse({ scaleMode: "fit", selectedTabId: 3 }).success).toBe(
+      false,
+    );
+  });
+});

package/client/browser-panel-state.ts

@@ -0,0 +1,14 @@
+/** Per-tab state Paseo persists across tab restoration and app reloads. */
+import { z } from "zod";
+import { browserTabIdSchema } from "../shared/browser";
+
+export const browserPanelStateSchema = z.object({
+  scaleMode: z.enum(["fit", "actual"]),
+  selectedTabId: browserTabIdSchema.nullable(),
+});
+export type BrowserPanelState = z.infer<typeof browserPanelStateSchema>;
+
+export const DEFAULT_BROWSER_PANEL_STATE: BrowserPanelState = {
+  scaleMode: "fit",
+  selectedTabId: null,
+};

package/client/browser-resolution-picker.tsx

@@ -1,6 +1,6 @@
 /** Grouped resolution choices with independent host favorites and capture quality. */
 import type { PluginHostProps } from "@getpaseo/plugin/client";
-import { Icon } from "@getpaseo/plugin/client/react-native";
+import { Icon } from "@getpaseo/plugin/client/ui";
 import { Pressable, StyleSheet, Text, View } from "react-native";
 import type { BrowserDisplayPreferences } from "../shared/browser-display-preferences";
 import type { DevicePresetId } from "../shared/device-presets";

package/client/browser-toolbar-menu.tsx

@@ -4,7 +4,7 @@
  * host internals. Placement stays inside the pane, including compact clients.
  */
 import type { PluginHostProps } from "@getpaseo/plugin/client";
-import { Icon } from "@getpaseo/plugin/client/react-native";
+import { Icon } from "@getpaseo/plugin/client/ui";
 import {
   type ReactNode,
   type RefObject,

package/client/browser-viewer-recovery.test.ts

@@ -3,6 +3,7 @@ import { describe, expect, it } from "vitest";
 import {
   createBrowserViewerRecovery,
   isBrowserClosedError,
+  isBrowserTabUnavailableError,
   isExpiredBrowserViewerError,
 } from "./browser-viewer-recovery";
 
@@ -109,3 +110,26 @@ it("the actual capture query observer discards old token errors when its token k
     client.clear();
   }
 });
+
+describe("remembered tab recovery", () => {
+  it("recognizes only the unavailable-tab rejection", () => {
+    const unavailable = Object.assign(
+      new Error(
+        "Request failed: Workspace runtime identity failed: Browser tab is no longer available requestType=plugin.rpc.invoke.request code=handler_error",
+      ),
+      { code: "handler_error" },
+    );
+    expect(isBrowserTabUnavailableError(unavailable)).toBe(true);
+    expect(isBrowserTabUnavailableError(new Error("Browser tab is no longer available"))).toBe(
+      true,
+    );
+    expect(isBrowserTabUnavailableError(expired)).toBe(false);
+    expect(isBrowserTabUnavailableError(new Error("Browser is closed"))).toBe(false);
+    expect(
+      isBrowserTabUnavailableError(
+        new Error("Could not parse: Browser tab is no longer available"),
+      ),
+    ).toBe(false);
+    expect(isBrowserTabUnavailableError(null)).toBe(false);
+  });
+});

package/client/browser-viewer-recovery.ts

@@ -5,6 +5,11 @@
  */
 const VIEWER_EXPIRED_MESSAGE = "Viewer token is invalid or expired";
 const BROWSER_CLOSED_MESSAGE = "Browser is closed";
+const BROWSER_TAB_UNAVAILABLE_MESSAGE = "Browser tab is no longer available";
+// The supervisor wraps runtime rejections as "Workspace runtime <operation> failed: <message>".
+const UNAVAILABLE_TAB_PATTERN = new RegExp(
+  `^(?:Workspace runtime \\w+ failed: )?${BROWSER_TAB_UNAVAILABLE_MESSAGE}(?: requestType=|$)`,
+);
 
 /** Recognize the server's explicit close fence without confusing it with a transport failure. */
 export function isBrowserClosedError(error: unknown): boolean {
@@ -76,3 +81,18 @@ export function createBrowserViewerRecovery() {
     return true;
   };
 }
+
+/**
+ * A remembered tab can outlive its page; the server then rejects attaching to it. The runtime
+ * wraps that rejection ("Workspace runtime identity failed: ..."), so match the phrase.
+ */
+export function isBrowserTabUnavailableError(error: unknown): boolean {
+  if (!error || typeof error !== "object") return false;
+  const value = error as { message?: unknown; code?: unknown };
+  if (typeof value.message !== "string") return false;
+  if (value.code !== undefined && value.code !== "handler_error") return false;
+  const message = value.message.startsWith("Request failed: ")
+    ? value.message.slice("Request failed: ".length)
+    : value.message;
+  return UNAVAILABLE_TAB_PATTERN.test(message);
+}

package/client/browser.tsx

@@ -4,8 +4,8 @@
  * presentation models live in focused counterpart hooks; this module never
  * replays published mutations or substitutes visible pixels for input authority.
  */
-import { type PluginWorkspacePanelProps, useRpc } from "@getpaseo/plugin/client";
-import { Icon, Modal } from "@getpaseo/plugin/client/react-native";
+import { type PluginWorkspacePanelProps, useRpc, useTabState } from "@getpaseo/plugin/client";
+import { Icon, Modal } from "@getpaseo/plugin/client/ui";
 import { useQuery, useQueryClient } from "@tanstack/react-query";
 import {
   type ReactNode,
@@ -53,7 +53,7 @@ import {
   type CaptureDensityMode,
   getAutomaticCaptureDensity,
 } from "./browser-auto-capture-density";
-import { type BrowserCanvasDisplayMode, getBrowserCanvasLayout } from "./browser-canvas-layout";
+import { getBrowserCanvasLayout } from "./browser-canvas-layout";
 import { BrowserCanvasViewport } from "./browser-canvas-viewport";
 import {
   CanvasPlaceholder,
@@ -75,6 +75,7 @@ import { type EmulationSelection, matchingResolutionPresetId } from "./browser-e
 import { getFillViewportResolution } from "./browser-fill-viewport";
 import type { FrameCandidate } from "./browser-frame-buffer";
 import { BrowserFrameImage } from "./browser-frame-image";
+import { browserPanelStateSchema, DEFAULT_BROWSER_PANEL_STATE } from "./browser-panel-state";
 import { createStyles, DIMENSION, SPACE } from "./browser-panel-styles";
 import { BrowserResolutionPicker } from "./browser-resolution-picker";
 import { BrowserTabs } from "./browser-tabs";
@@ -86,7 +87,11 @@ import {
 } from "./browser-toolbar-menu";
 import { isFrameCurrent, isVideoSourceCurrent } from "./browser-video-currency";
 import { BrowserVideoSurface } from "./browser-video-surface";
-import { isBrowserClosedError, isExpiredBrowserViewerError } from "./browser-viewer-recovery";
+import {
+  isBrowserClosedError,
+  isBrowserTabUnavailableError,
+  isExpiredBrowserViewerError,
+} from "./browser-viewer-recovery";
 import { createFrameLifecycle } from "./frame-lifecycle";
 import { useBrowserAutoCaptureDensity } from "./use-browser-auto-capture-density";
 import { useBrowserCanvasInput } from "./use-browser-canvas-input";
@@ -188,6 +193,7 @@ export function SharedBrowserPanel({
   host,
   layout,
   workspaceId,
+  tab,
 }: PluginWorkspacePanelProps) {
   const queryClient = useQueryClient();
   const styles = useMemo(() => createStyles(theme, layout.compact), [theme, layout.compact]);
@@ -245,7 +251,38 @@ export function SharedBrowserPanel({
   const [operationError, setOperationError] = useState<string | null>(null);
   const [reconnecting, setReconnecting] = useState(false);
   const [browserClosed, setBrowserClosed] = useState(false);
-  const [selectedTabId, setSelectedTabId] = useState<string | null>(null);
+  const [panelState, writePanelState] = useTabState(
+    tab,
+    browserPanelStateSchema,
+    DEFAULT_BROWSER_PANEL_STATE,
+  );
+  // Writes replace the whole persisted value; merge into the latest one so two
+  // updates in the same tick (e.g. Fill viewport) cannot drop each other.
+  const panelStateRef = useRef(panelState);
+  panelStateRef.current = panelState;
+  const updatePanelState = useCallback(
+    (patch: Partial<typeof panelState>) => {
+      const next = { ...panelStateRef.current, ...patch };
+      if (
+        next.scaleMode === panelStateRef.current.scaleMode &&
+        next.selectedTabId === panelStateRef.current.selectedTabId
+      ) {
+        return;
+      }
+      panelStateRef.current = next;
+      writePanelState(next);
+    },
+    [writePanelState],
+  );
+  const { selectedTabId, scaleMode } = panelState;
+  const setSelectedTabId = useCallback(
+    (tabId: string | null) => updatePanelState({ selectedTabId: tabId }),
+    [updatePanelState],
+  );
+  const setScaleMode = useCallback(
+    (mode: typeof scaleMode) => updatePanelState({ scaleMode: mode }),
+    [updatePanelState],
+  );
   const selectedTabIdRef = useRef(selectedTabId);
   selectedTabIdRef.current = selectedTabId;
   const [tabMutationPending, setTabMutationPending] = useState(false);
@@ -268,7 +305,6 @@ export function SharedBrowserPanel({
   const [keysSubmenuOpen, setKeysSubmenuOpen] = useState(false);
   const keysAnchorRef = useRef<View | null>(null);
   const [toolbarMenu, setToolbarMenu] = useState<"display" | "actions" | null>(null);
-  const [scaleMode, setScaleMode] = useState<BrowserCanvasDisplayMode>("fit");
   const paneRef = useRef<View | null>(null);
   const displayAnchorRef = useRef<View | null>(null);
   const actionsAnchorRef = useRef<View | null>(null);
@@ -426,6 +462,12 @@ export function SharedBrowserPanel({
     if (isBrowserClosedError(attachQuery.error)) setBrowserClosed(true);
   }, [attachQuery.error]);
 
+  // A restored selection can name a page that no longer exists; without the
+  // attach there is no viewer to list tabs with, so fall back to the default page.
+  useEffect(() => {
+    if (selectedTabId && isBrowserTabUnavailableError(attachQuery.error)) setSelectedTabId(null);
+  }, [attachQuery.error, selectedTabId, setSelectedTabId]);
+
   useEffect(() => {
     if (!closedView) return;
     setControlRequest(null);
@@ -457,13 +499,21 @@ export function SharedBrowserPanel({
     setOperationError(null);
     setRuntimeNotice(null);
     setBrowserClosed(false);
-    setSelectedTabId(null);
     setTabCloseConfirmationOpen(false);
     setControlRequest(null);
     setPendingControlAction(null);
     setCloseConfirmationOpen(false);
   }, [reset, workspaceId, host.id, inputLifecycle]);
 
+  // The remembered tab belongs to this host and workspace. Keep it on mount,
+  // where it was just restored, and clear it only when the scope really changes.
+  const selectionScopeRef = useRef(panelScope);
+  useEffect(() => {
+    if (selectionScopeRef.current === panelScope) return;
+    selectionScopeRef.current = panelScope;
+    setSelectedTabId(null);
+  }, [panelScope, setSelectedTabId]);
+
   useEffect(() => {
     // A tab selection changes the viewer's page and frame authority, even
     // though the underlying Chromium process and saved profile stay shared.

package/index.client.tsx

@@ -7,7 +7,6 @@ export default function contribute(client: PluginClientContext) {
     id: "shared-browser",
     title: "Shared Browser",
     icon: "PanelsTopLeft",
-    context: "workspace",
     locations: ["workspace", "explorer"],
     Component: SharedBrowserPanel,
   });

package/npm-shrinkwrap.json

@@ -8,7 +8,7 @@
       "name": "@omercnet/paseo-shared-browser",
       "version": "3.0.0",
       "dependencies": {
-        "@getpaseo/plugin": "0.13.0-beta.2",
+        "@getpaseo/plugin": "0.13.0",
         "@modelcontextprotocol/sdk": "1.30.0",
         "agent-browser": "0.39.1",
         "esbuild": "0.28.2",
@@ -441,29 +441,29 @@
       }
     },
     "node_modules/@getpaseo/client": {
-      "version": "0.13.0-beta.2",
-      "resolved": "https://registry.npmjs.org/@getpaseo/client/-/client-0.13.0-beta.2.tgz",
-      "integrity": "sha512-f8tSt3fMpDvKjWespbKjGZa9Y5bszWpCnde2hJEAATcLRCobGPpCueWA6Vj7qsQ7oa7WpzbAnqysswS4IWkJHg==",
+      "version": "0.13.0",
+      "resolved": "https://registry.npmjs.org/@getpaseo/client/-/client-0.13.0.tgz",
+      "integrity": "sha512-379gl/OHIowATqKBZugupxX6HaOPWQhkOeVnlMQNWnZ5oKbyfCTEPGSkzA8Kotvv1Uue2u+j8z2WnLXyZ9ChYQ==",
       "peer": true,
       "dependencies": {
-        "@getpaseo/protocol": "0.13.0-beta.2",
-        "@getpaseo/relay": "0.13.0-beta.2",
+        "@getpaseo/protocol": "0.13.0",
+        "@getpaseo/relay": "0.13.0",
         "ws": "^8.20.0",
         "zod": "^4.4.3"
       }
     },
     "node_modules/@getpaseo/plugin": {
-      "version": "0.13.0-beta.2",
-      "resolved": "https://registry.npmjs.org/@getpaseo/plugin/-/plugin-0.13.0-beta.2.tgz",
-      "integrity": "sha512-c0E0gCyhIDWJk8Lhjf9n5dch6QAKKQm/gS9xGRRIxzhnUMHeBgSJTl017NzBjs7cxsnEPaDv2N8Fmo2apD9tyw==",
+      "version": "0.13.0",
+      "resolved": "https://registry.npmjs.org/@getpaseo/plugin/-/plugin-0.13.0.tgz",
+      "integrity": "sha512-8aGH0lf5kF9yjaM0dVsm8Awu5eB2jHhmbX9ljgf6+jttNWX3XRbRNeylg3whPoKORGrJNlpuLx3XvJMC5KSCaQ==",
       "dependencies": {
         "@agentclientprotocol/sdk": "^1.4.0",
         "i18next": "^26.3.0",
         "use-sync-external-store": "^1.6.0"
       },
       "peerDependencies": {
-        "@getpaseo/client": "0.13.0-beta.2",
-        "@getpaseo/protocol": "0.13.0-beta.2",
+        "@getpaseo/client": "0.13.0",
+        "@getpaseo/protocol": "0.13.0",
         "react": ">=19.1.0 <20",
         "react-native": ">=0.81.5",
         "zod": "^4.4.3"
@@ -475,9 +475,9 @@
       }
     },
     "node_modules/@getpaseo/protocol": {
-      "version": "0.13.0-beta.2",
-      "resolved": "https://registry.npmjs.org/@getpaseo/protocol/-/protocol-0.13.0-beta.2.tgz",
-      "integrity": "sha512-1C3nPR4Cj1E12LpTpnQr9g7xFce2ZT/KVGPKzfziNrS+7VPPUFT/oJufiwPtDtndWlV5fN1zTeSWnMCwYnvXpw==",
+      "version": "0.13.0",
+      "resolved": "https://registry.npmjs.org/@getpaseo/protocol/-/protocol-0.13.0.tgz",
+      "integrity": "sha512-g5Hp6QP5hV7KTCrSRBVye2+qhptwnhhLXRn6PHaS1L8PgmeRh5LvrE8PZq3HRq8B1WxflVDuV2WRB2Z3FNcvJA==",
       "peer": true,
       "dependencies": {
         "semver": "^7.8.5",
@@ -485,9 +485,9 @@
       }
     },
     "node_modules/@getpaseo/relay": {
-      "version": "0.13.0-beta.2",
-      "resolved": "https://registry.npmjs.org/@getpaseo/relay/-/relay-0.13.0-beta.2.tgz",
-      "integrity": "sha512-W7IILPB+TvX1qFa9NQFq/5+8AFlbf1XhFIC2DXD13pBIdjj1vJ+bSlOEbNOakAlF5QyE4pwxcHt/CfyCDmSrVg==",
+      "version": "0.13.0",
+      "resolved": "https://registry.npmjs.org/@getpaseo/relay/-/relay-0.13.0.tgz",
+      "integrity": "sha512-Yd/RR+2hStTEtmkutwE21drjVmgz+RnQWyjmoh1++dPysp2oNsrimurnbfN0yoBJ5xXWlyuvn8Sr7CziTpkv7Q==",
       "peer": true,
       "dependencies": {
         "@noble/ciphers": "^2.4.0",
@@ -1229,9 +1229,9 @@
       }
     },
     "node_modules/i18next": {
-      "version": "26.5.6",
-      "resolved": "https://registry.npmjs.org/i18next/-/i18next-26.5.6.tgz",
-      "integrity": "sha512-GFWrDwGmYhOQS3bKvjA2Ir2ob9ScEdyY1UbeQJ10jyVACGQ6XxmDYqC/lxEj/IPEJlPQYNRnYffDET6TM8mnFg==",
+      "version": "26.5.8",
+      "resolved": "https://registry.npmjs.org/i18next/-/i18next-26.5.8.tgz",
+      "integrity": "sha512-EQx2RyhwINMekbykhZpAJQ2ILeJqnYOpRjWEkSVv45pR8yeVbb0thr2zxQ+dOo365OIb7h06BKPtt16WE8Wliw==",
       "funding": [
         {
           "type": "individual",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omercnet/paseo-shared-browser",
-  "version": "3.0.0-next.284.1",
+  "version": "3.0.0-next.292.1",
   "description": "One real Chromium session per Paseo workspace, shared live across every connected client.",
   "keywords": [
     "browser",
@@ -54,7 +54,7 @@
     "test:video": "vitest run tests/video.smoke.test.ts --testTimeout=30000"
   },
   "dependencies": {
-    "@getpaseo/plugin": "0.13.0-beta.2",
+    "@getpaseo/plugin": "0.13.0",
     "@modelcontextprotocol/sdk": "1.30.0",
     "agent-browser": "0.39.1",
     "esbuild": "0.28.2",
@@ -62,7 +62,7 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.10",
-    "@getpaseo/server": "0.13.0-beta.2",
+    "@getpaseo/server": "0.13.0",
     "@tanstack/react-query": "^5.102.3",
     "@types/node": "^24.10.1",
     "@types/react": "^19.2.18",

package/paseo-plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "shared-browser",
   "description": "One real Chromium session per Paseo workspace, shared live across every connected client.",
-  "requirements": { "paseo": "^0.12.0 || ^0.13.0" },
+  "requirements": { "paseo": "^0.13.0" },
   "build": [["node", "scripts/prepare-dependencies.mjs"], ["npm", "run", "prepare:runtime"]]
 }