@robinmordasiewicz/f5xc-api-mcp 3.11.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.d.ts

@@ -27,6 +27,12 @@ export { getConsolidatedIndex, clearConsolidatedCache, getConsolidatedResource,
 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
  *
@@ -260,5 +266,98 @@ export declare const DISCOVERY_TOOLS: {
             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;AAG3B,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE3E;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsPlB,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

@@ -27,6 +27,9 @@ export { getConsolidatedIndex, clearConsolidatedCache, getConsolidatedResource,
 // 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
  *
@@ -258,5 +261,101 @@ export const DISCOVERY_TOOLS = {
             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

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