@gxp-dev/tools 2.0.71 → 2.0.72

package/bin/lib/lint/schemas/field.schema.json

@@ -0,0 +1,230 @@
+{
+	"$id": "https://gxp.dev/schemas/field.schema.json",
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"title": "GxP Form Field",
+	"description": "A single form field descriptor used inside a fields_list card.",
+	"type": "object",
+	"required": ["type"],
+	"properties": {
+		"type": {
+			"type": "string",
+			"enum": [
+				"hidden",
+				"html",
+				"live-html",
+				"heading",
+				"heading-large",
+				"small-heading",
+				"description",
+				"image",
+				"video",
+				"icon",
+				"icon-selector",
+				"clipboard",
+				"timestamp",
+				"button",
+				"external_link",
+				"text",
+				"number",
+				"email",
+				"password",
+				"phone_number",
+				"textarea",
+				"select",
+				"pill_select",
+				"multi_select",
+				"autocomplete",
+				"asyncSelect",
+				"radio",
+				"checkbox",
+				"boolean",
+				"boolean_icon",
+				"file",
+				"selectAsset",
+				"selectPagePlugin",
+				"selectProjectPlan",
+				"keyValuePair",
+				"codeEditor",
+				"htmlEditor",
+				"render_markdown",
+				"colorPicker",
+				"tag_list",
+				"savedSearchBuilder",
+				"date",
+				"datetime",
+				"time",
+				"timezone_picker",
+				"data_table",
+				"integration_connector",
+				"form-builder",
+				"object-builder"
+			],
+			"description": "Field type. Determines which extra properties are required."
+		},
+		"name": { "type": ["string", "null"] },
+		"label": { "type": ["string", "null"] },
+		"default": {
+			"type": ["string", "number", "boolean", "array", "object", "null"]
+		},
+		"placeholder": { "type": ["string", "null"] },
+		"disabled": { "type": "boolean" },
+		"readonly": { "type": "boolean" },
+		"required": { "type": "boolean" },
+		"multiple": { "type": "boolean" },
+		"classList": {
+			"type": "array",
+			"items": { "type": "string" }
+		},
+		"columnClass": { "type": ["string", "null"] },
+		"cols": {
+			"$ref": "common.schema.json#/$defs/gridCols"
+		},
+		"colsSm": { "$ref": "common.schema.json#/$defs/gridCols" },
+		"colsMd": { "$ref": "common.schema.json#/$defs/gridCols" },
+		"colsLg": { "$ref": "common.schema.json#/$defs/gridCols" },
+		"condition": { "type": ["string", "null"] },
+		"conditionParams": {
+			"$ref": "common.schema.json#/$defs/conditionParams"
+		},
+		"content": { "type": ["string", "null"] },
+		"text": { "type": ["string", "null"] },
+		"href": { "type": ["string", "null"] },
+		"icon": { "type": ["string", "null"] },
+		"options": {
+			"$ref": "common.schema.json#/$defs/options"
+		},
+		"accept": {
+			"type": "array",
+			"items": { "type": "string" }
+		},
+		"format": { "type": ["string", "null"] },
+		"prepend": { "type": ["string", "null"] },
+		"append": { "type": ["string", "null"] },
+		"method": {
+			"type": ["string", "null"],
+			"enum": ["GET", "POST", "PUT", "PATCH", "DELETE", null]
+		},
+		"query_parameter": { "type": ["string", "null"] },
+		"refresh": {
+			"type": "object",
+			"properties": {
+				"only": { "type": "string" },
+				"key": { "type": "string" }
+			},
+			"additionalProperties": true
+		},
+		"validation_rules": {
+			"type": "array",
+			"items": { "type": "string" }
+		},
+		"custom_settings": { "type": "object" }
+	},
+	"allOf": [
+		{
+			"if": {
+				"properties": {
+					"type": {
+						"enum": [
+							"select",
+							"pill_select",
+							"multi_select",
+							"radio",
+							"checkbox"
+						]
+					}
+				},
+				"required": ["type"]
+			},
+			"then": {
+				"required": ["options"],
+				"properties": {
+					"options": {
+						"$ref": "common.schema.json#/$defs/options",
+						"minItems": 1
+					}
+				}
+			}
+		},
+		{
+			"if": {
+				"properties": {
+					"type": {
+						"enum": [
+							"text",
+							"number",
+							"email",
+							"password",
+							"phone_number",
+							"textarea",
+							"select",
+							"pill_select",
+							"multi_select",
+							"autocomplete",
+							"asyncSelect",
+							"radio",
+							"checkbox",
+							"boolean",
+							"boolean_icon",
+							"file",
+							"selectAsset",
+							"keyValuePair",
+							"codeEditor",
+							"htmlEditor",
+							"colorPicker",
+							"tag_list",
+							"date",
+							"datetime",
+							"time",
+							"timezone_picker"
+						]
+					}
+				},
+				"required": ["type"]
+			},
+			"then": {
+				"required": ["name"],
+				"properties": {
+					"name": {
+						"type": "string",
+						"minLength": 1
+					}
+				}
+			}
+		},
+		{
+			"if": {
+				"properties": { "type": { "const": "asyncSelect" } },
+				"required": ["type"]
+			},
+			"then": {
+				"required": ["href", "method"]
+			}
+		},
+		{
+			"if": {
+				"properties": { "type": { "const": "external_link" } },
+				"required": ["type"]
+			},
+			"then": {
+				"required": ["href"]
+			}
+		},
+		{
+			"if": {
+				"properties": { "type": { "const": "colorPicker" } },
+				"required": ["type"]
+			},
+			"then": {
+				"properties": {
+					"default": {
+						"oneOf": [
+							{ "$ref": "common.schema.json#/$defs/colorHex" },
+							{ "type": "null" }
+						]
+					}
+				}
+			}
+		}
+	],
+	"additionalProperties": true
+}

