@robinmordasiewicz/f5xc-api-mcp 2.0.21-2601081307 → 2.0.21-2601081701

package/dist/tools/discovery/schema-loader.js

@@ -0,0 +1,322 @@
+/**
+ * Schema Loader Module
+ *
+ * Provides infrastructure for loading OpenAPI component schemas from spec files
+ * and resolving $ref pointers to produce fully resolved schemas.
+ *
+ * This enables AI assistants to understand the exact structure required for
+ * API payloads without guessing.
+ */
+import { readFileSync, existsSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { getToolByName } from "../registry.js";
+// Get specs directory path
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const SPECS_DIR = join(__dirname, "../../../specs/domains");
+// Module-level cache for domain schemas
+const schemaCache = new Map();
+// Maximum depth for $ref resolution to prevent infinite loops
+const MAX_RESOLUTION_DEPTH = 10;
+/**
+ * Map tool domain names to spec file names
+ * Some domains have different naming conventions
+ */
+function getDomainSpecFileName(domain) {
+    // Convert domain name to spec file name (e.g., "virtual" -> "virtual.json")
+    return `${domain}.json`;
+}
+/**
+ * Load all schemas from a domain's spec file
+ *
+ * @param domain - Domain name (e.g., "virtual", "dns", "waf")
+ * @returns Cached domain schema data or null if not found
+ */
+export function loadDomainSchemas(domain) {
+    // Check cache first
+    const cached = schemaCache.get(domain);
+    if (cached) {
+        return cached;
+    }
+    const specFileName = getDomainSpecFileName(domain);
+    const specPath = join(SPECS_DIR, specFileName);
+    if (!existsSync(specPath)) {
+        // Try alternative naming (replace underscores with hyphens)
+        const altPath = join(SPECS_DIR, domain.replace(/_/g, "-") + ".json");
+        if (!existsSync(altPath)) {
+            return null;
+        }
+    }
+    try {
+        const specContent = readFileSync(specPath, "utf-8");
+        const spec = JSON.parse(specContent);
+        const cacheEntry = {
+            schemas: spec.components?.schemas || {},
+            loadedAt: Date.now(),
+        };
+        schemaCache.set(domain, cacheEntry);
+        return cacheEntry;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse a $ref string to extract the schema name
+ *
+ * @param ref - Reference string (e.g., "#/components/schemas/http_loadbalancerCreateRequest")
+ * @returns Schema name or null if invalid format
+ */
+export function parseSchemaRef(ref) {
+    if (!ref || typeof ref !== "string") {
+        return null;
+    }
+    // Handle standard OpenAPI $ref format
+    const match = ref.match(/^#\/components\/schemas\/(.+)$/);
+    if (match && match[1]) {
+        return match[1];
+    }
+    return null;
+}
+/**
+ * Resolve a $ref pointer to its actual schema
+ *
+ * @param ref - Reference string
+ * @param domain - Domain to look up schemas from
+ * @returns Resolved schema or null if not found
+ */
+export function resolveSchemaRef(ref, domain) {
+    const schemaName = parseSchemaRef(ref);
+    if (!schemaName) {
+        return null;
+    }
+    const domainCache = loadDomainSchemas(domain);
+    if (!domainCache) {
+        return null;
+    }
+    const schema = domainCache.schemas[schemaName];
+    if (!schema) {
+        // Schema might be in a different domain - try loading from all cached domains
+        for (const [, cache] of schemaCache) {
+            if (cache.schemas[schemaName]) {
+                return cache.schemas[schemaName];
+            }
+        }
+        return null;
+    }
+    return schema;
+}
+/**
+ * Recursively resolve all $ref pointers in a schema
+ *
+ * @param schema - Schema object (may contain $refs)
+ * @param domain - Primary domain for lookups
+ * @param depth - Current recursion depth
+ * @param visited - Set of already visited refs to detect cycles
+ * @returns Fully resolved schema
+ */
+export function resolveNestedRefs(schema, domain, depth = 0, visited = new Set()) {
+    // Depth limit check
+    if (depth > MAX_RESOLUTION_DEPTH) {
+        return schema;
+    }
+    // Handle null/undefined
+    if (!schema || typeof schema !== "object") {
+        return schema;
+    }
+    const obj = schema;
+    // Handle $ref
+    if ("$ref" in obj && typeof obj["$ref"] === "string") {
+        const ref = obj["$ref"];
+        // Cycle detection
+        if (visited.has(ref)) {
+            return { $ref: ref, _circular: true };
+        }
+        visited.add(ref);
+        const resolved = resolveSchemaRef(ref, domain);
+        if (resolved) {
+            // Continue resolving nested refs in the resolved schema
+            return resolveNestedRefs(resolved, domain, depth + 1, new Set(visited));
+        }
+        // Couldn't resolve - return original ref
+        return obj;
+    }
+    // Handle arrays
+    if (Array.isArray(obj)) {
+        return obj.map((item) => resolveNestedRefs(item, domain, depth + 1, visited));
+    }
+    // Handle objects - recursively resolve all properties
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (key === "properties" && typeof value === "object" && value !== null) {
+            // Resolve each property schema
+            const props = {};
+            for (const [propKey, propValue] of Object.entries(value)) {
+                props[propKey] = resolveNestedRefs(propValue, domain, depth + 1, visited);
+            }
+            result[key] = props;
+        }
+        else if (key === "items" && typeof value === "object") {
+            // Resolve array items schema
+            result[key] = resolveNestedRefs(value, domain, depth + 1, visited);
+        }
+        else if ((key === "oneOf" || key === "anyOf" || key === "allOf") && Array.isArray(value)) {
+            // Resolve composition schemas
+            result[key] = value.map((item) => resolveNestedRefs(item, domain, depth + 1, visited));
+        }
+        else if (key === "additionalProperties" && typeof value === "object" && value !== null) {
+            // Resolve additionalProperties schema
+            result[key] = resolveNestedRefs(value, domain, depth + 1, visited);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Get fully resolved request body schema for a tool
+ *
+ * @param toolName - Tool name (e.g., "f5xc-api-virtual-http-loadbalancer-create")
+ * @returns Fully resolved schema or null if not found
+ */
+export function getResolvedRequestBodySchema(toolName) {
+    const tool = getToolByName(toolName);
+    if (!tool || !tool.requestBodySchema) {
+        return null;
+    }
+    const schema = tool.requestBodySchema;
+    // If schema has a $ref, resolve it
+    if ("$ref" in schema && typeof schema["$ref"] === "string") {
+        const resolved = resolveSchemaRef(schema["$ref"], tool.domain);
+        if (resolved) {
+            return resolveNestedRefs(resolved, tool.domain);
+        }
+    }
+    // Schema is already inline - just resolve any nested refs
+    return resolveNestedRefs(schema, tool.domain);
+}
+/**
+ * Get the x-f5xc-minimum-configuration from a tool's request body schema
+ *
+ * @param toolName - Tool name
+ * @returns Minimum configuration or null if not found
+ */
+export function getMinimumConfigurationFromSchema(toolName) {
+    const tool = getToolByName(toolName);
+    if (!tool || !tool.requestBodySchema) {
+        return null;
+    }
+    const schema = tool.requestBodySchema;
+    // If schema has a $ref, resolve it first
+    if ("$ref" in schema && typeof schema["$ref"] === "string") {
+        const resolved = resolveSchemaRef(schema["$ref"], tool.domain);
+        if (resolved && "x-f5xc-minimum-configuration" in resolved) {
+            return resolved["x-f5xc-minimum-configuration"];
+        }
+    }
+    // Check inline schema
+    if ("x-f5xc-minimum-configuration" in schema) {
+        return schema["x-f5xc-minimum-configuration"];
+    }
+    return null;
+}
+/**
+ * Extract required fields from a resolved schema
+ *
+ * @param schema - Resolved schema
+ * @param path - Current path prefix for nested fields
+ * @returns Array of required field paths
+ */
+export function extractRequiredFields(schema, path = "") {
+    const required = [];
+    // Add directly required fields
+    if (schema.required && Array.isArray(schema.required)) {
+        for (const field of schema.required) {
+            required.push(path ? `${path}.${field}` : field);
+        }
+    }
+    // Recursively check nested properties
+    if (schema.properties) {
+        for (const [key, propSchema] of Object.entries(schema.properties)) {
+            const propPath = path ? `${path}.${key}` : key;
+            required.push(...extractRequiredFields(propSchema, propPath));
+        }
+    }
+    return required;
+}
+/**
+ * Extract oneOf/anyOf groups from a schema
+ *
+ * @param schema - Resolved schema
+ * @param path - Current path prefix
+ * @returns Array of mutually exclusive groups
+ */
+export function extractMutuallyExclusiveGroups(schema, path = "") {
+    const groups = [];
+    // Check for x-ves-oneof-field annotations
+    for (const [key, value] of Object.entries(schema)) {
+        if (key.startsWith("x-ves-oneof-field-") && typeof value === "string") {
+            try {
+                const options = JSON.parse(value);
+                const choiceField = key.replace("x-ves-oneof-field-", "");
+                groups.push({
+                    fieldPath: path ? `${path}.${choiceField}` : choiceField,
+                    options: options.map((opt) => ({ fieldName: opt })),
+                    reason: `Choose one of: ${options.join(", ")}`,
+                });
+            }
+            catch {
+                // Invalid JSON, skip
+            }
+        }
+    }
+    // Check for standard oneOf/anyOf
+    if (schema.oneOf && Array.isArray(schema.oneOf)) {
+        groups.push({
+            fieldPath: path || "root",
+            options: schema.oneOf.map((opt, idx) => ({
+                fieldName: typeof opt.title === "string" ? opt.title : `option${idx + 1}`,
+                description: typeof opt.description === "string" ? opt.description : undefined,
+            })),
+            reason: "Choose one of the following options",
+        });
+    }
+    if (schema.anyOf && Array.isArray(schema.anyOf)) {
+        groups.push({
+            fieldPath: path || "root",
+            options: schema.anyOf.map((opt, idx) => ({
+                fieldName: typeof opt.title === "string" ? opt.title : `option${idx + 1}`,
+                description: typeof opt.description === "string" ? opt.description : undefined,
+            })),
+            reason: "Choose one or more of the following options",
+        });
+    }
+    // Recursively check properties
+    if (schema.properties) {
+        for (const [key, propSchema] of Object.entries(schema.properties)) {
+            const propPath = path ? `${path}.${key}` : key;
+            groups.push(...extractMutuallyExclusiveGroups(propSchema, propPath));
+        }
+    }
+    return groups;
+}
+/**
+ * Clear the schema cache (useful for testing)
+ */
+export function clearSchemaCache() {
+    schemaCache.clear();
+}
+/**
+ * Get cache statistics
+ */
+export function getSchemaCacheStats() {
+    const cachedDomains = Array.from(schemaCache.keys());
+    let totalSchemas = 0;
+    for (const cache of schemaCache.values()) {
+        totalSchemas += Object.keys(cache.schemas).length;
+    }
+    return { cachedDomains, totalSchemas };
+}
+//# sourceMappingURL=schema-loader.js.map

package/dist/tools/discovery/schema-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-loader.js","sourceRoot":"","sources":["../../../src/tools/discovery/schema-loader.ts"],"names":[],"mappings":"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"}

package/dist/tools/discovery/schema.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Schema Retrieval Module
+ *
+ * Provides full JSON schemas for F5XC API request bodies to eliminate
+ * guessing by AI assistants when constructing API payloads.
+ *
+ * Enhanced with $ref resolution, minimum configuration extraction,
+ * and smart example generation.
+ */
+import { type ResolvedSchema, type MinimumConfiguration, type MutuallyExclusiveGroup } from "./schema-loader.js";
+export type { ResolvedSchema, MinimumConfiguration, MutuallyExclusiveGroup };
+/**
+ * Get the raw JSON schema for a tool's request body (may contain $refs)
+ *
+ * @param toolName - The exact tool name
+ * @returns Raw JSON schema or null if not found
+ *
+ * @example
+ * ```typescript
+ * const schema = getRequestBodySchema("f5xc-api-virtual-http-loadbalancer-create");
+ * if (schema) {
+ *   console.log(JSON.stringify(schema, null, 2));
+ * }
+ * ```
+ */
+export declare function getRequestBodySchema(toolName: string): Record<string, unknown> | null;
+/**
+ * Get fully resolved request body schema (all $refs expanded)
+ *
+ * This is the recommended function for AI assistants as it provides
+ * the complete schema structure without any unresolved references.
+ *
+ * @param toolName - The exact tool name
+ * @returns Fully resolved schema or null if not found
+ *
+ * @example
+ * ```typescript
+ * const schema = getResolvedRequestBodySchema("f5xc-api-virtual-http-loadbalancer-create");
+ * if (schema) {
+ *   // schema.properties contains all nested structures
+ *   console.log(schema.properties);
+ * }
+ * ```
+ */
+export declare function getResolvedRequestBodySchema(toolName: string): ResolvedSchema | null;
+/**
+ * Get the full JSON schema for a tool's response
+ *
+ * @param toolName - The exact tool name
+ * @returns Complete JSON schema or null if not found
+ */
+export declare function getResponseSchema(toolName: string): Record<string, unknown> | null;
+/**
+ * Get both request and response schemas for a tool
+ *
+ * @param toolName - The exact tool name
+ * @returns Object with request and response schemas
+ */
+export declare function getToolSchemas(toolName: string): {
+    requestBody?: Record<string, unknown>;
+    response?: Record<string, unknown>;
+};
+/**
+ * Get x-f5xc-minimum-configuration from a tool's request body schema
+ *
+ * This contains rich examples (JSON, YAML, cURL), required fields,
+ * and mutually exclusive field groups from the OpenAPI spec.
+ *
+ * @param toolName - The exact tool name
+ * @returns Minimum configuration or null if not found
+ */
+export declare function getMinimumConfiguration(toolName: string): MinimumConfiguration | null;
+/**
+ * Get all required fields for a tool's request body
+ *
+ * Combines required fields from:
+ * 1. Schema 'required' arrays (recursively)
+ * 2. x-f5xc-minimum-configuration.required_fields
+ *
+ * @param toolName - The exact tool name
+ * @returns Array of required field paths (e.g., ["metadata.name", "spec.domains"])
+ */
+export declare function getRequiredFields(toolName: string): string[];
+/**
+ * Get mutually exclusive field groups for a tool
+ *
+ * These indicate fields where only one option should be specified.
+ *
+ * @param toolName - The exact tool name
+ * @returns Array of mutually exclusive groups
+ */
+export declare function getMutuallyExclusiveFields(toolName: string): MutuallyExclusiveGroup[];
+/**
+ * Generate example payload from request body schema (legacy function)
+ *
+ * This helps AI assistants understand the structure of complex nested objects
+ * without having to guess the format.
+ *
+ * @param toolName - The exact tool name
+ * @returns Example payload or null if no schema found
+ *
+ * @deprecated Use generateSmartExamplePayload for better results with $ref resolution
+ */
+export declare function generateExamplePayload(toolName: string): unknown;
+/**
+ * Generate smart example payload with $ref resolution and intelligent defaults
+ *
+ * This is the recommended function for generating example payloads as it:
+ * 1. Resolves all $ref pointers
+ * 2. Uses smart defaults based on field names
+ * 3. Falls back to x-f5xc-minimum-configuration examples when available
+ *
+ * @param toolName - The exact tool name
+ * @returns Complete example payload or null if no schema found
+ */
+export declare function generateSmartExamplePayload(toolName: string): Record<string, unknown> | null;
+/**
+ * Get comprehensive schema information for a tool
+ *
+ * This combines all schema-related data into a single response,
+ * ideal for AI assistants that need full context.
+ *
+ * @param toolName - The exact tool name
+ * @returns Comprehensive schema info or null if not found
+ */
+export declare function getComprehensiveSchemaInfo(toolName: string): {
+    resolvedSchema: ResolvedSchema;
+    requiredFields: string[];
+    mutuallyExclusiveGroups: MutuallyExclusiveGroup[];
+    examplePayload: Record<string, unknown> | null;
+    minimumConfiguration: MinimumConfiguration | null;
+    curlExample: string | null;
+} | null;
+//# sourceMappingURL=schema.d.ts.map

package/dist/tools/discovery/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/tools/discovery/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAKL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC5B,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,CAAC;AAE7E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAQrF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAEpF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAQlF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAWA;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAErF;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAoB5D;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,EAAE,CAsBrF;AA0LD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAQhE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAmB5F;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG;IAC5D,cAAc,EAAE,cAAc,CAAC;IAC/B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,uBAAuB,EAAE,sBAAsB,EAAE,CAAC;IAClD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/C,oBAAoB,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAClD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,GAAG,IAAI,CAgBP"}