@frase/mcp-server 0.1.0

package/dist/cache.js

@@ -0,0 +1,97 @@
+/**
+ * Simple in-memory cache for GET responses
+ */
+/**
+ * Cache TTL configuration (in milliseconds)
+ */
+export const CACHE_TTL = {
+    lists: 60_000, // 1 minute for list endpoints
+    resources: 300_000, // 5 minutes for individual resources
+};
+/**
+ * Simple cache implementation
+ */
+export class ResponseCache {
+    cache = new Map();
+    cleanupInterval = null;
+    constructor() {
+        // Run cleanup every minute
+        this.cleanupInterval = setInterval(() => this.cleanup(), 60_000);
+    }
+    /**
+     * Get a cached value
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return undefined;
+        }
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            return undefined;
+        }
+        return entry.data;
+    }
+    /**
+     * Set a cached value
+     */
+    set(key, data, ttl) {
+        this.cache.set(key, {
+            data,
+            expiresAt: Date.now() + ttl,
+        });
+    }
+    /**
+     * Generate cache key for a request
+     */
+    static key(method, path, params) {
+        const paramStr = params ? JSON.stringify(params) : "";
+        return `${method}:${path}:${paramStr}`;
+    }
+    /**
+     * Invalidate cache entries matching a pattern
+     */
+    invalidate(pattern) {
+        const regex = typeof pattern === "string" ? new RegExp(pattern) : pattern;
+        for (const key of this.cache.keys()) {
+            if (regex.test(key)) {
+                this.cache.delete(key);
+            }
+        }
+    }
+    /**
+     * Invalidate all cache entries for a resource type
+     * Called after write operations
+     */
+    invalidateResourceType(resourceType) {
+        this.invalidate(new RegExp(`:/${resourceType}`));
+    }
+    /**
+     * Clear all cached entries
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Clean up expired entries
+     */
+    cleanup() {
+        const now = Date.now();
+        for (const [key, entry] of this.cache.entries()) {
+            if (now > entry.expiresAt) {
+                this.cache.delete(key);
+            }
+        }
+    }
+    /**
+     * Stop the cleanup interval (for graceful shutdown)
+     */
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+        this.cache.clear();
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Configuration for the Frase MCP Server
+ */
+export interface Config {
+    apiKey: string;
+    apiUrl: string;
+    debug: boolean;
+}
+/**
+ * Load configuration from environment variables
+ */
+export declare function loadConfig(): Config;
+/**
+ * Log debug message if debug mode is enabled
+ */
+export declare function debugLog(config: Config, ...args: unknown[]): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAOD;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAenC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAIjE"}

package/dist/config.js

@@ -0,0 +1,31 @@
+/**
+ * Configuration for the Frase MCP Server
+ */
+/**
+ * Default API URL
+ */
+const DEFAULT_API_URL = "https://next.frase.io/api/v1";
+/**
+ * Load configuration from environment variables
+ */
+export function loadConfig() {
+    const apiKey = process.env.FRASE_API_KEY;
+    if (!apiKey) {
+        throw new Error("FRASE_API_KEY environment variable is required. " +
+            "Get your API key from https://app.frase.io/settings/api");
+    }
+    return {
+        apiKey,
+        apiUrl: process.env.FRASE_API_URL || DEFAULT_API_URL,
+        debug: process.env.FRASE_MCP_DEBUG === "true",
+    };
+}
+/**
+ * Log debug message if debug mode is enabled
+ */
+export function debugLog(config, ...args) {
+    if (config.debug) {
+        console.error("[Frase MCP Debug]", ...args);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;GAEG;AACH,MAAM,eAAe,GAAG,8BAA8B,CAAC;AAEvD;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAEzC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,kDAAkD;YAChD,yDAAyD,CAC5D,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM;QACN,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,eAAe;QACpD,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,MAAM;KAC9C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,GAAG,IAAe;IACzD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,IAAI,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC"}

package/dist/formatter.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Markdown response formatter for MCP tools
+ */
+/**
+ * Format a date for display
+ */
+export declare function formatDate(date: string | Date): string;
+/**
+ * Format status with emoji
+ */
+export declare function formatStatus(status: string): string;
+/**
+ * Format a list of items as a markdown table
+ */
+export declare function formatTable(headers: string[], rows: string[][], options?: {
+    align?: ("left" | "center" | "right")[];
+}): string;
+/**
+ * Format pagination info
+ */
+export declare function formatPagination(pagination: {
+    page: number;
+    page_size: number;
+    total: number;
+    has_more: boolean;
+}): string;
+/**
+ * Format a success response
+ */
+export declare function formatSuccess(title: string, content: string): string;
+/**
+ * Format an error response
+ */
+export declare function formatError(error: Error | string): string;
+/**
+ * Format a key-value list
+ */
+export declare function formatKeyValue(items: Record<string, string | number | boolean | null | undefined>): string;
+/**
+ * Format word count
+ */
+export declare function formatWordCount(count: number | null | undefined): string;
+/**
+ * Truncate text with ellipsis
+ */
+export declare function truncate(text: string, maxLength: number): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAOtD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA2BnD;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,MAAM,EAAE,EAAE,EAChB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC,EAAE,CAAA;CAAE,GACpD,MAAM,CAiCR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,MAAM,CAYT;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAGzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,CAa1G;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAUxE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAMhE"}

package/dist/formatter.js

@@ -0,0 +1,136 @@
+/**
+ * Markdown response formatter for MCP tools
+ */
+/**
+ * Format a date for display
+ */
+export function formatDate(date) {
+    const d = typeof date === "string" ? new Date(date) : date;
+    return d.toLocaleDateString("en-US", {
+        month: "short",
+        day: "numeric",
+        year: "numeric",
+    });
+}
+/**
+ * Format status with emoji
+ */
+export function formatStatus(status) {
+    const statusEmojis = {
+        // Content statuses
+        draft: "📝",
+        generating: "🔄",
+        review: "👀",
+        published: "✅",
+        archived: "📦",
+        // Brief statuses
+        pending: "⏳",
+        research: "🔍",
+        ready: "✅",
+        completed: "✅",
+        // Job statuses
+        running: "🔄",
+        failed: "❌",
+        success: "✅",
+        // Audit statuses
+        crawling: "🕷️",
+        analyzing: "🔍",
+    };
+    const emoji = statusEmojis[status.toLowerCase()] || "•";
+    return `${emoji} ${status}`;
+}
+/**
+ * Format a list of items as a markdown table
+ */
+export function formatTable(headers, rows, options) {
+    if (rows.length === 0) {
+        return "_No items found._";
+    }
+    const align = options?.align || headers.map(() => "left");
+    // Build header row
+    let table = "| " + headers.join(" | ") + " |\n";
+    // Build separator row with alignment
+    table +=
+        "| " +
+            align
+                .map((a) => {
+                switch (a) {
+                    case "center":
+                        return ":---:";
+                    case "right":
+                        return "---:";
+                    default:
+                        return "---";
+                }
+            })
+                .join(" | ") +
+            " |\n";
+    // Build data rows
+    for (const row of rows) {
+        table += "| " + row.join(" | ") + " |\n";
+    }
+    return table;
+}
+/**
+ * Format pagination info
+ */
+export function formatPagination(pagination) {
+    const start = (pagination.page - 1) * pagination.page_size + 1;
+    const end = Math.min(pagination.page * pagination.page_size, pagination.total);
+    let text = `\n**Showing ${start}-${end} of ${pagination.total} items**`;
+    if (pagination.has_more) {
+        text += ` · \`has_more: true\`\n`;
+        text += `\nUse \`page: ${pagination.page + 1}\` to see more.`;
+    }
+    return text;
+}
+/**
+ * Format a success response
+ */
+export function formatSuccess(title, content) {
+    return `## ${title}\n\n${content}`;
+}
+/**
+ * Format an error response
+ */
+export function formatError(error) {
+    const message = typeof error === "string" ? error : error.message;
+    return `**Error:** ${message}`;
+}
+/**
+ * Format a key-value list
+ */
+export function formatKeyValue(items) {
+    const lines = [];
+    for (const [key, value] of Object.entries(items)) {
+        if (value !== undefined && value !== null) {
+            const displayKey = key
+                .replace(/_/g, " ")
+                .replace(/\b\w/g, (c) => c.toUpperCase());
+            lines.push(`- **${displayKey}:** ${value}`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Format word count
+ */
+export function formatWordCount(count) {
+    if (count === null || count === undefined) {
+        return "-";
+    }
+    if (count >= 1000) {
+        return `${(count / 1000).toFixed(1)}k`;
+    }
+    return count.toString();
+}
+/**
+ * Truncate text with ellipsis
+ */
+export function truncate(text, maxLength) {
+    if (text.length <= maxLength) {
+        return text;
+    }
+    return text.slice(0, maxLength - 3) + "...";
+}
+//# sourceMappingURL=formatter.js.map

package/dist/formatter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+/**
+ * Frase MCP Server
+ *
+ * A Model Context Protocol (MCP) server that allows customers to interact with
+ * their Frase account via AI tools like Claude Desktop.
+ *
+ * Features:
+ * - API key authentication
+ * - All v1 API functionality as MCP tools
+ * - Markdown-formatted responses for easy reading
+ * - Local caching for improved performance
+ * - Auto-retry with exponential backoff
+ *
+ * Usage:
+ * Set FRASE_API_KEY environment variable before connecting
+ *
+ * Claude Desktop config example:
+ * {
+ *   "mcpServers": {
+ *     "frase": {
+ *       "command": "npx",
+ *       "args": ["-y", "@frase/mcp-server"],
+ *       "env": {
+ *         "FRASE_API_KEY": "your-api-key-here"
+ *       }
+ *     }
+ *   }
+ * }
+ */
+export {};
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG"}

package/dist/index.js

@@ -0,0 +1,292 @@
+#!/usr/bin/env node
+/**
+ * Frase MCP Server
+ *
+ * A Model Context Protocol (MCP) server that allows customers to interact with
+ * their Frase account via AI tools like Claude Desktop.
+ *
+ * Features:
+ * - API key authentication
+ * - All v1 API functionality as MCP tools
+ * - Markdown-formatted responses for easy reading
+ * - Local caching for improved performance
+ * - Auto-retry with exponential backoff
+ *
+ * Usage:
+ * Set FRASE_API_KEY environment variable before connecting
+ *
+ * Claude Desktop config example:
+ * {
+ *   "mcpServers": {
+ *     "frase": {
+ *       "command": "npx",
+ *       "args": ["-y", "@frase/mcp-server"],
+ *       "env": {
+ *         "FRASE_API_KEY": "your-api-key-here"
+ *       }
+ *     }
+ *   }
+ * }
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, ErrorCode, McpError, } from "@modelcontextprotocol/sdk/types.js";
+import { config as loadEnv } from "dotenv";
+// Load environment variables
+loadEnv();
+import { loadConfig, debugLog } from "./config.js";
+import { FraseApiClient } from "./api-client.js";
+import { ALL_TOOLS, TOOL_EXECUTORS, getToolByName } from "./tools/index.js";
+import { ALL_RESOURCE_TEMPLATES, listAllResources, readResource, getRootResources, } from "./resources/index.js";
+import { ALL_PROMPTS, getPromptByName, getPromptMessages, } from "./prompts/index.js";
+// Server metadata
+const SERVER_NAME = "frase-mcp-server";
+const SERVER_VERSION = "0.1.0";
+/**
+ * Main MCP server class
+ */
+class FraseMcpServer {
+    server;
+    config = null;
+    client = null;
+    isInitialized = false;
+    constructor() {
+        this.server = new Server({
+            name: SERVER_NAME,
+            version: SERVER_VERSION,
+        }, {
+            capabilities: {
+                tools: {},
+                resources: {},
+                prompts: {},
+            },
+        });
+        this.setupHandlers();
+        this.setupErrorHandling();
+    }
+    /**
+     * Initialize the server (load config, create API client)
+     */
+    async initialize() {
+        if (this.isInitialized) {
+            return;
+        }
+        try {
+            this.config = loadConfig();
+            this.client = new FraseApiClient(this.config);
+            this.isInitialized = true;
+            debugLog(this.config, "Server initialized");
+            debugLog(this.config, `API URL: ${this.config.apiUrl}`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unknown error";
+            throw new McpError(ErrorCode.InvalidRequest, message);
+        }
+    }
+    /**
+     * Get tool context for execution
+     */
+    getContext() {
+        if (!this.config || !this.client) {
+            throw new McpError(ErrorCode.InvalidRequest, "Server not initialized");
+        }
+        return {
+            client: this.client,
+            config: this.config,
+        };
+    }
+    /**
+     * Set up MCP request handlers
+     */
+    setupHandlers() {
+        // Handle list_tools request
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            await this.initialize();
+            return {
+                tools: ALL_TOOLS.map((tool) => ({
+                    name: tool.name,
+                    description: tool.description,
+                    inputSchema: tool.inputSchema,
+                })),
+            };
+        });
+        // Handle list_resources request
+        this.server.setRequestHandler(ListResourcesRequestSchema, async () => {
+            await this.initialize();
+            try {
+                const context = this.getContext();
+                const resources = await listAllResources(context);
+                return {
+                    resources: resources.map((r) => ({
+                        uri: r.uri,
+                        name: r.name,
+                        description: r.description,
+                        mimeType: r.mimeType,
+                    })),
+                };
+            }
+            catch (error) {
+                console.error("[Frase MCP] Error listing resources:", error);
+                // Return root resources as fallback
+                return {
+                    resources: getRootResources().map((r) => ({
+                        uri: r.uri,
+                        name: r.name,
+                        description: r.description,
+                        mimeType: r.mimeType,
+                    })),
+                };
+            }
+        });
+        // Handle list_resource_templates request
+        this.server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => {
+            return {
+                resourceTemplates: ALL_RESOURCE_TEMPLATES.map((t) => ({
+                    uriTemplate: t.uriTemplate,
+                    name: t.name,
+                    description: t.description,
+                    mimeType: t.mimeType,
+                })),
+            };
+        });
+        // Handle read_resource request
+        this.server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+            await this.initialize();
+            const { uri } = request.params;
+            try {
+                debugLog(this.config, `Reading resource: ${uri}`);
+                const context = this.getContext();
+                const result = await readResource(uri, context);
+                return result;
+            }
+            catch (error) {
+                console.error(`[Frase MCP] Error reading resource:`, error);
+                const message = error instanceof Error ? error.message : "Unknown error";
+                throw new McpError(ErrorCode.InvalidRequest, message);
+            }
+        });
+        // Handle list_prompts request
+        this.server.setRequestHandler(ListPromptsRequestSchema, async () => {
+            return {
+                prompts: ALL_PROMPTS.map((p) => ({
+                    name: p.name,
+                    description: p.description,
+                    arguments: p.arguments,
+                })),
+            };
+        });
+        // Handle get_prompt request
+        this.server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+            const { name, arguments: promptArgs } = request.params;
+            const prompt = getPromptByName(name);
+            if (!prompt) {
+                throw new McpError(ErrorCode.MethodNotFound, `Unknown prompt: ${name}`);
+            }
+            try {
+                const messages = getPromptMessages(name, promptArgs || {});
+                return {
+                    description: prompt.description,
+                    messages,
+                };
+            }
+            catch (error) {
+                console.error(`[Frase MCP] Error getting prompt:`, error);
+                const message = error instanceof Error ? error.message : "Unknown error";
+                throw new McpError(ErrorCode.InvalidRequest, message);
+            }
+        });
+        // Handle call_tool request
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            await this.initialize();
+            const { name, arguments: args } = request.params;
+            // Find the tool
+            const tool = getToolByName(name);
+            if (!tool) {
+                throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+            }
+            // Get the executor
+            const executor = TOOL_EXECUTORS[name];
+            if (!executor) {
+                throw new McpError(ErrorCode.InternalError, `No executor for tool: ${name}`);
+            }
+            // Execute the tool
+            try {
+                debugLog(this.config, `Executing tool: ${name}`);
+                const startTime = Date.now();
+                const context = this.getContext();
+                const result = await executor(args, context);
+                const duration = Date.now() - startTime;
+                debugLog(this.config, `Tool ${name} completed in ${duration}ms`);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: result.markdown,
+                        },
+                    ],
+                    isError: !result.success,
+                };
+            }
+            catch (error) {
+                console.error(`[Frase MCP] Tool execution error:`, error);
+                const message = error instanceof Error ? error.message : "Unknown error";
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `**Error:** ${message}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    /**
+     * Set up error handling
+     */
+    setupErrorHandling() {
+        this.server.onerror = (error) => {
+            console.error("[Frase MCP] Server error:", error);
+        };
+        process.on("SIGINT", async () => {
+            console.error("[Frase MCP] Shutting down...");
+            this.cleanup();
+            await this.server.close();
+            process.exit(0);
+        });
+        process.on("SIGTERM", async () => {
+            console.error("[Frase MCP] Shutting down...");
+            this.cleanup();
+            await this.server.close();
+            process.exit(0);
+        });
+    }
+    /**
+     * Clean up resources
+     */
+    cleanup() {
+        if (this.client) {
+            this.client.destroy();
+        }
+    }
+    /**
+     * Start the MCP server
+     */
+    async run() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error(`[Frase MCP] Server started (v${SERVER_VERSION})`);
+        console.error(`[Frase MCP] Tools available: ${ALL_TOOLS.length}`);
+        console.error(`[Frase MCP] Resource templates: ${ALL_RESOURCE_TEMPLATES.length}`);
+        console.error(`[Frase MCP] Prompts available: ${ALL_PROMPTS.length}`);
+        console.error("[Frase MCP] Waiting for connection...");
+    }
+}
+// Entry point
+const server = new FraseMcpServer();
+server.run().catch((error) => {
+    console.error("[Frase MCP] Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map