@robinmordasiewicz/f5xc-api-mcp 3.0.0

package/dist/tools/discovery/index.js

@@ -0,0 +1,177 @@
+/**
+ * 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";
+/**
+ * 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",
+                },
+            },
+            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"],
+        },
+    },
+};
+//# 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/search.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Tool Search Implementation
+ *
+ * Provides natural language search across the tool index.
+ * Uses lightweight text matching for efficient discovery.
+ */
+import type { ToolIndexEntry, SearchResult, SearchOptions } from "./types.js";
+/**
+ * Search for tools matching a natural language query
+ *
+ * @param query - Natural language search query
+ * @param options - Search options
+ * @returns Ranked list of matching tools
+ *
+ * @example
+ * ```typescript
+ * // Find load balancer tools
+ * const results = searchTools("http load balancer");
+ *
+ * // Find create operations in WAAP domain
+ * const results = searchTools("create", { domains: ["waap"], operations: ["create"] });
+ * ```
+ */
+export declare function searchTools(query: string, options?: SearchOptions): SearchResult[];
+/**
+ * Get tools by exact domain
+ */
+export declare function getToolsByDomain(domain: string): ToolIndexEntry[];
+/**
+ * Get tools by resource name
+ */
+export declare function getToolsByResource(resource: string): ToolIndexEntry[];
+/**
+ * Get all available domains
+ */
+export declare function getAvailableDomains(): string[];
+/**
+ * Get tool count by domain
+ */
+export declare function getToolCountByDomain(): Record<string, number>;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/tools/discovery/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAgG9E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,YAAY,EAAE,CAkCtF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CAGjE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAIrE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAG9C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAG7D"}

package/dist/tools/discovery/search.js

@@ -0,0 +1,155 @@
+/**
+ * Tool Search Implementation
+ *
+ * Provides natural language search across the tool index.
+ * Uses lightweight text matching for efficient discovery.
+ */
+import { getToolIndex } from "./index-loader.js";
+/**
+ * Normalize text for search matching
+ */
+function normalizeText(text) {
+    return text
+        .toLowerCase()
+        .replace(/[-_]/g, " ")
+        .replace(/[^a-z0-9\s]/g, "")
+        .trim();
+}
+/**
+ * Tokenize text into searchable terms
+ */
+function tokenize(text) {
+    return normalizeText(text)
+        .split(/\s+/)
+        .filter((term) => term.length > 1);
+}
+/**
+ * Calculate relevance score between query and tool
+ */
+function calculateScore(query, tool) {
+    const queryTerms = tokenize(query);
+    const matchedTerms = [];
+    if (queryTerms.length === 0) {
+        return { score: 0, matchedTerms };
+    }
+    // Build searchable text from tool
+    const toolText = [tool.name, tool.domain, tool.resource, tool.operation, tool.summary].join(" ");
+    const normalizedToolText = normalizeText(toolText);
+    const toolTerms = new Set(tokenize(toolText));
+    let matchCount = 0;
+    for (const queryTerm of queryTerms) {
+        // Exact term match
+        if (toolTerms.has(queryTerm)) {
+            matchCount += 1;
+            matchedTerms.push(queryTerm);
+            continue;
+        }
+        // Partial match (query term contained in tool text)
+        if (normalizedToolText.includes(queryTerm)) {
+            matchCount += 0.7;
+            matchedTerms.push(queryTerm);
+            continue;
+        }
+        // Check if any tool term starts with query term (prefix match)
+        for (const toolTerm of toolTerms) {
+            if (toolTerm.startsWith(queryTerm)) {
+                matchCount += 0.5;
+                matchedTerms.push(queryTerm);
+                break;
+            }
+        }
+    }
+    // Boost scores for specific matches
+    let score = matchCount / queryTerms.length;
+    // Boost for domain match
+    if (normalizeText(tool.domain).includes(normalizeText(query.split(" ")[0] || ""))) {
+        score *= 1.2;
+    }
+    // Boost for operation match
+    const operationTerms = ["create", "get", "list", "update", "delete", "patch"];
+    for (const opTerm of operationTerms) {
+        if (query.toLowerCase().includes(opTerm) && tool.operation === opTerm) {
+            score *= 1.3;
+            break;
+        }
+    }
+    // Boost for resource match
+    if (normalizeText(tool.resource).includes(normalizeText(query))) {
+        score *= 1.4;
+    }
+    // Cap score at 1.0
+    return { score: Math.min(score, 1), matchedTerms: [...new Set(matchedTerms)] };
+}
+/**
+ * Search for tools matching a natural language query
+ *
+ * @param query - Natural language search query
+ * @param options - Search options
+ * @returns Ranked list of matching tools
+ *
+ * @example
+ * ```typescript
+ * // Find load balancer tools
+ * const results = searchTools("http load balancer");
+ *
+ * // Find create operations in WAAP domain
+ * const results = searchTools("create", { domains: ["waap"], operations: ["create"] });
+ * ```
+ */
+export function searchTools(query, options = {}) {
+    const { limit = 10, domains, operations, minScore = 0.1 } = options;
+    const index = getToolIndex();
+    let tools = index.tools;
+    // Apply domain filter
+    if (domains && domains.length > 0) {
+        const domainSet = new Set(domains.map((d) => d.toLowerCase()));
+        tools = tools.filter((t) => domainSet.has(t.domain.toLowerCase()));
+    }
+    // Apply operation filter
+    if (operations && operations.length > 0) {
+        const opSet = new Set(operations.map((o) => o.toLowerCase()));
+        tools = tools.filter((t) => opSet.has(t.operation.toLowerCase()));
+    }
+    // Score and rank tools
+    const results = [];
+    for (const tool of tools) {
+        const { score, matchedTerms } = calculateScore(query, tool);
+        if (score >= minScore) {
+            results.push({ tool, score, matchedTerms });
+        }
+    }
+    // Sort by score descending
+    results.sort((a, b) => b.score - a.score);
+    // Return top results
+    return results.slice(0, limit);
+}
+/**
+ * Get tools by exact domain
+ */
+export function getToolsByDomain(domain) {
+    const index = getToolIndex();
+    return index.tools.filter((t) => t.domain.toLowerCase() === domain.toLowerCase());
+}
+/**
+ * Get tools by resource name
+ */
+export function getToolsByResource(resource) {
+    const index = getToolIndex();
+    const normalizedResource = normalizeText(resource);
+    return index.tools.filter((t) => normalizeText(t.resource).includes(normalizedResource));
+}
+/**
+ * Get all available domains
+ */
+export function getAvailableDomains() {
+    const index = getToolIndex();
+    return Object.keys(index.metadata.domains);
+}
+/**
+ * Get tool count by domain
+ */
+export function getToolCountByDomain() {
+    const index = getToolIndex();
+    return { ...index.metadata.domains };
+}
+//# sourceMappingURL=search.js.map

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

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

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

