@inkeep/agents-manage-ui 0.0.0-dev-20251021180725 → 0.0.0-dev-20251021181503

package/src/components/external-agents/external-agent-item.tsx

@@ -0,0 +1,169 @@
+'use client';
+
+import { MoreVertical, Trash2 } from 'lucide-react';
+import { useParams } from 'next/navigation';
+import { useState } from 'react';
+import { toast } from 'sonner';
+import { formatDate } from '@/app/utils/format-date';
+import { Button } from '@/components/ui/button';
+import { Dialog, DialogTrigger } from '@/components/ui/dialog';
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuTrigger,
+} from '@/components/ui/dropdown-menu';
+import {
+  ItemCardContent,
+  ItemCardFooter,
+  ItemCardHeader,
+  ItemCardLink,
+  ItemCardRoot,
+  ItemCardTitle,
+} from '@/components/ui/item-card';
+import { deleteExternalAgentAction } from '@/lib/actions/external-agents';
+import type { ExternalAgent } from '@/lib/types/external-agents';
+import { ProviderIcon } from '../icons/provider-icon';
+import { Badge } from '../ui/badge';
+import { CardTitle } from '../ui/card';
+import { DeleteConfirmation } from '../ui/delete-confirmation';
+import { Tooltip, TooltipContent, TooltipTrigger } from '../ui/tooltip';
+
+// URL Display Component with ellipsis and tooltip
+function URLDisplay({ url }: { url: string }) {
+  return (
+    <Tooltip>
+      <TooltipTrigger asChild>
+        <div className="rounded py-1 min-w-0">
+          <code className="text-sm text-muted-foreground block truncate">{url}</code>
+        </div>
+      </TooltipTrigger>
+      <TooltipContent side="bottom" align="start" className="max-w-md">
+        <code className="text-xs break-all">{url}</code>
+      </TooltipContent>
+    </Tooltip>
+  );
+}
+
+interface ExternalAgentDialogMenuProps {
+  externalAgentId: string;
+  externalAgentName?: string;
+}
+
+function ExternalAgentDialogMenu({
+  externalAgentId,
+  externalAgentName,
+}: ExternalAgentDialogMenuProps) {
+  const { tenantId, projectId } = useParams<{
+    tenantId: string;
+    projectId: string;
+  }>();
+
+  const [isOpen, setIsOpen] = useState(false);
+  const [isSubmitting, setIsSubmitting] = useState(false);
+
+  const handleOpenChange = (open: boolean) => {
+    setIsOpen(open);
+  };
+
+  const handleDelete = async () => {
+    setIsSubmitting(true);
+    try {
+      const result = await deleteExternalAgentAction(tenantId, projectId, externalAgentId);
+      if (result.success) {
+        setIsOpen(false);
+        toast.success('External agent deleted.');
+      } else {
+        toast.error('Failed to delete external agent.');
+      }
+    } finally {
+      setIsSubmitting(false);
+    }
+  };
+
+  return (
+    <Dialog open={isOpen} onOpenChange={handleOpenChange}>
+      <DropdownMenu>
+        <DropdownMenuTrigger asChild>
+          <Button
+            variant="ghost"
+            size="icon-sm"
+            className=" p-0 hover:bg-accent hover:text-accent-foreground rounded-sm -mr-2"
+          >
+            <MoreVertical className="h-4 w-4 text-muted-foreground" />
+          </Button>
+        </DropdownMenuTrigger>
+        <DropdownMenuContent
+          align="end"
+          className="w-48 shadow-lg border border-border bg-popover/95 backdrop-blur-sm"
+        >
+          <DialogTrigger asChild>
+            <DropdownMenuItem className="text-destructive hover:!bg-destructive/10 dark:hover:!bg-destructive/20 hover:!text-destructive cursor-pointer">
+              <Trash2 className="size-4 text-destructive" />
+              Delete
+            </DropdownMenuItem>
+          </DialogTrigger>
+        </DropdownMenuContent>
+      </DropdownMenu>
+      {isOpen && (
+        <DeleteConfirmation
+          itemName={externalAgentName || 'this external agent'}
+          isSubmitting={isSubmitting}
+          onDelete={handleDelete}
+        />
+      )}
+    </Dialog>
+  );
+}
+
+export function ExternalAgentItem({
+  tenantId,
+  projectId,
+  externalAgent,
+}: {
+  tenantId: string;
+  projectId: string;
+  externalAgent: ExternalAgent;
+}) {
+  const linkPath = `/${tenantId}/projects/${projectId}/external-agents/${externalAgent.id}`;
+
+  return (
+    <ItemCardRoot>
+      <ItemCardHeader>
+        <ItemCardLink href={linkPath}>
+          <ItemCardTitle className="text-md">
+            <div className="flex items-center gap-3">
+              <ProviderIcon provider={externalAgent.name} size={24} className="flex-shrink-0" />
+              <div className="flex-1 min-w-0">
+                <CardTitle className="text-base truncate font-medium">
+                  {externalAgent.name}
+                </CardTitle>
+              </div>
+            </div>
+          </ItemCardTitle>
+        </ItemCardLink>
+        <ExternalAgentDialogMenu
+          externalAgentId={externalAgent.id}
+          externalAgentName={externalAgent.name}
+        />
+      </ItemCardHeader>
+      <ItemCardContent>
+        <div className="space-y-3 min-w-0">
+          {externalAgent.description && (
+            <p className="text-sm text-muted-foreground line-clamp-2">
+              {externalAgent.description}
+            </p>
+          )}
+
+          <URLDisplay url={externalAgent.baseUrl} />
+
+          {/* Key metrics in a structured layout */}
+          <div className="flex items-center gap-2 flex-wrap">
+            {externalAgent.credentialReferenceId && <Badge variant="code">Secured</Badge>}
+          </div>
+        </div>
+        <ItemCardFooter footerText={`Created ${formatDate(externalAgent.createdAt)}`} />
+      </ItemCardContent>
+    </ItemCardRoot>
+  );
+}

