@robinmordasiewicz/f5xc-api-mcp 1.0.82-2512312028

package/dist/tools/discovery/index.js

@@ -0,0 +1,361 @@
+/**
+ * Discovery Module - Dynamic Tool Discovery for Token Efficiency
+ *
+ * This module implements the Speakeasy-style dynamic toolset pattern
+ * that reduces token consumption by 95%+ through lazy loading.
+ *
+ * Instead of loading all 1,400+ tools upfront (~535K tokens), this module
+ * exposes three meta-tools that load tool schemas on-demand:
+ *
+ * 1. search_tools - Find tools matching a natural language query
+ * 2. describe_tool - Get full schema for a specific tool
+ * 3. execute_tool - Execute a discovered tool
+ *
+ * Token Impact:
+ * - Before: 535,000 tokens loaded at server start
+ * - After: ~500 tokens (meta-tools) + ~375 tokens per tool used
+ */
+// Index loader exports
+export { getToolIndex, clearIndexCache, getIndexMetadata, toolExists, getToolEntry, } from "./index-loader.js";
+// Search exports
+export { searchTools, getToolsByDomain, getToolsByResource, getAvailableDomains, getToolCountByDomain, } from "./search.js";
+// Describe exports
+export { describeTool, describeTools, describeToolSafe, describeToolCompact, getFullToolSchema, getOptimizationStats, } from "./describe.js";
+// Execute exports
+export { executeTool, validateExecuteParams } from "./execute.js";
+export { getConsolidatedIndex, clearConsolidatedCache, getConsolidatedResource, getConsolidatedByDomain, searchConsolidatedResources, resolveConsolidatedTool, getConsolidationStats, } from "./consolidate.js";
+// Dependency discovery exports
+export { loadDependencyGraph, clearDependencyCache, getResourceDependencies, getCreationOrder, getPrerequisiteResources, getDependentResources, getOneOfGroups, getSubscriptionRequirements, getResourcesRequiringSubscription, getAvailableAddonServices, generateDependencyReport, getDependencyStats, getResourcesInDomain, getAllDependencyDomains, } from "./dependencies.js";
+export { validateToolParams, formatValidationResult } from "./validate.js";
+export { resolveDependencies, formatCreationPlan, generateCompactPlan } from "./resolver.js";
+export { estimateToolTokens, estimateToolLatency, estimateToolCost, estimateMultipleToolsCost, estimateWorkflowCost, formatCostEstimate, formatWorkflowCostEstimate, } from "./cost-estimator.js";
+export { getDomainBestPractices, queryBestPractices, getAllDomainsSummary, formatBestPractices, } from "./best-practices.js";
+/**
+ * MCP Tool Definitions for the discovery meta-tools
+ *
+ * These are the three tools that get registered with the MCP server
+ * instead of the 1,400+ individual API tools.
+ */
+export const DISCOVERY_TOOLS = {
+    search: {
+        name: "f5xc-api-search-tools",
+        description: "Search for F5XC API tools using natural language. Returns matching tools with relevance scores. " +
+            "Use this to find tools for specific operations like 'create load balancer' or 'list DNS zones'.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Natural language search query (e.g., 'http load balancer', 'create origin pool', 'delete dns zone')",
+                },
+                limit: {
+                    type: "number",
+                    description: "Maximum number of results to return (default: 10, max: 50)",
+                    default: 10,
+                },
+                domains: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Filter by domain(s): waap, dns, core, network, site, security, appstack",
+                },
+                operations: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Filter by operation type(s): create, get, list, update, delete",
+                },
+                excludeDangerous: {
+                    type: "boolean",
+                    description: "Exclude high-danger operations from results",
+                },
+                excludeDeprecated: {
+                    type: "boolean",
+                    description: "Exclude deprecated operations from results",
+                },
+                includeDependencies: {
+                    type: "boolean",
+                    description: "Include prerequisite hints for create operations",
+                },
+            },
+            required: ["query"],
+        },
+    },
+    describe: {
+        name: "f5xc-api-describe-tool",
+        description: "Get detailed information about a specific F5XC API tool including parameters, request body schema, " +
+            "and usage examples. Use search_tools first to find the tool name.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                toolName: {
+                    type: "string",
+                    description: "The exact tool name (e.g., 'f5xc-api-waap-http-loadbalancer-create')",
+                },
+            },
+            required: ["toolName"],
+        },
+    },
+    execute: {
+        name: "f5xc-api-execute-tool",
+        description: "Execute an F5XC API tool. In authenticated mode, makes the actual API call. " +
+            "In documentation mode, returns CLI equivalents and curl examples.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                toolName: {
+                    type: "string",
+                    description: "The exact tool name to execute",
+                },
+                pathParams: {
+                    type: "object",
+                    description: "Path parameters (e.g., { namespace: 'default', name: 'example-resource' })",
+                    additionalProperties: { type: "string" },
+                },
+                queryParams: {
+                    type: "object",
+                    description: "Query parameters for the request",
+                    additionalProperties: { type: "string" },
+                },
+                body: {
+                    type: "object",
+                    description: "Request body for POST/PUT/PATCH operations",
+                },
+            },
+            required: ["toolName"],
+        },
+    },
+    serverInfo: {
+        name: "f5xc-api-server-info",
+        description: "Get F5XC API MCP server information including authentication status, available domains, " +
+            "and total tool count. Use this to understand server capabilities.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    searchResources: {
+        name: "f5xc-api-search-resources",
+        description: "Search for F5XC resources (consolidated view). Returns resources with their available CRUD operations. " +
+            "More efficient than searching individual tools - one result per resource instead of 5 CRUD tools.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Natural language search query (e.g., 'http load balancer', 'origin pool', 'dns zone')",
+                },
+                limit: {
+                    type: "number",
+                    description: "Maximum number of results to return (default: 10)",
+                    default: 10,
+                },
+                domains: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Filter by domain(s): waap, dns, core, network, site, security, appstack",
+                },
+            },
+            required: ["query"],
+        },
+    },
+    executeResource: {
+        name: "f5xc-api-execute-resource",
+        description: "Execute a CRUD operation on a consolidated F5XC resource. Specify the resource name and operation. " +
+            "Routes to the correct underlying API tool automatically.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                resourceName: {
+                    type: "string",
+                    description: "The consolidated resource name (e.g., 'f5xc-api-waap-http-loadbalancer')",
+                },
+                operation: {
+                    type: "string",
+                    enum: ["create", "get", "list", "update", "delete"],
+                    description: "The CRUD operation to perform",
+                },
+                pathParams: {
+                    type: "object",
+                    description: "Path parameters (e.g., { namespace: 'default', name: 'example-resource' })",
+                    additionalProperties: { type: "string" },
+                },
+                queryParams: {
+                    type: "object",
+                    description: "Query parameters for the request",
+                    additionalProperties: { type: "string" },
+                },
+                body: {
+                    type: "object",
+                    description: "Request body for create/update operations",
+                },
+            },
+            required: ["resourceName", "operation"],
+        },
+    },
+    dependencies: {
+        name: "f5xc-api-dependencies",
+        description: "Get dependency information for F5XC resources. Returns prerequisites (resources that must exist before creation), " +
+            "dependents (resources that would break if deleted), mutually exclusive field options (oneOf groups), " +
+            "subscription requirements, and recommended creation order. Essential for understanding resource relationships.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                resource: {
+                    type: "string",
+                    description: "The resource name (e.g., 'http-loadbalancer', 'origin-pool')",
+                },
+                domain: {
+                    type: "string",
+                    description: "The domain containing the resource (e.g., 'virtual', 'network', 'api')",
+                },
+                action: {
+                    type: "string",
+                    enum: ["prerequisites", "dependents", "oneOf", "subscriptions", "creationOrder", "full"],
+                    description: "Type of information to retrieve: " +
+                        "'prerequisites' - resources that must exist before creation, " +
+                        "'dependents' - resources that depend on this one, " +
+                        "'oneOf' - mutually exclusive field options, " +
+                        "'subscriptions' - required addon services, " +
+                        "'creationOrder' - topologically sorted creation sequence, " +
+                        "'full' - all dependency information (default)",
+                    default: "full",
+                },
+            },
+            required: ["resource", "domain"],
+        },
+    },
+    dependencyStats: {
+        name: "f5xc-api-dependency-stats",
+        description: "Get statistics about the F5XC resource dependency graph including total resources, " +
+            "dependency counts, available addon services, and graph metadata.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    validateParams: {
+        name: "f5xc-api-validate-params",
+        description: "Validate parameters for an F5XC API tool before execution. Checks required fields, " +
+            "parameter types, and oneOf constraints. Returns detailed error messages for invalid inputs.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                toolName: {
+                    type: "string",
+                    description: "The exact tool name to validate parameters for",
+                },
+                pathParams: {
+                    type: "object",
+                    description: "Path parameters to validate (e.g., { namespace: 'default', name: 'my-resource' })",
+                    additionalProperties: { type: "string" },
+                },
+                queryParams: {
+                    type: "object",
+                    description: "Query parameters to validate",
+                    additionalProperties: { type: "string" },
+                },
+                body: {
+                    type: "object",
+                    description: "Request body to validate",
+                },
+            },
+            required: ["toolName"],
+        },
+    },
+    resolveDependencies: {
+        name: "f5xc-api-resolve-dependencies",
+        description: "Generate a complete creation plan for an F5XC resource with all transitive dependencies. " +
+            "Returns step-by-step workflow with tool names, required inputs, and oneOf choices. " +
+            "Essential for understanding what resources must be created before the target resource.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                resource: {
+                    type: "string",
+                    description: "The target resource to create (e.g., 'http-loadbalancer', 'origin-pool')",
+                },
+                domain: {
+                    type: "string",
+                    description: "The domain containing the resource (e.g., 'virtual', 'network')",
+                },
+                existingResources: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Resources that already exist (will be skipped). Format: 'domain/resource' " +
+                        "(e.g., ['network/origin-pool', 'certificates/certificate'])",
+                },
+                includeOptional: {
+                    type: "boolean",
+                    description: "Include optional dependencies in the plan (default: false)",
+                    default: false,
+                },
+                maxDepth: {
+                    type: "number",
+                    description: "Maximum depth for dependency traversal (default: 10)",
+                    default: 10,
+                },
+                expandAlternatives: {
+                    type: "boolean",
+                    description: "Include alternative paths for oneOf choices (default: false)",
+                    default: false,
+                },
+            },
+            required: ["resource", "domain"],
+        },
+    },
+    estimateCost: {
+        name: "f5xc-api-estimate-cost",
+        description: "Estimate token usage and latency for F5XC API tool calls. Provides cost estimates for individual tools, " +
+            "multiple tools, or complete creation plan workflows. Useful for planning and optimizing API interactions.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                toolName: {
+                    type: "string",
+                    description: "A single tool name to estimate (e.g., 'f5xc-api-waap-http-loadbalancer-create')",
+                },
+                toolNames: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Multiple tool names to estimate costs for",
+                },
+                plan: {
+                    type: "object",
+                    description: "A CreationPlan object from f5xc-api-resolve-dependencies to estimate workflow costs",
+                },
+                detailed: {
+                    type: "boolean",
+                    description: "Include detailed breakdown of token usage and latency (default: true)",
+                    default: true,
+                },
+            },
+        },
+    },
+    bestPractices: {
+        name: "f5xc-api-best-practices",
+        description: "Get domain-specific best practices for F5XC API operations. Includes common errors with resolutions, " +
+            "recommended workflows, danger level analysis, security notes, and performance tips.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                domain: {
+                    type: "string",
+                    description: "Domain to get best practices for (e.g., 'virtual', 'dns', 'certificates'). " +
+                        "Omit to list available domains.",
+                },
+                aspect: {
+                    type: "string",
+                    enum: ["errors", "workflows", "danger", "security", "performance", "all"],
+                    description: "Specific aspect to retrieve: 'errors' (common errors), 'workflows' (recommended workflows), " +
+                        "'danger' (danger level analysis), 'security' (security notes), 'performance' (tips), 'all' (default)",
+                    default: "all",
+                },
+                detailed: {
+                    type: "boolean",
+                    description: "Include detailed breakdowns (default: true)",
+                    default: true,
+                },
+            },
+        },
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/tools/discovery/index.js.map

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

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

