orcheo-studio 0.21.2 → 0.22.2

package/src/features/workflow/pages/workflow-gallery/onboard-team-dialog.tsx

@@ -0,0 +1,57 @@
+import { Button } from "@/design-system/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogHeader,
+  DialogTitle,
+} from "@/design-system/ui/dialog";
+import { type ApiTeam } from "@features/workflow/lib/workflow-storage-api";
+
+interface OnboardTeamDialogProps {
+  open: boolean;
+  candidateName: string;
+  teams: ApiTeam[];
+  onSelect: (teamId: string) => void;
+  onOpenChange: (open: boolean) => void;
+}
+
+/**
+ * Prompts which team to onboard a candidate into when the workspace has more
+ * than one team.
+ */
+export const OnboardTeamDialog = ({
+  open,
+  candidateName,
+  teams,
+  onSelect,
+  onOpenChange,
+}: OnboardTeamDialogProps) => {
+  return (
+    <Dialog open={open} onOpenChange={onOpenChange}>
+      <DialogContent>
+        <DialogHeader>
+          <DialogTitle>Choose a team</DialogTitle>
+          <DialogDescription>
+            Select the team to onboard "{candidateName}" into.
+          </DialogDescription>
+        </DialogHeader>
+        <div className="flex flex-col gap-2">
+          {teams.map((team) => (
+            <Button
+              key={team.id}
+              variant="outline"
+              className="justify-between"
+              onClick={() => onSelect(team.id)}
+            >
+              <span>{team.name}</span>
+              {team.is_default ? (
+                <span className="text-xs text-muted-foreground">Default</span>
+              ) : null}
+            </Button>
+          ))}
+        </div>
+      </DialogContent>
+    </Dialog>
+  );
+};

package/src/features/workflow/pages/workflow-gallery/team-section.tsx

@@ -0,0 +1,58 @@
+import { type ReactNode, useState } from "react";
+import { ChevronDown, ChevronRight, Trash2 } from "lucide-react";
+import { Button } from "@/design-system/ui/button";
+
+interface TeamSectionProps {
+  name: string;
+  count: number;
+  defaultOpen?: boolean;
+  onRemove?: () => void;
+  children: ReactNode;
+}
+
+/**
+ * A vertically-stacked, individually collapsible section grouping the AI
+ * colleagues that belong to a single team.
+ */
+export const TeamSection = ({
+  name,
+  count,
+  defaultOpen = true,
+  onRemove,
+  children,
+}: TeamSectionProps) => {
+  const [isOpen, setIsOpen] = useState(defaultOpen);
+
+  return (
+    <section className="border-b border-border/60 pb-4 last:border-b-0">
+      <div className="group flex items-center py-3">
+        <button
+          type="button"
+          aria-expanded={isOpen}
+          onClick={() => setIsOpen((open) => !open)}
+          className="flex items-center gap-2 text-left"
+        >
+          {isOpen ? (
+            <ChevronDown className="h-4 w-4 text-muted-foreground" />
+          ) : (
+            <ChevronRight className="h-4 w-4 text-muted-foreground" />
+          )}
+          <span className="text-sm font-semibold">{name}</span>
+          <span className="text-xs text-muted-foreground">{count}</span>
+        </button>
+        {onRemove ? (
+          <Button
+            variant="ghost"
+            size="icon"
+            className="ml-1 h-7 w-7 opacity-0 group-hover:opacity-100"
+            onClick={onRemove}
+            aria-label={`Remove team ${name}`}
+          >
+            <Trash2 className="h-3.5 w-3.5 text-muted-foreground" />
+          </Button>
+        ) : null}
+      </div>
+      {isOpen ? children : null}
+    </section>
+  );
+};

package/src/features/workflow/pages/workflow-gallery/use-workflow-gallery-actions.ts

