/**
 * Data for get-suggested-nodes tool.
 * Contains curated node recommendations organized by workflow technique category.
 * Ported from ai-workflow-builder.ee — keeps the instance-ai builder on par.
 */

export interface CategorySuggestedNode {
	name: string;
	note?: string;
}

export interface CategoryData {
	description: string;
	patternHint: string;
	nodes: CategorySuggestedNode[];
}

export const suggestedNodesData: Record<string, CategoryData> = {
	chatbot: {
		description: 'Receiving chat messages and replying (built-in chat, Telegram, Slack, etc.)',
		patternHint: 'Chat Trigger -> AI Agent -> Memory -> Response',
		nodes: [
			{
				name: '@n8n/n8n-nodes-langchain.chatTrigger',
				note: "Do not attach a memory subnode to the Chat Trigger to give the Agent memory — that's the Agent's job. See the loadPreviousSession builderHint for when the trigger itself needs memory.",
			},
			{
				name: '@n8n/n8n-nodes-langchain.agent',
				note: 'Every agent in a conversational workflow MUST have a memory subnode connected. If multiple agents share the same conversation, they must use the same memory session key',
			},
			{ name: '@n8n/n8n-nodes-langchain.lmChatOpenAi' },
			{ name: '@n8n/n8n-nodes-langchain.lmChatGoogleGemini' },
			{
				name: '@n8n/n8n-nodes-langchain.memoryBufferWindow',
				note: 'Maintains short-term conversation history. Must be connected as a subnode to every Agent that participates in a conversation. When multiple agents share a conversation, use the same session key across all of them',
			},
			{
				name: '@n8n/n8n-nodes-langchain.retrieverVectorStore',
				note: 'Connects any Vector Store (Pinecone, Qdrant, Supabase, In-Memory, etc.) to an AI Agent for RAG. Use this as a subnode between the vector store and the agent to retrieve relevant documents when answering questions',
			},
			{ name: 'n8n-nodes-base.slack' },
			{ name: 'n8n-nodes-base.telegram' },
			{ name: 'n8n-nodes-base.whatsApp' },
			{ name: 'n8n-nodes-base.discord' },
		],
	},

	notification: {
		description: 'Sending alerts or updates via email, chat, SMS when events occur',
		patternHint: 'Trigger -> Condition -> Send (Email/Slack/SMS)',
		nodes: [
			{
				name: 'n8n-nodes-base.webhook',
				note: 'Event-based notifications from external systems',
			},
			{
				name: 'n8n-nodes-base.scheduleTrigger',
				note: 'Periodic monitoring and batch notifications',
			},
			{
				name: 'n8n-nodes-base.gmail',
				note: "Default to this because it's easy for users to setup",
			},
			{ name: 'n8n-nodes-base.slack' },
			{ name: 'n8n-nodes-base.telegram' },
			{ name: 'n8n-nodes-base.twilio' },
			{
				name: 'n8n-nodes-base.httpRequest',
				note: 'For services without dedicated nodes (Teams, Discord)',
			},
			{
				name: 'n8n-nodes-base.if',
				note: 'Check alert conditions before sending',
			},
			{
				name: 'n8n-nodes-base.switch',
				note: 'If routing by severity/type is needed, use Switch to direct to different channels',
			},
		],
	},

	scheduling: {
		description: 'Running actions at specific times or intervals',
		patternHint: 'Schedule Trigger -> Fetch -> Process -> Act',
		nodes: [
			{ name: 'n8n-nodes-base.scheduleTrigger' },
			{ name: 'n8n-nodes-base.httpRequest' },
			{ name: 'n8n-nodes-base.set' },
			{
				name: 'n8n-nodes-base.wait',
				note: 'Respect rate limits between API calls',
			},
		],
	},

	data_transformation: {
		description: 'Cleaning, formatting, or restructuring data',
		patternHint: 'Input -> Filter/Map -> Transform -> Output',
		nodes: [
			{ name: 'n8n-nodes-base.set' },
			{ name: 'n8n-nodes-base.if', note: 'Use early to validate inputs' },
			{
				name: 'n8n-nodes-base.filter',
				note: 'Use early to reduce data volume',
			},
			{
				name: 'n8n-nodes-base.summarize',
				note: 'Pivot table-style aggregations',
			},
			{
				name: 'n8n-nodes-base.aggregate',
				note: 'Combine multiple items into one',
			},
			{
				name: 'n8n-nodes-base.splitOut',
				note: 'Convert single item with array into multiple items',
			},
			{ name: 'n8n-nodes-base.sort' },
			{ name: 'n8n-nodes-base.limit' },
			{ name: 'n8n-nodes-base.removeDuplicates' },
			{
				name: 'n8n-nodes-base.splitInBatches',
				note: 'For large datasets (100+ items), batch processing prevents timeouts',
			},
		],
	},

	data_persistence: {
		description: 'Storing, updating, or retrieving records from persistent storage',
		patternHint: 'Trigger -> Process -> Store (DataTable/Sheets)',
		nodes: [
			{
				name: 'n8n-nodes-base.dataTable',
				note: 'PREFERRED - no external config needed',
			},
			{
				name: 'n8n-nodes-base.googleSheets',
				note: 'For collaboration needs; if >10k rows expected, consider DataTable instead',
			},
			{
				name: 'n8n-nodes-base.airtable',
				note: 'If relationships between tables are needed',
			},
			{ name: 'n8n-nodes-base.postgres' },
			{ name: 'n8n-nodes-base.mySql' },
			{ name: 'n8n-nodes-base.mongoDb' },
		],
	},

	data_extraction: {
		description: 'Pulling specific information from structured or unstructured inputs',
		patternHint: 'Source -> Extract -> Parse -> Structure',
		nodes: [
			{
				name: 'n8n-nodes-base.extractFromFile',
				note: 'For multiple file types, route by file type first with IF/Switch',
			},
			{
				name: 'n8n-nodes-base.htmlExtract',
				note: 'JS-rendered content may be empty',
			},
			{
				name: 'n8n-nodes-base.splitOut',
				note: 'Use before Loop Over Items for arrays',
			},
			{
				name: 'n8n-nodes-base.splitInBatches',
				note: 'Process 200 rows at a time for memory',
			},
			{ name: 'n8n-nodes-base.code' },
			{
				name: '@n8n/n8n-nodes-langchain.informationExtractor',
				note: 'For unstructured text',
			},
			{
				name: '@n8n/n8n-nodes-langchain.chainSummarization',
				note: 'Context window limits may truncate',
			},
		],
	},

	document_processing: {
		description: 'Taking action on content within files (PDFs, Word docs, images)',
		patternHint: 'Trigger -> Extract Text -> AI Parse -> Store',
		nodes: [
			{ name: 'n8n-nodes-base.gmailTrigger' },
			{ name: 'n8n-nodes-base.googleDriveTrigger' },
			{
				name: 'n8n-nodes-base.extractFromFile',
				note: 'Different file types require different operations - route accordingly',
			},
			{
				name: 'n8n-nodes-base.awsTextract',
				note: 'For tables and forms in scanned docs',
			},
			{
				name: 'n8n-nodes-base.mindee',
				note: 'Specialized invoice/receipt parsing',
			},
			{ name: '@n8n/n8n-nodes-langchain.agent' },
			{
				name: '@n8n/n8n-nodes-langchain.documentDefaultDataLoader',
				note: 'Loads binary files (PDF, CSV, JSON, DOCX, EPUB, text) into LangChain Documents. Auto-detects format from MIME type. Requires a preceding node that outputs binary data',
			},
			{
				name: '@n8n/n8n-nodes-langchain.vectorStoreInMemory',
				note: 'No external dependencies needed',
			},
			{
				name: 'n8n-nodes-base.splitInBatches',
				note: 'Process 5-10 files at a time',
			},
		],
	},

	form_input: {
		description: 'Gathering data from users via forms',
		patternHint: 'Form Trigger -> Validate -> Store -> Respond',
		nodes: [
			{
				name: 'n8n-nodes-base.formTrigger',
				note: 'ALWAYS store raw data to persistent storage',
			},
			{ name: 'n8n-nodes-base.form', note: 'Each node is one page/step' },
			{
				name: 'n8n-nodes-base.dataTable',
				note: 'PREFERRED for form data storage',
			},
			{ name: 'n8n-nodes-base.googleSheets' },
			{ name: 'n8n-nodes-base.airtable' },
		],
	},

	content_generation: {
		description: 'Creating text, images, audio, or video',
		patternHint: 'Trigger -> Generate (Text/Image/Video) -> Deliver',
		nodes: [
			{
				name: '@n8n/n8n-nodes-langchain.agent',
				note: 'For text generation',
			},
			{
				name: '@n8n/n8n-nodes-langchain.openAi',
				note: 'Use for image/video generation. DALL-E, TTS, Sora video generation',
			},
			{
				name: '@n8n/n8n-nodes-langchain.lmChatGoogleGemini',
				note: 'Imagen, video generation',
			},
			{
				name: 'n8n-nodes-base.httpRequest',
				note: 'For APIs without dedicated nodes',
			},
			{
				name: 'n8n-nodes-base.editImage',
				note: 'Resize, crop, format conversion',
			},
			{ name: 'n8n-nodes-base.markdown', note: 'Convert to HTML' },
			{ name: 'n8n-nodes-base.facebookGraphApi' },
			{
				name: 'n8n-nodes-base.wait',
				note: 'Video generation is async, use wait while polling for updates',
			},
		],
	},

	triage: {
		description: 'Classifying data for routing or prioritization',
		patternHint: 'Trigger -> Classify -> Route -> Act',
		nodes: [
			{
				name: '@n8n/n8n-nodes-langchain.agent',
				note: 'For consistent/deterministic classification, always use structured output parser and set temperature 0-0.2',
			},
			{
				name: '@n8n/n8n-nodes-langchain.outputParserStructured',
				note: 'Critical to ensure agent output is consistent and matching general schema',
			},
		],
	},

	scraping_and_research: {
		description: 'Collecting information from websites or APIs',
		patternHint: 'Trigger -> Fetch -> Extract -> Store',
		nodes: [
			{
				name: 'n8n-nodes-base.dataTable',
				note: 'Default storage for scraped data when the user does not specify a destination. No external config needed. Always include a storage step in scraping workflows',
			},
			{
				name: 'n8n-nodes-base.phantombuster',
				note: 'Use this for social media requests: LinkedIn, Facebook, Instagram, Twitter, etc.',
			},
			{
				name: '@n8n/n8n-nodes-langchain.toolSerpApi',
				note: 'Give agent web search capability, get up-to-date information from websites.',
			},
			{
				name: 'n8n-nodes-base.perplexity',
				note: 'Recommended for fetching up-to-date news',
			},
			{
				name: 'n8n-nodes-base.perplexityTool',
				note: 'Recommended for fetching up-to-date news',
			},
			{
				name: 'n8n-nodes-base.htmlExtract',
				note: 'Use to extract HTML content from http requests. Though, JS-rendered sites may return empty',
			},
			{
				name: 'n8n-nodes-base.splitInBatches',
				note: 'Use to batch the processing of items. General recommendation: 200 rows at a time if processing is fast',
			},
			{
				name: 'n8n-nodes-base.wait',
				note: 'Use this to avoid rate limits (429 errors)',
			},
			{ name: 'n8n-nodes-base.httpRequest' },
			{ name: 'n8n-nodes-base.httpRequestTool' },
		],
	},

	web_app: {
		description:
			'Serving a single-page web application from an n8n webhook — dashboard, admin panel, interactive tool, form with rich UI',
		patternHint:
			'Write HTML to chunks/page.html, then in src/workflow.ts use readFileSync + JSON.stringify to embed it in a Code node. Use multiple webhooks for page + API routes. Respond with text/html for pages, allEntries for JSON APIs.',
		nodes: [
			{
				name: 'n8n-nodes-base.webhook',
				note: 'Set responseMode to "responseNode". Use one webhook per route (e.g. GET /app for page, GET /app/items for API, POST /app/items/add for mutations). Access POST body via $json.body',
			},
			{
				name: 'n8n-nodes-base.respondToWebhook',
				note: 'For HTML pages: respondWith "text", responseBody via expression, Content-Type: text/html header. For JSON APIs: respondWith "allEntries"',
			},
			{
				name: 'n8n-nodes-base.aggregate',
				note: 'Use aggregateAllItemData to collect multiple DataTable rows into a single array before the Code node that builds the HTML page',
			},
			{
				name: 'n8n-nodes-base.code',
				note: 'Builds the final HTML by replacing a __DATA_PLACEHOLDER__ token with base64-encoded data. The HTML template is loaded via readFileSync + JSON.stringify in the SDK code — NEVER embed large HTML directly in jsCode',
			},
			{
				name: 'n8n-nodes-base.dataTable',
				note: 'PREFERRED for SPA data storage — no external config needed. Use resource: "row" with get/insert/update operations for CRUD API routes',
			},
		],
	},
};

export const categoryList = Object.keys(suggestedNodesData);