@robinmordasiewicz/f5xc-api-mcp 3.0.0

package/dist/generator/openapi-parser.d.ts

@@ -0,0 +1,339 @@
+/**
+ * OpenAPI Specification Parser
+ *
+ * Parses F5 Distributed Cloud OpenAPI specifications and extracts
+ * operation metadata for MCP tool generation.
+ */
+import { z } from "zod";
+/**
+ * OpenAPI Schema Types
+ */
+declare const OpenApiParameterSchema: z.ZodObject<{
+    name: z.ZodString;
+    in: z.ZodEnum<{
+        path: "path";
+        query: "query";
+        header: "header";
+        cookie: "cookie";
+    }>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    description: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+declare const OpenApiOperationSchema: z.ZodObject<{
+    operationId: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        in: z.ZodEnum<{
+            path: "path";
+            query: "query";
+            header: "header";
+            cookie: "cookie";
+        }>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+        schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+    requestBody: z.ZodOptional<z.ZodObject<{
+        required: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+        content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    responses: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    security: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>>;
+    "x-ves-proto-rpc": z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const OpenApiSpecSchema: z.ZodObject<{
+    openapi: z.ZodOptional<z.ZodString>;
+    swagger: z.ZodOptional<z.ZodString>;
+    info: z.ZodObject<{
+        title: z.ZodString;
+        version: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    paths: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        get: z.ZodOptional<z.ZodObject<{
+            operationId: z.ZodOptional<z.ZodString>;
+            summary: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                in: z.ZodEnum<{
+                    path: "path";
+                    query: "query";
+                    header: "header";
+                    cookie: "cookie";
+                }>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+                schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>>;
+            requestBody: z.ZodOptional<z.ZodObject<{
+                required: z.ZodOptional<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+                content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+            responses: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                description: z.ZodOptional<z.ZodString>;
+                content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>>;
+            security: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>>;
+            "x-ves-proto-rpc": z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        post: z.ZodOptional<z.ZodObject<{
+            operationId: z.ZodOptional<z.ZodString>;
+            summary: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                in: z.ZodEnum<{
+                    path: "path";
+                    query: "query";
+                    header: "header";
+                    cookie: "cookie";
+                }>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+                schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>>;
+            requestBody: z.ZodOptional<z.ZodObject<{
+                required: z.ZodOptional<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+                content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+            responses: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                description: z.ZodOptional<z.ZodString>;
+                content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>>;
+            security: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>>;
+            "x-ves-proto-rpc": z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        put: z.ZodOptional<z.ZodObject<{
+            operationId: z.ZodOptional<z.ZodString>;
+            summary: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                in: z.ZodEnum<{
+                    path: "path";
+                    query: "query";
+                    header: "header";
+                    cookie: "cookie";
+                }>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+                schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>>;
+            requestBody: z.ZodOptional<z.ZodObject<{
+                required: z.ZodOptional<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+                content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+            responses: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                description: z.ZodOptional<z.ZodString>;
+                content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>>;
+            security: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>>;
+            "x-ves-proto-rpc": z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        delete: z.ZodOptional<z.ZodObject<{
+            operationId: z.ZodOptional<z.ZodString>;
+            summary: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                in: z.ZodEnum<{
+                    path: "path";
+                    query: "query";
+                    header: "header";
+                    cookie: "cookie";
+                }>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+                schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>>;
+            requestBody: z.ZodOptional<z.ZodObject<{
+                required: z.ZodOptional<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+                content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+            responses: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                description: z.ZodOptional<z.ZodString>;
+                content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>>;
+            security: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>>;
+            "x-ves-proto-rpc": z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        patch: z.ZodOptional<z.ZodObject<{
+            operationId: z.ZodOptional<z.ZodString>;
+            summary: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                in: z.ZodEnum<{
+                    path: "path";
+                    query: "query";
+                    header: "header";
+                    cookie: "cookie";
+                }>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+                schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>>;
+            requestBody: z.ZodOptional<z.ZodObject<{
+                required: z.ZodOptional<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+                content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+            responses: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                description: z.ZodOptional<z.ZodString>;
+                content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>>;
+            security: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>>;
+            "x-ves-proto-rpc": z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            in: z.ZodEnum<{
+                path: "path";
+                query: "query";
+                header: "header";
+                cookie: "cookie";
+            }>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            description: z.ZodOptional<z.ZodString>;
+            schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    components: z.ZodOptional<z.ZodObject<{
+        schemas: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        securitySchemes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type OpenApiSpec = z.infer<typeof OpenApiSpecSchema>;
+export type OpenApiOperation = z.infer<typeof OpenApiOperationSchema>;
+export type OpenApiParameter = z.infer<typeof OpenApiParameterSchema>;
+/**
+ * Parsed operation with metadata for tool generation
+ */
+export interface ParsedOperation {
+    /** Generated tool name */
+    toolName: string;
+    /** HTTP method */
+    method: string;
+    /** API path */
+    path: string;
+    /** Operation type (create, list, get, update, delete) */
+    operation: string;
+    /** Domain category (waap, dns, network, etc.) */
+    domain: string;
+    /** Resource type */
+    resource: string;
+    /** Human-readable summary */
+    summary: string;
+    /** Detailed description */
+    description: string;
+    /** Path parameters */
+    pathParameters: OpenApiParameter[];
+    /** Query parameters */
+    queryParameters: OpenApiParameter[];
+    /** Request body schema */
+    requestBodySchema: Record<string, unknown> | null;
+    /** Response schema */
+    responseSchema: Record<string, unknown> | null;
+    /** Required parameters */
+    requiredParams: string[];
+    /** Original operation ID */
+    operationId: string | null;
+    /** Tags for categorization */
+    tags: string[];
+    /** Source spec file */
+    sourceFile: string;
+}
+/**
+ * Parsed specification file
+ */
+export interface ParsedSpec {
+    /** File path */
+    filePath: string;
+    /** Spec title */
+    title: string;
+    /** Spec version */
+    version: string;
+    /** Parsed operations */
+    operations: ParsedOperation[];
+    /** Component schemas */
+    schemas: Record<string, unknown>;
+}
+/**
+ * Parse a single OpenAPI specification file
+ * @param filePath - Absolute path to the spec file
+ * @param basePath - Optional base path for creating relative sourceFile paths (for deterministic output)
+ * @deprecated Use parseDomainSpecFile() for pre-enriched domain specs from robinmordasiewicz/f5xc-api-enriched
+ */
+export declare function parseSpecFile(filePath: string, basePath?: string): ParsedSpec | null;
+/**
+ * Parse all spec files in a directory
+ * @deprecated Use parseDomainsDirectory() for pre-enriched domain specs from robinmordasiewicz/f5xc-api-enriched
+ */
+export declare function parseSpecDirectory(dirPath: string): ParsedSpec[];
+/**
+ * Get all unique operations across all specs
+ */
+export declare function getAllOperations(specs: ParsedSpec[]): ParsedOperation[];
+/**
+ * Group operations by domain
+ */
+export declare function groupOperationsByDomain(operations: ParsedOperation[]): Map<string, ParsedOperation[]>;
+/**
+ * Parse a single enriched domain specification file
+ * Domain is derived from the filename (e.g., load_balancer.json → load_balancer)
+ *
+ * @param filePath - Absolute path to the domain spec file
+ * @param basePath - Optional base path for creating relative sourceFile paths
+ */
+export declare function parseDomainSpecFile(filePath: string, basePath?: string): ParsedSpec | null;
+/**
+ * Parse all enriched domain specs from a directory
+ * This is the primary entry point for the new enriched spec format
+ *
+ * @param dirPath - Path to the domains directory (specs/domains/)
+ */
+export declare function parseDomainsDirectory(dirPath: string): ParsedSpec[];
+export {};
+//# sourceMappingURL=openapi-parser.d.ts.map

package/dist/generator/openapi-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-parser.d.ts","sourceRoot":"","sources":["../../src/generator/openapi-parser.ts"],"names":[],"mappings":"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"}