@robinmordasiewicz/f5xc-api-mcp 1.0.82-2512312028

package/dist/generator/transformers/normalize-examples.js

@@ -0,0 +1,66 @@
+/**
+ * Example Normalization Transformer
+ *
+ * Normalizes example names in OpenAPI descriptions to follow
+ * the project's naming convention (using "example-" prefix).
+ *
+ * @deprecated Pre-enriched specs already have normalized examples.
+ * This module is only used by the deprecated parseSpecDirectory() function.
+ */
+/**
+ * Pattern to match "my-" prefixed example names
+ * Matches whole words only to avoid partial replacements
+ */
+const MY_PREFIX_PATTERN = /\bmy-(\w+)/g;
+/**
+ * Normalize examples in a description string
+ *
+ * Replaces "my-" prefixed example names with "example-" prefix
+ * to maintain consistent naming conventions throughout the codebase.
+ *
+ * @param description - The description text to normalize
+ * @returns Normalized description with "example-" prefixes
+ *
+ * @example
+ * ```typescript
+ * normalizeExamples("my-file, shared/my-file, my-ns/my-file")
+ * // Returns: "example-file, shared/example-file, example-ns/example-file"
+ *
+ * normalizeExamples("Use namespace 'my-namespace' with resource 'my-lb'")
+ * // Returns: "Use namespace 'example-namespace' with resource 'example-lb'"
+ * ```
+ * @deprecated Pre-enriched specs already have normalized examples
+ */
+export function normalizeExamples(description) {
+    if (!description) {
+        return description;
+    }
+    return description.replace(MY_PREFIX_PATTERN, "example-$1");
+}
+/**
+ * Normalize examples in a parameter object
+ *
+ * Creates a new parameter object with normalized description
+ *
+ * @param param - The parameter object to normalize
+ * @returns New parameter object with normalized description
+ */
+export function normalizeParameterExamples(param) {
+    if (!param.description) {
+        return param;
+    }
+    return {
+        ...param,
+        description: normalizeExamples(param.description),
+    };
+}
+/**
+ * Check if a string contains "my-" prefixed examples
+ *
+ * @param text - Text to check
+ * @returns True if "my-" prefixed examples are found
+ */
+export function hasMyPrefixExamples(text) {
+    return MY_PREFIX_PATTERN.test(text);
+}
+//# sourceMappingURL=normalize-examples.js.map

