@robinmordasiewicz/f5xc-api-mcp 3.0.0

package/dist/resources/handlers.d.ts

@@ -0,0 +1,72 @@
+/**
+ * MCP Resource Handlers
+ *
+ * Implements resource read handlers for F5XC configuration objects.
+ * Supports both documentation mode (returns schema info) and
+ * execution mode (fetches actual resource data).
+ */
+import { ResourceType } from "./templates.js";
+import { CredentialManager } from "../auth/credential-manager.js";
+import { HttpClient } from "../auth/http-client.js";
+/**
+ * Resource read result
+ */
+export interface ResourceReadResult {
+    /** Resource URI */
+    uri: string;
+    /** MIME type of content */
+    mimeType: string;
+    /** Resource content */
+    content: string;
+    /** Whether this is documentation or actual data */
+    mode: "documentation" | "execution";
+}
+/**
+ * Resource documentation (for unauthenticated mode)
+ */
+export interface ResourceDocumentation {
+    /** Resource URI */
+    uri: string;
+    /** Resource type information */
+    resourceType: ResourceType;
+    /** API path for this resource */
+    apiPath: string;
+    /** Example resource structure */
+    exampleResource: Record<string, unknown>;
+    /** f5xcctl command to get this resource */
+    f5xcctlCommand: string;
+    /** Terraform data source */
+    terraformDataSource: string;
+    /** Related resources */
+    relatedResources: string[];
+}
+/**
+ * Resource Handler class
+ */
+export declare class ResourceHandler {
+    private credentialManager;
+    private httpClient;
+    constructor(credentialManager: CredentialManager, httpClient: HttpClient | null);
+    /**
+     * Read a resource by URI
+     */
+    readResource(uri: string): Promise<ResourceReadResult>;
+    /**
+     * List available resource templates
+     */
+    listResourceTemplates(): Array<{
+        uriTemplate: string;
+        name: string;
+        description: string;
+        mimeType: string;
+    }>;
+    /**
+     * List resources of a specific type in a namespace
+     */
+    listResources(namespace: string, resourceType: string): Promise<ResourceReadResult>;
+}
+/**
+ * Create resource handler
+ */
+export declare function createResourceHandler(credentialManager: CredentialManager, httpClient: HttpClient | null): ResourceHandler;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/resources/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/resources/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAKL,YAAY,EACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAY,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIpD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mBAAmB;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,IAAI,EAAE,eAAe,GAAG,WAAW,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mBAAmB;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,YAAY,EAAE,YAAY,CAAC;IAC3B,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,2CAA2C;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wBAAwB;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AA2KD;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,UAAU,CAAoB;gBAE1B,iBAAiB,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI;IAK/E;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAmD5D;;OAEG;IACH,qBAAqB,IAAI,KAAK,CAAC;QAC7B,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IAaF;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAoD1F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,iBAAiB,EAAE,iBAAiB,EACpC,UAAU,EAAE,UAAU,GAAG,IAAI,GAC5B,eAAe,CAEjB"}

package/dist/resources/handlers.js

