@nanogpt/mcp 1.0.0

package/dist/index.js

@@ -0,0 +1,168 @@
+#!/usr/bin/env node
+/**
+ * NanoGPT MCP Server
+ *
+ * An MCP server that provides access to NanoGPT's API capabilities:
+ * - Chat completion
+ * - Image generation
+ * - Web search
+ * - URL scraping
+ * - YouTube transcription
+ * - Model listing
+ *
+ * Uses stdio transport for communication with MCP clients.
+ *
+ * Pinned MCP SDK version: @modelcontextprotocol/sdk@^1.23.0
+ */
+import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { loadConfig, log } from './config.js';
+import { read, clearCache } from './resources.js';
+import { abortAllRequests, getActiveRequestCount } from './activeRequests.js';
+import { balance, chat, imageGenerate, webSearch, scrapeUrls, youtubeTranscribe, listTextModels, listImageModels, listAudioModels, listVideoModels, } from './tools/index.js';
+/**
+ * Main entry point
+ */
+async function main() {
+    // Load and validate configuration
+    const config = loadConfig();
+    log('info', 'NanoGPT MCP server starting', { baseUrl: config.baseUrl });
+    // Create MCP server
+    const server = new McpServer({
+        name: 'nanogpt-mcp',
+        version: '1.0.0',
+    });
+    // Register tools
+    registerTools(server);
+    // Register resource handlers
+    registerResources(server);
+    // Setup graceful shutdown
+    setupShutdown();
+    // Connect via stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    log('info', 'NanoGPT MCP server connected and ready');
+}
+/**
+ * Register all tools with the MCP server
+ */
+function registerTools(server) {
+    const tools = [
+        balance,
+        chat,
+        imageGenerate,
+        webSearch,
+        scrapeUrls,
+        youtubeTranscribe,
+        listTextModels,
+        listImageModels,
+        listAudioModels,
+        listVideoModels,
+    ];
+    for (const tool of tools) {
+        server.registerTool(tool.name, {
+            description: tool.description,
+            // MCP SDK v1.23+ accepts Zod schemas and converts to JSON Schema internally
+            inputSchema: tool.inputSchema,
+        }, tool.handler);
+    }
+    log('info', `Registered ${tools.length} tools`);
+}
+/**
+ * Register resource handlers for reading stored resources
+ */
+function registerResources(server) {
+    // Resource template for raw JSON responses
+    const rawTemplate = new ResourceTemplate('nanogpt://raw/{id}', { list: undefined });
+    server.registerResource('nanogpt-raw', rawTemplate, {
+        description: 'Raw JSON response from NanoGPT API',
+        mimeType: 'application/json',
+    }, async (uri, _variables) => {
+        const uriString = uri.toString();
+        const result = read(uriString);
+        if (!result || !result.text) {
+            return {
+                contents: [
+                    {
+                        uri: uriString,
+                        mimeType: 'text/plain',
+                        text: `Resource not found (may have been evicted): ${uriString}`,
+                    },
+                ],
+            };
+        }
+        return {
+            contents: [
+                {
+                    uri: uriString,
+                    mimeType: result.mimeType,
+                    text: result.text,
+                },
+            ],
+        };
+    });
+    // Resource template for stored images
+    const imageTemplate = new ResourceTemplate('nanogpt://image/{id}', { list: undefined });
+    server.registerResource('nanogpt-image', imageTemplate, {
+        description: 'Image generated by NanoGPT',
+        mimeType: 'image/*',
+    }, async (uri, _variables) => {
+        const uriString = uri.toString();
+        const result = read(uriString);
+        if (!result || !result.blob) {
+            return {
+                contents: [
+                    {
+                        uri: uriString,
+                        mimeType: 'text/plain',
+                        text: `Resource not found (may have been evicted): ${uriString}`,
+                    },
+                ],
+            };
+        }
+        return {
+            contents: [
+                {
+                    uri: uriString,
+                    mimeType: result.mimeType,
+                    blob: result.blob,
+                },
+            ],
+        };
+    });
+    log('info', 'Registered resource handlers for nanogpt://raw/* and nanogpt://image/*');
+}
+/**
+ * Setup graceful shutdown handlers
+ */
+function setupShutdown() {
+    const shutdown = async (signal) => {
+        const activeCount = getActiveRequestCount();
+        log('info', `Received ${signal}, shutting down...`, { activeRequests: activeCount });
+        // Abort all active HTTP requests
+        abortAllRequests();
+        // Clear resource cache
+        clearCache();
+        log('info', 'Shutdown complete');
+        process.exit(0);
+    };
+    process.on('SIGINT', () => shutdown('SIGINT'));
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+    // Handle uncaught errors
+    process.on('uncaughtException', (err) => {
+        log('error', 'Uncaught exception', { error: err.message });
+        process.exit(1);
+    });
+    process.on('unhandledRejection', (reason) => {
+        log('error', 'Unhandled rejection', {
+            error: reason instanceof Error ? reason.message : String(reason),
+        });
+        process.exit(1);
+    });
+}
+// Run the server
+main().catch((err) => {
+    console.error('Fatal error:', err);
+    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/resources.d.ts

@@ -0,0 +1,68 @@
+/**
+ * In-memory LRU resource cache for NanoGPT MCP server
+ *
+ * Stores large payloads (images, raw JSON) that are too big to inline.
+ * Resources are ephemeral and will be evicted when the cache is full.
+ */
+export type ResourceType = 'raw' | 'image';
+/**
+ * Generate a resource URI
+ */
+export declare function makeUri(type: ResourceType, id: string): string;
+/**
+ * Parse a resource URI
+ */
+export declare function parseUri(uri: string): {
+    type: ResourceType;
+    id: string;
+} | null;
+/**
+ * Store raw text/JSON as a resource
+ */
+export declare function putRawText(text: string, mimeType?: string): {
+    uri: string;
+    bytes: number;
+} | null;
+/**
+ * Store binary data (image) as a resource
+ */
+export declare function putBlob(buffer: Buffer, mimeType: string): {
+    uri: string;
+    bytes: number;
+} | null;
+/**
+ * Store base64-encoded image data
+ */
+export declare function putBase64Image(base64: string, mimeType: string): {
+    uri: string;
+    bytes: number;
+} | null;
+export interface ResourceReadResult {
+    mimeType: string;
+    text?: string;
+    blob?: string;
+}
+/**
+ * Read a resource by URI
+ */
+export declare function read(uri: string): ResourceReadResult | null;
+/**
+ * List all cached resources (for resources/list)
+ */
+export declare function listResources(): Array<{
+    uri: string;
+    name: string;
+    mimeType: string;
+}>;
+/**
+ * Clear all cached resources (for graceful shutdown)
+ */
+export declare function clearCache(): void;
+/**
+ * Get cache statistics (for debugging)
+ */
+export declare function getCacheStats(): {
+    count: number;
+    totalBytes: number;
+};
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,OAAO,CAAC;AAe3C;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAO/E;AAwBD;;GAEG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAA2B,GACpC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA6BvC;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiC/F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAgCvC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAqB3D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAYtF;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CASrE"}

package/dist/resources.js

@@ -0,0 +1,198 @@
+/**
+ * In-memory LRU resource cache for NanoGPT MCP server
+ *
+ * Stores large payloads (images, raw JSON) that are too big to inline.
+ * Resources are ephemeral and will be evicted when the cache is full.
+ */
+import { randomUUID } from 'crypto';
+import { getConfig } from './config.js';
+// In-memory LRU cache
+const cache = new Map();
+const accessOrder = [];
+/**
+ * Generate a resource URI
+ */
+export function makeUri(type, id) {
+    return `nanogpt://${type}/${id}`;
+}
+/**
+ * Parse a resource URI
+ */
+export function parseUri(uri) {
+    const match = uri.match(/^nanogpt:\/\/(raw|image)\/([a-f0-9-]+)$/);
+    if (!match)
+        return null;
+    return {
+        type: match[1],
+        id: match[2],
+    };
+}
+/**
+ * Update access order for LRU eviction
+ */
+function updateAccessOrder(id) {
+    const index = accessOrder.indexOf(id);
+    if (index > -1) {
+        accessOrder.splice(index, 1);
+    }
+    accessOrder.push(id);
+}
+/**
+ * Evict oldest entries if cache is full
+ */
+function evictIfNeeded() {
+    const config = getConfig();
+    while (cache.size >= config.maxResourceCacheItems && accessOrder.length > 0) {
+        const oldestId = accessOrder.shift();
+        cache.delete(oldestId);
+    }
+}
+/**
+ * Store raw text/JSON as a resource
+ */
+export function putRawText(text, mimeType = 'application/json') {
+    const config = getConfig();
+    const bytes = Buffer.byteLength(text, 'utf-8');
+    // Check size limit
+    if (bytes > config.maxResourceBytes) {
+        return null;
+    }
+    // Evict if needed
+    evictIfNeeded();
+    const id = randomUUID();
+    const entry = {
+        id,
+        type: 'raw',
+        mimeType,
+        data: text,
+        bytes,
+        createdAt: Date.now(),
+    };
+    cache.set(id, entry);
+    updateAccessOrder(id);
+    return {
+        uri: makeUri('raw', id),
+        bytes,
+    };
+}
+/**
+ * Store binary data (image) as a resource
+ */
+export function putBlob(buffer, mimeType) {
+    const config = getConfig();
+    // Convert to base64 first, then check size limit against actual stored size
+    // (base64 encoding expands data by ~33%)
+    const base64Data = buffer.toString('base64');
+    const storedBytes = base64Data.length;
+    // Check size limit against actual stored size
+    if (storedBytes > config.maxResourceBytes) {
+        return null;
+    }
+    // Evict if needed
+    evictIfNeeded();
+    const id = randomUUID();
+    const entry = {
+        id,
+        type: 'image',
+        mimeType,
+        data: base64Data,
+        bytes: storedBytes,
+        createdAt: Date.now(),
+    };
+    cache.set(id, entry);
+    updateAccessOrder(id);
+    return {
+        uri: makeUri('image', id),
+        bytes: storedBytes,
+    };
+}
+/**
+ * Store base64-encoded image data
+ */
+export function putBase64Image(base64, mimeType) {
+    const config = getConfig();
+    // Remove data URL prefix if present
+    const cleanBase64 = base64.replace(/^data:[^,]+,/, '');
+    const bytes = cleanBase64.length; // Track actual stored string size
+    // Check size limit
+    if (bytes > config.maxResourceBytes) {
+        return null;
+    }
+    // Evict if needed
+    evictIfNeeded();
+    const id = randomUUID();
+    const entry = {
+        id,
+        type: 'image',
+        mimeType,
+        data: cleanBase64,
+        bytes,
+        createdAt: Date.now(),
+    };
+    cache.set(id, entry);
+    updateAccessOrder(id);
+    return {
+        uri: makeUri('image', id),
+        bytes,
+    };
+}
+/**
+ * Read a resource by URI
+ */
+export function read(uri) {
+    const parsed = parseUri(uri);
+    if (!parsed)
+        return null;
+    const entry = cache.get(parsed.id);
+    if (!entry)
+        return null;
+    // Update access order
+    updateAccessOrder(parsed.id);
+    if (entry.type === 'raw') {
+        return {
+            mimeType: entry.mimeType,
+            text: entry.data,
+        };
+    }
+    else {
+        return {
+            mimeType: entry.mimeType,
+            blob: entry.data,
+        };
+    }
+}
+/**
+ * List all cached resources (for resources/list)
+ */
+export function listResources() {
+    const result = [];
+    for (const [id, entry] of cache.entries()) {
+        result.push({
+            uri: makeUri(entry.type, id),
+            name: entry.type === 'raw' ? 'Raw response' : 'Generated image',
+            mimeType: entry.mimeType,
+        });
+    }
+    return result;
+}
+/**
+ * Clear all cached resources (for graceful shutdown)
+ */
+export function clearCache() {
+    cache.clear();
+    accessOrder.length = 0;
+}
+/**
+ * Get cache statistics (for debugging)
+ */
+export function getCacheStats() {
+    let totalBytes = 0;
+    for (const entry of cache.values()) {
+        totalBytes += entry.bytes;
+    }
+    return {
+        count: cache.size,
+        totalBytes,
+    };
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAaxC,sBAAsB;AACtB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;AAC/C,MAAM,WAAW,GAAa,EAAE,CAAC;AAEjC;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,IAAkB,EAAE,EAAU;IACpD,OAAO,aAAa,IAAI,IAAI,EAAE,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACnE,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,CAAC,CAAiB;QAC9B,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;KACb,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,EAAU;IACnC,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACtC,IAAI,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;QACf,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,SAAS,aAAa;IACpB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,OAAO,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,qBAAqB,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5E,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,EAAG,CAAC;QACtC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,WAAmB,kBAAkB;IAErC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE/C,mBAAmB;IACnB,IAAI,KAAK,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kBAAkB;IAClB,aAAa,EAAE,CAAC;IAEhB,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACxB,MAAM,KAAK,GAAkB;QAC3B,EAAE;QACF,IAAI,EAAE,KAAK;QACX,QAAQ;QACR,IAAI,EAAE,IAAI;QACV,KAAK;QACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;IAEF,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,CAAC;IAEtB,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QACvB,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,MAAc,EAAE,QAAgB;IACtD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,4EAA4E;IAC5E,yCAAyC;IACzC,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC;IAEtC,8CAA8C;IAC9C,IAAI,WAAW,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kBAAkB;IAClB,aAAa,EAAE,CAAC;IAEhB,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACxB,MAAM,KAAK,GAAkB;QAC3B,EAAE;QACF,IAAI,EAAE,OAAO;QACb,QAAQ;QACR,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,WAAW;QAClB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;IAEF,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,CAAC;IAEtB,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACzB,KAAK,EAAE,WAAW;KACnB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,QAAgB;IAEhB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,oCAAoC;IACpC,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,kCAAkC;IAEpE,mBAAmB;IACnB,IAAI,KAAK,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kBAAkB;IAClB,aAAa,EAAE,CAAC;IAEhB,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACxB,MAAM,KAAK,GAAkB;QAC3B,EAAE;QACF,IAAI,EAAE,OAAO;QACb,QAAQ;QACR,IAAI,EAAE,WAAW;QACjB,KAAK;QACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;IAEF,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,CAAC;IAEtB,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACzB,KAAK;KACN,CAAC;AACJ,CAAC;AAQD;;GAEG;AACH,MAAM,UAAU,IAAI,CAAC,GAAW;IAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,sBAAsB;IACtB,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAE7B,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACzB,OAAO;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,MAAM,GAA2D,EAAE,CAAC;IAE1E,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC;YACV,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAC5B,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,iBAAiB;YAC/D,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QACnC,UAAU,IAAI,KAAK,CAAC,KAAK,CAAC;IAC5B,CAAC;IACD,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,IAAI;QACjB,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/toolUtils.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Common utilities for tool handlers
+ *
+ * WARNING: The zodTypeToJsonSchema function accesses Zod internal structures (_def)
+ * which are not part of Zod's public API and may break with Zod updates.
+ * Consider switching to a maintained converter like 'zod-to-json-schema' package
+ * for production use with full Zod type coverage.
+ */
+import { z, type ZodTypeAny } from 'zod';
+import { McpError } from '@modelcontextprotocol/sdk/types.js';
+import { type HttpError } from './httpClient.js';
+export interface ResourceLink {
+    type: 'resource_link';
+    uri: string;
+    name: string;
+    mimeType: string;
+}
+export interface TextContent {
+    type: 'text';
+    text: string;
+}
+export type ContentItem = TextContent | ResourceLink;
+/**
+ * Map HTTP error to MCP error
+ */
+export declare function httpErrorToMcpError(err: HttpError): McpError;
+/**
+ * Handle errors in tool handlers.
+ *
+ * This function ALWAYS throws and never returns (return type: never).
+ * Use as: `return handleToolError(err)` in catch blocks to make control flow
+ * explicit and satisfy TypeScript's type checker.
+ */
+export declare function handleToolError(err: unknown): never;
+export interface RawResponse {
+    status: number;
+    headers?: Record<string, string>;
+    body?: unknown;
+}
+/** Error returned when raw response cannot be stored */
+export interface RawResponseError {
+    error: string;
+}
+/**
+ * Union type for the 'raw' field in processRawResponse result.
+ * - RawResponse: The full response object (when small enough to inline)
+ * - string: A URI reference to the stored resource (when stored successfully)
+ * - RawResponseError: An error object (when storage fails)
+ */
+export type ProcessedRawValue = RawResponse | string | RawResponseError;
+/** Result type for processRawResponse */
+export interface ProcessRawResponseResult {
+    /** The raw response - can be inline object, URI string, or error */
+    raw?: ProcessedRawValue;
+    /** Resource link if response was stored as a resource */
+    resourceLink?: ResourceLink;
+}
+/**
+ * Type guard to check if raw value is an error
+ */
+export declare function isRawResponseError(value: ProcessedRawValue): value is RawResponseError;
+/**
+ * Type guard to check if raw value is a URI string
+ */
+export declare function isRawResponseUri(value: ProcessedRawValue): value is string;
+/**
+ * Type guard to check if raw value is an inline RawResponse
+ */
+export declare function isRawResponseInline(value: ProcessedRawValue): value is RawResponse;
+/**
+ * Process raw response - inline if small, store as resource if large
+ *
+ * @returns Object with:
+ *   - raw: Either the inline RawResponse, a URI string to stored resource, or an error object
+ *   - resourceLink: Present only when response was stored as a resource
+ */
+export declare function processRawResponse(response: RawResponse, includeRaw?: boolean): ProcessRawResponseResult;
+/**
+ * Build content array with text and optional resource link
+ */
+export declare function buildContent(text: string, resourceLink?: ResourceLink): ContentItem[];
+/**
+ * Common input schema for include_raw parameter
+ */
+export declare const includeRawSchema: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+export interface JsonSchema {
+    type?: string | string[];
+    properties?: Record<string, JsonSchema>;
+    items?: JsonSchema;
+    required?: string[];
+    additionalProperties?: boolean;
+    enum?: unknown[];
+    const?: unknown;
+    oneOf?: JsonSchema[];
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    minItems?: number;
+    maxItems?: number;
+}
+/**
+ * Zod to JSON Schema converter (simplified)
+ *
+ * WARNING: This function accesses Zod internal structures (_def) which are not
+ * part of Zod's public API. This implementation:
+ * - May break with future Zod versions
+ * - Does not support all Zod types (see UNSUPPORTED_ZOD_TYPES)
+ * - Uses defensive checks but may still fail on edge cases
+ *
+ * For production use with full Zod type coverage, consider using the
+ * 'zod-to-json-schema' package instead.
+ */
+export declare function zodToJsonSchema(schema: ZodTypeAny): JsonSchema;
+//# sourceMappingURL=toolUtils.d.ts.map

package/dist/toolUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolUtils.d.ts","sourceRoot":"","sources":["../src/toolUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,KAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAa,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAmC,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIlF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,eAAe,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC;AAErD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,GAAG,QAAQ,CAwB5D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAmBnD;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,MAAM,GAAG,gBAAgB,CAAC;AAExE,yCAAyC;AACzC,MAAM,WAAW,wBAAwB;IACvC,oEAAoE;IACpE,GAAG,CAAC,EAAE,iBAAiB,CAAC;IACxB,yDAAyD;IACzD,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK,IAAI,gBAAgB,CAEtF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK,IAAI,MAAM,CAE1E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK,IAAI,WAAW,CAElF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,WAAW,EACrB,UAAU,CAAC,EAAE,OAAO,GACnB,wBAAwB,CA4B1B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,YAAY,GAAG,WAAW,EAAE,CAMrF;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,2CAAwC,CAAC;AAGtE,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAE9D"}