Files
fusion/packages/dashboard/app/components/PluginManager.tsx
gsxdsm ff0750cd15 Fix invisible workflow graph editor and bundle CE/Roadmap plugins
- WorkflowNodeEditor overlay was missing the `open` class, so the
  graph editor mounted with display:none — clicking the button just
  dismissed the steps view. Add `open` so the overlay renders.
- Add fusion-plugin-compound-engineering and fusion-plugin-roadmap to
  BUILTIN_PLUGINS so they show under Settings → Built-in Plugins.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-03 23:25:28 -07:00

1102 lines
48 KiB
TypeScript

/**
* Plugin Manager Component
*
* Provides UI for managing installed plugins:
* - List installed plugins with state indicators
* - Install plugins from local paths
* - Enable/disable plugins
* - Configure plugin settings
* - Uninstall plugins
* - Live updates via SSE (plugin:lifecycle events)
*/
import "./PluginManager.css";
import { useState, useEffect, useCallback, useRef } from "react";
import { useTranslation } from "react-i18next";
import { Package, Settings, Trash2, Plus, X, RefreshCw, RotateCcw, ExternalLink, Shield } from "lucide-react";
import { fetchPlugins, installPlugin, enablePlugin, disablePlugin, uninstallPlugin, fetchPluginSettings, updatePluginSettings, reloadPlugin, fetchPluginSetupStatus, installPluginSetup, updatePlugin, rescanPlugin } from "../api";
import { DirectoryPicker } from "./DirectoryPicker";
import type { PluginInstallation, PluginState, PluginSettingSchema } from "@fusion/core";
import type { PluginSetupStatusResponse } from "../api";
import type { ToastType } from "../hooks/useToast";
import { useConfirm } from "../hooks/useConfirm";
import { subscribeSse } from "../sse-bus";
/** Normalized plugin lifecycle payload from SSE plugin:lifecycle events */
interface PluginLifecyclePayload {
scope: "global" | "project";
pluginId: string;
transition: "installing" | "enabled" | "disabled" | "error" | "state-changed" | "uninstalled" | "settings-updated";
sourceEvent: string;
timestamp: string;
projectId?: string;
enabled: boolean;
state: PluginState;
version: string;
settings: Record<string, unknown>;
error?: string;
}
interface PluginManagerProps {
addToast: (message: string, type?: ToastType) => void;
projectId?: string;
}
interface BuiltinPlugin {
id: string;
name: string;
description: string;
category: "runtime" | "integration";
path?: string;
experimental?: boolean;
hasSetup?: boolean;
}
export const BUILTIN_AGENT_BROWSER_PLUGIN_ID = "fusion-plugin-agent-browser";
export const AGENT_BROWSER_SETTINGS_SCHEMA: Record<string, PluginSettingSchema> = {
enabled: { type: "boolean", label: "Enable Agent Browser", group: "General" },
installChannel: {
type: "enum",
label: "Install Channel",
enumValues: ["stable", "beta", "nightly"],
defaultValue: "stable",
group: "General",
},
commandTimeoutMs: {
type: "number",
label: "Command Timeout (ms)",
defaultValue: 120000,
group: "General",
},
headlessMode: { type: "boolean", label: "Headless Mode", defaultValue: true, group: "Browser" },
allowedDomains: { type: "array", label: "Allowed Domains", itemType: "string", group: "Browser" },
promptExecutorSystem: { type: "string", label: "Executor System Prompt", multiline: true, group: "Prompt Contributions" },
promptExecutorTask: { type: "string", label: "Executor Task Prompt", multiline: true, group: "Prompt Contributions" },
promptTriage: { type: "string", label: "Triage Prompt", multiline: true, group: "Prompt Contributions" },
promptReviewer: { type: "string", label: "Reviewer Prompt", multiline: true, group: "Prompt Contributions" },
promptHeartbeat: { type: "string", label: "Heartbeat Prompt", multiline: true, group: "Prompt Contributions" },
skillExposure: {
type: "enum",
label: "Skill Exposure",
enumValues: ["none", "selected", "all"],
defaultValue: "selected",
group: "Skills",
},
};
/** Maps known agent-browser schema group names to their i18n keys */
const AGENT_BROWSER_GROUP_KEYS: Record<string, string> = {
"General": "plugins.agentBrowser.groupGeneral",
"Browser": "plugins.agentBrowser.groupBrowser",
"Prompt Contributions": "plugins.agentBrowser.groupPromptContributions",
"Skills": "plugins.agentBrowser.groupSkills",
};
/** Maps known agent-browser schema label strings to their i18n keys */
const AGENT_BROWSER_LABEL_KEYS: Record<string, string> = {
"Enable Agent Browser": "plugins.agentBrowser.labelEnabled",
"Install Channel": "plugins.agentBrowser.labelInstallChannel",
"Command Timeout (ms)": "plugins.agentBrowser.labelCommandTimeoutMs",
"Headless Mode": "plugins.agentBrowser.labelHeadlessMode",
"Allowed Domains": "plugins.agentBrowser.labelAllowedDomains",
"Executor System Prompt": "plugins.agentBrowser.labelPromptExecutorSystem",
"Executor Task Prompt": "plugins.agentBrowser.labelPromptExecutorTask",
"Triage Prompt": "plugins.agentBrowser.labelPromptTriage",
"Reviewer Prompt": "plugins.agentBrowser.labelPromptReviewer",
"Heartbeat Prompt": "plugins.agentBrowser.labelPromptHeartbeat",
"Skill Exposure": "plugins.agentBrowser.labelSkillExposure",
};
const BUILTIN_PLUGINS: BuiltinPlugin[] = [
{
id: "fusion-plugin-hermes-runtime",
name: "Hermes Runtime",
description: "Runtime provider for Hermes CLI-backed execution.",
category: "runtime",
path: "./plugins/fusion-plugin-hermes-runtime",
experimental: true,
},
{
id: "fusion-plugin-paperclip-runtime",
name: "Paperclip Runtime",
description: "Runtime provider for Paperclip agent connections.",
category: "runtime",
path: "./plugins/fusion-plugin-paperclip-runtime",
},
{
id: "fusion-plugin-openclaw-runtime",
name: "OpenClaw Runtime",
description: "Runtime provider for OpenClaw execution.",
category: "runtime",
path: "./plugins/fusion-plugin-openclaw-runtime",
experimental: true,
},
{
id: "fusion-plugin-droid-runtime",
name: "Droid Runtime",
description: "Runtime provider for Droid CLI execution.",
category: "runtime",
path: "./plugins/fusion-plugin-droid-runtime",
experimental: true,
},
{
id: "fusion-plugin-dependency-graph",
name: "Dependency Graph",
description: "Dashboard plugin for task dependency graph visualization.",
category: "integration",
path: "./plugins/fusion-plugin-dependency-graph",
},
{
id: "fusion-plugin-reports",
name: "Reports",
description: "View report history, compare runs side-by-side, and export standalone HTML summaries.",
category: "integration",
path: "./plugins/fusion-plugin-reports",
},
{
id: "fusion-plugin-whatsapp-chat",
name: "WhatsApp Chat",
description: "Pairs to WhatsApp Web (multi-device) with QR or pairing code, then bridges direct chats to a Fusion agent.",
category: "integration",
path: "./plugins/fusion-plugin-whatsapp-chat",
},
{
id: "fusion-plugin-cli-printing-press",
name: "CLI Printing Press",
description: "Guided wizard for drafting external service CLI definitions.",
category: "integration",
path: "./plugins/fusion-plugin-cli-printing-press",
},
{
id: "fusion-plugin-compound-engineering",
name: "Compound Engineering",
description: "A dedicated dashboard surface for compound-engineering artifacts and interactive ce-* sessions.",
category: "integration",
path: "./plugins/fusion-plugin-compound-engineering",
},
{
id: "fusion-plugin-roadmap",
name: "Roadmaps",
description: "Standalone roadmap planning plugin.",
category: "integration",
path: "./plugins/fusion-plugin-roadmap",
},
{
id: BUILTIN_AGENT_BROWSER_PLUGIN_ID,
name: "Agent Browser",
description: "Built-in integration metadata. Package install support lands in FN-3101.",
category: "integration",
hasSetup: true,
},
];
export const STATE_COLORS: Record<string, string> = {
started: "var(--color-success)",
loaded: "var(--color-warning)",
error: "var(--color-error)",
stopped: "var(--color-muted)",
installed: "var(--color-info)",
};
function resolveSettingsSchema(plugin: PluginInstallation): Record<string, PluginSettingSchema> | undefined {
const pluginSchema = plugin.settingsSchema;
const hasPluginSchema = pluginSchema && Object.keys(pluginSchema).length > 0;
if (plugin.id !== BUILTIN_AGENT_BROWSER_PLUGIN_ID) {
return hasPluginSchema ? pluginSchema : undefined;
}
if (!hasPluginSchema) {
return AGENT_BROWSER_SETTINGS_SCHEMA;
}
return {
...AGENT_BROWSER_SETTINGS_SCHEMA,
...pluginSchema,
};
}
function groupSettingsSchema(settingsSchema: Record<string, PluginSettingSchema>) {
const grouped = new Map<string, Array<[string, PluginSettingSchema]>>();
const ungrouped: Array<[string, PluginSettingSchema]> = [];
for (const [key, schema] of Object.entries(settingsSchema)) {
if (schema.group) {
const groupItems = grouped.get(schema.group) ?? [];
groupItems.push([key, schema]);
grouped.set(schema.group, groupItems);
} else {
ungrouped.push([key, schema]);
}
}
return { grouped, ungrouped };
}
function renderPluginError(plugin: PluginInstallation, className = "plugin-error-text") {
if (plugin.state !== "error" || !plugin.error) {
return null;
}
return (
<p className={className} title={plugin.error}>
{plugin.error}
</p>
);
}
export function PluginManager({ addToast, projectId }: PluginManagerProps) {
const { t } = useTranslation("app");
const [plugins, setPlugins] = useState<PluginInstallation[]>([]);
const [loading, setLoading] = useState(true);
const [showInstall, setShowInstall] = useState(false);
const [installPath, setInstallPath] = useState("");
const [installing, setInstalling] = useState(false);
const [installAiScanOnLoad, setInstallAiScanOnLoad] = useState(false);
const [reloadingPluginId, setReloadingPluginId] = useState<string | null>(null);
const [selectedPlugin, setSelectedPlugin] = useState<PluginInstallation | null>(null);
const [pluginSettings, setPluginSettings] = useState<Record<string, unknown>>({});
const [settingsLoading, setSettingsLoading] = useState(false);
const [installingBuiltinPluginId, setInstallingBuiltinPluginId] = useState<string | null>(null);
const [builtinSetupStatusById, setBuiltinSetupStatusById] = useState<Record<string, PluginSetupStatusResponse>>({});
const [loadingBuiltinSetupId, setLoadingBuiltinSetupId] = useState<string | null>(null);
const [installingBuiltinSetupId, setInstallingBuiltinSetupId] = useState<string | null>(null);
const { confirm } = useConfirm();
const loadPlugins = useCallback(async () => {
try {
setLoading(true);
const data = await fetchPlugins(projectId);
setPlugins(data);
} catch (err) {
addToast(t("plugins.loadFailed", "Failed to load plugins: {{error}}", { error: err instanceof Error ? err.message : String(err) }), "error");
} finally {
setLoading(false);
}
}, [projectId, addToast]);
useEffect(() => {
loadPlugins();
}, [loadPlugins]);
useEffect(() => {
const installedBuiltinsWithSetup = BUILTIN_PLUGINS.filter((builtinPlugin) => (
builtinPlugin.hasSetup && plugins.some((plugin) => plugin.id === builtinPlugin.id)
));
if (installedBuiltinsWithSetup.length === 0) {
return;
}
let cancelled = false;
void Promise.all(installedBuiltinsWithSetup.map(async (builtinPlugin) => {
try {
const response = await fetchPluginSetupStatus(builtinPlugin.id, projectId);
if (cancelled) {
return;
}
setBuiltinSetupStatusById((prev) => ({ ...prev, [builtinPlugin.id]: response }));
} catch {
if (cancelled) {
return;
}
setBuiltinSetupStatusById((prev) => ({
...prev,
[builtinPlugin.id]: {
hasSetup: true,
setupCheckDeferred: true,
deferredReason: "plugin-not-started",
pluginState: "installed",
},
}));
}
}));
return () => {
cancelled = true;
};
}, [plugins, projectId]);
// SSE live updates for plugin lifecycle events
const pluginsRef = useRef<PluginInstallation[]>([]);
pluginsRef.current = plugins;
useEffect(() => {
const query = projectId ? `?projectId=${encodeURIComponent(projectId)}` : "";
const handlePluginLifecycle = (e: MessageEvent) => {
try {
const payload: PluginLifecyclePayload = JSON.parse(e.data);
if (payload.scope === "project") {
if ((payload.projectId ?? projectId) !== projectId) {
return;
}
}
switch (payload.transition) {
case "installing":
case "enabled":
case "disabled":
case "settings-updated":
// Update existing plugin or add if new
setPlugins((prev) => {
const existingIndex = prev.findIndex((p) => p.id === payload.pluginId);
if (existingIndex >= 0) {
// Update existing plugin
const updated = [...prev];
updated[existingIndex] = {
...updated[existingIndex],
enabled: payload.enabled,
state: payload.state,
settings: payload.settings,
error: payload.error,
};
return updated;
} else {
// New plugin added via another session — refetch to get full data
void loadPlugins();
return prev;
}
});
break;
case "state-changed":
setPlugins((prev) => {
const existingIndex = prev.findIndex((p) => p.id === payload.pluginId);
if (existingIndex >= 0) {
const updated = [...prev];
updated[existingIndex] = {
...updated[existingIndex],
state: payload.state,
error: payload.error,
};
return updated;
}
return prev;
});
break;
case "uninstalled":
// Remove plugin from list
setPlugins((prev) => prev.filter((p) => p.id !== payload.pluginId));
break;
case "error":
// Update plugin state to error
setPlugins((prev) => {
const existingIndex = prev.findIndex((p) => p.id === payload.pluginId);
if (existingIndex >= 0) {
const updated = [...prev];
updated[existingIndex] = {
...updated[existingIndex],
state: payload.state,
error: payload.error,
};
return updated;
}
return prev;
});
break;
}
} catch {
// Ignore parse errors
}
};
return subscribeSse(`/api/events${query}`, {
events: { "plugin:lifecycle": handlePluginLifecycle },
onReconnect: () => {
// Re-sync plugin list after a forced reconnect — any events that
// occurred while disconnected would otherwise be missed.
void loadPlugins();
},
});
}, [projectId, loadPlugins]);
const handleInstall = async () => {
if (!installPath.trim()) {
addToast(t("plugins.installPathRequired", "Please enter a plugin path"), "error");
return;
}
try {
setInstalling(true);
await installPlugin({ path: installPath, ...(installAiScanOnLoad ? { aiScanOnLoad: true } : {}) }, projectId);
addToast(t("plugins.installedGlobally", "Plugin installed globally"), "success");
setShowInstall(false);
setInstallPath("");
setInstallAiScanOnLoad(false);
await loadPlugins();
} catch (err) {
addToast(t("plugins.installFailed", "Failed to install plugin: {{error}}", { error: err instanceof Error ? err.message : String(err) }), "error");
} finally {
setInstalling(false);
}
};
const handleInstallBuiltinPlugin = async (plugin: BuiltinPlugin) => {
if (!plugin.path) {
addToast(t("plugins.builtinNoPackage", "{{name}} is built in and does not have an installable package yet", { name: plugin.name }), "warning");
return;
}
try {
setInstallingBuiltinPluginId(plugin.id);
await installPlugin({ path: plugin.path }, projectId);
addToast(t("plugins.builtinInstalledGlobally", "{{name}} installed globally", { name: plugin.name }), "success");
await loadPlugins();
} catch (err) {
addToast(t("plugins.builtinInstallFailed", "Failed to install {{name}}: {{error}}", { name: plugin.name, error: err instanceof Error ? err.message : String(err) }), "error");
} finally {
setInstallingBuiltinPluginId(null);
}
};
const handleInstallBuiltinSetup = async (plugin: BuiltinPlugin) => {
try {
setInstallingBuiltinSetupId(plugin.id);
const result = await installPluginSetup(plugin.id, projectId);
if (!result.success) {
addToast(t("plugins.setupInstallFailed", "Failed to install {{name}} setup: {{error}}", { name: plugin.name, error: result.error ?? t("plugins.unknownError", "unknown error") }), "error");
return;
}
addToast(t("plugins.setupInstalled", "{{name}} setup installed", { name: plugin.name }), "success");
setLoadingBuiltinSetupId(plugin.id);
const setupStatus = await fetchPluginSetupStatus(plugin.id, projectId);
setBuiltinSetupStatusById((prev) => ({ ...prev, [plugin.id]: setupStatus }));
} catch (err) {
addToast(t("plugins.setupInstallFailed", "Failed to install {{name}} setup: {{error}}", { name: plugin.name, error: err instanceof Error ? err.message : String(err) }), "error");
} finally {
setInstallingBuiltinSetupId(null);
setLoadingBuiltinSetupId(null);
}
};
const handleEnable = async (plugin: PluginInstallation) => {
try {
const enabledPlugin = await enablePlugin(plugin.id, projectId);
if (enabledPlugin.state === "error") {
addToast(t("plugins.enableFailed", "Failed to enable {{name}}: {{error}}", { name: plugin.name, error: enabledPlugin.error ?? t("plugins.unknownError", "unknown error") }), "error");
await loadPlugins();
return;
}
addToast(t("plugins.enabledForProject", "{{name}} enabled for this project", { name: plugin.name }), "success");
await loadPlugins();
} catch (err) {
addToast(t("plugins.enablePluginFailed", "Failed to enable plugin: {{error}}", { error: err instanceof Error ? err.message : String(err) }), "error");
}
};
const handleDisable = async (plugin: PluginInstallation) => {
try {
await disablePlugin(plugin.id, projectId);
addToast(t("plugins.disabledForProject", "{{name}} disabled for this project", { name: plugin.name }), "success");
await loadPlugins();
} catch (err) {
addToast(t("plugins.disablePluginFailed", "Failed to disable plugin: {{error}}", { error: err instanceof Error ? err.message : String(err) }), "error");
}
};
const handleReload = async (plugin: PluginInstallation) => {
try {
setReloadingPluginId(plugin.id);
await reloadPlugin(plugin.id, projectId);
addToast(t("plugins.reloaded", "{{name}} reloaded", { name: plugin.name }), "success");
await loadPlugins();
} catch (err) {
addToast(t("plugins.reloadFailed", "Failed to reload plugin: {{error}}", { error: err instanceof Error ? err.message : String(err) }), "error");
} finally {
setReloadingPluginId(null);
}
};
const handleUninstall = async (plugin: PluginInstallation) => {
const shouldUninstall = await confirm({
title: t("plugins.uninstallTitle", "Uninstall Plugin Globally"),
message: t("plugins.uninstallConfirm", "Are you sure you want to uninstall \"{{name}}\" globally (all projects)?", { name: plugin.name }),
danger: true,
});
if (!shouldUninstall) {
return;
}
try {
await uninstallPlugin(plugin.id, projectId);
addToast(t("plugins.uninstalledGlobally", "{{name}} uninstalled globally", { name: plugin.name }), "success");
await loadPlugins();
setSelectedPlugin(null);
} catch (err) {
addToast(t("plugins.uninstallFailed", "Failed to uninstall plugin: {{error}}", { error: err instanceof Error ? err.message : String(err) }), "error");
}
};
const handleToggleAiScanOnLoad = async (plugin: PluginInstallation, aiScanOnLoad: boolean) => {
try {
await updatePlugin(plugin.id, { aiScanOnLoad }, projectId);
addToast(aiScanOnLoad ? t("plugins.aiScanEnabled", "AI scan on load enabled") : t("plugins.aiScanDisabled", "AI scan on load disabled"), "success");
await loadPlugins();
} catch (err) {
addToast(t("plugins.updateFailed", "Failed to update plugin: {{error}}", { error: err instanceof Error ? err.message : String(err) }), "error");
}
};
const handleRescan = async (plugin: PluginInstallation) => {
try {
await rescanPlugin(plugin.id, projectId);
addToast(t("plugins.rescanned", "{{name}} rescanned", { name: plugin.name }), "success");
await loadPlugins();
} catch (err) {
addToast(t("plugins.rescanFailed", "Failed to rescan plugin: {{error}}", { error: err instanceof Error ? err.message : String(err) }), "error");
}
};
const handleSelectPlugin = async (plugin: PluginInstallation) => {
setSelectedPlugin(plugin);
try {
setSettingsLoading(true);
const settings = await fetchPluginSettings(plugin.id, projectId);
setPluginSettings(settings);
} catch {
setPluginSettings({});
} finally {
setSettingsLoading(false);
}
};
const handleSaveSettings = async () => {
if (!selectedPlugin) return;
try {
await updatePluginSettings(selectedPlugin.id, pluginSettings, projectId);
addToast(t("plugins.settingsSaved", "Settings saved"), "success");
} catch (err) {
addToast(t("plugins.saveSettingsFailed", "Failed to save settings: {{error}}", { error: err instanceof Error ? err.message : String(err) }), "error");
}
};
// Plugin detail view
if (selectedPlugin) {
return (
<div className="plugin-manager-detail" data-testid="plugin-manager-detail">
<div className="plugin-manager-detail-header">
<button className="btn-icon" onClick={() => setSelectedPlugin(null)} aria-label={t("plugins.backToList", "Back to plugin list")}>
<X size={16} />
</button>
<div className="plugin-detail-title">
<div className="plugin-detail-title-copy">
<h4 className="plugin-detail-name">{selectedPlugin.name}</h4>
{renderPluginError(selectedPlugin, "plugin-error-text plugin-error-text--detail")}
</div>
<span className="plugin-state-badge" style={{ color: STATE_COLORS[selectedPlugin.state] || STATE_COLORS.installed }}>
{selectedPlugin.state}
</span>
</div>
</div>
<div className="plugin-detail-content">
<div className="plugin-detail-card">
{selectedPlugin.description && (
<p className="plugin-description">{selectedPlugin.description}</p>
)}
{selectedPlugin.author && (
<p className="plugin-detail-meta-row">
<span className="text-muted">{t("plugins.author", "Author:")}</span>
{selectedPlugin.author}
</p>
)}
{selectedPlugin.homepage && (
<p className="plugin-detail-meta-row plugin-homepage">
<span className="text-muted">{t("plugins.homepage", "Homepage:")}</span>
<a href={selectedPlugin.homepage} target="_blank" rel="noopener noreferrer">
{selectedPlugin.homepage}
<ExternalLink size={12} />
</a>
</p>
)}
<p className="plugin-detail-meta-row">
<span className="text-muted">{t("plugins.version", "Version:")}</span>
{selectedPlugin.version}
</p>
</div>
<div className="plugin-detail-card">
<h5 className="plugin-detail-section-heading">{t("plugins.securityScan", "Security Scan")}</h5>
<div className="plugin-security-row">
<label className="checkbox-label">
<input
type="checkbox"
checked={Boolean(selectedPlugin.aiScanOnLoad)}
onChange={(e) => void handleToggleAiScanOnLoad(selectedPlugin, e.target.checked)}
/>
{t("plugins.enableAiScanBeforeLoad", "Enable AI scan before load/reload")}
</label>
<button className="btn btn-secondary btn-sm" onClick={() => void handleRescan(selectedPlugin)}>
<Shield size={14} /> {t("plugins.rescanAndReload", "Rescan and Reload")}
</button>
</div>
<p className="text-muted">{t("plugins.aiScanHint", "Turning this on only updates configuration. Use Rescan and Reload to run it now.")}</p>
{selectedPlugin.lastSecurityScan ? (
<div className="plugin-security-results">
<div className="plugin-security-header">
<span className={`plugin-state-badge plugin-security-badge plugin-security-badge--${selectedPlugin.lastSecurityScan.verdict}`}>
{selectedPlugin.lastSecurityScan.verdict}
</span>
<span className="text-muted">{selectedPlugin.lastSecurityScan.scannedAt}</span>
</div>
<p className="plugin-security-summary">{selectedPlugin.lastSecurityScan.summary}</p>
<details>
<summary>{t("plugins.findings", "Findings ({{count}})", { count: selectedPlugin.lastSecurityScan.findings.length })}</summary>
<ul className="plugin-security-findings">
{selectedPlugin.lastSecurityScan.findings.map((finding, index) => (
<li key={`${finding.file}-${index}`}>
<strong>{finding.severity}</strong> {finding.category} — {finding.file}: {finding.reason}
</li>
))}
</ul>
</details>
</div>
) : (
<p className="text-muted">{t("plugins.noSecurityScan", "No security scan has been run yet.")}</p>
)}
</div>
<div className="plugin-detail-card">
<h5 className="plugin-detail-section-heading">{t("plugins.settings", "Settings")}</h5>
{settingsLoading ? (
<p className="text-muted">{t("plugins.loading", "Loading...")}</p>
) : (() => {
const effectiveSettingsSchema = resolveSettingsSchema(selectedPlugin);
return effectiveSettingsSchema && Object.keys(effectiveSettingsSchema).length > 0 ? (
<div className="plugin-settings-form">
{(() => {
const { grouped, ungrouped } = groupSettingsSchema(effectiveSettingsSchema);
const sections: Array<{ title: string | null; entries: Array<[string, PluginSettingSchema]> }> = [];
if (ungrouped.length > 0) {
sections.push({ title: null, entries: ungrouped });
}
for (const [groupName, entries] of grouped.entries()) {
sections.push({ title: groupName, entries });
}
return sections.map((section) => (
<div
key={section.title ?? "ungrouped"}
className={section.title ? "plugin-settings-group" : undefined}
>
{section.title && (
<h6 className="plugin-settings-group-heading">
{AGENT_BROWSER_GROUP_KEYS[section.title]
? t(AGENT_BROWSER_GROUP_KEYS[section.title] as string, section.title)
: section.title}
</h6>
)}
{section.entries.map(([key, schema]) => {
const helpId = `setting-${key}-help`;
const displayLabel = schema.label
? (AGENT_BROWSER_LABEL_KEYS[schema.label]
? t(AGENT_BROWSER_LABEL_KEYS[schema.label] as string, schema.label)
: schema.label)
: key;
return (
<div key={key} className="form-group">
<label htmlFor={`setting-${key}`}>
{displayLabel}
{schema.required && " *"}
</label>
{schema.type === "string" && !schema.multiline && (
<input
className="input"
type="text"
id={`setting-${key}`}
value={(pluginSettings[key] as string) ?? ""}
onChange={(e) => setPluginSettings({ ...pluginSettings, [key]: e.target.value })}
placeholder={schema.description}
aria-describedby={schema.description && !schema.required ? helpId : undefined}
/>
)}
{schema.type === "string" && schema.multiline && (
<textarea
className="input"
id={`setting-${key}`}
rows={4}
value={(pluginSettings[key] as string) ?? ""}
onChange={(e) => setPluginSettings({ ...pluginSettings, [key]: e.target.value })}
placeholder={schema.description}
aria-describedby={schema.description && !schema.required ? helpId : undefined}
/>
)}
{schema.type === "password" && (
<input
className="input"
type="password"
id={`setting-${key}`}
value={(pluginSettings[key] as string) ?? ""}
onChange={(e) => setPluginSettings({ ...pluginSettings, [key]: e.target.value })}
placeholder={schema.description}
aria-describedby={schema.description && !schema.required ? helpId : undefined}
/>
)}
{schema.type === "number" && (
<input
className="input"
type="number"
id={`setting-${key}`}
value={(pluginSettings[key] as number) ?? ""}
onChange={(e) => setPluginSettings({ ...pluginSettings, [key]: Number(e.target.value) })}
aria-describedby={schema.description && !schema.required ? helpId : undefined}
/>
)}
{schema.type === "boolean" && (
<label className="checkbox-label">
<input
type="checkbox"
checked={(pluginSettings[key] as boolean) ?? false}
onChange={(e) => setPluginSettings({ ...pluginSettings, [key]: e.target.checked })}
/>
{schema.description}
</label>
)}
{schema.type === "enum" && (
<select
className="select"
id={`setting-${key}`}
value={(pluginSettings[key] as string) ?? ""}
onChange={(e) => setPluginSettings({ ...pluginSettings, [key]: e.target.value })}
aria-describedby={schema.description && !schema.required ? helpId : undefined}
>
<option value="">{t("plugins.selectOption", "Select...")}</option>
{schema.enumValues?.map((v) => (
<option key={v} value={v}>{v}</option>
))}
</select>
)}
{schema.type === "array" && (
<div className="plugin-settings-array">
{(pluginSettings[key] as unknown[] | undefined)?.map((item, index) => (
<div key={index} className="plugin-settings-array-item">
<input
className="input"
type={schema.itemType === "number" ? "number" : "text"}
value={(item as string | number) ?? ""}
onChange={(e) => {
const newValue = e.target.value;
const current = (pluginSettings[key] as unknown[]) || [];
const updated = [...current];
updated[index] = schema.itemType === "number" ? Number(newValue) : newValue;
setPluginSettings({ ...pluginSettings, [key]: updated });
}}
/>
<button
className="btn-icon"
onClick={() => {
const current = (pluginSettings[key] as unknown[]) || [];
const updated = [...current];
updated.splice(index, 1);
setPluginSettings({ ...pluginSettings, [key]: updated });
}}
aria-label={t("plugins.removeItem", "Remove item")}
>
<X size={14} />
</button>
</div>
))}
<button
className="btn btn-secondary"
onClick={() => {
const current = (pluginSettings[key] as unknown[]) || [];
const defaultItem = schema.itemType === "number" ? 0 : "";
setPluginSettings({ ...pluginSettings, [key]: [...current, defaultItem] });
}}
>
<Plus size={14} /> {t("plugins.addItem", "Add Item")}
</button>
</div>
)}
{schema.description && !schema.required && !schema.multiline && (
<span id={helpId} className="form-help">{schema.description}</span>
)}
</div>
);
})}
</div>
));
})()}
<button className="btn btn-primary" onClick={handleSaveSettings}>
{t("plugins.saveSettings", "Save Settings")}
</button>
</div>
) : (
<p className="text-muted">{t("plugins.noConfigurableSettings", "No configurable settings.")}</p>
);
})()}
</div>
<div className="plugin-detail-actions">
{selectedPlugin.state === "started" && (
<button
className="btn btn-secondary"
onClick={() => handleReload(selectedPlugin)}
disabled={reloadingPluginId === selectedPlugin.id}
>
<RotateCcw size={14} className={reloadingPluginId === selectedPlugin.id ? "spin" : ""} />
{reloadingPluginId === selectedPlugin.id ? t("plugins.reloading", "Reloading...") : t("plugins.reload", "Reload")}
</button>
)}
{selectedPlugin.enabled ? (
<button className="btn btn-secondary" onClick={() => handleDisable(selectedPlugin)}>
{t("plugins.disableInProject", "Disable in Project")}
</button>
) : (
<button className="btn btn-primary" onClick={() => handleEnable(selectedPlugin)}>
{t("plugins.enableInProject", "Enable in Project")}
</button>
)}
<button className="btn btn-danger" onClick={() => handleUninstall(selectedPlugin)}>
<Trash2 size={14} /> {t("plugins.uninstallGlobally", "Uninstall Globally")}
</button>
</div>
</div>
</div>
);
}
const installedPluginsById = new Map(plugins.map((plugin) => [plugin.id, plugin]));
const installedPlugins = plugins;
const renderBuiltinPluginSection = () => (
<section className="plugin-builtins-section" aria-label={t("plugins.builtinPlugins", "Built-in Plugins")}>
<div className="plugin-builtins-header">
<h4 className="plugin-builtins-heading">{t("plugins.builtinPlugins", "Built-in Plugins")}</h4>
<p className="plugin-builtins-description">
{t("plugins.builtinPluginsCatalog", "Built-in plugin catalog for runtimes and integrations.")}
</p>
</div>
<div className="plugin-builtins-list" aria-label={t("plugins.builtinPluginRecommendations", "Built-in plugin recommendations")}>
{BUILTIN_PLUGINS.map((builtinPlugin) => {
const installedPlugin = installedPluginsById.get(builtinPlugin.id);
const isInstalled = Boolean(installedPlugin);
const setupStatus = builtinSetupStatusById[builtinPlugin.id];
const setupStatusDeferred = Boolean(
setupStatus
&& "setupCheckDeferred" in setupStatus
&& setupStatus.setupCheckDeferred,
);
const pluginSetupState = setupStatus && "status" in setupStatus ? setupStatus.status : undefined;
const requiresSetupAction =
isInstalled
&& builtinPlugin.hasSetup
&& setupStatus?.hasSetup
&& !setupStatusDeferred
&& installedPlugin?.state === "started"
&& (pluginSetupState === "not-installed" || pluginSetupState === "error");
const setupReady = isInstalled && setupStatus?.hasSetup && pluginSetupState === "installed";
const setupCheckInFlight = loadingBuiltinSetupId === builtinPlugin.id;
const metadataOnly = !builtinPlugin.path;
return (
<div key={builtinPlugin.id} className="plugin-builtins-item">
<div className="plugin-builtins-meta">
<span className="plugin-builtins-name">{builtinPlugin.name}</span>
{builtinPlugin.experimental && <span className="plugin-builtins-runtime-badge">{t("plugins.experimental", "Experimental")}</span>}
<span className="plugin-builtins-runtime-badge">{builtinPlugin.category}</span>
<span className={`plugin-builtins-status ${isInstalled ? "plugin-builtins-status--installed" : "plugin-builtins-status--available"}`}>
{isInstalled ? t("plugins.statusInstalled", "Installed") : metadataOnly ? t("plugins.statusBuiltIn", "Built in") : t("plugins.statusNotInstalled", "Not installed")}
</span>
{requiresSetupAction && (
<span className="plugin-builtins-setup-status plugin-builtins-setup-status--warning">{t("plugins.setupRequired", "Setup required")}</span>
)}
{setupReady && (
<span className="plugin-builtins-setup-status plugin-builtins-setup-status--ready">{t("plugins.setupReady", "Setup ready")}</span>
)}
{setupCheckInFlight && (
<span className="plugin-builtins-setup-status plugin-builtins-setup-status--pending">{t("plugins.checkingSetup", "Checking setup...")}</span>
)}
{setupStatusDeferred && (
<span className="plugin-builtins-setup-status plugin-builtins-setup-status--deferred">{t("plugins.startPluginToCheckSetup", "Start plugin to check setup")}</span>
)}
<span className="plugin-builtins-description-text">{builtinPlugin.description}</span>
</div>
{metadataOnly ? (
isInstalled && requiresSetupAction ? (
<button
className="btn btn-primary btn-sm"
onClick={() => void handleInstallBuiltinSetup(builtinPlugin)}
disabled={installingBuiltinSetupId === builtinPlugin.id || setupCheckInFlight}
>
{installingBuiltinSetupId === builtinPlugin.id ? t("plugins.settingUp", "Setting up...") : t("plugins.installSetup", "Install Setup")}
</button>
) : isInstalled && installedPlugin ? (
<button className="btn btn-secondary btn-sm" onClick={() => void handleSelectPlugin(installedPlugin)}>
{t("plugins.manage", "Manage")}
</button>
) : (
<span className="plugin-builtins-metadata-only">{t("plugins.builtinMetadataOnly", "Built-in metadata only")}</span>
)
) : (
<button
className={`btn ${(isInstalled && !requiresSetupAction) ? "btn-secondary" : "btn-primary"} btn-sm`}
onClick={() => {
if (!isInstalled) {
void handleInstallBuiltinPlugin(builtinPlugin);
return;
}
if (requiresSetupAction) {
void handleInstallBuiltinSetup(builtinPlugin);
return;
}
if (installedPlugin) {
void handleSelectPlugin(installedPlugin);
}
}}
disabled={
installingBuiltinPluginId === builtinPlugin.id
|| installingBuiltinSetupId === builtinPlugin.id
|| setupCheckInFlight
}
>
{!isInstalled
? (installingBuiltinPluginId === builtinPlugin.id ? t("plugins.installing", "Installing...") : t("plugins.installNamed", "Install {{name}}", { name: builtinPlugin.name }))
: requiresSetupAction
? (installingBuiltinSetupId === builtinPlugin.id ? t("plugins.settingUp", "Setting up...") : t("plugins.installSetup", "Install Setup"))
: t("plugins.manage", "Manage")}
</button>
)}
</div>
);
})}
</div>
</section>
);
// Plugin list view
return (
<div className="plugin-manager" data-testid="plugin-manager">
<div className="plugin-manager-header">
<span className="plugin-manager-header-title">{t("plugins.installedPlugins", "Installed Plugins")}</span>
<div className="plugin-manager-actions">
<button className="btn btn-sm" onClick={loadPlugins} title={t("plugins.refresh", "Refresh")} aria-label={t("plugins.refreshPluginList", "Refresh plugin list")}>
<RefreshCw size={14} className={loading ? "spin" : ""} />
{t("plugins.refresh", "Refresh")}
</button>
<button className="btn btn-primary btn-sm" onClick={() => setShowInstall(true)}>
<Plus size={14} /> {t("plugins.install", "Install")}
</button>
</div>
</div>
{showInstall && (
<div className="plugin-install-form">
<p className="plugin-install-hint">
{t("plugins.installHint", "Browse to a plugin package root (contains manifest.json) or a built dist directory.")}
</p>
<DirectoryPicker
value={installPath}
onChange={setInstallPath}
placeholder={t("plugins.installPathPlaceholder", "Absolute path to plugin directory or dist folder")}
onInputKeyDown={(e) => {
if (e.key === "Enter") {
e.preventDefault();
handleInstall();
}
}}
/>
<label className="checkbox-label">
<input
type="checkbox"
checked={installAiScanOnLoad}
onChange={(e) => setInstallAiScanOnLoad(e.target.checked)}
/>
{t("plugins.enableAiSecurityScan", "Enable AI security scan on load")}
</label>
<div className="plugin-install-actions">
<button className="btn btn-primary" onClick={handleInstall} disabled={installing || !installPath.trim()}>
{installing ? t("plugins.installing", "Installing...") : t("plugins.installPluginGlobally", "Install Plugin Globally")}
</button>
<button className="btn btn-secondary" onClick={() => { setShowInstall(false); setInstallPath(""); }}>
{t("plugins.cancel", "Cancel")}
</button>
</div>
</div>
)}
{loading ? (
<div className="settings-empty-state">{t("plugins.loadingPlugins", "Loading plugins...")}</div>
) : (
<>
{installedPlugins.length === 0 ? (
<div className="settings-empty-state">
<Package size={32} className="text-muted" />
<p>{t("plugins.noPluginsInstalled", "No plugins installed.")}</p>
<p className="text-muted">{t("plugins.noPluginsHint", "Install a plugin to get started, or use the built-in catalog below.")}</p>
</div>
) : (
<div className="plugin-list">
{installedPlugins.map((plugin) => (
<div key={plugin.id} className="plugin-item">
<div className="plugin-info">
<div className="plugin-copy">
<div className="plugin-copy-header">
<span className="plugin-name">{plugin.name}</span>
<span className="plugin-version text-muted">v{plugin.version}</span>
<span className="plugin-state-badge" style={{ color: STATE_COLORS[plugin.state] || STATE_COLORS.installed }}>
{plugin.state}
</span>
</div>
{renderPluginError(plugin)}
</div>
</div>
<div className="plugin-actions">
{plugin.state === "started" && (
<button
className="btn-icon"
onClick={() => handleReload(plugin)}
disabled={reloadingPluginId === plugin.id}
title={t("plugins.reload", "Reload")}
>
<RotateCcw size={14} className={reloadingPluginId === plugin.id ? "spin" : ""} />
</button>
)}
<label className="toggle-switch">
<input
type="checkbox"
checked={plugin.enabled}
onChange={() => plugin.enabled ? handleDisable(plugin) : handleEnable(plugin)}
aria-label={plugin.enabled ? t("plugins.disablePlugin", "Disable {{name}}", { name: plugin.name }) : t("plugins.enablePlugin", "Enable {{name}}", { name: plugin.name })}
/>
<span className="toggle-slider"></span>
</label>
<button
className="btn-icon"
onClick={() => handleSelectPlugin(plugin)}
title={t("plugins.settings", "Settings")}
>
<Settings size={14} />
</button>
<button
className="btn-icon"
onClick={() => handleUninstall(plugin)}
title={t("plugins.uninstallGloballyTitle", "Uninstall globally")}
>
<Trash2 size={14} />
</button>
</div>
</div>
))}
</div>
)}
{renderBuiltinPluginSection()}
</>
)}
</div>
);
}