@@ -1,4 +1,4 @@
-import { useCallback } from "react";
+import { useCallback, useState } from "react";
 import { useNavigate } from "react-router-dom";
 import { toast } from "@/hooks/use-toast";
 import {
@@ -10,14 +10,29 @@ import {
   deleteWorkflow,
   onboardCandidateAsWorkflow,
 } from "@features/workflow/lib/workflow-storage";
-import { fetchWorkflowVersions } from "@features/workflow/lib/workflow-storage-api";
+import {
+  type ApiTeam,
+  createTeam,
+  deleteTeam,
+  fetchWorkflowVersions,
+} from "@features/workflow/lib/workflow-storage-api";
 import { getWorkflowRouteRef } from "@features/workflow/lib/workflow-storage-helpers";
 import { getSelectedWorkspaceSlug } from "@/lib/workspace-session";
-import { getWorkspaceWorkflowPath } from "@/lib/workspace-routing";
+import {
+  getWorkspaceTeamWorkflowPath,
+  getWorkspaceWorkflowPath,
+} from "@/lib/workspace-routing";
 import { type WorkflowGalleryTab } from "./types";
 
 interface WorkflowGalleryActionsArgs {
   setSelectedTab: (value: WorkflowGalleryTab) => void;
+  teams: ApiTeam[];
+  refreshTeams: () => Promise<void>;
+}
+
+interface OnboardTarget {
+  candidateId: string;
+  candidateName: string;
 }
 
 const STARTER_TEMPLATE_IDS = ["template-python-agent"];
@@ -81,30 +96,27 @@ export const useWorkflowGalleryActions = (
   state: WorkflowGalleryActionsArgs,
 ) => {
   const navigate = useNavigate();
+  const [onboardTarget, setOnboardTarget] = useState<OnboardTarget | null>(
+    null,
+  );
+  const [isCreateTeamOpen, setIsCreateTeamOpen] = useState(false);
 
   const handleOpenWorkflow = useCallback(
-    (workflowId: string) => {
-      navigate(
-        getWorkspaceWorkflowPath(getSelectedWorkspaceSlug(), workflowId),
-      );
+    (workflowId: string, teamSlug?: string) => {
+      const slug = getSelectedWorkspaceSlug();
+      const path =
+        teamSlug
+          ? getWorkspaceTeamWorkflowPath(slug, teamSlug, workflowId)
+          : getWorkspaceWorkflowPath(slug, workflowId);
+      navigate(path);
     },
     [navigate],
   );
 
-  const handleUseTemplate = useCallback(
-    async (templateId: string) => {
+  const performOnboard = useCallback(
+    async (candidateId: string, teamId?: string) => {
       try {
-        const badge = getCandidateBadgeDefinition(templateId);
-        if (!badge?.candidateId) {
-          toast({
-            title: "Candidate unavailable",
-            description: "We couldn't find that candidate. Please try another.",
-            variant: "destructive",
-          });
-          return;
-        }
-
-        const workflow = await onboardCandidateAsWorkflow(badge.candidateId);
+        const workflow = await onboardCandidateAsWorkflow(candidateId, teamId);
 
         state.setSelectedTab("all");
 
@@ -113,7 +125,8 @@ export const useWorkflowGalleryActions = (
           description: `"${workflow.name}" has been onboarded to your workspace.`,
         });
 
-        handleOpenWorkflow(getWorkflowRouteRef(workflow));
+        const team = teamId ? state.teams.find((t) => t.id === teamId) : null;
+        handleOpenWorkflow(getWorkflowRouteRef(workflow), team?.slug);
       } catch (error) {
         toast({
           title: "Failed to onboard candidate",
@@ -126,6 +139,48 @@ export const useWorkflowGalleryActions = (
     [handleOpenWorkflow, state],
   );
 
+  const handleUseTemplate = useCallback(
+    async (templateId: string) => {
+      const badge = getCandidateBadgeDefinition(templateId);
+      if (!badge?.candidateId) {
+        toast({
+          title: "Candidate unavailable",
+          description: "We couldn't find that candidate. Please try another.",
+          variant: "destructive",
+        });
+        return;
+      }
+
+      // With more than one team, ask which team to onboard into. Otherwise the
+      // server places the colleague in the workspace's default team.
+      if (state.teams.length > 1) {
+        setOnboardTarget({
+          candidateId: badge.candidateId,
+          candidateName: badge.name ?? badge.candidateId,
+        });
+        return;
+      }
+
+      await performOnboard(badge.candidateId);
+    },
+    [performOnboard, state.teams],
+  );
+
+  const confirmOnboardTeam = useCallback(
+    async (teamId: string) => {
+      const target = onboardTarget;
+      setOnboardTarget(null);
+      if (target) {
+        await performOnboard(target.candidateId, teamId);
+      }
+    },
+    [onboardTarget, performOnboard],
+  );
+
+  const cancelOnboardTeam = useCallback(() => {
+    setOnboardTarget(null);
+  }, []);
+
   const handleImportStarterPack = useCallback(async () => {
     try {
       const results = await Promise.allSettled(
@@ -193,6 +248,40 @@ export const useWorkflowGalleryActions = (
     }
   }, []);
 
+  const handleCreateTeam = useCallback(
+    async (name: string, slug: string) => {
+      await createTeam({ name, slug });
+      await state.refreshTeams();
+      toast({
+        title: "Team created",
+        description: `"${name}" is ready to group colleagues.`,
+      });
+    },
+    [state],
+  );
+
+  const handleDeleteTeam = useCallback(
+    async (teamId: string) => {
+      const team = state.teams.find((t) => t.id === teamId);
+      try {
+        await deleteTeam(teamId);
+        await state.refreshTeams();
+        toast({
+          title: "Team removed",
+          description: team ? `"${team.name}" has been removed.` : undefined,
+        });
+      } catch (error) {
+        toast({
+          title: "Cannot remove team",
+          description:
+            error instanceof Error ? error.message : "Unknown error occurred",
+          variant: "destructive",
+        });
+      }
+    },
+    [state],
+  );
+
   const handleDeleteWorkflow = useCallback(
     async (workflowId: string, workflowName: string) => {
       try {
@@ -213,11 +302,25 @@ export const useWorkflowGalleryActions = (
     [],
   );
 
+  const openCreateTeamDialog = useCallback(() => setIsCreateTeamOpen(true), []);
+  const closeCreateTeamDialog = useCallback(
+    () => setIsCreateTeamOpen(false),
+    [],
+  );
+
   return {
     handleOpenWorkflow,
     handleUseTemplate,
     handleImportStarterPack,
     handleExportWorkflow,
     handleDeleteWorkflow,
+    onboardTarget,
+    confirmOnboardTeam,
+    cancelOnboardTeam,
+    isCreateTeamOpen,
+    openCreateTeamDialog,
+    closeCreateTeamDialog,
+    handleCreateTeam,
+    handleDeleteTeam,
   };
 };

package/src/features/workflow/pages/workflow-gallery/use-workflow-gallery-state.ts

@@ -1,4 +1,4 @@
-import { useEffect, useMemo, useState } from "react";
+import { useCallback, useEffect, useMemo, useState } from "react";
 import { toast } from "@/hooks/use-toast";
 import {
   GALLERY_TEMPLATE_WORKFLOWS,
@@ -16,7 +16,9 @@ import {
 } from "@features/workflow/lib/workflow-storage";
 import {
   type ApiCandidate,
+  type ApiTeam,
   fetchCandidates,
+  fetchTeams,
 } from "@features/workflow/lib/workflow-storage-api";
 import {
   type WorkflowGalleryTab,
@@ -33,6 +35,8 @@ interface WorkflowGalleryStateSlice {
   tabCounts: WorkflowGalleryTabCounts;
   isTemplateView: boolean;
   templates: Workflow[];
+  teams: ApiTeam[];
+  refreshTeams: () => Promise<void>;
 }
 
 const toCandidateSpec = (candidate: ApiCandidate): CandidateBadgeSpec => ({
@@ -63,6 +67,7 @@ const matchesWorkflowSearch = (
 export const useWorkflowGalleryState = (): WorkflowGalleryStateSlice => {
   const [workflows, setWorkflows] = useState<StoredWorkflow[]>([]);
   const [candidateWorkflows, setCandidateWorkflows] = useState<Workflow[]>([]);
+  const [teams, setTeams] = useState<ApiTeam[]>([]);
   const [isLoadingWorkflows, setIsLoadingWorkflows] = useState(true);
   const [searchQuery, setSearchQuery] = useState("");
   const [selectedTab, setSelectedTab] = useState<WorkflowGalleryTab>("all");
@@ -96,6 +101,15 @@ export const useWorkflowGalleryState = (): WorkflowGalleryStateSlice => {
     };
   }, []);
 
+  const refreshTeams = useCallback(async () => {
+    try {
+      const teamList = await fetchTeams();
+      setTeams(teamList);
+    } catch {
+      // non-fatal — teams list will stay stale
+    }
+  }, []);
+
   useEffect(() => {
     let isMounted = true;
 
@@ -104,9 +118,13 @@ export const useWorkflowGalleryState = (): WorkflowGalleryStateSlice => {
         setIsLoadingWorkflows(true);
       }
       try {
-        const items = await listWorkflows({ forceRefresh });
+        const [items, teamList] = await Promise.all([
+          listWorkflows({ forceRefresh }),
+          fetchTeams().catch(() => [] as ApiTeam[]),
+        ]);
         if (isMounted) {
           setWorkflows(items);
+          setTeams(teamList);
         }
       } catch (error) {
         if (!isMounted) {
@@ -202,5 +220,7 @@ export const useWorkflowGalleryState = (): WorkflowGalleryStateSlice => {
     tabCounts,
     isTemplateView,
     templates,
+    teams,
+    refreshTeams,
   };
 };

package/src/features/workflow/pages/workflow-gallery/use-workflow-gallery.ts

@@ -5,6 +5,8 @@ export const useWorkflowGallery = () => {
   const state = useWorkflowGalleryState();
   const actions = useWorkflowGalleryActions({
     setSelectedTab: state.setSelectedTab,
+    teams: state.teams,
+    refreshTeams: state.refreshTeams,
   });
 
   return {

package/src/features/workflow/pages/workflow-gallery/workflow-card.tsx

@@ -19,7 +19,10 @@ import {
 import { cn } from "@/lib/utils";
 import { resolveAvatarUrl } from "@/assets/avatars";
 import { ConfirmDeleteWorkflowDialog } from "@features/workflow/components/dialogs/confirm-delete-workflow-dialog";
-import { getCandidateBadgeDefinition } from "@features/workflow/data/templates/candidate-badges";
+import {
+  getCandidateBadgeByHandle,
+  getCandidateBadgeDefinition,
+} from "@features/workflow/data/templates/candidate-badges";
 import { type Workflow } from "@features/workflow/data/workflow-data";
 import { getWorkflowRouteRef } from "@features/workflow/lib/workflow-storage-helpers";
 import { WORKFLOW_GALLERY_CARD_ASPECT_CLASSNAME } from "./workflow-card-size";
@@ -37,6 +40,7 @@ const getWorkflowTemplateAvatar = (workflow: Workflow): string | undefined => {
 interface WorkflowCardProps {
   workflow: Workflow;
   isTemplate: boolean;
+  teamSlug?: string;
   workspaceLabel: string;
   onOpenWorkflow: (workflowId: string) => void;
   onUseTemplate: (workflowId: string) => void;
@@ -50,6 +54,7 @@ interface WorkflowCardProps {
 export const WorkflowCard = ({
   workflow,
   isTemplate,
+  teamSlug,
   workspaceLabel,
   onOpenWorkflow,
   onUseTemplate,
@@ -62,8 +67,24 @@ export const WorkflowCard = ({
   const candidateBadge = isTemplate
     ? getCandidateBadgeDefinition(workflow.id)
     : undefined;
+  const templateId = !isTemplate
+    ? workflow.versions?.at(-1)?.templateId
+    : undefined;
+  const templateBadge = !isTemplate
+    ? (templateId
+        ? getCandidateBadgeDefinition(templateId)
+        : workflow.handle
+          ? getCandidateBadgeByHandle(workflow.handle)
+          : undefined)
+    : undefined;
+  const displayBadge = candidateBadge ?? templateBadge;
   const headerLabel = isTemplate ? "Candidate" : workspaceLabel;
-  const workflowSlug = workflow.handle ?? workflow.id;
+  const rawHandle = workflow.handle ?? workflow.id;
+  const workflowSlug = isTemplate
+    ? rawHandle.replace(/^template-/, "").replace(/_/g, "-")
+    : rawHandle;
+  const displayHandle =
+    !isTemplate && teamSlug ? `${teamSlug}/${workflowSlug}` : workflowSlug;
   const avatarUrl = resolveAvatarUrl(
     workflow.avatarEmoji ?? getWorkflowTemplateAvatar(workflow),
     workflow.id,
@@ -271,15 +292,15 @@ export const WorkflowCard = ({
           </div>
 
           <div className="mt-1 shrink-0 font-mono text-[10px] tracking-[0.04em] text-muted-foreground">
-            @{workflowSlug}
+            @{displayHandle}
           </div>
 
           <div className="mt-3 flex min-h-0 w-full flex-1 flex-col items-center justify-start">
             <div className="h-px w-8 rounded-full bg-border/80" />
 
-            {candidateBadge?.subtitle ? (
+            {displayBadge?.subtitle ? (
               <div className="mt-1 shrink-0 font-mono text-[10px] font-semibold uppercase tracking-[0.12em] text-muted-foreground">
-                {candidateBadge.subtitle}
+                {displayBadge.subtitle}
               </div>
             ) : null}
 

package/src/features/workflow/pages/workflow-gallery/workflow-gallery-tabs.tsx

@@ -9,9 +9,11 @@ import {
 } from "@/design-system/ui/tabs";
 import { Loader2, Search, Upload, Zap } from "lucide-react";
 import { type Workflow } from "@features/workflow/data/workflow-data";
+import { type ApiTeam } from "@features/workflow/lib/workflow-storage-api";
 import { UploadWorkflowDialog } from "@features/workflow/components/dialogs/upload-workflow-dialog";
 import { useUploadsAllowed } from "@/hooks/use-uploads-allowed";
 import { WorkflowCard } from "./workflow-card";
+import { TeamSection } from "./team-section";
 import {
   type WorkflowGalleryTab,
   type WorkflowGalleryTabCounts,
@@ -24,17 +26,19 @@ interface WorkflowGalleryTabsProps {
   sortedWorkflows: Workflow[];
   tabCounts: WorkflowGalleryTabCounts;
   isTemplateView: boolean;
+  teams?: ApiTeam[];
   workspaceLabel: string;
   searchQuery: string;
   onSearchQueryChange: (value: string) => void;
   onImportStarterPack: () => void;
-  onOpenWorkflow: (workflowId: string) => void;
+  onOpenWorkflow: (workflowId: string, teamSlug?: string) => void;
   onUseTemplate: (workflowId: string) => void;
   onExportWorkflow: (workflow: Workflow) => void;
   onDeleteWorkflow: (
     workflowId: string,
     workflowName: string,
   ) => Promise<void> | void;
+  onDeleteTeam?: (teamId: string) => void;
 }
 
 export const WorkflowGalleryTabs = ({
@@ -44,6 +48,7 @@ export const WorkflowGalleryTabs = ({
   sortedWorkflows,
   tabCounts,
   isTemplateView,
+  teams = [],
   workspaceLabel,
   searchQuery,
   onSearchQueryChange,
@@ -52,6 +57,7 @@ export const WorkflowGalleryTabs = ({
   onUseTemplate,
   onExportWorkflow,
   onDeleteWorkflow,
+  onDeleteTeam,
 }: WorkflowGalleryTabsProps) => {
   const [isUploadOpen, setIsUploadOpen] = useState(false);
   const uploadsAllowed = useUploadsAllowed();
@@ -60,6 +66,87 @@ export const WorkflowGalleryTabs = ({
     onSearchQueryChange(event.target.value);
   };
 
+  const renderGrid = (items: Workflow[], teamSlug?: string) => (
+    <div className="grid grid-cols-1 gap-3 pb-2 md:grid-cols-3 lg:grid-cols-4 xl:grid-cols-5 2xl:grid-cols-6">
+      {items.map((workflow) => (
+        <WorkflowCard
+          key={workflow.id}
+          workflow={workflow}
+          isTemplate={isTemplateView}
+          teamSlug={teamSlug}
+          workspaceLabel={workspaceLabel}
+          onOpenWorkflow={(id) => onOpenWorkflow(id, teamSlug)}
+          onUseTemplate={onUseTemplate}
+          onExportWorkflow={onExportWorkflow}
+          onDeleteWorkflow={onDeleteWorkflow}
+        />
+      ))}
+    </div>
+  );
+
+  // Group colleagues into vertical, collapsible team sections. Candidate
+  // (template) view stays flat since candidates are not yet assigned a team.
+  const renderColleagues = () => {
+    if (isTemplateView) {
+      return renderGrid(sortedWorkflows);
+    }
+
+    // No teams yet — fall back to flat grid (e.g. during first load).
+    if (teams.length === 0) {
+      return renderGrid(sortedWorkflows);
+    }
+
+    const byTeam = new Map<string, Workflow[]>();
+    for (const workflow of sortedWorkflows) {
+      const key = workflow.teamId ?? "__none__";
+      const bucket = byTeam.get(key);
+      if (bucket) {
+        bucket.push(workflow);
+      } else {
+        byTeam.set(key, [workflow]);
+      }
+    }
+
+    // All known teams, in default-first order from the server, then any
+    // orphaned workflows whose team no longer appears in the list.
+    const leftovers = [...byTeam.keys()].filter(
+      (key) => key !== "__none__" && !teams.some((t) => t.id === key),
+    );
+    const sections = [
+      ...teams.map((team) => ({
+        key: team.id,
+        name: team.name,
+        slug: team.slug,
+      })),
+      ...leftovers.map((key) => ({ key, name: "Other", slug: undefined })),
+      ...(byTeam.has("__none__")
+        ? [{ key: "__none__", name: "Ungrouped", slug: undefined }]
+        : []),
+    ];
+
+    return (
+      <div className="flex flex-col gap-1 pb-6">
+        {sections.map((section) => {
+          const items = byTeam.get(section.key) ?? [];
+          return (
+            <TeamSection
+              key={section.key}
+              name={section.name}
+              count={items.length}
+              onRemove={
+                onDeleteTeam && section.slug !== undefined
+                  ? () => onDeleteTeam(section.key)
+                  : undefined
+              }
+            >
+              {items.length > 0 ? renderGrid(items, section.slug) : null}
+            </TeamSection>
+          );
+        })}
+      </div>
+    );
+  };
+
   return (
     <Tabs
       value={selectedTab}
@@ -132,7 +219,8 @@ export const WorkflowGalleryTabs = ({
               </p>
             </div>
           </div>
-        ) : sortedWorkflows.length === 0 ? (
+        ) : sortedWorkflows.length === 0 &&
+          (isTemplateView || teams.length === 0) ? (
           <div className="flex flex-col items-center justify-center py-12 text-center">
             <div className="mb-4 rounded-full bg-muted p-4">
               <Zap className="h-8 w-8 text-muted-foreground" />
@@ -152,20 +240,7 @@ export const WorkflowGalleryTabs = ({
             </div>
           </div>
         ) : (
-          <div className="grid grid-cols-1 gap-3 pb-6 md:grid-cols-3 lg:grid-cols-4 xl:grid-cols-5 2xl:grid-cols-6">
-            {sortedWorkflows.map((workflow) => (
-              <WorkflowCard
-                key={workflow.id}
-                workflow={workflow}
-                isTemplate={isTemplateView}
-                workspaceLabel={workspaceLabel}
-                onOpenWorkflow={onOpenWorkflow}
-                onUseTemplate={onUseTemplate}
-                onExportWorkflow={onExportWorkflow}
-                onDeleteWorkflow={onDeleteWorkflow}
-              />
-            ))}
-          </div>
+          renderColleagues()
         )}
       </TabsContent>
     </Tabs>