@omercnet/paseo-agent-crew 1.1.0 → 1.2.0-next.214.1

package/README.md

@@ -56,8 +56,10 @@ Each row exposes the operations available through the public Paseo SDK:
 - **Open** navigates to the selected agent.
 - **Expand or collapse** shows or hides a managed branch without changing agent state.
 - **Nudge** sends a follow-up to an idle or waiting agent.
-- **Interrupt and redirect** sends a new direction to a running agent. Paseo stops the active turn
-  before starting that direction, and the confirmation dialog says so explicitly.
+- **Interrupt and redirect** sends a new direction to a running agent. The dialog defaults to
+  **Interrupt**, which stops the active turn before starting that direction. **Prefer steering**
+  asks the provider to deliver the message into the running turn instead; a provider that cannot
+  steer replaces the turn. The choice resets to **Interrupt** each time the dialog opens.
 - **Detach** removes a managed child branch from its parent while allowing it to continue
   independently. Root agents and context-only ancestors do not expose this action.
 - **Archive** stops and removes the selected agent. Same-workspace descendants may be archived with
@@ -69,6 +71,18 @@ Each row exposes the operations available through the public Paseo SDK:
 Every mutating control uses a confirmation dialog. Successful actions show a toast; SDK errors are
 shown without hiding the failure.
 
+## Active crews sidebar row
+
+On Paseo 0.11 and later, an **Active crews** sidebar header row counts the crews that have a member
+working or waiting for input. Pressing it lists those crews with their workspace; choosing one opens
+that workspace's Agent Crew panel in the Explorer. The list is a popover on wide layouts and a
+bottom sheet on compact ones. Paseo's compact layout does not show Explorer panels, so there the
+jump lands on the workspace. Hide the row from Settings > Sidebar.
+
+The row reads the same directory query and subscriptions as the panel, so they stay active while
+the sidebar is mounted. Paseo 0.9 and 0.10 do not support sidebar items; the row is not registered
+there.
+
 ## How it reads state
 
 `usePaseo().agents.list()` and `usePaseo().workspaces.list()` page the selected daemon directory at
@@ -99,8 +113,8 @@ Agent Crew intentionally stays inside the public Paseo plugin SDK.
 - Workspace-less top-level agents are outside every workspace crew; workspace-less descendants of
   visible members remain in that crew.
 - It does not add heartbeat controls, private cancellation calls, or direct daemon API access.
-- Sending to a running agent interrupts its active turn; there is no separate non-interrupting send
-  operation.
+- Steering is a preference. Paseo does not report whether a message steered the running turn or
+  replaced it, so the toast only says the message was sent.
 - If the daemon contains more than 2,000 agents, the panel warns that its directory snapshot may
   omit agents in this workspace or their descendants.
 
