@robinmordasiewicz/f5xc-api-mcp 1.0.82-2512312028

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

@@ -0,0 +1,133 @@
+/**
+ * Tool Description Loader
+ *
+ * Loads full tool schemas on-demand for specific tools.
+ * This implements lazy loading to avoid upfront token consumption.
+ */
+import type { ParsedOperation } from "../../generator/openapi-parser.js";
+/**
+ * Simplified tool description for MCP response
+ * Contains the essential information needed to execute a tool
+ */
+export interface ToolDescription {
+    /** Tool name */
+    name: string;
+    /** Human-readable summary */
+    summary: string;
+    /** Detailed description */
+    description: string;
+    /** HTTP method */
+    method: string;
+    /** API path template */
+    path: string;
+    /** Domain category */
+    domain: string;
+    /** Resource type */
+    resource: string;
+    /** Operation type */
+    operation: string;
+    /** Required parameters (path + query + body) */
+    requiredParams: string[];
+    /** Path parameters with descriptions */
+    pathParameters: ParameterDescription[];
+    /** Query parameters with descriptions */
+    queryParameters: ParameterDescription[];
+    /** Whether request body is required */
+    hasRequestBody: boolean;
+    /** Request body schema reference (if any) */
+    requestBodyRef: string | null;
+}
+/**
+ * Simplified parameter description
+ */
+export interface ParameterDescription {
+    name: string;
+    description: string;
+    required: boolean;
+    type: string;
+}
+/**
+ * Get full tool description by name
+ *
+ * @param toolName - The exact tool name
+ * @returns Full tool description or null if not found
+ *
+ * @example
+ * ```typescript
+ * const desc = describeTool("f5xc-api-waap-http-loadbalancer-create");
+ * if (desc) {
+ *   console.log(desc.requiredParams);
+ *   console.log(desc.pathParameters);
+ * }
+ * ```
+ */
+export declare function describeTool(toolName: string): ToolDescription | null;
+/**
+ * Get the full ParsedOperation for a tool (includes raw schemas)
+ *
+ * Use this when you need the complete tool definition including
+ * full request/response schemas. More expensive than describeTool.
+ *
+ * @param toolName - The exact tool name
+ * @returns Full ParsedOperation or null if not found
+ */
+export declare function getFullToolSchema(toolName: string): ParsedOperation | null;
+/**
+ * Get multiple tool descriptions at once
+ *
+ * @param toolNames - Array of tool names
+ * @returns Map of tool name to description (excludes not found tools)
+ */
+export declare function describeTools(toolNames: string[]): Map<string, ToolDescription>;
+/**
+ * Get tool description with validation
+ *
+ * @param toolName - The tool name to describe
+ * @returns Object with success status and either description or error
+ */
+export declare function describeToolSafe(toolName: string): {
+    success: boolean;
+    description?: ToolDescription;
+    error?: string;
+};
+/**
+ * Compact tool description for minimal token usage
+ * Omits optional fields and uses abbreviated format
+ */
+export interface CompactToolDescription {
+    n: string;
+    m: string;
+    p: string;
+    d: string;
+    r: string;
+    o: string;
+    s: string;
+    rp: string[];
+    pp: Array<{
+        n: string;
+        r: boolean;
+    }>;
+    qp: Array<{
+        n: string;
+        r: boolean;
+    }>;
+    rb: boolean;
+}
+/**
+ * Get ultra-compact tool description for maximum token efficiency
+ * Reduces description size by ~60% compared to full description
+ *
+ * @param toolName - The exact tool name
+ * @returns Compact description or null if not found
+ */
+export declare function describeToolCompact(toolName: string): CompactToolDescription | null;
+/**
+ * Calculate token savings from schema optimization
+ * Uses dynamically selected tools from the registry - no hardcoded tool names
+ */
+export declare function getOptimizationStats(): {
+    avgOriginalParamDescLen: number;
+    avgOptimizedParamDescLen: number;
+    estimatedSavingsPercent: string;
+};
+//# sourceMappingURL=describe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../../src/tools/discovery/describe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAIzE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,wCAAwC;IACxC,cAAc,EAAE,oBAAoB,EAAE,CAAC;IACvC,yCAAyC;IACzC,eAAe,EAAE,oBAAoB,EAAE,CAAC;IACxC,uCAAuC;IACvC,cAAc,EAAE,OAAO,CAAC;IACxB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAoDD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAgCrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAW/E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAqBA;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,EAAE,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACrC,EAAE,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACrC,EAAE,EAAE,OAAO,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAoBnF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI;IACtC,uBAAuB,EAAE,MAAM,CAAC;IAChC,wBAAwB,EAAE,MAAM,CAAC;IACjC,uBAAuB,EAAE,MAAM,CAAC;CACjC,CAkCA"}