@@ -0,0 +1,279 @@
+/**
+ * MCP Resource Handlers
+ *
+ * Implements resource read handlers for F5XC configuration objects.
+ * Supports both documentation mode (returns schema info) and
+ * execution mode (fetches actual resource data).
+ */
+import { parseResourceUri, getResourceType, buildApiPath, RESOURCE_TYPES, } from "./templates.js";
+import { AuthMode } from "../auth/credential-manager.js";
+import { logger } from "../utils/logging.js";
+import { F5XCApiError } from "../utils/error-handling.js";
+/**
+ * Generate example resource structure based on type
+ */
+function generateExampleResource(resourceType, namespace, name) {
+    const baseMetadata = {
+        name,
+        namespace,
+        labels: {},
+        annotations: {},
+        description: `Example ${resourceType}`,
+    };
+    switch (resourceType) {
+        case "http_loadbalancer":
+            return {
+                metadata: baseMetadata,
+                spec: {
+                    domains: ["app.example.com"],
+                    http: {
+                        dns_volterra_managed: true,
+                    },
+                    default_route_pools: [
+                        {
+                            pool: {
+                                tenant: "your-tenant",
+                                namespace,
+                                name: "example-origin-pool",
+                            },
+                            weight: 1,
+                        },
+                    ],
+                    advertise_on_public_default_vip: {},
+                },
+                system_metadata: {
+                    creation_timestamp: "2024-01-01T00:00:00Z",
+                    modification_timestamp: "2024-01-01T00:00:00Z",
+                },
+            };
+        case "origin_pool":
+            return {
+                metadata: baseMetadata,
+                spec: {
+                    origin_servers: [
+                        {
+                            public_ip: {
+                                ip: "10.0.0.1",
+                            },
+                        },
+                    ],
+                    port: 80,
+                    no_tls: {},
+                    endpoint_selection: "LOCAL_PREFERRED",
+                    loadbalancer_algorithm: "ROUND_ROBIN",
+                },
+                system_metadata: {
+                    creation_timestamp: "2024-01-01T00:00:00Z",
+                },
+            };
+        case "dns_zone":
+            return {
+                metadata: baseMetadata,
+                spec: {
+                    primary: {
+                        soa_parameters: {
+                            refresh: 3600,
+                            retry: 600,
+                            expire: 604800,
+                            negative_ttl: 1800,
+                        },
+                        default_rr_set_group: [],
+                    },
+                },
+                system_metadata: {
+                    creation_timestamp: "2024-01-01T00:00:00Z",
+                },
+            };
+        case "app_firewall":
+            return {
+                metadata: baseMetadata,
+                spec: {
+                    detection_settings: {
+                        signature_selection_setting: {
+                            default_attack_type_settings: {},
+                            high_medium_accuracy_signatures: {},
+                        },
+                        enable_suppression: {},
+                        enable_threat_campaigns: {},
+                    },
+                    bot_protection_setting: {
+                        malicious_bot_action: "BLOCK",
+                        suspicious_bot_action: "REPORT",
+                        good_bot_action: "REPORT",
+                    },
+                },
+                system_metadata: {
+                    creation_timestamp: "2024-01-01T00:00:00Z",
+                },
+            };
+        default:
+            return {
+                metadata: baseMetadata,
+                spec: {},
+                system_metadata: {
+                    creation_timestamp: "2024-01-01T00:00:00Z",
+                },
+            };
+    }
+}
+/**
+ * Generate f5xcctl command for resource
+ */
+function generateF5xcctlCommand(resourceType, namespace, name) {
+    const rt = resourceType.replace(/-/g, "_");
+    return `f5xcctl get ${rt} ${name} -n ${namespace} -o yaml`;
+}
+/**
+ * Generate Terraform data source
+ */
+function generateTerraformDataSource(resourceType, namespace, name) {
+    const tfResource = `volterra_${resourceType.replace(/-/g, "_")}`;
+    return `data "${tfResource}" "example" {
+  name      = "${name}"
+  namespace = "${namespace}"
+}`;
+}
+/**
+ * Build documentation response for a resource
+ */
+function buildDocumentationResponse(uri, _tenant, namespace, resourceType, name) {
+    const rt = getResourceType(resourceType);
+    if (!rt) {
+        throw new F5XCApiError(`Unknown resource type: ${resourceType}`, 400);
+    }
+    const apiPath = buildApiPath(resourceType, namespace, name);
+    return {
+        uri,
+        resourceType: rt,
+        apiPath: apiPath ?? "",
+        exampleResource: generateExampleResource(resourceType, namespace, name),
+        f5xcctlCommand: generateF5xcctlCommand(resourceType, namespace, name),
+        terraformDataSource: generateTerraformDataSource(resourceType, namespace, name),
+        relatedResources: rt.relatedResources ?? [],
+    };
+}
+/**
+ * Resource Handler class
+ */
+export class ResourceHandler {
+    credentialManager;
+    httpClient;
+    constructor(credentialManager, httpClient) {
+        this.credentialManager = credentialManager;
+        this.httpClient = httpClient;
+    }
+    /**
+     * Read a resource by URI
+     */
+    async readResource(uri) {
+        const parsed = parseResourceUri(uri);
+        if (!parsed) {
+            throw new F5XCApiError(`Invalid resource URI: ${uri}`, 400);
+        }
+        const { tenant, namespace, resourceType, name } = parsed;
+        // Check if resource type is valid
+        const rt = getResourceType(resourceType);
+        if (!rt) {
+            throw new F5XCApiError(`Unknown resource type: ${resourceType}`, 400);
+        }
+        // Documentation mode - return schema and examples
+        if (this.credentialManager.getAuthMode() === AuthMode.NONE || !this.httpClient) {
+            const doc = buildDocumentationResponse(uri, tenant, namespace, resourceType, name);
+            return {
+                uri,
+                mimeType: "application/json",
+                content: JSON.stringify(doc, null, 2),
+                mode: "documentation",
+            };
+        }
+        // Execution mode - fetch actual resource
+        const apiPath = buildApiPath(resourceType, namespace, name);
+        if (!apiPath) {
+            throw new F5XCApiError(`Cannot build API path for: ${uri}`, 400);
+        }
+        try {
+            const response = await this.httpClient.get(apiPath);
+            return {
+                uri,
+                mimeType: "application/json",
+                content: JSON.stringify(response.data, null, 2),
+                mode: "execution",
+            };
+        }
+        catch (error) {
+            logger.error(`Failed to read resource: ${uri}`, {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+    }
+    /**
+     * List available resource templates
+     */
+    listResourceTemplates() {
+        const tenant = this.credentialManager.getTenant() ?? "{tenant}";
+        return Object.values(RESOURCE_TYPES).map((rt) => ({
+            uriTemplate: rt.namespaceScoped
+                ? `f5xc://${tenant}/{namespace}/${rt.type}/{name}`
+                : `f5xc://${tenant}/system/${rt.type}/{name}`,
+            name: rt.name,
+            description: rt.description,
+            mimeType: "application/json",
+        }));
+    }
+    /**
+     * List resources of a specific type in a namespace
+     */
+    async listResources(namespace, resourceType) {
+        const rt = getResourceType(resourceType);
+        if (!rt) {
+            throw new F5XCApiError(`Unknown resource type: ${resourceType}`, 400);
+        }
+        const tenant = this.credentialManager.getTenant() ?? "unknown";
+        const uri = `f5xc://${tenant}/${namespace}/${resourceType}`;
+        // Documentation mode
+        if (this.credentialManager.getAuthMode() === AuthMode.NONE || !this.httpClient) {
+            const doc = {
+                uri,
+                resourceType: rt,
+                apiPath: buildApiPath(resourceType, namespace),
+                note: "In documentation mode. Provide F5XC credentials to list actual resources.",
+                f5xcctlCommand: `f5xcctl get ${resourceType.replace(/-/g, "_")}s -n ${namespace}`,
+            };
+            return {
+                uri,
+                mimeType: "application/json",
+                content: JSON.stringify(doc, null, 2),
+                mode: "documentation",
+            };
+        }
+        // Execution mode - list resources
+        const apiPath = buildApiPath(resourceType, namespace);
+        if (!apiPath) {
+            throw new F5XCApiError(`Cannot build API path for listing: ${resourceType}`, 400);
+        }
+        try {
+            const response = await this.httpClient.get(apiPath);
+            return {
+                uri,
+                mimeType: "application/json",
+                content: JSON.stringify(response.data, null, 2),
+                mode: "execution",
+            };
+        }
+        catch (error) {
+            logger.error(`Failed to list resources: ${resourceType}`, {
+                namespace,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+    }
+}
+/**
+ * Create resource handler
+ */
+export function createResourceHandler(credentialManager, httpClient) {
+    return new ResourceHandler(credentialManager, httpClient);
+}
+//# sourceMappingURL=handlers.js.map

package/dist/resources/handlers.js.map

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

package/dist/resources/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Resources Module - Export all resource utilities
+ */
+export { RESOURCE_SCHEMES, RESOURCE_TYPES, buildResourceUri, parseResourceUri, getResourceType, getResourceTypesByTier, buildApiPath, } from "./templates.js";
+export type { ResourceType } from "./templates.js";
+export { ResourceHandler, createResourceHandler } from "./handlers.js";
+export type { ResourceReadResult, ResourceDocumentation } from "./handlers.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEvE,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/resources/index.js

@@ -0,0 +1,6 @@
+/**
+ * Resources Module - Export all resource utilities
+ */
+export { RESOURCE_SCHEMES, RESOURCE_TYPES, buildResourceUri, parseResourceUri, getResourceType, getResourceTypesByTier, buildApiPath, } from "./templates.js";
+export { ResourceHandler, createResourceHandler } from "./handlers.js";
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/resources/templates.d.ts

@@ -0,0 +1,86 @@
+/**
+ * MCP Resource URI Templates
+ *
+ * Defines URI templates for F5XC configuration resources.
+ * URI scheme: f5xc://{tenant}/{namespace}/{resource-type}/{name}
+ */
+/**
+ * Resource URI schemes
+ */
+export declare const RESOURCE_SCHEMES: {
+    /** Base scheme for all F5XC resources */
+    readonly BASE: "f5xc://";
+    /** System namespace for global resources */
+    readonly SYSTEM: "system";
+    /** Shared namespace for cross-tenant resources */
+    readonly SHARED: "shared";
+};
+/**
+ * Resource type definitions
+ */
+export interface ResourceType {
+    /** Resource type identifier */
+    type: string;
+    /** Human-readable name */
+    name: string;
+    /** Resource description */
+    description: string;
+    /** API path template */
+    apiPath: string;
+    /** Whether resource is namespace-scoped */
+    namespaceScoped: boolean;
+    /** Subscription tier required */
+    tier: "NO_TIER" | "STANDARD" | "ADVANCED";
+    /** Related resources */
+    relatedResources?: string[];
+}
+/**
+ * All supported resource types
+ */
+export declare const RESOURCE_TYPES: Record<string, ResourceType>;
+/**
+ * Build resource URI from components
+ *
+ * @param tenant - Tenant name
+ * @param namespace - Namespace (or 'system'/'shared')
+ * @param resourceType - Resource type identifier
+ * @param name - Resource name
+ * @returns Formatted resource URI
+ */
+export declare function buildResourceUri(tenant: string, namespace: string, resourceType: string, name: string): string;
+/**
+ * Parse resource URI into components
+ *
+ * @param uri - Resource URI to parse
+ * @returns Parsed components or null if invalid
+ */
+export declare function parseResourceUri(uri: string): {
+    tenant: string;
+    namespace: string;
+    resourceType: string;
+    name: string;
+} | null;
+/**
+ * Get resource type definition
+ *
+ * @param type - Resource type identifier
+ * @returns Resource type definition or undefined
+ */
+export declare function getResourceType(type: string): ResourceType | undefined;
+/**
+ * Get all resource types for a tier
+ *
+ * @param tier - Subscription tier
+ * @returns Array of resource types
+ */
+export declare function getResourceTypesByTier(tier: "NO_TIER" | "STANDARD" | "ADVANCED"): ResourceType[];
+/**
+ * Build API path for a resource
+ *
+ * @param resourceType - Resource type identifier
+ * @param namespace - Namespace name
+ * @param name - Resource name (optional)
+ * @returns API path
+ */
+export declare function buildApiPath(resourceType: string, namespace: string, name?: string): string | null;
+//# sourceMappingURL=templates.d.ts.map

package/dist/resources/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/resources/templates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B,yCAAyC;;IAGzC,4CAA4C;;IAG5C,kDAAkD;;CAE1C,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,eAAe,EAAE,OAAO,CAAC;IACzB,iCAAiC;IACjC,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;IAC1C,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CA+JvD,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,GACX,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,GACV;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAmBlF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEtE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,EAAE,CAEhG;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CAaf"}