@newfold/wp-module-ai-chat 1.0.0

package/src/utils/nfdAgents/typingIndicatorToolDisplay.js

@@ -0,0 +1,180 @@
+/**
+ * Tool/ability display helpers for the TypingIndicator tool execution list.
+ * Maps tool and ability names to user-facing title and description.
+ *
+ * @package
+ */
+
+import { __ } from "@wordpress/i18n";
+
+/**
+ * Get ability details for display in the typing indicator.
+ *
+ * @param {string} abilityName The ability name (e.g. from tool arguments).
+ * @return {Object} { title, description }
+ */
+export function getAbilityDetails(abilityName) {
+	const abilityMap = {
+		"nfd-agents/get-global-styles": {
+			title: __("Reading Site Colors", "wp-module-ai-chat"),
+			description: __(
+				"Fetching current color palette and typography settings",
+				"wp-module-ai-chat"
+			),
+		},
+		"nfd-agents/update-global-palette": {
+			title: __("Updating Site Colors", "wp-module-ai-chat"),
+			description: __("Applying new colors to global styles", "wp-module-ai-chat"),
+		},
+		"newfold-agents/get-global-styles": {
+			title: __("Reading Site Colors", "wp-module-ai-chat"),
+			description: __(
+				"Fetching current color palette and typography settings",
+				"wp-module-ai-chat"
+			),
+		},
+		"newfold-agents/update-global-palette": {
+			title: __("Updating Site Colors", "wp-module-ai-chat"),
+			description: __("Applying new colors to global styles", "wp-module-ai-chat"),
+		},
+		"blu/get-global-styles": {
+			title: __("Reading Site Colors", "wp-module-ai-chat"),
+			description: __(
+				"Fetching current color palette and typography settings",
+				"wp-module-ai-chat"
+			),
+		},
+		"blu/update-global-palette": {
+			title: __("Updating Site Colors", "wp-module-ai-chat"),
+			description: __("Applying new colors to global styles", "wp-module-ai-chat"),
+		},
+		"blu-get-global-styles": {
+			title: __("Reading Site Colors", "wp-module-ai-chat"),
+			description: __(
+				"Fetching current color palette and typography settings",
+				"wp-module-ai-chat"
+			),
+		},
+		"blu/get-active-global-styles": {
+			title: __("Reading Active Styles", "wp-module-ai-chat"),
+			description: __("Fetching active global styles", "wp-module-ai-chat"),
+		},
+		"blu-get-active-global-styles": {
+			title: __("Reading Active Styles", "wp-module-ai-chat"),
+			description: __("Fetching active global styles", "wp-module-ai-chat"),
+		},
+		"blu/get-active-global-styles-id": {
+			title: __("Getting Styles ID", "wp-module-ai-chat"),
+			description: __("Fetching active styles ID", "wp-module-ai-chat"),
+		},
+		"blu-get-active-global-styles-id": {
+			title: __("Getting Styles ID", "wp-module-ai-chat"),
+			description: __("Fetching active styles ID", "wp-module-ai-chat"),
+		},
+		"blu/update-global-styles": {
+			title: __("Updating Site Styles", "wp-module-ai-chat"),
+			description: __("Applying new styles to global styles", "wp-module-ai-chat"),
+		},
+		"blu-update-global-styles": {
+			title: __("Updating Site Styles", "wp-module-ai-chat"),
+			description: __("Applying new styles to global styles", "wp-module-ai-chat"),
+		},
+		"blu-update-global-palette": {
+			title: __("Updating Site Colors", "wp-module-ai-chat"),
+			description: __("Applying new colors to global styles", "wp-module-ai-chat"),
+		},
+		"blu/edit-block": {
+			title: __("Editing Block Content", "wp-module-ai-chat"),
+			description: __("Editing block content", "wp-module-ai-chat"),
+		},
+		"blu-edit-block": {
+			title: __("Editing Block Content", "wp-module-ai-chat"),
+			description: __("Editing block content", "wp-module-ai-chat"),
+		},
+		"blu/add-section": {
+			title: __("Adding New Section", "wp-module-ai-chat"),
+			description: __("Adding new section", "wp-module-ai-chat"),
+		},
+		"blu-add-section": {
+			title: __("Adding New Section", "wp-module-ai-chat"),
+			description: __("Adding new section", "wp-module-ai-chat"),
+		},
+		"blu/delete-block": {
+			title: __("Removing Block", "wp-module-ai-chat"),
+			description: __("Removing block", "wp-module-ai-chat"),
+		},
+		"blu-delete-block": {
+			title: __("Removing Block", "wp-module-ai-chat"),
+			description: __("Removing block", "wp-module-ai-chat"),
+		},
+		"blu/move-block": {
+			title: __("Moving Block", "wp-module-ai-chat"),
+			description: __("Moving block", "wp-module-ai-chat"),
+		},
+		"blu-move-block": {
+			title: __("Moving Block", "wp-module-ai-chat"),
+			description: __("Moving block", "wp-module-ai-chat"),
+		},
+		"mcp-adapter-discover-abilities": {
+			title: __("Discovering Actions", "wp-module-ai-chat"),
+			description: __("Finding available WordPress abilities", "wp-module-ai-chat"),
+		},
+		"mcp-adapter-get-ability-info": {
+			title: __("Getting Ability Info", "wp-module-ai-chat"),
+			description: __("Fetching ability details", "wp-module-ai-chat"),
+		},
+		"mcp-adapter-execute-ability": {
+			title: __("Executing Action", "wp-module-ai-chat"),
+			description: __("Running WordPress ability", "wp-module-ai-chat"),
+		},
+	};
+
+	if (abilityMap[abilityName]) {
+		return abilityMap[abilityName];
+	}
+
+	if (abilityName === "preparing-changes") {
+		return {
+			title: __("Preparing changes", "wp-module-ai-chat"),
+			description: __("Building block markup", "wp-module-ai-chat"),
+		};
+	}
+
+	return {
+		title:
+			abilityName?.replace(/[-_\/]/g, " ").replace(/\b\w/g, (l) => l.toUpperCase()) ||
+			__("Executing", "wp-module-ai-chat"),
+		description: __("Running action", "wp-module-ai-chat"),
+	};
+}
+
+/**
+ * Get tool details for display (title, description, optional params string).
+ *
+ * @param {string} toolName The tool name.
+ * @param {Object} args     The tool arguments (e.g. ability_name, parameters).
+ * @return {Object} { title, description, params }
+ */
+export function getToolDetails(toolName, args = {}) {
+	if (toolName === "mcp-adapter-execute-ability") {
+		const abilityName = args?.ability_name || "unknown";
+		const details = getAbilityDetails(abilityName);
+
+		let params = null;
+		const paletteAbility =
+			abilityName === "nfd-agents/update-global-palette" ||
+			abilityName === "newfold-agents/update-global-palette" ||
+			abilityName === "blu/update-global-palette" ||
+			abilityName === "blu-update-global-palette" ||
+			abilityName === "blu/update-global-styles" ||
+			abilityName === "blu-update-global-styles";
+		if (paletteAbility && args?.parameters?.colors) {
+			const colorCount = args.parameters.colors.length;
+			params = `${colorCount} color${colorCount !== 1 ? "s" : ""}`;
+		}
+
+		return { ...details, params };
+	}
+
+	return getAbilityDetails(toolName);
+}