package/dist/tools/discovery/describe.js

@@ -0,0 +1,208 @@
+/**
+ * Tool Description Loader
+ *
+ * Loads full tool schemas on-demand for specific tools.
+ * This implements lazy loading to avoid upfront token consumption.
+ */
+import { getToolByName } from "../registry.js";
+import { toolExists, getToolEntry, getToolIndex } from "./index-loader.js";
+/**
+ * Common parameter descriptions (shared to save tokens)
+ * These replace verbose OpenAPI descriptions with concise versions
+ */
+const COMMON_PARAM_DESCRIPTIONS = {
+    namespace: "Target namespace (e.g., 'default')",
+    "metadata.namespace": "Target namespace for the resource",
+    name: "Resource name",
+    "metadata.name": "Resource name identifier",
+};
+/**
+ * Optimize parameter description by using shared descriptions for common params
+ * and truncating verbose descriptions
+ */
+function optimizeDescription(name, description) {
+    // Use shared description if available
+    if (COMMON_PARAM_DESCRIPTIONS[name]) {
+        return COMMON_PARAM_DESCRIPTIONS[name];
+    }
+    // Truncate verbose descriptions (keep first sentence or 100 chars)
+    if (description.length > 100) {
+        const firstSentence = description.split(/[.\n]/)[0];
+        if (firstSentence && firstSentence.length <= 100) {
+            return firstSentence;
+        }
+        return description.slice(0, 97) + "...";
+    }
+    return description;
+}
+/**
+ * Extract parameter description from OpenAPI parameter
+ */
+function extractParameterDescription(param) {
+    return {
+        name: param.name,
+        description: optimizeDescription(param.name, param.description ?? ""),
+        required: param.required ?? false,
+        type: param.schema?.type ?? "string",
+    };
+}
+/**
+ * Get full tool description by name
+ *
+ * @param toolName - The exact tool name
+ * @returns Full tool description or null if not found
+ *
+ * @example
+ * ```typescript
+ * const desc = describeTool("f5xc-api-waap-http-loadbalancer-create");
+ * if (desc) {
+ *   console.log(desc.requiredParams);
+ *   console.log(desc.pathParameters);
+ * }
+ * ```
+ */
+export function describeTool(toolName) {
+    const tool = getToolByName(toolName);
+    if (!tool) {
+        return null;
+    }
+    // Extract request body schema reference
+    let requestBodyRef = null;
+    if (tool.requestBodySchema) {
+        const ref = tool.requestBodySchema.$ref;
+        if (typeof ref === "string") {
+            // Extract just the schema name from the reference
+            requestBodyRef = ref.replace("#/components/schemas/", "");
+        }
+    }
+    return {
+        name: tool.toolName,
+        summary: tool.summary,
+        description: tool.description,
+        method: tool.method,
+        path: tool.path,
+        domain: tool.domain,
+        resource: tool.resource,
+        operation: tool.operation,
+        requiredParams: tool.requiredParams,
+        pathParameters: tool.pathParameters.map(extractParameterDescription),
+        queryParameters: tool.queryParameters.map(extractParameterDescription),
+        hasRequestBody: tool.requestBodySchema !== null,
+        requestBodyRef,
+    };
+}
+/**
+ * Get the full ParsedOperation for a tool (includes raw schemas)
+ *
+ * Use this when you need the complete tool definition including
+ * full request/response schemas. More expensive than describeTool.
+ *
+ * @param toolName - The exact tool name
+ * @returns Full ParsedOperation or null if not found
+ */
+export function getFullToolSchema(toolName) {
+    return getToolByName(toolName) ?? null;
+}
+/**
+ * Get multiple tool descriptions at once
+ *
+ * @param toolNames - Array of tool names
+ * @returns Map of tool name to description (excludes not found tools)
+ */
+export function describeTools(toolNames) {
+    const results = new Map();
+    for (const name of toolNames) {
+        const desc = describeTool(name);
+        if (desc) {
+            results.set(name, desc);
+        }
+    }
+    return results;
+}
+/**
+ * Get tool description with validation
+ *
+ * @param toolName - The tool name to describe
+ * @returns Object with success status and either description or error
+ */
+export function describeToolSafe(toolName) {
+    if (!toolExists(toolName)) {
+        // Try to find similar tools
+        const entry = getToolEntry(toolName);
+        if (!entry) {
+            return {
+                success: false,
+                error: `Tool "${toolName}" not found. Use search_tools to find available tools.`,
+            };
+        }
+    }
+    const description = describeTool(toolName);
+    if (!description) {
+        return {
+            success: false,
+            error: `Failed to load description for tool "${toolName}".`,
+        };
+    }
+    return { success: true, description };
+}
+/**
+ * Get ultra-compact tool description for maximum token efficiency
+ * Reduces description size by ~60% compared to full description
+ *
+ * @param toolName - The exact tool name
+ * @returns Compact description or null if not found
+ */
+export function describeToolCompact(toolName) {
+    const tool = getToolByName(toolName);
+    if (!tool) {
+        return null;
+    }
+    return {
+        n: tool.toolName,
+        m: tool.method,
+        p: tool.path,
+        d: tool.domain,
+        r: tool.resource,
+        o: tool.operation,
+        s: tool.summary,
+        rp: tool.requiredParams,
+        pp: tool.pathParameters.map((p) => ({ n: p.name, r: p.required ?? true })),
+        qp: tool.queryParameters.map((p) => ({ n: p.name, r: p.required ?? false })),
+        rb: tool.requestBodySchema !== null,
+    };
+}
+/**
+ * Calculate token savings from schema optimization
+ * Uses dynamically selected tools from the registry - no hardcoded tool names
+ */
+export function getOptimizationStats() {
+    // Dynamically get sample tools with path parameters from the registry
+    const allTools = getToolIndex().tools;
+    // Find tools that likely have path parameters (create and list operations)
+    const sampleTools = allTools
+        .filter((t) => t.operation === "create" || t.operation === "list")
+        .slice(0, 5)
+        .map((t) => t.name);
+    let originalTotal = 0;
+    let optimizedTotal = 0;
+    let count = 0;
+    for (const name of sampleTools) {
+        const tool = getToolByName(name);
+        if (tool && tool.pathParameters.length > 0) {
+            for (const param of tool.pathParameters) {
+                originalTotal += (param.description ?? "").length;
+                optimizedTotal += optimizeDescription(param.name, param.description ?? "").length;
+                count++;
+            }
+        }
+    }
+    const avgOriginal = count > 0 ? Math.round(originalTotal / count) : 0;
+    const avgOptimized = count > 0 ? Math.round(optimizedTotal / count) : 0;
+    const savings = avgOriginal > 0 ? ((avgOriginal - avgOptimized) / avgOriginal) * 100 : 0;
+    return {
+        avgOriginalParamDescLen: avgOriginal,
+        avgOptimizedParamDescLen: avgOptimized,
+        estimatedSavingsPercent: `${savings.toFixed(1)}%`,
+    };
+}
+//# sourceMappingURL=describe.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../../src/tools/discovery/describe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA6C3E;;;GAGG;AACH,MAAM,yBAAyB,GAA2B;IACxD,SAAS,EAAE,oCAAoC;IAC/C,oBAAoB,EAAE,mCAAmC;IACzD,IAAI,EAAE,eAAe;IACrB,eAAe,EAAE,0BAA0B;CAC5C,CAAC;AAEF;;;GAGG;AACH,SAAS,mBAAmB,CAAC,IAAY,EAAE,WAAmB;IAC5D,sCAAsC;IACtC,IAAI,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO,yBAAyB,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,mEAAmE;IACnE,IAAI,WAAW,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QAC7B,MAAM,aAAa,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,IAAI,aAAa,IAAI,aAAa,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;YACjD,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC;IAC1C,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,SAAS,2BAA2B,CAAC,KAKpC;IACC,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,mBAAmB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC;QACrE,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK;QACjC,IAAI,EAAG,KAAK,CAAC,MAAM,EAAE,IAAe,IAAI,QAAQ;KACjD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAErC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wCAAwC;IACxC,IAAI,cAAc,GAAkB,IAAI,CAAC;IACzC,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC;QACxC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,kDAAkD;YAClD,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,QAAQ;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,2BAA2B,CAAC;QACpE,eAAe,EAAE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,2BAA2B,CAAC;QACtE,cAAc,EAAE,IAAI,CAAC,iBAAiB,KAAK,IAAI;QAC/C,cAAc;KACf,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,aAAa,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,SAAmB;IAC/C,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEnD,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAK/C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,4BAA4B;QAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,SAAS,QAAQ,wDAAwD;aACjF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,wCAAwC,QAAQ,IAAI;SAC5D,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AACxC,CAAC;AAoBD;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAErC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,CAAC,EAAE,IAAI,CAAC,QAAQ;QAChB,CAAC,EAAE,IAAI,CAAC,MAAM;QACd,CAAC,EAAE,IAAI,CAAC,IAAI;QACZ,CAAC,EAAE,IAAI,CAAC,MAAM;QACd,CAAC,EAAE,IAAI,CAAC,QAAQ;QAChB,CAAC,EAAE,IAAI,CAAC,SAAS;QACjB,CAAC,EAAE,IAAI,CAAC,OAAO;QACf,EAAE,EAAE,IAAI,CAAC,cAAc;QACvB,EAAE,EAAE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;QAC1E,EAAE,EAAE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,QAAQ,IAAI,KAAK,EAAE,CAAC,CAAC;QAC5E,EAAE,EAAE,IAAI,CAAC,iBAAiB,KAAK,IAAI;KACpC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAKlC,sEAAsE;IACtE,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC,KAAK,CAAC;IAEtC,2EAA2E;IAC3E,MAAM,WAAW,GAAG,QAAQ;SACzB,MAAM,CAAC,CAAC,CAAwB,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC;SACxF,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAExC,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,IAAI,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBACxC,aAAa,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;gBAClD,cAAc,IAAI,mBAAmB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;gBAClF,KAAK,EAAE,CAAC;YACV,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,MAAM,YAAY,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,YAAY,CAAC,GAAG,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzF,OAAO;QACL,uBAAuB,EAAE,WAAW;QACpC,wBAAwB,EAAE,YAAY;QACtC,uBAAuB,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;KAClD,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,96 @@
+/**
+ * Tool Execution Dispatcher
+ *
+ * Routes tool execution requests to the appropriate handler.
+ * This provides a unified interface for executing any discovered tool.
+ */
+import { CredentialManager } from "../../auth/credential-manager.js";
+/**
+ * Tool execution parameters
+ */
+export interface ExecuteToolParams {
+    /** The tool name to execute */
+    toolName: string;
+    /** Path parameters (e.g., { namespace: "default", name: "example-lb" }) */
+    pathParams?: Record<string, string>;
+    /** Query parameters */
+    queryParams?: Record<string, string | string[]>;
+    /** Request body (for POST/PUT/PATCH) */
+    body?: Record<string, unknown>;
+}
+/**
+ * Tool execution result
+ */
+export interface ExecuteToolResult {
+    /** Whether execution was successful */
+    success: boolean;
+    /** Response data (if successful) */
+    data?: unknown;
+    /** Error message (if failed) */
+    error?: string;
+    /** HTTP status code (if API call was made) */
+    statusCode?: number;
+    /** Tool metadata */
+    toolInfo: {
+        name: string;
+        method: string;
+        path: string;
+        operation: string;
+    };
+}
+/**
+ * Documentation-mode response when not authenticated
+ */
+export interface DocumentationResponse {
+    /** The tool that was requested */
+    tool: {
+        name: string;
+        summary: string;
+        method: string;
+        path: string;
+        domain: string;
+        resource: string;
+        operation: string;
+    };
+    /** Terraform resource example (if applicable) */
+    terraformExample?: string;
+    /** curl command example */
+    curlExample: string;
+    /** Message about authentication */
+    authMessage: string;
+}
+/**
+ * Execute a tool by name with the given parameters
+ *
+ * In authenticated mode: Makes the actual API call
+ * In documentation mode: Returns API examples and documentation
+ *
+ * @param params - Execution parameters
+ * @param credentialManager - Optional credential manager for auth
+ * @returns Execution result or documentation
+ *
+ * @example
+ * ```typescript
+ * // Execute in authenticated mode
+ * const result = await executeTool({
+ *   toolName: "f5xc-api-waap-http-loadbalancer-list",
+ *   pathParams: { namespace: "default" }
+ * }, credentialManager);
+ *
+ * // Execute in documentation mode (no credentials)
+ * const docs = await executeTool({
+ *   toolName: "f5xc-api-waap-http-loadbalancer-create",
+ *   pathParams: { "metadata.namespace": "default" },
+ *   body: { metadata: { name: "example-lb" }, spec: { ... } }
+ * });
+ * ```
+ */
+export declare function executeTool(params: ExecuteToolParams, credentialManager?: CredentialManager): Promise<ExecuteToolResult | DocumentationResponse>;
+/**
+ * Validate execution parameters before running
+ */
+export declare function validateExecuteParams(toolName: string, params: ExecuteToolParams): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=execute.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/tools/discovery/execute.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,iBAAiB,EAAY,MAAM,kCAAkC,CAAC;AAI/E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAChD,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB;AAwFD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,iBAAiB,EACzB,iBAAiB,CAAC,EAAE,iBAAiB,GACpC,OAAO,CAAC,iBAAiB,GAAG,qBAAqB,CAAC,CAiGpD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,iBAAiB,GACxB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA4BtC"}