package/src/components/external-agents/external-agents-list.tsx

@@ -0,0 +1,29 @@
+'use client';
+
+import { useParams } from 'next/navigation';
+import type { ExternalAgent } from '@/lib/types/external-agents';
+import { ExternalAgentItem } from './external-agent-item';
+
+interface ExternalAgentsListProps {
+  externalAgents: ExternalAgent[];
+}
+
+export function ExternalAgentsList({ externalAgents }: ExternalAgentsListProps) {
+  const { tenantId, projectId } = useParams<{
+    tenantId: string;
+    projectId: string;
+  }>();
+
+  return (
+    <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 gap-3 md:gap-4">
+      {externalAgents?.map((externalAgent: ExternalAgent) => (
+        <ExternalAgentItem
+          key={externalAgent.id}
+          tenantId={tenantId}
+          projectId={projectId}
+          externalAgent={externalAgent}
+        />
+      ))}
+    </div>
+  );
+}

package/src/components/external-agents/form/external-agent-form.tsx

@@ -0,0 +1,146 @@
+'use client';
+
+import { zodResolver } from '@hookform/resolvers/zod';
+import { nanoid } from 'nanoid';
+import { useRouter } from 'next/navigation';
+import { useForm } from 'react-hook-form';
+import { toast } from 'sonner';
+import { GenericInput } from '@/components/form/generic-input';
+import { GenericSelect } from '@/components/form/generic-select';
+import { GenericTextarea } from '@/components/form/generic-textarea';
+import { Button } from '@/components/ui/button';
+import { Form } from '@/components/ui/form';
+import { InfoCard } from '@/components/ui/info-card';
+import type { Credential } from '@/lib/api/credentials';
+import { createExternalAgent, updateExternalAgent } from '@/lib/api/external-agents';
+import type { ExternalAgent } from '@/lib/types/external-agents';
+import { type ExternalAgentFormData, externalAgentSchema } from './validation';
+
+interface ExternalAgentFormProps {
+  initialData?: ExternalAgentFormData;
+  mode?: 'create' | 'update';
+  externalAgent?: ExternalAgent;
+  credentials: Credential[];
+  tenantId: string;
+  projectId: string;
+}
+
+const defaultValues: ExternalAgentFormData = {
+  name: '',
+  description: '',
+  baseUrl: '',
+  credentialReferenceId: 'none',
+};
+
+export function ExternalAgentForm({
+  initialData,
+  mode = 'create',
+  externalAgent,
+  credentials,
+  tenantId,
+  projectId,
+}: ExternalAgentFormProps) {
+  const router = useRouter();
+
+  const form = useForm({
+    resolver: zodResolver(externalAgentSchema),
+    defaultValues: {
+      ...defaultValues,
+      ...initialData,
+    },
+  });
+
+  const { isSubmitting } = form.formState;
+
+  const onSubmit = async (data: ExternalAgentFormData) => {
+    try {
+      // Transform form data to API format
+      const transformedData = {
+        ...data,
+        description: data.description || '',
+        credentialReferenceId:
+          data.credentialReferenceId === 'none' ? null : data.credentialReferenceId,
+      };
+
+      if (mode === 'update' && externalAgent) {
+        await updateExternalAgent(tenantId, projectId, externalAgent.id, transformedData);
+        toast.success('External agent updated successfully');
+        router.push(`/${tenantId}/projects/${projectId}/external-agents/${externalAgent.id}`);
+      } else {
+        const newExternalAgent = await createExternalAgent(tenantId, projectId, {
+          ...transformedData,
+          id: nanoid(),
+        });
+        toast.success('External agent created successfully');
+        router.push(`/${tenantId}/projects/${projectId}/external-agents/${newExternalAgent.id}`);
+      }
+    } catch (error) {
+      console.error(`Failed to ${mode} external agent:`, error);
+      toast.error(`Failed to ${mode} external agent. Please try again.`);
+    }
+  };
+
+  return (
+    <Form {...form}>
+      <form onSubmit={form.handleSubmit(onSubmit)} className="space-y-8">
+        <GenericInput
+          control={form.control}
+          name="name"
+          label="Name"
+          placeholder="My External Agent"
+          isRequired
+        />
+        <GenericTextarea
+          control={form.control}
+          name="description"
+          label="Description (optional)"
+          placeholder="A brief description of what this external agent does..."
+        />
+        <GenericInput
+          control={form.control}
+          name="baseUrl"
+          label="Base URL"
+          placeholder="https://api.example.com"
+          isRequired
+        />
+
+        <div className="space-y-3">
+          <GenericSelect
+            control={form.control}
+            selectTriggerClassName="w-full"
+            name="credentialReferenceId"
+            label="Credential"
+            placeholder="Select a credential"
+            options={[
+              { value: 'none', label: 'No Authentication' },
+              ...credentials.map((credential) => ({
+                value: credential.id,
+                label: credential.id,
+              })),
+            ]}
+          />
+          <InfoCard title="How this works">
+            <div className="space-y-2">
+              <p>
+                Select{' '}
+                <code className="bg-background px-1.5 py-0.5 rounded border">
+                  No Authentication
+                </code>{' '}
+                if the external agent does not require authentication, or if you want to add a
+                credential later.
+              </p>
+              <p>
+                Otherwise, select from the existing credentials you have already created. The
+                credential will be used when communicating with this external agent.
+              </p>
+            </div>
+          </InfoCard>
+        </div>
+
+        <Button type="submit" disabled={isSubmitting}>
+          {mode === 'update' ? 'Save' : 'Create'}
+        </Button>
+      </form>
+    </Form>
+  );
+}

