import { useState, useEffect, useRef, useMemo } 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"; import { getUIAdapter } from "../adapters"; import { ClaudeLocalAdvancedFields } from "../adapters/claude-local/config-fields"; /* ---- Create mode values ---- */ // Canonical type lives in @paperclip/adapter-utils; re-exported here // so existing imports from this file keep working. export type { CreateConfigValues } from "@paperclip/adapter-utils"; import type { CreateConfigValues } from "@paperclip/adapter-utils"; export const defaultCreateValues: CreateConfigValues = { adapterType: "claude_local", cwd: "", promptTemplate: "", model: "", dangerouslySkipPermissions: false, search: false, dangerouslyBypassSandbox: false, command: "", args: "", extraArgs: "", envVars: "", url: "", bootstrapPrompt: "", maxTurnsPerRun: 80, heartbeatEnabled: false, intervalSec: 300, }; /* ---- Props ---- */ type AgentConfigFormProps = { adapterModels?: AdapterModel[]; onDirtyChange?: (dirty: boolean) => void; onSaveActionChange?: (save: (() => void) | null) => void; onCancelActionChange?: (cancel: (() => void) | null) => void; hideInlineSave?: boolean; } & ( | { 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"; function parseCommaArgs(value: string): string[] { return value .split(",") .map((item) => item.trim()) .filter(Boolean); } function formatArgList(value: unknown): string { if (Array.isArray(value)) { return value .filter((item): item is string => typeof item === "string") .join(", "); } return typeof value === "string" ? value : ""; } function parseEnvVars(text: string): Record { const env: Record = {}; for (const line of text.split(/\r?\n/)) { const trimmed = line.trim(); if (!trimmed || trimmed.startsWith("#")) continue; const eq = trimmed.indexOf("="); if (eq <= 0) continue; const key = trimmed.slice(0, eq).trim(); const value = trimmed.slice(eq + 1); if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) continue; env[key] = value; } return env; } function formatEnvVars(value: unknown): string { if (typeof value !== "object" || value === null || Array.isArray(value)) return ""; return Object.entries(value as Record) .filter(([, v]) => typeof v === "string") .map(([k, v]) => `${k}=${String(v)}`) .join("\n"); } function extractPickedDirectoryPath(handle: unknown): string | null { if (typeof handle !== "object" || handle === null) return null; const maybePath = (handle as { path?: unknown }).path; return typeof maybePath === "string" && maybePath.length > 0 ? maybePath : null; } /* ---- 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); } useEffect(() => { if (!isCreate) { props.onDirtyChange?.(isDirty); props.onSaveActionChange?.(() => handleSave()); props.onCancelActionChange?.(() => setOverlay({ ...emptyOverlay })); return () => { props.onSaveActionChange?.(null); props.onCancelActionChange?.(null); props.onDirtyChange?.(false); }; } return; }, [isCreate, isDirty, props.onDirtyChange, props.onSaveActionChange, props.onCancelActionChange, overlay]); // eslint-disable-line react-hooks/exhaustive-deps // ---- 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"; const uiAdapter = useMemo(() => getUIAdapter(adapterType), [adapterType]); // Fetch adapter models for the effective adapter type const { data: fetchedModels } = useQuery({ queryKey: ["adapter-models", adapterType], queryFn: () => agentsApi.adapterModels(adapterType), }); const models = fetchedModels ?? externalModels ?? []; /** Props passed to adapter-specific config field components */ const adapterFieldProps = { mode, isCreate, adapterType, values: isCreate ? props.values : null, set: isCreate ? (patch: Partial) => props.onChange(patch) : null, config, eff: eff as (group: "adapterConfig", field: string, original: T) => T, mark: mark as (group: "adapterConfig", field: string, value: unknown) => void, models, }; // Section toggle state — advanced always starts collapsed const [adapterAdvancedOpen, setAdapterAdvancedOpen] = useState(false); const [heartbeatOpen, setHeartbeatOpen] = useState(!isCreate); const [cwdPickerNotice, setCwdPickerNotice] = useState(null); // 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 && !props.hideInlineSave && (
Unsaved changes
)} {/* ---- Identity (edit only) ---- */} {!isCreate && (
Identity
mark("identity", "name", v)} immediate className={inputClass} placeholder="Agent name" /> mark("identity", "title", v || null)} immediate className={inputClass} placeholder="e.g. VP of Engineering" /> mark("identity", "capabilities", v || null)} immediate 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 className="w-full bg-transparent outline-none text-sm font-mono placeholder:text-muted-foreground/40" placeholder="/path/to/project" />
{cwdPickerNotice && (

{cwdPickerNotice}

)}
)} {/* Prompt template */} {isLocal && ( {isCreate ? ( set!({ promptTemplate: v })} minRows={4} /> ) : ( mark("adapterConfig", "promptTemplate", v || undefined) } immediate placeholder="You are agent {{ agent.name }}. Your role is {{ agent.role }}..." minRows={4} /> )} )} {/* Adapter-specific fields */} {/* Advanced adapter section — collapsible in both modes */} {isLocal && ( setAdapterAdvancedOpen(!adapterAdvancedOpen)} >
isCreate ? set!({ command: v }) : mark("adapterConfig", "command", v || undefined) } immediate className={inputClass} placeholder={adapterType === "codex_local" ? "codex" : "claude"} /> isCreate ? set!({ model: v }) : mark("adapterConfig", "model", v || undefined) } open={modelOpen} onOpenChange={setModelOpen} /> {isCreate ? ( set!({ bootstrapPrompt: v })} minRows={2} /> ) : ( mark("adapterConfig", "bootstrapPromptTemplate", v || undefined) } immediate placeholder="Optional initial setup prompt for the first run" minRows={2} /> )} {adapterType === "claude_local" && ( )} isCreate ? set!({ extraArgs: v }) : mark("adapterConfig", "extraArgs", v ? parseCommaArgs(v) : undefined) } immediate className={inputClass} placeholder="e.g. --verbose, --foo=bar" /> {isCreate ? ( set!({ envVars: v })} minRows={3} /> ) : ( { const parsed = parseEnvVars(v); mark( "adapterConfig", "env", Object.keys(parsed).length > 0 ? parsed : undefined, ); }} immediate placeholder={"ANTHROPIC_API_KEY=...\nPAPERCLIP_API_URL=http://localhost:3100"} minRows={3} /> )} {/* Edit-only: timeout + grace period */} {!isCreate && ( <> mark("adapterConfig", "timeoutSec", v)} immediate className={inputClass} /> mark("adapterConfig", "graceSec", v)} immediate 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", "wakeOnDemand", v)} /> mark("heartbeat", "cooldownSec", v)} immediate className={inputClass} />
)} {/* ---- Runtime (edit only) ---- */} {!isCreate && (
Runtime
mark("runtime", "budgetMonthlyCents", v)} immediate 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) => ( ))} ); }