@@ -133,7 +147,7 @@ bun run test:coverage
 bun run typecheck
 ```
 
-The manifest supports Paseo `^0.9.0 || ^0.10.0`. Development pins the stable 0.9 SDK line; nightly compatibility checks run the OMP provider against both the current stable and beta SDK channels. React 19.1 and React Native 0.81 match the host.
+The manifest supports Paseo `^0.9.0 || ^0.10.0 || ^0.11.0`. Development pins the stable 0.9 SDK line; nightly compatibility checks run the OMP provider against both the current stable and beta SDK channels. React 19.1 and React Native 0.81 match the host.
 
 Release Please maintains versions, changelog entries, component tags, and GitHub releases from
 Conventional Commits in the monorepo.

package/client/crew.ts

@@ -1,10 +1,23 @@
-import type { usePaseo } from "@getpaseo/plugin/client";
+import type {
+  PluginClientContext,
+  PluginSidebarItemContribution,
+  usePaseo,
+} from "@getpaseo/plugin/client";
 
 export type PaseoApi = ReturnType<typeof usePaseo>;
 export type PaseoWorkspace = Awaited<ReturnType<PaseoApi["workspaces"]["list"]>>["entries"][number];
 export type AgentEntry = Awaited<ReturnType<PaseoApi["agents"]["list"]>>["entries"][number];
 type AgentSnapshot = AgentEntry["agent"];
 
+/** Sidebar header items arrived in Paseo 0.11; on older hosts the item is not registered. */
+export function addSidebarHeaderItemIfSupported(
+  client: Pick<PluginClientContext, "addSidebarHeaderItem">,
+  item: PluginSidebarItemContribution,
+): () => void {
+  if (typeof client.addSidebarHeaderItem !== "function") return () => {};
+  return client.addSidebarHeaderItem(item);
+}
+
 export function listenToCrewDirectory(paseo: PaseoApi, invalidate: () => void): () => void {
   let closed = false;
   let removeAgentObserver: (() => void) | undefined;
@@ -112,6 +125,13 @@ export function crewState(agent: AgentSnapshot): CrewState {
   return "idle";
 }
 
+export type DeliveryChoice = "steer" | "interrupt";
+
+/** Idle agents get a plain send; the choice only applies to a running turn. */
+export function sendOptions(running: boolean, choice: DeliveryChoice) {
+  return running ? { activeTurnBehavior: choice } : undefined;
+}
+
 export function isWorking(agent: AgentSnapshot): boolean {
   return agent.status === "running" || agent.status === "initializing";
 }
@@ -309,3 +329,52 @@ export function collapseCrewNodes(
   }
   return visible;
 }
+
+export interface ActiveCrew {
+  workspaceId: string;
+  lead: AgentEntry;
+  working: number;
+  needsInput: number;
+}
+
+/** Crews each workspace's panel shows, kept only when a member is working or needs input. */
+export function activeCrews(entries: readonly AgentEntry[]): ActiveCrew[] {
+  const workspaceIds = new Set<string>();
+  for (const { agent } of entries) {
+    if (agent.workspaceId && !agent.archivedAt) workspaceIds.add(agent.workspaceId);
+  }
+  const crews: ActiveCrew[] = [];
+  for (const workspaceId of workspaceIds) {
+    let crew: ActiveCrew | undefined;
+    for (const node of buildCrewForest(entries, workspaceId)) {
+      if (node.depth === 0) {
+        crew =
+          node.descendantCount > 0
+            ? { workspaceId, lead: node.entry, working: 0, needsInput: 0 }
+            : undefined;
+        if (crew) crews.push(crew);
+      }
+      if (!crew || !node.member) continue;
+      const state = crewState(node.entry.agent);
+      if (state === "working") crew.working += 1;
+      if (state === "needs-input") crew.needsInput += 1;
+    }
+  }
+  return crews.filter((crew) => crew.working + crew.needsInput > 0);
+}
+
+export type CrewPopoverNotice = "loading" | "error" | "empty";
+
+/**
+ * The note the Active crews popover shows, or null when its crew list speaks for itself. A failed
+ * load always wins, even over cached crews, so an outage never reads as "no crew is active".
+ */
+export function crewPopoverNotice(input: {
+  crewCount: number;
+  isPending: boolean;
+  error: unknown;
+}): CrewPopoverNotice | null {
+  if (input.error) return "error";
+  if (input.crewCount > 0) return null;
+  return input.isPending ? "loading" : "empty";
+}

package/client/main.tsx

@@ -22,12 +22,14 @@ import {
   collapseCrewNodes,
   crewCounts,
   crewState,
+  type DeliveryChoice,
   formatAge,
   isWorking,
   listenToCrewDirectory,
   type PaseoApi,
   type PaseoWorkspace,
   parentAgentId,
+  sendOptions,
 } from "./crew";
 
 const PAGE_LIMIT = 200;
@@ -43,7 +45,7 @@ type CrewData = {
 };
 
 type CrewAction =
-  | { kind: "send"; agentId: string; text: string; interrupted: boolean }
+  | { kind: "send"; agentId: string; text: string; running: boolean; choice: DeliveryChoice }
   | { kind: "detach"; agentId: string }
   | { kind: "archive"; agentId: string };
 
@@ -96,6 +98,36 @@ async function loadCrewData(paseo: PaseoApi): Promise<CrewData> {
   };
 }
 
+/** Host-wide crew directory, refreshed by agent and workspace subscriptions plus a slow backstop. */
+export function useCrewDirectory(hostId: string) {
+  const paseo = usePaseo();
+  const queryClient = useQueryClient();
+  const queryKey = useMemo(() => ["agent-crew", "directory", hostId], [hostId]);
+  const directory = useQuery({
+    queryKey,
+    queryFn: () => loadCrewData(paseo),
+    refetchInterval: BACKSTOP_REFRESH_MS,
+  });
+
+  useEffect(() => {
+    let debounce: ReturnType<typeof setTimeout> | undefined;
+    const invalidate = () => {
+      if (debounce) return;
+      debounce = setTimeout(() => {
+        debounce = undefined;
+        void queryClient.invalidateQueries({ queryKey });
+      }, REFRESH_DEBOUNCE_MS);
+    };
+    const unsubscribeDirectory = listenToCrewDirectory(paseo, invalidate);
+    return () => {
+      clearTimeout(debounce);
+      unsubscribeDirectory();
+    };
+  }, [paseo, queryClient, queryKey]);
+
+  return directory;
+}
+
 function ActionButton({
   accessibilityLabel,
   color,
@@ -186,14 +218,8 @@ export function AgentCrew({
 }: PluginWorkspacePanelProps) {
   const paseo = usePaseo();
   const toast = useToast();
-  const queryClient = useQueryClient();
   const workspaceTitle = useWorkspace(workspaceId, ({ name, title }) => title?.trim() || name);
-  const queryKey = useMemo(() => ["agent-crew", "directory", host.id], [host.id]);
-  const { data, error, isPending, isFetching, refetch } = useQuery({
-    queryKey,
-    queryFn: () => loadCrewData(paseo),
-    refetchInterval: BACKSTOP_REFRESH_MS,
-  });
+  const { data, error, isPending, isFetching, refetch } = useCrewDirectory(host.id);
 
   const [selectedState, setSelectedState] = useState<CrewState | null>(null);
   const [query, setQuery] = useState("");
@@ -201,6 +227,7 @@ export function AgentCrew({
   const [dialog, setDialog] = useState<DialogState>(null);
   const [permissionDialog, setPermissionDialog] = useState<PermissionDialogState>(null);
   const [message, setMessage] = useState("");
+  const [delivery, setDelivery] = useState<DeliveryChoice>("interrupt");
   const [collapsedAgentIds, setCollapsedAgentIds] = useState<ReadonlySet<string>>(() => new Set());
 
   useEffect(() => {
@@ -208,22 +235,6 @@ export function AgentCrew({
     return () => clearInterval(clock);
   }, []);
 
-  useEffect(() => {
-    let debounce: ReturnType<typeof setTimeout> | undefined;
-    const invalidate = () => {
-      if (debounce) return;
-      debounce = setTimeout(() => {
-        debounce = undefined;
-        void queryClient.invalidateQueries({ queryKey });
-      }, REFRESH_DEBOUNCE_MS);
-    };
-    const unsubscribeDirectory = listenToCrewDirectory(paseo, invalidate);
-    return () => {
-      clearTimeout(debounce);
-      unsubscribeDirectory();
-    };
-  }, [paseo, queryClient, queryKey]);
-
   const allNodes = useMemo(
     () =>
       buildCrewForest(data?.entries ?? [], workspaceId, {
@@ -265,7 +276,7 @@ export function AgentCrew({
     mutationFn: async (input: CrewAction) => {
       const handle = paseo.agents.ref(input.agentId);
       if (input.kind === "send") {
-        await handle.send(input.text);
+        await handle.send(input.text, sendOptions(input.running, input.choice));
       } else if (input.kind === "detach") {
         await handle.detach();
       } else {
@@ -274,7 +285,12 @@ export function AgentCrew({
     },
     onSuccess: (_result, input) => {
       if (input.kind === "send") {
-        toast.show(input.interrupted ? "Agent redirected" : "Nudge sent", { variant: "success" });
+        const sent = !input.running
+          ? "Nudge sent"
+          : input.choice === "interrupt"
+            ? "Agent redirected"
+            : "Message sent";
+        toast.show(sent, { variant: "success" });
       } else if (input.kind === "detach") {
         toast.show("Subagent detached", { variant: "success" });
       } else {
@@ -287,7 +303,7 @@ export function AgentCrew({
       toast.error(mutationError instanceof Error ? mutationError.message : "Agent action failed");
     },
     onSettled: async () => {
-      await queryClient.invalidateQueries({ queryKey });
+      await refetch();
     },
   });
 
@@ -315,7 +331,7 @@ export function AgentCrew({
       }
     },
     onSettled: async () => {
-      await queryClient.invalidateQueries({ queryKey });
+      await refetch();
     },
   });
 
@@ -467,6 +483,18 @@ export function AgentCrew({
           backgroundColor: theme.colors.surface1,
           textAlignVertical: "top",
         },
+        deliveryRow: { flexDirection: "row", gap: 8 },
+        deliveryOption: {
+          flex: 1,
+          minHeight: 36,
+          alignItems: "center",
+          justifyContent: "center",
+          borderRadius: 8,
+          borderWidth: StyleSheet.hairlineWidth,
+          borderColor: theme.colors.border,
+          backgroundColor: theme.colors.surface1,
+        },
+        deliveryOptionActive: { backgroundColor: theme.colors.accent },
         modalActions: { flexDirection: "row", justifyContent: "flex-end", gap: 8 },
         secondaryButton: {
           minHeight: 36,
@@ -528,6 +556,7 @@ export function AgentCrew({
   );
   function openDialog(kind: NonNullable<DialogState>["kind"], node: CrewNode) {
     setMessage("");
+    setDelivery("interrupt");
     setDialog({ kind, node });
   }
 
@@ -537,7 +566,13 @@ export function AgentCrew({
     if (dialog.kind === "message") {
       const text = message.trim();
       if (!text) return;
-      action.mutate({ kind: "send", agentId: agent.id, text, interrupted: isWorking(agent) });
+      action.mutate({
+        kind: "send",
+        agentId: agent.id,
+        text,
+        running: isWorking(agent),
+        choice: delivery,
+      });
       return;
     }
     action.mutate({ kind: dialog.kind, agentId: agent.id });
@@ -714,17 +749,26 @@ export function AgentCrew({
     if (dialog.kind === "message") {
       const state = crewState(dialog.node.entry.agent);
       const running = isWorking(dialog.node.entry.agent);
-      dialogTitle = running ? `Interrupt and redirect ${target}` : `Nudge ${target}`;
-      dialogCopy = running
-        ? "This agent is working. Sending a message stops its current turn and starts the new direction."
-        : state === "needs-input"
-          ? "This agent is waiting for a permission decision. Sending a message dismisses that request and starts the new direction."
-          : "Send a concise follow-up with the missing context or next step.";
-      confirmLabel = running
-        ? "Interrupt & redirect"
-        : state === "needs-input"
-          ? "Dismiss request & nudge"
-          : "Send nudge";
+      const steer = running && delivery === "steer";
+      dialogTitle = !running
+        ? `Nudge ${target}`
+        : steer
+          ? `Message ${target}`
+          : `Interrupt and redirect ${target}`;
+      dialogCopy = steer
+        ? "This agent is working. The message is delivered to the running turn if the provider supports steering; otherwise it replaces the turn."
+        : running
+          ? "This agent is working. Sending a message stops its current turn and starts the new direction."
+          : state === "needs-input"
+            ? "This agent is waiting for a permission decision. Sending a message dismisses that request and starts the new direction."
+            : "Send a concise follow-up with the missing context or next step.";
+      confirmLabel = steer
+        ? "Send (prefer steering)"
+        : running
+          ? "Interrupt & redirect"
+          : state === "needs-input"
+            ? "Dismiss request & nudge"
+            : "Send nudge";
     } else if (dialog.kind === "detach") {
       dialogTitle = `Detach ${target}?`;
       dialogCopy =
@@ -895,6 +939,36 @@ export function AgentCrew({
         <Modal.Content>
           <View style={panelStyles.modalBody}>
             <Text style={panelStyles.modalCopy}>{dialogCopy}</Text>
+            {dialog?.kind === "message" && isWorking(dialog.node.entry.agent) ? (
+              <View style={panelStyles.deliveryRow}>
+                {(
+                  [
+                    ["interrupt", "Interrupt"],
+                    ["steer", "Prefer steering"],
+                  ] as const
+                ).map(([value, label]) => (
+                  <Pressable
+                    key={value}
+                    accessibilityRole="button"
+                    accessibilityState={{ selected: delivery === value }}
+                    disabled={action.isPending}
+                    onPress={() => setDelivery(value)}
+                    style={[
+                      panelStyles.deliveryOption,
+                      delivery === value && panelStyles.deliveryOptionActive,
+                    ]}
+                  >
+                    <Text
+                      style={
+                        delivery === value ? panelStyles.primaryButtonText : panelStyles.buttonText
+                      }
+                    >
+                      {label}
+                    </Text>
+                  </Pressable>
+                ))}
+              </View>
+            ) : null}
             {dialog?.kind === "message" ? (
               <TextInput
                 accessibilityLabel="Message to subagent"

package/client/sidebar.tsx

@@ -0,0 +1,90 @@
+import type {
+  PluginClientContext,
+  PluginPopoverProps,
+  PluginSidebarItemProps,
+} from "@getpaseo/plugin/client";
+import { useToast } from "@getpaseo/plugin/client/react-native";
+import { SidebarRow } from "@getpaseo/plugin/client/ui";
+import { useMemo } from "react";
+import { Pressable, StyleSheet, Text, View } from "react-native";
+import { activeCrews, agentTitle, crewPopoverNotice } from "./crew";
+import { useCrewDirectory } from "./main";
+
+/** The Active crews sidebar row; its popover opens a crew's workspace Agent Crew panel. */
+export function createActiveCrewsItem(client: PluginClientContext) {
+  function ActiveCrewsPopover({ theme, host, close }: PluginPopoverProps) {
+    const toast = useToast();
+    const { data, error, isPending } = useCrewDirectory(host.id);
+    const crews = useMemo(() => activeCrews(data?.entries ?? []), [data]);
+    const styles = useMemo(
+      () =>
+        StyleSheet.create({
+          row: { gap: 2, paddingHorizontal: 8, paddingVertical: 8, borderRadius: 8 },
+          pressed: { backgroundColor: theme.colors.surface2 },
+          title: { color: theme.colors.foreground, fontSize: 13, fontWeight: "600" },
+          detail: { color: theme.colors.foregroundMuted, fontSize: 12 },
+          error: { color: theme.colors.statusDanger, fontSize: 12, marginBottom: 6 },
+        }),
+      [theme],
+    );
+    const notice = crewPopoverNotice({ crewCount: crews.length, isPending, error });
+    let noticeText = "No crew is working or waiting for input.";
+    if (notice === "loading") noticeText = "Loading crews…";
+    if (notice === "error") {
+      noticeText = error instanceof Error ? error.message : "Could not load crews";
+    }
+    return (
+      <View>
+        {notice ? (
+          <Text style={notice === "error" ? styles.error : styles.detail}>{noticeText}</Text>
+        ) : null}
+        {crews.map((crew) => (
+          <Pressable
+            key={`${crew.workspaceId}:${crew.lead.agent.id}`}
+            accessibilityRole="button"
+            onPress={() => {
+              close();
+              try {
+                client.openPanel("crew", { workspaceId: crew.workspaceId, location: "explorer" });
+              } catch (error) {
+                toast.error(error instanceof Error ? error.message : "Could not open Agent Crew");
+              }
+            }}
+            style={({ pressed }) => [styles.row, pressed && styles.pressed]}
+          >
+            <Text style={styles.title} numberOfLines={1}>
+              {agentTitle(crew.lead)}
+            </Text>
+            <Text style={styles.detail} numberOfLines={1}>
+              {[
+                data?.workspaceNames.get(crew.workspaceId) ?? "Unknown workspace",
+                crew.working > 0 ? `${crew.working} working` : null,
+                crew.needsInput > 0 ? `${crew.needsInput} need input` : null,
+              ]
+                .filter(Boolean)
+                .join(" · ")}
+            </Text>
+          </Pressable>
+        ))}
+      </View>
+    );
+  }
+
+  function ActiveCrewsItem({ theme, host, openPopover }: PluginSidebarItemProps) {
+    const { data } = useCrewDirectory(host.id);
+    const count = useMemo(() => activeCrews(data?.entries ?? []).length, [data]);
+    return (
+      <SidebarRow
+        icon="Network"
+        onPress={() => openPopover(ActiveCrewsPopover)}
+        trailing={
+          count > 0 ? (
+            <Text style={{ color: theme.colors.foregroundMuted, fontSize: 12 }}>{count}</Text>
+          ) : undefined
+        }
+      />
+    );
+  }
+
+  return ActiveCrewsItem;
+}

package/index.client.tsx

@@ -1,7 +1,9 @@
 import type { PluginClientContext, PluginSurfaceProps } from "@getpaseo/plugin/client";
 import { createAutoOpenManager } from "./client/auto-open";
+import { addSidebarHeaderItemIfSupported } from "./client/crew";
 import { AgentCrew } from "./client/main";
 import { AgentCrewSettingsScreen } from "./client/settings-screen";
+import { createActiveCrewsItem } from "./client/sidebar";
 import { agentCrewSettings } from "./shared/settings";
 
 export default function contribute(client: PluginClientContext) {
@@ -35,8 +37,14 @@ export default function contribute(client: PluginClientContext) {
       openPanel("crew", { location: "explorer" });
     },
   });
+  const removeActiveCrews = addSidebarHeaderItemIfSupported(client, {
+    id: "active-crews",
+    title: "Active crews",
+    Component: createActiveCrewsItem(client),
+  });
 
   return () => {
+    removeActiveCrews();
     removeOpenCrew();
     removeWorkspacePanel();
     removeSettings();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omercnet/paseo-agent-crew",
-  "version": "1.1.0",
+  "version": "1.2.0-next.214.1",
   "type": "module",
   "description": "A Paseo Explorer panel for visualizing and controlling every managed agent crew in a workspace.",
   "license": "MIT",
@@ -47,10 +47,10 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.10",
-    "@getpaseo/cli": "0.10.1",
-    "@getpaseo/client": "0.10.1",
-    "@getpaseo/plugin": "0.10.1",
-    "@getpaseo/protocol": "0.10.1",
+    "@getpaseo/cli": "0.11.0-beta.3",
+    "@getpaseo/client": "0.11.0-beta.3",
+    "@getpaseo/plugin": "0.11.0-beta.3",
+    "@getpaseo/protocol": "0.11.0-beta.3",
     "@tanstack/react-query": "^5.102.3",
     "@types/node": "^24.10.1",
     "@types/react": "^19.2.18",

package/paseo-plugin.json

@@ -1,5 +1,5 @@
 {
   "id": "agent-crew",
   "description": "A Paseo Explorer panel for visualizing and controlling every managed agent crew in a workspace.",
-  "requirements": { "paseo": "^0.9.0 || ^0.10.0" }
+  "requirements": { "paseo": "^0.9.0 || ^0.10.0 || ^0.11.0" }
 }