@omercnet/paseo-shared-browser 0.4.2-next.133.1 → 0.4.2-next.146.1

package/README.md

@@ -148,9 +148,9 @@ User-supplied `AGENT_BROWSER_*` variables are deliberately ignored.
   isolation boundary between local OS users.
 - `agent-browser` IPC metadata and workspace profile directories are owner-only on POSIX systems.
   The plugin rejects a non-loopback CDP endpoint.
-- Viewer and control tokens coordinate clients already paired to the same Paseo daemon. Paseo v0.8
-  plugin RPC callbacks expose no authenticated caller identity, so these human-viewer tokens are a
-  workflow safeguard, not an authorization boundary. The stdio MCP adapter separately uses an
+- Viewer and control tokens coordinate clients already paired to the same Paseo daemon. Plugin RPC
+  callbacks expose no authenticated caller identity, so these human-viewer tokens are a workflow
+  safeguard, not an authorization boundary. The stdio MCP adapter separately uses an
   opaque, workspace-bound credential.
 - Downloads, uploads, clipboard synchronization, media permissions, extensions, native passkeys,
   and platform authenticators are not exposed by this plugin.
@@ -176,6 +176,5 @@ persistence, and archive teardown.
 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.8.0 <0.10.0`, which supports Paseo 0.8
-and Paseo 0.9. The client surface uses React Native primitives and works in desktop, web, iOS,
-and Android Paseo clients.
+Both the Paseo daemon and app must satisfy `^0.9.0`. The client surface uses React Native primitives
+and works in desktop, web, iOS, and Android Paseo clients.

package/client/browser.tsx

@@ -72,6 +72,7 @@ const CAPTURE_INTERVAL_READY = 250;
 const CAPTURE_INTERVAL_WAITING = 1_500;
 const MAX_VIEWER_LABEL_LENGTH = 64;
 const PILL_PRESENCE_POLL_MS = 2_000;
+const AGENT_DIRECTORY_PAGE_LIMIT = 200;
 const MAX_URL_LENGTH = 8_192;
 const MAX_TEXT_LENGTH = 4_000;
 const BYTES_PER_KIBIBYTE = 1_024;
@@ -803,18 +804,33 @@ function CanvasPlaceholder({
   );
 }
 
+interface AgentDirectoryPage {
+  entries: Array<{ agent: { id: string; workspaceId?: string | undefined } }>;
+  pageInfo: { hasMore: boolean; nextCursor: string | null };
+}
+
+type AgentDirectoryUpdate =
+  | { kind: "remove"; agentId: string }
+  | { kind: "upsert"; agent: { id: string; workspaceId?: string | undefined } };
+type AgentPlacement = { id: string; workspaceId: string };
+
 export function contributeSharedBrowserClient(client: PluginClientContext) {
-  const agents = new Map<string, { id: string; workspaceId: string }>();
+  const agents = new Map<string, AgentPlacement>();
   const pills = new Map<string, { workspaceId: string; remove: () => void }>();
+  const lifetime = new AbortController();
   let openWorkspaceIds = new Set<string>();
   let refreshing = false;
   let stopped = false;
+  let directoryGeneration = 0;
+  let pendingDirectory: { generation: number; updates: AgentDirectoryUpdate[] } | null = null;
+  let unsubscribeDirectory: (() => void) | null = null;
+  let releaseDirectory: (() => Promise<void>) | null = null;
 
   const removePill = (agentId: string) => {
     pills.get(agentId)?.remove();
     pills.delete(agentId);
   };
-  const syncPill = (agent: { id: string; workspaceId: string }) => {
+  const syncPill = (agent: AgentPlacement) => {
     const current = pills.get(agent.id);
     if (!openWorkspaceIds.has(agent.workspaceId)) {
       removePill(agent.id);
@@ -858,32 +874,94 @@ export function contributeSharedBrowserClient(client: PluginClientContext) {
       refreshing = false;
     }
   };
-
-  const unsubscribe = client.paseo.agents.subscribe((update) => {
+  const applyUpdate = (target: Map<string, AgentPlacement>, update: AgentDirectoryUpdate) => {
+    if (update.kind === "remove") {
+      target.delete(update.agentId);
+      return;
+    }
+    const { id, workspaceId } = update.agent;
+    if (workspaceId) target.set(id, { id, workspaceId });
+    else target.delete(id);
+  };
+  const applyLiveUpdate = (update: AgentDirectoryUpdate) => {
+    if (stopped) return;
+    pendingDirectory?.updates.push(update);
+    applyUpdate(agents, update);
     if (update.kind === "remove") {
-      agents.delete(update.agentId);
       removePill(update.agentId);
       return;
     }
     const { id, workspaceId } = update.agent;
     if (!workspaceId) {
-      agents.delete(id);
       removePill(id);
       return;
     }
-    const agent = { id, workspaceId };
-    agents.set(id, agent);
-    syncPill(agent);
+    syncPill({ id, workspaceId });
     void refreshPresence();
-  });
-  void client.paseo.agents
-    .list()
-    .then(async ({ entries }) => {
-      for (const { agent } of entries) {
-        if (agent.workspaceId)
-          agents.set(agent.id, { id: agent.id, workspaceId: agent.workspaceId });
+  };
+  const replaceAgents = (next: Map<string, AgentPlacement>) => {
+    for (const agentId of agents.keys()) {
+      if (!next.has(agentId)) removePill(agentId);
+    }
+    agents.clear();
+    for (const [agentId, agent] of next) agents.set(agentId, agent);
+    syncAllPills();
+  };
+  const followSnapshot = async (snapshot: AgentDirectoryPage) => {
+    if (stopped) return;
+    const generation = ++directoryGeneration;
+    const transaction = { generation, updates: [] as AgentDirectoryUpdate[] };
+    pendingDirectory = transaction;
+    const next = new Map<string, AgentPlacement>();
+    for (const { agent } of snapshot.entries) {
+      if (agent.workspaceId) next.set(agent.id, { id: agent.id, workspaceId: agent.workspaceId });
+    }
+
+    try {
+      let cursor = snapshot.pageInfo.hasMore ? snapshot.pageInfo.nextCursor : null;
+      while (cursor) {
+        const page = await client.paseo.agents.list({
+          scope: "active",
+          page: { limit: AGENT_DIRECTORY_PAGE_LIMIT, cursor },
+          signal: lifetime.signal,
+        });
+        if (stopped || pendingDirectory?.generation !== generation) return;
+        for (const { agent } of page.entries) {
+          if (agent.workspaceId)
+            next.set(agent.id, { id: agent.id, workspaceId: agent.workspaceId });
+        }
+        cursor = page.pageInfo.hasMore ? page.pageInfo.nextCursor : null;
       }
+      if (stopped || pendingDirectory?.generation !== generation) return;
+      for (const update of transaction.updates) applyUpdate(next, update);
+      pendingDirectory = null;
+      replaceAgents(next);
       await refreshPresence();
+    } catch {
+      if (!stopped && pendingDirectory?.generation === generation) pendingDirectory = null;
+    }
+  };
+
+  void client.paseo.agents
+    .list({
+      scope: "active",
+      page: { limit: AGENT_DIRECTORY_PAGE_LIMIT },
+      subscribe: {},
+      signal: lifetime.signal,
+    })
+    .then(({ subscription }) => {
+      if (stopped) {
+        void subscription.release().catch(() => undefined);
+        return undefined;
+      }
+      releaseDirectory = subscription.release;
+      unsubscribeDirectory = subscription.subscribe({
+        snapshot: (snapshot) => void followSnapshot(snapshot),
+        update: (message) => {
+          if (message.type === "agent_update") applyLiveUpdate(message.payload);
+        },
+      });
+      return undefined;
     })
     .catch(() => undefined);
   const presenceTimer = setInterval(() => void refreshPresence(), PILL_PRESENCE_POLL_MS);
@@ -891,8 +969,12 @@ export function contributeSharedBrowserClient(client: PluginClientContext) {
   return () => {
     if (stopped) return;
     stopped = true;
+    directoryGeneration += 1;
+    pendingDirectory = null;
     clearInterval(presenceTimer);
-    unsubscribe();
+    unsubscribeDirectory?.();
+    void releaseDirectory?.().catch(() => undefined);
+    lifetime.abort();
     for (const { remove } of pills.values()) remove();
     pills.clear();
     agents.clear();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omercnet/paseo-shared-browser",
-  "version": "0.4.2-next.133.1",
+  "version": "0.4.2-next.146.1",
   "description": "One real Chromium session per Paseo workspace, shared live across every connected client.",
   "keywords": [
     "browser",
@@ -42,8 +42,8 @@
     "check:write": "biome check --write .",
     "typecheck": "tsc --noEmit",
     "prepare:runtime": "node scripts/prepare-runtime.mjs",
-    "test": "vitest run tests/contracts.test.ts tests/lease.test.ts tests/runtime-lifecycle.test.ts tests/agent-access.test.ts",
-    "test:unit": "vitest run tests/contracts.test.ts tests/lease.test.ts tests/runtime-lifecycle.test.ts tests/agent-access.test.ts",
+    "test": "vitest run tests/contracts.test.ts tests/lease.test.ts tests/runtime-lifecycle.test.ts tests/agent-access.test.ts tests/composer-pills.test.ts",
+    "test:unit": "vitest run tests/contracts.test.ts tests/lease.test.ts tests/runtime-lifecycle.test.ts tests/agent-access.test.ts tests/composer-pills.test.ts",
     "test:smoke": "vitest run tests/browser.smoke.test.ts --testTimeout=30000"
   },
   "dependencies": {

package/paseo-plugin.json

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

package/server/agent-browser-runtime.ts

@@ -93,6 +93,7 @@ export interface AgentBrowserRuntimeOptions {
   ipcDirectory: string;
   session: string;
   initialUrl?: string;
+  headed?: boolean;
   timeoutMs?: number;
 }
 
@@ -189,6 +190,7 @@ export class AgentBrowserRuntime {
   readonly ipcDirectory: string;
   readonly session: string;
   private readonly initialUrl: string;
+  private readonly headed: boolean;
   private readonly timeoutMs: number;
   private readonly environment: NodeJS.ProcessEnv;
   private connection: CdpConnection | null = null;
@@ -212,6 +214,7 @@ export class AgentBrowserRuntime {
       throw new AgentBrowserIncompatibleError("agent-browser session name is invalid");
     }
     this.session = options.session;
+    this.headed = options.headed ?? false;
     this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
     this.environment = runtimeEnvironment(this.ipcDirectory);
     this.initialUrl = options.initialUrl ?? "about:blank";
@@ -236,6 +239,7 @@ export class AgentBrowserRuntime {
       this.profilePath,
       "--executable-path",
       this.executablePath,
+      ...(this.headed ? ["--headed"] : []),
       ...(chromiumArguments ? ["--args", chromiumArguments] : []),
       "--json",
       "open",

package/server/runtime-owner.ts

@@ -11,12 +11,18 @@ interface OwnedRuntime {
   runtimeId: string;
   runtime: AgentBrowserRuntime;
 }
+interface RuntimeOwnerOptions {
+  initialUrl?: string;
+  headed?: boolean;
+}
 
 function paseoHome(): string {
   return process.env.PASEO_HOME ?? join(homedir(), ".paseo");
 }
 
-export async function createRuntimeOwner(): Promise<RuntimeOwner<OwnedRuntime>> {
+export async function createRuntimeOwner(
+  options: RuntimeOwnerOptions = {},
+): Promise<RuntimeOwner<OwnedRuntime>> {
   const root = join(paseoHome(), "plugin-data", "shared-browser");
   const ipcDirectory =
     process.platform === "win32"
@@ -46,7 +52,8 @@ export async function createRuntimeOwner(): Promise<RuntimeOwner<OwnedRuntime>>
         profilePath: join(root, "profiles", hash),
         ipcDirectory,
         session: `ws-${hash.slice(0, 16)}`,
-        initialUrl: DEFAULT_BROWSER_URL,
+        initialUrl: options.initialUrl ?? DEFAULT_BROWSER_URL,
+        headed: options.headed ?? false,
       });
       await runtime.launch();
       return { runtimeId: randomUUID(), runtime };