@@ -0,0 +1,119 @@
+/**
+ * Interactive Dependency Resolver
+ *
+ * Generates complete creation plans with all transitive dependencies,
+ * step-by-step workflows with tool names and required inputs,
+ * and handles oneOf groups with alternative paths.
+ */
+/**
+ * A single step in a creation workflow
+ */
+export interface WorkflowStep {
+    /** Step number in the sequence */
+    stepNumber: number;
+    /** Action description */
+    action: "create" | "configure" | "verify";
+    /** Resource domain */
+    domain: string;
+    /** Resource type */
+    resource: string;
+    /** Full tool name for this step */
+    toolName: string;
+    /** Resources that must be created before this step */
+    dependsOn: string[];
+    /** Whether this step is optional */
+    optional: boolean;
+    /** Required input parameters */
+    requiredInputs: string[];
+    /** OneOf choices that must be made for this resource */
+    oneOfChoices?: Array<{
+        field: string;
+        options: string[];
+        description?: string;
+    }>;
+    /** Notes or hints for this step */
+    notes?: string;
+}
+/**
+ * Alternative path in a creation plan (for oneOf choices)
+ */
+export interface AlternativePath {
+    /** Name of the choice field */
+    choiceField: string;
+    /** Selected option */
+    selectedOption: string;
+    /** Steps specific to this alternative */
+    steps: WorkflowStep[];
+    /** Description of what this alternative provides */
+    description?: string;
+}
+/**
+ * Complete creation plan for a resource
+ */
+export interface CreationPlan {
+    /** Target resource to create */
+    targetResource: string;
+    /** Target domain */
+    targetDomain: string;
+    /** Total number of steps */
+    totalSteps: number;
+    /** Ordered workflow steps */
+    steps: WorkflowStep[];
+    /** Warnings about the plan */
+    warnings: string[];
+    /** Alternative paths for oneOf choices */
+    alternatives: AlternativePath[];
+    /** Required subscriptions */
+    subscriptions: string[];
+    /** Resources that already exist (skip these steps) */
+    existingResources?: string[];
+    /** Estimated complexity (low, medium, high) */
+    complexity: "low" | "medium" | "high";
+}
+/**
+ * Parameters for resolving dependencies
+ */
+export interface ResolveParams {
+    /** Target resource to create */
+    resource: string;
+    /** Domain containing the resource */
+    domain: string;
+    /** Resources that already exist (will be skipped) */
+    existingResources?: string[];
+    /** Whether to include optional dependencies */
+    includeOptional?: boolean;
+    /** Maximum depth for dependency traversal */
+    maxDepth?: number;
+    /** Whether to expand oneOf alternatives */
+    expandAlternatives?: boolean;
+}
+/**
+ * Result of dependency resolution
+ */
+export interface ResolveResult {
+    success: boolean;
+    plan?: CreationPlan;
+    error?: string;
+}
+/**
+ * Resolve dependencies and generate a complete creation plan
+ */
+export declare function resolveDependencies(params: ResolveParams): ResolveResult;
+/**
+ * Format a creation plan for human-readable output
+ */
+export declare function formatCreationPlan(plan: CreationPlan): string;
+/**
+ * Generate a compact JSON creation plan for programmatic use
+ */
+export declare function generateCompactPlan(params: ResolveParams): {
+    success: boolean;
+    steps?: Array<{
+        tool: string;
+        resource: string;
+        inputs: string[];
+        choices?: Record<string, string[]>;
+    }>;
+    error?: string;
+};
+//# sourceMappingURL=resolver.d.ts.map

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

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