package/dist/generator/transformers/normalize-examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-examples.js","sourceRoot":"","sources":["../../../src/generator/transformers/normalize-examples.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAExC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,WAAW,CAAC,OAAO,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CAAqC,KAAQ;IACrF,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO;QACL,GAAG,KAAK;QACR,WAAW,EAAE,iBAAiB,CAAC,KAAK,CAAC,WAAW,CAAC;KAClD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/**
+ * F5 Distributed Cloud API MCP Server
+ *
+ * Entry point for the MCP server that provides tools for interacting
+ * with F5 XC APIs via Model Context Protocol.
+ *
+ * Supports dual-mode operation:
+ * - Documentation mode: No credentials required - provides API documentation
+ *   and Terraform examples
+ * - Execution mode: When F5XC credentials are provided, enables direct API calls
+ *
+ * Environment Variables:
+ * - F5XC_API_URL: Tenant URL (auto-normalized)
+ * - F5XC_API_TOKEN: API token for authentication
+ * - F5XC_P12_FILE: Path to P12 certificate file (alternative to token)
+ * - F5XC_P12_PASSWORD: Password for P12 certificate
+ * - F5XC_PROFILE: Profile name to use (default: F5XC_DEFAULT_PROFILE)
+ */
+/** Server version - synchronized with package.json */
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;GAiBG;AAKH,sDAAsD;AACtD,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+/**
+ * F5 Distributed Cloud API MCP Server
+ *
+ * Entry point for the MCP server that provides tools for interacting
+ * with F5 XC APIs via Model Context Protocol.
+ *
+ * Supports dual-mode operation:
+ * - Documentation mode: No credentials required - provides API documentation
+ *   and Terraform examples
+ * - Execution mode: When F5XC credentials are provided, enables direct API calls
+ *
+ * Environment Variables:
+ * - F5XC_API_URL: Tenant URL (auto-normalized)
+ * - F5XC_API_TOKEN: API token for authentication
+ * - F5XC_P12_FILE: Path to P12 certificate file (alternative to token)
+ * - F5XC_P12_PASSWORD: Password for P12 certificate
+ * - F5XC_PROFILE: Profile name to use (default: F5XC_DEFAULT_PROFILE)
+ */
+import { createServer } from "./server.js";
+import { logger } from "./utils/logging.js";
+/** Server version - synchronized with package.json */
+export const VERSION = "0.1.0";
+/**
+ * Main entry point
+ */
+async function main() {
+    try {
+        // Get command-line arguments (skip node executable and script name)
+        const args = process.argv.slice(2);
+        // Handle version flag
+        if (args.includes("--version") || args.includes("-v")) {
+            console.log(`f5xc-api-mcp v${VERSION}\n`);
+            process.exit(0);
+        }
+        // Handle help flag
+        if (args.includes("--help") || args.includes("-h")) {
+            console.log(`F5 Distributed Cloud API MCP Server v${VERSION}
+
+Usage: f5xc-api-mcp [options]
+
+Options:
+  -v, --version    Show version number
+  -h, --help       Show help
+
+Environment Variables:
+  F5XC_API_URL        Tenant URL (e.g., https://tenant.console.ves.volterra.io)
+  F5XC_API_TOKEN      API token for authentication
+  F5XC_P12_FILE       Path to P12 certificate file (alternative to token)
+  F5XC_P12_PASSWORD   Password for P12 certificate
+  F5XC_PROFILE        Profile name to use
+
+The server runs in documentation mode when no credentials are provided,
+allowing exploration of the API without authentication.
+`);
+            process.exit(0);
+        }
+        // Start MCP server (default behavior)
+        const server = createServer();
+        await server.start();
+        // Handle graceful shutdown
+        const shutdown = async (signal) => {
+            logger.info(`Received ${signal}, shutting down gracefully`);
+            await server.stop();
+            process.exit(0);
+        };
+        process.on("SIGINT", () => void shutdown("SIGINT"));
+        process.on("SIGTERM", () => void shutdown("SIGTERM"));
+        // Handle uncaught errors
+        process.on("uncaughtException", (error) => {
+            logger.error("Uncaught exception", {
+                error: error.message,
+                stack: error.stack,
+            });
+            process.exit(1);
+        });
+        process.on("unhandledRejection", (reason) => {
+            logger.error("Unhandled rejection", {
+                reason: reason instanceof Error ? reason.message : String(reason),
+            });
+            process.exit(1);
+        });
+    }
+    catch (error) {
+        logger.error("Failed to start server", {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        process.exit(1);
+    }
+}
+// Only run main when executed directly, not when imported (e.g., during tests)
+const isMainModule = import.meta.url === `file://${process.argv[1]}` || process.argv[1]?.endsWith("f5xc-api-mcp");
+if (isMainModule) {
+    main().catch((error) => {
+        logger.error("Fatal error", {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/prompts/error-resolution.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Error Resolution Prompts (Phase B)
+ *
+ * Provides guided diagnosis and resolution workflows for common
+ * F5XC API errors. These prompts help users troubleshoot issues
+ * systematically with framework-specific guidance.
+ */
+/**
+ * Error resolution prompt definition
+ */
+export interface ErrorPrompt {
+    /** HTTP status code */
+    code: number;
+    /** Error type name */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Prompt arguments */
+    arguments: ErrorPromptArgument[];
+    /** Prompt template */
+    template: string;
+}
+/**
+ * Error prompt argument
+ */
+export interface ErrorPromptArgument {
+    /** Argument name */
+    name: string;
+    /** Argument description */
+    description: string;
+    /** Whether argument is required */
+    required: boolean;
+}
+/**
+ * 401 Unauthorized - Authentication Issues
+ */
+export declare const error401Prompt: ErrorPrompt;
+/**
+ * 403 Forbidden - Authorization Issues
+ */
+export declare const error403Prompt: ErrorPrompt;
+/**
+ * 404 Not Found - Resource Issues
+ */
+export declare const error404Prompt: ErrorPrompt;
+/**
+ * 409 Conflict - Resource Conflict Issues
+ */
+export declare const error409Prompt: ErrorPrompt;
+/**
+ * 500 Internal Server Error - Server Issues
+ */
+export declare const error500Prompt: ErrorPrompt;
+/**
+ * All error resolution prompts
+ */
+export declare const ERROR_PROMPTS: ErrorPrompt[];
+/**
+ * Get error prompt by HTTP status code
+ */
+export declare function getErrorPrompt(code: number): ErrorPrompt | undefined;
+/**
+ * Get error prompt by name
+ */
+export declare function getErrorPromptByName(name: string): ErrorPrompt | undefined;
+/**
+ * Process error prompt template with arguments
+ */
+export declare function processErrorTemplate(prompt: ErrorPrompt, args: Record<string, string>): string;
+//# sourceMappingURL=error-resolution.d.ts.map

package/dist/prompts/error-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-resolution.d.ts","sourceRoot":"","sources":["../../src/prompts/error-resolution.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,WAoD5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,WA2D5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,WAyD5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,WA2D5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,WA8D5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,EAMtC,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEpE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE1E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAS9F"}

package/dist/prompts/error-resolution.js

@@ -0,0 +1,350 @@
+/**
+ * Error Resolution Prompts (Phase B)
+ *
+ * Provides guided diagnosis and resolution workflows for common
+ * F5XC API errors. These prompts help users troubleshoot issues
+ * systematically with framework-specific guidance.
+ */
+/**
+ * 401 Unauthorized - Authentication Issues
+ */
+export const error401Prompt = {
+    code: 401,
+    name: "resolve-401-unauthorized",
+    description: "Diagnose and resolve authentication failures (401 Unauthorized)",
+    arguments: [
+        {
+            name: "operation",
+            description: "The API operation that failed (e.g., 'create http-loadbalancer')",
+            required: false,
+        },
+        {
+            name: "error_message",
+            description: "The specific error message received",
+            required: false,
+        },
+    ],
+    template: `# 401 Unauthorized - Authentication Resolution
+
+## Common Causes
+1. **Missing API Token**: F5XC_API_TOKEN environment variable not set
+2. **Expired Token**: API token has expired and needs regeneration
+3. **Invalid Token**: Token was revoked or is malformed
+4. **Wrong Tenant**: Token is for a different F5XC tenant
+
+## Diagnosis Steps
+
+### Step 1: Verify Token Configuration
+Check if the API token is properly configured:
+- Environment variable: F5XC_API_TOKEN
+- Tenant URL: F5XC_API_URL
+
+### Step 2: Validate Token
+Use f5xc-api-server-info to check authentication status.
+If not authenticated, the token needs to be set or refreshed.
+
+### Step 3: Token Regeneration
+If the token is expired:
+1. Log into F5 Distributed Cloud Console
+2. Navigate to Account Settings → Credentials
+3. Generate a new API Token
+4. Set F5XC_API_TOKEN with the new value
+
+## Related Tools
+- f5xc-api-server-info: Check current authentication status
+- f5xc-api-search-tools: Find authentication-related operations
+
+## Resolution Checklist
+- [ ] Verify F5XC_API_TOKEN is set
+- [ ] Verify F5XC_API_URL points to correct tenant
+- [ ] Check token expiration in Console
+- [ ] Regenerate token if needed
+`,
+};
+/**
+ * 403 Forbidden - Authorization Issues
+ */
+export const error403Prompt = {
+    code: 403,
+    name: "resolve-403-forbidden",
+    description: "Diagnose and resolve authorization failures (403 Forbidden)",
+    arguments: [
+        {
+            name: "operation",
+            description: "The API operation that failed",
+            required: false,
+        },
+        {
+            name: "namespace",
+            description: "The namespace where the operation was attempted",
+            required: false,
+        },
+        {
+            name: "resource",
+            description: "The resource type being accessed",
+            required: false,
+        },
+    ],
+    template: `# 403 Forbidden - Authorization Resolution
+
+## Common Causes
+1. **Insufficient Permissions**: User lacks RBAC permissions for this operation
+2. **Namespace Restrictions**: User cannot access resources in this namespace
+3. **Resource-Level Policies**: Resource has access restrictions
+4. **Subscription Required**: Operation requires an addon service subscription
+
+## Diagnosis Steps
+
+### Step 1: Check User Roles
+Verify your user account has appropriate roles:
+- Namespace Admin: Full access within namespace
+- Tenant Admin: Full access across tenant
+- Custom roles: Check specific permissions
+
+### Step 2: Verify Namespace Access
+Ensure you have access to the target namespace.
+Use f5xc-api-search-tools with query "namespace" to find namespace operations.
+
+### Step 3: Check Subscription Requirements
+Some features require addon subscriptions:
+- WAAP Advanced features
+- Bot Defense
+- API Security
+
+Use f5xc-api-dependencies with action="subscriptions" to check requirements.
+
+## Related Tools
+- f5xc-api-dependencies: Check subscription requirements
+- f5xc-api-search-tools: Find user/role operations
+
+## Resolution Checklist
+- [ ] Verify user role includes required permissions
+- [ ] Confirm namespace access is granted
+- [ ] Check if addon subscription is required
+- [ ] Contact tenant admin if permissions needed
+`,
+};
+/**
+ * 404 Not Found - Resource Issues
+ */
+export const error404Prompt = {
+    code: 404,
+    name: "resolve-404-not-found",
+    description: "Diagnose and resolve resource not found errors (404 Not Found)",
+    arguments: [
+        {
+            name: "resource_type",
+            description: "The type of resource (e.g., 'http-loadbalancer')",
+            required: false,
+        },
+        {
+            name: "resource_name",
+            description: "The name of the missing resource",
+            required: false,
+        },
+        {
+            name: "namespace",
+            description: "The namespace being searched",
+            required: false,
+        },
+    ],
+    template: `# 404 Not Found - Resource Resolution
+
+## Common Causes
+1. **Resource Doesn't Exist**: The specified resource hasn't been created
+2. **Wrong Namespace**: Resource exists in a different namespace
+3. **Typo in Name**: Resource name is misspelled
+4. **Deleted Resource**: Resource was previously deleted
+5. **Wrong Domain**: Using incorrect API domain for this resource type
+
+## Diagnosis Steps
+
+### Step 1: Verify Resource Exists
+Use the list operation to check if the resource exists:
+- Search for list operations: f5xc-api-search-tools with query "list [resource_type]"
+- Execute list in the target namespace
+
+### Step 2: Check Other Namespaces
+The resource might exist in a different namespace:
+- List all namespaces
+- Search for resource in each namespace
+
+### Step 3: Verify Resource Type
+Ensure you're using the correct resource type and API domain:
+- Use f5xc-api-search-resources to find the correct resource
+- Check domain matches (e.g., 'virtual' for load balancers)
+
+## Related Tools
+- f5xc-api-search-resources: Find resources by name
+- f5xc-api-search-tools: Find list operations
+
+## Resolution Checklist
+- [ ] Verify resource name spelling
+- [ ] Check correct namespace is specified
+- [ ] Use list operation to find existing resources
+- [ ] Create resource if it doesn't exist
+`,
+};
+/**
+ * 409 Conflict - Resource Conflict Issues
+ */
+export const error409Prompt = {
+    code: 409,
+    name: "resolve-409-conflict",
+    description: "Diagnose and resolve resource conflict errors (409 Conflict)",
+    arguments: [
+        {
+            name: "resource_type",
+            description: "The type of resource involved",
+            required: false,
+        },
+        {
+            name: "resource_name",
+            description: "The name of the conflicting resource",
+            required: false,
+        },
+        {
+            name: "operation",
+            description: "The operation attempted (create/update/delete)",
+            required: false,
+        },
+    ],
+    template: `# 409 Conflict - Resource Conflict Resolution
+
+## Common Causes
+1. **Duplicate Name**: Resource with same name already exists
+2. **Version Conflict**: Resource was modified by another operation
+3. **State Conflict**: Resource is in a transitional state
+4. **Dependency Conflict**: Operation conflicts with dependent resources
+5. **Concurrent Modification**: Race condition with another update
+
+## Diagnosis Steps
+
+### Step 1: Check for Existing Resource
+Use get/list operations to check current resource state:
+- If creating: resource may already exist
+- If updating: resource may have been modified
+
+### Step 2: Check Resource Dependencies
+Use f5xc-api-dependencies to understand relationships:
+- Check what depends on this resource
+- Check what this resource depends on
+
+### Step 3: Handle Version Conflicts
+For update operations:
+- Fetch latest version of resource
+- Apply changes to fresh copy
+- Retry update with current version
+
+## Related Tools
+- f5xc-api-dependencies: Check resource relationships
+- f5xc-api-describe-tool: Get full schema for retry
+
+## Resolution Checklist
+- [ ] Check if resource already exists (for creates)
+- [ ] Fetch latest resource version (for updates)
+- [ ] Wait for transitional states to complete
+- [ ] Resolve dependency conflicts first
+- [ ] Retry operation with fresh data
+`,
+};
+/**
+ * 500 Internal Server Error - Server Issues
+ */
+export const error500Prompt = {
+    code: 500,
+    name: "resolve-500-internal-error",
+    description: "Diagnose and handle internal server errors (500 Internal Server Error)",
+    arguments: [
+        {
+            name: "operation",
+            description: "The operation that triggered the error",
+            required: false,
+        },
+        {
+            name: "error_message",
+            description: "Any specific error message received",
+            required: false,
+        },
+    ],
+    template: `# 500 Internal Server Error - Resolution Guide
+
+## Common Causes
+1. **Transient Service Issue**: Temporary backend problem
+2. **Invalid Request Body**: Malformed or invalid request data
+3. **Backend Timeout**: Long-running operation timed out
+4. **Service Maintenance**: Planned or unplanned maintenance
+5. **Rate Limiting**: Too many requests in short period
+
+## Diagnosis Steps
+
+### Step 1: Validate Request
+Check if request body is valid:
+- Use f5xc-api-describe-tool to verify parameter requirements
+- Check required fields and formats
+- Validate JSON structure
+
+### Step 2: Retry with Exponential Backoff
+For transient issues:
+- Wait 1 second, retry
+- If fails, wait 2 seconds, retry
+- Continue doubling wait time (max 30 seconds)
+
+### Step 3: Simplify Operation
+Try breaking complex operations into simpler steps:
+- Create dependencies separately
+- Reduce request complexity
+- Check for optional fields causing issues
+
+### Step 4: Check Service Status
+If errors persist:
+- Check F5 Distributed Cloud status page
+- Review system announcements
+- Contact F5 support if widespread issue
+
+## Related Tools
+- f5xc-api-describe-tool: Validate request schema
+- f5xc-api-dependencies: Check prerequisites
+
+## Resolution Checklist
+- [ ] Validate request body against schema
+- [ ] Retry with exponential backoff
+- [ ] Simplify request if complex
+- [ ] Check F5 service status
+- [ ] Contact support if persistent
+`,
+};
+/**
+ * All error resolution prompts
+ */
+export const ERROR_PROMPTS = [
+    error401Prompt,
+    error403Prompt,
+    error404Prompt,
+    error409Prompt,
+    error500Prompt,
+];
+/**
+ * Get error prompt by HTTP status code
+ */
+export function getErrorPrompt(code) {
+    return ERROR_PROMPTS.find((p) => p.code === code);
+}
+/**
+ * Get error prompt by name
+ */
+export function getErrorPromptByName(name) {
+    return ERROR_PROMPTS.find((p) => p.name === name);
+}
+/**
+ * Process error prompt template with arguments
+ */
+export function processErrorTemplate(prompt, args) {
+    let processed = prompt.template;
+    for (const [key, value] of Object.entries(args)) {
+        const placeholder = new RegExp(`\\{\\{${key}\\}\\}`, "g");
+        processed = processed.replace(placeholder, value || `[${key}]`);
+    }
+    return processed;
+}
+//# sourceMappingURL=error-resolution.js.map

package/dist/prompts/error-resolution.js.map

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

package/dist/prompts/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Prompts Module - Export all prompt utilities
+ */
+export { WORKFLOW_PROMPTS, getWorkflowPrompt, processPromptTemplate, deployHttpLoadBalancerPrompt, configureWafPrompt, createMultiCloudSitePrompt, generateTerraformPrompt, } from "./workflows.js";
+export type { WorkflowPrompt, WorkflowArgument } from "./workflows.js";
+export { ERROR_PROMPTS, getErrorPrompt, getErrorPromptByName, processErrorTemplate, error401Prompt, error403Prompt, error404Prompt, error409Prompt, error500Prompt, } from "./error-resolution.js";
+export type { ErrorPrompt, ErrorPromptArgument } from "./error-resolution.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,4BAA4B,EAC5B,kBAAkB,EAClB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvE,OAAO,EACL,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/prompts/index.js

@@ -0,0 +1,7 @@
+/**
+ * Prompts Module - Export all prompt utilities
+ */
+export { WORKFLOW_PROMPTS, getWorkflowPrompt, processPromptTemplate, deployHttpLoadBalancerPrompt, configureWafPrompt, createMultiCloudSitePrompt, generateTerraformPrompt, } from "./workflows.js";
+// Phase B: Error resolution prompts
+export { ERROR_PROMPTS, getErrorPrompt, getErrorPromptByName, processErrorTemplate, error401Prompt, error403Prompt, error404Prompt, error409Prompt, error500Prompt, } from "./error-resolution.js";
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,4BAA4B,EAC5B,kBAAkB,EAClB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAIxB,oCAAoC;AACpC,OAAO,EACL,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,uBAAuB,CAAC"}