@robinmordasiewicz/f5xc-api-mcp 3.10.0 → 3.12.0

package/dist/tools/discovery/cost-estimator.js

@@ -0,0 +1,273 @@
+/**
+ * Cost and Performance Estimation
+ *
+ * Provides token usage estimates, latency expectations, and
+ * workflow cost aggregation for F5XC API operations.
+ */
+import { getToolByName } from "../registry.js";
+import { toolExists } from "./index-loader.js";
+/**
+ * Latency level to milliseconds mapping
+ */
+const LATENCY_MS_MAP = {
+    low: 500,
+    moderate: 2000,
+    high: 5000,
+    unknown: 1500,
+};
+/**
+ * Latency level descriptions
+ */
+const LATENCY_DESCRIPTIONS = {
+    low: "Fast operation, typically completes in under 1 second",
+    moderate: "Standard operation, may take 1-3 seconds",
+    high: "Complex operation, may take 3-10 seconds or involve async processing",
+    unknown: "Latency not specified, estimate based on operation type",
+};
+/**
+ * Estimate token count for a string (rough approximation)
+ */
+function estimateTokens(text) {
+    // Rough approximation: 1 token per 4 characters for English text
+    // JSON tends to be more verbose, so use 1 token per 3.5 characters
+    return Math.ceil(text.length / 3.5);
+}
+/**
+ * Get latency level from tool metadata
+ */
+function getLatencyLevel(toolName) {
+    const tool = getToolByName(toolName);
+    if (!tool) {
+        return "unknown";
+    }
+    // Check operation metadata for performance impact
+    const metadata = tool.operationMetadata;
+    if (metadata?.performance_impact?.latency) {
+        const latency = metadata.performance_impact.latency;
+        if (latency === "low" || latency === "moderate" || latency === "high") {
+            return latency;
+        }
+    }
+    // Fallback: estimate based on operation type
+    switch (tool.operation) {
+        case "list":
+            return "low";
+        case "get":
+            return "low";
+        case "create":
+            return "moderate";
+        case "update":
+            return "moderate";
+        case "delete":
+            return "moderate";
+        default:
+            return "unknown";
+    }
+}
+/**
+ * Estimate tokens for a tool call
+ */
+export function estimateToolTokens(toolName) {
+    const tool = getToolByName(toolName);
+    if (!tool) {
+        // Default estimate for unknown tools
+        return {
+            schemaTokens: 200,
+            requestTokens: 100,
+            responseTokens: 300,
+            totalTokens: 600,
+        };
+    }
+    // Schema tokens: tool description + parameters
+    const descriptionTokens = estimateTokens(tool.description);
+    const pathParamTokens = tool.pathParameters.length * 30;
+    const queryParamTokens = (tool.queryParameters?.length ?? 0) * 40;
+    const schemaTokens = descriptionTokens + pathParamTokens + queryParamTokens;
+    // Request tokens: based on operation type
+    let requestTokens;
+    switch (tool.operation) {
+        case "create":
+            requestTokens = 500; // Create operations typically have larger request bodies
+            break;
+        case "update":
+            requestTokens = 400;
+            break;
+        case "list":
+            requestTokens = 50; // List operations have minimal request
+            break;
+        case "get":
+            requestTokens = 30;
+            break;
+        case "delete":
+            requestTokens = 30;
+            break;
+        default:
+            requestTokens = 200;
+    }
+    // Response tokens: based on operation type
+    let responseTokens;
+    switch (tool.operation) {
+        case "list":
+            responseTokens = 1000; // List operations can return many items
+            break;
+        case "get":
+            responseTokens = 500;
+            break;
+        case "create":
+            responseTokens = 400;
+            break;
+        case "update":
+            responseTokens = 400;
+            break;
+        case "delete":
+            responseTokens = 100;
+            break;
+        default:
+            responseTokens = 300;
+    }
+    return {
+        schemaTokens,
+        requestTokens,
+        responseTokens,
+        totalTokens: schemaTokens + requestTokens + responseTokens,
+    };
+}
+/**
+ * Estimate latency for a tool call
+ */
+export function estimateToolLatency(toolName) {
+    const level = getLatencyLevel(toolName);
+    return {
+        level,
+        estimatedMs: LATENCY_MS_MAP[level],
+        description: LATENCY_DESCRIPTIONS[level],
+    };
+}
+/**
+ * Get complete cost estimate for a single tool
+ */
+export function estimateToolCost(toolName) {
+    const exists = toolExists(toolName);
+    const tool = getToolByName(toolName);
+    return {
+        toolName,
+        tokens: estimateToolTokens(toolName),
+        latency: estimateToolLatency(toolName),
+        dangerLevel: tool?.dangerLevel ?? "low",
+        exists,
+    };
+}
+/**
+ * Estimate costs for multiple tools
+ */
+export function estimateMultipleToolsCost(toolNames) {
+    return toolNames.map((name) => estimateToolCost(name));
+}
+/**
+ * Aggregate latency levels into average
+ */
+function aggregateLatency(levels) {
+    if (levels.length === 0) {
+        return "unknown";
+    }
+    const levelValues = {
+        low: 1,
+        moderate: 2,
+        high: 3,
+        unknown: 2,
+    };
+    const total = levels.reduce((sum, level) => sum + levelValues[level], 0);
+    const avg = total / levels.length;
+    if (avg < 1.5)
+        return "low";
+    if (avg < 2.5)
+        return "moderate";
+    return "high";
+}
+/**
+ * Estimate costs for a creation plan workflow
+ */
+export function estimateWorkflowCost(plan) {
+    const warnings = [];
+    const latencyLevels = [];
+    const steps = plan.steps.map((step) => {
+        const tokens = estimateToolTokens(step.toolName);
+        const latency = estimateToolLatency(step.toolName);
+        if (!toolExists(step.toolName)) {
+            warnings.push(`Tool '${step.toolName}' not found - estimates may be inaccurate`);
+        }
+        latencyLevels.push(latency.level);
+        return {
+            stepNumber: step.stepNumber,
+            toolName: step.toolName,
+            tokens: tokens.totalTokens,
+            latencyMs: latency.estimatedMs,
+        };
+    });
+    const totalTokens = steps.reduce((sum, step) => sum + step.tokens, 0);
+    const estimatedTotalMs = steps.reduce((sum, step) => sum + step.latencyMs, 0);
+    return {
+        totalTokens,
+        averageLatency: aggregateLatency(latencyLevels),
+        estimatedTotalMs,
+        stepCount: steps.length,
+        steps,
+        warnings,
+    };
+}
+/**
+ * Format cost estimate for human-readable output
+ */
+export function formatCostEstimate(estimate) {
+    const lines = [];
+    lines.push(`# Cost Estimate: ${estimate.toolName}`);
+    lines.push("");
+    if (!estimate.exists) {
+        lines.push("**Warning**: Tool not found - estimates are approximate");
+        lines.push("");
+    }
+    lines.push("## Token Usage");
+    lines.push(`- Schema/Description: ~${estimate.tokens.schemaTokens} tokens`);
+    lines.push(`- Request Body: ~${estimate.tokens.requestTokens} tokens`);
+    lines.push(`- Response: ~${estimate.tokens.responseTokens} tokens`);
+    lines.push(`- **Total per call**: ~${estimate.tokens.totalTokens} tokens`);
+    lines.push("");
+    lines.push("## Latency");
+    lines.push(`- Level: ${estimate.latency.level}`);
+    lines.push(`- Estimated: ~${estimate.latency.estimatedMs}ms`);
+    lines.push(`- ${estimate.latency.description}`);
+    lines.push("");
+    lines.push("## Risk");
+    lines.push(`- Danger Level: ${estimate.dangerLevel}`);
+    return lines.join("\n");
+}
+/**
+ * Format workflow cost estimate for human-readable output
+ */
+export function formatWorkflowCostEstimate(estimate) {
+    const lines = [];
+    lines.push("# Workflow Cost Estimate");
+    lines.push("");
+    lines.push("## Summary");
+    lines.push(`- **Total Steps**: ${estimate.stepCount}`);
+    lines.push(`- **Total Tokens**: ~${estimate.totalTokens}`);
+    lines.push(`- **Average Latency**: ${estimate.averageLatency}`);
+    lines.push(`- **Estimated Total Time**: ~${(estimate.estimatedTotalMs / 1000).toFixed(1)}s`);
+    lines.push("");
+    if (estimate.warnings.length > 0) {
+        lines.push("## Warnings");
+        for (const warning of estimate.warnings) {
+            lines.push(`- ${warning}`);
+        }
+        lines.push("");
+    }
+    lines.push("## Step Breakdown");
+    lines.push("");
+    lines.push("| Step | Tool | Tokens | Latency |");
+    lines.push("|------|------|--------|---------|");
+    for (const step of estimate.steps) {
+        lines.push(`| ${step.stepNumber} | ${step.toolName} | ~${step.tokens} | ~${step.latencyMs}ms |`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=cost-estimator.js.map

package/dist/tools/discovery/cost-estimator.js.map

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

package/dist/tools/discovery/index-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-loader.d.ts","sourceRoot":"","sources":["../../../src/tools/discovery/index-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAkC/E;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAKxC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,CAEpD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAGzE"}
+{"version":3,"file":"index-loader.d.ts","sourceRoot":"","sources":["../../../src/tools/discovery/index-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAqC/E;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAKxC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,CAEpD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAGzE"}

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

@@ -17,6 +17,9 @@ function generateIndex() {
         resource: tool.resource,
         operation: tool.operation,
         summary: tool.summary,
+        dangerLevel: tool.dangerLevel ?? "low",
+        // Note: isDeprecated not yet extracted from x-ves-deprecated in parser
+        isDeprecated: false,
     }));
     // Calculate domain counts
     const domains = {};

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

@@ -1 +1 @@
-{"version":3,"file":"index-loader.js","sourceRoot":"","sources":["../../../src/tools/discovery/index-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,+BAA+B;AAC/B,IAAI,WAAW,GAAqB,IAAI,CAAC;AAEzC;;GAEG;AACH,SAAS,aAAa;IACpB,MAAM,KAAK,GAAqB,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACtD,IAAI,EAAE,IAAI,CAAC,QAAQ;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAC,CAAC;IAEJ,0BAA0B;IAC1B,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,QAAQ,GAAsB;QAClC,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,OAAO;QACP,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,OAAO,EAAE,OAAO;KACjB,CAAC;IAEF,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,WAAW,GAAG,aAAa,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,YAAY,EAAE,CAAC,QAAQ,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;AACtD,CAAC"}
+{"version":3,"file":"index-loader.js","sourceRoot":"","sources":["../../../src/tools/discovery/index-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,+BAA+B;AAC/B,IAAI,WAAW,GAAqB,IAAI,CAAC;AAEzC;;GAEG;AACH,SAAS,aAAa;IACpB,MAAM,KAAK,GAAqB,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACtD,IAAI,EAAE,IAAI,CAAC,QAAQ;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,KAAK;QACtC,uEAAuE;QACvE,YAAY,EAAE,KAAK;KACpB,CAAC,CAAC,CAAC;IAEJ,0BAA0B;IAC1B,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,QAAQ,GAAsB;QAClC,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,OAAO;QACP,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,OAAO,EAAE,OAAO;KACjB,CAAC;IAEF,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,WAAW,GAAG,aAAa,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,YAAY,EAAE,CAAC,QAAQ,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;AACtD,CAAC"}

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

@@ -25,6 +25,14 @@ export { executeTool, validateExecuteParams } from "./execute.js";
 export type { CrudOperation, ConsolidatedResource, ConsolidatedIndex } from "./consolidate.js";
 export { getConsolidatedIndex, clearConsolidatedCache, getConsolidatedResource, getConsolidatedByDomain, searchConsolidatedResources, resolveConsolidatedTool, getConsolidationStats, } from "./consolidate.js";
 export { loadDependencyGraph, clearDependencyCache, getResourceDependencies, getCreationOrder, getPrerequisiteResources, getDependentResources, getOneOfGroups, getSubscriptionRequirements, getResourcesRequiringSubscription, getAvailableAddonServices, generateDependencyReport, getDependencyStats, getResourcesInDomain, getAllDependencyDomains, } from "./dependencies.js";
+export type { ValidationError, ValidationResult, ValidateParams } from "./validate.js";
+export { validateToolParams, formatValidationResult } from "./validate.js";
+export type { WorkflowStep, AlternativePath, CreationPlan, ResolveParams, ResolveResult, } from "./resolver.js";
+export { resolveDependencies, formatCreationPlan, generateCompactPlan } from "./resolver.js";
+export type { LatencyLevel, TokenEstimate, LatencyEstimate, ToolCostEstimate, WorkflowCostEstimate, EstimateCostParams, } from "./cost-estimator.js";
+export { estimateToolTokens, estimateToolLatency, estimateToolCost, estimateMultipleToolsCost, estimateWorkflowCost, formatCostEstimate, formatWorkflowCostEstimate, } from "./cost-estimator.js";
+export type { CommonError, DangerAnalysis, RecommendedWorkflow, DomainBestPractices, BestPracticesQuery, BestPracticesResult, } from "./best-practices.js";
+export { getDomainBestPractices, queryBestPractices, getAllDomainsSummary, formatBestPractices, } from "./best-practices.js";
 /**
  * MCP Tool Definitions for the discovery meta-tools
  *
@@ -61,6 +69,18 @@ export declare const DISCOVERY_TOOLS: {
                     };
                     readonly description: "Filter by operation type(s): create, get, list, update, delete";
                 };
+                readonly excludeDangerous: {
+                    readonly type: "boolean";
+                    readonly description: "Exclude high-danger operations from results";
+                };
+                readonly excludeDeprecated: {
+                    readonly type: "boolean";
+                    readonly description: "Exclude deprecated operations from results";
+                };
+                readonly includeDependencies: {
+                    readonly type: "boolean";
+                    readonly description: "Include prerequisite hints for create operations";
+                };
             };
             readonly required: readonly ["query"];
         };
@@ -214,5 +234,130 @@ export declare const DISCOVERY_TOOLS: {
             readonly properties: {};
         };
     };
+    readonly validateParams: {
+        readonly name: "f5xc-api-validate-params";
+        readonly description: string;
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly toolName: {
+                    readonly type: "string";
+                    readonly description: "The exact tool name to validate parameters for";
+                };
+                readonly pathParams: {
+                    readonly type: "object";
+                    readonly description: "Path parameters to validate (e.g., { namespace: 'default', name: 'my-resource' })";
+                    readonly additionalProperties: {
+                        readonly type: "string";
+                    };
+                };
+                readonly queryParams: {
+                    readonly type: "object";
+                    readonly description: "Query parameters to validate";
+                    readonly additionalProperties: {
+                        readonly type: "string";
+                    };
+                };
+                readonly body: {
+                    readonly type: "object";
+                    readonly description: "Request body to validate";
+                };
+            };
+            readonly required: readonly ["toolName"];
+        };
+    };
+    readonly resolveDependencies: {
+        readonly name: "f5xc-api-resolve-dependencies";
+        readonly description: string;
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly resource: {
+                    readonly type: "string";
+                    readonly description: "The target resource to create (e.g., 'http-loadbalancer', 'origin-pool')";
+                };
+                readonly domain: {
+                    readonly type: "string";
+                    readonly description: "The domain containing the resource (e.g., 'virtual', 'network')";
+                };
+                readonly existingResources: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly description: string;
+                };
+                readonly includeOptional: {
+                    readonly type: "boolean";
+                    readonly description: "Include optional dependencies in the plan (default: false)";
+                    readonly default: false;
+                };
+                readonly maxDepth: {
+                    readonly type: "number";
+                    readonly description: "Maximum depth for dependency traversal (default: 10)";
+                    readonly default: 10;
+                };
+                readonly expandAlternatives: {
+                    readonly type: "boolean";
+                    readonly description: "Include alternative paths for oneOf choices (default: false)";
+                    readonly default: false;
+                };
+            };
+            readonly required: readonly ["resource", "domain"];
+        };
+    };
+    readonly estimateCost: {
+        readonly name: "f5xc-api-estimate-cost";
+        readonly description: string;
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly toolName: {
+                    readonly type: "string";
+                    readonly description: "A single tool name to estimate (e.g., 'f5xc-api-waap-http-loadbalancer-create')";
+                };
+                readonly toolNames: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly description: "Multiple tool names to estimate costs for";
+                };
+                readonly plan: {
+                    readonly type: "object";
+                    readonly description: "A CreationPlan object from f5xc-api-resolve-dependencies to estimate workflow costs";
+                };
+                readonly detailed: {
+                    readonly type: "boolean";
+                    readonly description: "Include detailed breakdown of token usage and latency (default: true)";
+                    readonly default: true;
+                };
+            };
+        };
+    };
+    readonly bestPractices: {
+        readonly name: "f5xc-api-best-practices";
+        readonly description: string;
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly domain: {
+                    readonly type: "string";
+                    readonly description: string;
+                };
+                readonly aspect: {
+                    readonly type: "string";
+                    readonly enum: readonly ["errors", "workflows", "danger", "security", "performance", "all"];
+                    readonly description: string;
+                    readonly default: "all";
+                };
+                readonly detailed: {
+                    readonly type: "boolean";
+                    readonly description: "Include detailed breakdowns (default: true)";
+                    readonly default: true;
+                };
+            };
+        };
+    };
 };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/discovery/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,YAAY,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EACb,SAAS,EACT,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEnG,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGhG,OAAO,EACL,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,YAAY,GACb,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGlE,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,wBAAwB,EACxB,qBAAqB,EACrB,cAAc,EACd,2BAA2B,EAC3B,iCAAiC,EACjC,yBAAyB,EACzB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAE3B;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0MlB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/discovery/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/discovery/index.js

@@ -26,6 +26,10 @@ 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
  *
@@ -59,6 +63,18 @@ export const DISCOVERY_TOOLS = {
                     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"],
         },
@@ -216,5 +232,130 @@ export const DISCOVERY_TOOLS = {
             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