@@ -0,0 +1,70 @@
+/**
+ * Discovery Module Type Definitions
+ *
+ * Lightweight types for the dynamic tool discovery system.
+ * These types are designed to minimize token usage while
+ * preserving essential information for tool discovery.
+ */
+/**
+ * Lightweight tool index entry (~50 tokens vs ~375 for full ParsedOperation)
+ * Contains only the minimum information needed for search/discovery.
+ */
+export interface ToolIndexEntry {
+    /** Tool name (e.g., "f5xc-api-waap-http-loadbalancer-create") */
+    name: string;
+    /** Domain category (e.g., "waap", "dns", "core") */
+    domain: string;
+    /** Resource type (e.g., "http-loadbalancer") */
+    resource: string;
+    /** Operation type (e.g., "create", "get", "list", "update", "delete") */
+    operation: string;
+    /** Brief summary for search matching */
+    summary: string;
+}
+/**
+ * Search result with relevance scoring
+ */
+export interface SearchResult {
+    /** The matching tool entry */
+    tool: ToolIndexEntry;
+    /** Relevance score (0-1) */
+    score: number;
+    /** Matched terms for highlighting */
+    matchedTerms: string[];
+}
+/**
+ * Search options for customizing tool discovery
+ */
+export interface SearchOptions {
+    /** Maximum number of results to return (default: 10) */
+    limit?: number;
+    /** Filter by domain(s) */
+    domains?: string[];
+    /** Filter by operation type(s) */
+    operations?: string[];
+    /** Minimum relevance score threshold (default: 0.1) */
+    minScore?: number;
+}
+/**
+ * Tool index metadata for the entire index
+ */
+export interface ToolIndexMetadata {
+    /** Total number of tools indexed */
+    totalTools: number;
+    /** Available domains with tool counts */
+    domains: Record<string, number>;
+    /** Index generation timestamp */
+    generatedAt: string;
+    /** Version of the index format */
+    version: string;
+}
+/**
+ * Complete tool index structure
+ */
+export interface ToolIndex {
+    /** Index metadata */
+    metadata: ToolIndexMetadata;
+    /** All tool entries */
+    tools: ToolIndexEntry[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/discovery/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,IAAI,EAAE,cAAc,CAAC;IACrB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,qBAAqB;IACrB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,uBAAuB;IACvB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB"}

package/dist/tools/discovery/types.js

@@ -0,0 +1,9 @@
+/**
+ * Discovery Module Type Definitions
+ *
+ * Lightweight types for the dynamic tool discovery system.
+ * These types are designed to minimize token usage while
+ * preserving essential information for tool discovery.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/discovery/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/tools/generated/ai_intelligence/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generated tool definitions for ai_intelligence domain
+ * DO NOT EDIT - This file is auto-generated by scripts/generate.ts
+ */
+import type { ParsedOperation } from "../../../generator/openapi-parser.js";
+export declare const ai_intelligenceTools: ParsedOperation[];
+export default ai_intelligenceTools;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/generated/ai_intelligence/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/generated/ai_intelligence/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAE5E,eAAO,MAAM,oBAAoB,EAAE,eAAe,EAqRjD,CAAC;AAEF,eAAe,oBAAoB,CAAC"}