package/src/components/external-agents/form/validation.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+
+export const externalAgentSchema = z.object({
+  name: z.string().min(1, 'Name is required.'),
+  description: z.string().optional(),
+  baseUrl: z.string().url('Must be a valid URL.'),
+  credentialReferenceId: z.string().nullish(),
+});
+
+export type ExternalAgentFormData = z.infer<typeof externalAgentSchema>;

package/src/components/external-agents/view-external-agent-details.tsx

@@ -0,0 +1,129 @@
+'use client';
+
+import { Lock, LockOpen, Pencil } from 'lucide-react';
+import Link from 'next/link';
+import { Badge } from '@/components/ui/badge';
+import { ExternalLink } from '@/components/ui/external-link';
+import type { ExternalAgent } from '@/lib/types/external-agents';
+import { cn } from '@/lib/utils';
+import { Button } from '../ui/button';
+import { CopyableSingleLineCode } from '../ui/copyable-single-line-code';
+
+export function ViewExternalAgentDetails({
+  externalAgent,
+  tenantId,
+  projectId,
+}: {
+  externalAgent: ExternalAgent;
+  tenantId: string;
+  projectId: string;
+}) {
+  const formatDate = (dateString: string) => {
+    return new Date(dateString).toLocaleDateString('en-US', {
+      year: 'numeric',
+      month: 'long',
+      day: 'numeric',
+      hour: '2-digit',
+      minute: '2-digit',
+    });
+  };
+
+  const ItemLabel = ({
+    children,
+    className,
+  }: {
+    children: React.ReactNode;
+    className?: string;
+  }) => {
+    return <div className={cn('text-sm font-medium leading-none', className)}>{children}</div>;
+  };
+
+  const ItemValue = ({
+    children,
+    className,
+  }: {
+    children: React.ReactNode;
+    className?: string;
+  }) => {
+    return <div className={cn('flex w-full text-sm', className)}>{children}</div>;
+  };
+
+  return (
+    <div className="max-w-2xl mx-auto py-4 space-y-8">
+      {/* Header */}
+      <div className="flex items-center justify-between">
+        <div className="flex items-center gap-3">
+          <div>
+            <h2 className="text-xl font-medium tracking-tight">{externalAgent.name}</h2>
+            <p className="text-sm text-muted-foreground">External agent details</p>
+          </div>
+        </div>
+        <Button asChild>
+          <Link
+            href={`/${tenantId}/projects/${projectId}/external-agents/${externalAgent.id}/edit`}
+          >
+            <Pencil className="w-4 h-4" />
+            Edit
+          </Link>
+        </Button>
+      </div>
+
+      {/* Basic Information */}
+      <div className="space-y-8">
+        {/* Description */}
+        {externalAgent.description && (
+          <div className="space-y-2">
+            <ItemLabel>Description</ItemLabel>
+            <ItemValue>
+              <p className="text-sm text-muted-foreground">{externalAgent.description}</p>
+            </ItemValue>
+          </div>
+        )}
+
+        {/* Created and Updated */}
+        <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
+          <div className="space-y-2">
+            <ItemLabel>Created At</ItemLabel>
+            <ItemValue>{formatDate(externalAgent.createdAt)}</ItemValue>
+          </div>
+          <div className="space-y-2">
+            <ItemLabel>Updated At</ItemLabel>
+            <ItemValue>{formatDate(externalAgent.updatedAt)}</ItemValue>
+          </div>
+        </div>
+
+        {/* Base URL */}
+        <div className="space-y-2">
+          <ItemLabel>Base URL</ItemLabel>
+          <CopyableSingleLineCode code={externalAgent.baseUrl} />
+        </div>
+
+        {/* Credential */}
+        <div className="space-y-2">
+          <ItemLabel>Credential</ItemLabel>
+          <ItemValue className="items-center">
+            {externalAgent.credentialReferenceId ? (
+              <div className="flex items-center gap-2">
+                <Badge variant="code" className="flex items-center gap-2">
+                  <Lock className="w-4 h-4" />
+                  {externalAgent.credentialReferenceId}
+                </Badge>
+                <ExternalLink
+                  href={`/${tenantId}/projects/${projectId}/credentials/${externalAgent.credentialReferenceId}`}
+                  className="text-xs"
+                >
+                  view credential
+                </ExternalLink>
+              </div>
+            ) : (
+              <Badge variant="warning" className="flex items-center gap-2">
+                <LockOpen className="w-4 h-4" />
+                Unsecured
+              </Badge>
+            )}
+          </ItemValue>
+        </div>
+      </div>
+    </div>
+  );
+}

package/src/components/sidebar-nav/sidebar-nav.tsx

@@ -4,6 +4,7 @@ import {
   Activity,
   BookOpen,
   Component,
+  Globe,
   Key,
   Layers,
   Library,
@@ -69,6 +70,11 @@ export function AppSidebar({ ...props }: React.ComponentProps<typeof Sidebar>) {
             url: `/${tenantId}/projects/${projectId}/mcp-servers`,
             icon: MCPIcon as LucideIcon,
           },
+          {
+            title: 'External Agents',
+            url: `/${tenantId}/projects/${projectId}/external-agents`,
+            icon: Globe,
+          },
           {
             title: 'Credentials',
             url: `/${tenantId}/projects/${projectId}/credentials`,