package/mcp/gxp-api-server.js

@@ -18,130 +18,12 @@
  */
 
 const readline = require("readline")
-const fs = require("fs")
-const path = require("path")
-
-// Environment URL configuration (matches constants.js)
-const ENVIRONMENT_URLS = {
-	production: {
-		apiBaseUrl: "https://api.gramercy.cloud",
-		openApiSpec: "https://api.gramercy.cloud/api-specs/openapi.json",
-		asyncApiSpec: "https://api.gramercy.cloud/api-specs/asyncapi.json",
-		webhookSpec: "https://api.gramercy.cloud/api-specs/webhooks.json",
-	},
-	staging: {
-		apiBaseUrl: "https://api.efz-staging.env.eventfinity.app",
-		openApiSpec:
-			"https://api.efz-staging.env.eventfinity.app/api-specs/openapi.json",
-		asyncApiSpec:
-			"https://api.efz-staging.env.eventfinity.app/api-specs/asyncapi.json",
-		webhookSpec:
-			"https://api.efz-staging.env.eventfinity.app/api-specs/webhooks.json",
-	},
-	testing: {
-		apiBaseUrl: "https://api.zenith-develop-testing.env.eventfinity.app",
-		openApiSpec:
-			"https://api.zenith-develop-testing.env.eventfinity.app/api-specs/openapi.json",
-		asyncApiSpec:
-			"https://api.zenith-develop-testing.env.eventfinity.app/api-specs/asyncapi.json",
-		webhookSpec:
-			"https://api.zenith-develop-testing.env.eventfinity.app/api-specs/webhooks.json",
-	},
-	develop: {
-		apiBaseUrl: "https://api.zenith-develop.env.eventfinity.app",
-		openApiSpec:
-			"https://api.zenith-develop.env.eventfinity.app/api-specs/openapi.json",
-		asyncApiSpec:
-			"https://api.zenith-develop.env.eventfinity.app/api-specs/asyncapi.json",
-		webhookSpec:
-			"https://api.zenith-develop.env.eventfinity.app/api-specs/webhooks.json",
-	},
-	local: {
-		apiBaseUrl: "https://dashboard.eventfinity.test",
-		openApiSpec: "https://api.eventfinity.test/api-specs/openapi.json",
-		asyncApiSpec: "https://api.eventfinity.test/api-specs/asyncapi.json",
-		webhookSpec: "https://api.eventfinity.test/api-specs/webhooks.json",
-	},
-}
-
-// Cache for fetched specs
-const specCache = {
-	openapi: null,
-	asyncapi: null,
-	webhooks: null,
-	lastFetch: null,
-}
-
-const CACHE_TTL = 5 * 60 * 1000 // 5 minutes
-
-/**
- * Get current environment from .env file or default
- */
-function getEnvironment() {
-	// Try to read from .env file in current directory
-	const envPath = path.join(process.cwd(), ".env")
-	if (fs.existsSync(envPath)) {
-		const envContent = fs.readFileSync(envPath, "utf-8")
-		const match = envContent.match(/VITE_API_ENV=(\w+)/)
-		if (match) {
-			return match[1]
-		}
-	}
-
-	// Fall back to environment variable or default
-	return process.env.VITE_API_ENV || process.env.API_ENV || "develop"
-}
-
-/**
- * Get URLs for current environment
- */
-function getEnvUrls() {
-	const env = getEnvironment()
-	return ENVIRONMENT_URLS[env] || ENVIRONMENT_URLS.develop
-}
-
-/**
- * Fetch a spec with caching
- */
-async function fetchSpec(specType) {
-	const urls = getEnvUrls()
-	const urlMap = {
-		openapi: urls.openApiSpec,
-		asyncapi: urls.asyncApiSpec,
-		webhooks: urls.webhookSpec,
-	}
-
-	const url = urlMap[specType]
-	if (!url) {
-		throw new Error(`Unknown spec type: ${specType}`)
-	}
-
-	// Check cache
-	const now = Date.now()
-	if (
-		specCache[specType] &&
-		specCache.lastFetch &&
-		now - specCache.lastFetch < CACHE_TTL
-	) {
-		return specCache[specType]
-	}
-
-	// Fetch fresh
-	try {
-		const response = await fetch(url)
-		if (!response.ok) {
-			throw new Error(`HTTP ${response.status}: ${response.statusText}`)
-		}
-		const data = await response.json()
-		specCache[specType] = data
-		specCache.lastFetch = now
-		return data
-	} catch (error) {
-		throw new Error(
-			`Failed to fetch ${specType} spec from ${url}: ${error.message}`,
-		)
-	}
-}
+const {
+	ENVIRONMENT_URLS,
+	getEnvironment,
+	getEnvUrls,
+	fetchSpec,
+} = require("./lib/specs")
 
 /**
  * Search OpenAPI spec for endpoints matching a query
@@ -247,13 +129,38 @@ function getEndpointDetails(spec, path, method) {
 }
 
 // MCP Server Implementation
+const {
+	CONFIG_TOOLS,
+	handleConfigToolCall,
+	isConfigTool,
+} = require("./lib/config-tools")
+
+const {
+	EXT_API_TOOLS,
+	handleExtApiToolCall,
+	isExtApiTool,
+} = require("./lib/api-tools")
+
+const {
+	DOCS_TOOLS,
+	handleDocsToolCall,
+	isDocsTool,
+} = require("./lib/docs-tools")
+
+const {
+	TEST_TOOLS,
+	handleTestToolCall,
+	isTestTool,
+} = require("./lib/test-tools")
+
 const SERVER_INFO = {
 	name: "gxp-api-server",
-	version: "1.0.0",
-	description: "GxP API documentation server for AI coding assistants",
+	version: "2.0.0",
+	description:
+		"GxP toolkit MCP server: API specs, config/manifest editing, documentation search, and plugin test helpers for AI coding assistants.",
 }
 
-const TOOLS = [
+const API_TOOLS = [
 	{
 		name: "get_openapi_spec",
 		description:
@@ -337,10 +244,32 @@ const TOOLS = [
 	},
 ]
 
+// Final tool set surfaced to MCP clients: API spec tools + extended API tools
+// + config-editor tools + doc-search tools + test tools.
+const TOOLS = [
+	...API_TOOLS,
+	...EXT_API_TOOLS,
+	...CONFIG_TOOLS,
+	...DOCS_TOOLS,
+	...TEST_TOOLS,
+]
+
 /**
  * Handle MCP tool calls
  */
 async function handleToolCall(name, args) {
+	if (isConfigTool(name)) {
+		return handleConfigToolCall(name, args)
+	}
+	if (isExtApiTool(name)) {
+		return handleExtApiToolCall(name, args)
+	}
+	if (isDocsTool(name)) {
+		return handleDocsToolCall(name, args)
+	}
+	if (isTestTool(name)) {
+		return handleTestToolCall(name, args)
+	}
 	switch (name) {
 		case "get_openapi_spec": {
 			const spec = await fetchSpec("openapi")