@cyanheads/mcp-ts-core 0.1.0-beta.12

package/dist/app.js

@@ -0,0 +1,222 @@
+/**
+ * @fileoverview Application composition root. Constructs all services in
+ * dependency order, initializes telemetry/logger, starts transport, and
+ * registers shutdown/signal handlers. Returns a ServerHandle for lifecycle
+ * management.
+ * @module src/app
+ */
+import { config, resetConfig } from './config/index.js';
+import { PromptRegistry } from './mcp-server/prompts/prompt-registration.js';
+import { ResourceRegistry } from './mcp-server/resources/resource-registration.js';
+import { RootsRegistry } from './mcp-server/roots/roots-registration.js';
+import { createMcpServerInstance } from './mcp-server/server.js';
+import { TaskManager } from './mcp-server/tasks/core/taskManager.js';
+import { ToolRegistry } from './mcp-server/tools/tool-registration.js';
+import { TransportManager } from './mcp-server/transports/manager.js';
+import { OpenRouterProvider } from './services/llm/providers/openrouter.provider.js';
+import { SpeechService } from './services/speech/core/SpeechService.js';
+import { StorageService } from './storage/core/StorageService.js';
+import { createStorageProvider } from './storage/core/storageFactory.js';
+import { JsonRpcErrorCode, McpError } from './types-global/errors.js';
+import { logger } from './utils/internal/logger.js';
+import { initHighResTimer } from './utils/internal/performance.js';
+import { requestContextService } from './utils/internal/requestContext.js';
+import { RateLimiter } from './utils/security/rateLimiter.js';
+import { initializeOpenTelemetry, shutdownOpenTelemetry, } from './utils/telemetry/instrumentation.js';
+/**
+ * Constructs core services, registries, and server factory.
+ * Shared by createApp() (Node) and createWorkerHandler() (Workers).
+ * Does NOT start transport, register signal handlers, or init OTEL/logger.
+ * @internal
+ */
+export async function composeServices(options = {}) {
+    const { tools = [], resources = [], prompts = [], setup } = options;
+    // Apply name/version overrides to env before config is parsed.
+    // resetConfig() invalidates the cached parse so the next config access
+    // picks up the new env values. This is the single authority for overrides —
+    // createApp() and createWorkerHandler() both delegate here.
+    if (options.name || options.version) {
+        if (options.name)
+            process.env.MCP_SERVER_NAME = options.name;
+        if (options.version)
+            process.env.MCP_SERVER_VERSION = options.version;
+        resetConfig();
+    }
+    // --- Core services ---
+    let supabaseClient;
+    if (config.storage.providerType === 'supabase') {
+        if (!config.supabase?.url || !config.supabase?.serviceRoleKey) {
+            throw new McpError(JsonRpcErrorCode.ConfigurationError, 'Supabase URL or service role key is missing for admin client.');
+        }
+        const { createClient } = await import('@supabase/supabase-js').catch(() => {
+            throw new McpError(JsonRpcErrorCode.ConfigurationError, 'Install "@supabase/supabase-js" to use Supabase storage: bun add @supabase/supabase-js');
+        });
+        supabaseClient = createClient(config.supabase.url, config.supabase.serviceRoleKey, {
+            auth: { persistSession: false, autoRefreshToken: false },
+        });
+    }
+    const storageProvider = createStorageProvider(config, {
+        ...(supabaseClient && { supabaseClient }),
+    });
+    const storageService = new StorageService(storageProvider);
+    const rateLimiter = new RateLimiter(config, logger);
+    // --- Optional services (constructed when config is present) ---
+    let llmProvider;
+    if (config.openrouterApiKey) {
+        llmProvider = new OpenRouterProvider(rateLimiter, config, logger);
+    }
+    let speechService;
+    if (config.speech) {
+        const ttsConfig = config.speech.tts?.enabled
+            ? config.speech.tts
+            : undefined;
+        const sttConfig = config.speech.stt?.enabled
+            ? config.speech.stt
+            : undefined;
+        if (ttsConfig || sttConfig) {
+            speechService = new SpeechService(ttsConfig, sttConfig);
+        }
+    }
+    const coreServices = {
+        config,
+        logger,
+        rateLimiter,
+        storage: storageService,
+        ...(llmProvider && { llmProvider }),
+        ...(speechService && { speechService }),
+        ...(supabaseClient && { supabase: supabaseClient }),
+    };
+    // --- Server-specific setup ---
+    if (setup) {
+        await setup(coreServices);
+    }
+    // --- MCP services ---
+    const toolRegistry = new ToolRegistry(tools, {
+        logger,
+        storage: storageService,
+    });
+    const resourceRegistry = new ResourceRegistry(resources, {
+        logger,
+        storage: storageService,
+    });
+    const promptRegistry = new PromptRegistry(prompts, logger);
+    const rootsRegistry = new RootsRegistry(logger);
+    const createServer = () => createMcpServerInstance({
+        config,
+        promptRegistry,
+        resourceRegistry,
+        rootsRegistry,
+        toolRegistry,
+    });
+    return { coreServices, createServer };
+}
+// ---------------------------------------------------------------------------
+// Public: createApp()
+// ---------------------------------------------------------------------------
+/**
+ * Suppresses ANSI color codes for MCP client compatibility.
+ */
+function suppressColors() {
+    const transportType = process.env.MCP_TRANSPORT_TYPE?.toLowerCase();
+    const isStdioMode = !transportType || transportType === 'stdio';
+    const isHttpModeWithoutTty = transportType === 'http' && !process.stdout.isTTY;
+    if (isStdioMode || isHttpModeWithoutTty) {
+        process.env.NO_COLOR = '1';
+        process.env.FORCE_COLOR = '0';
+    }
+}
+/**
+ * Composes the application, initializes all services, starts transport,
+ * and registers signal/error handlers. This is the complete entry point
+ * for a Node.js MCP server process.
+ *
+ * @param options - Definition arrays, name/version overrides, and setup callback.
+ *                  All arrays default to the template's built-in definitions.
+ * @returns A {@link ServerHandle} with `shutdown()` and `services`.
+ * @throws {McpError} If config parsing or service construction fails.
+ */
+export async function createApp(options = {}) {
+    suppressColors();
+    // --- Initialize OTEL + high-res timer (independent, run in parallel) ---
+    await Promise.all([
+        initializeOpenTelemetry().catch((err) => {
+            console.error('[Startup] Failed to initialize OpenTelemetry:', err);
+        }),
+        initHighResTimer(),
+    ]);
+    // --- Compose services (handles name/version overrides + resetConfig) ---
+    const { coreServices, createServer } = await composeServices(options);
+    // --- Initialize logger (after composeServices so config reflects overrides) ---
+    await logger.initialize(config.logLevel, config.mcpTransportType);
+    logger.info('Core services constructed.');
+    logger.info(`Storage service initialized with provider: ${config.storage.providerType}`, requestContextService.createRequestContext({ operation: 'StorageInit' }));
+    // --- Transport ---
+    const taskManager = new TaskManager(config, coreServices.storage);
+    const transportManager = new TransportManager(config, logger, createServer, taskManager);
+    // --- Startup context ---
+    const startupContext = requestContextService.createRequestContext({
+        operation: 'ServerStartup',
+        applicationName: config.mcpServerName,
+        applicationVersion: config.mcpServerVersion,
+        nodeEnvironment: config.environment,
+    });
+    logger.info(`Starting ${config.mcpServerName} (v${config.mcpServerVersion})...`, startupContext);
+    // --- Named handlers (stored for cleanup in shutdown) ---
+    const onUncaughtException = (error) => {
+        logger.fatal('FATAL: Uncaught exception detected.', error, startupContext);
+        void shutdown('uncaughtException');
+    };
+    const onUnhandledRejection = (reason) => {
+        const err = reason instanceof Error ? reason : new Error(String(reason));
+        logger.fatal('FATAL: Unhandled promise rejection detected.', err, startupContext);
+        void shutdown('unhandledRejection');
+    };
+    const onSigterm = () => void shutdown('SIGTERM');
+    const onSigint = () => void shutdown('SIGINT');
+    // --- Shutdown ---
+    let isShuttingDown = false;
+    const shutdown = async (signal = 'SHUTDOWN') => {
+        if (isShuttingDown)
+            return;
+        isShuttingDown = true;
+        // Remove listeners to prevent re-entry and allow GC in tests
+        process.removeListener('uncaughtException', onUncaughtException);
+        process.removeListener('unhandledRejection', onUnhandledRejection);
+        process.removeListener('SIGTERM', onSigterm);
+        process.removeListener('SIGINT', onSigint);
+        const shutdownContext = requestContextService.createRequestContext({
+            operation: 'ServerShutdown',
+            triggerEvent: signal,
+        });
+        logger.info(`Received ${signal}. Initiating graceful shutdown...`, shutdownContext);
+        try {
+            await transportManager.stop(signal);
+            logger.info('Graceful shutdown completed successfully.', shutdownContext);
+            await shutdownOpenTelemetry();
+            await logger.close();
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            logger.error('Critical error during shutdown process.', err, shutdownContext);
+            try {
+                await logger.close();
+            }
+            catch {
+                // Ignore errors during final logger close
+            }
+        }
+    };
+    // --- Register error/signal handlers ---
+    process.on('uncaughtException', onUncaughtException);
+    process.on('unhandledRejection', onUnhandledRejection);
+    // --- Start transport ---
+    await transportManager.start();
+    logger.info(`${config.mcpServerName} is now running and ready.`, startupContext);
+    process.on('SIGTERM', onSigterm);
+    process.on('SIGINT', onSigint);
+    return { services: coreServices, shutdown };
+}
+export { prompt } from './mcp-server/prompts/utils/newPromptDefinition.js';
+export { resource } from './mcp-server/resources/utils/newResourceDefinition.js';
+export { tool } from './mcp-server/tools/utils/newToolDefinition.js';
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

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

