paseo-plugin-machine-status 0.3.1 → 0.3.2

package/OVERVIEW.md

@@ -14,7 +14,7 @@ Machine Status shows what the daemon's Mac is doing while your agents work: CPU
 
 ## Setup
 
-- A macOS daemon on Paseo 0.11 to 0.14. On other platforms the screen says it cannot collect metrics.
+- A macOS daemon on Paseo 0.11 or newer. On other platforms the screen says it cannot collect metrics.
 - Docker Desktop, OrbStack or Rancher Desktop for the Docker tab. Without one, the tab says which is missing.
 
 ## What it can change

package/README.md

@@ -11,7 +11,7 @@
 <p align="center">
   <a href="https://github.com/dutchakdev/paseo-plugin-machine-status/actions/workflows/ci.yml"><img src="https://github.com/dutchakdev/paseo-plugin-machine-status/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI"></a>
   <a href="https://www.npmjs.com/package/paseo-plugin-machine-status"><img src="https://img.shields.io/npm/v/paseo-plugin-machine-status" alt="npm"></a>
-  <img src="https://img.shields.io/badge/Paseo-0.11.x%20%E2%80%93%200.14.x-3987e5" alt="Supports Paseo 0.11.x through 0.14.x, including betas">
+  <img src="https://img.shields.io/badge/Paseo-0.11%2B-3987e5" alt="Supports Paseo 0.11 and newer, including betas">
   <img src="https://img.shields.io/badge/macOS-only-9aa1a6" alt="macOS only">
   <img src="https://img.shields.io/badge/dependencies-none-c98500" alt="No runtime dependencies">
   <img src="https://img.shields.io/badge/license-MIT-9aa1a6" alt="MIT licensed">
@@ -44,12 +44,12 @@ source that matches your Paseo:
 Paseo 0.11 a bare `owner/name` names a directory entry, so a GitHub source there needs
 the `git:` prefix: `git:dutchakdev/paseo-plugin-machine-status`.
 
-The plugin supports **Paseo 0.11.x through 0.14.x, including betas**, on both the
+The plugin supports **Paseo 0.11 and newer, including betas**, on both the
 daemon, which runs its collectors, and the app, which runs its screens.
 
 The manifest asks for `>=0.11.0` because it declares the icon shown in the plugin
 directory, and Paseo 0.8 to 0.10 refuse a manifest with a field they do not know.
