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

package/src/components/credentials/views/credential-form-validation.ts

@@ -12,6 +12,7 @@ export const credentialFormSchema = z.object({
   credentialStoreId: z.string().min(1, 'Please select a credential store'),
   credentialStoreType: z.enum(CredentialStoreType),
   selectedTool: z.string().optional(),
+  selectedExternalAgent: z.string().optional(),
 });
 
 export type CredentialFormData = z.output<typeof credentialFormSchema>;

package/src/components/credentials/views/credential-form.tsx

@@ -12,11 +12,10 @@ import { Button } from '@/components/ui/button';
 import { Checkbox } from '@/components/ui/checkbox';
 import { Form } from '@/components/ui/form';
 import { InfoCard } from '@/components/ui/info-card';
-import {
-  type CredentialStoreStatus,
-  listCredentialStores,
-} from '@/lib/api/credentialStores';
+import { type CredentialStoreStatus, listCredentialStores } from '@/lib/api/credentialStores';
+import { fetchExternalAgents } from '@/lib/api/external-agents';
 import { fetchMCPTools } from '@/lib/api/tools';
+import type { ExternalAgent } from '@/lib/types/external-agents';
 import type { MCPTool } from '@/lib/types/tools';
 import { type CredentialFormData, credentialFormSchema } from './credential-form-validation';
 
@@ -36,12 +35,16 @@ const defaultValues: CredentialFormData = {
   credentialStoreId: '',
   credentialStoreType: 'nango',
   selectedTool: undefined,
+  selectedExternalAgent: undefined,
 };
 
 export function CredentialForm({ onCreateCredential, tenantId, projectId }: CredentialFormProps) {
   const [availableMCPServers, setAvailableMCPServers] = useState<MCPTool[]>([]);
   const [toolsLoading, setToolsLoading] = useState(true);
   const [shouldLinkToServer, setShouldLinkToServer] = useState(false);
+  const [availableExternalAgents, setAvailableExternalAgents] = useState<ExternalAgent[]>([]);
+  const [externalAgentsLoading, setExternalAgentsLoading] = useState(true);
+  const [shouldLinkToExternalAgent, setShouldLinkToExternalAgent] = useState(false);
   const [credentialStores, setCredentialStores] = useState<CredentialStoreStatus[]>([]);
   const [storesLoading, setStoresLoading] = useState(true);
 
@@ -68,6 +71,24 @@ export function CredentialForm({ onCreateCredential, tenantId, projectId }: Cred
     loadAvailableTools();
   }, [tenantId, projectId]);
 
