@daniel.stefan/metalink 1.3.1

package/packages/core/dist/server/metrics.d.ts

@@ -0,0 +1,134 @@
+/**
+ * v1.2.0: Metrics System
+ * Comprehensive telemetry tracking for tool calls, API requests, and server performance
+ */
+export interface ToolCallMetric {
+    timestamp: number;
+    serverName: string;
+    toolName: string;
+    durationMs: number;
+    isError: boolean;
+    clientType?: string;
+    sessionId?: string;
+}
+export interface ApiCallMetric {
+    timestamp: number;
+    method: string;
+    path: string;
+    durationMs: number;
+    statusCode: number;
+    clientType?: string;
+}
+export interface ServerStartMetric {
+    timestamp: number;
+    serverName: string;
+    durationMs: number;
+    success: boolean;
+}
+export interface InstantMetrics {
+    timestamp: number;
+    totalToolCalls: number;
+    totalApiCalls: number;
+    totalErrors: number;
+    avgToolDurationMs: number;
+    topTools: Array<{
+        name: string;
+        count: number;
+    }>;
+    topServers: Array<{
+        name: string;
+        count: number;
+    }>;
+    topClients: Array<{
+        type: string;
+        count: number;
+    }>;
+}
+export interface HourlyStats {
+    hour: string;
+    toolCallCount: number;
+    errorCount: number;
+    avgDurationMs: number;
+    topTools: Array<{
+        name: string;
+        count: number;
+    }>;
+}
+export interface DailyStats {
+    date: string;
+    toolCallCount: number;
+    errorCount: number;
+    avgDurationMs: number;
+    topTools: Array<{
+        name: string;
+        count: number;
+    }>;
+    topServers: Array<{
+        name: string;
+        count: number;
+    }>;
+}
+/**
+ * Global metrics collector with in-memory storage
+ * Async background writes to disk (non-blocking)
+ */
+export declare class GlobalMetrics {
+    private toolCalls;
+    private apiCalls;
+    private serverStarts;
+    private maxMemoryMetrics;
+    private writeQueue;
+    /**
+     * Record a tool call metric
+     */
+    recordToolCall(serverName: string, toolName: string, durationMs: number, isError?: boolean, clientType?: string, sessionId?: string): void;
+    /**
+     * Record an API call metric
+     */
+    recordApiCall(method: string, path: string, durationMs: number, statusCode: number, clientType?: string): void;
+    /**
+     * Record a server start metric
+     */
+    recordServerStart(serverName: string, durationMs: number, success?: boolean): void;
+    /**
+     * Get instant metrics (current state)
+     */
+    getInstantMetrics(): InstantMetrics;
+    /**
+     * Get hourly aggregated metrics
+     */
+    getHourlyMetrics(hoursBack?: number): HourlyStats[];
+    /**
+     * Get daily aggregated metrics
+     */
+    getDailyMetrics(daysBack?: number): DailyStats[];
+    /**
+     * Export metrics in Prometheus format
+     */
+    exportPrometheus(): string;
+    /**
+     * Get metrics statistics for debugging
+     */
+    getStats(): {
+        toolCallsInMemory: number;
+        apiCallsInMemory: number;
+        serverStartsInMemory: number;
+    };
+    /**
+     * Queue an async write to disk (non-blocking)
+     */
+    private queueMetricsWrite;
+    /**
+     * Flush pending writes (call before shutdown)
+     */
+    flush(): Promise<void>;
+    /**
+     * Clear all metrics
+     */
+    clear(): void;
+}
+/**
+ * Global metrics instance (singleton)
+ */
+export declare const globalMetrics: GlobalMetrics;
+//# sourceMappingURL=metrics.d.ts.map

package/packages/core/dist/server/metrics.d.ts.map

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

package/packages/core/dist/server/metrics.js