-Paseo also checks a prerelease's stable version core, so `0.14.0-beta.1` satisfies
+Paseo also checks a prerelease's stable version core, so the betas of later releases satisfy
 this range. The 0.11.0 betas pass that check but predate the `icon` field, so they
 refuse the manifest as well and need the release named in the install table; see
 [version requirements](https://paseo.sh/docs/plugins/reference#requirements).
@@ -364,8 +364,8 @@ including a refusal to terminate the test runner itself.
 
 ### Paseo versions
 
-The SDK stays pinned to 0.8.0 for typechecking and tests, so the compiler proves
-the plugin uses only the 0.8 API, which every supported release still provides.
+The SDK stays pinned to 0.11.4 for typechecking and tests, so the compiler proves
+the plugin uses only the 0.11 API, which every supported release still provides.
 Paseo supplies the runtime instances on every supported release line, so none of
 it ships with the plugin.
 

package/client/agent-directory.ts

@@ -0,0 +1,139 @@
+import type { PluginClientContext } from "@getpaseo/plugin/client";
+
+export interface DirectoryAgent {
+  id: string;
+  workspaceId?: string | null;
+  archivedAt?: string | null;
+}
+
+export interface DirectoryListener {
+  /** An agent exists, or changed. */
+  track(agent: DirectoryAgent): void;
+  /** An agent is gone. */
+  hide(agentId: string): void;
+  /** The agents that are known at the moment. */
+  known(): Iterable<string>;
+}
+
+/** The most Paseo returns in one page. */
+const PAGE_LIMIT = 200;
+/** How long after a failure the observation is asked for again; each failure in a row doubles it, up to the cap. */
+export const RETRY_MS = 5_000;
+export const RETRY_CAP_MS = 60_000;
+
+/**
+ * Follows the agent directory through one owned observation.
+ *
+ * Paseo 0.15 keeps a plugin installed across a dropped connection and does not run
+ * its setup again, so a list read once at setup would miss everything that happened
+ * meanwhile. The observation hands over the existing agents and, after each
+ * reconnect, a fresh snapshot of the first page. The rest are read page by page, and
+ * only a directory read to its end removes the agents that went while the app was
+ * away; a page that fails starts the read again later. Paseo gives up an observation
+ * whose request fails after a reconnect, so a failure asks for a new one. Returns
+ * the cleanup.
+ */
+export function followAgents(paseo: PluginClientContext["paseo"], listener: DirectoryListener): () => void {
+  const lifetime = new AbortController();
+  let retry: ReturnType<typeof setTimeout> | undefined;
+  let failures = 0;
+  // Each snapshot starts a new read, and a read still under way gives way to it.
+  let reading = 0;
+  // Agents an update spoke of during a read: a page read after that may be older than the update.
+  const updated = new Set<string>();
+
+  async function catchUp(first: Awaited<ReturnType<typeof paseo.agents.list>>) {
+    const read = ++reading;
+    updated.clear();
+    const listed = new Set<string>();
+    const take = (page: typeof first) => {
+      for (const { agent } of page.entries) {
+        listed.add(agent.id);
+        if (!updated.has(agent.id)) listener.track(agent);
+      }
+    };
+    take(first);
+    let { hasMore, nextCursor } = first.pageInfo;
+    while (hasMore) {
+      // A directory that cannot be read to its end says nothing about the agents it did not reach, so none is removed.
+      if (!nextCursor) return;
+      let page: typeof first;
+      try {
+        page = await paseo.agents.list({ page: { limit: PAGE_LIMIT, cursor: nextCursor } });
+      } catch {
+        if (read === reading) readAgain();
+        return;
+      }
+      if (read !== reading || lifetime.signal.aborted) return;
+      if (page.pageInfo.nextCursor === nextCursor) return;
+      take(page);
+      ({ hasMore, nextCursor } = page.pageInfo);
+    }
+    failures = 0;
+    for (const id of [...listener.known()]) {
+      if (!listed.has(id) && !updated.has(id)) listener.hide(id);
+    }
+  }
+
+  function later(action: () => void) {
+    if (lifetime.signal.aborted) return;
+    clearTimeout(retry);
+    retry = setTimeout(action, Math.min(RETRY_CAP_MS, RETRY_MS * 2 ** failures));
+    failures += 1;
+  }
+
+  function readAgain() {
+    later(() => {
+      const read = reading;
+      void paseo.agents
+        .list({ page: { limit: PAGE_LIMIT } })
+        .then((first) => {
+          if (read === reading && !lifetime.signal.aborted) void catchUp(first);
+          return undefined;
+        })
+        .catch(() => {
+          if (read === reading) readAgain();
+        });
+    });
+  }
+
+  function observeAgain() {
+    later(observe);
+  }
+
+  function observe() {
+    if (lifetime.signal.aborted) return;
+    void paseo.agents
+      .list({ subscribe: {}, page: { limit: PAGE_LIMIT }, signal: lifetime.signal })
+      .then(({ subscription }) => {
+        subscription.subscribe({
+          snapshot(result) {
+            if (lifetime.signal.aborted) return;
+            clearTimeout(retry);
+            failures = 0;
+            void catchUp(result);
+          },
+          update(message) {
+            if (lifetime.signal.aborted || message.type !== "agent_update") return;
+            const update = message.payload;
+            if (update.kind === "upsert") {
+              updated.add(update.agent.id);
+              listener.track(update.agent);
+            } else {
+              updated.add(update.agentId);
+              listener.hide(update.agentId);
+            }
+          },
+          error: observeAgain,
+        });
+        return undefined;
+      })
+      .catch(observeAgain);
+  }
+
+  observe();
+  return () => {
+    lifetime.abort();
+    clearTimeout(retry);
+  };
+}

package/client/pill.tsx

@@ -7,6 +7,7 @@ import type {
 import { Icon } from "@getpaseo/plugin/client/react-native";
 import React, { useSyncExternalStore } from "react";
 import { readMetrics } from "../shared/contracts";
+import { followAgents, type DirectoryAgent } from "./agent-directory";
 import { openMachineScreen } from "./compat";
 import { createMachineCard } from "./pill-card";
 import { pillReading, type PillReading } from "../shared/pill";
@@ -56,19 +57,12 @@ function createIcon(store: ReadingStore) {
   };
 }
 
-interface TrackedAgent {
-  id: string;
-  workspaceId?: string | null;
-  archivedAt?: string | null;
-}
-
 /**
  * CPU load and memory pressure beside every agent's composer, fed by one poll.
  *
  * Paseo scopes a pill to a single agent, so this follows the agent directory: a
  * pill appears for each agent that has a workspace and goes when the agent is
- * archived or removed. The directory is seeded from `list`, because a
- * subscription reports changes rather than the agents that already exist.
+ * archived or removed.
  */
 export function contributePills(client: PluginClientContext) {
   const store = createReadingStore();
@@ -124,32 +118,19 @@ export function contributePills(client: PluginClientContext) {
     pills.delete(agentId);
   }
 
-  function track(agent: TrackedAgent) {
+  function track(agent: DirectoryAgent) {
     if (agent.workspaceId && !agent.archivedAt) show(agent.id, agent.workspaceId);
     else hide(agent.id);
   }
 
-  const unsubscribe = client.paseo.agents.subscribe((update) => {
-    if (disposed) return;
-    if (update.kind === "upsert") track(update.agent);
-    else hide(update.agentId);
-  });
-
-  client.paseo.agents
-    .list()
-    .then(({ entries }) => {
-      if (!disposed) for (const entry of entries) track(entry.agent);
-    })
-    .catch(() => {
-      // Without the seed, pills appear as each agent next reports a change.
-    });
+  const stopFollowing = followAgents(client.paseo, { track, hide, known: () => pills.keys() });
 
   const timer = setInterval(() => void refresh(), REFRESH_MS);
 
   return () => {
     disposed = true;
     clearInterval(timer);
-    unsubscribe();
+    stopFollowing();
     for (const { registration } of pills.values()) registration.remove();
     pills.clear();
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paseo-plugin-machine-status",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Machine dashboard, open ports and Docker control inside Paseo",
   "license": "MIT",
   "author": "dutchakdev",
@@ -26,9 +26,9 @@
     "check": "npm run typecheck && npm test"
   },
   "devDependencies": {
-    "@getpaseo/client": "0.8.0",
-    "@getpaseo/plugin": "0.8.0",
-    "@getpaseo/protocol": "0.8.0",
+    "@getpaseo/client": "0.11.4",
+    "@getpaseo/plugin": "0.11.4",
+    "@getpaseo/protocol": "0.11.4",
     "@tanstack/react-query": "^5.90.11",
     "@types/node": "22.20.5",
     "@types/react": "~19.2.0",
@@ -36,8 +36,9 @@
     "react-native": "0.81.5",
     "semver": "7.8.5",
     "tsx": "^4.23.13",
-    "typescript": "^5.9.3",
-    "vitest": "^4.1.11",
+    "typescript": "^7.0.2",
+    "vite": "^8.3.5",
+    "vitest": "^5.0.5",
     "zod": "^4.4.3"
   },
   "files": [