package/dist/cli/init.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview CLI entry point for `@cyanheads/mcp-ts-core`. Dispatches subcommands.
+ * Currently supports `init` for scaffolding new consumer projects.
+ * @module src/cli/init
+ */
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/cli/init.js

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview CLI entry point for `@cyanheads/mcp-ts-core`. Dispatches subcommands.
+ * Currently supports `init` for scaffolding new consumer projects.
+ * @module src/cli/init
+ */
+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { basename, dirname, join, relative } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const PACKAGE_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..', '..');
+const TEMPLATES_DIR = join(PACKAGE_ROOT, 'templates');
+const SKILLS_DIR = join(PACKAGE_ROOT, 'skills');
+// ── CLI dispatch ──────────────────────────────────────────────────────
+const [subcommand] = process.argv.slice(2);
+if (subcommand === 'init') {
+    init();
+}
+else {
+    printUsage();
+    process.exit(subcommand === undefined || subcommand === '--help' ? 0 : 1);
+}
+function printUsage() {
+    const pkg = JSON.parse(readFileSync(join(PACKAGE_ROOT, 'package.json'), 'utf-8'));
+    console.log(`
+  @cyanheads/mcp-ts-core v${pkg.version}
+
+  Usage:
+    mcp-ts-core init [name] [--dry-run]   Scaffold a new MCP server project
+    mcp-ts-core --help                    Show this help message
+
+  Examples:
+    npx @cyanheads/mcp-ts-core init my-mcp-server
+    bunx @cyanheads/mcp-ts-core init banking-server --dry-run
+`);
+}
+// ── Init command ──────────────────────────────────────────────────────
+function init() {
+    const args = process.argv.slice(3);
+    const dryRun = args.includes('--dry-run');
+    const name = args.find((a) => !a.startsWith('--'));
+    const dest = process.cwd();
+    console.log(`\n  Scaffolding${name ? ` ${name}` : ''} in ${dest}\n`);
+    const created = [];
+    const skipped = [];
+    // Step 1: Copy templates
+    copyTemplates(dest, name, dryRun, created, skipped);
+    // Step 2: Copy external skills
+    copyExternalSkills(dest, dryRun, created, skipped);
+    // Print summary
+    printSummary(created, skipped, dryRun, name);
+}
+// ── Template copying ──────────────────────────────────────────────────
+function copyTemplates(dest, name, dryRun, created, skipped) {
+    const entries = walkDir(TEMPLATES_DIR);
+    for (const srcPath of entries) {
+        let relPath = relative(TEMPLATES_DIR, srcPath);
+        // Strip template naming conventions that prevent IDE auto-discovery:
+        //   biome.template.json → biome.json
+        //   _tsconfig.json      → tsconfig.json
+        relPath = relPath.replace(/\.template\.json$/, '.json');
+        relPath = relPath.replace(/(^|\/)_([^/]+)$/, '$1$2');
+        const destPath = join(dest, relPath);
+        if (existsSync(destPath)) {
+            skipped.push(relPath);
+            continue;
+        }
+        if (!dryRun) {
+            mkdirSync(dirname(destPath), { recursive: true });
+            if (basename(srcPath) === 'package.json' && name) {
+                const content = readFileSync(srcPath, 'utf-8').replace(/\{\{PACKAGE_NAME\}\}/g, name);
+                writeFileSync(destPath, content);
+            }
+            else {
+                cpSync(srcPath, destPath);
+            }
+        }
+        created.push(relPath);
+    }
+}
+// ── Skill copying ─────────────────────────────────────────────────────
+function copyExternalSkills(dest, dryRun, created, skipped) {
+    if (!existsSync(SKILLS_DIR))
+        return;
+    const skillDirs = readdirSync(SKILLS_DIR, { withFileTypes: true }).filter((d) => d.isDirectory());
+    for (const dir of skillDirs) {
+        const skillMdPath = join(SKILLS_DIR, dir.name, 'SKILL.md');
+        if (!existsSync(skillMdPath))
+            continue;
+        const audience = extractAudience(readFileSync(skillMdPath, 'utf-8'));
+        if (audience !== 'external')
+            continue;
+        const skillFiles = walkDir(join(SKILLS_DIR, dir.name));
+        for (const srcPath of skillFiles) {
+            const relPath = join('skills', dir.name, relative(join(SKILLS_DIR, dir.name), srcPath));
+            const destPath = join(dest, relPath);
+            if (existsSync(destPath)) {
+                skipped.push(relPath);
+                continue;
+            }
+            if (!dryRun) {
+                mkdirSync(dirname(destPath), { recursive: true });
+                cpSync(srcPath, destPath);
+            }
+            created.push(relPath);
+        }
+    }
+}
+/**
+ * Extract `metadata.audience` from SKILL.md YAML frontmatter.
+ * Simple regex — avoids needing a YAML parser for a single field read.
+ */
+function extractAudience(content) {
+    const frontmatter = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!frontmatter?.[1])
+        return;
+    return frontmatter[1].match(/audience:\s*(\w+)/)?.[1];
+}
+// ── Utilities ─────────────────────────────────────────────────────────
+/** Recursively walk a directory, returning all file paths (no directories). */
+function walkDir(dir) {
+    const results = [];
+    if (!existsSync(dir))
+        return results;
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.name === '.DS_Store')
+            continue;
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...walkDir(full));
+        }
+        else {
+            results.push(full);
+        }
+    }
+    return results;
+}
+function printSummary(created, skipped, dryRun, name) {
+    const prefix = dryRun ? '(dry run) ' : '';
+    if (created.length > 0) {
+        console.log(`  ${prefix}Created:`);
+        for (const f of created) {
+            console.log(`    + ${f}`);
+        }
+    }
+    if (skipped.length > 0) {
+        console.log(`\n  ${prefix}Skipped (already exist):`);
+        for (const f of skipped) {
+            console.log(`    - ${f}`);
+        }
+    }
+    console.log(`\n  ${created.length} created, ${skipped.length} skipped`);
+    if (!dryRun && created.length > 0) {
+        console.log(`
+  Next steps:
+    ${name ? '' : '1. Update package.json name\n    '}${name ? '1' : '2'}. bun install
+    ${name ? '2' : '3'}. Open the project in your editor — your agent will read CLAUDE.md
+`);
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

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