Skip to content

Self-improving AI Employees for everyone

feat(nodes): Wave 10 — plugin pattern, icons as schema, full backend SSOT

trohitge62073d606a7
diff --git a/CLAUDE.md b/CLAUDE.md
index d6841446..dc2c55d3 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -10,9 +10,9 @@ This is a React Flow-based workflow automation platform implementing n8n-inspire
| Document | Description |
|----------|-------------|
| **[Frontend Architecture](./docs-internal/frontend_architecture.md)** | Current frontend stack (React 19 + Vite + Tailwind v4 + shadcn/ui + Radix + RHF/zod + TanStack Query + Zustand). Tokens, primitives, forms, credentials exemplar, ownership boundary, `uiHints` catalogue. |
-| **[UI Migration Plan](./docs-internal/ui_migration_plan.md)** | antd → shadcn/ui migration plan + completion log. Waves 1–3 done; Phase 6 (ParameterRenderer → widget registry) deferred pending backend `get_node_spec`. |
-| **[Schema Source of Truth RFC](./docs-internal/schema_source_of_truth_rfc.md)** | Wave 3 + Wave 6: backend is SSOT for node output schemas AND input parameter schemas via Pydantic → JSON Schema. 110 NodeSpecs registered. Endpoints: `GET /api/schemas/nodes/{type}.json` (output), `/{type}/spec.json` (full NodeSpec), `/nodes/options/{method}` (loadOptions dispatcher), `/nodes/groups` (node-groups index). Frontend adapter + feature flag `VITE_NODESPEC_BACKEND` ready; Phase 3e flag flip + frontend nodeDefinitions/* deletion deferred pending snapshot tests. |
-| **[Node Creation Guide](./docs-internal/node_creation.md)** | Complete guide for creating new nodes (frontend definitions, backend handlers, config nodes, triggers) |
+| **[UI Migration Plan](./docs-internal/ui_migration_plan.md)** | antd → shadcn/ui migration plan + completion log. Waves 1–10 done. Full frontend is schema-driven (backend SSOT); remaining DIY widget registry (ex-Phase 6) is the one deferred item. |
+| **[Schema Source of Truth RFC](./docs-internal/schema_source_of_truth_rfc.md)** | Backend is SSOT for node schemas, visual metadata, handlers, palette metadata, and icons. Plugin pattern via `@register_node`: one file in `server/nodes/<name>.py` = new node. Wire format: `asset:<key>` (filesystem SVG) / `<lib>:<brand>` (NPM icon package) / URL / emoji. Endpoints: `/api/schemas/nodes/{type}/spec.json`, `/nodes/options/{method}`, `/nodes/groups`. 108 pytest invariants lock the contract. |
+| **[Node Creation Guide](./docs-internal/node_creation.md)** | Canonical Wave 10 plugin recipe — one Python file, zero frontend edits. Covers Pydantic params, handler, visual metadata (icon / color / handles / componentKind), uiHints catalogue, dynamic option loaders, output schemas. |
| **[AI Tool Node Guide](./docs-internal/ai_tool_node_creation.md)** | Detailed guide for creating dedicated AI Agent tool nodes (schemas, handlers, toolkits) |
| **[Specialized Agent Guide](./docs-internal/specialized_agent_node_creation.md)** | Guide for creating specialized AI agents (Android, Coding, Web, Task, Social, Travel, Tool, Productivity, Payments, Consumer) with full AI configuration |
| **[Dual-Purpose Tool Guide](./docs-internal/dual_purpose_tool_node_creation.md)** | Guide for nodes that work as both workflow nodes AND AI Agent tools (e.g., whatsappSend) |
diff --git a/client/src/Dashboard.tsx b/client/src/Dashboard.tsx
index 910876df..8c8ec950 100644
--- a/client/src/Dashboard.tsx
+++ b/client/src/Dashboard.tsx
@@ -15,7 +15,6 @@ import {
import { featureFlags } from './lib/featureFlags';
import { prefetchAllNodeSpecs, getCachedNodeSpec } from './lib/nodeSpec';
import AIAgentNode from './components/AIAgentNode';
-import ModelNode from './components/ModelNode';
import SquareNode from './components/SquareNode';
import TriggerNode from './components/TriggerNode';
import ToolkitNode from './components/ToolkitNode';
@@ -74,7 +73,7 @@ const COMPONENT_BY_KIND: Record<string, React.ComponentType<any>> = {
trigger: TriggerNode,
agent: AIAgentNode,
chat: AIAgentNode,
- model: ModelNode,
+ model: SquareNode,
square: SquareNode,
tool: SquareNode,
generic: SquareNode,
diff --git a/client/src/ParameterPanel.tsx b/client/src/ParameterPanel.tsx
index 29ee6332..3096f756 100644
--- a/client/src/ParameterPanel.tsx
+++ b/client/src/ParameterPanel.tsx
@@ -6,8 +6,8 @@ import { useAppStore } from './store/useAppStore';
import { useWebSocket } from './contexts/WebSocketContext';
import { ExecutionService, ExecutionResult } from './services/executionService';
import { useAppTheme } from './hooks/useAppTheme';
-import { CalendarClock, PlayCircle } from 'lucide-react';
import { ActionButton } from './components/ui/action-button';
+import { resolveIcon, resolveLibraryIcon, isImageIcon } from './assets/icons';
const ParameterPanel: React.FC = () => {
const theme = useAppTheme();
@@ -133,22 +133,19 @@ const ParameterPanel: React.FC = () => {
- // Wave 10.G.5: icon dispatch reads spec.componentKind ("start" is the
- // backend-declared componentKind of the workflow start node) and a
- // small set of icon-key prefixes. No hardcoded node-name checks.
- const renderIcon = (icon: string) => {
- if (icon === 'schedule') {
- return <CalendarClock className="h-5 w-5" style={{ color: theme.colors.actionDeploy }} />;
+ // Wave 10.B: schema-driven icon dispatch. Library-backed React
+ // components (`lobehub:<brand>`) resolve first, then the string
+ // resolver handles `asset:<key>`, URLs, data URIs, and plain
+ // emoji/text.
+ const renderIcon = (icon: string | undefined) => {
+ const LibIcon = resolveLibraryIcon(icon);
+ if (LibIcon) return <LibIcon size={20} />;
+ const resolved = resolveIcon(icon);
+ if (!resolved) return null;
+ if (isImageIcon(resolved)) {
+ return <img src={resolved} alt="icon" style={{ width: 20, height: 20, objectFit: 'contain' }} />;
}
- if (icon === 'play' || (nodeDefinition as any)?.componentKind === 'start') {
- return <PlayCircle className="h-5 w-5" style={{ color: theme.dracula.cyan }} />;
- }
- if (icon.startsWith('data:') || icon.startsWith('http') || icon.startsWith('/')) {
- return (
- <img src={icon} alt="icon" style={{ width: 20, height: 20, objectFit: 'contain' }} />
- );
- }
- return <span>{icon}</span>;
+ return <span>{resolved}</span>;
};
// Header actions with node name and buttons in middle area
diff --git a/client/src/assets/icons/chat/chat.svg b/client/src/assets/icons/chat/chat.svg
new file mode 100644
index 00000000..dde0ad3e
--- /dev/null
+++ b/client/src/assets/icons/chat/chat.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="#4A90D9"><path d="M20 2H4c-1.1 0-2 .9-2 2v18l4-4h14c1.1 0 2-.9 2-2V4c0-1.1-.9-2-2-2zm0 14H6l-2 2V4h16v12z"/></svg>
diff --git a/client/src/assets/icons/index.ts b/client/src/assets/icons/index.ts
new file mode 100644
index 00000000..d8bd431c
--- /dev/null
+++ b/client/src/assets/icons/index.ts
@@ -0,0 +1,127 @@
+/**
+ * Wave 10.B: schema-driven icon resolver — n8n-aligned prefix scheme.
+ *
+ * Backend plugins declare an icon string; the resolver picks the
+ * right source based on the prefix (same `file:` / `fa:` / URL
+ * pattern n8n uses, extended for React icon libraries):
+ *
+ * `asset:<key>` → filesystem SVG (Vite `import.meta.glob`
+ * over `client/src/assets/icons/**\/*.svg`).
+ * Key is the filename minus `.svg`. Dropping
+ * a `<key>.svg` into any subfolder registers
+ * it automatically — no central edit.
+ * `<lib>:<brand>` → React component from an installed NPM icon
+ * library. `<lib>` names the package
+ * (`lobehub` today; add more in
+ * `ICON_LIBRARIES` below). `<brand>` is a
+ * case-insensitive lookup. `.Color` variant
+ * preferred, `.Avatar` fallback.
+ * `data:...` → data-URI passthrough (inline SVG / base64).
+ * `http(s)://...` → remote URL passthrough.
+ * `/...` → absolute local URL passthrough.
+ * plain text → emoji / short label (rendered as-is).
+ *
+ * Consumers call `resolveLibraryIcon` first for React component
+ * icons, then `resolveIcon` for strings / image URIs. No node-type
+ * knowledge anywhere in the frontend.
+ */
+
+import * as React from 'react';
+import * as Lobehub from '@lobehub/icons';
+
+type RawSvg = string;
+
+// Eagerly load every .svg file as its raw string contents so the
+// resolver is synchronous at render time.
+const svgModules = import.meta.glob<RawSvg>('./**/*.svg', {
+ eager: true,
+ query: '?raw',
+ import: 'default',
+});
+
+const svgToDataUri = (svg: string): string => {
+ const encoded = encodeURIComponent(svg).replace(/'/g, '%27').replace(/"/g, '%22');
+ return `data:image/svg+xml,${encoded}`;
+};
+
+const keyFromPath = (path: string): string => {
+ // './google/gmail.svg' -> 'gmail'
+ const filename = path.split('/').pop() ?? '';
+ return filename.replace(/\.svg$/i, '');
+};
+
+const entries = Object.entries(svgModules)
+ .sort(([a], [b]) => a.localeCompare(b)) // deterministic on collisions
+ .map(([path, raw]) => [keyFromPath(path), svgToDataUri(raw as string)] as const);
+
+/** Filesystem-derived asset key -> SVG data URI. */
+export const ICON_REGISTRY: Readonly<Record<string, string>> = Object.fromEntries(entries);
+
+/**
+ * Resolve a backend-declared icon string to something renderable.
+ * Contract:
+ * `asset:<key>` → look up in ICON_REGISTRY (filesystem-derived)
+ * `data:...` → pass through
+ * otherwise → render as-is (emoji / short text / URL)
+ * Returns `null` when the icon string is empty or an unknown asset key,
+ * so callers can apply their own fallback.
+ */
+export const resolveIcon = (icon: string | undefined | null): string | null => {
+ if (!icon) return null;
+ if (icon.startsWith('asset:')) {
+ // Unknown asset key — backend declared a file that doesn't exist in
+ // client/src/assets/icons/. Return null so the gap is visible to
+ // the author rather than masked by a fallback emoji.
+ return ICON_REGISTRY[icon.slice('asset:'.length)] ?? null;
+ }
+ if (icon.startsWith('data:') || icon.startsWith('http://') || icon.startsWith('https://') || icon.startsWith('/')) {
+ return icon;
+ }
+ // Library-prefixed strings are handled by `resolveLibraryIcon`; if
+ // they reach here it means the caller only consulted `resolveIcon`
+ // and should also try the library resolver — treat as unresolvable.
+ if (icon.includes(':')) return null;
+ return icon; // plain emoji / short text — callers render as <span>
+};
+
+/** True when the resolved icon is an image URI (data: or http: or /path). */
+export const isImageIcon = (resolved: string): boolean =>
+ resolved.startsWith('data:') || resolved.startsWith('http') || resolved.startsWith('/');
+
+/**
+ * Library-icon resolver. Dispatches `<lib>:<brand>` strings to the
+ * matching NPM icon package. Adding a new library is one entry in
+ * `ICON_LIBRARIES` — no per-brand hardcoding, names come from the
+ * package's own exports.
+ */
+export type LibraryIcon = React.FC<{ size?: number }>;
+
+type LibraryResolver = (brand: string) => LibraryIcon | null;
+
+// Build a case-insensitive name index once per library so `lobehub:claude`
+// and `lobehub:Claude` both hit the same `Claude` export.
+const indexLibrary = (lib: Record<string, unknown>): Record<string, string> =>
+ Object.fromEntries(Object.keys(lib).map((name) => [name.toLowerCase(), name]));
+
+const lobehubIndex = indexLibrary(Lobehub as Record<string, unknown>);
+
+const ICON_LIBRARIES: Readonly<Record<string, LibraryResolver>> = {
+ lobehub: (brand) => {
+ const exportName = lobehubIndex[brand.toLowerCase()];
+ if (!exportName) return null;
+ const entry = (Lobehub as Record<string, any>)[exportName];
+ return entry?.Color ?? entry?.Avatar ?? null;
+ },
+ // Add `simpleicons` / other NPM icon packages here as needed:
+ // simpleicons: (brand) => import('simple-icons').si[brand]?.svg ...
+};
+
+export const resolveLibraryIcon = (icon: string | undefined | null): LibraryIcon | null => {
+ if (!icon) return null;
+ const sep = icon.indexOf(':');
+ if (sep <= 0) return null;
+ const lib = icon.slice(0, sep);
+ const resolver = ICON_LIBRARIES[lib];
+ return resolver ? resolver(icon.slice(sep + 1)) : null;
+};
+
diff --git a/client/src/assets/icons/social/social.svg b/client/src/assets/icons/social/social.svg
new file mode 100644
index 00000000..b70fdefc
--- /dev/null
+++ b/client/src/assets/icons/social/social.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="#6366F1"><path d="M4.25 5.61C6.27 8.2 10 13 10 13v6c0 .55.45 1 1 1h2c.55 0 1-.45 1-1v-6s3.73-4.8 5.75-7.39C20.26 4.95 19.79 4 18.95 4H5.04c-.83 0-1.31.95-.79 1.61z"/></svg>
diff --git a/client/src/assets/icons/twitter/x.svg b/client/src/assets/icons/twitter/x.svg
new file mode 100644
index 00000000..f5c2a528
--- /dev/null
+++ b/client/src/assets/icons/twitter/x.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor"><path d="M18.244 2.25h3.308l-7.227 8.26 8.502 11.24H16.17l-5.214-6.817L4.99 21.75H1.68l7.73-8.835L1.254 2.25H8.08l4.713 6.231zm-1.161 17.52h1.833L7.084 4.126H5.117z"/></svg>
diff --git a/client/src/assets/icons/whatsapp/whatsapp-db.svg b/client/src/assets/icons/whatsapp/whatsapp-db.svg
new file mode 100644
index 00000000..c6c08b9b
--- /dev/null
+++ b/client/src/assets/icons/whatsapp/whatsapp-db.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="#25D366"><path d="M12 3C7.58 3 4 4.79 4 7v10c0 2.21 3.58 4 8 4s8-1.79 8-4V7c0-2.21-3.58-4-8-4zm0 2c3.87 0 6 1.5 6 2s-2.13 2-6 2-6-1.5-6-2 2.13-2 6-2zm6 12c0 .5-2.13 2-6 2s-6-1.5-6-2v-2.23c1.61.78 3.72 1.23 6 1.23s4.39-.45 6-1.23V17zm0-4c0 .5-2.13 2-6 2s-6-1.5-6-2v-2.23c1.61.78 3.72 1.23 6 1.23s4.39-.45 6-1.23V13zm0-4c0 .5-2.13 2-6 2s-6-1.5-6-2V6.77C7.61 7.55 9.72 8 12 8s4.39-.45 6-1.23V9z"/></svg>
diff --git a/client/src/assets/icons/whatsapp/whatsapp-receive.svg b/client/src/assets/icons/whatsapp/whatsapp-receive.svg
new file mode 100644
index 00000000..d35b0cdd
--- /dev/null
+++ b/client/src/assets/icons/whatsapp/whatsapp-receive.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="#25D366"><path d="M12 22c1.1 0 2-.9 2-2h-4c0 1.1.9 2 2 2zm6-6v-5c0-3.07-1.63-5.64-4.5-6.32V4c0-.83-.67-1.5-1.5-1.5s-1.5.67-1.5 1.5v.68C7.64 5.36 6 7.92 6 11v5l-2 2v1h16v-1l-2-2zm-2 1H8v-6c0-2.48 1.51-4.5 4-4.5s4 2.02 4 4.5v6z"/><circle cx="18" cy="6" r="4"/></svg>
diff --git a/client/src/assets/icons/whatsapp/whatsapp-send.svg b/client/src/assets/icons/whatsapp/whatsapp-send.svg
new file mode 100644
index 00000000..42f8b042
--- /dev/null
+++ b/client/src/assets/icons/whatsapp/whatsapp-send.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="#25D366"><path d="M2.01 21L23 12 2.01 3 2 10l15 2-15 2z"/></svg>
diff --git a/client/src/assets/icons/whatsapp/whatsapp.svg b/client/src/assets/icons/whatsapp/whatsapp.svg
new file mode 100644
index 00000000..c2df5a87
--- /dev/null
+++ b/client/src/assets/icons/whatsapp/whatsapp.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="#25D366"><path d="M17.472 14.382c-.297-.149-1.758-.867-2.03-.967-.273-.099-.471-.148-.67.15-.197.297-.767.966-.94 1.164-.173.199-.347.223-.644.075-.297-.15-1.255-.463-2.39-1.475-.883-.788-1.48-1.761-1.653-2.059-.173-.297-.018-.458.13-.606.134-.133.298-.347.446-.52.149-.174.198-.298.298-.497.099-.198.05-.371-.025-.52-.075-.149-.669-1.612-.916-2.207-.242-.579-.487-.5-.669-.51-.173-.008-.371-.01-.57-.01-.198 0-.52.074-.792.372-.272.297-1.04 1.016-1.04 2.479 0 1.462 1.065 2.875 1.213 3.074.149.198 2.096 3.2 5.077 4.487.709.306 1.262.489 1.694.625.712.227 1.36.195 1.871.118.571-.085 1.758-.719 2.006-1.413.248-.694.248-1.289.173-1.413-.074-.124-.272-.198-.57-.347m-5.421 7.403h-.004a9.87 9.87 0 01-5.031-1.378l-.361-.214-3.741.982.998-3.648-.235-.374a9.86 9.86 0 01-1.51-5.26c.001-5.45 4.436-9.884 9.888-9.884 2.64 0 5.122 1.03 6.988 2.898a9.825 9.825 0 012.893 6.994c-.003 5.45-4.437 9.884-9.885 9.884m8.413-18.297A11.815 11.815 0 0012.05 0C5.495 0 .16 5.335.157 11.892c0 2.096.547 4.142 1.588 5.945L.057 24l6.305-1.654a11.882 11.882 0 005.683 1.448h.005c6.554 0 11.89-5.335 11.893-11.893a11.821 11.821 0 00-3.48-8.413z"/></svg>
diff --git a/client/src/components/AIAgentNode.tsx b/client/src/components/AIAgentNode.tsx
index 82d1385e..68155fbe 100644
--- a/client/src/components/AIAgentNode.tsx
+++ b/client/src/components/AIAgentNode.tsx
@@ -6,8 +6,8 @@ import AIAgentExecutionService from '../services/execution/aiAgentExecutionServi
import { useAppTheme } from '../hooks/useAppTheme';
import { useNodeStatus } from '../contexts/WebSocketContext';
import { dracula } from '../styles/theme';
-import { ClaudeIcon } from './icons/AIProviderIcons';
-import { getCachedNodeSpec } from '../lib/nodeSpec';
+import { useNodeSpec } from '../lib/nodeSpec';
+import { resolveIcon, resolveLibraryIcon } from '../assets/icons';
// LangGraph phase icons and labels. Colors reference the dracula token
// constants so a future palette change in tokens.css propagates without
@@ -34,17 +34,19 @@ interface SpecHandle {
role?: string;
}
-// Minimal icon resolver. Wave 10.B will replace this with a shared
-// IconResolver + ICON_REGISTRY. For now the only React-component icon
-// is Claude Code; everything else is a plain emoji/string.
+// Wave 10.B: schema-driven icon dispatch via the shared resolver.
+// No frontend fallback — if resolution returns null the node's plugin
+// metadata is missing an icon, which surfaces as a visible gap rather
+// than a masking emoji.
const renderIcon = (icon?: string): React.ReactNode => {
- if (!icon) return <span style={{ fontSize: '28px' }}>🤖</span>;
- if (icon === 'asset:claude') return <ClaudeIcon size={28} />;
- if (icon.startsWith('asset:') || icon.startsWith('data:')) {
- // Asset keys other than 'claude' not yet registered; fall back.
- return <span style={{ fontSize: '28px' }}>🔧</span>;
+ const LibIcon = resolveLibraryIcon(icon);
+ if (LibIcon) return <LibIcon size={28} />;
+ const resolved = resolveIcon(icon);
+ if (!resolved) return null;
+ if (resolved.startsWith('http') || resolved.startsWith('data:') || resolved.startsWith('/')) {
+ return <img src={resolved} alt="icon" style={{ width: 28, height: 28, objectFit: 'contain' }} />;
}
- return <span style={{ fontSize: '28px' }}>{icon}</span>;
+ return <span style={{ fontSize: '28px' }}>{resolved}</span>;
};
const REACT_POSITION: Record<SpecHandle['position'], Position> = {
@@ -64,7 +66,7 @@ const AIAgentNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnecta
// NodeSpec envelope (server/nodes/agents.py → register_node()). The
// component only knows how to render whatever topology the spec
// declares.
- const spec = getCachedNodeSpec(type || 'aiAgent');
+ const spec = useNodeSpec(type || 'aiAgent');
const handles: SpecHandle[] = (spec?.handles as SpecHandle[] | undefined) ?? [];
const accentColor = spec?.color || dracula.purple;
const width = (spec?.uiHints as any)?.width ?? 300;
diff --git a/client/src/components/GenericNode.tsx b/client/src/components/GenericNode.tsx
index 2cb2b526..bb0bc87e 100644
--- a/client/src/components/GenericNode.tsx
+++ b/client/src/components/GenericNode.tsx
@@ -2,6 +2,8 @@ import React, { useState, useEffect, useRef, useCallback } from 'react';
import { Handle, Position, NodeProps } from 'reactflow';
import { nodeDefinitions } from '../nodeDefinitions';
import { resolveNodeDescription } from '../lib/nodeSpec';
+import { resolveIcon, resolveLibraryIcon } from '../assets/icons';
+import { useNodeSpec } from '../lib/nodeSpec';
import { NodeData } from '../types/NodeTypes';
import { INodeInputDefinition, INodeOutputDefinition, NodeConnectionType } from '../types/INodeProperties';
import { useAppStore } from '../store/useAppStore';
@@ -21,6 +23,9 @@ const GenericNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnecta
// Wave 6 Phase 3e: backend NodeSpec -> legacy fallback
const definition = type ? resolveNodeDescription(type, nodeDefinitions[type] ?? null) : null;
+ // Wave 10.B: reactive spec subscription keeps the icon fresh the
+ // moment the prefetch lands (no waiting for parent re-render).
+ const iconSpec = useNodeSpec(type);
// Inline rename state
const [isRenaming, setIsRenaming] = useState(false);
@@ -130,39 +135,22 @@ const GenericNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnecta
const nodeInputs = getNodeInputs();
const nodeOutputs = getNodeOutputs();
- // Check if string is likely an emoji (contains emoji characters)
- const isEmoji = (str: string): boolean => {
- const emojiRegex = /[\u{1F300}-\u{1F9FF}]|[\u{2600}-\u{26FF}]|[\u{2700}-\u{27BF}]|[\u{1F600}-\u{1F64F}]|[\u{1F680}-\u{1F6FF}]|[\u{1F1E0}-\u{1F1FF}]|[\u{2300}-\u{23FF}]|[\u{2B50}]|[\u{231A}-\u{231B}]|[\u{25AA}-\u{25AB}]|[\u{25B6}]|[\u{25C0}]|[\u{25FB}-\u{25FE}]|[\u{2614}-\u{2615}]|[\u{2648}-\u{2653}]|[\u{267F}]|[\u{2693}]|[\u{26A1}]|[\u{26AA}-\u{26AB}]|[\u{26BD}-\u{26BE}]|[\u{26C4}-\u{26C5}]|[\u{26CE}]|[\u{26D4}]|[\u{26EA}]|[\u{26F2}-\u{26F3}]|[\u{26F5}]|[\u{26FA}]|[\u{26FD}]|[\u{2702}]|[\u{2705}]|[\u{2708}-\u{270D}]|[\u{270F}]|[\u{2712}]|[\u{2714}]|[\u{2716}]|[\u{271D}]|[\u{2721}]|[\u{2728}]|[\u{2733}-\u{2734}]|[\u{2744}]|[\u{2747}]|[\u{274C}]|[\u{274E}]|[\u{2753}-\u{2755}]|[\u{2757}]|[\u{2763}-\u{2764}]|[\u{2795}-\u{2797}]|[\u{27A1}]|[\u{27B0}]|[\u{27BF}]|[\u{E000}-\u{F8FF}]/u;
- return emojiRegex.test(str);
- };
-
- // Helper to render icon (handles URLs, SVG data URIs, emojis)
- const renderIcon = (icon: string | undefined) => {
- if (!icon) return '📦';
-
- // Handle image URLs and data URIs (including SVG)
+ // Wave 10.B: schema-driven icon dispatch. No fallback.
+ const renderIcon = (rawIcon: string | undefined) => {
+ const LibIcon = resolveLibraryIcon(rawIcon);
+ if (LibIcon) return <LibIcon size={24} />;
+ const icon = resolveIcon(rawIcon);
+ if (!icon) return null;
if (icon.startsWith('http') || icon.startsWith('data:') || icon.startsWith('/')) {
return (
<img
src={icon}
alt="icon"
- style={{
- width: '24px',
- height: '24px',
- objectFit: 'contain',
- borderRadius: '4px'
- }}
+ style={{ width: '24px', height: '24px', objectFit: 'contain', borderRadius: '4px' }}
/>
);
}
-
- // If it's already an emoji, return it directly
- if (isEmoji(icon)) {
- return icon;
- }
-
- // Fallback for unknown formats
- return icon || '📦';
+ return icon;
};
// Helper functions for color management
@@ -283,7 +271,7 @@ const GenericNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnecta
paddingRight: '4px'
}}>
<span className="flex items-center text-2xl">
- {renderIcon(definition.icon)}
+ {renderIcon(iconSpec?.icon ?? definition.icon)}
</span>
{isRenaming ? (
<input
diff --git a/client/src/components/SquareNode.tsx b/client/src/components/SquareNode.tsx
index bfca1240..9dc3aea9 100644
--- a/client/src/components/SquareNode.tsx
+++ b/client/src/components/SquareNode.tsx
@@ -7,9 +7,8 @@ import { nodeDefinitions } from '../nodeDefinitions';
import { useAppTheme } from '../hooks/useAppTheme';
import { useWebSocket, useWhatsAppStatus } from '../contexts/WebSocketContext';
import { useApiKeys } from '../hooks/useApiKeys';
-import { getCachedNodeSpec, isNodeInBackendGroup, resolveNodeDescription } from '../lib/nodeSpec';
-import { getAIProviderIcon } from './icons/AIProviderIcons';
-import { PlayCircle, CalendarClock } from 'lucide-react';
+import { getCachedNodeSpec, isNodeInBackendGroup, resolveNodeDescription, useNodeSpec } from '../lib/nodeSpec';
+import { resolveIcon, resolveLibraryIcon } from '../assets/icons';
import { AI_MODEL_PROVIDER_MAP } from '../nodeDefinitions/aiModelNodes';
// Nodes with 'tool' in their group can connect to AI Agent/Zeenie tool handles
@@ -268,234 +267,27 @@ const SquareNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnectab
}
};
- // Common icon name to emoji mapping for fallback
- const iconNameToEmoji: Record<string, string> = {
- brain: '🧠',
- memory: '🧠',
- robot: '🤖',
- ai: '🤖',
- agent: '🤖',
- chat: '💬',
- message: '💬',
- whatsapp: '📱',
- phone: '📱',
- email: '📧',
- mail: '📧',
- webhook: '🔗',
- http: '🌐',
- api: '🔌',
- database: '🗄️',
- file: '📄',
- folder: '📁',
- code: '💻',
- python: '🐍',
- javascript: '📜',
- settings: '⚙️',
- config: '⚙️',
- clock: '⏰',
- schedule: '📅',
- location: '📍',
- map: '🗺️',
- search: '🔍',
- filter: '🔍',
- play: '▶️',
- start: '▶️',
- stop: '⏹️',
- pause: '⏸️',
- send: '📤',
- receive: '📥',
- upload: '⬆️',
- download: '⬇️',
- sync: '🔄',
- refresh: '🔄',
- warning: '⚠️',
- error: '❌',
- success: '✅',
- info: '💡',
- help: '❓',
- user: '👤',
- users: '👥',
- key: '🔑',
- lock: '🔒',
- unlock: '🔓',
- star: '⭐',
- heart: '❤️',
- thunder: '⚡',
- lightning: '⚡',
- fire: '🔥',
- water: '💧',
- cloud: '☁️',
- sun: '☀️',
- moon: '🌙',
- camera: '📷',
- image: '🖼️',
- video: '🎬',
- audio: '🔊',
- music: '🎵',
- bell: '🔔',
- notification: '🔔',
- link: '🔗',
- chain: '🔗',
- tool: '🔧',
- wrench: '🔧',
- hammer: '🔨',
- gear: '⚙️',
- cog: '⚙️',
- bug: '🐛',
- debug: '🐛',
- test: '🧪',
- experiment: '🧪',
- lab: '🧪',
- book: '📖',
- docs: '📚',
- note: '📝',
- edit: '✏️',
- pencil: '✏️',
- trash: '🗑️',
- delete: '🗑️',
- copy: '📋',
- paste: '📋',
- cut: '✂️',
- scissors: '✂️',
- tag: '🏷️',
- label: '🏷️',
- flag: '🚩',
- bookmark: '🔖',
- pin: '📌',
- target: '🎯',
- goal: '🎯',
- trophy: '🏆',
- medal: '🏅',
- gift: '🎁',
- package: '📦',
- box: '📦',
- truck: '🚚',
- shipping: '🚚',
- cart: '🛒',
- shop: '🛍️',
- store: '🏪',
- money: '💰',
- dollar: '💵',
- credit: '💳',
- payment: '💳',
- chart: '📊',
- graph: '📈',
- analytics: '📊',
- stats: '📊',
- dashboard: '📊',
- terminal: '💻',
- console: '💻',
- server: '🖥️',
- computer: '💻',
- mobile: '📱',
- tablet: '📱',
- battery: '🔋',
- wifi: '📶',
- bluetooth: '📶',
- antenna: '📡',
- satellite: '🛰️',
- rocket: '🚀',
- plane: '✈️',
- car: '🚗',
- bike: '🚲',
- train: '🚂',
- ship: '🚢',
- home: '🏠',
- house: '🏠',
- building: '🏢',
- office: '🏢',
- factory: '🏭',
- hospital: '🏥',
- school: '🏫',
- university: '🎓',
- graduation: '🎓',
- world: '🌍',
- globe: '🌐',
- earth: '🌍',
- android: '🤖',
- apple: '🍎',
- windows: '🪟',
- linux: '🐧',
- };
-
- // Check if string is likely an emoji (contains emoji characters)
- const isEmoji = (str: string): boolean => {
- // Emoji regex pattern - matches most common emojis
- const emojiRegex = /[\u{1F300}-\u{1F9FF}]|[\u{2600}-\u{26FF}]|[\u{2700}-\u{27BF}]|[\u{1F600}-\u{1F64F}]|[\u{1F680}-\u{1F6FF}]|[\u{1F1E0}-\u{1F1FF}]|[\u{2300}-\u{23FF}]|[\u{2B50}]|[\u{231A}-\u{231B}]|[\u{25AA}-\u{25AB}]|[\u{25B6}]|[\u{25C0}]|[\u{25FB}-\u{25FE}]|[\u{2614}-\u{2615}]|[\u{2648}-\u{2653}]|[\u{267F}]|[\u{2693}]|[\u{26A1}]|[\u{26AA}-\u{26AB}]|[\u{26BD}-\u{26BE}]|[\u{26C4}-\u{26C5}]|[\u{26CE}]|[\u{26D4}]|[\u{26EA}]|[\u{26F2}-\u{26F3}]|[\u{26F5}]|[\u{26FA}]|[\u{26FD}]|[\u{2702}]|[\u{2705}]|[\u{2708}-\u{270D}]|[\u{270F}]|[\u{2712}]|[\u{2714}]|[\u{2716}]|[\u{271D}]|[\u{2721}]|[\u{2728}]|[\u{2733}-\u{2734}]|[\u{2744}]|[\u{2747}]|[\u{274C}]|[\u{274E}]|[\u{2753}-\u{2755}]|[\u{2757}]|[\u{2763}-\u{2764}]|[\u{2795}-\u{2797}]|[\u{27A1}]|[\u{27B0}]|[\u{27BF}]|[\u{E000}-\u{F8FF}]/u;
- return emojiRegex.test(str);
- };
- // Helper to render icon (handles URLs, emojis, and icon names)
- const renderIcon = (icon: string) => {
- // Handle image URLs and data URIs (including SVG data URIs for Google icons)
+ // Wave 10.B: schema-driven icon dispatch. `useNodeSpec` subscribes
+ // to the NodeSpec cache so the icon populates when prefetch lands
+ // without waiting for a parent re-render.
+ const iconSpec = useNodeSpec(type);
+ const getServiceIcon = () => {
+ const raw = (iconSpec?.icon as string | undefined) ?? (definition?.icon as string | undefined) ?? '';
+ const LibIcon = resolveLibraryIcon(raw);
+ if (LibIcon) return <LibIcon size={28} />;
+ const icon = resolveIcon(raw);
+ if (!icon) return null;
if (icon.startsWith('http') || icon.startsWith('data:') || icon.startsWith('/')) {
return (
<img
src={icon}
alt="icon"
- style={{
- width: '28px',
- height: '28px',
- objectFit: 'contain',
- borderRadius: '4px'
- }}
+ style={{ width: '28px', height: '28px', objectFit: 'contain', borderRadius: '4px' }}
/>
);
}
-
- // If it's already an emoji, return it directly
- if (isEmoji(icon)) {
- return icon;
- }
-
- // Check if it's a known icon name and convert to emoji
- const lowerIcon = icon.toLowerCase().trim();
- if (iconNameToEmoji[lowerIcon]) {
- return iconNameToEmoji[lowerIcon];
- }
-
- // Fallback: return a generic icon instead of plain text
- console.warn(`[SquareNode] Unknown icon name "${icon}" - using fallback. Add emoji directly or update iconNameToEmoji mapping.`);
- return '📦';
- };
-
- // Get service icon for display
- const getServiceIcon = () => {
- // Priority 0: Start node - use PlayCircle icon with cyan color (neutral "begin" color)
- if (type === 'start') {
- return <PlayCircle className="h-7 w-7" style={{ color: theme.dracula.cyan }} />;
- }
-
- // Cron Scheduler node - use CalendarClock with node definition color
- if (type === 'cronScheduler') {
- return <CalendarClock className="h-7 w-7" style={{ color: definition?.defaults?.color || nodeColor }} />;
- }
-
- // Priority 1: Check if this is an AI model node - use official provider icons
- if (type && AI_MODEL_NODE_TYPES[type]) {
- const providerId = AI_MODEL_NODE_TYPES[type];
- const IconComponent = getAIProviderIcon(providerId);
- if (IconComponent) {
- return <IconComponent size={28} />;
- }
- }
-
- // Priority 2: Custom icon set on the node instance (via data.customIcon)
- if (data?.customIcon && typeof data.customIcon === 'string') {
- return renderIcon(data.customIcon);
- }
-
- // Priority 3: Use the icon from the node definition if available
- if (definition?.icon && typeof definition.icon === 'string') {
- return renderIcon(definition.icon);
- }
-
- // Fallback logic based on node type
- if (type?.includes('gmaps_create')) return '🗺️';
- if (type?.includes('gmaps_locations')) return '🌍';
- if (type?.includes('gmaps_nearby_places')) return '🔍';
-
- return '📍';
+ return icon;
};
// Get the node color from definition or use default
diff --git a/client/src/components/ToolkitNode.tsx b/client/src/components/ToolkitNode.tsx
index 519cb431..8caa6ebc 100644
--- a/client/src/components/ToolkitNode.tsx
+++ b/client/src/components/ToolkitNode.tsx
@@ -16,6 +16,8 @@ import { NodeData } from '../types/NodeTypes';
import { useAppStore } from '../store/useAppStore';
import { nodeDefinitions } from '../nodeDefinitions';
import { resolveNodeDescription } from '../lib/nodeSpec';
+import { resolveIcon, resolveLibraryIcon } from '../assets/icons';
+import { useNodeSpec } from '../lib/nodeSpec';
import { useAppTheme } from '../hooks/useAppTheme';
import { useWebSocket } from '../contexts/WebSocketContext';
@@ -96,47 +98,26 @@ const ToolkitNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnecta
// Get the node color from definition or use Android green
const nodeColor = definition?.defaults?.color || '#3DDC84';
- // Helper to check if string is emoji
- const isEmoji = (str: string): boolean => {
- const emojiRegex = /^(?:\p{Emoji_Presentation}|\p{Emoji}\uFE0F)(?:\u200D(?:\p{Emoji_Presentation}|\p{Emoji}\uFE0F))*$/u;
- return emojiRegex.test(str);
- };
-
- // Helper to render icon (handles URLs, emojis, and icon names)
- const renderIcon = (icon: string) => {
- // Handle image URLs and data URIs
+ // Wave 10.B: schema-driven icon dispatch with reactive subscription.
+ const iconSpec = useNodeSpec(type);
+ const getIcon = () => {
+ const raw = (iconSpec?.icon as string | undefined) ?? (definition?.icon as string | undefined);
+ const LibIcon = resolveLibraryIcon(raw);
+ if (LibIcon) return <LibIcon size={28} />;
+ const icon = resolveIcon(raw);
+ if (!icon) return null;
if (icon.startsWith('http') || icon.startsWith('data:') || icon.startsWith('/')) {
return (
<img
src={icon}
alt="icon"
- style={{
- width: '28px',
- height: '28px',
- objectFit: 'contain',
- borderRadius: '4px'
- }}
+ style={{ width: '28px', height: '28px', objectFit: 'contain', borderRadius: '4px' }}
/>
);
}
-
- // If it's already an emoji, return it directly
- if (isEmoji(icon)) {
- return icon;
- }
-
- // Fallback
return icon;
};
- // Get icon from definition
- const getIcon = () => {
- if (definition?.icon) {
- return renderIcon(definition.icon);
- }
- return '📱'; // Default Android icon
- };
-
// Get status indicator color
const getStatusIndicatorColor = () => {
if (isExecuting) return theme.dracula.cyan;
diff --git a/client/src/components/TriggerNode.tsx b/client/src/components/TriggerNode.tsx
index f6f80ef6..0e09590b 100644
--- a/client/src/components/TriggerNode.tsx
+++ b/client/src/components/TriggerNode.tsx
@@ -11,11 +11,10 @@ import { Handle, Position, NodeProps } from 'reactflow';
import { NodeData } from '../types/NodeTypes';
import { useAppStore } from '../store/useAppStore';
import { nodeDefinitions } from '../nodeDefinitions';
-import { resolveNodeDescription } from '../lib/nodeSpec';
+import { resolveNodeDescription, useNodeSpec } from '../lib/nodeSpec';
+import { resolveIcon, resolveLibraryIcon } from '../assets/icons';
import { useAppTheme } from '../hooks/useAppTheme';
import { useWebSocket, useWhatsAppStatus } from '../contexts/WebSocketContext';
-import { PlayCircle, CalendarClock } from 'lucide-react';
-import { Google } from '@lobehub/icons';
const TriggerNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnectable, selected }) => {
const theme = useAppTheme();
@@ -145,66 +144,25 @@ const TriggerNode: React.FC<NodeProps<NodeData>> = ({ id, type, data, isConnecta
}
};
- // Check if string is likely an emoji
- const isEmoji = (str: string): boolean => {
- const emojiRegex = /[\u{1F300}-\u{1F9FF}]|[\u{2600}-\u{26FF}]|[\u{2700}-\u{27BF}]|[\u{1F600}-\u{1F64F}]|[\u{1F680}-\u{1F6FF}]|[\u{1F1E0}-\u{1F1FF}]|[\u{2300}-\u{23FF}]|[\u{2B50}]|[\u{231A}-\u{231B}]|[\u{25AA}-\u{25AB}]|[\u{25B6}]|[\u{25C0}]|[\u{25FB}-\u{25FE}]|[\u{2614}-\u{2615}]|[\u{2648}-\u{2653}]|[\u{267F}]|[\u{2693}]|[\u{26A1}]|[\u{26AA}-\u{26AB}]|[\u{26BD}-\u{26BE}]|[\u{26C4}-\u{26C5}]|[\u{26CE}]|[\u{26D4}]|[\u{26EA}]|[\u{26F2}-\u{26F3}]|[\u{26F5}]|[\u{26FA}]|[\u{26FD}]|[\u{2702}]|[\u{2705}]|[\u{2708}-\u{270D}]|[\u{270F}]|[\u{2712}]|[\u{2714}]|[\u{2716}]|[\u{271D}]|[\u{2721}]|[\u{2728}]|[\u{2733}-\u{2734}]|[\u{2744}]|[\u{2747}]|[\u{274C}]|[\u{274E}]|[\u{2753}-\u{2755}]|[\u{2757}]|[\u{2763}-\u{2764}]|[\u{2795}-\u{2797}]|[\u{27A1}]|[\u{27B0}]|[\u{27BF}]|[\u{E000}-\u{F8FF}]/u;
- return emojiRegex.test(str);
- };
-
- // Helper to render icon
- const renderIcon = (icon: string) => {
- // Handle component markers (e.g., 'component:Gmail')
- if (icon.startsWith('component:')) {
- const componentName = icon.replace('component:', '');
- if (componentName === 'Gmail') {
- return <Google.Color size={28} />;
- }
- // Fallback for unknown component markers
- return '⚡';
- }
-
+ // Wave 10.B: schema-driven icon dispatch. `useNodeSpec` subscribes
+ // to the NodeSpec cache so the icon populates when prefetch lands.
+ const iconSpec = useNodeSpec(type);
+ const getTriggerIcon = () => {
+ const raw = (iconSpec?.icon as string | undefined) ?? (definition?.icon as string | undefined) ?? '';
+ const LibIcon = resolveLibraryIcon(raw);
+ if (LibIcon) return <LibIcon size={28} />;
+ const icon = resolveIcon(raw);
+ if (!icon) return null;
if (icon.startsWith('http') || icon.startsWith('data:') || icon.startsWith('/')) {
return (
<img
src={icon}
alt="icon"
- style={{
- width: '28px',
- height: '28px',
- objectFit: 'contain',
- borderRadius: '4px'
- }}
+ style={{ width: '28px', height: '28px', objectFit: 'contain', borderRadius: '4px' }}
/>
);
}
-
- if (isEmoji(icon)) {
- return icon;
- }
-
- // Fallback
- return '⚡';
- };
-
- // Get trigger icon for display
- const getTriggerIcon = () => {
- // Start node - use PlayCircle icon
- if (type === 'start') {
- return <PlayCircle className="h-7 w-7" style={{ color: theme.dracula.cyan }} />;
- }
-
- // Cron Scheduler - use CalendarClock
- if (type === 'cronScheduler') {
- return <CalendarClock className="h-7 w-7" style={{ color: definition?.defaults?.color || nodeColor }} />;
- }
-
- // Use the icon from the node definition if available
- if (definition?.icon && typeof definition.icon === 'string') {
- return renderIcon(definition.icon);
- }
-
- // Fallback to lightning bolt for triggers
- return '⚡';
+ return icon;
};
// Get the node color from definition or use default trigger color
diff --git a/client/src/components/credentials/catalogueAdapter.ts b/client/src/components/credentials/catalogueAdapter.ts
index 5d92f9f6..cfdfac63 100644
--- a/client/src/components/credentials/catalogueAdapter.ts
+++ b/client/src/components/credentials/catalogueAdapter.ts
@@ -19,14 +19,7 @@
import React from 'react';
-import { AI_PROVIDER_META } from '../icons/AIProviderIcons';
-import { APIFY_ICON } from '../../assets/icons/apify';
-import { BRAVE_SEARCH_ICON, SERPER_ICON, PERPLEXITY_ICON } from '../../assets/icons/search';
-import { TELEGRAM_ICON } from '../../assets/icons/telegram';
-import { GMAIL_ICON } from '../../assets/icons/google';
-import { EMAIL_READ_ICON } from '../../assets/icons/email';
-import { WHATSAPP_CONNECT_ICON } from '../../nodeDefinitions/whatsappNodes';
-import { TWITTER_ICON } from '../../nodeDefinitions/twitterNodes';
+import { resolveIcon, resolveLibraryIcon, isImageIcon } from '../../assets/icons';
import type {
ProviderConfig,
@@ -48,63 +41,18 @@ import type {
} from '../../hooks/useCatalogueQuery';
// ============================================================================
-// Icon factories — uses <img> with data URIs (the project standard from
-// assets/icons/*/index.ts). No innerHTML, no dangerouslySetInnerHTML,
-// no ref+useEffect. Every icon module already exports svgToDataUri'd
-// constants; we import those directly and render as <img>.
+// Wave 10.B: icon resolution now routes through the shared resolvers in
+// `assets/icons/`. Backend `icon_ref` uses the same three-format contract
+// as node icons:
+// "lobehub:<brand>" → React component (provider brand icon)
+// "asset:<key>" → <img> with filesystem-registered SVG data URI
+// emoji / plain text → <span>
// ============================================================================
interface IconProps {
size: number;
}
-/** Render a data:image/svg+xml URI as a sized <img>. Project standard. */
-const fromDataUri = (dataUri: string): React.FC<IconProps> => {
- const Comp: React.FC<IconProps> = ({ size }) =>
- React.createElement('img', {
- src: dataUri,
- width: size,
- height: size,
- alt: '',
- style: { display: 'block' },
- });
- return Comp;
-};
-
-const fromEmoji = (emoji: string): React.FC<IconProps> => {
- const Comp: React.FC<IconProps> = ({ size }) =>
- React.createElement(
- 'span',
- { style: { fontSize: size, lineHeight: 1, display: 'inline-block' } },
- emoji,
- );
- return Comp;
-};
-
-// ============================================================================
-// Icon ref resolver
-//
-// JSON `icon_ref` values use a small DSL:
-// "ai:openai" → AI_PROVIDER_META[openai].Icon (@lobehub/icons)
-// "raw_svg:SearchIcons.brave" → <img> with pre-exported data URI (BRAVE_SEARCH_ICON)
-// "data_uri:WHATSAPP_CONNECT_ICON" → <img> with data URI
-// "emoji:📱" → <span> with emoji text
-// ============================================================================
-
-/** Map "Module.key" strings to already-converted data URIs from assets/icons/. */
-const RAW_SVG_DATA_URIS: Record<string, Record<string, string>> = {
- SearchIcons: { brave: BRAVE_SEARCH_ICON, serper: SERPER_ICON, perplexity: PERPLEXITY_ICON },
- TelegramIcons: { telegram: TELEGRAM_ICON },
- GoogleIcons: { gmail: GMAIL_ICON },
- EmailIcons: { read: EMAIL_READ_ICON },
- ApifyIcons: { apify: APIFY_ICON },
-};
-
-const DATA_URI_REGISTRY: Record<string, string> = {
- WHATSAPP_CONNECT_ICON,
- TWITTER_ICON,
-};
-
// Fallback for providers whose icon_ref cannot be resolved — renders a
// circle with the provider initial, so the palette never shows nothing.
const fallbackIcon = (initial: string): React.FC<IconProps> => {
@@ -130,36 +78,40 @@ const fallbackIcon = (initial: string): React.FC<IconProps> => {
return Comp;
};
-function resolveIcon(iconRef: string | undefined, providerId: string): React.FC<IconProps> {
+export function resolveIconRef(iconRef: string | undefined, providerId: string): React.FC<IconProps> {
const initial = (providerId[0] ?? '?').toUpperCase();
if (!iconRef) return fallbackIcon(initial);
- const colon = iconRef.indexOf(':');
- if (colon < 0) return fallbackIcon(initial);
+ const LibIcon = resolveLibraryIcon(iconRef);
+ if (LibIcon) {
+ const Comp: React.FC<IconProps> = ({ size }) => React.createElement(LibIcon, { size });
+ return Comp;
+ }
- const kind = iconRef.slice(0, colon);
- const rest = iconRef.slice(colon + 1);
+ const resolved = resolveIcon(iconRef);
+ if (resolved && isImageIcon(resolved)) {
+ const Comp: React.FC<IconProps> = ({ size }) =>
+ React.createElement('img', {
+ src: resolved,
+ width: size,
+ height: size,
+ alt: '',
+ style: { display: 'block' },
+ });
+ return Comp;
+ }
- switch (kind) {
- case 'ai': {
- const meta = AI_PROVIDER_META[rest];
- return meta?.Icon ?? fallbackIcon(initial);
- }
- case 'raw_svg': {
- // e.g. "SearchIcons.brave" → look up pre-exported data URI
- const [module, key] = rest.split('.');
- const uri = RAW_SVG_DATA_URIS[module]?.[key];
- return uri ? fromDataUri(uri) : fallbackIcon(initial);
- }
- case 'data_uri': {
- const uri = DATA_URI_REGISTRY[rest];
- return uri ? fromDataUri(uri) : fallbackIcon(initial);
- }
- case 'emoji':
- return fromEmoji(rest);
- default:
- return fallbackIcon(initial);
+ if (resolved) {
+ const Comp: React.FC<IconProps> = ({ size }) =>
+ React.createElement(
+ 'span',
+ { style: { fontSize: size, lineHeight: 1, display: 'inline-block' } },
+ resolved,
+ );
+ return Comp;
}
+
+ return fallbackIcon(initial);
}
// ============================================================================
@@ -271,7 +223,7 @@ export function rehydrateProvider(entry: ServerProviderConfig): ProviderConfig {
categoryLabel: entry.category_label,
color: entry.color,
kind: entry.kind as PanelKind,
- icon: resolveIcon(entry.icon_ref, entry.id),
+ icon: resolveIconRef(entry.icon_ref, entry.id),
fields: buildFields(entry.fields),
ws: entry.ws,
statusHook: entry.status_hook,
diff --git a/client/src/components/credentials/providers.tsx b/client/src/components/credentials/providers.tsx
index f14e0010..e8772bb7 100644
--- a/client/src/components/credentials/providers.tsx
+++ b/client/src/components/credentials/providers.tsx
@@ -8,71 +8,28 @@
* Status rows: pure data (ok/trueText/falseText), theme colors resolved in StatusCard.
*/
-import React from 'react';
import { AI_PROVIDER_META } from '../icons/AIProviderIcons';
-import { ApifyIcons } from '../../assets/icons/apify';
-import { SearchIcons } from '../../assets/icons/search';
-import { TelegramIcons } from '../../assets/icons/telegram';
-import { GoogleIcons } from '../../assets/icons/google';
-import { EmailIcons } from '../../assets/icons/email';
-import { WHATSAPP_CONNECT_ICON } from '../../nodeDefinitions/whatsappNodes';
-import { TWITTER_ICON } from '../../nodeDefinitions/twitterNodes';
+import { resolveIconRef } from './catalogueAdapter';
import type { ProviderConfig, CategoryGroup } from './types';
// ============================================================================
-// ICON FACTORIES — thin wrappers around existing asset strings.
-// All icons accept a `size` prop from the caller (no hardcoded dimensions).
+// Wave 10.B: icon resolution unified with the backend-driven catalogue —
+// every provider icon goes through `resolveIconRef`, which dispatches
+// `lobehub:<brand>` → React component, `asset:<key>` → SVG via the
+// filesystem registry, and emoji/text as a styled <span>.
// ============================================================================
-interface IconProps { size: number }
-
-/** Wraps a raw SVG string (from assets/icons/) into a sized component. */
-const fromRawSvg = (rawSvg: string): React.FC<IconProps> => {
- const Comp: React.FC<IconProps> = ({ size }) => {
- const ref = React.useRef<HTMLDivElement>(null);
- React.useEffect(() => { if (ref.current) ref.current.innerHTML = rawSvg; }, []);
- return <div ref={ref} style={{ width: size, height: size }} />;
- };
- return Comp;
-};
-
-/** Wraps a data:image/svg+xml URI (from node definitions) into a sized component. */
-const fromDataUri = (dataUri: string): React.FC<IconProps> => {
- const Comp: React.FC<IconProps> = ({ size }) => (
- <img src={dataUri} width={size} height={size} alt="" style={{ display: 'block' }} />
- );
- return Comp;
-};
-
-/** Wraps an emoji string into a sized inline element — matches node-definition convention. */
-const fromEmoji = (emoji: string): React.FC<IconProps> => {
- const Comp: React.FC<IconProps> = ({ size }) => (
- <span style={{ fontSize: size, lineHeight: 1, display: 'inline-block' }}>{emoji}</span>
- );
- return Comp;
-};
-
-// Reuse raw SVG strings from assets/icons/
-const BraveIcon = fromRawSvg(SearchIcons.brave);
-const SerperIcon = fromRawSvg(SearchIcons.serper);
-const PerplexityIcon = fromRawSvg(SearchIcons.perplexity);
-const TelegramBotIcon = fromRawSvg(TelegramIcons.telegram);
-const GWorkspaceIcon = fromRawSvg(GoogleIcons.gmail);
-const EmailCredIcon = fromRawSvg(EmailIcons.read);
-
-// Apify needs explicit scaling attribute on its root <svg>
-const ApifyIconC: React.FC<IconProps> = ({ size }) => {
- const scaled = ApifyIcons.apify.replace('<svg', '<svg width="100%" height="100%"');
- return <div dangerouslySetInnerHTML={{ __html: scaled }} style={{ width: size, height: size }} />;
-};
-
-// Reuse data URIs exported from node definitions
-const WhatsAppIcon = fromDataUri(WHATSAPP_CONNECT_ICON);
-const XIcon = fromDataUri(TWITTER_ICON);
-
-// Google Maps + Android: emoji (matches locationNodes '🗺️' and androidServiceNodes '📱')
-const GoogleMapsIcon = fromEmoji('🗺️');
-const AndroidIcon = fromEmoji('📱');
+const BraveIcon = resolveIconRef('asset:brave', 'brave');
+const SerperIcon = resolveIconRef('asset:google', 'serper');
+const PerplexityIcon = resolveIconRef('asset:perplexity', 'perplexity');
+const TelegramBotIcon = resolveIconRef('asset:telegram', 'telegram');
+const GWorkspaceIcon = resolveIconRef('asset:gmail', 'google');
+const EmailCredIcon = resolveIconRef('asset:read', 'email');
+const ApifyIconC = resolveIconRef('asset:apify', 'apify');
+const WhatsAppIcon = resolveIconRef('asset:whatsapp', 'whatsapp');
+const XIcon = resolveIconRef('asset:x', 'twitter');
+const GoogleMapsIcon = resolveIconRef('🗺️', 'maps');
+const AndroidIcon = resolveIconRef('📱', 'android');
// ============================================================================
// AI PROVIDERS — derived from centralized AI_PROVIDER_META
diff --git a/client/src/components/output/OutputPanel.tsx b/client/src/components/output/OutputPanel.tsx
index 49f30743..b2bdc6c0 100644
--- a/client/src/components/output/OutputPanel.tsx
+++ b/client/src/components/output/OutputPanel.tsx
@@ -53,19 +53,23 @@ interface Props {
interface SectionProps {
label: React.ReactNode;
defaultOpen?: boolean;
+ action?: React.ReactNode;
children: React.ReactNode;
}
-function Section({ label, defaultOpen = false, children }: SectionProps) {
+function Section({ label, defaultOpen = false, action, children }: SectionProps) {
const [open, setOpen] = useState(defaultOpen);
return (
<Collapsible open={open} onOpenChange={setOpen} className="border-b border-border last:border-0">
- <CollapsibleTrigger className="flex w-full items-center gap-2 py-2 text-sm font-medium text-foreground hover:text-primary">
- <ChevronDown
- className={cn('h-4 w-4 transition-transform', open && 'rotate-0', !open && '-rotate-90')}
- />
- <span className="flex-1 text-left">{label}</span>
- </CollapsibleTrigger>
+ <div className="flex items-center gap-2">
+ <CollapsibleTrigger className="flex flex-1 items-center gap-2 py-2 text-sm font-medium text-foreground hover:text-primary">
+ <ChevronDown
+ className={cn('h-4 w-4 transition-transform', open && 'rotate-0', !open && '-rotate-90')}
+ />
+ <span className="flex-1 text-left">{label}</span>
+ </CollapsibleTrigger>
+ {action && <div className="shrink-0">{action}</div>}
+ </div>
<CollapsibleContent className="pb-3 pl-6">{children}</CollapsibleContent>
</Collapsible>
);
@@ -151,21 +155,16 @@ export default function OutputPanel({ results, onClear, selectedNode }: Props) {
)}
<Section
- label={
- <div className="flex items-center gap-2">
- <span>Raw JSON</span>
- <button
- type="button"
- onClick={(e) => {
- e.stopPropagation();
- copyToClipboard(raw, 'Copied!');
- }}
- className="inline-flex items-center gap-1 text-xs text-primary hover:underline"
- >
- <Copy className="h-3 w-3" />
- Copy
- </button>
- </div>
+ label="Raw JSON"
+ action={
+ <button
+ type="button"
+ onClick={() => copyToClipboard(raw, 'Copied!')}
+ className="inline-flex items-center gap-1 text-xs text-primary hover:underline"
+ >
+ <Copy className="h-3 w-3" />
+ Copy
+ </button>
}
>
<JsonView
diff --git a/client/src/components/parameterPanel/InputSection.tsx b/client/src/components/parameterPanel/InputSection.tsx
index 258bbf8b..e72946f0 100644
--- a/client/src/components/parameterPanel/InputSection.tsx
+++ b/client/src/components/parameterPanel/InputSection.tsx
@@ -7,6 +7,7 @@ import { useDragVariable } from '../../hooks/useDragVariable';
import { useAppTheme } from '../../hooks/useAppTheme';
import { queryClient } from '../../lib/queryClient';
import { getCachedNodeSpec } from '../../lib/nodeSpec';
+import { resolveIcon, resolveLibraryIcon, isImageIcon } from '../../assets/icons';
// ---------------------------------------------------------------------------
// Backend-driven node output schema lookup.
@@ -92,18 +93,22 @@ interface NodeData {
hasExecutionData: boolean;
}
-// Helper to render icon (handles both image URLs and emoji/text)
+// Wave 10.B: shared icon dispatch — library components (`lobehub:*`),
+// filesystem SVGs (`asset:*`), data/http URIs, then emoji/text.
const renderNodeIcon = (icon: string, size: number = 16) => {
- if (icon.startsWith('data:') || icon.startsWith('http') || icon.startsWith('/')) {
+ const LibIcon = resolveLibraryIcon(icon);
+ if (LibIcon) return <LibIcon size={size} />;
+ const resolved = resolveIcon(icon);
+ if (resolved && isImageIcon(resolved)) {
return (
<img
- src={icon}
+ src={resolved}
alt="icon"
style={{ width: size, height: size, objectFit: 'contain' }}
/>
);
}
- return <span style={{ fontSize: size - 2 }}>{icon}</span>;
+ return <span style={{ fontSize: size - 2 }}>{resolved ?? ''}</span>;
};
const InputSection: React.FC<InputSectionProps> = ({ nodeId, visible = true }) => {
diff --git a/client/src/components/parameterPanel/MasterSkillEditor.tsx b/client/src/components/parameterPanel/MasterSkillEditor.tsx
index 97a4ab7f..9906437c 100644
--- a/client/src/components/parameterPanel/MasterSkillEditor.tsx
+++ b/client/src/components/parameterPanel/MasterSkillEditor.tsx
@@ -50,6 +50,7 @@ import { useAppTheme } from '../../hooks/useAppTheme';
import { useWebSocket } from '../../contexts/WebSocketContext';
import { skillNodes, SKILL_NODE_TYPES } from '../../nodeDefinitions/skillNodes';
import { DUCKDUCKGO_ICON, BRAVE_SEARCH_ICON, SERPER_ICON, PERPLEXITY_ICON } from '../../assets/icons/search';
+import { resolveIcon, resolveLibraryIcon, isImageIcon } from '../../assets/icons';
// Override icons for skills that have branded SVGs
const SKILL_ICON_OVERRIDES: Record<string, string> = {
@@ -127,12 +128,16 @@ const getNodeDefaults = (skillName: string): { icon: string; color: string } =>
return { icon: '', color: '' };
};
-// Helper to render icon (handles emojis and SVG data URIs)
+// Wave 10.B: shared icon dispatch — library components (`lobehub:*`),
+// filesystem SVGs (`asset:*`), data/http URIs, then emoji/text.
const renderSkillIcon = (icon: string, size: number = 16) => {
- if (icon.startsWith('data:') || icon.startsWith('http')) {
- return <img src={icon} alt="icon" style={{ width: size, height: size, objectFit: 'contain' }} />;
+ const LibIcon = resolveLibraryIcon(icon);
+ if (LibIcon) return <LibIcon size={size} />;
+ const resolved = resolveIcon(icon);
+ if (resolved && isImageIcon(resolved)) {
+ return <img src={resolved} alt="icon" style={{ width: size, height: size, objectFit: 'contain' }} />;
}
- return <span style={{ fontSize: size }}>{icon}</span>;
+ return <span style={{ fontSize: size }}>{resolved ?? ''}</span>;
};
const MasterSkillEditor: React.FC<MasterSkillEditorProps> = ({
diff --git a/client/src/components/parameterPanel/MiddleSection.tsx b/client/src/components/parameterPanel/MiddleSection.tsx
index 94dfdb39..f9bba2ce 100644
--- a/client/src/components/parameterPanel/MiddleSection.tsx
+++ b/client/src/components/parameterPanel/MiddleSection.tsx
@@ -35,6 +35,7 @@ import { useWebSocket, CompactionStats } from '../../contexts/WebSocketContext';
import { useUserSettingsQuery } from '../../hooks/useUserSettingsQuery';
import { nodeDefinitions } from '../../nodeDefinitions';
import { INodeTypeDescription, INodeProperties } from '../../types/INodeProperties';
+import { resolveIcon, resolveLibraryIcon, isImageIcon } from '../../assets/icons';
import { ExecutionResult } from '../../services/executionService';
import { Edge } from 'reactflow';
import { shouldShowParameter } from '../../utils/parameterVisibility';
@@ -757,11 +758,15 @@ const MiddleSection: React.FC<MiddleSectionProps> = ({
className="flex h-9 w-9 shrink-0 items-center justify-center rounded-md"
style={{ backgroundColor: skill.color + '20' }}
>
- {skill.icon.startsWith('data:') ? (
- <img src={skill.icon} alt={skill.name} className="h-5 w-5" />
- ) : (
- <span className="text-lg">{skill.icon}</span>
- )}
+ {(() => {
+ const LibIcon = resolveLibraryIcon(skill.icon);
+ if (LibIcon) return <LibIcon size={20} />;
+ const resolved = resolveIcon(skill.icon);
+ if (resolved && isImageIcon(resolved)) {
+ return <img src={resolved} alt={skill.name} className="h-5 w-5" />;
+ }
+ return <span className="text-lg">{resolved ?? ''}</span>;
+ })()}
</div>
<div className="min-w-0 flex-1">
<div className="mb-0.5 text-sm font-semibold text-foreground">
diff --git a/client/src/components/ui/ComponentItem.tsx b/client/src/components/ui/ComponentItem.tsx
index c904283a..0deb0b02 100644
--- a/client/src/components/ui/ComponentItem.tsx
+++ b/client/src/components/ui/ComponentItem.tsx
@@ -1,155 +1,70 @@
import React, { useState } from 'react';
-import { useAppTheme } from '../../hooks/useAppTheme';
+import { GripVertical } from 'lucide-react';
+import { cn } from '@/lib/utils';
+import { Card } from '@/components/ui/card';
import { INodeTypeDescription } from '../../types/INodeProperties';
+import { resolveIcon, resolveLibraryIcon, isImageIcon as isImage } from '../../assets/icons';
+import { useNodeSpec } from '../../lib/nodeSpec';
interface ComponentItemProps {
definition: INodeTypeDescription;
onDragStart: (event: React.DragEvent, definition: INodeTypeDescription) => void;
}
-const ComponentItem: React.FC<ComponentItemProps> = ({ definition, onDragStart }) => {
- const theme = useAppTheme();
+const ComponentItem: React.FC<ComponentItemProps> = ({ definition: localDefinition, onDragStart }) => {
const [isDragging, setIsDragging] = useState(false);
- const [isHovered, setIsHovered] = useState(false);
- // Helper to get colors from new interface format
- const getNodeColor = () => definition.defaults.color || '#9E9E9E';
+ // Wave 10.B: subscribe to the backend NodeSpec cache so the palette
+ // icon populates the moment prefetch lands. Icon + color come from
+ // the spec; display fields fall back to the bundled definition.
+ const spec = useNodeSpec(localDefinition.name);
+ const definition = localDefinition;
+ const iconRaw = spec?.icon ?? definition.icon;
- // Check if icon is an image URL or data URI (including SVG data URIs for Google icons)
- const isImageIcon = () => {
- const icon = definition.icon;
- return icon && (icon.startsWith('data:') || icon.startsWith('http') || icon.startsWith('/'));
- };
- const getIconBackground = () => isImageIcon() ? theme.colors.backgroundAlt : getNodeColor();
- const getBorderColor = () => {
- // Create a darker shade for border
- const color = getNodeColor();
- // Simple color darkening - could be enhanced
- if (color.startsWith('#')) {
- const hex = color.substring(1);
- const r = Math.max(0, parseInt(hex.substring(0, 2), 16) - 40);
- const g = Math.max(0, parseInt(hex.substring(2, 4), 16) - 40);
- const b = Math.max(0, parseInt(hex.substring(4, 6), 16) - 40);
- return `#${r.toString(16).padStart(2, '0')}${g.toString(16).padStart(2, '0')}${b.toString(16).padStart(2, '0')}`;
- }
- return color;
- };
+ const LibIcon = resolveLibraryIcon(iconRaw);
+ const resolvedIcon = LibIcon ? null : resolveIcon(iconRaw);
+ const iconIsImage = !!resolvedIcon && isImage(resolvedIcon);
return (
- <div
+ <Card
+ size="sm"
draggable
onDragStart={(e) => {
setIsDragging(true);
- onDragStart(e, definition);
+ onDragStart(e, localDefinition);
}}
onDragEnd={() => setIsDragging(false)}
- onMouseEnter={() => setIsHovered(true)}
- onMouseLeave={() => setIsHovered(false)}
- style={{
- padding: '12px',
- backgroundColor: theme.colors.background,
- border: `2px solid ${isHovered ? getBorderColor() : theme.colors.border}`,
- borderRadius: theme.borderRadius.lg,
- cursor: 'grab',
- transition: `all ${theme.transitions.fast}`,
- display: 'flex',
- alignItems: 'center',
- gap: '12px',
- boxShadow: isHovered
- ? theme.isDarkMode
- ? `0 4px 12px ${getNodeColor()}25, 0 0 0 1px ${getNodeColor()}15`
- : `0 4px 12px ${getNodeColor()}30, 0 0 0 1px ${getNodeColor()}20`
- : theme.isDarkMode
- ? `0 1px 3px ${theme.colors.shadowLight}`
- : `0 1px 4px rgba(0,0,0,0.08)`,
- transform: isHovered ? 'translateY(-2px) scale(1.02)' : 'translateY(0)',
- opacity: isDragging ? 0.5 : 1,
- fontFamily: 'system-ui, sans-serif',
- position: 'relative',
- overflow: 'hidden',
- }}
+ className={cn(
+ 'group relative flex-row items-center gap-3 px-3 py-2 cursor-grab select-none',
+ 'transition-all duration-150 ease-out',
+ 'hover:-translate-y-0.5 hover:ring-2 hover:ring-foreground/15 hover:shadow-md',
+ isDragging && 'opacity-50',
+ )}
>
- {/* Gradient Background on Hover */}
- <div style={{
- position: 'absolute',
- top: 0,
- left: 0,
- right: 0,
- bottom: 0,
- background: theme.isDarkMode
- ? `linear-gradient(135deg, ${getNodeColor()}08 0%, ${getNodeColor()}12 100%)`
- : `linear-gradient(135deg, ${getNodeColor()}06 0%, ${getNodeColor()}12 100%)`,
- opacity: isHovered ? 1 : 0,
- transition: `opacity ${theme.transitions.fast}`,
- pointerEvents: 'none',
- }} />
-
- {/* Icon */}
- <div
- style={{
- fontSize: '18px',
- width: '36px',
- height: '36px',
- display: 'flex',
- alignItems: 'center',
- justifyContent: 'center',
- borderRadius: theme.borderRadius.md,
- backgroundColor: getIconBackground(),
- boxShadow: `0 2px 4px ${getNodeColor()}30`,
- flexShrink: 0,
- position: 'relative',
- zIndex: 1,
- }}
- >
- {isImageIcon() ? (
- <img src={definition.icon} alt="" style={{ width: '20px', height: '20px', objectFit: 'contain' }} />
+ <div className="flex h-9 w-9 shrink-0 items-center justify-center rounded-md bg-muted text-lg ring-1 ring-foreground/10">
+ {LibIcon ? (
+ <LibIcon size={20} />
+ ) : iconIsImage ? (
+ <img src={resolvedIcon!} alt="" className="h-5 w-5 object-contain" />
) : (
- definition.icon || '📦'
+ <span>{resolvedIcon || '📦'}</span>
)}
</div>
- {/* Content */}
- <div style={{
- flex: 1,
- overflow: 'hidden',
- position: 'relative',
- zIndex: 1,
- }}>
- <div style={{
- fontWeight: theme.fontWeight.medium,
- fontSize: theme.fontSize.base,
- color: theme.colors.text,
- marginBottom: '2px',
- overflow: 'hidden',
- textOverflow: 'ellipsis',
- whiteSpace: 'nowrap',
- }}>
+ <div className="min-w-0 flex-1">
+ <div className="truncate text-sm font-medium text-foreground">
{definition.displayName}
</div>
- <div style={{
- fontSize: theme.fontSize.xs,
- color: theme.colors.textSecondary,
- overflow: 'hidden',
- textOverflow: 'ellipsis',
- whiteSpace: 'nowrap',
- lineHeight: '1.3',
- }}>
+ <div className="truncate text-xs leading-tight text-muted-foreground">
{definition.description}
</div>
</div>
- {/* Drag Indicator */}
- <div style={{
- fontSize: '14px',
- color: theme.colors.textSecondary,
- opacity: isHovered ? 0.6 : 0.3,
- transition: `opacity ${theme.transitions.fast}`,
- position: 'relative',
- zIndex: 1,
- }}>
- ⋮⋮
- </div>
- </div>
+ <GripVertical
+ className="h-4 w-4 shrink-0 text-muted-foreground opacity-30 transition-opacity group-hover:opacity-60"
+ aria-hidden
+ />
+ </Card>
);
};
diff --git a/client/src/components/ui/ComponentPalette.tsx b/client/src/components/ui/ComponentPalette.tsx
index 051d1716..42735eb9 100644
--- a/client/src/components/ui/ComponentPalette.tsx
+++ b/client/src/components/ui/ComponentPalette.tsx
@@ -1,39 +1,20 @@
import React from 'react';
+import { useQuery } from '@tanstack/react-query';
import { useAppTheme } from '../../hooks/useAppTheme';
import { ComponentPaletteProps } from '../../types/ComponentTypes';
import { INodeTypeDescription } from '../../types/INodeProperties';
import ComponentItem from './ComponentItem';
import CollapsibleSection from './CollapsibleSection';
-import googleSvg from '../../assets/icons/search/google.svg?raw';
+import { Badge } from '@/components/ui/badge';
+import { Input } from '@/components/ui/input';
+import { Search } from 'lucide-react';
+import { resolveIcon, resolveLibraryIcon, isImageIcon } from '../../assets/icons';
+import { nodeGroupsQueryKey, NodeGroupEntry } from '../../lib/nodeSpec';
+import { useWebSocket } from '../../contexts/WebSocketContext';
-// Category icons - emoji strings or { svg: string } for inline SVG icons
-const CATEGORY_ICONS: Record<string, string | { svg: string }> = {
- workflow: '⚡',
- trigger: '🕐',
- ai: '🤖',
- agent: '🤖',
- model: '🧬',
- skill: '🎯',
- tool: '🛠️',
- location: '📍',
- social: '📱',
- android: '📱',
- chat: '💭',
- code: '💻',
- document: '🗄️',
- utility: '🔧',
- api: '🕷️',
- search: '🔍',
- google: { svg: googleSvg },
- scheduler: '📅',
- proxy: '🛡',
-};
-
-// Categories that should be merged into 'social' (Social Media)
-const SOCIAL_CATEGORIES = ['whatsapp', 'social'];
-
-// Categories shown in simple (noob) mode - only AI related
-const SIMPLE_MODE_CATEGORIES = ['agent', 'model', 'skill', 'tool'];
+// Wave 10.B: palette section metadata (icon / label / color / visibility)
+// is fetched from the backend GET /api/schemas/nodes/groups endpoint.
+// Frontend retains zero per-category tables.
const ComponentPalette: React.FC<ComponentPaletteProps> = ({
nodeDefinitions,
@@ -45,59 +26,32 @@ const ComponentPalette: React.FC<ComponentPaletteProps> = ({
proMode = false, // Default to simple mode
}) => {
const theme = useAppTheme();
-
- const getCategoryConfig = (category: string) => {
- const key = category.toLowerCase();
- // Use theme-specific category colors (darker for light mode, vibrant for dark mode)
- const colors = theme.colors as Record<string, string>;
- const colorMap: Record<string, string> = {
- workflow: colors.categoryWorkflow || theme.dracula.orange,
- trigger: colors.categoryTrigger || theme.dracula.pink,
- ai: colors.categoryAI || theme.dracula.purple,
- agent: colors.categoryAgent || theme.dracula.purple,
- model: colors.categoryModel || theme.dracula.cyan,
- skill: colors.categorySkill || theme.dracula.green,
- tool: colors.categoryTool || theme.dracula.green,
- location: colors.categoryLocation || theme.dracula.red,
- social: colors.categorySocial || theme.dracula.green,
- android: colors.categoryAndroid || theme.dracula.cyan,
- chat: colors.categoryChat || theme.dracula.yellow,
- code: colors.categoryCode || theme.dracula.orange,
- document: colors.categoryTrigger || theme.dracula.pink,
- utility: colors.categoryUtil || theme.dracula.purple,
- api: colors.categoryCode || theme.dracula.orange,
- search: colors.categoryModel || theme.dracula.cyan,
- google: theme.accent.blue,
- scheduler: colors.categoryTrigger || theme.dracula.pink,
- proxy: colors.categoryUtil || theme.dracula.purple,
- };
- const labelMap: Record<string, string> = {
- workflow: 'Workflows',
- trigger: 'Triggers',
- ai: 'AI',
- agent: 'AI Agents',
- model: 'AI Models',
- skill: 'AI Skills',
- tool: 'AI Tools',
- location: 'Location',
- social: 'Social',
- android: 'Android',
- chat: 'Chat',
- code: 'Code',
- document: 'Documents',
- utility: 'Utilities',
- api: 'API & Scraping',
- search: 'Search',
- google: 'Google Workspace',
- scheduler: 'Schedulers',
- proxy: 'Proxy',
- };
+ const { sendRequest, isConnected } = useWebSocket();
+
+ // Backend-driven group metadata (label / icon / color / visibility).
+ // Direct WS call — do NOT route through `fetchNodeGroups`, which
+ // would re-enter `queryClient.fetchQuery` on the same key and leave
+ // this subscription stuck with `undefined`.
+ const { data: groupIndex } = useQuery<Record<string, NodeGroupEntry>>({
+ queryKey: nodeGroupsQueryKey,
+ queryFn: async () => {
+ const response = await sendRequest('get_node_groups', {});
+ return (response?.groups ?? {}) as Record<string, NodeGroupEntry>;
+ },
+ staleTime: Infinity,
+ enabled: isConnected,
+ });
+
+ const getCategoryConfig = React.useCallback((category: string) => {
+ const entry = groupIndex?.[category.toLowerCase()] as NodeGroupEntry | undefined;
+ // No icon/color fallback: if the backend doesn't declare the
+ // group via register_group(), the empty string surfaces the gap.
return {
- icon: CATEGORY_ICONS[key] || '📦',
- color: colorMap[key] || theme.colors.textSecondary,
- label: labelMap[key] || category
+ icon: entry?.icon ?? '',
+ color: entry?.color || theme.colors.textSecondary,
+ label: entry?.label || category,
};
- };
+ }, [groupIndex, theme.colors.textSecondary]);
const categorizedComponents = React.useMemo(() => {
const categories: Record<string, INodeTypeDescription[]> = {};
@@ -118,10 +72,13 @@ const ComponentPalette: React.FC<ComponentPaletteProps> = ({
}
}
- // Filter by proMode - in simple mode, only show AI-related categories
+ // Wave 10.B: simple-mode visibility comes from backend
+ // GroupMetadata.visibility ('normal' shown, 'dev' hidden in simple
+ // mode). No frontend SIMPLE_MODE_CATEGORIES table.
if (!proMode) {
- const categoryKey = (definition.group?.[0] || '').toLowerCase();
- if (!SIMPLE_MODE_CATEGORIES.includes(categoryKey)) {
+ const firstGroup = (definition.group?.[0] || '').toLowerCase();
+ const groupVisibility = groupIndex?.[firstGroup]?.visibility;
+ if (groupVisibility !== 'normal' && groupVisibility !== 'all') {
return false;
}
}
@@ -131,16 +88,8 @@ const ComponentPalette: React.FC<ComponentPaletteProps> = ({
filteredDefinitions.forEach((definition) => {
try {
- let categoryKey = definition.group?.[0] || 'Uncategorized';
-
- // Merge whatsapp and social categories into 'social'
- if (SOCIAL_CATEGORIES.includes(categoryKey.toLowerCase())) {
- categoryKey = 'social';
- }
-
- if (!categories[categoryKey]) {
- categories[categoryKey] = [];
- }
+ const categoryKey = (definition.group?.[0] || 'Uncategorized').toLowerCase();
+ if (!categories[categoryKey]) categories[categoryKey] = [];
categories[categoryKey].push(definition);
} catch (error) {
// Skip invalid definitions
@@ -148,7 +97,7 @@ const ComponentPalette: React.FC<ComponentPaletteProps> = ({
});
return categories;
- }, [nodeDefinitions, searchQuery, proMode]);
+ }, [nodeDefinitions, searchQuery, proMode, groupIndex]);
const totalComponents = Object.values(categorizedComponents).reduce(
(acc, components) => acc + components.length,
@@ -156,112 +105,35 @@ const ComponentPalette: React.FC<ComponentPaletteProps> = ({
);
return (
- <div style={{
- width: '100%',
- height: '100%',
- overflowY: 'auto',
- backgroundColor: theme.colors.backgroundPanel,
- display: 'flex',
- flexDirection: 'column',
- }}>
+ <div className="flex h-full w-full flex-col overflow-hidden bg-muted/30">
{/* Header Section */}
- <div style={{
- padding: theme.spacing.lg,
- borderBottom: `1px solid ${theme.colors.border}`,
- background: theme.colors.background,
- }}>
- <div style={{ display: 'flex', alignItems: 'center', justifyContent: 'space-between', marginBottom: theme.spacing.md }}>
- <h2 style={{
- margin: 0,
- fontSize: theme.fontSize.lg,
- fontWeight: theme.fontWeight.semibold,
- color: theme.colors.text,
- fontFamily: 'system-ui, sans-serif',
- }}>
- Components
- </h2>
- <span style={{
- fontSize: theme.fontSize.xs,
- padding: '4px 10px',
- backgroundColor: theme.colors.backgroundAlt,
- borderRadius: '12px',
- color: theme.colors.textSecondary,
- fontWeight: theme.fontWeight.medium,
- }}>
+ <div className="border-b border-border bg-card p-4">
+ <div className="mb-3 flex items-center justify-between">
+ <h2 className="text-base font-semibold text-foreground">Components</h2>
+ <Badge variant="secondary" className="text-xs font-medium">
{totalComponents}
- </span>
+ </Badge>
</div>
{/* Search Input */}
- <div style={{ position: 'relative' }}>
- <input
+ <div className="relative">
+ <Search className="pointer-events-none absolute left-3 top-1/2 h-4 w-4 -translate-y-1/2 text-muted-foreground" />
+ <Input
type="text"
placeholder="Search..."
value={searchQuery}
onChange={(e) => onSearchChange(e.target.value)}
- style={{
- width: '100%',
- padding: '10px 12px',
- paddingLeft: '36px',
- fontSize: theme.fontSize.sm,
- border: `1px solid ${theme.colors.border}`,
- borderRadius: theme.borderRadius.md,
- backgroundColor: theme.colors.backgroundAlt,
- color: theme.colors.text,
- fontFamily: 'system-ui, sans-serif',
- outline: 'none',
- transition: `all ${theme.transitions.fast}`,
- }}
- onFocus={(e) => {
- e.currentTarget.style.borderColor = theme.colors.focus;
- e.currentTarget.style.backgroundColor = theme.colors.background;
- }}
- onBlur={(e) => {
- e.currentTarget.style.borderColor = theme.colors.border;
- e.currentTarget.style.backgroundColor = theme.colors.backgroundAlt;
- }}
+ className="pl-9"
/>
- <svg
- style={{
- position: 'absolute',
- left: '12px',
- top: '50%',
- transform: 'translateY(-50%)',
- width: '16px',
- height: '16px',
- color: theme.colors.textSecondary,
- pointerEvents: 'none',
- }}
- fill="none"
- stroke="currentColor"
- viewBox="0 0 24 24"
- >
- <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z" />
- </svg>
</div>
</div>
{/* Categories */}
- <div style={{
- padding: theme.spacing.md,
- flex: 1,
- overflowY: 'auto',
- }}>
+ <div className="flex-1 overflow-y-auto p-3">
{Object.keys(categorizedComponents).length === 0 ? (
- <div style={{
- textAlign: 'center',
- padding: theme.spacing.xxl,
- color: theme.colors.textSecondary,
- }}>
- <svg
- style={{ width: '48px', height: '48px', marginBottom: theme.spacing.md, opacity: 0.5 }}
- fill="none"
- stroke="currentColor"
- viewBox="0 0 24 24"
- >
- <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z" />
- </svg>
- <p style={{ margin: 0, fontSize: theme.fontSize.sm }}>
+ <div className="flex flex-col items-center px-6 py-12 text-center text-muted-foreground">
+ <Search className="mb-3 h-12 w-12 opacity-50" />
+ <p className="text-sm">
No components found matching "{searchQuery}"
</p>
</div>
@@ -272,59 +144,42 @@ const ComponentPalette: React.FC<ComponentPaletteProps> = ({
const config = getCategoryConfig(category);
return (
- <div key={category || 'unknown'} style={{ marginBottom: theme.spacing.md }}>
+ <div key={category || 'unknown'} className="mb-3">
<CollapsibleSection
title={
- <div style={{ display: 'flex', alignItems: 'center', justifyContent: 'space-between', width: '100%' }}>
- <div style={{ display: 'flex', alignItems: 'center', gap: '10px' }}>
- <span style={{
- width: '28px',
- height: '28px',
- display: 'flex',
- alignItems: 'center',
- justifyContent: 'center',
- backgroundColor: `${config.color}20`,
- borderRadius: '6px',
- fontSize: '16px',
- }}>
- {typeof config.icon === 'object' && 'svg' in config.icon ? (
- <span
- dangerouslySetInnerHTML={{ __html: config.icon.svg }}
- style={{ width: '16px', height: '16px', display: 'flex', alignItems: 'center', justifyContent: 'center' }}
- />
- ) : typeof config.icon === 'string' && (config.icon.startsWith('data:') || config.icon.startsWith('http')) ? (
- <img src={config.icon} alt="" style={{ width: '16px', height: '16px', objectFit: 'contain' }} />
- ) : (
- config.icon
- )}
+ <div className="flex w-full items-center justify-between">
+ <div className="flex items-center gap-2.5">
+ <span
+ className="flex h-7 w-7 items-center justify-center rounded-md text-base"
+ style={{ backgroundColor: `${config.color}20` }}
+ >
+ {(() => {
+ const LibIcon = resolveLibraryIcon(config.icon);
+ if (LibIcon) return <LibIcon size={16} />;
+ const resolved = resolveIcon(config.icon);
+ if (resolved && isImageIcon(resolved)) {
+ return <img src={resolved} alt="" className="h-4 w-4 object-contain" />;
+ }
+ return resolved || '📦';
+ })()}
</span>
- <span style={{
- fontWeight: theme.fontWeight.semibold,
- color: theme.colors.text,
- }}>
+ <span className="text-sm font-semibold text-foreground">
{config.label}
</span>
</div>
- <span style={{
- fontSize: theme.fontSize.xs,
- padding: '3px 10px',
- backgroundColor: `${config.color}15`,
- borderRadius: '12px',
- color: theme.colors.textSecondary,
- fontWeight: theme.fontWeight.medium,
- }}>
+ <Badge
+ variant="secondary"
+ className="text-xs font-medium"
+ style={{ backgroundColor: `${config.color}15`, color: 'hsl(var(--muted-foreground))' }}
+ >
{components?.length || 0}
- </span>
+ </Badge>
</div>
}
isCollapsed={isCollapsed}
onToggle={() => onToggleSection(category)}
>
- <div style={{
- display: 'grid',
- gap: theme.spacing.sm,
- paddingTop: theme.spacing.sm,
- }}>
+ <div className="grid gap-2 pt-2">
{(components || []).map((definition, idx) => {
try {
return (
diff --git a/client/src/factories/baseChatModelFactory.ts b/client/src/factories/baseChatModelFactory.ts
index 0efd8b85..c350d5a5 100644
--- a/client/src/factories/baseChatModelFactory.ts
+++ b/client/src/factories/baseChatModelFactory.ts
@@ -10,7 +10,6 @@ import {
export interface ChatModelConfig {
providerId: string;
displayName: string;
- icon: string;
color: string;
description: string;
nodeName?: string;
@@ -20,7 +19,7 @@ export function createBaseChatModel(config: ChatModelConfig): INodeTypeDescripti
return {
displayName: `${config.displayName} Chat Model`,
name: config.nodeName || `${config.providerId}ChatModel`,
- icon: config.icon,
+ // Wave 10.B: icon comes from the backend NodeSpec.
group: ['model'],
version: 1,
subtitle: '={{$parameter["model"]}}',
diff --git a/client/src/lib/nodeSpec.ts b/client/src/lib/nodeSpec.ts
index 6ac5138f..2d7d4411 100644
--- a/client/src/lib/nodeSpec.ts
+++ b/client/src/lib/nodeSpec.ts
@@ -12,6 +12,7 @@
* See C:\\Users\\Tgroh\\.claude\\plans\\typed-splashing-crown.md.
*/
+import { useQuery } from '@tanstack/react-query';
import { nodeSpecToDescription, type NodeSpec } from '../adapters/nodeSpecToDescription';
import type { INodeTypeDescription } from '../types/INodeProperties';
import { featureFlags } from './featureFlags';
@@ -60,21 +61,62 @@ export async function prefetchAllNodeSpecs(sendRequest: SendRequest): Promise<vo
}
/**
- * Synchronous read of a previously-cached NodeSpec. Used by flag-gated
- * render paths that need a description on-demand without suspending.
- * Returns `null` if not yet fetched.
- *
- * Reactivity: Dashboard's `prefetchAllNodeSpecs` warms every spec on
- * WebSocket connect, before any node mounts. Consumer components call
- * this on every render; React Flow re-renders nodes on viewport /
- * selection / parameter changes, which gives the spec a chance to
- * arrive. If you need eager reactivity, wrap with `useQuery` using
- * the shared `nodeSpecQueryKey(type)`.
+ * Synchronous read of a previously-cached NodeSpec. Used by the
+ * non-reactive merge helpers (`resolveNodeDescription`,
+ * `isNodeInBackendGroup`). Prefer `useNodeSpec` in React components
+ * so the render updates when prefetch lands.
*/
export function getCachedNodeSpec(nodeType: string): NodeSpec | null {
return queryClient.getQueryData<NodeSpec | null>(nodeSpecQueryKey(nodeType)) ?? null;
}
+/**
+ * Reactive spec subscription. Uses TanStack Query so the component
+ * re-renders when the prefetch warms the cache. No extra network
+ * traffic — `prefetchAllNodeSpecs` populates the cache at WS connect;
+ * this hook just subscribes.
+ */
+export function useNodeSpec(nodeType: string | undefined | null): NodeSpec | null {
+ const { data } = useQuery<NodeSpec | null>({
+ queryKey: nodeSpecQueryKey(nodeType ?? '__none__'),
+ queryFn: () => null,
+ enabled: false,
+ staleTime: Infinity,
+ });
+ return data ?? null;
+}
+
+/** Wire shape for one entry in the GET /api/schemas/nodes/groups
+ * response (Wave 10.B): per-group palette metadata + member types. */
+export interface NodeGroupEntry {
+ types: string[];
+ label: string;
+ icon: string;
+ color: string;
+ visibility: 'all' | 'normal' | 'dev';
+}
+
+export const nodeGroupsQueryKey = ['nodeGroups'] as const;
+
+/**
+ * Wave 10.B: fetch the full per-group palette index from the backend.
+ * Cached forever (group metadata only changes with a redeploy). The
+ * frontend ComponentPalette consumes this directly — no hand-rolled
+ * `CATEGORY_ICONS` / `labelMap` / `SIMPLE_MODE_CATEGORIES` tables.
+ */
+export async function fetchNodeGroups(
+ sendRequest: SendRequest,
+): Promise<Record<string, NodeGroupEntry>> {
+ return queryClient.fetchQuery({
+ queryKey: nodeGroupsQueryKey,
+ queryFn: async () => {
+ const response = await sendRequest('get_node_groups', {});
+ return (response?.groups ?? {}) as Record<string, NodeGroupEntry>;
+ },
+ staleTime: Infinity,
+ });
+}
+
/**
* Wave 10.E: enumerate every NodeSpec the cache currently holds.
* Used by component palette / drag-drop / execution routing to derive
@@ -187,22 +229,19 @@ export function resolveNodeDescription(
return merged;
});
- // Top-level UX-field fallback: frontend owns visual assets (SVG data
- // URIs in nodeDefinitions/assets/icons/, provider brand colors) — backend
- // NODE_METADATA carries empty strings for these to avoid duplicating SVG
- // payload across the wire. Fall back to local when backend is empty so
- // slimmed nodes keep their SVG icons and color swatches.
- const pick = <T,>(bv: T | undefined, lv: T | undefined): T | undefined =>
- bv !== undefined && bv !== null && bv !== '' ? bv : lv;
+ // Wave 10.B: backend NodeSpec is the sole source for top-level
+ // visual metadata (icon, subtitle, description, color). Local
+ // nodeDefinitions/*.ts entries carry no icons anymore, so we just
+ // pass the backend values through and only preserve local
+ // `defaults.color` when the backend doesn't declare one — color is
+ // the last remaining UX field that a few specialised agent configs
+ // still set locally.
return {
...backend,
- icon: pick(backend.icon, localFallback.icon) ?? '',
- subtitle: pick(backend.subtitle, localFallback.subtitle),
- description: pick(backend.description, localFallback.description) ?? '',
defaults: {
...localFallback.defaults,
...backend.defaults,
- color: pick(backend.defaults?.color, localFallback.defaults?.color),
+ color: backend.defaults?.color || localFallback.defaults?.color,
},
properties: mergedProperties,
};
diff --git a/client/src/nodeDefinitions/aiAgentNodes.ts b/client/src/nodeDefinitions/aiAgentNodes.ts
index 990f3db6..e6650d65 100644
--- a/client/src/nodeDefinitions/aiAgentNodes.ts
+++ b/client/src/nodeDefinitions/aiAgentNodes.ts
@@ -1,8 +1,5 @@
// AI Agent Node Definitions - AI agents and AI processing components
-import {
- INodeTypeDescription,
- NodeConnectionType
-} from '../types/INodeProperties';
+import { INodeTypeDescription, NodeConnectionType } from '../types/INodeProperties';
// ============================================================================
// AI AGENT AND CHAT NODES
@@ -13,7 +10,6 @@ export const aiAgentNodes: Record<string, INodeTypeDescription> = {
aiAgent: {
displayName: 'AI Agent',
name: 'aiAgent',
- icon: '🤖',
group: ['agent'],
version: 1,
subtitle: 'Tools Agent',
@@ -65,7 +61,6 @@ export const aiAgentNodes: Record<string, INodeTypeDescription> = {
chatAgent: {
displayName: 'Zeenie',
name: 'chatAgent',
- icon: '🧞',
group: ['agent'],
version: 1,
subtitle: 'Your Personal Assistant',
@@ -118,7 +113,6 @@ export const aiAgentNodes: Record<string, INodeTypeDescription> = {
simpleMemory: {
displayName: 'Simple Memory',
name: 'simpleMemory',
- icon: '🧠',
group: ['tool', 'memory'], // 'tool' = appears in AI Tools category
version: 1,
description: 'Markdown-based conversation memory with optional vector DB for long-term retrieval',
diff --git a/client/src/nodeDefinitions/aiModelNodes.ts b/client/src/nodeDefinitions/aiModelNodes.ts
index ce65a8c0..d784f3eb 100644
--- a/client/src/nodeDefinitions/aiModelNodes.ts
+++ b/client/src/nodeDefinitions/aiModelNodes.ts
@@ -4,12 +4,10 @@
import { INodeTypeDescription } from '../types/INodeProperties';
import { createBaseChatModel, ChatModelConfig } from '../factories/baseChatModelFactory';
import { dracula } from '../styles/theme';
-import { DEEPSEEK_ICON, KIMI_ICON, MISTRAL_ICON } from '../assets/icons/llm';
const openaiConfig: ChatModelConfig = {
providerId: 'openai',
displayName: 'OpenAI',
- icon: '🤖',
color: '#00A67E',
description: 'OpenAI GPT models for chat completion and generation',
};
@@ -17,7 +15,6 @@ const openaiConfig: ChatModelConfig = {
const claudeConfig: ChatModelConfig = {
providerId: 'anthropic',
displayName: 'Claude',
- icon: '🧠',
color: '#FF6B35',
description: 'Anthropic Claude models for conversation and analysis',
};
@@ -25,7 +22,6 @@ const claudeConfig: ChatModelConfig = {
const geminiConfig: ChatModelConfig = {
providerId: 'gemini',
displayName: 'Gemini',
- icon: '⭐',
color: '#4285F4',
description: 'Google Gemini models for multimodal AI capabilities',
};
@@ -33,7 +29,6 @@ const geminiConfig: ChatModelConfig = {
const openrouterConfig: ChatModelConfig = {
providerId: 'openrouter',
displayName: 'OpenRouter',
- icon: '🔀',
color: '#6366F1',
description: 'OpenRouter unified API - access OpenAI, Claude, Gemini, Llama, and more through one API',
};
@@ -41,7 +36,6 @@ const openrouterConfig: ChatModelConfig = {
const groqConfig: ChatModelConfig = {
providerId: 'groq',
displayName: 'Groq',
- icon: '⚡',
color: '#F55036',
description: 'Groq - Ultra-fast LLM inference with Llama, Mixtral, and Gemma models',
};
@@ -49,7 +43,6 @@ const groqConfig: ChatModelConfig = {
const cerebrasConfig: ChatModelConfig = {
providerId: 'cerebras',
displayName: 'Cerebras',
- icon: '🧬',
color: dracula.orange,
description: 'Cerebras - Ultra-fast inference with Llama and Qwen models on custom AI hardware',
};
@@ -57,7 +50,6 @@ const cerebrasConfig: ChatModelConfig = {
const deepseekConfig: ChatModelConfig = {
providerId: 'deepseek',
displayName: 'DeepSeek',
- icon: DEEPSEEK_ICON,
color: dracula.cyan,
description: 'DeepSeek V3 models (deepseek-chat, deepseek-reasoner with always-on CoT)',
};
@@ -65,7 +57,6 @@ const deepseekConfig: ChatModelConfig = {
const kimiConfig: ChatModelConfig = {
providerId: 'kimi',
displayName: 'Kimi',
- icon: KIMI_ICON,
color: dracula.purple,
description: 'Kimi K2 models by Moonshot AI with 256K context (thinking on by default)',
};
@@ -73,7 +64,6 @@ const kimiConfig: ChatModelConfig = {
const mistralConfig: ChatModelConfig = {
providerId: 'mistral',
displayName: 'Mistral',
- icon: MISTRAL_ICON,
color: dracula.orange,
description: 'Mistral AI models for reasoning, coding, and multilingual tasks',
};
diff --git a/client/src/nodeDefinitions/androidServiceNodes.ts b/client/src/nodeDefinitions/androidServiceNodes.ts
index ab22e3ee..2199a1f1 100644
--- a/client/src/nodeDefinitions/androidServiceNodes.ts
+++ b/client/src/nodeDefinitions/androidServiceNodes.ts
@@ -1,8 +1,5 @@
// Android Service Nodes - Individual nodes for each Android system service
-import {
- INodeTypeDescription,
- NodeConnectionType
-} from '../types/INodeProperties';
+import { INodeTypeDescription, NodeConnectionType } from '../types/INodeProperties';
import { API_CONFIG } from '../config/api';
// ============================================================================
@@ -14,7 +11,6 @@ function createAndroidServiceNode(config: {
name: string;
displayName: string;
serviceId: string;
- icon: string;
color: string;
group: string[];
description: string;
@@ -35,7 +31,6 @@ function createAndroidServiceNode(config: {
return {
displayName: config.displayName,
name: config.name,
- icon: config.icon,
group: config.group,
version: 1,
subtitle: `Android ${config.group[1]} Service`,
@@ -101,7 +96,6 @@ export const androidServiceNodes: Record<string, INodeTypeDescription> = {
name: 'batteryMonitor',
displayName: 'Battery Monitor',
serviceId: 'battery',
- icon: '🔋',
color: '#4CAF50',
group: ['android', 'monitoring'],
description: 'Monitor battery status, level, charging state, temperature, and health',
@@ -112,7 +106,6 @@ export const androidServiceNodes: Record<string, INodeTypeDescription> = {
name: 'networkMonitor',
displayName: 'Network Monitor',
serviceId: 'network',
- icon: '📡',
color: '#2196F3',
group: ['android', 'monitoring'],
description: 'Monitor network connectivity status, type, and internet availability',
@@ -123,7 +116,6 @@ export const androidServiceNodes: Record<string, INodeTypeDescription> = {
name: 'systemInfo',
displayName: 'System Info',
serviceId: 'system_info',
- icon: '📱',
color: '#9C27B0',
group: ['android', 'monitoring'],
description: 'Get device and OS information including Android version, API level, memory, and hardware details',
@@ -134,7 +126,6 @@ export const androidServiceNodes: Record<string, INodeTypeDescription> = {
name: 'location',
displayName: 'Location',
serviceId: 'location',
- icon: '📍',
color: '#F44336',
group: ['android', 'monitoring'],
description: 'GPS location tracking with latitude, longitude, accuracy, and provider information',
@@ -149,7 +140,6 @@ export const androidServiceNodes: Record<string, INodeTypeDescription> = {
name: 'appLauncher',
displayName: 'App Launcher',
serviceId: 'app_launcher',
- icon: '🚀',
color: '#FF9800',
group: ['android', 'apps'],
description: 'Launch applications by package name',
@@ -176,7 +166,6 @@ export const androidServiceNodes: Record<string, INodeTypeDescription> = {
name: 'appList',
displayName: 'App List',
serviceId: 'app_list',
- icon: '📋',
color: '#00BCD4',
group: ['android', 'apps'],
description: 'Get list of installed applications with package names, versions, and metadata',
@@ -191,7 +180,6 @@ export const androidServiceNodes: Record<string, INodeTypeDescription> = {
name: 'wifiAutomation',
displayName: 'WiFi Automation',
serviceId: 'wifi_automation',
- icon: '📶',
color: '#3F51B5',
group: ['android', 'automation'],
description: 'WiFi control and scanning - enable, disable, get status, scan for networks',
@@ -202,7 +190,6 @@ export const androidServiceNodes: Record<string, INodeTypeDescription> = {
name: 'bluetoothAutomation',
displayName: 'Bluetooth Automation',
serviceId: 'bluetooth_automation',
- icon: '🔵',
color: '#2196F3',
group: ['android', 'automation'],
description: 'Bluetooth control - enable, disable, get status, and paired devices',
@@ -213,7 +200,6 @@ export const androidServiceNodes: Record<string, INodeTypeDescription> = {
name: 'audioAutomation',
displayName: 'Audio Automation',
serviceId: 'audio_automation',
- icon: '🔊',
color: '#E91E63',
group: ['android', 'automation'],
description: 'Volume and audio control - get/set volume, mute, unmute',
@@ -224,7 +210,6 @@ export const androidServiceNodes: Record<string, INodeTypeDescription> = {
name: 'deviceStateAutomation',
displayName: 'Device State',
serviceId: 'device_state_automation',
- icon: '⚙️',
color: '#607D8B',
group: ['android', 'automation'],
description: 'Device state control - airplane mode, screen on/off, power save mode, brightness',
@@ -235,7 +220,6 @@ export const androidServiceNodes: Record<string, INodeTypeDescription> = {
name: 'screenControlAutomation',
displayName: 'Screen Control',
serviceId: 'screen_control_automation',
- icon: '💡',
color: '#FFC107',
group: ['android', 'automation'],
description: 'Screen control - brightness adjustment, wake screen, auto-brightness, screen timeout',
@@ -246,7 +230,6 @@ export const androidServiceNodes: Record<string, INodeTypeDescription> = {
name: 'airplaneModeControl',
displayName: 'Airplane Mode',
serviceId: 'airplane_mode_control',
- icon: '✈️',
color: '#795548',
group: ['android', 'automation'],
description: 'Airplane mode status monitoring and control',
@@ -261,7 +244,6 @@ export const androidServiceNodes: Record<string, INodeTypeDescription> = {
name: 'motionDetection',
displayName: 'Motion Detection',
serviceId: 'motion_detection',
- icon: '📳',
color: '#FF5722',
group: ['android', 'sensors'],
description: 'Accelerometer and gyroscope data - detect motion, shake gestures, device orientation',
@@ -272,7 +254,6 @@ export const androidServiceNodes: Record<string, INodeTypeDescription> = {
name: 'environmentalSensors',
displayName: 'Environmental Sensors',
serviceId: 'environmental_sensors',
- icon: '🌡️',
color: '#009688',
group: ['android', 'sensors'],
description: 'Environmental sensors - temperature, humidity, pressure, light level',
@@ -287,7 +268,6 @@ export const androidServiceNodes: Record<string, INodeTypeDescription> = {
name: 'cameraControl',
displayName: 'Camera Control',
serviceId: 'camera_control',
- icon: '📷',
color: '#673AB7',
group: ['android', 'media'],
description: 'Camera control - get camera info, take photos, camera capabilities',
@@ -298,7 +278,6 @@ export const androidServiceNodes: Record<string, INodeTypeDescription> = {
name: 'mediaControl',
displayName: 'Media Control',
serviceId: 'media_control',
- icon: '🎵',
color: '#E91E63',
group: ['android', 'media'],
description: 'Media playback control - volume control, playback control, play media files',
diff --git a/client/src/nodeDefinitions/apifyNodes.ts b/client/src/nodeDefinitions/apifyNodes.ts
index 74c2dd3e..ceb2f235 100644
--- a/client/src/nodeDefinitions/apifyNodes.ts
+++ b/client/src/nodeDefinitions/apifyNodes.ts
@@ -1,12 +1,5 @@
// Apify Node Definitions - Web scraping and social media data extraction
-import {
- INodeTypeDescription,
- NodeConnectionType
-} from '../types/INodeProperties';
-import { APIFY_ICON } from '../assets/icons/apify';
-
-// Re-export icon for external use
-export { APIFY_ICON };
+import { INodeTypeDescription, NodeConnectionType } from '../types/INodeProperties';
// ============================================================================
// APIFY NODES
@@ -17,7 +10,6 @@ export const apifyNodes: Record<string, INodeTypeDescription> = {
apifyActor: {
displayName: 'Apify Actor',
name: 'apifyActor',
- icon: APIFY_ICON,
group: ['api', 'scraper', 'tool'],
version: 1,
subtitle: 'Run Web Scraper',
diff --git a/client/src/nodeDefinitions/browserNodes.ts b/client/src/nodeDefinitions/browserNodes.ts
index 3dba7883..d3d62b42 100644
--- a/client/src/nodeDefinitions/browserNodes.ts
+++ b/client/src/nodeDefinitions/browserNodes.ts
@@ -1,18 +1,13 @@
// Browser Automation Node - Interactive browser control via agent-browser CLI
// Dual-purpose node: works as standalone workflow node AND AI Agent tool
-import {
- INodeTypeDescription,
- NodeConnectionType,
-} from '../types/INodeProperties';
+import { INodeTypeDescription, NodeConnectionType } from '../types/INodeProperties';
import { dracula } from '../styles/theme';
-import { BROWSER_ICON } from '../assets/icons/browser';
export const browserNodes: Record<string, INodeTypeDescription> = {
browser: {
displayName: 'Browser',
name: 'browser',
- icon: BROWSER_ICON,
group: ['browser', 'tool'],
version: 1,
subtitle: 'Agent Browser',
diff --git a/client/src/nodeDefinitions/chatNodes.ts b/client/src/nodeDefinitions/chatNodes.ts
index 77350b9b..521ff6ea 100644
--- a/client/src/nodeDefinitions/chatNodes.ts
+++ b/client/src/nodeDefinitions/chatNodes.ts
@@ -1,15 +1,11 @@
// Chat Node Definitions - JSON-RPC 2.0 WebSocket chat integration
import { INodeTypeDescription, NodeConnectionType } from '../types/INodeProperties';
-// Chat icon (speech bubble)
-const CHAT_ICON = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%234A90D9'%3E%3Cpath d='M20 2H4c-1.1 0-2 .9-2 2v18l4-4h14c1.1 0 2-.9 2-2V4c0-1.1-.9-2-2-2zm0 14H6l-2 2V4h16v12z'/%3E%3C/svg%3E";
-
export const chatNodes: Record<string, INodeTypeDescription> = {
// Chat Send Message Node
chatSend: {
displayName: 'Chat Send',
name: 'chatSend',
- icon: CHAT_ICON,
group: ['chat'],
version: 1,
subtitle: 'Send Chat Message',
@@ -35,7 +31,6 @@ export const chatNodes: Record<string, INodeTypeDescription> = {
chatHistory: {
displayName: 'Chat History',
name: 'chatHistory',
- icon: CHAT_ICON,
group: ['chat'],
version: 1,
subtitle: 'Get Chat History',
diff --git a/client/src/nodeDefinitions/codeNodes.ts b/client/src/nodeDefinitions/codeNodes.ts
index d49a50d6..aa158d77 100644
--- a/client/src/nodeDefinitions/codeNodes.ts
+++ b/client/src/nodeDefinitions/codeNodes.ts
@@ -5,7 +5,6 @@ export const codeNodes: Record<string, INodeTypeDescription> = {
pythonExecutor: {
displayName: 'Python Executor',
name: 'pythonExecutor',
- icon: 'https://cdn.jsdelivr.net/gh/devicons/devicon/icons/python/python-original.svg',
group: ['code', 'tool'],
version: 1,
subtitle: 'Run Python Code',
@@ -31,7 +30,6 @@ export const codeNodes: Record<string, INodeTypeDescription> = {
javascriptExecutor: {
displayName: 'JavaScript Executor',
name: 'javascriptExecutor',
- icon: 'https://cdn.jsdelivr.net/gh/devicons/devicon/icons/javascript/javascript-original.svg',
group: ['code', 'tool'],
version: 1,
subtitle: 'Run JavaScript Code',
@@ -56,7 +54,6 @@ export const codeNodes: Record<string, INodeTypeDescription> = {
typescriptExecutor: {
displayName: 'TypeScript Executor',
name: 'typescriptExecutor',
- icon: 'https://cdn.jsdelivr.net/gh/devicons/devicon/icons/typescript/typescript-original.svg',
group: ['code', 'tool'],
version: 1,
subtitle: 'Run TypeScript Code',
diff --git a/client/src/nodeDefinitions/crawleeNodes.ts b/client/src/nodeDefinitions/crawleeNodes.ts
index cef82240..ce5d12d4 100644
--- a/client/src/nodeDefinitions/crawleeNodes.ts
+++ b/client/src/nodeDefinitions/crawleeNodes.ts
@@ -1,16 +1,12 @@
// Crawlee Web Scraping Node - Static & Browser-based scraping via Crawlee
// Dual-purpose node: works as standalone workflow node AND AI Agent tool
-import {
- INodeTypeDescription,
- NodeConnectionType,
-} from '../types/INodeProperties';
+import { INodeTypeDescription, NodeConnectionType } from '../types/INodeProperties';
export const crawleeNodes: Record<string, INodeTypeDescription> = {
crawleeScraper: {
displayName: 'Web Scraper',
name: 'crawleeScraper',
- icon: '🕷',
group: ['api', 'tool'],
version: 1,
subtitle: 'Crawlee Scraper',
diff --git a/client/src/nodeDefinitions/documentNodes.ts b/client/src/nodeDefinitions/documentNodes.ts
index c7fc3870..fb9d3a81 100644
--- a/client/src/nodeDefinitions/documentNodes.ts
+++ b/client/src/nodeDefinitions/documentNodes.ts
@@ -1,14 +1,10 @@
// Document Processing Nodes - HTTP Scraper, File Downloader, Document Parser, Text Chunker, Embedding Generator, Vector Store
-import {
- INodeTypeDescription,
- NodeConnectionType
-} from '../types/INodeProperties';
+import { INodeTypeDescription, NodeConnectionType } from '../types/INodeProperties';
export const documentNodes: Record<string, INodeTypeDescription> = {
httpScraper: {
displayName: 'HTTP Scraper',
name: 'httpScraper',
- icon: '🔍',
group: ['document'],
version: 1,
description: 'Scrape links from web pages with date/page pagination support',
@@ -27,7 +23,6 @@ export const documentNodes: Record<string, INodeTypeDescription> = {
fileDownloader: {
displayName: 'File Downloader',
name: 'fileDownloader',
- icon: '⬇️',
group: ['document'],
version: 1,
description: 'Download files from URLs in parallel',
@@ -46,7 +41,6 @@ export const documentNodes: Record<string, INodeTypeDescription> = {
documentParser: {
displayName: 'Document Parser',
name: 'documentParser',
- icon: '📄',
group: ['document'],
version: 1,
description: 'Parse documents to text using various parsers',
@@ -65,7 +59,6 @@ export const documentNodes: Record<string, INodeTypeDescription> = {
textChunker: {
displayName: 'Text Chunker',
name: 'textChunker',
- icon: '✂️',
group: ['document'],
version: 1,
description: 'Split text into overlapping chunks for embedding',
@@ -84,7 +77,6 @@ export const documentNodes: Record<string, INodeTypeDescription> = {
embeddingGenerator: {
displayName: 'Embedding Generator',
name: 'embeddingGenerator',
- icon: '🧠',
group: ['document'],
version: 1,
description: 'Generate vector embeddings from text chunks',
@@ -103,7 +95,6 @@ export const documentNodes: Record<string, INodeTypeDescription> = {
vectorStore: {
displayName: 'Vector Store',
name: 'vectorStore',
- icon: '🗄️',
group: ['document'],
version: 1,
description: 'Store and query vector embeddings',
diff --git a/client/src/nodeDefinitions/emailNodes.ts b/client/src/nodeDefinitions/emailNodes.ts
index 3d4e6caa..b6319bb7 100644
--- a/client/src/nodeDefinitions/emailNodes.ts
+++ b/client/src/nodeDefinitions/emailNodes.ts
@@ -1,10 +1,6 @@
// Email Node Definitions - IMAP/SMTP integration via Himalaya CLI
-import {
- INodeTypeDescription,
- NodeConnectionType
-} from '../types/INodeProperties';
+import { INodeTypeDescription, NodeConnectionType } from '../types/INodeProperties';
import { solarized } from '../styles/theme';
-import { EMAIL_SEND_ICON, EMAIL_READ_ICON, EMAIL_RECEIVE_ICON } from '../assets/icons/email';
// Wave 8: provider presets + property metadata now live on backend
// (Email{Send,Read,Receive}Params + EMAIL_PROVIDERS in server config).
@@ -18,7 +14,6 @@ export const emailNodes: Record<string, INodeTypeDescription> = {
emailSend: {
displayName: 'Email Send',
name: 'emailSend',
- icon: EMAIL_SEND_ICON,
group: ['email', 'tool'],
version: 1,
subtitle: 'Send Email via SMTP',
@@ -36,7 +31,6 @@ export const emailNodes: Record<string, INodeTypeDescription> = {
emailRead: {
displayName: 'Email Read',
name: 'emailRead',
- icon: EMAIL_READ_ICON,
group: ['email', 'tool'],
version: 1,
subtitle: 'Read & Manage via IMAP',
@@ -54,7 +48,6 @@ export const emailNodes: Record<string, INodeTypeDescription> = {
emailReceive: {
displayName: 'Email Receive',
name: 'emailReceive',
- icon: EMAIL_RECEIVE_ICON,
group: ['email', 'trigger'],
version: 1,
subtitle: 'On Email Received',
diff --git a/client/src/nodeDefinitions/filesystemNodes.ts b/client/src/nodeDefinitions/filesystemNodes.ts
index 32211d97..ce611869 100644
--- a/client/src/nodeDefinitions/filesystemNodes.ts
+++ b/client/src/nodeDefinitions/filesystemNodes.ts
@@ -5,7 +5,6 @@ export const filesystemNodes: Record<string, INodeTypeDescription> = {
fileRead: {
displayName: 'File Read',
name: 'fileRead',
- icon: '\u{1F4C4}',
group: ['utility', 'tool'],
version: 1,
subtitle: 'Read File',
@@ -23,7 +22,6 @@ export const filesystemNodes: Record<string, INodeTypeDescription> = {
fileModify: {
displayName: 'File Modify',
name: 'fileModify',
- icon: '\u{270F}\u{FE0F}',
group: ['utility', 'tool'],
version: 1,
subtitle: 'Write / Edit File',
@@ -41,7 +39,6 @@ export const filesystemNodes: Record<string, INodeTypeDescription> = {
shell: {
displayName: 'Shell',
name: 'shell',
- icon: '\u{1F4BB}',
group: ['utility', 'tool'],
version: 1,
subtitle: 'Execute Command',
@@ -59,7 +56,6 @@ export const filesystemNodes: Record<string, INodeTypeDescription> = {
fsSearch: {
displayName: 'FS Search',
name: 'fsSearch',
- icon: '\u{1F50D}',
group: ['utility', 'tool'],
version: 1,
subtitle: 'List / Glob / Grep',
diff --git a/client/src/nodeDefinitions/googleWorkspaceNodes.ts b/client/src/nodeDefinitions/googleWorkspaceNodes.ts
index 4bdbfe11..af08b68e 100644
--- a/client/src/nodeDefinitions/googleWorkspaceNodes.ts
+++ b/client/src/nodeDefinitions/googleWorkspaceNodes.ts
@@ -1,17 +1,8 @@
// Google Workspace Node Definitions - Consolidated nodes for Gmail, Calendar, Drive, Sheets, Tasks, Contacts
// Each node uses an operation selector pattern with displayOptions.show for conditional parameters
-import {
- INodeTypeDescription,
- NodeConnectionType
-} from '../types/INodeProperties';
-import {
- GMAIL_ICON,
- CALENDAR_ICON,
- DRIVE_ICON,
- SHEETS_ICON,
- TASKS_ICON,
- CONTACTS_ICON
-} from '../assets/icons/google';
+import { INodeTypeDescription, NodeConnectionType } from '../types/INodeProperties';
+
+// Wave 10.B: icons resolved from asset:<key> via assets/icons/google/*.svg.
// Wave 8: ACCOUNT_MODE_PROPERTY + CUSTOMER_ID_PROPERTY moved to backend
// (each Google* Pydantic model carries account_mode + customer_id with
@@ -24,7 +15,6 @@ import {
export const gmailNode: INodeTypeDescription = {
displayName: 'Gmail',
name: 'gmail',
- icon: GMAIL_ICON,
group: ['google', 'tool'],
version: 1,
subtitle: 'Email Operations',
@@ -61,7 +51,6 @@ export const gmailNode: INodeTypeDescription = {
export const gmailReceiveNode: INodeTypeDescription = {
displayName: 'Gmail Receive',
name: 'gmailReceive',
- icon: GMAIL_ICON,
group: ['google', 'trigger'],
version: 1,
subtitle: 'On New Email',
@@ -85,7 +74,6 @@ export const gmailReceiveNode: INodeTypeDescription = {
export const calendarNode: INodeTypeDescription = {
displayName: 'Calendar',
name: 'calendar',
- icon: CALENDAR_ICON,
group: ['google', 'tool'],
version: 1,
subtitle: 'Calendar Events',
@@ -122,7 +110,6 @@ export const calendarNode: INodeTypeDescription = {
export const driveNode: INodeTypeDescription = {
displayName: 'Drive',
name: 'drive',
- icon: DRIVE_ICON,
group: ['google', 'tool'],
version: 1,
subtitle: 'File Operations',
@@ -159,7 +146,6 @@ export const driveNode: INodeTypeDescription = {
export const sheetsNode: INodeTypeDescription = {
displayName: 'Sheets',
name: 'sheets',
- icon: SHEETS_ICON,
group: ['google', 'tool'],
version: 1,
subtitle: 'Spreadsheet Operations',
@@ -196,7 +182,6 @@ export const sheetsNode: INodeTypeDescription = {
export const tasksNode: INodeTypeDescription = {
displayName: 'Tasks',
name: 'tasks',
- icon: TASKS_ICON,
group: ['google', 'tool'],
version: 1,
subtitle: 'Task Management',
@@ -233,7 +218,6 @@ export const tasksNode: INodeTypeDescription = {
export const contactsNode: INodeTypeDescription = {
displayName: 'Contacts',
name: 'contacts',
- icon: CONTACTS_ICON,
group: ['google', 'tool'],
version: 1,
subtitle: 'Contact Management',
diff --git a/client/src/nodeDefinitions/locationNodes.ts b/client/src/nodeDefinitions/locationNodes.ts
index 6f3df65e..c6e2fcc6 100644
--- a/client/src/nodeDefinitions/locationNodes.ts
+++ b/client/src/nodeDefinitions/locationNodes.ts
@@ -1,8 +1,5 @@
// Location Node Definitions - GPS, Maps, and Geolocation Services
-import {
- INodeTypeDescription,
- NodeConnectionType
-} from '../types/INodeProperties';
+import { INodeTypeDescription, NodeConnectionType } from '../types/INodeProperties';
// ============================================================================
// LOCATION NODES - GPS, Maps, and Geolocation Services
@@ -17,7 +14,6 @@ export const locationNodes: Record<string, INodeTypeDescription> = {
gmaps_create: {
displayName: 'GMaps Create',
name: 'gmaps_create',
- icon: '🗺️',
group: ['location', 'service'],
version: 1,
subtitle: 'Initialize Google Map',
@@ -50,7 +46,6 @@ export const locationNodes: Record<string, INodeTypeDescription> = {
gmaps_locations: {
displayName: 'GMaps Locations',
name: 'gmaps_locations',
- icon: '🌍',
group: ['location', 'service', 'tool'], // 'tool' enables AI Agent tool calling
version: 1,
subtitle: 'Geocoding Service',
@@ -82,7 +77,6 @@ export const locationNodes: Record<string, INodeTypeDescription> = {
gmaps_nearby_places: {
displayName: 'GMaps Nearby Places',
name: 'gmaps_nearby_places',
- icon: '🔍',
group: ['location', 'service', 'tool'], // 'tool' enables AI Agent tool calling
version: 1,
subtitle: 'Places API nearbySearch',
diff --git a/client/src/nodeDefinitions/processNodes.ts b/client/src/nodeDefinitions/processNodes.ts
index 1bd6305c..6335fc8d 100644
--- a/client/src/nodeDefinitions/processNodes.ts
+++ b/client/src/nodeDefinitions/processNodes.ts
@@ -1,17 +1,13 @@
// Process Manager Node -- start, stop, and manage long-running processes
// Dual-purpose: workflow node AND AI Agent tool
-import {
- INodeTypeDescription,
- NodeConnectionType,
-} from '../types/INodeProperties';
+import { INodeTypeDescription, NodeConnectionType } from '../types/INodeProperties';
import { dracula } from '../styles/theme';
export const processNodes: Record<string, INodeTypeDescription> = {
processManager: {
displayName: 'Process Manager',
name: 'processManager',
- icon: '\u{2699}\u{FE0F}',
group: ['utility', 'tool'],
version: 1,
subtitle: 'Manage Processes',
diff --git a/client/src/nodeDefinitions/proxyNodes.ts b/client/src/nodeDefinitions/proxyNodes.ts
index 2e1c212b..82a54287 100644
--- a/client/src/nodeDefinitions/proxyNodes.ts
+++ b/client/src/nodeDefinitions/proxyNodes.ts
@@ -1,8 +1,5 @@
// Proxy Nodes - Proxy-aware HTTP requests and provider status
-import {
- INodeTypeDescription,
- NodeConnectionType
-} from '../types/INodeProperties';
+import { INodeTypeDescription, NodeConnectionType } from '../types/INodeProperties';
// ============================================================================
// PROXY NODES
@@ -12,7 +9,6 @@ export const proxyNodes: Record<string, INodeTypeDescription> = {
proxyRequest: {
displayName: 'Proxy Request',
name: 'proxyRequest',
- icon: '🛡',
group: ['proxy', 'tool'],
version: 1,
description: 'Make HTTP requests through residential proxy providers with geo-targeting and failover',
@@ -31,7 +27,6 @@ export const proxyNodes: Record<string, INodeTypeDescription> = {
proxyConfig: {
displayName: 'Proxy Config',
name: 'proxyConfig',
- icon: '🔧',
group: ['proxy', 'tool'],
version: 1,
description: 'Configure proxy providers and routing rules. Works as workflow node or AI Agent tool.',
@@ -50,7 +45,6 @@ export const proxyNodes: Record<string, INodeTypeDescription> = {
proxyStatus: {
displayName: 'Proxy Status',
name: 'proxyStatus',
- icon: '📊',
group: ['proxy', 'tool'],
version: 1,
description: 'View proxy provider health, scores, and usage statistics',
diff --git a/client/src/nodeDefinitions/schedulerNodes.ts b/client/src/nodeDefinitions/schedulerNodes.ts
index 414c76d9..f561e117 100644
--- a/client/src/nodeDefinitions/schedulerNodes.ts
+++ b/client/src/nodeDefinitions/schedulerNodes.ts
@@ -6,7 +6,6 @@ export const schedulerNodes: Record<string, INodeTypeDescription> = {
timer: {
displayName: 'Timer',
name: 'timer',
- icon: '⏱️',
group: ['utility', 'workflow', 'tool'],
version: 1,
subtitle: '={{$parameter["duration"]}} {{$parameter["unit"]}}',
@@ -40,7 +39,6 @@ export const schedulerNodes: Record<string, INodeTypeDescription> = {
cronScheduler: {
displayName: 'Cron Scheduler',
name: 'cronScheduler',
- icon: '⏰',
group: ['trigger', 'workflow', 'tool'],
version: 1,
subtitle: '={{$parameter["frequency"]}}',
diff --git a/client/src/nodeDefinitions/searchNodes.ts b/client/src/nodeDefinitions/searchNodes.ts
index efa8e91d..735090f6 100644
--- a/client/src/nodeDefinitions/searchNodes.ts
+++ b/client/src/nodeDefinitions/searchNodes.ts
@@ -1,10 +1,8 @@
// Search API Node Definitions - Brave Search, Serper, Perplexity Sonar
// Dual-purpose nodes: work as standalone workflow nodes AND AI Agent tools
-import {
- INodeTypeDescription,
- NodeConnectionType
-} from '../types/INodeProperties';
-import { BRAVE_SEARCH_ICON, SERPER_ICON, PERPLEXITY_ICON } from '../assets/icons/search';
+import { INodeTypeDescription, NodeConnectionType } from '../types/INodeProperties';
+
+// Wave 10.B: icons resolved from asset:<key> via assets/icons/search/*.svg.
// ============================================================================
// SEARCH NODES
@@ -15,7 +13,6 @@ export const searchNodes: Record<string, INodeTypeDescription> = {
braveSearch: {
displayName: 'Brave Search',
name: 'braveSearch',
- icon: BRAVE_SEARCH_ICON,
group: ['search', 'tool'],
version: 1,
subtitle: 'Web Search',
@@ -49,7 +46,6 @@ export const searchNodes: Record<string, INodeTypeDescription> = {
serperSearch: {
displayName: 'Serper Search',
name: 'serperSearch',
- icon: SERPER_ICON,
group: ['search', 'tool'],
version: 1,
subtitle: 'Google Search',
@@ -83,7 +79,6 @@ export const searchNodes: Record<string, INodeTypeDescription> = {
perplexitySearch: {
displayName: 'Perplexity Search',
name: 'perplexitySearch',
- icon: PERPLEXITY_ICON,
group: ['search', 'tool'],
version: 1,
subtitle: 'AI Search',
diff --git a/client/src/nodeDefinitions/skillNodes.ts b/client/src/nodeDefinitions/skillNodes.ts
index e007184a..8fc65729 100644
--- a/client/src/nodeDefinitions/skillNodes.ts
+++ b/client/src/nodeDefinitions/skillNodes.ts
@@ -1,8 +1,5 @@
// Skill Node Definitions - Skill nodes for Zeenie capabilities
-import {
- INodeTypeDescription,
- NodeConnectionType
-} from '../types/INodeProperties';
+import { INodeTypeDescription, NodeConnectionType } from '../types/INodeProperties';
// ============================================================================
// SKILL NODES - Connect to Zeenie's input-skill handle
@@ -15,7 +12,6 @@ export const skillNodes: Record<string, INodeTypeDescription> = {
masterSkill: {
displayName: 'Master Skill',
name: 'masterSkill',
- icon: '🎯',
group: ['tool'], // Appears in AI Tools category
version: 1,
subtitle: 'Skill Aggregator',
diff --git a/client/src/nodeDefinitions/socialNodes.ts b/client/src/nodeDefinitions/socialNodes.ts
index ca07cf08..8650302f 100644
--- a/client/src/nodeDefinitions/socialNodes.ts
+++ b/client/src/nodeDefinitions/socialNodes.ts
@@ -1,22 +1,10 @@
// Social Node Definitions - Unified social platform messaging
// Supports: WhatsApp, Telegram, Discord, Slack, Signal, SMS, Webchat, Email, Matrix, Teams
-import {
- INodeTypeDescription,
- NodeConnectionType
-} from '../types/INodeProperties';
-
-// ============================================================================
-// SOCIAL ICONS (SVG Data URIs)
-// ============================================================================
-
-// Social Receive - Funnel/filter icon (normalizes messages from platform triggers)
-const SOCIAL_RECEIVE_ICON = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%236366F1'%3E%3Cpath d='M4.25 5.61C6.27 8.2 10 13 10 13v6c0 .55.45 1 1 1h2c.55 0 1-.45 1-1v-6s3.73-4.8 5.75-7.39C20.26 4.95 19.79 4 18.95 4H5.04c-.83 0-1.31.95-.79 1.61z'/%3E%3C/svg%3E";
-
-// Social Send - Paper plane with globe (multi-platform send)
-const SOCIAL_SEND_ICON = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%236366F1'%3E%3Cpath d='M2.01 21L23 12 2.01 3 2 10l15 2-15 2z'/%3E%3Ccircle cx='18' cy='18' r='4' fill='%236366F1' stroke='%23fff' stroke-width='1'/%3E%3Cpath d='M18 15.5c-1.38 0-2.5 1.12-2.5 2.5s1.12 2.5 2.5 2.5 2.5-1.12 2.5-2.5-1.12-2.5-2.5-2.5zm0 1c.28 0 .5.22.5.5v1h1c.28 0 .5.22.5.5s-.22.5-.5.5h-1v1c0 .28-.22.5-.5.5s-.5-.22-.5-.5v-1h-1c-.28 0-.5-.22-.5-.5s.22-.5.5-.5h1v-1c0-.28.22-.5.5-.5z' fill='%23fff'/%3E%3C/svg%3E";
+import { INodeTypeDescription, NodeConnectionType } from '../types/INodeProperties';
// Wave 8: channel + message-type option lists now live in
// SocialReceiveParams / SocialSendParams Pydantic enums.
+// Wave 10.B: node icons resolved from asset:<key> via assets/icons/social/.
// ============================================================================
// SOCIAL NODES
@@ -27,7 +15,6 @@ export const socialNodes: Record<string, INodeTypeDescription> = {
socialReceive: {
displayName: 'Social Receive',
name: 'socialReceive',
- icon: SOCIAL_RECEIVE_ICON,
group: ['social'],
version: 1,
subtitle: 'Normalize Message',
@@ -77,7 +64,6 @@ export const socialNodes: Record<string, INodeTypeDescription> = {
socialSend: {
displayName: 'Social Send',
name: 'socialSend',
- icon: SOCIAL_SEND_ICON,
group: ['social', 'tool'],
version: 1,
subtitle: 'Send Message',
diff --git a/client/src/nodeDefinitions/specializedAgentNodes.ts b/client/src/nodeDefinitions/specializedAgentNodes.ts
index 0a5dcf5c..6ace8620 100644
--- a/client/src/nodeDefinitions/specializedAgentNodes.ts
+++ b/client/src/nodeDefinitions/specializedAgentNodes.ts
@@ -1,9 +1,5 @@
// Specialized Agent Node Definitions - AI Agents with specialized capabilities
-import {
- INodeTypeDescription,
- NodeConnectionType,
- INodeProperties
-} from '../types/INodeProperties';
+import { INodeTypeDescription, NodeConnectionType, INodeProperties } from '../types/INodeProperties';
import { dracula } from '../styles/theme';
import { AI_PROVIDER_OPTIONS } from './aiModelNodes';
@@ -165,7 +161,6 @@ export const specializedAgentNodes: Record<string, INodeTypeDescription> = {
android_agent: {
displayName: 'Android Control Agent',
name: 'android_agent',
- icon: '📱',
group: ['agent', 'ai'],
version: 1,
subtitle: 'Device Control',
@@ -180,7 +175,6 @@ export const specializedAgentNodes: Record<string, INodeTypeDescription> = {
coding_agent: {
displayName: 'Coding Agent',
name: 'coding_agent',
- icon: '💻',
group: ['agent', 'ai'],
version: 1,
subtitle: 'Code Execution',
@@ -195,7 +189,6 @@ export const specializedAgentNodes: Record<string, INodeTypeDescription> = {
web_agent: {
displayName: 'Web Control Agent',
name: 'web_agent',
- icon: '🌐',
group: ['agent', 'ai'],
version: 1,
subtitle: 'Browser Automation',
@@ -210,7 +203,6 @@ export const specializedAgentNodes: Record<string, INodeTypeDescription> = {
task_agent: {
displayName: 'Task Management Agent',
name: 'task_agent',
- icon: '📋',
group: ['agent', 'ai'],
version: 1,
subtitle: 'Task Automation',
@@ -225,7 +217,6 @@ export const specializedAgentNodes: Record<string, INodeTypeDescription> = {
social_agent: {
displayName: 'Social Media Agent',
name: 'social_agent',
- icon: '📱',
group: ['agent', 'ai'],
version: 1,
subtitle: 'Social Messaging',
@@ -240,7 +231,6 @@ export const specializedAgentNodes: Record<string, INodeTypeDescription> = {
travel_agent: {
displayName: 'Travel Agent',
name: 'travel_agent',
- icon: '✈️',
group: ['agent', 'ai'],
version: 1,
subtitle: 'Travel Planning',
@@ -255,7 +245,6 @@ export const specializedAgentNodes: Record<string, INodeTypeDescription> = {
tool_agent: {
displayName: 'Tool Agent',
name: 'tool_agent',
- icon: '🔧',
group: ['agent', 'ai'],
version: 1,
subtitle: 'Tool Orchestration',
@@ -270,7 +259,6 @@ export const specializedAgentNodes: Record<string, INodeTypeDescription> = {
productivity_agent: {
displayName: 'Productivity Agent',
name: 'productivity_agent',
- icon: '⏰',
group: ['agent', 'ai'],
version: 1,
subtitle: 'Productivity',
@@ -285,7 +273,6 @@ export const specializedAgentNodes: Record<string, INodeTypeDescription> = {
payments_agent: {
displayName: 'Payments Agent',
name: 'payments_agent',
- icon: '💳',
group: ['agent', 'ai'],
version: 1,
subtitle: 'Payment Processing',
@@ -300,7 +287,6 @@ export const specializedAgentNodes: Record<string, INodeTypeDescription> = {
consumer_agent: {
displayName: 'Consumer Agent',
name: 'consumer_agent',
- icon: '🛒',
group: ['agent', 'ai'],
version: 1,
subtitle: 'Consumer Support',
@@ -315,7 +301,6 @@ export const specializedAgentNodes: Record<string, INodeTypeDescription> = {
autonomous_agent: {
displayName: 'Autonomous Agent',
name: 'autonomous_agent',
- icon: '🎯',
group: ['agent', 'ai'],
version: 1,
subtitle: 'Autonomous Operations',
@@ -330,7 +315,6 @@ export const specializedAgentNodes: Record<string, INodeTypeDescription> = {
orchestrator_agent: {
displayName: 'Orchestrator Agent',
name: 'orchestrator_agent',
- icon: '🎼',
group: ['agent', 'ai'],
version: 1,
subtitle: 'Agent Coordination',
@@ -349,7 +333,6 @@ export const specializedAgentNodes: Record<string, INodeTypeDescription> = {
ai_employee: {
displayName: 'AI Employee',
name: 'ai_employee',
- icon: '👥',
group: ['agent', 'ai'],
version: 1,
subtitle: 'Team Orchestration',
@@ -368,7 +351,6 @@ export const specializedAgentNodes: Record<string, INodeTypeDescription> = {
rlm_agent: {
displayName: 'RLM Agent',
name: 'rlm_agent',
- icon: '🧠',
group: ['agent', 'ai'],
version: 1,
subtitle: 'Recursive Reasoning',
@@ -383,7 +365,6 @@ export const specializedAgentNodes: Record<string, INodeTypeDescription> = {
claude_code_agent: {
displayName: 'Claude Code Agent',
name: 'claude_code_agent',
- icon: '>/_',
group: ['agent', 'ai'],
version: 1,
subtitle: 'Agentic Coding',
@@ -399,7 +380,6 @@ export const specializedAgentNodes: Record<string, INodeTypeDescription> = {
deep_agent: {
displayName: 'Deep Agent',
name: 'deep_agent',
- icon: '\u{1F9E0}',
group: ['agent', 'ai'],
version: 1,
subtitle: 'LangChain DeepAgents',
diff --git a/client/src/nodeDefinitions/telegramNodes.ts b/client/src/nodeDefinitions/telegramNodes.ts
index 8834479b..06effd8e 100644
--- a/client/src/nodeDefinitions/telegramNodes.ts
+++ b/client/src/nodeDefinitions/telegramNodes.ts
@@ -1,22 +1,11 @@
// Telegram Node Definitions - Messaging integration via python-telegram-bot
-import {
- INodeTypeDescription,
- NodeConnectionType
-} from '../types/INodeProperties';
+import { INodeTypeDescription, NodeConnectionType } from '../types/INodeProperties';
-// ============================================================================
-// TELEGRAM ICONS (SVG Data URIs)
-// ============================================================================
-
-// Telegram Send - Paper plane (send message)
-const TELEGRAM_SEND_ICON = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%230088CC'%3E%3Cpath d='M2.01 21L23 12 2.01 3 2 10l15 2-15 2z'/%3E%3C/svg%3E";
-
-// Telegram Logo - Official Telegram logo (exported for use in credentials/skill nodes)
+// Wave 10.B: node icons resolved from asset:telegram via assets/icons/telegram/.
+// TELEGRAM_LOGO_ICON retained as a data URI export because external consumers
+// (credentials modal, skill editor) still read it directly.
export const TELEGRAM_LOGO_ICON = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%230088CC'%3E%3Cpath d='M11.944 0A12 12 0 0 0 0 12a12 12 0 0 0 12 12 12 12 0 0 0 12-12A12 12 0 0 0 12 0a12 12 0 0 0-.056 0zm4.962 7.224c.1-.002.321.023.465.14a.506.506 0 0 1 .171.325c.016.093.036.306.02.472-.18 1.898-.962 6.502-1.36 8.627-.168.9-.499 1.201-.82 1.23-.696.065-1.225-.46-1.9-.902-1.056-.693-1.653-1.124-2.678-1.8-1.185-.78-.417-1.21.258-1.91.177-.184 3.247-2.977 3.307-3.23.007-.032.014-.15-.056-.212s-.174-.041-.249-.024c-.106.024-1.793 1.14-5.061 3.345-.48.33-.913.49-1.302.48-.428-.008-1.252-.241-1.865-.44-.752-.245-1.349-.374-1.297-.789.027-.216.325-.437.893-.663 3.498-1.524 5.83-2.529 6.998-3.014 3.332-1.386 4.025-1.627 4.476-1.635z'/%3E%3C/svg%3E";
-// Telegram Receive - Notification bell with dot (trigger node)
-const TELEGRAM_RECEIVE_ICON = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%230088CC'%3E%3Cpath d='M12 22c1.1 0 2-.9 2-2h-4c0 1.1.9 2 2 2zm6-6v-5c0-3.07-1.63-5.64-4.5-6.32V4c0-.83-.67-1.5-1.5-1.5s-1.5.67-1.5 1.5v.68C7.64 5.36 6 7.92 6 11v5l-2 2v1h16v-1l-2-2zm-2 1H8v-6c0-2.48 1.51-4.5 4-4.5s4 2.02 4 4.5v6z'/%3E%3Ccircle cx='18' cy='6' r='4'/%3E%3C/svg%3E";
-
// ============================================================================
// TELEGRAM NODES
// ============================================================================
@@ -26,7 +15,6 @@ export const telegramNodes: Record<string, INodeTypeDescription> = {
telegramSend: {
displayName: 'Telegram Send',
name: 'telegramSend',
- icon: TELEGRAM_SEND_ICON,
group: ['social', 'tool'],
version: 1,
subtitle: 'Send Telegram Message',
@@ -67,7 +55,6 @@ export const telegramNodes: Record<string, INodeTypeDescription> = {
telegramReceive: {
displayName: 'Telegram Receive',
name: 'telegramReceive',
- icon: TELEGRAM_RECEIVE_ICON,
group: ['social', 'trigger'],
version: 1,
subtitle: 'On Message Received',
diff --git a/client/src/nodeDefinitions/toolNodes.ts b/client/src/nodeDefinitions/toolNodes.ts
index 7c77e070..5b525f4b 100644
--- a/client/src/nodeDefinitions/toolNodes.ts
+++ b/client/src/nodeDefinitions/toolNodes.ts
@@ -1,9 +1,5 @@
// Tool Node Definitions - Tool nodes for AI Agent tool calling
-import {
- INodeTypeDescription,
- NodeConnectionType,
-} from '../types/INodeProperties';
-import { DUCKDUCKGO_ICON } from '../assets/icons/search';
+import { INodeTypeDescription, NodeConnectionType } from '../types/INodeProperties';
// ============================================================================
// TOOL NODES - Connect to AI Agent's input-tools handle
@@ -14,7 +10,6 @@ export const toolNodes: Record<string, INodeTypeDescription> = {
calculatorTool: {
displayName: 'Calculator Tool',
name: 'calculatorTool',
- icon: '🔢',
group: ['tool', 'ai'],
version: 1,
subtitle: 'Math Operations',
@@ -35,7 +30,6 @@ export const toolNodes: Record<string, INodeTypeDescription> = {
currentTimeTool: {
displayName: 'Current Time Tool',
name: 'currentTimeTool',
- icon: '🕐',
group: ['tool', 'ai'],
version: 1,
subtitle: 'Date & Time',
@@ -56,7 +50,6 @@ export const toolNodes: Record<string, INodeTypeDescription> = {
duckduckgoSearch: {
displayName: 'DuckDuckGo Search',
name: 'duckduckgoSearch',
- icon: DUCKDUCKGO_ICON,
group: ['tool', 'ai'],
version: 1,
subtitle: 'Free Web Search',
@@ -77,7 +70,6 @@ export const toolNodes: Record<string, INodeTypeDescription> = {
taskManager: {
displayName: 'Task Manager',
name: 'taskManager',
- icon: '📋',
group: ['tool', 'ai'],
version: 1,
subtitle: 'Track Delegated Tasks',
@@ -106,7 +98,6 @@ export const toolNodes: Record<string, INodeTypeDescription> = {
writeTodos: {
displayName: 'Write Todos',
name: 'writeTodos',
- icon: '\u{1F4DD}',
group: ['tool', 'ai'],
version: 1,
subtitle: 'Task Planning',
diff --git a/client/src/nodeDefinitions/twitterNodes.ts b/client/src/nodeDefinitions/twitterNodes.ts
index 51eb0039..d9f7e7d8 100644
--- a/client/src/nodeDefinitions/twitterNodes.ts
+++ b/client/src/nodeDefinitions/twitterNodes.ts
@@ -1,22 +1,15 @@
// Twitter/X Node Definitions - X API v2 integration via OAuth 2.0
-import {
- INodeTypeDescription,
- NodeConnectionType
-} from '../types/INodeProperties';
+import { INodeTypeDescription, NodeConnectionType } from '../types/INodeProperties';
// ============================================================================
// TWITTER ICONS (SVG Data URIs) - X Brand black color
// ============================================================================
-// Twitter/X Logo - Official X logo (white fill for dark backgrounds)
+// Wave 10.B: node icons resolved from asset:x via assets/icons/twitter/x.svg.
+// TWITTER_ICON export retained because credentials modal still imports the
+// raw data URI directly (providers.tsx).
export const TWITTER_ICON = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%23FFFFFF'%3E%3Cpath d='M18.244 2.25h3.308l-7.227 8.26 8.502 11.24H16.17l-5.214-6.817L4.99 21.75H1.68l7.73-8.835L1.254 2.25H8.08l4.713 6.231zm-1.161 17.52h1.833L7.084 4.126H5.117z'/%3E%3C/svg%3E";
-// All Twitter nodes use the X logo
-const TWITTER_SEND_ICON = TWITTER_ICON;
-const TWITTER_RECEIVE_ICON = TWITTER_ICON;
-const TWITTER_SEARCH_ICON = TWITTER_ICON;
-const TWITTER_USER_ICON = TWITTER_ICON;
-
// ============================================================================
// TWITTER NODES
// ============================================================================
@@ -26,7 +19,6 @@ export const twitterNodes: Record<string, INodeTypeDescription> = {
twitterSend: {
displayName: 'Twitter Send',
name: 'twitterSend',
- icon: TWITTER_SEND_ICON,
group: ['social', 'tool'],
version: 1,
subtitle: 'Post to Twitter/X',
@@ -65,7 +57,6 @@ export const twitterNodes: Record<string, INodeTypeDescription> = {
twitterReceive: {
displayName: 'Twitter Receive',
name: 'twitterReceive',
- icon: TWITTER_RECEIVE_ICON,
group: ['social', 'trigger'],
version: 1,
subtitle: 'On Twitter Event',
@@ -89,7 +80,6 @@ export const twitterNodes: Record<string, INodeTypeDescription> = {
twitterSearch: {
displayName: 'Twitter Search',
name: 'twitterSearch',
- icon: TWITTER_SEARCH_ICON,
group: ['social', 'tool'],
version: 1,
subtitle: 'Search Tweets',
@@ -127,7 +117,6 @@ export const twitterNodes: Record<string, INodeTypeDescription> = {
twitterUser: {
displayName: 'Twitter User',
name: 'twitterUser',
- icon: TWITTER_USER_ICON,
group: ['social', 'tool'],
version: 1,
subtitle: 'User Operations',
diff --git a/client/src/nodeDefinitions/utilityNodes.ts b/client/src/nodeDefinitions/utilityNodes.ts
index aedf1ab8..7616184d 100644
--- a/client/src/nodeDefinitions/utilityNodes.ts
+++ b/client/src/nodeDefinitions/utilityNodes.ts
@@ -1,14 +1,10 @@
// Utility Nodes - HTTP Request, Webhooks
-import {
- INodeTypeDescription,
- NodeConnectionType
-} from '../types/INodeProperties';
+import { INodeTypeDescription, NodeConnectionType } from '../types/INodeProperties';
export const utilityNodes: Record<string, INodeTypeDescription> = {
httpRequest: {
displayName: 'HTTP Request',
name: 'httpRequest',
- icon: '🌐',
group: ['utility', 'tool'],
version: 1,
description: 'Make HTTP requests to external APIs',
@@ -34,7 +30,6 @@ export const utilityNodes: Record<string, INodeTypeDescription> = {
webhookTrigger: {
displayName: 'Webhook Trigger',
name: 'webhookTrigger',
- icon: '🪝',
group: ['trigger'],
version: 1,
description: 'Start workflow when HTTP request is received',
@@ -55,7 +50,6 @@ export const utilityNodes: Record<string, INodeTypeDescription> = {
webhookResponse: {
displayName: 'Webhook Response',
name: 'webhookResponse',
- icon: '↩️',
group: ['utility'],
version: 1,
description: 'Send response back to webhook caller',
@@ -71,7 +65,6 @@ export const utilityNodes: Record<string, INodeTypeDescription> = {
chatTrigger: {
displayName: 'Chat Trigger',
name: 'chatTrigger',
- icon: '💬',
group: ['utility', 'trigger'],
version: 1,
description: 'Trigger workflow when user sends a chat message from the console input',
@@ -91,7 +84,6 @@ export const utilityNodes: Record<string, INodeTypeDescription> = {
console: {
displayName: 'Console',
name: 'console',
- icon: '🖥️',
group: ['utility'],
version: 1,
description: 'Log data to console panel for debugging during execution',
@@ -110,7 +102,6 @@ export const utilityNodes: Record<string, INodeTypeDescription> = {
teamMonitor: {
displayName: 'Team Monitor',
name: 'teamMonitor',
- icon: '📊',
group: ['utility', 'agent'],
version: 1,
description: 'Monitor agent team operations, tasks, and messages in real-time',
diff --git a/client/src/nodeDefinitions/whatsappNodes.ts b/client/src/nodeDefinitions/whatsappNodes.ts
index c774388e..4769bfc1 100644
--- a/client/src/nodeDefinitions/whatsappNodes.ts
+++ b/client/src/nodeDefinitions/whatsappNodes.ts
@@ -1,8 +1,5 @@
// WhatsApp Node Definitions - Messaging integration via whatsmeow
-import {
- INodeTypeDescription,
- NodeConnectionType
-} from '../types/INodeProperties';
+import { INodeTypeDescription, NodeConnectionType } from '../types/INodeProperties';
import { API_CONFIG } from '../config/api';
// Get WebSocket URL dynamically based on environment
@@ -54,22 +51,11 @@ async function wsRequest(type: string, data: Record<string, unknown> = {}): Prom
});
}
-// ============================================================================
-// WHATSAPP ICONS (SVG Data URIs)
-// ============================================================================
-
-// WhatsApp Send - Paper plane (send message)
-const WHATSAPP_SEND_ICON = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%2325D366'%3E%3Cpath d='M2.01 21L23 12 2.01 3 2 10l15 2-15 2z'/%3E%3C/svg%3E";
-
-// WhatsApp Connect - Official WhatsApp logo (exported for use in skill nodes)
+// Wave 10.B: node icons resolved from asset:whatsapp via
+// assets/icons/whatsapp/whatsapp.svg. WHATSAPP_CONNECT_ICON export
+// retained because the credentials modal reads the raw data URI.
export const WHATSAPP_CONNECT_ICON = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%2325D366'%3E%3Cpath d='M17.472 14.382c-.297-.149-1.758-.867-2.03-.967-.273-.099-.471-.148-.67.15-.197.297-.767.966-.94 1.164-.173.199-.347.223-.644.075-.297-.15-1.255-.463-2.39-1.475-.883-.788-1.48-1.761-1.653-2.059-.173-.297-.018-.458.13-.606.134-.133.298-.347.446-.52.149-.174.198-.298.298-.497.099-.198.05-.371-.025-.52-.075-.149-.669-1.612-.916-2.207-.242-.579-.487-.5-.669-.51-.173-.008-.371-.01-.57-.01-.198 0-.52.074-.792.372-.272.297-1.04 1.016-1.04 2.479 0 1.462 1.065 2.875 1.213 3.074.149.198 2.096 3.2 5.077 4.487.709.306 1.262.489 1.694.625.712.227 1.36.195 1.871.118.571-.085 1.758-.719 2.006-1.413.248-.694.248-1.289.173-1.413-.074-.124-.272-.198-.57-.347m-5.421 7.403h-.004a9.87 9.87 0 01-5.031-1.378l-.361-.214-3.741.982.998-3.648-.235-.374a9.86 9.86 0 01-1.51-5.26c.001-5.45 4.436-9.884 9.888-9.884 2.64 0 5.122 1.03 6.988 2.898a9.825 9.825 0 012.893 6.994c-.003 5.45-4.437 9.884-9.885 9.884m8.413-18.297A11.815 11.815 0 0012.05 0C5.495 0 .16 5.335.157 11.892c0 2.096.547 4.142 1.588 5.945L.057 24l6.305-1.654a11.882 11.882 0 005.683 1.448h.005c6.554 0 11.89-5.335 11.893-11.893a11.821 11.821 0 00-3.48-8.413z'/%3E%3C/svg%3E";
-// WhatsApp Receive - Notification bell with dot (trigger node)
-const WHATSAPP_RECEIVE_ICON = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%2325D366'%3E%3Cpath d='M12 22c1.1 0 2-.9 2-2h-4c0 1.1.9 2 2 2zm6-6v-5c0-3.07-1.63-5.64-4.5-6.32V4c0-.83-.67-1.5-1.5-1.5s-1.5.67-1.5 1.5v.68C7.64 5.36 6 7.92 6 11v5l-2 2v1h16v-1l-2-2zm-2 1H8v-6c0-2.48 1.51-4.5 4-4.5s4 2.02 4 4.5v6z'/%3E%3Ccircle cx='18' cy='6' r='4'/%3E%3C/svg%3E";
-
-// WhatsApp DB - Database icon (query contacts, groups, messages)
-const WHATSAPP_DB_ICON = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%2325D366'%3E%3Cpath d='M12 3C7.58 3 4 4.79 4 7v10c0 2.21 3.58 4 8 4s8-1.79 8-4V7c0-2.21-3.58-4-8-4zm0 2c3.87 0 6 1.5 6 2s-2.13 2-6 2-6-1.5-6-2 2.13-2 6-2zm6 12c0 .5-2.13 2-6 2s-6-1.5-6-2v-2.23c1.61.78 3.72 1.23 6 1.23s4.39-.45 6-1.23V17zm0-4c0 .5-2.13 2-6 2s-6-1.5-6-2v-2.23c1.61.78 3.72 1.23 6 1.23s4.39-.45 6-1.23V13zm0-4c0 .5-2.13 2-6 2s-6-1.5-6-2V6.77C7.61 7.55 9.72 8 12 8s4.39-.45 6-1.23V9z'/%3E%3C/svg%3E";
-
// ============================================================================
// WHATSAPP NODES
// ============================================================================
@@ -79,7 +65,6 @@ export const whatsappNodes: Record<string, INodeTypeDescription> = {
whatsappSend: {
displayName: 'WhatsApp Send',
name: 'whatsappSend',
- icon: WHATSAPP_SEND_ICON,
group: ['whatsapp', 'tool'],
version: 1,
subtitle: 'Send WhatsApp Message',
@@ -113,7 +98,6 @@ export const whatsappNodes: Record<string, INodeTypeDescription> = {
whatsappReceive: {
displayName: 'WhatsApp Receive',
name: 'whatsappReceive',
- icon: WHATSAPP_RECEIVE_ICON,
group: ['whatsapp', 'trigger'],
version: 1,
subtitle: 'On Message Received',
@@ -222,7 +206,6 @@ export const whatsappNodes: Record<string, INodeTypeDescription> = {
whatsappDb: {
displayName: 'WhatsApp DB',
name: 'whatsappDb',
- icon: WHATSAPP_DB_ICON,
group: ['whatsapp', 'tool'],
version: 1,
subtitle: 'Query WhatsApp',
diff --git a/client/src/nodeDefinitions/workflowNodes.ts b/client/src/nodeDefinitions/workflowNodes.ts
index ff03fac3..0e926225 100644
--- a/client/src/nodeDefinitions/workflowNodes.ts
+++ b/client/src/nodeDefinitions/workflowNodes.ts
@@ -1,15 +1,11 @@
// Workflow Control Nodes - Start, triggers, and flow control
-import {
- INodeTypeDescription,
- NodeConnectionType
-} from '../types/INodeProperties';
+import { INodeTypeDescription, NodeConnectionType } from '../types/INodeProperties';
export const workflowNodes: Record<string, INodeTypeDescription> = {
// Start Node - Entry point for workflows
start: {
displayName: 'Start',
name: 'start',
- icon: '▶',
group: ['workflow'],
version: 1,
subtitle: 'Workflow Entry',
@@ -42,7 +38,6 @@ export const workflowNodes: Record<string, INodeTypeDescription> = {
taskTrigger: {
displayName: 'Task Completed',
name: 'taskTrigger',
- icon: '📨',
group: ['trigger', 'workflow'],
version: 1,
subtitle: 'Child Agent Completed',
diff --git a/client/src/types/INodeProperties.ts b/client/src/types/INodeProperties.ts
index 7e265e4e..84490833 100644
--- a/client/src/types/INodeProperties.ts
+++ b/client/src/types/INodeProperties.ts
@@ -212,7 +212,9 @@ export interface INodeUIHints {
export interface INodeTypeDescription {
displayName: string;
name: string;
- icon: string;
+ // Wave 10.B: icon comes from the backend NodeSpec; local
+ // nodeDefinitions/*.ts no longer declare icons.
+ icon?: string;
group: string[];
version: number;
subtitle?: string;
diff --git a/docs-internal/node_creation.md b/docs-internal/node_creation.md
index acf48e2e..12529f1b 100644
--- a/docs-internal/node_creation.md
+++ b/docs-internal/node_creation.md
@@ -9,54 +9,148 @@ This guide explains how to create new nodes for MachinaOs, covering frontend def
---
-## Wave 6 recommended recipe (backend-first)
-
-> **Status:** Wave 6 backend infrastructure shipped on `feature/credentials-scaling-v2`. The frontend feature flag `VITE_NODESPEC_BACKEND` defaults OFF, so the legacy frontend-`nodeDefinitions/*.ts` recipe (sections below) still works. Once Phase 3e flips the flag, **the only authoring location for parameter schemas is the backend**.
-
-For new nodes added today, follow the backend-first recipe — the legacy frontend definition becomes a thin manifest (or vanishes entirely) once the flag flips. You author once on the backend; the frontend renders via the NodeSpec adapter.
-
-### 4-step recipe
-
-1. **Pydantic input model** — declare in [server/models/nodes.py](../server/models/nodes.py):
- ```python
- class MyNodeParams(BaseNodeParams):
- """Parameters for my new node."""
- type: Literal["myNode"]
- operation: Literal["create", "update", "delete"] = "create"
- name: str = Field(default="", json_schema_extra={
- "displayOptions": {"show": {"operation": ["create", "update"]}},
- })
- resource_id: str = Field(
- default="",
- alias="resourceId",
- json_schema_extra={"displayOptions": {"show": {"operation": ["update", "delete"]}}},
- )
- ```
- Use `Field(ge=, le=, alias=, default=)` for constraints and camelCase aliasing. Use `json_schema_extra` for `displayOptions`, `loadOptionsMethod`, `placeholder`, `validation`, `typeOptions` (`password`, `rows`, `editor`, `editorLanguage`, `accept`, `multipleValues`, …).
+## Wave 10 — plugin recipe (canonical)
-2. **Register in the discriminated union** in the same file's `KnownNodeParams = Annotated[Union[...]]`.
+Since Wave 10 the canonical path is **one Python file per node** via the
+`@register_node` plugin pattern. Drop a file in `server/nodes/`; the
+auto-discovery walker in `server/nodes/__init__.py` picks it up at import
+time and writes to the four registries
+(`NODE_METADATA`, `_DIRECT_MODELS`, `NODE_OUTPUT_SCHEMAS`,
+`_HANDLER_REGISTRY`) atomically.
-3. **Pydantic input registry** — add to `_DIRECT_MODELS` in [server/services/node_input_schemas.py](../server/services/node_input_schemas.py):
- ```python
- "myNode": MyNodeParams,
- ```
+**Zero frontend edits.** The backend is SSOT for parameter schemas,
+output schemas, visual metadata (icon / color / handles / componentKind),
+and handlers. See [schema_source_of_truth_rfc.md § Wave 10](./schema_source_of_truth_rfc.md#wave-10--plugin-pattern--visual-contract)
+for the full wire-format reference.
-4. **Display metadata** — add to `NODE_METADATA` in [server/models/node_metadata.py](../server/models/node_metadata.py):
- ```python
- "myNode": {
- "displayName": "My Node",
- "icon": "🔧",
- "group": ["category", "tool"],
- "description": "What this node does",
- "version": 1,
- },
- ```
+### One-file recipe
+
+```python
+# server/nodes/my_node.py
+from typing import Literal
+from pydantic import Field
+from models.nodes import BaseNodeParams
+from services.node_registry import register_node
+
+
+class MyNodeParams(BaseNodeParams):
+ """Parameters for my new node."""
+ type: Literal["myNode"]
+ operation: Literal["create", "update", "delete"] = "create"
+ name: str = Field(
+ default="",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["create", "update"]}}},
+ )
+ resource_id: str = Field(
+ default="", alias="resourceId",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["update", "delete"]}}},
+ )
+ api_key: str | None = Field(
+ default=None, alias="apiKey",
+ json_schema_extra={"password": True}, # masks in UI
+ )
+
+
+async def handle_my_node(node_id, node_type, params, context):
+ # business logic here
+ return {"success": True, "result": {...}}
+
+
+register_node(
+ type="myNode",
+ metadata={
+ "displayName": "My Node",
+ "subtitle": "Short action hint",
+ "icon": "asset:my_icon", # see "Icon wire format" below
+ "color": "#8be9fd", # dracula token or hex
+ "group": ["tool"], # palette-section grouping
+ "componentKind": "square", # React Flow component dispatch
+ "handles": [
+ {"name": "input-main", "kind": "input", "position": "left", "role": "main", "label": "Input"},
+ {"name": "output-main", "kind": "output", "position": "right", "role": "main", "label": "Output"},
+ ],
+ "description": "What this node does",
+ "version": 1,
+ "uiHints": {}, # optional: isToolPanel, hideRunButton, hasCodeEditor, …
+ },
+ input_model=MyNodeParams,
+ handler=handle_my_node,
+)
+```
+
+That's the whole file. Restart the backend — the node appears in the
+editor palette and can be dropped on the canvas. No frontend edit anywhere.
+
+### Icon wire format
+
+Backend `icon:` string uses n8n-style prefix dispatch:
+
+| Format | Source | Example |
+|---|---|---|
+| `asset:<key>` | Filesystem SVG under `client/src/assets/icons/**/*.svg`. `<key>` = filename minus `.svg`. Drop a new SVG into any subfolder — Vite's `import.meta.glob` picks it up automatically. | `asset:gmail` |
+| `<lib>:<brand>` | NPM icon package. `lobehub` is registered today (covers 1400+ AI/SaaS brands). Adding a second library = 3-line addition to `ICON_LIBRARIES` in `client/src/assets/icons/index.ts`. | `lobehub:claude` |
+| `data:` / `http(s)://` / `/…` | URL passthrough | `data:image/svg+xml,…` |
+| plain text | emoji / short label | `🔧` |
-That's it. The NodeSpec auto-emits at `GET /api/schemas/nodes/myNode/spec.json` with the full parameter contract, validation rules, conditional visibility, and dynamic option routing. The output schema (Wave 3) is a separate Pydantic model in [server/services/node_output_schemas.py](../server/services/node_output_schemas.py) registered in `NODE_OUTPUT_SCHEMAS`.
+Pytest invariant `test_every_asset_icon_has_matching_svg` fails CI if you
+reference an `asset:<key>` that doesn't exist.
+
+### componentKind dispatch
+
+Tells the Dashboard which React component renders the node:
+
+| componentKind | Component | When to use |
+|---|---|---|
+| `square` | `SquareNode` | Default for most data / tool / service nodes |
+| `trigger` | `TriggerNode` | Nodes with only an output handle that emit events |
+| `start` | `StartNode` | The workflow Start node (special visual treatment) |
+| `agent` | `AIAgentNode` | LangGraph-style agents (accepts skill/tool/memory/task inputs) |
+| `chat` | `AIAgentNode` | Conversational chat agents |
+| `tool` | `SquareNode` | Passive tool nodes with `uiHints.isToolPanel` for ToolSchemaEditor |
+| `model` | `ModelNode` | AI chat model configuration nodes |
+
+### uiHints catalogue
+
+Every panel-visibility decision reads from `uiHints`:
+
+- `hideInputSection` / `hideOutputSection` / `hideRunButton` — panel chrome toggles
+- `hasCodeEditor` — renders the code-editor layout (Python / JS / TS)
+- `hasSkills` — shows Connected Skills accordion (required for all `componentKind:"agent"`)
+- `isToolPanel` — shows Tool Schema Editor (required for all `componentKind:"tool"`)
+- `isMasterSkillEditor` — shows Master Skill split-panel editor
+- `isMemoryPanel` — shows Memory window-size + token-usage panel
+- `isMonitorPanel` — shows Team Monitor live display
+- `isChatTrigger` / `isConsoleSink` — wires to ConsolePanel tabs
+- `showLocationPanel` — shows Google Maps picker
+- `isAndroidToolkit` — shows ToolSchemaEditor gated on Android service sub-nodes
+- `width` / `height` — explicit canvas node size (overrides defaults)
+
+### Dynamic option loaders
+
+For fields needing fetched-at-edit-time options (Gmail labels, WhatsApp groups, …):
+
+1. Write an async loader in `server/services/node_option_loaders/`.
+2. Register in `LOAD_OPTIONS_REGISTRY` (one line).
+3. On the Pydantic field: `json_schema_extra={"loadOptionsMethod": "myMethodName"}`.
+
+The frontend's generic `load_options` WS dispatcher populates the dropdown.
+
+### Output schemas
+
+For nodes whose runtime output the frontend should show in the Input panel:
+pass `output_model=MyOutput` to `register_node(...)`. Matches the Wave 3
+pattern — see [schema_source_of_truth_rfc.md](./schema_source_of_truth_rfc.md).
+
+---
-### Backend handler
+## Legacy backend-only recipe (pre-Wave-10)
-The handler in `server/services/handlers/` and registry entry in [server/services/node_executor.py](../server/services/node_executor.py) `_build_handler_registry()` are unchanged from the legacy recipe — still required, see [Backend: Workflow Handler](#backend-workflow-handler) below.
+Before Wave 10 the recipe spread across 5+ files
+(`models/nodes.py` + `KnownNodeParams` union + `_DIRECT_MODELS` dict +
+`NODE_METADATA` dict + `node_executor` handler registry). The plugin
+pattern above replaces all of that with one file — but the individual
+registries are still live and accept direct entries if you prefer
+the explicit pattern.
### Dynamic option loaders
diff --git a/docs-internal/schema_source_of_truth_rfc.md b/docs-internal/schema_source_of_truth_rfc.md
index 4595d156..f8ffe309 100644
--- a/docs-internal/schema_source_of_truth_rfc.md
+++ b/docs-internal/schema_source_of_truth_rfc.md
@@ -1,6 +1,6 @@
# Schema source of truth — RFC
-**Status:** ✅ **implemented + extended to NodeSpec** · **Owner:** frontend + backend platform · **Original landing:** 2026-04-14 (output schemas) · **Wave 6 extension:** 2026-04-15+ (full NodeSpec contract)
+**Status:** ✅ **implemented + extended to full plugin registry** · **Owner:** frontend + backend platform · **Landing:** 2026-04-14 (output schemas) → **Wave 6** (NodeSpec contract) → **Wave 10** (plugin pattern + visual contract + icons, 2026-04-15)
## Landed outcome (Wave 3 — output schemas)
@@ -156,11 +156,132 @@ Phase 6 (`ParameterRenderer` → DIY widget registry) was blocked on the backend
- Build-time codegen of TypeScript types from the backend schemas (Nango's pattern) — deferred. The frontend reads schemas as plain JSON; typed inference on top would be nice-to-have but isn't load-bearing.
- Versioning of schemas per node-type version — deferred. All current node types are v1; add `{version}` to the URL path the first time we bump.
+## Wave 10 — plugin pattern + visual contract
+
+Wave 6 made the backend authoritative for node schemas. Wave 10 closed the
+remaining tribal-code paths so **adding a new node = one Python file, zero
+frontend edits**.
+
+### 10.A — Visual contract extended
+
+`NodeMetadata` TypedDict in [server/models/node_metadata.py](../server/models/node_metadata.py)
+gains the fields the frontend previously hardcoded:
+
+- `color` (hex / dracula token)
+- `componentKind` (`square` / `circle` / `trigger` / `start` / `agent` / `chat` / `tool` / `model` / `generic`)
+- `handles: NodeHandle[]` — full React Flow topology (replaces the 400-line
+ `AGENT_CONFIGS` map in `AIAgentNode.tsx`)
+- `credentials`, `hideOutputHandle`, `visibility`
+
+Each field flows through `get_node_spec()` into the `/api/schemas/nodes/{type}/spec.json`
+envelope, so every consumer (React Flow dispatch, parameter panel, palette)
+reads from one source.
+
+### 10.C — `@register_node` decorator
+
+[server/services/node_registry.register_node(...)](../server/services/node_registry.py)
+writes to four registries atomically: `NODE_METADATA`, `_DIRECT_MODELS`,
+`NODE_OUTPUT_SCHEMAS`, `_HANDLER_REGISTRY`. `server/nodes/__init__.py` walks
+`server/nodes/*.py` submodules at import time via `pkgutil.iter_modules`,
+so plugin registration is side-effect at startup. 106/111 node types migrated
+to this path (the remaining 5 are output-only legacy aliases).
+
+**New node checklist (post-Wave-10):**
+
+```python
+# server/nodes/my_node.py
+from typing import Literal
+from pydantic import Field
+from models.nodes import BaseNodeParams
+from services.node_registry import register_node
+
+class MyParams(BaseNodeParams):
+ type: Literal["myNode"]
+ query: str = Field(default="", json_schema_extra={"placeholder": "Search..."})
+
+async def handle_my_node(node_id, node_type, params, context):
+ return {"success": True, "result": {...}}
+
+register_node(
+ type="myNode",
+ metadata={
+ "displayName": "My Node",
+ "icon": "asset:my_icon", # or "lobehub:<brand>" or emoji
+ "group": ["tool"],
+ "color": "#8be9fd",
+ "componentKind": "square",
+ "handles": [...], # full topology
+ "description": "...",
+ "version": 1,
+ },
+ input_model=MyParams,
+ handler=handle_my_node,
+)
+```
+
+Zero edits elsewhere.
+
+### 10.B — Icon wire format + resolver
+
+Backend icons follow n8n's prefix-dispatch convention. The resolver at
+[client/src/assets/icons/index.ts](../client/src/assets/icons/index.ts)
+handles every source:
+
+| Prefix | Source | Example |
+|---|---|---|
+| `asset:<key>` | Filesystem SVG; Vite `import.meta.glob` over `client/src/assets/icons/**/*.svg`. Key is filename minus `.svg`. | `asset:gmail` |
+| `<lib>:<brand>` | NPM icon package. `ICON_LIBRARIES` dispatch table with `lobehub` registered. Case-insensitive brand lookup — names come from the package's own exports. | `lobehub:claude` |
+| `data:` / `http(s)://` / `/…` | URL passthrough | — |
+| plain text | emoji / short label | `🤖` |
+
+Frontend consumers call `resolveLibraryIcon(icon)` first (returns a React
+component) then `resolveIcon(icon)` (returns string / data URI). Consumers
+use the `useNodeSpec(type)` reactive hook so icons populate the moment the
+prefetch lands. **No frontend fallbacks**: a missing icon is a backend bug,
+not something to mask.
+
+Group-palette metadata follows the same pattern via
+[server/nodes/groups.py](../server/nodes/groups.py): 25 palette groups each
+declaring `{label, icon, color, visibility}`. Retires the frontend's
+`CATEGORY_ICONS` / `labelMap` / `colorMap` / `SIMPLE_MODE_CATEGORIES` tables.
+
+### 10.G — Parameter panel fully spec-driven
+
+- `ParameterRenderer.tsx` gains `case 'code'` + `case 'dateTime'` + generic
+ `loadOptionsMethod` dispatch via the backend `load_options` WS handler
+ (unlocking the 4 Google Workspace dynamic-option loaders that were
+ previously unreachable). `displayOptions.show` now propagates into nested
+ `fixedCollection` renders. Password masking wins over multi-row textarea.
+- `MiddleSection` / `InputSection` / `SquareNode` / `ParameterPanel` retire
+ the last 14 hardcoded type-array fallbacks (`TRIGGER_NODE_TYPES`,
+ `AGENT_WITH_SKILLS_TYPES`, `SKILL_NODE_TYPES`, etc.). Every widget
+ decision reads a uiHint or handle-topology fact declared by the node's
+ own plugin module.
+- `nodeDefinitions/*.ts` files strip every `icon:` field (−272 LOC) —
+ backend is sole declaration site. `INodeTypeDescription.icon` narrowed
+ to `icon?: string`.
+
+### Contract invariants (108 pytest in `tests/test_node_spec.py`)
+
+`TestWave10GContractInvariants` enforces:
+
+- every agent-kind node has `uiHints.hasSkills`
+- every tool-kind node has `uiHints.isToolPanel`
+- every Google Workspace node has a field gated by
+ `displayOptions.show.operation`
+- every code executor emits `editor: "code"` on its `code` field
+- every `api_key` / `apiKey` field emits `password: True`
+- every `asset:<key>` icon resolves to a real SVG under
+ `client/src/assets/icons/`
+- every palette group carries non-empty label + icon
+
## References
- [n8n `schemaPreview.api.ts`](https://github.com/n8n-io/n8n/blob/master/packages/frontend/editor-ui/src/features/ndv/runData/schemaPreview.api.ts)
- [n8n `VirtualSchema.vue`](https://github.com/n8n-io/n8n/blob/master/packages/frontend/editor-ui/src/features/ndv/runData/components/VirtualSchema.vue)
- [n8n `nodeTypes.store.ts`](https://github.com/n8n-io/n8n/blob/master/packages/frontend/editor-ui/src/app/stores/nodeTypes.store.ts)
+- [n8n node-icon conventions](https://docs.n8n.io/integrations/creating-nodes/build/reference/node-base-files/icons/) — `file:` + `fa:` prefix-dispatch which Wave 10.B generalises
- [Activepieces `piece-metadata.ts`](https://github.com/activepieces/activepieces/blob/main/packages/pieces/framework/src/lib/piece-metadata.ts)
- [Activepieces `action.ts`](https://github.com/activepieces/activepieces/blob/main/packages/pieces/framework/src/lib/action/action.ts)
- [Nango `nangoYaml/index.ts`](https://github.com/NangoHQ/nango/blob/master/packages/types/lib/nangoYaml/index.ts)
+- [@lobehub/icons](https://github.com/lobehub/lobe-icons) — the default `<lib>:<brand>` target for AI provider brand logos
diff --git a/docs-internal/ui_migration_plan.md b/docs-internal/ui_migration_plan.md
index 97d34250..4bca2572 100644
--- a/docs-internal/ui_migration_plan.md
+++ b/docs-internal/ui_migration_plan.md
@@ -177,13 +177,52 @@ Per the user directive: **"frontend is just UI and backend has all the business
| Item | Status | Notes |
|---|---|---|
-| Backend NODE_METADATA icon/displayName backfill | 🟡 in progress | 35 entries currently have empty `icon` for SVG-only frontend icons; nodes render with same blank icon when flag is ON. Fix is to populate emoji fallbacks + revisit SVG asset hosting strategy. |
-| `aiModelNodes.ts` factory refactor | ⏸ deferred | Uses `createBaseChatModel(config)` factory; `properties` array built inside the factory. Slimming requires moving the factory to the backend or converting to direct definitions. |
-| `ParameterRenderer.tsx` → DIY widget registry | ⏸ deferred | 2158-line file with 19 switch cases + closure-captured state. Needs a focused multi-session surgical refactor with per-widget unit tests. |
-| Narrow `INodeTypeDescription.properties` to optional | ⏸ deferred | Depends on widget registry. |
-| Delete `adapters/nodeSpecToDescription.ts` | ⏸ deferred | Depends on `INodeTypeDescription` narrowed to NodeSpec shape. |
+| Backend NODE_METADATA icon/displayName backfill | ✅ done in Wave 10.B | Migrated to prefix-dispatched icon wire format (`asset:` / `lobehub:` / URL / emoji) so no empty slots remain. |
+| `aiModelNodes.ts` factory refactor | ✅ done in Wave 9.2 | `createBaseChatModel` slimmed to visual metadata; schema lives on backend in `AIChatModelParams`. |
+| `ParameterRenderer.tsx` → widget registry | 🟡 partial (Wave 10.G.1) | `case 'code'` / `'dateTime'` added, generic `loadOptionsMethod` dispatch wired, `displayOptions.show` propagates into `fixedCollection` nesting, password masking beats textarea. Full DIY widget registry still deferred. |
+| Narrow `INodeTypeDescription.properties` | ✅ done in Wave 10.B | `icon` also narrowed to optional; backend is sole declaration site. |
+| Delete `adapters/nodeSpecToDescription.ts` | ⏸ deferred | Adapter is thin (~230 LOC), justified as JSON-Schema→INodeProperties bridge. Sunset still optional. |
| Telegram/Twitter loadOptions loaders | ⏸ deferred | Limited value (Telegram bots have no chat-list API; Twitter lists need significant setup). |
+## Wave 10 — plugin pattern + full visual SSOT (April 2026)
+
+Wave 10 closes the tribal-code paths that survived Wave 6-9. **Adding a new
+node is now one Python file** with a single `register_node(...)` call —
+zero frontend edits, zero cross-cutting backend edits.
+
+Full detail: [schema_source_of_truth_rfc.md § Wave 10](./schema_source_of_truth_rfc.md#wave-10--plugin-pattern--visual-contract).
+
+| Sub-wave | What it delivers | Impact |
+|---|---|---|
+| 10.A — `NodeMetadata` extended | + `color`, `componentKind`, `handles`, `credentials`, `hideOutputHandle`, `visibility` fields | Retires the 400-line `AGENT_CONFIGS` map in `AIAgentNode.tsx` + frontend `NO_OUTPUT_NODE_TYPES` / `SIMPLE_MODE_CATEGORIES` tables |
+| 10.B — Icon wire format | n8n-style prefix dispatch: `asset:<key>` (Vite glob) / `<lib>:<brand>` (NPM icon packages via `ICON_LIBRARIES` table) / `data:` / `http://` / emoji. `useNodeSpec(type)` reactive hook so icons populate the moment prefetch lands. | Drops 272 LOC of `icon:` declarations from 26 `nodeDefinitions/*.ts` files; retires frontend `CATEGORY_ICONS` / `labelMap` / `colorMap` tables |
+| 10.C — `@register_node` decorator + plugin auto-discovery | `server/nodes/__init__.py` walks submodules; `register_node` writes to `NODE_METADATA` + `_DIRECT_MODELS` + `NODE_OUTPUT_SCHEMAS` + `_HANDLER_REGISTRY` atomically. 106/111 node types migrated. | New node checklist: 1 file |
+| 10.D — Dashboard `createNodeTypes` collapsed to `componentKind` dispatch | Retires 17 `*_NODE_TYPES` imports; `AIAgentNode` reads handle topology from spec; `nodeTypesRef` rebuilds once on prefetch completion | −400 LOC in `AIAgentNode.tsx`, −120 in `Dashboard.tsx` |
+| 10.E — 14 frontend type arrays retired | `SquareNode` / `ParameterRenderer` / `executionService` / `useDragAndDrop` / `MiddleSection` / `InputSection` all read from `getCachedNodeSpec()` instead of hardcoded arrays | isNodeTypeSupported collapses to spec lookup + fallback |
+| 10.G — Parameter panel fully spec-driven | `case 'code'` + `case 'dateTime'` handlers, generic backend `load_options` WS dispatch for the 4 Google Workspace loaders, `displayOptions.show` into nested collections, password-masking over textarea, `hasSkills`/`isToolPanel`/`isMasterSkillEditor`/`isMemoryPanel` uiHints on plugin registrations. **Zero frontend emoji fallbacks** — a missing icon surfaces as empty so the backend authoring gap is visible. | Retires 3 tribal arrays (`AGENT_WITH_SKILLS_TYPES`, `TOOL_NODE_TYPES`, `SKILL_NODE_TYPES`) from `MiddleSection.tsx` |
+
+**Wave 10 numbers:**
+- Backend: 108/108 pytest (was 94 pre-Wave-10; +14 invariants lock the plugin contract). `+server/nodes/` directory (agents.py + triggers.py + tools.py + utilities.py + services.py + groups.py). 785-LOC legacy `NODE_METADATA` dict literal in `models/node_metadata.py` deleted — populated at import time by plugins.
+- Frontend: `−272 LOC` across 26 `nodeDefinitions/*.ts` files (all `icon:` declarations + SVG imports stripped). `INodeTypeDescription.icon` narrowed to `icon?: string`.
+- Total commits: 17 on `feature/credentials-scaling-v2` past the Wave 9 marker.
+
+**New contract invariants (pytest):**
+- Every plugin node has `componentKind`, non-empty `color`, ≥1 handle
+- Every agent node has `uiHints.hasSkills`
+- Every tool-kind node has `uiHints.isToolPanel`
+- Every Google Workspace node has a field gated by `displayOptions.show.operation`
+- Every code executor emits `editor: "code"` on its `code` field
+- Every `api_key` field emits `password: True`
+- Every `asset:<key>` icon resolves to a real SVG under `client/src/assets/icons/`
+- Every palette group carries non-empty label + icon
+
+**Architectural delta (permanent):** the backend plugin registry is the
+single source of truth for node declaration — Pydantic params, output
+schema, handler, visual metadata (icon / color / handles / componentKind),
+palette-section metadata, and dynamic-option loaders. The frontend is a
+thin renderer that dispatches on `componentKind` and resolves icons via
+a shared `resolveIcon` + `resolveLibraryIcon` pair.
+
**Wave 6 numbers (14 commits across this wave):**
- Backend: 105 Pydantic input models (started 67, +57%), 105 NODE_METADATA entries (started 0), 110 total NodeSpecs (every registered node type), 3 dynamic-option loaders wired, 25 node groups derived. 63/63 pytest cases pass.
- Frontend: 3 new files (featureFlags.ts, nodeSpec.ts, adapters/nodeSpecToDescription.ts) — all inline-colocated per the design-system "no speculative scaffolding" principle. Zero new hook files.
diff --git a/server/config/credential_providers.json b/server/config/credential_providers.json
index a676ba7e..1d629ac0 100644
--- a/server/config/credential_providers.json
+++ b/server/config/credential_providers.json
@@ -36,7 +36,7 @@
"extends": "_ai_base",
"name": "OpenAI",
"color": "dracula.green",
- "icon_ref": "ai:openai",
+ "icon_ref": "lobehub:openai",
"fields": [
{ "key": "apiKey", "placeholder": "sk-..." }
]
@@ -45,7 +45,7 @@
"extends": "_ai_base",
"name": "Anthropic",
"color": "dracula.orange",
- "icon_ref": "ai:anthropic",
+ "icon_ref": "lobehub:claude",
"fields": [
{ "key": "apiKey", "placeholder": "sk-ant-..." }
]
@@ -54,7 +54,7 @@
"extends": "_ai_base",
"name": "Gemini",
"color": "solarized.blue",
- "icon_ref": "ai:gemini",
+ "icon_ref": "lobehub:gemini",
"fields": [
{ "key": "apiKey", "placeholder": "AIza..." }
]
@@ -63,7 +63,7 @@
"extends": "_ai_base",
"name": "Groq",
"color": "dracula.red",
- "icon_ref": "ai:groq",
+ "icon_ref": "lobehub:groq",
"fields": [
{ "key": "apiKey", "placeholder": "gsk_..." }
]
@@ -72,7 +72,7 @@
"extends": "_ai_base",
"name": "Cerebras",
"color": "dracula.orange",
- "icon_ref": "ai:cerebras",
+ "icon_ref": "lobehub:cerebras",
"fields": [
{ "key": "apiKey", "placeholder": "csk-..." }
]
@@ -81,7 +81,7 @@
"extends": "_ai_base",
"name": "OpenRouter",
"color": "solarized.violet",
- "icon_ref": "ai:openrouter",
+ "icon_ref": "lobehub:openrouter",
"fields": [
{ "key": "apiKey", "placeholder": "sk-or-..." }
]
@@ -90,7 +90,7 @@
"extends": "_ai_base",
"name": "DeepSeek",
"color": "dracula.cyan",
- "icon_ref": "ai:deepseek",
+ "icon_ref": "lobehub:deepseek",
"fields": [
{ "key": "apiKey", "placeholder": "sk-..." }
]
@@ -99,14 +99,14 @@
"extends": "_ai_base",
"name": "Kimi",
"color": "dracula.purple",
- "icon_ref": "ai:kimi",
+ "icon_ref": "lobehub:kimi",
"fields": [
{ "key": "apiKey", "placeholder": "sk-..." }
]
},
"mistral": {
"extends": "_ai_base",
- "icon_ref": "ai:mistral",
+ "icon_ref": "lobehub:mistral",
"name": "Mistral",
"color": "dracula.pink",
"fields": [
@@ -120,7 +120,7 @@
"category_label": "Social Media",
"color": "theme.categoryWhatsapp",
"kind": "qrPairing",
- "icon_ref": "data_uri:WHATSAPP_CONNECT_ICON",
+ "icon_ref": "asset:whatsapp",
"status_hook": "whatsapp",
"has_rate_limits": true,
"status_rows": [
@@ -151,7 +151,7 @@
"category_label": "Social Media",
"color": "theme.categoryTrigger",
"kind": "oauth",
- "icon_ref": "data_uri:TWITTER_ICON",
+ "icon_ref": "asset:x",
"status_hook": "twitter",
"usage_service": "twitter",
"ws": {
@@ -185,7 +185,7 @@
"category_label": "Social Media",
"color": "theme.categoryChat",
"kind": "oauth",
- "icon_ref": "raw_svg:TelegramIcons.telegram",
+ "icon_ref": "asset:telegram",
"status_hook": "telegram",
"ws": {
"login": "telegram_connect",
@@ -211,7 +211,7 @@
"category_label": "Productivity",
"color": "theme.categoryAI",
"kind": "oauth",
- "icon_ref": "raw_svg:GoogleIcons.gmail",
+ "icon_ref": "asset:gmail",
"status_hook": "google",
"usage_service": "google_workspace",
"ws": {
@@ -246,7 +246,7 @@
"category_label": "Email",
"color": "theme.categoryChat",
"kind": "email",
- "icon_ref": "raw_svg:EmailIcons.read"
+ "icon_ref": "asset:read"
},
"android_remote": {
@@ -255,7 +255,7 @@
"category_label": "Android",
"color": "theme.categoryAndroid",
"kind": "qrPairing",
- "icon_ref": "emoji:📱",
+ "icon_ref": "📱",
"status_hook": "android",
"fields": [
{
@@ -306,7 +306,7 @@
"category_label": "Search",
"color": "theme.categoryLocation",
"kind": "apiKey",
- "icon_ref": "raw_svg:SearchIcons.brave",
+ "icon_ref": "asset:brave",
"fields": [
{
"key": "apiKey",
@@ -325,7 +325,7 @@
"category_label": "Search",
"color": "theme.categoryUtil",
"kind": "apiKey",
- "icon_ref": "raw_svg:SearchIcons.perplexity",
+ "icon_ref": "asset:perplexity",
"fields": [
{
"key": "apiKey",
@@ -344,7 +344,7 @@
"category_label": "Scrapers",
"color": "theme.categoryAI",
"kind": "apiKey",
- "icon_ref": "raw_svg:ApifyIcons.apify",
+ "icon_ref": "asset:apify",
"validate_as": "apify",
"fields": [
{
@@ -364,7 +364,7 @@
"category_label": "Scrapers",
"color": "theme.categoryAI",
"kind": "apiKey",
- "icon_ref": "raw_svg:SearchIcons.serper",
+ "icon_ref": "asset:google",
"fields": [
{
"key": "apiKey",
@@ -382,7 +382,7 @@
"category_label": "Services",
"color": "theme.categoryLocation",
"kind": "apiKey",
- "icon_ref": "emoji:🗺️",
+ "icon_ref": "🗺️",
"validate_as": "google_maps",
"usage_service": "google_maps",
"fields": [
diff --git a/server/config/model_registry.json b/server/config/model_registry.json
index 2048c2ae..e103173c 100644
--- a/server/config/model_registry.json
+++ b/server/config/model_registry.json
@@ -1,8 +1,34 @@
{
- "_generated": "2026-04-12T22:46:31.828259+00:00",
+ "_generated": "2026-04-13T23:09:24.941879+00:00",
"_source": "openrouter",
- "_model_count": 349,
+ "_model_count": 350,
"models": {
+ "openrouter/elephant-alpha": {
+ "id": "openrouter/elephant-alpha",
+ "name": "Elephant",
+ "provider": "openrouter",
+ "local_id": "elephant-alpha",
+ "context_length": 262144,
+ "max_output_tokens": 32768,
+ "input_price_per_mtok": 0.0,
+ "output_price_per_mtok": 0.0,
+ "supports_thinking": false,
+ "thinking_type": "none",
+ "temperature_range": [
+ 0.0,
+ 2.0
+ ],
+ "is_reasoning_model": false,
+ "supported_parameters": [
+ "max_tokens",
+ "response_format",
+ "structured_outputs",
+ "temperature",
+ "tool_choice",
+ "tools",
+ "top_p"
+ ]
+ },
"anthropic/claude-opus-4.6-fast": {
"id": "anthropic/claude-opus-4.6-fast",
"name": "Anthropic: Claude Opus 4.6 (Fast)",
@@ -56,8 +82,10 @@
"logprobs",
"max_tokens",
"min_p",
+ "parallel_tool_calls",
"presence_penalty",
"reasoning",
+ "reasoning_effort",
"repetition_penalty",
"response_format",
"seed",
@@ -105,9 +133,9 @@
"provider": "gemini",
"local_id": "gemma-4-26b-a4b-it",
"context_length": 262144,
- "max_output_tokens": 262144,
- "input_price_per_mtok": 0.12,
- "output_price_per_mtok": 0.4,
+ "max_output_tokens": 0,
+ "input_price_per_mtok": 0.08,
+ "output_price_per_mtok": 0.35,
"supports_thinking": false,
"thinking_type": "none",
"temperature_range": [
@@ -119,7 +147,9 @@
"frequency_penalty",
"include_reasoning",
"logit_bias",
+ "logprobs",
"max_tokens",
+ "min_p",
"presence_penalty",
"reasoning",
"repetition_penalty",
@@ -131,6 +161,7 @@
"tool_choice",
"tools",
"top_k",
+ "top_logprobs",
"top_p"
]
},
@@ -168,9 +199,9 @@
"provider": "gemini",
"local_id": "gemma-4-31b-it",
"context_length": 262144,
- "max_output_tokens": 131072,
- "input_price_per_mtok": 0.14,
- "output_price_per_mtok": 0.4,
+ "max_output_tokens": 0,
+ "input_price_per_mtok": 0.13,
+ "output_price_per_mtok": 0.38,
"supports_thinking": false,
"thinking_type": "none",
"temperature_range": [
@@ -183,6 +214,7 @@
"include_reasoning",
"logit_bias",
"max_tokens",
+ "min_p",
"presence_penalty",
"reasoning",
"repetition_penalty",
@@ -526,8 +558,8 @@
"name": "MiniMax: MiniMax M2.7",
"provider": "minimax",
"local_id": "minimax-m2.7",
- "context_length": 204800,
- "max_output_tokens": 131072,
+ "context_length": 196608,
+ "max_output_tokens": 0,
"input_price_per_mtok": 0.3,
"output_price_per_mtok": 1.2,
"supports_thinking": false,
@@ -538,13 +570,23 @@
],
"is_reasoning_model": false,
"supported_parameters": [
+ "frequency_penalty",
"include_reasoning",
+ "logit_bias",
+ "logprobs",
"max_tokens",
+ "min_p",
+ "presence_penalty",
"reasoning",
+ "repetition_penalty",
"response_format",
+ "stop",
+ "structured_outputs",
"temperature",
"tool_choice",
"tools",
+ "top_k",
+ "top_logprobs",
"top_p"
]
},
@@ -1642,6 +1684,7 @@
"min_p",
"presence_penalty",
"reasoning",
+ "reasoning_effort",
"repetition_penalty",
"response_format",
"seed",
@@ -5338,7 +5381,6 @@
"response_format",
"seed",
"stop",
- "structured_outputs",
"temperature",
"tool_choice",
"tools",
@@ -9009,11 +9051,11 @@
"top_p"
]
},
- "inflection/inflection-3-pi": {
- "id": "inflection/inflection-3-pi",
- "name": "Inflection: Inflection 3 Pi",
+ "inflection/inflection-3-productivity": {
+ "id": "inflection/inflection-3-productivity",
+ "name": "Inflection: Inflection 3 Productivity",
"provider": "inflection",
- "local_id": "inflection-3-pi",
+ "local_id": "inflection-3-productivity",
"context_length": 8000,
"max_output_tokens": 1024,
"input_price_per_mtok": 2.5,
@@ -9032,11 +9074,11 @@
"top_p"
]
},
- "inflection/inflection-3-productivity": {
- "id": "inflection/inflection-3-productivity",
- "name": "Inflection: Inflection 3 Productivity",
+ "inflection/inflection-3-pi": {
+ "id": "inflection/inflection-3-pi",
+ "name": "Inflection: Inflection 3 Pi",
"provider": "inflection",
- "local_id": "inflection-3-productivity",
+ "local_id": "inflection-3-pi",
"context_length": 8000,
"max_output_tokens": 1024,
"input_price_per_mtok": 2.5,
@@ -9091,36 +9133,6 @@
"top_p"
]
},
- "meta/llama-3.2-11b-vision-instruct": {
- "id": "meta-llama/llama-3.2-11b-vision-instruct",
- "name": "Meta: Llama 3.2 11B Vision Instruct",
- "provider": "meta",
- "local_id": "llama-3.2-11b-vision-instruct",
- "context_length": 131072,
- "max_output_tokens": 16384,
- "input_price_per_mtok": 0.245,
- "output_price_per_mtok": 0.245,
- "supports_thinking": false,
- "thinking_type": "none",
- "temperature_range": [
- 0.0,
- 2.0
- ],
- "is_reasoning_model": false,
- "supported_parameters": [
- "frequency_penalty",
- "max_tokens",
- "min_p",
- "presence_penalty",
- "repetition_penalty",
- "response_format",
- "seed",
- "stop",
- "temperature",
- "top_k",
- "top_p"
- ]
- },
"meta/llama-3.2-3b-instruct:free": {
"id": "meta-llama/llama-3.2-3b-instruct:free",
"name": "Meta: Llama 3.2 3B Instruct (free)",
@@ -9201,6 +9213,36 @@
"top_p"
]
},
+ "meta/llama-3.2-11b-vision-instruct": {
+ "id": "meta-llama/llama-3.2-11b-vision-instruct",
+ "name": "Meta: Llama 3.2 11B Vision Instruct",
+ "provider": "meta",
+ "local_id": "llama-3.2-11b-vision-instruct",
+ "context_length": 131072,
+ "max_output_tokens": 16384,
+ "input_price_per_mtok": 0.245,
+ "output_price_per_mtok": 0.245,
+ "supports_thinking": false,
+ "thinking_type": "none",
+ "temperature_range": [
+ 0.0,
+ 2.0
+ ],
+ "is_reasoning_model": false,
+ "supported_parameters": [
+ "frequency_penalty",
+ "max_tokens",
+ "min_p",
+ "presence_penalty",
+ "repetition_penalty",
+ "response_format",
+ "seed",
+ "stop",
+ "temperature",
+ "top_k",
+ "top_p"
+ ]
+ },
"qwen/qwen-2.5-72b-instruct": {
"id": "qwen/qwen-2.5-72b-instruct",
"name": "Qwen2.5 72B Instruct",
@@ -10073,15 +10115,15 @@
"top_p"
]
},
- "openai/gpt-3.5-turbo-0613": {
- "id": "openai/gpt-3.5-turbo-0613",
- "name": "OpenAI: GPT-3.5 Turbo (older v0613)",
+ "openai/gpt-4-turbo-preview": {
+ "id": "openai/gpt-4-turbo-preview",
+ "name": "OpenAI: GPT-4 Turbo Preview",
"provider": "openai",
- "local_id": "gpt-3.5-turbo-0613",
- "context_length": 4095,
+ "local_id": "gpt-4-turbo-preview",
+ "context_length": 128000,
"max_output_tokens": 4096,
- "input_price_per_mtok": 1.0,
- "output_price_per_mtok": 2.0,
+ "input_price_per_mtok": 10.0,
+ "output_price_per_mtok": 30.0,
"supports_thinking": false,
"thinking_type": "none",
"temperature_range": [
@@ -10093,7 +10135,7 @@
"frequency_penalty",
"logit_bias",
"logprobs",
- "max_completion_tokens",
+ "max_tokens",
"presence_penalty",
"response_format",
"seed",
@@ -10106,15 +10148,15 @@
"top_p"
]
},
- "openai/gpt-4-turbo-preview": {
- "id": "openai/gpt-4-turbo-preview",
- "name": "OpenAI: GPT-4 Turbo Preview",
+ "openai/gpt-3.5-turbo-0613": {
+ "id": "openai/gpt-3.5-turbo-0613",
+ "name": "OpenAI: GPT-3.5 Turbo (older v0613)",
"provider": "openai",
- "local_id": "gpt-4-turbo-preview",
- "context_length": 128000,
+ "local_id": "gpt-3.5-turbo-0613",
+ "context_length": 4095,
"max_output_tokens": 4096,
- "input_price_per_mtok": 10.0,
- "output_price_per_mtok": 30.0,
+ "input_price_per_mtok": 1.0,
+ "output_price_per_mtok": 2.0,
"supports_thinking": false,
"thinking_type": "none",
"temperature_range": [
@@ -10126,7 +10168,7 @@
"frequency_penalty",
"logit_bias",
"logprobs",
- "max_tokens",
+ "max_completion_tokens",
"presence_penalty",
"response_format",
"seed",
@@ -10280,15 +10322,15 @@
"top_p"
]
},
- "mistralai/mistral-7b-instruct-v0.1": {
- "id": "mistralai/mistral-7b-instruct-v0.1",
- "name": "Mistral: Mistral 7B Instruct v0.1",
- "provider": "mistralai",
- "local_id": "mistral-7b-instruct-v0.1",
- "context_length": 2824,
- "max_output_tokens": 0,
- "input_price_per_mtok": 0.11,
- "output_price_per_mtok": 0.19,
+ "openai/gpt-3.5-turbo-instruct": {
+ "id": "openai/gpt-3.5-turbo-instruct",
+ "name": "OpenAI: GPT-3.5 Turbo Instruct",
+ "provider": "openai",
+ "local_id": "gpt-3.5-turbo-instruct",
+ "context_length": 4095,
+ "max_output_tokens": 4096,
+ "input_price_per_mtok": 1.5,
+ "output_price_per_mtok": 2.0,
"supports_thinking": false,
"thinking_type": "none",
"temperature_range": [
@@ -10298,24 +10340,28 @@
"is_reasoning_model": false,
"supported_parameters": [
"frequency_penalty",
+ "logit_bias",
+ "logprobs",
"max_tokens",
"presence_penalty",
- "repetition_penalty",
+ "response_format",
"seed",
+ "stop",
+ "structured_outputs",
"temperature",
- "top_k",
+ "top_logprobs",
"top_p"
]
},
- "openai/gpt-3.5-turbo-instruct": {
- "id": "openai/gpt-3.5-turbo-instruct",
- "name": "OpenAI: GPT-3.5 Turbo Instruct",
- "provider": "openai",
- "local_id": "gpt-3.5-turbo-instruct",
- "context_length": 4095,
- "max_output_tokens": 4096,
- "input_price_per_mtok": 1.5,
- "output_price_per_mtok": 2.0,
+ "mistralai/mistral-7b-instruct-v0.1": {
+ "id": "mistralai/mistral-7b-instruct-v0.1",
+ "name": "Mistral: Mistral 7B Instruct v0.1",
+ "provider": "mistralai",
+ "local_id": "mistral-7b-instruct-v0.1",
+ "context_length": 2824,
+ "max_output_tokens": 0,
+ "input_price_per_mtok": 0.11,
+ "output_price_per_mtok": 0.19,
"supports_thinking": false,
"thinking_type": "none",
"temperature_range": [
@@ -10325,16 +10371,12 @@
"is_reasoning_model": false,
"supported_parameters": [
"frequency_penalty",
- "logit_bias",
- "logprobs",
"max_tokens",
"presence_penalty",
- "response_format",
+ "repetition_penalty",
"seed",
- "stop",
- "structured_outputs",
"temperature",
- "top_logprobs",
+ "top_k",
"top_p"
]
},
@@ -10509,15 +10551,15 @@
"top_p"
]
},
- "openai/gpt-3.5-turbo": {
- "id": "openai/gpt-3.5-turbo",
- "name": "OpenAI: GPT-3.5 Turbo",
+ "openai/gpt-4": {
+ "id": "openai/gpt-4",
+ "name": "OpenAI: GPT-4",
"provider": "openai",
- "local_id": "gpt-3.5-turbo",
- "context_length": 16385,
+ "local_id": "gpt-4",
+ "context_length": 8191,
"max_output_tokens": 4096,
- "input_price_per_mtok": 0.5,
- "output_price_per_mtok": 1.5,
+ "input_price_per_mtok": 30.0,
+ "output_price_per_mtok": 60.0,
"supports_thinking": false,
"thinking_type": "none",
"temperature_range": [
@@ -10529,6 +10571,7 @@
"frequency_penalty",
"logit_bias",
"logprobs",
+ "max_completion_tokens",
"max_tokens",
"presence_penalty",
"response_format",
@@ -10542,15 +10585,15 @@
"top_p"
]
},
- "openai/gpt-4": {
- "id": "openai/gpt-4",
- "name": "OpenAI: GPT-4",
+ "openai/gpt-3.5-turbo": {
+ "id": "openai/gpt-3.5-turbo",
+ "name": "OpenAI: GPT-3.5 Turbo",
"provider": "openai",
- "local_id": "gpt-4",
- "context_length": 8191,
+ "local_id": "gpt-3.5-turbo",
+ "context_length": 16385,
"max_output_tokens": 4096,
- "input_price_per_mtok": 30.0,
- "output_price_per_mtok": 60.0,
+ "input_price_per_mtok": 0.5,
+ "output_price_per_mtok": 1.5,
"supports_thinking": false,
"thinking_type": "none",
"temperature_range": [
@@ -10562,7 +10605,6 @@
"frequency_penalty",
"logit_bias",
"logprobs",
- "max_completion_tokens",
"max_tokens",
"presence_penalty",
"response_format",
diff --git a/server/models/node_metadata.py b/server/models/node_metadata.py
index 07174148..d0715624 100644
--- a/server/models/node_metadata.py
+++ b/server/models/node_metadata.py
@@ -64,6 +64,32 @@ class NodeMetadata(TypedDict, total=False):
NODE_METADATA: dict[str, NodeMetadata] = {}
+class GroupMetadata(TypedDict, total=False):
+ """Wave 10.B: per-group metadata for the component palette.
+
+ Retires the frontend `CATEGORY_ICONS`, `colorMap`, `labelMap`,
+ `SIMPLE_MODE_CATEGORIES` tables in `client/src/components/ui/
+ ComponentPalette.tsx`. Each group's icon/label/color/visibility is
+ declared once in `server/nodes/groups.py` and served via
+ `/api/schemas/nodes/groups`.
+ """
+
+ label: str # e.g. "AI Agents"
+ icon: str # emoji | "asset:<key>"
+ color: str # hex / dracula token
+ visibility: Literal["all", "normal", "dev"]
+
+
+# Plugin-populated registry — same pattern as NODE_METADATA. Filled by
+# register_group(...) calls in server/nodes/groups.py at import time.
+GROUP_METADATA: dict[str, GroupMetadata] = {}
+
+
+def get_group_metadata(group: str) -> Optional[GroupMetadata]:
+ """Return metadata for a group key, or None if not seeded."""
+ return GROUP_METADATA.get(group)
+
+
def get_node_metadata(node_type: str) -> Optional[NodeMetadata]:
"""Return display metadata for a node type, or None if not seeded."""
diff --git a/server/nodes/agents.py b/server/nodes/agents.py
index 87fa141d..66466eec 100644
--- a/server/nodes/agents.py
+++ b/server/nodes/agents.py
@@ -111,7 +111,7 @@ register_node(type="payments_agent", metadata={"displayName": "Payments Agen
register_node(type="consumer_agent", metadata={"displayName": "Consumer Agent", "subtitle": "Consumer Support", "icon": "🛒", "color": "#bd93f9", "group": ["agent"], "componentKind": "agent", "handles": _std_handles(), "description": "AI agent for consumer interactions", "version": 1, "uiHints": _STD_AGENT_HINTS})
register_node(type="autonomous_agent", metadata={"displayName": "Autonomous Agent", "subtitle": "Autonomous Ops", "icon": "🎯", "color": "#bd93f9", "group": ["agent"], "componentKind": "agent", "handles": _std_handles(), "description": "Autonomous agent using Code Mode patterns", "version": 1, "uiHints": _STD_AGENT_HINTS})
register_node(type="rlm_agent", metadata={"displayName": "RLM Agent", "subtitle": "Recursive Reasoning", "icon": "🧠", "color": "#ffb86c", "group": ["agent"], "componentKind": "agent", "handles": _std_handles(), "description": "Recursive Language Model agent (REPL-based)", "version": 1, "uiHints": _STD_AGENT_HINTS})
-register_node(type="claude_code_agent", metadata={"displayName": "Claude Code", "subtitle": "Agentic Coding", "icon": "asset:claude", "color": "#8be9fd", "group": ["agent"], "componentKind": "agent", "handles": _std_handles(), "description": "Claude Code CLI as a specialized agent", "version": 1, "uiHints": _STD_AGENT_HINTS})
+register_node(type="claude_code_agent", metadata={"displayName": "Claude Code", "subtitle": "Agentic Coding", "icon": "lobehub:Claude", "color": "#8be9fd", "group": ["agent"], "componentKind": "agent", "handles": _std_handles(), "description": "Claude Code CLI as a specialized agent", "version": 1, "uiHints": _STD_AGENT_HINTS})
# -- Team leads (Skill / Tool / Teammates bottom handles) --------------------
@@ -172,7 +172,7 @@ register_node(
metadata={
"displayName": "Social Receive",
"subtitle": "Normalize Message",
- "icon": "📡",
+ "icon": "asset:social",
"color": "#bd93f9",
"group": ["social"],
"componentKind": "agent", # Uses AIAgentNode component for multi-handle rendering
@@ -193,7 +193,7 @@ register_node(
metadata={
"displayName": "Social Send",
"subtitle": "Send Message",
- "icon": "📤",
+ "icon": "asset:social",
"color": "#bd93f9",
"group": ["social", "tool"],
"componentKind": "agent",
diff --git a/server/nodes/groups.py b/server/nodes/groups.py
new file mode 100644
index 00000000..d12ed374
--- /dev/null
+++ b/server/nodes/groups.py
@@ -0,0 +1,57 @@
+"""Component-palette group metadata (Wave 10.B).
+
+Each group referenced in any node's `group:` array gets a registration
+here with its palette icon, label, color, and visibility bucket. The
+frontend ComponentPalette reads the index from
+`/api/schemas/nodes/groups` and renders section headers directly from
+this data — no `CATEGORY_ICONS` / `labelMap` / `colorMap` /
+`SIMPLE_MODE_CATEGORIES` tables on the frontend anymore.
+
+`visibility`:
+ - "normal": shown in the default simple-mode palette
+ - "dev": shown only when the user toggles pro/dev mode on
+ - "all": always shown (effectively same as "normal")
+"""
+
+from __future__ import annotations
+
+from services.node_registry import register_group
+
+
+# ---------------------------------------------------------------------------
+# Normal-mode groups (visible in simple mode — the core agent building blocks)
+# ---------------------------------------------------------------------------
+
+register_group(key="agent", metadata={"label": "AI Agents", "icon": "🤖", "color": "#bd93f9", "visibility": "normal"})
+register_group(key="model", metadata={"label": "AI Models", "icon": "🧬", "color": "#8be9fd", "visibility": "normal"})
+register_group(key="skill", metadata={"label": "AI Skills", "icon": "🎯", "color": "#50fa7b", "visibility": "normal"})
+register_group(key="tool", metadata={"label": "AI Tools", "icon": "🛠️", "color": "#50fa7b", "visibility": "normal"})
+
+
+# ---------------------------------------------------------------------------
+# Dev-mode groups (shown when pro/dev mode is toggled on)
+# ---------------------------------------------------------------------------
+
+register_group(key="workflow", metadata={"label": "Workflows", "icon": "⚡", "color": "#ffb86c", "visibility": "dev"})
+register_group(key="trigger", metadata={"label": "Triggers", "icon": "🕐", "color": "#ff79c6", "visibility": "dev"})
+register_group(key="ai", metadata={"label": "AI", "icon": "🤖", "color": "#bd93f9", "visibility": "dev"})
+register_group(key="location", metadata={"label": "Location", "icon": "📍", "color": "#ff5555", "visibility": "dev"})
+register_group(key="social", metadata={"label": "Social", "icon": "📱", "color": "#50fa7b", "visibility": "dev"})
+register_group(key="android", metadata={"label": "Android", "icon": "📱", "color": "#8be9fd", "visibility": "dev"})
+register_group(key="chat", metadata={"label": "Chat", "icon": "💭", "color": "#f1fa8c", "visibility": "dev"})
+register_group(key="code", metadata={"label": "Code", "icon": "💻", "color": "#ffb86c", "visibility": "dev"})
+register_group(key="document", metadata={"label": "Documents", "icon": "🗄️", "color": "#ff79c6", "visibility": "dev"})
+register_group(key="utility", metadata={"label": "Utilities", "icon": "🔧", "color": "#bd93f9", "visibility": "dev"})
+register_group(key="api", metadata={"label": "API & Scraping", "icon": "🕷️", "color": "#ffb86c", "visibility": "dev"})
+register_group(key="search", metadata={"label": "Search", "icon": "🔍", "color": "#8be9fd", "visibility": "dev"})
+register_group(key="google", metadata={"label": "Google Workspace", "icon": "asset:google", "color": "#4285F4", "visibility": "dev"})
+register_group(key="scheduler", metadata={"label": "Schedulers", "icon": "📅", "color": "#ff79c6", "visibility": "dev"})
+register_group(key="proxy", metadata={"label": "Proxy", "icon": "🛡", "color": "#bd93f9", "visibility": "dev"})
+register_group(key="whatsapp", metadata={"label": "WhatsApp", "icon": "💬", "color": "#25D366", "visibility": "dev"})
+register_group(key="email", metadata={"label": "Email", "icon": "✉️", "color": "#8be9fd", "visibility": "dev"})
+register_group(key="browser", metadata={"label": "Browser", "icon": "🌐", "color": "#ff79c6", "visibility": "dev"})
+register_group(key="scraper", metadata={"label": "Scrapers", "icon": "🕸", "color": "#ff79c6", "visibility": "dev"})
+register_group(key="filesystem", metadata={"label": "Filesystem", "icon": "📁", "color": "#8be9fd", "visibility": "dev"})
+register_group(key="service", metadata={"label": "Services", "icon": "⚙️", "color": "#50fa7b", "visibility": "dev"})
+register_group(key="text", metadata={"label": "Text", "icon": "📝", "color": "#bd93f9", "visibility": "dev"})
+register_group(key="memory", metadata={"label": "Memory", "icon": "💾", "color": "#f1fa8c", "visibility": "dev"})
diff --git a/server/nodes/services.py b/server/nodes/services.py
index 9f87bae4..8ded4b47 100644
--- a/server/nodes/services.py
+++ b/server/nodes/services.py
@@ -61,15 +61,15 @@ register_node(type="mediaControl", metadata={"displayName": "Media Con
# 2. AI chat models (9) + memory + skill — model dispatch + accent colors
# ---------------------------------------------------------------------------
-register_node(type="openaiChatModel", metadata={"displayName": "OpenAI", "subtitle": "Chat Model", "icon": "🤖", "color": "#00A67E", "group": ["model"], "componentKind": "model", "handles": _MODEL_OUT, "description": "OpenAI GPT models for chat completion and generation", "version": 1})
-register_node(type="anthropicChatModel", metadata={"displayName": "Claude", "subtitle": "Chat Model", "icon": "🧠", "color": "#FF6B35", "group": ["model"], "componentKind": "model", "handles": _MODEL_OUT, "description": "Anthropic Claude models for conversation and analysis", "version": 1})
-register_node(type="geminiChatModel", metadata={"displayName": "Gemini", "subtitle": "Chat Model", "icon": "⭐", "color": "#4285F4", "group": ["model"], "componentKind": "model", "handles": _MODEL_OUT, "description": "Google Gemini models for multimodal AI capabilities", "version": 1})
-register_node(type="openrouterChatModel", metadata={"displayName": "OpenRouter", "subtitle": "Chat Model", "icon": "🔀", "color": "#6366F1", "group": ["model"], "componentKind": "model", "handles": _MODEL_OUT, "description": "OpenRouter unified API - access OpenAI, Claude, Gemini, Llama, and more", "version": 1})
-register_node(type="groqChatModel", metadata={"displayName": "Groq", "subtitle": "Chat Model", "icon": "⚡", "color": "#F55036", "group": ["model"], "componentKind": "model", "handles": _MODEL_OUT, "description": "Groq ultra-fast LLM inference (Llama, Qwen3, GPT-OSS)", "version": 1})
-register_node(type="cerebrasChatModel", metadata={"displayName": "Cerebras", "subtitle": "Chat Model", "icon": "🧬", "color": "#ffb86c", "group": ["model"], "componentKind": "model", "handles": _MODEL_OUT, "description": "Cerebras ultra-fast inference on custom AI hardware", "version": 1})
-register_node(type="deepseekChatModel", metadata={"displayName": "DeepSeek", "subtitle": "Chat Model", "icon": "🌊", "color": "#8be9fd", "group": ["model"], "componentKind": "model", "handles": _MODEL_OUT, "description": "DeepSeek V3 models (deepseek-chat, deepseek-reasoner with always-on CoT)", "version": 1})
-register_node(type="kimiChatModel", metadata={"displayName": "Kimi", "subtitle": "Chat Model", "icon": "🌙", "color": "#bd93f9", "group": ["model"], "componentKind": "model", "handles": _MODEL_OUT, "description": "Kimi K2 models by Moonshot AI with 256K context (thinking on by default)", "version": 1})
-register_node(type="mistralChatModel", metadata={"displayName": "Mistral", "subtitle": "Chat Model", "icon": "🌬", "color": "#ffb86c", "group": ["model"], "componentKind": "model", "handles": _MODEL_OUT, "description": "Mistral AI models for reasoning, coding, and multilingual tasks", "version": 1})
+register_node(type="openaiChatModel", metadata={"displayName": "OpenAI", "subtitle": "Chat Model", "icon": "lobehub:openai", "color": "#00A67E", "group": ["model"], "componentKind": "model", "handles": _MODEL_OUT, "description": "OpenAI GPT models for chat completion and generation", "version": 1})
+register_node(type="anthropicChatModel", metadata={"displayName": "Claude", "subtitle": "Chat Model", "icon": "lobehub:claude", "color": "#FF6B35", "group": ["model"], "componentKind": "model", "handles": _MODEL_OUT, "description": "Anthropic Claude models for conversation and analysis", "version": 1})
+register_node(type="geminiChatModel", metadata={"displayName": "Gemini", "subtitle": "Chat Model", "icon": "lobehub:gemini", "color": "#4285F4", "group": ["model"], "componentKind": "model", "handles": _MODEL_OUT, "description": "Google Gemini models for multimodal AI capabilities", "version": 1})
+register_node(type="openrouterChatModel", metadata={"displayName": "OpenRouter", "subtitle": "Chat Model", "icon": "lobehub:openrouter", "color": "#6366F1", "group": ["model"], "componentKind": "model", "handles": _MODEL_OUT, "description": "OpenRouter unified API - access OpenAI, Claude, Gemini, Llama, and more", "version": 1})
+register_node(type="groqChatModel", metadata={"displayName": "Groq", "subtitle": "Chat Model", "icon": "lobehub:groq", "color": "#F55036", "group": ["model"], "componentKind": "model", "handles": _MODEL_OUT, "description": "Groq ultra-fast LLM inference (Llama, Qwen3, GPT-OSS)", "version": 1})
+register_node(type="cerebrasChatModel", metadata={"displayName": "Cerebras", "subtitle": "Chat Model", "icon": "lobehub:cerebras", "color": "#ffb86c", "group": ["model"], "componentKind": "model", "handles": _MODEL_OUT, "description": "Cerebras ultra-fast inference on custom AI hardware", "version": 1})
+register_node(type="deepseekChatModel", metadata={"displayName": "DeepSeek", "subtitle": "Chat Model", "icon": "lobehub:deepseek", "color": "#8be9fd", "group": ["model"], "componentKind": "model", "handles": _MODEL_OUT, "description": "DeepSeek V3 models (deepseek-chat, deepseek-reasoner with always-on CoT)", "version": 1})
+register_node(type="kimiChatModel", metadata={"displayName": "Kimi", "subtitle": "Chat Model", "icon": "lobehub:kimi", "color": "#bd93f9", "group": ["model"], "componentKind": "model", "handles": _MODEL_OUT, "description": "Kimi K2 models by Moonshot AI with 256K context (thinking on by default)", "version": 1})
+register_node(type="mistralChatModel", metadata={"displayName": "Mistral", "subtitle": "Chat Model", "icon": "lobehub:mistral", "color": "#ffb86c", "group": ["model"], "componentKind": "model", "handles": _MODEL_OUT, "description": "Mistral AI models for reasoning, coding, and multilingual tasks", "version": 1})
register_node(
type="simpleMemory",
@@ -102,44 +102,44 @@ register_node(
# 3. Messaging — WhatsApp, Telegram, Twitter, Email, Chat
# ---------------------------------------------------------------------------
-register_node(type="whatsappSend", metadata={"displayName": "WhatsApp Send", "subtitle": "Send Message", "icon": "💬", "color": "#25D366", "group": ["whatsapp", "tool"], "componentKind": "square", "handles": _IO, "description": "Send WhatsApp messages (text, media, location, contact, sticker)", "version": 1})
-register_node(type="whatsappDb", metadata={"displayName": "WhatsApp DB", "subtitle": "Query DB", "icon": "🗃", "color": "#25D366", "group": ["whatsapp", "tool"], "componentKind": "square", "handles": _IO, "description": "Query WhatsApp database (chat history, contacts, groups, channels)", "version": 1})
+register_node(type="whatsappSend", metadata={"displayName": "WhatsApp Send", "subtitle": "Send Message", "icon": "asset:whatsapp-send", "color": "#25D366", "group": ["whatsapp", "tool"], "componentKind": "square", "handles": _IO, "description": "Send WhatsApp messages (text, media, location, contact, sticker)", "version": 1})
+register_node(type="whatsappDb", metadata={"displayName": "WhatsApp DB", "subtitle": "Query DB", "icon": "asset:whatsapp-db", "color": "#25D366", "group": ["whatsapp", "tool"], "componentKind": "square", "handles": _IO, "description": "Query WhatsApp database (chat history, contacts, groups, channels)", "version": 1})
-register_node(type="telegramSend", metadata={"displayName": "Telegram Send", "subtitle": "Send Message", "icon": "✈️", "color": "#0088CC", "group": ["social", "tool"], "componentKind": "square", "handles": _IO, "description": "Send text, photo, document, location, or contact via Telegram bot", "version": 1})
+register_node(type="telegramSend", metadata={"displayName": "Telegram Send", "subtitle": "Send Message", "icon": "asset:telegram", "color": "#0088CC", "group": ["social", "tool"], "componentKind": "square", "handles": _IO, "description": "Send text, photo, document, location, or contact via Telegram bot", "version": 1})
-register_node(type="twitterSend", metadata={"displayName": "Twitter Send", "subtitle": "Tweet / Reply", "icon": "🐦", "color": "#1DA1F2", "group": ["social", "tool"], "componentKind": "square", "handles": _IO, "description": "Post tweets, reply, retweet, like, or delete tweets on Twitter/X", "version": 1})
-register_node(type="twitterSearch", metadata={"displayName": "Twitter Search", "subtitle": "Search Tweets", "icon": "🔍", "color": "#1DA1F2", "group": ["social", "tool"], "componentKind": "square", "handles": _IO, "description": "Search recent tweets on Twitter/X using the Search API", "version": 1})
-register_node(type="twitterUser", metadata={"displayName": "Twitter User", "subtitle": "User Profiles", "icon": "👤", "color": "#1DA1F2", "group": ["social", "tool"], "componentKind": "square", "handles": _IO, "description": "Look up Twitter/X user profiles, followers, and following", "version": 1})
+register_node(type="twitterSend", metadata={"displayName": "Twitter Send", "subtitle": "Tweet / Reply", "icon": "asset:x", "color": "#1DA1F2", "group": ["social", "tool"], "componentKind": "square", "handles": _IO, "description": "Post tweets, reply, retweet, like, or delete tweets on Twitter/X", "version": 1})
+register_node(type="twitterSearch", metadata={"displayName": "Twitter Search", "subtitle": "Search Tweets", "icon": "asset:x", "color": "#1DA1F2", "group": ["social", "tool"], "componentKind": "square", "handles": _IO, "description": "Search recent tweets on Twitter/X using the Search API", "version": 1})
+register_node(type="twitterUser", metadata={"displayName": "Twitter User", "subtitle": "User Profiles", "icon": "asset:x", "color": "#1DA1F2", "group": ["social", "tool"], "componentKind": "square", "handles": _IO, "description": "Look up Twitter/X user profiles, followers, and following", "version": 1})
-register_node(type="emailSend", metadata={"displayName": "Email Send", "subtitle": "SMTP Outbound", "icon": "✉️", "color": "#8be9fd", "group": ["email", "tool"], "componentKind": "square", "handles": _IO, "description": "Send emails via SMTP (Gmail, Outlook, Yahoo, iCloud, ProtonMail, Fastmail, custom)", "version": 1})
-register_node(type="emailRead", metadata={"displayName": "Email Read", "subtitle": "IMAP Read/Manage", "icon": "📖", "color": "#8be9fd", "group": ["email", "tool"], "componentKind": "square", "handles": _IO, "description": "Read and manage emails via IMAP - list, search, read, move, delete, flag", "version": 1})
+register_node(type="emailSend", metadata={"displayName": "Email Send", "subtitle": "SMTP Outbound", "icon": "asset:send", "color": "#8be9fd", "group": ["email", "tool"], "componentKind": "square", "handles": _IO, "description": "Send emails via SMTP (Gmail, Outlook, Yahoo, iCloud, ProtonMail, Fastmail, custom)", "version": 1})
+register_node(type="emailRead", metadata={"displayName": "Email Read", "subtitle": "IMAP Read/Manage", "icon": "asset:read", "color": "#8be9fd", "group": ["email", "tool"], "componentKind": "square", "handles": _IO, "description": "Read and manage emails via IMAP - list, search, read, move, delete, flag", "version": 1})
-register_node(type="chatSend", metadata={"displayName": "Chat Send", "subtitle": "Send to Chat", "icon": "💬", "color": "#8be9fd", "group": ["chat"], "componentKind": "square", "handles": _IO, "description": "Send messages to chat conversations", "version": 1})
-register_node(type="chatHistory", metadata={"displayName": "Chat History", "subtitle": "Retrieve Messages", "icon": "📜", "color": "#8be9fd", "group": ["chat"], "componentKind": "square", "handles": _IO, "description": "Retrieve chat conversation history", "version": 1})
+register_node(type="chatSend", metadata={"displayName": "Chat Send", "subtitle": "Send to Chat", "icon": "asset:chat", "color": "#8be9fd", "group": ["chat"], "componentKind": "square", "handles": _IO, "description": "Send messages to chat conversations", "version": 1})
+register_node(type="chatHistory", metadata={"displayName": "Chat History", "subtitle": "Retrieve Messages", "icon": "asset:chat", "color": "#8be9fd", "group": ["chat"], "componentKind": "square", "handles": _IO, "description": "Retrieve chat conversation history", "version": 1})
# ---------------------------------------------------------------------------
# 4. Google Workspace (6) — branded blue
# ---------------------------------------------------------------------------
-register_node(type="gmail", metadata={"displayName": "Gmail", "subtitle": "Email Operations", "icon": "📧", "color": "#EA4335", "group": ["google", "tool"], "componentKind": "square", "handles": _IO, "description": "Gmail send / search / read operations", "version": 1})
-register_node(type="calendar", metadata={"displayName": "Calendar", "subtitle": "Event Management", "icon": "📅", "color": "#4285F4", "group": ["google", "tool"], "componentKind": "square", "handles": _IO, "description": "Google Calendar create / list / update / delete events", "version": 1})
-register_node(type="drive", metadata={"displayName": "Drive", "subtitle": "File Operations", "icon": "📁", "color": "#0F9D58", "group": ["google", "tool"], "componentKind": "square", "handles": _IO, "description": "Google Drive upload / download / list / share files", "version": 1})
-register_node(type="sheets", metadata={"displayName": "Sheets", "subtitle": "Spreadsheet Ops", "icon": "📊", "color": "#0F9D58", "group": ["google", "tool"], "componentKind": "square", "handles": _IO, "description": "Google Sheets read / write / append spreadsheet data", "version": 1})
-register_node(type="tasks", metadata={"displayName": "Tasks", "subtitle": "Task Management", "icon": "✅", "color": "#4285F4", "group": ["google", "tool"], "componentKind": "square", "handles": _IO, "description": "Google Tasks create / list / complete / update / delete", "version": 1})
-register_node(type="contacts", metadata={"displayName": "Contacts", "subtitle": "Contact Management", "icon": "👥", "color": "#4285F4", "group": ["google", "tool"], "componentKind": "square", "handles": _IO, "description": "Google Contacts create / list / search / get / update / delete", "version": 1})
+register_node(type="gmail", metadata={"displayName": "Gmail", "subtitle": "Email Operations", "icon": "asset:gmail", "color": "#EA4335", "group": ["google", "tool"], "componentKind": "square", "handles": _IO, "description": "Gmail send / search / read operations", "version": 1})
+register_node(type="calendar", metadata={"displayName": "Calendar", "subtitle": "Event Management", "icon": "asset:calendar", "color": "#4285F4", "group": ["google", "tool"], "componentKind": "square", "handles": _IO, "description": "Google Calendar create / list / update / delete events", "version": 1})
+register_node(type="drive", metadata={"displayName": "Drive", "subtitle": "File Operations", "icon": "asset:drive", "color": "#0F9D58", "group": ["google", "tool"], "componentKind": "square", "handles": _IO, "description": "Google Drive upload / download / list / share files", "version": 1})
+register_node(type="sheets", metadata={"displayName": "Sheets", "subtitle": "Spreadsheet Ops", "icon": "asset:sheets", "color": "#0F9D58", "group": ["google", "tool"], "componentKind": "square", "handles": _IO, "description": "Google Sheets read / write / append spreadsheet data", "version": 1})
+register_node(type="tasks", metadata={"displayName": "Tasks", "subtitle": "Task Management", "icon": "asset:tasks", "color": "#4285F4", "group": ["google", "tool"], "componentKind": "square", "handles": _IO, "description": "Google Tasks create / list / complete / update / delete", "version": 1})
+register_node(type="contacts", metadata={"displayName": "Contacts", "subtitle": "Contact Management", "icon": "asset:contacts", "color": "#4285F4", "group": ["google", "tool"], "componentKind": "square", "handles": _IO, "description": "Google Contacts create / list / search / get / update / delete", "version": 1})
# ---------------------------------------------------------------------------
# 5. Web — search, browser, scrapers, proxy, location
# ---------------------------------------------------------------------------
-register_node(type="braveSearch", metadata={"displayName": "Brave Search", "subtitle": "Web Search", "icon": "🦁", "color": "#FB542B", "group": ["search", "tool"], "componentKind": "square", "handles": _IO, "description": "Search the web using Brave Search API", "version": 1})
-register_node(type="serperSearch", metadata={"displayName": "Serper Search", "subtitle": "Google SERP", "icon": "🔎", "color": "#ff79c6", "group": ["search", "tool"], "componentKind": "square", "handles": _IO, "description": "Search the web using Google via Serper API (web/news/images/places)", "version": 1})
-register_node(type="perplexitySearch", metadata={"displayName": "Perplexity Search","subtitle": "AI Search", "icon": "✨", "color": "#ff79c6", "group": ["search", "tool"], "componentKind": "square", "handles": _IO, "description": "AI-powered search using Perplexity Sonar with citations", "version": 1})
+register_node(type="braveSearch", metadata={"displayName": "Brave Search", "subtitle": "Web Search", "icon": "asset:brave", "color": "#FB542B", "group": ["search", "tool"], "componentKind": "square", "handles": _IO, "description": "Search the web using Brave Search API", "version": 1})
+register_node(type="serperSearch", metadata={"displayName": "Serper Search", "subtitle": "Google SERP", "icon": "asset:google","color": "#ff79c6", "group": ["search", "tool"], "componentKind": "square", "handles": _IO, "description": "Search the web using Google via Serper API (web/news/images/places)", "version": 1})
+register_node(type="perplexitySearch", metadata={"displayName": "Perplexity Search","subtitle": "AI Search", "icon": "asset:perplexity", "color": "#ff79c6", "group": ["search", "tool"], "componentKind": "square", "handles": _IO, "description": "AI-powered search using Perplexity Sonar with citations", "version": 1})
-register_node(type="browser", metadata={"displayName": "Browser", "subtitle": "Browser Automation","icon": "🌐", "color": "#ff79c6", "group": ["browser", "tool"], "componentKind": "square", "handles": _IO, "description": "Interactive browser automation via agent-browser CLI", "version": 1})
-register_node(type="apifyActor", metadata={"displayName": "Apify Actor", "subtitle": "Web Scraper", "icon": "🕸", "color": "#ff79c6", "group": ["api", "scraper", "tool"], "componentKind": "square", "handles": _IO, "description": "Run Apify actors for Instagram, TikTok, Twitter, LinkedIn, etc.", "version": 1})
+register_node(type="browser", metadata={"displayName": "Browser", "subtitle": "Browser Automation","icon": "asset:chrome", "color": "#ff79c6", "group": ["browser", "tool"], "componentKind": "square", "handles": _IO, "description": "Interactive browser automation via agent-browser CLI", "version": 1})
+register_node(type="apifyActor", metadata={"displayName": "Apify Actor", "subtitle": "Web Scraper", "icon": "asset:apify", "color": "#ff79c6", "group": ["api", "scraper", "tool"], "componentKind": "square", "handles": _IO, "description": "Run Apify actors for Instagram, TikTok, Twitter, LinkedIn, etc.", "version": 1})
register_node(type="crawleeScraper", metadata={"displayName": "Web Scraper", "subtitle": "Crawlee", "icon": "🕷", "color": "#ff79c6", "group": ["scraper", "tool"], "componentKind": "square", "handles": _IO, "description": "Web scraper supporting static HTML (BeautifulSoup) and JS-rendered (Playwright)", "version": 1})
register_node(type="proxyRequest", metadata={"displayName": "Proxy Request", "subtitle": "Routed HTTP", "icon": "🛡", "color": "#ffb86c", "group": ["proxy"], "componentKind": "square", "handles": _IO, "description": "Make HTTP requests through residential proxy providers", "version": 1})
diff --git a/server/nodes/tools.py b/server/nodes/tools.py
index 97ef52b8..21d7efd4 100644
--- a/server/nodes/tools.py
+++ b/server/nodes/tools.py
@@ -59,7 +59,7 @@ register_node(
metadata={
"displayName": "DuckDuckGo Search",
"subtitle": "Free Web Search",
- "icon": "🦆",
+ "icon": "asset:duckduckgo",
"color": "#f1fa8c",
"group": ["tool", "ai", "search"],
"componentKind": "tool",
diff --git a/server/nodes/triggers.py b/server/nodes/triggers.py
index ccbdd1fe..b779b73b 100644
--- a/server/nodes/triggers.py
+++ b/server/nodes/triggers.py
@@ -102,7 +102,7 @@ register_node(
metadata={
"displayName": "Chat Trigger",
"subtitle": "Console Chat",
- "icon": "💬",
+ "icon": "asset:chat",
"color": "#ffb86c",
"group": ["utility", "trigger"],
"componentKind": "trigger",
@@ -133,7 +133,7 @@ register_node(
metadata={
"displayName": "WhatsApp Receive",
"subtitle": "Inbound Message",
- "icon": "📱",
+ "icon": "asset:whatsapp-receive",
"color": "#25D366",
"group": ["whatsapp", "trigger"],
"componentKind": "trigger",
@@ -148,7 +148,7 @@ register_node(
metadata={
"displayName": "Telegram Receive",
"subtitle": "Inbound Message",
- "icon": "✈️",
+ "icon": "asset:telegram",
"color": "#0088CC",
"group": ["social", "trigger"],
"componentKind": "trigger",
@@ -163,7 +163,7 @@ register_node(
metadata={
"displayName": "Twitter Receive",
"subtitle": "Mentions / DMs",
- "icon": "🐦",
+ "icon": "asset:x",
"color": "#1DA1F2",
"group": ["social", "trigger"],
"componentKind": "trigger",
@@ -178,7 +178,7 @@ register_node(
metadata={
"displayName": "Gmail Receive",
"subtitle": "Inbound Email",
- "icon": "📧",
+ "icon": "asset:gmail",
"color": "#EA4335",
"group": ["google", "trigger"],
"componentKind": "trigger",
@@ -193,7 +193,7 @@ register_node(
metadata={
"displayName": "Email Receive",
"subtitle": "IMAP Polling",
- "icon": "📬",
+ "icon": "asset:receive",
"color": "#8be9fd",
"group": ["email", "trigger"],
"componentKind": "trigger",
diff --git a/server/services/node_registry.py b/server/services/node_registry.py
index cecce292..32f84beb 100644
--- a/server/services/node_registry.py
+++ b/server/services/node_registry.py
@@ -28,7 +28,7 @@ from typing import Callable, Optional, Type
from pydantic import BaseModel
-from models.node_metadata import NODE_METADATA, NodeMetadata
+from models.node_metadata import GROUP_METADATA, NODE_METADATA, GroupMetadata, NodeMetadata
from services.node_input_schemas import _DIRECT_MODELS
from services.node_output_schemas import NODE_OUTPUT_SCHEMAS
@@ -83,3 +83,14 @@ def registered_node_types() -> frozenset[str]:
"""Types that came in via the plugin path. Useful for tests and for
telling the legacy dispatcher which types it must NOT also claim."""
return frozenset(_HANDLER_REGISTRY.keys())
+
+
+def register_group(*, key: str, metadata: GroupMetadata) -> None:
+ """Register a component-palette group's metadata.
+
+ Wave 10.B: retires the frontend `CATEGORY_ICONS` / `labelMap` /
+ `colorMap` / `SIMPLE_MODE_CATEGORIES` tables. Every group a plugin
+ module uses in its `group:` field can declare its visual
+ representation here. Idempotent — re-registration replaces.
+ """
+ GROUP_METADATA[key] = metadata
diff --git a/server/services/node_spec.py b/server/services/node_spec.py
index c51d2e9f..21659f18 100644
--- a/server/services/node_spec.py
+++ b/server/services/node_spec.py
@@ -91,28 +91,63 @@ def get_node_spec(node_type: str) -> Optional[dict[str, Any]]:
def list_node_types_with_spec() -> list[str]:
- """Stable sorted list of every node type that has at least an input
- model or an output schema. Editor uses this on boot to know which
- types it can probe without 404s."""
-
- return sorted(set(NODE_INPUT_MODELS.keys()) | set(NODE_OUTPUT_SCHEMAS.keys()))
-
-
-def list_node_groups() -> dict[str, list[str]]:
- """Wave 6 Phase 5: invert the per-spec ``group`` arrays into a
- {group_name: [node_type, ...]} index. Replaces the 34 hand-rolled
- ``*_NODE_TYPES`` arrays scattered across the frontend.
-
- Editor consumers (`useNodeGroup('tool')`, palette filters, console
- sink detection, etc.) read from a single TanStack Query backed by
- this endpoint instead of importing per-category constants.
+ """Stable sorted list of every node type the backend knows about —
+ either via an input model, an output schema, or a `register_node()`
+ metadata entry. The editor uses this on boot to prefetch every spec
+ (including visual-only nodes like `simpleMemory` that have metadata
+ but no Pydantic schemas)."""
+
+ from models.node_metadata import NODE_METADATA
+ return sorted(
+ set(NODE_INPUT_MODELS.keys())
+ | set(NODE_OUTPUT_SCHEMAS.keys())
+ | set(NODE_METADATA.keys())
+ )
+
+
+def list_node_groups() -> dict[str, dict[str, Any]]:
+ """Per-group index for the component palette.
+
+ Wave 10.B shape::
+
+ {
+ "agent": {"types": [...], "label": "AI Agents",
+ "icon": "🤖", "color": "#bd93f9",
+ "visibility": "normal"},
+ "model": {"types": [...], ...},
+ ...
+ }
+
+ `types` is the sorted list of node types belonging to the group
+ (replaces the 34 hand-rolled `*_NODE_TYPES` arrays scattered across
+ the frontend). Remaining keys come from
+ ``models.node_metadata.GROUP_METADATA`` and make the palette's
+ section headers fully backend-driven — icon, label, color, and
+ "normal"-vs-"dev" visibility are all declared in
+ ``server/nodes/groups.py``.
+
+ When a group has nodes but no metadata seeded, the entry falls back
+ to the raw key as label with no icon/color; the frontend can still
+ render it safely.
"""
+ from models.node_metadata import get_group_metadata
- index: dict[str, set[str]] = {}
+ types_by_group: dict[str, set[str]] = {}
for node_type in list_node_types_with_spec():
spec = get_node_spec(node_type)
if not spec:
continue
for group in spec.get("group", []):
- index.setdefault(group, set()).add(node_type)
- return {group: sorted(types) for group, types in sorted(index.items())}
+ types_by_group.setdefault(group, set()).add(node_type)
+
+ result: dict[str, dict[str, Any]] = {}
+ for group, type_set in sorted(types_by_group.items()):
+ meta = get_group_metadata(group) or {}
+ result[group] = {
+ "types": sorted(type_set),
+ "label": meta.get("label") or group,
+ "icon": meta.get("icon", ""),
+ "color": meta.get("color", ""),
+ "visibility": meta.get("visibility", "dev"),
+ }
+ return result
diff --git a/server/tests/test_node_spec.py b/server/tests/test_node_spec.py
index a331b443..a9f4f697 100644
--- a/server/tests/test_node_spec.py
+++ b/server/tests/test_node_spec.py
@@ -408,21 +408,35 @@ class TestPhase5NodeGroups:
def test_tool_group_includes_known_tools(self):
from services.node_spec import list_node_groups
- tools = set(list_node_groups().get("tool", []))
+ tools = set(list_node_groups()["tool"]["types"])
for expected in ["pythonExecutor", "javascriptExecutor", "httpRequest"]:
assert expected in tools
def test_trigger_group_includes_known_triggers(self):
from services.node_spec import list_node_groups
- triggers = set(list_node_groups().get("trigger", []))
+ triggers = set(list_node_groups()["trigger"]["types"])
for expected in ["webhookTrigger", "chatTrigger", "telegramReceive", "twitterReceive"]:
assert expected in triggers
def test_each_group_alphabetised(self):
from services.node_spec import list_node_groups
- for group, types in list_node_groups().items():
+ for group, entry in list_node_groups().items():
+ types = entry["types"]
assert types == sorted(types), f"Group {group!r} not sorted: {types}"
+ def test_every_group_carries_palette_metadata(self):
+ """Wave 10.B: every group the node registry emits must have a
+ palette metadata entry (label/icon/color/visibility) registered
+ via ``register_group`` in ``server/nodes/groups.py``. Prevents
+ a new group key silently rendering unlabelled in the palette."""
+ from services.node_spec import list_node_groups
+ for group, entry in list_node_groups().items():
+ assert entry["label"], f"{group}: missing label"
+ assert entry["icon"], f"{group}: missing icon"
+ assert entry["visibility"] in ("normal", "dev", "all"), (
+ f"{group}: visibility={entry['visibility']!r}"
+ )
+
class TestDisplayOptionsEnrichment:
"""Wave 6 Phase 6 enrichment: Pydantic Field(json_schema_extra=...)
@@ -940,6 +954,35 @@ class TestWave10GContractInvariants:
f"{t}.code: expected `editor: 'code'`, got {code_field.get('editor')!r}"
)
+ def test_every_asset_icon_has_matching_svg(self):
+ """Wave 10.B: every ``asset:<key>`` string emitted by a plugin
+ must resolve to a real SVG file under
+ ``client/src/assets/icons/<folder>/<key>.svg``. Without this
+ invariant, a typo in a ``register_node(... icon="asset:foo")``
+ call silently renders no icon on the canvas — user sees an
+ empty slot instead of the intended logo."""
+ from pathlib import Path
+ import re
+ from models.node_metadata import NODE_METADATA
+
+ # Walk client/src/assets/icons/**/*.svg once; derive keys.
+ repo_root = Path(__file__).resolve().parents[2]
+ assets_dir = repo_root / "client" / "src" / "assets" / "icons"
+ assert assets_dir.is_dir(), f"icon assets dir not found at {assets_dir}"
+ svg_keys = {p.stem for p in assets_dir.rglob("*.svg")}
+
+ ASSET_RE = re.compile(r"^asset:([A-Za-z0-9_\-]+)$")
+ missing: list[str] = []
+ for node_type, meta in NODE_METADATA.items():
+ icon = meta.get("icon", "") or ""
+ m = ASSET_RE.match(icon)
+ if m and m.group(1) not in svg_keys:
+ missing.append(f"{node_type}.icon={icon!r}")
+ assert not missing, (
+ f"asset:<key> references with no matching SVG: {missing}. "
+ f"Drop the file at client/src/assets/icons/<folder>/<key>.svg."
+ )
+
def test_api_key_fields_are_password_masked(self):
"""Every field named `apiKey` / `api_key` across every node's
input schema must emit `password: True` so the UI masks it.