+  useEffect(() => {
+    const loadAvailableExternalAgents = async () => {
+      try {
+        const allExternalAgents = await fetchExternalAgents(tenantId, projectId);
+        const externalAgentsWithoutCredentials = allExternalAgents.filter(
+          (agent) => !agent.credentialReferenceId
+        );
+        setAvailableExternalAgents(externalAgentsWithoutCredentials);
+      } catch (err) {
+        console.error('Failed to load external agents:', err);
+      } finally {
+        setExternalAgentsLoading(false);
+      }
+    };
+
+    loadAvailableExternalAgents();
+  }, [tenantId, projectId]);
+
   useEffect(() => {
     const loadCredentialStores = async () => {
       try {
@@ -87,7 +108,9 @@ export function CredentialForm({ onCreateCredential, tenantId, projectId }: Cred
           const currentStoreId = form.getValues('credentialStoreId');
           if (!currentStoreId) {
             form.setValue('credentialStoreId', preferredStore.id, { shouldValidate: true });
-            form.setValue('credentialStoreType', preferredStore.type as 'keychain' | 'nango', { shouldValidate: true });
+            form.setValue('credentialStoreType', preferredStore.type as 'keychain' | 'nango', {
+              shouldValidate: true,
+            });
           }
         }
       } catch (err) {
@@ -108,6 +131,13 @@ export function CredentialForm({ onCreateCredential, tenantId, projectId }: Cred
     }
   }, [shouldLinkToServer, form]);
 
+  useEffect(() => {
+    if (!shouldLinkToExternalAgent) {
+      // Clear the selectedExternalAgent field when not linking to external agent
+      form.setValue('selectedExternalAgent', undefined);
+    }
+  }, [shouldLinkToExternalAgent, form]);
+
   useEffect(() => {
     const subscription = form.watch((value: any, { name }: any) => {
       if (name === 'credentialStoreId' && value.credentialStoreId) {
@@ -126,6 +156,10 @@ export function CredentialForm({ onCreateCredential, tenantId, projectId }: Cred
     setShouldLinkToServer(checked === true);
   };
 
+  const handleLinkToExternalAgentChange = (checked: boolean | 'indeterminate') => {
+    setShouldLinkToExternalAgent(checked === true);
+  };
+
   const onSubmit = async (data: CredentialFormData) => {
     try {
       if (
@@ -136,6 +170,14 @@ export function CredentialForm({ onCreateCredential, tenantId, projectId }: Cred
         return;
       }
 
+      if (
+        shouldLinkToExternalAgent &&
+        (data.selectedExternalAgent === 'loading' || data.selectedExternalAgent === 'error')
+      ) {
+        toast('Please select a valid external agent');
+        return;
+      }
+
       await onCreateCredential(data);
     } catch (err) {
       console.error('Failed to create credential:', err);
@@ -162,6 +204,25 @@ export function CredentialForm({ onCreateCredential, tenantId, projectId }: Cred
     [availableMCPServers, toolsLoading]
   );
 
+  const externalAgentOptions = useMemo(
+    () => [
+      ...(externalAgentsLoading
+        ? [
+            {
+              value: 'loading',
+              label: 'Loading external agents...',
+              disabled: true,
+            },
+          ]
+        : []),
+      ...availableExternalAgents.map((agent) => ({
+        value: agent.id,
+        label: `${agent.name} - ${agent.baseUrl}`,
+      })),
+    ],
+    [availableExternalAgents, externalAgentsLoading]
+  );
+
   const credentialStoreOptions = useMemo(() => {
     if (storesLoading) {
       return [
@@ -298,6 +359,36 @@ export function CredentialForm({ onCreateCredential, tenantId, projectId }: Cred
               )}
             </div>
           )}
+
+          {/* External Agent Selection Section */}
+          {availableExternalAgents.length > 0 && (
+            <div className="space-y-4">
+              <div className="flex items-center space-x-3 relative">
+                <Checkbox
+                  id="linkToExternalAgent"
+                  checked={shouldLinkToExternalAgent}
+                  onCheckedChange={handleLinkToExternalAgentChange}
+                />
+                <label
+                  htmlFor="linkToExternalAgent"
+                  className="text-sm font-medium leading-none peer-disabled:cursor-not-allowed peer-disabled:opacity-70"
+                >
+                  Link this credential to an external agent
+                </label>
+              </div>
+
+              {shouldLinkToExternalAgent && (
+                <GenericSelect
+                  control={form.control}
+                  name="selectedExternalAgent"
+                  label=""
+                  options={externalAgentOptions}
+                  selectTriggerClassName="w-full"
+                  placeholder="Choose an external agent"
+                />
+              )}
+            </div>
+          )}
         </div>
 
         <div className="flex gap-3 pt-4">

package/src/components/credentials/views/edit-credential-form.tsx

@@ -7,7 +7,7 @@ import { useState } from 'react';
 import { useForm } from 'react-hook-form';
 import { toast } from 'sonner';
 import { z } from 'zod';
-import { CredentialToolsList } from '@/components/credentials/credential-tools-list';
+import { CredentialResourcesList } from '@/components/credentials/credential-resources-list';
 import { GenericInput } from '@/components/form/generic-input';
 import { GenericKeyValueInput } from '@/components/form/generic-key-value-input';
 import { Button } from '@/components/ui/button';
@@ -183,9 +183,10 @@ export function EditCredentialForm({
               </div>
             )}
 
-            {/* MCP Servers Using This Credential */}
-            <CredentialToolsList
+            {/* Resources Using This Credential */}
+            <CredentialResourcesList
               tools={credential.tools}
+              externalAgents={credential.externalAgents}
               tenantId={tenantId}
               projectId={projectId}
             />

package/src/components/credentials/views/new-credential-form.tsx

@@ -6,6 +6,7 @@ import { useParams, useRouter } from 'next/navigation';
 import { toast } from 'sonner';
 import type { CredentialFormData } from '@/components/credentials/views/credential-form-validation';
 import { createCredentialInStore } from '@/lib/api/credentialStores';
+import { updateExternalAgent } from '@/lib/api/external-agents';
 import { updateMCPTool } from '@/lib/api/tools';
 import { createNangoApiKeyConnection } from '@/lib/mcp-tools/nango';
 import { findOrCreateCredential } from '@/lib/utils/credentials-utils';
@@ -72,6 +73,18 @@ export function NewCredentialForm() {
         await updateMCPTool(tenantId, projectId, data.selectedTool, updatedTool);
       }
 
+      if (data.selectedExternalAgent && newCredential) {
+        const updatedExternalAgent = {
+          credentialReferenceId: newCredential.id,
+        };
+        await updateExternalAgent(
+          tenantId,
+          projectId,
+          data.selectedExternalAgent,
+          updatedExternalAgent
+        );
+      }
+
       toast.success('Credential created successfully');
       router.push(`/${tenantId}/projects/${projectId}/credentials`);
     } catch (error) {

package/src/components/data-components/preview/component-preview-generator.tsx

@@ -250,7 +250,7 @@ export function ComponentPreviewGenerator({
               </Popover>
               {isSaved && (
                 <Button
-                  variant="destructive"
+                  variant="destructive-outline"
                   onClick={handleDeletePreview}
                   disabled={isDeleting || isGenerating}
                   size="icon"

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>;