import { useState, useEffect, useRef } from "react"; import { useQuery } from "@tanstack/react-query"; import { AGENT_ADAPTER_TYPES } from "@paperclip/shared"; import type { Agent } from "@paperclip/shared"; import type { AdapterModel } from "../api/agents"; import { agentsApi } from "../api/agents"; import { Popover, PopoverContent, PopoverTrigger, } from "@/components/ui/popover"; import { Button } from "@/components/ui/button"; import { FolderOpen, Heart, ChevronDown } from "lucide-react"; import { cn } from "../lib/utils"; import { Field, ToggleField, ToggleWithNumber, CollapsibleSection, AutoExpandTextarea, DraftInput, DraftTextarea, DraftNumberInput, help, adapterLabels, } from "./agent-config-primitives"; /* ---- Create mode values ---- */ export interface CreateConfigValues { adapterType: string; cwd: string; promptTemplate: string; model: string; dangerouslySkipPermissions: boolean; search: boolean; dangerouslyBypassSandbox: boolean; command: string; args: string; url: string; bootstrapPrompt: string; maxTurnsPerRun: number; heartbeatEnabled: boolean; intervalSec: number; } export const defaultCreateValues: CreateConfigValues = { adapterType: "claude_local", cwd: "", promptTemplate: "", model: "", dangerouslySkipPermissions: false, search: false, dangerouslyBypassSandbox: false, command: "", args: "", url: "", bootstrapPrompt: "", maxTurnsPerRun: 80, heartbeatEnabled: false, intervalSec: 300, }; /* ---- Props ---- */ type AgentConfigFormProps = { adapterModels?: AdapterModel[]; } & ( | { mode: "create"; values: CreateConfigValues; onChange: (patch: Partial) => void; } | { mode: "edit"; agent: Agent; onSave: (patch: Record) => void; isSaving?: boolean; } ); /* ---- Edit mode overlay (dirty tracking) ---- */ interface Overlay { identity: Record; adapterType?: string; adapterConfig: Record; heartbeat: Record; runtime: Record; } const emptyOverlay: Overlay = { identity: {}, adapterConfig: {}, heartbeat: {}, runtime: {}, }; function isOverlayDirty(o: Overlay): boolean { return ( Object.keys(o.identity).length > 0 || o.adapterType !== undefined || Object.keys(o.adapterConfig).length > 0 || Object.keys(o.heartbeat).length > 0 || Object.keys(o.runtime).length > 0 ); } /* ---- Shared input class ---- */ const inputClass = "w-full rounded-md border border-border px-2.5 py-1.5 bg-transparent outline-none text-sm font-mono placeholder:text-muted-foreground/40"; /* ---- Form ---- */ export function AgentConfigForm(props: AgentConfigFormProps) { const { mode, adapterModels: externalModels } = props; const isCreate = mode === "create"; // ---- Edit mode: overlay for dirty tracking ---- const [overlay, setOverlay] = useState(emptyOverlay); const agentRef = useRef(null); // Clear overlay when agent data refreshes (after save) useEffect(() => { if (!isCreate) { if (agentRef.current !== null && props.agent !== agentRef.current) { setOverlay({ ...emptyOverlay }); } agentRef.current = props.agent; } }, [isCreate, !isCreate ? props.agent : undefined]); // eslint-disable-line react-hooks/exhaustive-deps const isDirty = !isCreate && isOverlayDirty(overlay); /** Read effective value: overlay if dirty, else original */ function eff(group: keyof Omit, field: string, original: T): T { const o = overlay[group]; if (field in o) return o[field] as T; return original; } /** Mark field dirty in overlay */ function mark(group: keyof Omit, field: string, value: unknown) { setOverlay((prev) => ({ ...prev, [group]: { ...prev[group], [field]: value }, })); } /** Build accumulated patch and send to parent */ function handleSave() { if (isCreate || !isDirty) return; const agent = props.agent; const patch: Record = {}; if (Object.keys(overlay.identity).length > 0) { Object.assign(patch, overlay.identity); } if (overlay.adapterType !== undefined) { patch.adapterType = overlay.adapterType; } if (Object.keys(overlay.adapterConfig).length > 0) { const existing = (agent.adapterConfig ?? {}) as Record; patch.adapterConfig = { ...existing, ...overlay.adapterConfig }; } if (Object.keys(overlay.heartbeat).length > 0) { const existingRc = (agent.runtimeConfig ?? {}) as Record; const existingHb = (existingRc.heartbeat ?? {}) as Record; patch.runtimeConfig = { ...existingRc, heartbeat: { ...existingHb, ...overlay.heartbeat } }; } if (Object.keys(overlay.runtime).length > 0) { Object.assign(patch, overlay.runtime); } props.onSave(patch); } // ---- Resolve values ---- const config = !isCreate ? ((props.agent.adapterConfig ?? {}) as Record) : {}; const runtimeConfig = !isCreate ? ((props.agent.runtimeConfig ?? {}) as Record) : {}; const heartbeat = !isCreate ? ((runtimeConfig.heartbeat ?? {}) as Record) : {}; const adapterType = isCreate ? props.values.adapterType : overlay.adapterType ?? props.agent.adapterType; const isLocal = adapterType === "claude_local" || adapterType === "codex_local"; // Fetch adapter models for the effective adapter type const { data: fetchedModels } = useQuery({ queryKey: ["adapter-models", adapterType], queryFn: () => agentsApi.adapterModels(adapterType), }); const models = fetchedModels ?? externalModels ?? []; // Section toggle state — advanced always starts collapsed const [adapterAdvancedOpen, setAdapterAdvancedOpen] = useState(false); const [heartbeatOpen, setHeartbeatOpen] = useState(!isCreate); // Popover states const [modelOpen, setModelOpen] = useState(false); // Create mode helpers const val = isCreate ? props.values : null; const set = isCreate ? (patch: Partial) => props.onChange(patch) : null; // Current model for display const currentModelId = isCreate ? val!.model : eff("adapterConfig", "model", String(config.model ?? "")); return (
{/* ---- Floating Save button (edit mode, when dirty) ---- */} {isDirty && (
Unsaved changes
)} {/* ---- Identity (edit only) ---- */} {!isCreate && (
Identity
mark("identity", "name", v)} className={inputClass} placeholder="Agent name" /> mark("identity", "title", v || null)} className={inputClass} placeholder="e.g. VP of Engineering" /> mark("identity", "capabilities", v || null)} placeholder="Describe what this agent can do..." minRows={2} />
)} {/* ---- Adapter type ---- */}
{ if (isCreate) { set!({ adapterType: t }); } else { setOverlay((prev) => ({ ...prev, adapterType: t, adapterConfig: {}, // clear adapter config when type changes })); } }} />
{/* ---- Adapter Configuration ---- */}
Adapter Configuration
{/* Working directory */} {isLocal && (
isCreate ? set!({ cwd: v }) : mark("adapterConfig", "cwd", v || undefined) } immediate={isCreate} className="w-full bg-transparent outline-none text-sm font-mono placeholder:text-muted-foreground/40" placeholder="/path/to/project" />
)} {/* Prompt template */} {isLocal && ( {isCreate ? ( set!({ promptTemplate: v })} minRows={4} /> ) : ( mark("adapterConfig", "promptTemplate", v || undefined) } placeholder="You are agent {{ agent.name }}. Your role is {{ agent.role }}..." minRows={4} /> )} )} {/* Claude-specific: Skip permissions */} {adapterType === "claude_local" && ( isCreate ? set!({ dangerouslySkipPermissions: v }) : mark("adapterConfig", "dangerouslySkipPermissions", v) } /> )} {/* Codex-specific: Bypass sandbox + Search */} {adapterType === "codex_local" && ( <> isCreate ? set!({ dangerouslyBypassSandbox: v }) : mark("adapterConfig", "dangerouslyBypassApprovalsAndSandbox", v) } /> isCreate ? set!({ search: v }) : mark("adapterConfig", "search", v) } /> )} {/* Process-specific */} {adapterType === "process" && ( <> isCreate ? set!({ command: v }) : mark("adapterConfig", "command", v || undefined) } immediate={isCreate} className={inputClass} placeholder="e.g. node, python" /> isCreate ? set!({ args: v }) : mark( "adapterConfig", "args", v ? v .split(",") .map((a) => a.trim()) .filter(Boolean) : undefined, ) } immediate={isCreate} className={inputClass} placeholder="e.g. script.js, --flag" /> )} {/* HTTP-specific */} {adapterType === "http" && ( isCreate ? set!({ url: v }) : mark("adapterConfig", "url", v || undefined) } immediate={isCreate} className={inputClass} placeholder="https://..." /> )} {/* Advanced adapter section — collapsible in both modes */} {isLocal && ( setAdapterAdvancedOpen(!adapterAdvancedOpen)} >
isCreate ? set!({ model: v }) : mark("adapterConfig", "model", v || undefined) } open={modelOpen} onOpenChange={setModelOpen} /> {isCreate ? ( set!({ bootstrapPrompt: v })} minRows={2} /> ) : ( mark("adapterConfig", "bootstrapPromptTemplate", v || undefined) } placeholder="Optional initial setup prompt for the first run" minRows={2} /> )} {adapterType === "claude_local" && ( {isCreate ? ( set!({ maxTurnsPerRun: Number(e.target.value) })} /> ) : ( mark("adapterConfig", "maxTurnsPerRun", v || 80)} className={inputClass} /> )} )} {/* Edit-only: timeout + grace period */} {!isCreate && ( <> mark("adapterConfig", "timeoutSec", v)} className={inputClass} /> mark("adapterConfig", "graceSec", v)} className={inputClass} /> )}
)}
{/* ---- Heartbeat Policy ---- */} {isCreate ? ( } open={heartbeatOpen} onToggle={() => setHeartbeatOpen(!heartbeatOpen)} bordered >
set!({ heartbeatEnabled: v })} number={val!.intervalSec} onNumberChange={(v) => set!({ intervalSec: v })} numberLabel="sec" numberPrefix="Run heartbeat every" numberHint={help.intervalSec} showNumber={val!.heartbeatEnabled} />
) : (
Heartbeat Policy
mark("heartbeat", "enabled", v)} number={eff("heartbeat", "intervalSec", Number(heartbeat.intervalSec ?? 300))} onNumberChange={(v) => mark("heartbeat", "intervalSec", v)} numberLabel="sec" numberPrefix="Run heartbeat every" numberHint={help.intervalSec} showNumber={eff("heartbeat", "enabled", heartbeat.enabled !== false)} /> {/* Edit-only: wake-on-* and cooldown */}
Advanced
mark("heartbeat", "wakeOnAssignment", v)} /> mark("heartbeat", "wakeOnOnDemand", v)} /> mark("heartbeat", "wakeOnAutomation", v)} /> mark("heartbeat", "cooldownSec", v)} className={inputClass} />
)} {/* ---- Runtime (edit only) ---- */} {!isCreate && (
Runtime
{props.agent.contextMode}
mark("runtime", "budgetMonthlyCents", v)} className={inputClass} />
)}
); } /* ---- Internal sub-components ---- */ function AdapterTypeDropdown({ value, onChange, }: { value: string; onChange: (type: string) => void; }) { return ( {AGENT_ADAPTER_TYPES.map((t) => ( ))} ); } function ModelDropdown({ models, value, onChange, open, onOpenChange, }: { models: AdapterModel[]; value: string; onChange: (id: string) => void; open: boolean; onOpenChange: (open: boolean) => void; }) { const selected = models.find((m) => m.id === value); return ( {models.map((m) => ( ))} ); }