@omercnet/paseo-agent-crew 1.1.0-next.198.1 → 1.1.0-next.206.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.
 

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-next.198.1",
+  "version": "1.1.0-next.206.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",