@rv404/mcp-launchpad 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,103 @@
+import { z } from 'zod';
+export interface BackendActionParam {
+    name: string;
+    type: string;
+    required: boolean;
+    description: string;
+    enum?: string[];
+}
+export interface BackendAction {
+    name: string;
+    description: string;
+    params: BackendActionParam[];
+}
+export type ActionDef = BackendAction;
+export interface Backend {
+    name: string;
+    description: string;
+    actions: BackendAction[];
+    execute(action: string, params: Record<string, unknown>): Promise<unknown>;
+    healthCheck(): Promise<HealthStatus>;
+}
+export interface HealthStatus {
+    status: 'healthy' | 'degraded' | 'unavailable';
+    latency_ms?: number;
+    error?: string;
+}
+export interface HealthReport {
+    router_version: string;
+    timestamp: string;
+    services: Record<string, HealthStatus>;
+}
+export interface RequestContext {
+    requestId: string;
+    service: string;
+    action: string;
+    startTime: number;
+}
+export interface RouterSuccessResponse {
+    success: true;
+    requestId: string;
+    service: string;
+    action: string;
+    duration_ms: number;
+    data: unknown;
+}
+export interface RouterErrorResponse {
+    success: false;
+    requestId: string;
+    service: string;
+    action: string;
+    error: {
+        type: 'auth' | 'rate_limit' | 'timeout' | 'network' | 'validation' | 'service_unavailable' | 'unknown_action' | 'unknown';
+        message: string;
+        retryable: boolean;
+        retryAfter?: number;
+    };
+}
+export type RouterResponse = RouterSuccessResponse | RouterErrorResponse;
+export interface RetryConfig {
+    maxAttempts: number;
+    initialDelayMs: number;
+    maxDelayMs: number;
+    backoffMultiplier: number;
+    retryableErrors: string[];
+}
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+export declare const DEFAULT_TIMEOUTS: Record<string, number>;
+export declare const ACTION_TIMEOUT_OVERRIDES: Record<string, Record<string, number>>;
+export type LogLevel = 'error' | 'warn' | 'info' | 'debug';
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    requestId?: string;
+    service?: string;
+    action?: string;
+    duration_ms?: number;
+    error?: string;
+    message: string;
+    [key: string]: unknown;
+}
+export declare const SERVICES: readonly ["clickup", "notion", "github", "slack", "n8n", "gemini", "quickbooks", "firecrawl", "youtube", "kie", "email"];
+export type ServiceName = typeof SERVICES[number];
+export declare const RouteRequestSchema: z.ZodObject<{
+    service: z.ZodEnum<["clickup", "notion", "github", "slack", "n8n", "gemini", "quickbooks", "firecrawl", "youtube", "kie", "email"]>;
+    action: z.ZodString;
+    params: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, "strip", z.ZodTypeAny, {
+    service: "clickup" | "notion" | "github" | "slack" | "n8n" | "gemini" | "quickbooks" | "firecrawl" | "youtube" | "kie" | "email";
+    action: string;
+    params: Record<string, unknown>;
+}, {
+    service: "clickup" | "notion" | "github" | "slack" | "n8n" | "gemini" | "quickbooks" | "firecrawl" | "youtube" | "kie" | "email";
+    action: string;
+    params?: Record<string, unknown> | undefined;
+}>;
+export declare const ListActionsSchema: z.ZodObject<{
+    service: z.ZodEnum<["clickup", "notion", "github", "slack", "n8n", "gemini", "quickbooks", "firecrawl", "youtube", "kie", "email"]>;
+}, "strip", z.ZodTypeAny, {
+    service: "clickup" | "notion" | "github" | "slack" | "n8n" | "gemini" | "quickbooks" | "firecrawl" | "youtube" | "kie" | "email";
+}, {
+    service: "clickup" | "notion" | "github" | "slack" | "n8n" | "gemini" | "quickbooks" | "firecrawl" | "youtube" | "kie" | "email";
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+export const DEFAULT_RETRY_CONFIG = {
+    maxAttempts: 3,
+    initialDelayMs: 1000,
+    maxDelayMs: 10000,
+    backoffMultiplier: 2,
+    retryableErrors: ['timeout', 'network', 'service_unavailable']
+};
+// ============================================================================
+// Timeout Configuration
+// ============================================================================
+export const DEFAULT_TIMEOUTS = {
+    clickup: 30000,
+    notion: 30000,
+    github: 60000,
+    slack: 15000,
+    n8n: 120000,
+    gemini: 90000,
+    quickbooks: 30000,
+    firecrawl: 300000, // 5 minutes - crawling can take time
+    youtube: 120000, // 2 minutes - transcript fetching and analysis
+    kie: 90000, // 1.5 minutes - image generation with polling
+    email: 60000, // 1 minute - email operations
+};
+export const ACTION_TIMEOUT_OVERRIDES = {
+    n8n: {
+        test_workflow: 180000,
+        deploy_template: 60000,
+    },
+    github: {
+        push_files: 120000,
+        merge_pull_request: 60000,
+    },
+    gemini: {
+        generate_image: 120000,
+    },
+    quickbooks: {
+        query: 60000,
+    },
+    youtube: {
+        download_video: 300000, // 5 minutes for video downloads
+        download_audio: 180000, // 3 minutes for audio extraction
+        analyze: 180000, // 3 minutes for full analysis
+    },
+    kie: {
+        generate_image_pro: 120000, // 2 minutes for high-res generation
+        edit_image: 180000, // 3 minutes for multi-image editing
+    },
+};
+// ============================================================================
+// Service List
+// ============================================================================
+export const SERVICES = ['clickup', 'notion', 'github', 'slack', 'n8n', 'gemini', 'quickbooks', 'firecrawl', 'youtube', 'kie', 'email'];
+// ============================================================================
+// Zod Schemas for Input Validation
+// ============================================================================
+export const RouteRequestSchema = z.object({
+    service: z.enum(SERVICES),
+    action: z.string().min(1),
+    params: z.record(z.unknown()).optional().default({}),
+});
+export const ListActionsSchema = z.object({
+    service: z.enum(SERVICES),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8FxB,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,WAAW,EAAE,CAAC;IACd,cAAc,EAAE,IAAI;IACpB,UAAU,EAAE,KAAK;IACjB,iBAAiB,EAAE,CAAC;IACpB,eAAe,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,qBAAqB,CAAC;CAC/D,CAAC;AAEF,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,OAAO,EAAE,KAAK;IACd,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,KAAK;IACZ,GAAG,EAAE,MAAM;IACX,MAAM,EAAE,KAAK;IACb,UAAU,EAAE,KAAK;IACjB,SAAS,EAAE,MAAM,EAAE,qCAAqC;IACxD,OAAO,EAAE,MAAM,EAAE,+CAA+C;IAChE,GAAG,EAAE,KAAK,EAAE,8CAA8C;IAC1D,KAAK,EAAE,KAAK,EAAE,8BAA8B;CAC7C,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAA2C;IAC9E,GAAG,EAAE;QACH,aAAa,EAAE,MAAM;QACrB,eAAe,EAAE,KAAK;KACvB;IACD,MAAM,EAAE;QACN,UAAU,EAAE,MAAM;QAClB,kBAAkB,EAAE,KAAK;KAC1B;IACD,MAAM,EAAE;QACN,cAAc,EAAE,MAAM;KACvB;IACD,UAAU,EAAE;QACV,KAAK,EAAE,KAAK;KACb;IACD,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,EAAE,gCAAgC;QACxD,cAAc,EAAE,MAAM,EAAE,iCAAiC;QACzD,OAAO,EAAE,MAAM,EAAE,8BAA8B;KAChD;IACD,GAAG,EAAE;QACH,kBAAkB,EAAE,MAAM,EAAE,oCAAoC;QAChE,UAAU,EAAE,MAAM,EAAE,oCAAoC;KACzD;CACF,CAAC;AAoBF,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAU,CAAC;AAGjJ,+EAA+E;AAC/E,mCAAmC;AACnC,+EAA+E;AAE/E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CACrD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;CAC1B,CAAC,CAAC"}

package/lib/mcp-file-output/dist/index.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Initialize the file output utility with a custom data root
+ */
+export declare function init(dataRoot: string): void;
+/**
+ * Get the current data root directory
+ */
+export declare function getDataRoot(): string;
+export interface FileOutputConfig {
+    service: string;
+    action: string;
+    outputType?: 'temp' | 'outputs' | 'cache';
+    filename?: string;
+    subdir?: string;
+}
+export interface FileOutputResult {
+    saved: boolean;
+    path?: string;
+    dir?: string;
+    files?: string[];
+    manifest?: string;
+    bytesSaved?: number;
+    reason?: string;
+}
+export interface ManifestEntry {
+    filename: string;
+    url?: string;
+    title?: string;
+    timestamp: string;
+    bytes: number;
+}
+export interface OutputManifest {
+    service: string;
+    action: string;
+    created: string;
+    totalFiles: number;
+    totalBytes: number;
+    files: ManifestEntry[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Determines if a response should be saved to disk based on size
+ */
+export declare function shouldSaveToDisk(data: unknown, forceFile?: boolean): boolean;
+/**
+ * Gets the output directory path for a given configuration
+ */
+export declare function getOutputDir(config: FileOutputConfig): string;
+/**
+ * Saves a single file and returns the result
+ */
+export declare function saveFile(data: string | Buffer, config: FileOutputConfig): Promise<FileOutputResult>;
+/**
+ * Saves multiple files with a manifest - ideal for crawl results
+ */
+export declare function saveMultipleFiles(files: Array<{
+    filename: string;
+    content: string;
+    url?: string;
+    title?: string;
+}>, config: FileOutputConfig, metadata?: Record<string, unknown>): Promise<FileOutputResult>;
+/**
+ * Saves large response data automatically if it exceeds threshold
+ * Returns either the original data (if small) or a reference to saved file(s)
+ */
+export declare function handleLargeResponse<T>(data: T, config: FileOutputConfig, options?: {
+    forceFile?: boolean;
+    returnData?: boolean;
+}): Promise<{
+    data: T;
+    fileOutput?: FileOutputResult;
+} | {
+    data: {
+        savedToFile: true;
+        location: string;
+        summary: string;
+    };
+    fileOutput: FileOutputResult;
+}>;
+/**
+ * Cleans up old temp files (utility for manual cleanup)
+ */
+export declare function cleanupTempFiles(olderThanDays?: number): Promise<{
+    deleted: number;
+    freedBytes: number;
+}>;
+export declare const fileOutput: {
+    init: typeof init;
+    getDataRoot: typeof getDataRoot;
+    shouldSaveToDisk: typeof shouldSaveToDisk;
+    getOutputDir: typeof getOutputDir;
+    saveFile: typeof saveFile;
+    saveMultipleFiles: typeof saveMultipleFiles;
+    handleLargeResponse: typeof handleLargeResponse;
+    cleanupTempFiles: typeof cleanupTempFiles;
+    TOKEN_THRESHOLD: number;
+};
+export default fileOutput;
+//# sourceMappingURL=index.d.ts.map

package/lib/mcp-file-output/dist/index.d.ts.map

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

package/lib/mcp-file-output/dist/index.js

@@ -0,0 +1,215 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+// ============================================================================
+// Configuration
+// ============================================================================
+// Default data root - can be overridden via environment variable or init()
+// Uses environment variable, or falls back to a folder in user's home directory
+const getDefaultDataRoot = () => {
+    const homeDir = process.env.HOME || process.env.USERPROFILE || '.';
+    return path.join(homeDir, '.router-mcp', 'data');
+};
+let DATA_ROOT = process.env.MCP_FILE_OUTPUT_DIR || process.env.ROUTER_MCP_DATA_DIR || getDefaultDataRoot();
+const TOKEN_THRESHOLD = 20000; // Auto-save responses exceeding this estimated token count
+const CHARS_PER_TOKEN = 4; // Rough estimate for token calculation
+/**
+ * Initialize the file output utility with a custom data root
+ */
+export function init(dataRoot) {
+    DATA_ROOT = dataRoot;
+}
+/**
+ * Get the current data root directory
+ */
+export function getDataRoot() {
+    return DATA_ROOT;
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+function estimateTokens(data) {
+    const str = typeof data === 'string' ? data : JSON.stringify(data);
+    return Math.ceil(str.length / CHARS_PER_TOKEN);
+}
+function sanitizeFilename(name) {
+    return name
+        .replace(/[<>:"/\\|?*]/g, '-')
+        .replace(/\s+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '')
+        .substring(0, 100);
+}
+function generateTimestamp() {
+    return new Date().toISOString().replace(/[:.]/g, '-').substring(0, 19);
+}
+async function ensureDir(dirPath) {
+    await fs.mkdir(dirPath, { recursive: true });
+}
+// ============================================================================
+// Core Functions
+// ============================================================================
+/**
+ * Determines if a response should be saved to disk based on size
+ */
+export function shouldSaveToDisk(data, forceFile) {
+    if (forceFile)
+        return true;
+    return estimateTokens(data) > TOKEN_THRESHOLD;
+}
+/**
+ * Gets the output directory path for a given configuration
+ */
+export function getOutputDir(config) {
+    const { service, outputType = 'outputs', subdir } = config;
+    const parts = [DATA_ROOT, outputType, service];
+    if (subdir)
+        parts.push(subdir);
+    return path.join(...parts);
+}
+/**
+ * Saves a single file and returns the result
+ */
+export async function saveFile(data, config) {
+    const dir = getOutputDir(config);
+    await ensureDir(dir);
+    const filename = config.filename || `${config.action}-${generateTimestamp()}`;
+    const ext = typeof data === 'string' ? '.json' : '';
+    const fullFilename = filename.includes('.') ? filename : `${filename}${ext}`;
+    const filePath = path.join(dir, fullFilename);
+    const content = typeof data === 'string' ? data : data;
+    await fs.writeFile(filePath, content, typeof data === 'string' ? 'utf-8' : undefined);
+    const stats = await fs.stat(filePath);
+    return {
+        saved: true,
+        path: filePath,
+        bytesSaved: stats.size,
+    };
+}
+/**
+ * Saves multiple files with a manifest - ideal for crawl results
+ */
+export async function saveMultipleFiles(files, config, metadata) {
+    const timestamp = generateTimestamp();
+    const subdir = config.subdir || timestamp;
+    const dir = getOutputDir({ ...config, subdir });
+    await ensureDir(dir);
+    const manifestEntries = [];
+    let totalBytes = 0;
+    // Save each file
+    for (const file of files) {
+        const safeName = sanitizeFilename(file.filename);
+        const filePath = path.join(dir, safeName);
+        await fs.writeFile(filePath, file.content, 'utf-8');
+        const stats = await fs.stat(filePath);
+        totalBytes += stats.size;
+        manifestEntries.push({
+            filename: safeName,
+            url: file.url,
+            title: file.title,
+            timestamp: new Date().toISOString(),
+            bytes: stats.size,
+        });
+    }
+    // Create manifest
+    const manifest = {
+        service: config.service,
+        action: config.action,
+        created: new Date().toISOString(),
+        totalFiles: files.length,
+        totalBytes,
+        files: manifestEntries,
+        metadata,
+    };
+    const manifestPath = path.join(dir, 'manifest.json');
+    await fs.writeFile(manifestPath, JSON.stringify(manifest, null, 2), 'utf-8');
+    return {
+        saved: true,
+        dir,
+        files: manifestEntries.map(e => e.filename),
+        manifest: manifestPath,
+        bytesSaved: totalBytes,
+    };
+}
+/**
+ * Saves large response data automatically if it exceeds threshold
+ * Returns either the original data (if small) or a reference to saved file(s)
+ */
+export async function handleLargeResponse(data, config, options) {
+    const shouldSave = shouldSaveToDisk(data, options?.forceFile);
+    if (!shouldSave) {
+        return { data };
+    }
+    const result = await saveFile(JSON.stringify(data, null, 2), config);
+    const summary = generateSummary(data);
+    return {
+        data: {
+            savedToFile: true,
+            location: result.path,
+            summary,
+        },
+        fileOutput: result,
+    };
+}
+/**
+ * Generates a brief summary of saved data for the response
+ */
+function generateSummary(data) {
+    if (Array.isArray(data)) {
+        return `Array with ${data.length} items`;
+    }
+    if (typeof data === 'object' && data !== null) {
+        const keys = Object.keys(data);
+        return `Object with keys: ${keys.slice(0, 5).join(', ')}${keys.length > 5 ? '...' : ''}`;
+    }
+    return `${typeof data} data`;
+}
+/**
+ * Cleans up old temp files (utility for manual cleanup)
+ */
+export async function cleanupTempFiles(olderThanDays) {
+    const tempDir = path.join(DATA_ROOT, 'temp');
+    let deleted = 0;
+    let freedBytes = 0;
+    try {
+        const services = await fs.readdir(tempDir);
+        for (const service of services) {
+            const serviceDir = path.join(tempDir, service);
+            const stats = await fs.stat(serviceDir);
+            if (stats.isDirectory()) {
+                const files = await fs.readdir(serviceDir);
+                for (const file of files) {
+                    const filePath = path.join(serviceDir, file);
+                    const fileStats = await fs.stat(filePath);
+                    if (olderThanDays) {
+                        const ageInDays = (Date.now() - fileStats.mtime.getTime()) / (1000 * 60 * 60 * 24);
+                        if (ageInDays < olderThanDays)
+                            continue;
+                    }
+                    freedBytes += fileStats.size;
+                    await fs.rm(filePath, { recursive: true });
+                    deleted++;
+                }
+            }
+        }
+    }
+    catch {
+        // Temp dir might not exist yet
+    }
+    return { deleted, freedBytes };
+}
+// ============================================================================
+// Default Export
+// ============================================================================
+export const fileOutput = {
+    init,
+    getDataRoot,
+    shouldSaveToDisk,
+    getOutputDir,
+    saveFile,
+    saveMultipleFiles,
+    handleLargeResponse,
+    cleanupTempFiles,
+    TOKEN_THRESHOLD,
+};
+export default fileOutput;
+//# sourceMappingURL=index.js.map

package/lib/mcp-file-output/dist/index.js.map

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

package/lib/mcp-file-output/node_modules/@types/node/LICENSE

@@ -0,0 +1,21 @@
+    MIT License
+
+    Copyright (c) Microsoft Corporation.
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

package/lib/mcp-file-output/node_modules/@types/node/README.md

@@ -0,0 +1,15 @@
+# Installation
+> `npm install --save @types/node`
+
+# Summary
+This package contains type definitions for node (https://nodejs.org/).
+
+# Details
+Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node/v20.
+
+### Additional Details
+ * Last updated: Sun, 14 Dec 2025 00:04:32 GMT
+ * Dependencies: [undici-types](https://npmjs.com/package/undici-types)
+
+# Credits
+These definitions were written by [Microsoft TypeScript](https://github.com/Microsoft), [Alberto Schiabel](https://github.com/jkomyno), [Andrew Makarov](https://github.com/r3nya), [Benjamin Toueg](https://github.com/btoueg), [David Junger](https://github.com/touffy), [Mohsen Azimi](https://github.com/mohsen1), [Nikita Galkin](https://github.com/galkin), [Sebastian Silbermann](https://github.com/eps1lon), [Wilco Bakker](https://github.com/WilcoBakker), [Marcin Kopacz](https://github.com/chyzwar), [Trivikram Kamat](https://github.com/trivikr), [Junxiao Shi](https://github.com/yoursunny), [Ilia Baryshnikov](https://github.com/qwelias), [ExE Boss](https://github.com/ExE-Boss), [Piotr Błażejewicz](https://github.com/peterblazejewicz), [Anna Henningsen](https://github.com/addaleax), [Victor Perin](https://github.com/victorperin), [NodeJS Contributors](https://github.com/NodeJS), [Linus Unnebäck](https://github.com/LinusU), [wafuwafu13](https://github.com/wafuwafu13), [Matteo Collina](https://github.com/mcollina), and [Dmitry Semigradsky](https://github.com/Semigradsky).

package/lib/mcp-file-output/node_modules/@types/node/assert/strict.d.ts

@@ -0,0 +1,8 @@
+declare module "assert/strict" {
+    import { strict } from "node:assert";
+    export = strict;
+}
+declare module "node:assert/strict" {
+    import { strict } from "node:assert";
+    export = strict;
+}