package/dist/tools/discovery/execute.js

@@ -0,0 +1,220 @@
+/**
+ * Tool Execution Dispatcher
+ *
+ * Routes tool execution requests to the appropriate handler.
+ * This provides a unified interface for executing any discovered tool.
+ */
+import { getToolByName } from "../registry.js";
+import { toolExists } from "./index-loader.js";
+import { CredentialManager, AuthMode } from "../../auth/credential-manager.js";
+import { createHttpClient } from "../../auth/http-client.js";
+import { logger } from "../../utils/logging.js";
+/**
+ * Build path with parameters substituted
+ */
+function buildPath(pathTemplate, pathParams) {
+    let path = pathTemplate;
+    for (const [key, value] of Object.entries(pathParams)) {
+        // Handle both {param} and {metadata.param} style placeholders
+        path = path.replace(`{${key}}`, encodeURIComponent(value));
+    }
+    // Check for any remaining unsubstituted parameters
+    const remaining = path.match(/\{[^}]+\}/g);
+    if (remaining) {
+        throw new Error(`Missing path parameters: ${remaining.join(", ")}`);
+    }
+    return path;
+}
+/**
+ * Build query string from parameters
+ */
+function buildQueryString(queryParams) {
+    const parts = [];
+    for (const [key, value] of Object.entries(queryParams)) {
+        if (Array.isArray(value)) {
+            for (const v of value) {
+                parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(v)}`);
+            }
+        }
+        else {
+            parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(value)}`);
+        }
+    }
+    return parts.length > 0 ? `?${parts.join("&")}` : "";
+}
+/**
+ * Generate curl command example
+ */
+function generateCurlCommand(tool, params, apiUrl) {
+    const path = buildPath(tool.path, params.pathParams ?? {});
+    const queryString = buildQueryString(params.queryParams ?? {});
+    const fullUrl = `${apiUrl}${path}${queryString}`;
+    let cmd = `curl -X ${tool.method} "${fullUrl}"`;
+    cmd += ' \\\n  -H "Authorization: APIToken $F5XC_API_TOKEN"';
+    cmd += ' \\\n  -H "Content-Type: application/json"';
+    if (params.body && ["POST", "PUT", "PATCH"].includes(tool.method)) {
+        cmd += ` \\\n  -d '${JSON.stringify(params.body, null, 2)}'`;
+    }
+    return cmd;
+}
+/**
+ * Generate documentation response for unauthenticated mode
+ */
+function generateDocumentationResponse(tool, params) {
+    const apiUrl = "https://{tenant}.console.ves.volterra.io/api";
+    return {
+        tool: {
+            name: tool.toolName,
+            summary: tool.summary,
+            method: tool.method,
+            path: tool.path,
+            domain: tool.domain,
+            resource: tool.resource,
+            operation: tool.operation,
+        },
+        curlExample: generateCurlCommand(tool, params, apiUrl),
+        authMessage: "API execution disabled. Set F5XC_API_URL and F5XC_API_TOKEN to enable execution.",
+    };
+}
+/**
+ * Execute a tool by name with the given parameters
+ *
+ * In authenticated mode: Makes the actual API call
+ * In documentation mode: Returns API examples and documentation
+ *
+ * @param params - Execution parameters
+ * @param credentialManager - Optional credential manager for auth
+ * @returns Execution result or documentation
+ *
+ * @example
+ * ```typescript
+ * // Execute in authenticated mode
+ * const result = await executeTool({
+ *   toolName: "f5xc-api-waap-http-loadbalancer-list",
+ *   pathParams: { namespace: "default" }
+ * }, credentialManager);
+ *
+ * // Execute in documentation mode (no credentials)
+ * const docs = await executeTool({
+ *   toolName: "f5xc-api-waap-http-loadbalancer-create",
+ *   pathParams: { "metadata.namespace": "default" },
+ *   body: { metadata: { name: "example-lb" }, spec: { ... } }
+ * });
+ * ```
+ */
+export async function executeTool(params, credentialManager) {
+    const { toolName, pathParams = {}, queryParams = {}, body } = params;
+    // Validate tool exists
+    if (!toolExists(toolName)) {
+        return {
+            success: false,
+            error: `Tool "${toolName}" not found. Use search_tools to find available tools.`,
+            toolInfo: {
+                name: toolName,
+                method: "UNKNOWN",
+                path: "UNKNOWN",
+                operation: "UNKNOWN",
+            },
+        };
+    }
+    // Get full tool definition
+    const tool = getToolByName(toolName);
+    if (!tool) {
+        return {
+            success: false,
+            error: `Failed to load tool "${toolName}".`,
+            toolInfo: {
+                name: toolName,
+                method: "UNKNOWN",
+                path: "UNKNOWN",
+                operation: "UNKNOWN",
+            },
+        };
+    }
+    const toolInfo = {
+        name: tool.toolName,
+        method: tool.method,
+        path: tool.path,
+        operation: tool.operation,
+    };
+    // Check authentication
+    const creds = credentialManager ?? new CredentialManager();
+    const authMode = creds.getAuthMode();
+    if (authMode === AuthMode.NONE) {
+        // Return documentation response
+        return generateDocumentationResponse(tool, params);
+    }
+    // Authenticated mode - execute API call
+    try {
+        const httpClient = createHttpClient(creds);
+        const path = buildPath(tool.path, pathParams);
+        const queryString = buildQueryString(queryParams);
+        const fullPath = `${path}${queryString}`;
+        logger.debug(`Executing tool: ${toolName}`, { method: tool.method, path: fullPath });
+        let response;
+        switch (tool.method.toUpperCase()) {
+            case "GET":
+                response = await httpClient.get(fullPath);
+                break;
+            case "POST":
+                response = await httpClient.post(fullPath, body);
+                break;
+            case "PUT":
+                response = await httpClient.put(fullPath, body);
+                break;
+            case "DELETE":
+                response = await httpClient.delete(fullPath);
+                break;
+            default:
+                return {
+                    success: false,
+                    error: `Unsupported HTTP method: ${tool.method}`,
+                    toolInfo,
+                };
+        }
+        return {
+            success: true,
+            data: response.data,
+            statusCode: response.status,
+            toolInfo,
+        };
+    }
+    catch (error) {
+        logger.error(`Tool execution failed: ${toolName}`, {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : "Unknown error occurred",
+            toolInfo,
+        };
+    }
+}
+/**
+ * Validate execution parameters before running
+ */
+export function validateExecuteParams(toolName, params) {
+    const errors = [];
+    // Check tool exists
+    const tool = getToolByName(toolName);
+    if (!tool) {
+        return { valid: false, errors: [`Tool "${toolName}" not found`] };
+    }
+    // Check required path parameters
+    for (const param of tool.pathParameters) {
+        if (param.required) {
+            const value = params.pathParams?.[param.name] ?? params.pathParams?.[param.name.replace("metadata.", "")];
+            if (!value) {
+                errors.push(`Missing required path parameter: ${param.name}`);
+            }
+        }
+    }
+    // Check if body is required
+    if (tool.requestBodySchema && !params.body) {
+        if (["POST", "PUT", "PATCH"].includes(tool.method)) {
+            errors.push("Request body is required for this operation");
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=execute.js.map