package/src/utils/nfdAgents/url.js

@@ -0,0 +1,101 @@
+/**
+ * NFD Agents URL Utilities
+ *
+ * Utilities for URL normalization and protocol conversion for WebSocket connections.
+ * Used for converting HTTP/HTTPS URLs to WebSocket protocols and normalizing site URLs.
+ */
+
+/**
+ * Convert HTTP/HTTPS URL to WebSocket protocol
+ *
+ * @param {string} url HTTP or HTTPS URL
+ * @return {string} WebSocket URL (ws:// or wss://)
+ */
+export const convertToWebSocketUrl = (url) => {
+	if (!url || typeof url !== "string") {
+		return url;
+	}
+
+	if (url.startsWith("http://")) {
+		return url.replace("http://", "ws://");
+	}
+
+	if (url.startsWith("https://")) {
+		return url.replace("https://", "wss://");
+	}
+
+	// If no protocol specified, determine based on localhost
+	if (!url.startsWith("ws://") && !url.startsWith("wss://")) {
+		return isLocalhost(url) ? `ws://${url}` : `wss://${url}`;
+	}
+
+	return url;
+};
+
+/**
+ * Check if URL is localhost
+ *
+ * @param {string} url URL to check
+ * @return {boolean} True if URL is localhost
+ */
+export const isLocalhost = (url) => {
+	if (!url || typeof url !== "string") {
+		return false;
+	}
+
+	const normalized = url.toLowerCase();
+	return normalized.includes("localhost") || normalized.includes("127.0.0.1");
+};
+
+/**
+ * Build the full WebSocket URL from config, session ID, and consumer type.
+ * Normalizes the 'nfd-agents' agent type alias to 'blu'.
+ *
+ * @param {Object} config             Config object from fetchAgentConfig
+ * @param {string} config.gateway_url Gateway HTTP(S) URL
+ * @param {string} config.brand_id    Brand identifier
+ * @param {string} config.agent_type  Agent type (may be 'nfd-agents' alias)
+ * @param {string} config.jarvis_jwt  Jarvis JWT for agents backend auth (backend returns this key)
+ * @param {string} config.huapi_token Optional alias for token (e.g. NFD_AGENTS_CHAT_DEBUG_TOKEN)
+ * @param {string} sessionId          Session ID for the connection
+ * @param {string} consumerType       Consumer type; passed to gateway as wordpress_${consumerType}
+ * @return {string} Full WebSocket URL with query parameters
+ */
+export const buildWebSocketUrl = (config, sessionId, consumerType) => {
+	const wsBaseUrl = convertToWebSocketUrl(config.gateway_url);
+	const agentType = (config.agent_type === "nfd-agents" ? "blu" : config.agent_type) || "blu";
+	const consumer = `wordpress_${consumerType}`;
+	const token = config.huapi_token ?? config.jarvis_jwt ?? "";
+
+	let url = `${wsBaseUrl}/${config.brand_id}/agents/${agentType}/v1/ws?session_id=${sessionId}&token=${encodeURIComponent(token)}&consumer=${encodeURIComponent(consumer)}`;
+	if (config.site_url && typeof config.site_url === "string" && config.site_url.trim()) {
+		url += `&site_url=${encodeURIComponent(config.site_url.trim())}`;
+	}
+	return url;
+};
+
+/**
+ * Normalize site URL to ensure it has a protocol.
+ * Adds http:// for localhost, https:// for other URLs.
+ *
+ * @param {string} siteUrl Site URL to normalize
+ * @return {string} Normalized URL with protocol
+ */
+export const normalizeUrl = (siteUrl) => {
+	if (!siteUrl || typeof siteUrl !== "string") {
+		return siteUrl;
+	}
+
+	// If already has protocol, return as-is
+	if (siteUrl.match(/^https?:\/\//)) {
+		return siteUrl;
+	}
+
+	// Check if it's localhost and default to http://
+	if (isLocalhost(siteUrl)) {
+		return `http://${siteUrl}`;
+	}
+
+	// For other URLs, default to https://
+	return `https://${siteUrl}`;
+};

package/src/utils/restApi.js

@@ -0,0 +1,87 @@
+/**
+ * REST API Utilities
+ *
+ * Utilities for constructing WordPress REST API URLs that work
+ * regardless of permalink settings.
+ */
+
+/**
+ * Get the REST API base URL using rest_route parameter
+ * This works even when permalinks are not configured properly
+ *
+ * @param {string} [baseUrl] Base URL (defaults to current site URL)
+ * @return {string} REST API base URL
+ */
+export const getRestApiBaseUrl = (baseUrl = "") => {
+	// If baseUrl is provided and already contains rest_route, return as-is
+	if (baseUrl && baseUrl.includes("rest_route=")) {
+		return baseUrl;
+	}
+
+	// Get site URL from window if not provided
+	if (!baseUrl && typeof window !== "undefined") {
+		baseUrl = window.location.origin;
+	}
+
+	// Use rest_route parameter instead of /wp-json/ path
+	// This works regardless of permalink settings
+	const separator = baseUrl.includes("?") ? "&" : "?";
+	return `${baseUrl}${separator}rest_route=/`;
+};
+
+/**
+ * Build a REST API endpoint URL
+ *
+ * @param {string} namespace REST API namespace (e.g., 'nfd-agents/chat/v1')
+ * @param {string} route     REST API route (e.g., 'config')
+ * @param {string} [baseUrl] Base URL (defaults to current site URL)
+ * @return {string} Full REST API endpoint URL
+ */
+export const buildRestApiUrl = (namespace, route, baseUrl = "") => {
+	const restBase = getRestApiBaseUrl(baseUrl);
+	const endpoint = `${namespace}/${route}`;
+
+	// If restBase already has rest_route, append to it
+	if (restBase.includes("rest_route=")) {
+		return restBase.replace("rest_route=/", `rest_route=/${endpoint}`);
+	}
+
+	// Otherwise, construct new rest_route parameter
+	const separator = restBase.includes("?") ? "&" : "?";
+	return `${restBase}${separator}rest_route=/${endpoint}`;
+};
+
+/**
+ * Convert a wp-json style URL to rest_route format
+ *
+ * @param {string} wpJsonUrl URL in format /wp-json/namespace/route
+ * @param {string} [baseUrl] Base URL (defaults to current site URL)
+ * @return {string} URL with rest_route parameter
+ */
+export const convertWpJsonToRestRoute = (wpJsonUrl, baseUrl = "") => {
+	// If already using rest_route, return as-is
+	if (wpJsonUrl.includes("rest_route=")) {
+		return wpJsonUrl;
+	}
+
+	// Extract the path after /wp-json/
+	const wpJsonMatch = wpJsonUrl.match(/\/wp-json\/(.+)$/);
+	if (!wpJsonMatch) {
+		// Not a wp-json URL, return as-is
+		return wpJsonUrl;
+	}
+
+	const endpoint = wpJsonMatch[1];
+
+	// Get base URL
+	if (!baseUrl && typeof window !== "undefined") {
+		baseUrl = window.location.origin;
+	}
+
+	// Remove /wp-json/ from baseUrl if present
+	const cleanBaseUrl = baseUrl.replace(/\/wp-json\/?$/, "");
+
+	// Build rest_route URL
+	const separator = cleanBaseUrl.includes("?") ? "&" : "?";
+	return `${cleanBaseUrl}${separator}rest_route=/${endpoint}`;
+};

package/src/utils/sanitizeHtml.js

@@ -0,0 +1,94 @@
+/**
+ * External dependencies
+ */
+import DOMPurify from "dompurify";
+
+/**
+ * Sanitize HTML content using DOMPurify to prevent XSS attacks
+ *
+ * @param {string} html - The HTML string to sanitize.
+ * @return {string} The sanitized HTML string.
+ */
+export const sanitizeHtml = (html) => {
+	return DOMPurify.sanitize(html, {
+		ALLOWED_TAGS: [
+			"section",
+			"div",
+			"h1",
+			"h2",
+			"h3",
+			"h4",
+			"h5",
+			"h6",
+			"p",
+			"span",
+			"strong",
+			"em",
+			"b",
+			"i",
+			"u",
+			"s",
+			"mark",
+			"small",
+			"sub",
+			"sup",
+			"a",
+			"br",
+			"ul",
+			"ol",
+			"li",
+			"dl",
+			"dt",
+			"dd",
+			"blockquote",
+			"code",
+			"pre",
+			"table",
+			"thead",
+			"tbody",
+			"tr",
+			"th",
+			"td",
+			"hr",
+			"address",
+			"time",
+		],
+		ALLOWED_ATTR: ["style", "class", "id", "href", "datetime", "target", "rel"],
+		ALLOW_DATA_ATTR: false,
+		FORBID_TAGS: [
+			"script",
+			"object",
+			"embed",
+			"iframe",
+			"form",
+			"fieldset",
+			"legend",
+			"label",
+			"input",
+			"textarea",
+			"select",
+			"option",
+			"button",
+			"details",
+			"summary",
+			"progress",
+			"meter",
+		],
+		FORBID_ATTR: ["onerror", "onload", "onclick", "onmouseover", "onfocus", "onblur"],
+	});
+};
+
+/**
+ * Check if content contains HTML tags
+ *
+ * @param {string} content - The content to check.
+ * @return {boolean} True if content contains HTML tags.
+ */
+export const containsHtml = (content) => {
+	return /<[a-z][\s\S]*>/i.test(content);
+};
+
+export default {
+	sanitizeHtml,
+	containsHtml,
+};