@@ -0,0 +1,273 @@
+/**
+ * v1.2.0: Metrics System
+ * Comprehensive telemetry tracking for tool calls, API requests, and server performance
+ */
+/**
+ * Global metrics collector with in-memory storage
+ * Async background writes to disk (non-blocking)
+ */
+export class GlobalMetrics {
+    constructor() {
+        this.toolCalls = [];
+        this.apiCalls = [];
+        this.serverStarts = [];
+        this.maxMemoryMetrics = 1000; // Keep last 1000 metrics in memory
+        this.writeQueue = Promise.resolve();
+    }
+    /**
+     * Record a tool call metric
+     */
+    recordToolCall(serverName, toolName, durationMs, isError = false, clientType, sessionId) {
+        const metric = {
+            timestamp: Date.now(),
+            serverName,
+            toolName,
+            durationMs,
+            isError,
+            clientType,
+            sessionId
+        };
+        this.toolCalls.push(metric);
+        // Keep memory bounded
+        if (this.toolCalls.length > this.maxMemoryMetrics) {
+            this.toolCalls = this.toolCalls.slice(-this.maxMemoryMetrics);
+        }
+        // Queue async write (don't wait)
+        this.queueMetricsWrite();
+    }
+    /**
+     * Record an API call metric
+     */
+    recordApiCall(method, path, durationMs, statusCode, clientType) {
+        const metric = {
+            timestamp: Date.now(),
+            method,
+            path,
+            durationMs,
+            statusCode,
+            clientType
+        };
+        this.apiCalls.push(metric);
+        if (this.apiCalls.length > this.maxMemoryMetrics) {
+            this.apiCalls = this.apiCalls.slice(-this.maxMemoryMetrics);
+        }
+        this.queueMetricsWrite();
+    }
+    /**
+     * Record a server start metric
+     */
+    recordServerStart(serverName, durationMs, success = true) {
+        const metric = {
+            timestamp: Date.now(),
+            serverName,
+            durationMs,
+            success
+        };
+        this.serverStarts.push(metric);
+        if (this.serverStarts.length > this.maxMemoryMetrics) {
+            this.serverStarts = this.serverStarts.slice(-this.maxMemoryMetrics);
+        }
+        this.queueMetricsWrite();
+    }
+    /**
+     * Get instant metrics (current state)
+     */
+    getInstantMetrics() {
+        const toolCallsByName = new Map();
+        const serversByName = new Map();
+        const clientsByType = new Map();
+        let totalErrors = 0;
+        let totalDuration = 0;
+        for (const call of this.toolCalls) {
+            const key = `${call.serverName}-${call.toolName}`;
+            toolCallsByName.set(key, (toolCallsByName.get(key) || 0) + 1);
+            serversByName.set(call.serverName, (serversByName.get(call.serverName) || 0) + 1);
+            if (call.clientType) {
+                clientsByType.set(call.clientType, (clientsByType.get(call.clientType) || 0) + 1);
+            }
+            if (call.isError)
+                totalErrors++;
+            totalDuration += call.durationMs;
+        }
+        const sortByCount = (map, limit = 5) => {
+            return Array.from(map.entries())
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, limit)
+                .map(([name, count]) => ({ name, count }));
+        };
+        const topClientsArray = Array.from(clientsByType.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 5)
+            .map(([type, count]) => ({ type, count }));
+        return {
+            timestamp: Date.now(),
+            totalToolCalls: this.toolCalls.length,
+            totalApiCalls: this.apiCalls.length,
+            totalErrors,
+            avgToolDurationMs: this.toolCalls.length > 0 ? totalDuration / this.toolCalls.length : 0,
+            topTools: sortByCount(toolCallsByName),
+            topServers: sortByCount(serversByName),
+            topClients: topClientsArray
+        };
+    }
+    /**
+     * Get hourly aggregated metrics
+     */
+    getHourlyMetrics(hoursBack = 24) {
+        const now = Date.now();
+        const hourMs = 60 * 60 * 1000;
+        const hourly = new Map();
+        // Group calls by hour
+        for (const call of this.toolCalls) {
+            const age = now - call.timestamp;
+            if (age > hoursBack * hourMs)
+                continue;
+            const hourStart = Math.floor(call.timestamp / hourMs) * hourMs;
+            const hourKey = new Date(hourStart).toISOString();
+            if (!hourly.has(hourKey)) {
+                hourly.set(hourKey, { calls: [] });
+            }
+            hourly.get(hourKey).calls.push(call);
+        }
+        // Aggregate
+        return Array.from(hourly.entries())
+            .map(([hour, data]) => {
+            const toolsByName = new Map();
+            let totalErrors = 0;
+            let totalDuration = 0;
+            for (const call of data.calls) {
+                const key = `${call.serverName}-${call.toolName}`;
+                toolsByName.set(key, (toolsByName.get(key) || 0) + 1);
+                if (call.isError)
+                    totalErrors++;
+                totalDuration += call.durationMs;
+            }
+            return {
+                hour,
+                toolCallCount: data.calls.length,
+                errorCount: totalErrors,
+                avgDurationMs: data.calls.length > 0 ? totalDuration / data.calls.length : 0,
+                topTools: Array.from(toolsByName.entries())
+                    .sort((a, b) => b[1] - a[1])
+                    .slice(0, 5)
+                    .map(([name, count]) => ({ name, count }))
+            };
+        })
+            .sort((a, b) => a.hour.localeCompare(b.hour));
+    }
+    /**
+     * Get daily aggregated metrics
+     */
+    getDailyMetrics(daysBack = 7) {
+        const now = Date.now();
+        const dayMs = 24 * 60 * 60 * 1000;
+        const daily = new Map();
+        // Group calls by day
+        for (const call of this.toolCalls) {
+            const age = now - call.timestamp;
+            if (age > daysBack * dayMs)
+                continue;
+            const dayStart = Math.floor(call.timestamp / dayMs) * dayMs;
+            const dayKey = new Date(dayStart).toISOString().split('T')[0];
+            if (!daily.has(dayKey)) {
+                daily.set(dayKey, { calls: [] });
+            }
+            daily.get(dayKey).calls.push(call);
+        }
+        // Aggregate
+        return Array.from(daily.entries())
+            .map(([date, data]) => {
+            const toolsByName = new Map();
+            const serversByName = new Map();
+            let totalErrors = 0;
+            let totalDuration = 0;
+            for (const call of data.calls) {
+                const toolKey = `${call.serverName}-${call.toolName}`;
+                toolsByName.set(toolKey, (toolsByName.get(toolKey) || 0) + 1);
+                serversByName.set(call.serverName, (serversByName.get(call.serverName) || 0) + 1);
+                if (call.isError)
+                    totalErrors++;
+                totalDuration += call.durationMs;
+            }
+            return {
+                date,
+                toolCallCount: data.calls.length,
+                errorCount: totalErrors,
+                avgDurationMs: data.calls.length > 0 ? totalDuration / data.calls.length : 0,
+                topTools: Array.from(toolsByName.entries())
+                    .sort((a, b) => b[1] - a[1])
+                    .slice(0, 5)
+                    .map(([name, count]) => ({ name, count })),
+                topServers: Array.from(serversByName.entries())
+                    .sort((a, b) => b[1] - a[1])
+                    .slice(0, 5)
+                    .map(([name, count]) => ({ name, count }))
+            };
+        })
+            .sort((a, b) => a.date.localeCompare(b.date));
+    }
+    /**
+     * Export metrics in Prometheus format
+     */
+    exportPrometheus() {
+        const instant = this.getInstantMetrics();
+        const lines = [];
+        lines.push('# HELP metalink_tool_calls_total Total number of tool calls');
+        lines.push('# TYPE metalink_tool_calls_total counter');
+        lines.push(`metalink_tool_calls_total ${instant.totalToolCalls}`);
+        lines.push('# HELP metalink_tool_errors_total Total number of tool errors');
+        lines.push('# TYPE metalink_tool_errors_total counter');
+        lines.push(`metalink_tool_errors_total ${instant.totalErrors}`);
+        lines.push('# HELP metalink_tool_duration_ms_avg Average tool execution duration');
+        lines.push('# TYPE metalink_tool_duration_ms_avg gauge');
+        lines.push(`metalink_tool_duration_ms_avg ${instant.avgToolDurationMs}`);
+        lines.push('# HELP metalink_api_calls_total Total number of API calls');
+        lines.push('# TYPE metalink_api_calls_total counter');
+        lines.push(`metalink_api_calls_total ${instant.totalApiCalls}`);
+        for (const { name, count } of instant.topTools) {
+            lines.push(`metalink_tool_calls{tool="${name}"} ${count}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Get metrics statistics for debugging
+     */
+    getStats() {
+        return {
+            toolCallsInMemory: this.toolCalls.length,
+            apiCallsInMemory: this.apiCalls.length,
+            serverStartsInMemory: this.serverStarts.length
+        };
+    }
+    /**
+     * Queue an async write to disk (non-blocking)
+     */
+    queueMetricsWrite() {
+        // In a real implementation, this would write to SQLite/disk
+        // For now, we keep metrics in memory with bounded size
+        // This is acceptable for v1.2.0 as persistence is optional
+        this.writeQueue = this.writeQueue.then(() => {
+            // Async write would happen here
+            // await metricsStore.saveBatch(this.toolCalls, this.apiCalls);
+        });
+    }
+    /**
+     * Flush pending writes (call before shutdown)
+     */
+    async flush() {
+        await this.writeQueue;
+    }
+    /**
+     * Clear all metrics
+     */
+    clear() {
+        this.toolCalls = [];
+        this.apiCalls = [];
+        this.serverStarts = [];
+    }
+}
+/**
+ * Global metrics instance (singleton)
+ */
+export const globalMetrics = new GlobalMetrics();
+//# sourceMappingURL=metrics.js.map

package/packages/core/dist/server/metrics.js.map

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

package/packages/core/dist/server/prompts.d.ts

@@ -0,0 +1,58 @@
+/**
+ * MCP Prompts Module
+ *
+ * Provides built-in educational prompts for the Metalink 4-tool Speakeasy pattern.
+ * Implements MCP protocol prompts/list and prompts/get endpoints.
+ *
+ * v1.3.x: Consolidated to 2 documentation prompts (guide, safety).
+ * Executable skills are now provided via Claude Code user commands.
+ */
+/**
+ * Prompt definition structure for prompts/list response
+ */
+interface PromptDefinition {
+    /** Unique prompt identifier */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Required and optional arguments */
+    arguments?: Array<{
+        name: string;
+        description: string;
+        required: boolean;
+    }>;
+}
+/**
+ * Message structure per MCP spec
+ */
+interface PromptMessage {
+    role: 'user' | 'assistant';
+    content: {
+        type: 'text';
+        text: string;
+    };
+}
+/**
+ * Complete prompt response for prompts/get
+ */
+interface PromptResponse {
+    description?: string;
+    messages: PromptMessage[];
+}
+/**
+ * Get list of all available prompts
+ *
+ * @returns Array of prompt definitions for prompts/list response
+ */
+export declare function getPromptsList(): PromptDefinition[];
+/**
+ * Get a specific prompt with arguments resolved
+ *
+ * @param name - Prompt identifier
+ * @param args - Argument key-value pairs
+ * @returns Rendered prompt with messages
+ * @throws Error if prompt not found or required arguments missing
+ */
+export declare function getPrompt(name: string, args?: Record<string, string>): PromptResponse;
+export {};
+//# sourceMappingURL=prompts.d.ts.map

package/packages/core/dist/server/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/server/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,UAAU,gBAAgB;IACxB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;GAEG;AACH,UAAU,cAAc;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AA2WD;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,gBAAgB,EAAE,CAEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,cAAc,CAuBzF"}