Let plugins add contextual workspace tools (#3465)

* feat(plugins): add workspace panels and command center contributions

Give local plugins contextual UI entry points without making the daemon interpret client placement or callbacks. Panels receive stable IDs and read cached client state through required selectors with shallow equality, avoiding unrelated guest rerenders and context-discovery RPCs.

* fix(plugins): align shared client state ownership

Workspace panels and Command Center callbacks consume the same frozen client snapshots, so their adapter belongs to the plugin boundary rather than either contribution surface. Refresh the Nix dependency hash for the selector-store dependency added by this feature.

packages/app/src/plugins/evaluate.ts

@@ -8,9 +8,13 @@ import {
   defineAttachmentSource,
   defineRpc,
   type PluginAttachmentSourceContribution,
+  type PluginCommandCenterItemContribution,
   type PluginSidebarContribution,
   type PluginSurfaceProps,
+  type PluginWorkspacePanelContribution,
   usePaseo,
+  useAgent,
+  useWorkspace,
   useRpc,
 } from "@paseo/plugin";
 import { createPluginContext, type PluginRegistrationCollector } from "@paseo/plugin/host";
@@ -30,10 +34,14 @@ export function evaluatePluginClientBundle(id: string, bundle: string): Evaluate
   const collector: PluginRegistrationCollector = {
     surfaces: [],
     sidebarItems: [],
+    workspacePanels: [],
+    commandCenterItems: [],
     attachmentSources: [],
   };
   const surfaceIds = new Set<string>();
   const sidebarItemIds = new Set<string>();
+  const workspacePanelIds = new Set<string>();
+  const commandCenterItemIds = new Set<string>();
   const attachmentSourceIds = new Set<string>();
   const pluginContext = createPluginContext({
     addSurface(surfaceId: string, Component: ComponentType<PluginSurfaceProps>) {
@@ -59,6 +67,54 @@ export function evaluatePluginClientBundle(id: string, bundle: string): Evaluate
         surface: requireId(contribution.surface, "sidebar surface id"),
       });
     },
+    addWorkspacePanel(contribution: PluginWorkspacePanelContribution) {
+      const normalizedId = requireId(contribution.id, "workspace panel id");
+      if (workspacePanelIds.has(normalizedId)) {
+        throw new Error(`Duplicate workspace panel: ${normalizedId}`);
+      }
+      const title = contribution.title.trim();
+      const icon = contribution.icon.trim();
+      if (!title) throw new Error(`Workspace panel ${normalizedId} has no title`);
+      if (!icon) throw new Error(`Workspace panel ${normalizedId} has no icon`);
+      if (contribution.context !== "workspace" && contribution.context !== "agent") {
+        throw new Error(`Workspace panel ${normalizedId} has invalid context`);
+      }
+      if (typeof contribution.Component !== "function") {
+        throw new Error(`Workspace panel ${normalizedId} is not a component`);
+      }
+      resolvePluginIcon(icon);
+      workspacePanelIds.add(normalizedId);
+      collector.workspacePanels.push({ ...contribution, id: normalizedId, title, icon });
+    },
+    addCommandCenterItem(contribution: PluginCommandCenterItemContribution) {
+      const normalizedId = requireId(contribution.id, "Command Center item id");
+      if (commandCenterItemIds.has(normalizedId)) {
+        throw new Error(`Duplicate Command Center item: ${normalizedId}`);
+      }
+      const title = contribution.title.trim();
+      const icon = contribution.icon.trim();
+      if (!title) throw new Error(`Command Center item ${normalizedId} has no title`);
+      if (!icon) throw new Error(`Command Center item ${normalizedId} has no icon`);
+      if (
+        contribution.context !== "global" &&
+        contribution.context !== "workspace" &&
+        contribution.context !== "agent"
+      ) {
+        throw new Error(`Command Center item ${normalizedId} has invalid context`);
+      }
+      if (typeof contribution.onSelect !== "function") {
+        throw new Error(`Command Center item ${normalizedId} has no callback`);
+      }
+      resolvePluginIcon(icon);
+      commandCenterItemIds.add(normalizedId);
+      collector.commandCenterItems.push({
+        ...contribution,
+        id: normalizedId,
+        title,
+        icon,
+        keywords: contribution.keywords?.map((keyword) => keyword.trim()).filter(Boolean),
+      });
+    },
     addAttachmentSource(contribution: PluginAttachmentSourceContribution) {
       const normalizedId = requireId(contribution.id, "attachment source id");
       if (attachmentSourceIds.has(normalizedId)) {
@@ -92,7 +148,16 @@ export function evaluatePluginClientBundle(id: string, bundle: string): Evaluate
     if (name === "react") return React;
     if (name === "react/jsx-runtime") return ReactJsxRuntime;
     if (name === "react-native") return ReactNative;
-    if (name === "@paseo/plugin") return { defineAttachmentSource, defineRpc, usePaseo, useRpc };
+    if (name === "@paseo/plugin") {
+      return {
+        defineAttachmentSource,
+        defineRpc,
+        usePaseo,
+        useAgent,
+        useWorkspace,
+        useRpc,
+      };
+    }
     if (name === "@tanstack/react-query") return ReactQuery;
     if (name === "zod") return Zod;
     throw new Error(`Module "${name}" is not available in plugin client code`);
@@ -133,6 +198,8 @@ export function evaluatePluginClientBundle(id: string, bundle: string): Evaluate
     cleanup,
     surfaces: collector.surfaces,
     sidebarItems: collector.sidebarItems,
+    workspacePanels: collector.workspacePanels,
+    commandCenterItems: collector.commandCenterItems,
     attachmentSources: collector.attachmentSources,
   };
 }