@pinepaper.studio/mcp-server 1.2.1 → 1.3.0

package/dist/metrics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC"}

package/dist/metrics/index.js

@@ -0,0 +1,8 @@
+/**
+ * Performance Metrics Module
+ *
+ * Provides performance tracking and metrics collection for MCP tool operations.
+ */
+export * from './types.js';
+export * from './performance-tracker.js';
+//# sourceMappingURL=index.js.map

package/dist/metrics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC"}

package/dist/metrics/performance-tracker.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Performance Tracker
+ *
+ * Tracks execution timing metrics for MCP tool operations.
+ * Provides aggregate statistics and export functionality.
+ */
+import { TimingMetric, AggregateStats, MetricsFilter, MetricsExportFormat, MetricsSummary } from './types.js';
+/**
+ * Configuration options for PerformanceTracker
+ */
+export interface PerformanceTrackerConfig {
+    /** Maximum number of metrics to retain in memory (default: 1000) */
+    maxRetention?: number;
+    /** Whether tracking is enabled (default: true) */
+    enabled?: boolean;
+}
+/**
+ * Performance tracking and metrics collection
+ */
+export declare class PerformanceTracker {
+    private metrics;
+    private activeTimers;
+    private maxRetention;
+    private enabled;
+    constructor(config?: PerformanceTrackerConfig);
+    /**
+     * Start a timer with a unique ID
+     */
+    startTimer(id: string): void;
+    /**
+     * End a timer and return elapsed time in milliseconds
+     */
+    endTimer(id: string): number;
+    /**
+     * Record a timing metric
+     */
+    recordMetric(metric: TimingMetric): void;
+    /**
+     * Get metrics matching filter criteria
+     */
+    getMetrics(filter?: MetricsFilter): TimingMetric[];
+    /**
+     * Calculate aggregate statistics for metrics
+     */
+    getAggregateStats(metrics: TimingMetric[]): AggregateStats;
+    /**
+     * Calculate percentile value
+     */
+    private percentile;
+    /**
+     * Get summary metrics for a tool or phase
+     */
+    getSummary(filter?: MetricsFilter): MetricsSummary[];
+    /**
+     * Export metrics in specified format
+     */
+    exportMetrics(format: MetricsExportFormat, filter?: MetricsFilter): string;
+    /**
+     * Export metrics as CSV
+     */
+    private exportCSV;
+    /**
+     * Export summary statistics
+     */
+    private exportSummary;
+    /**
+     * Clear all metrics
+     */
+    clear(): void;
+    /**
+     * Get tracker statistics
+     */
+    getStats(): {
+        totalMetrics: number;
+        activeTimers: number;
+        retention: number;
+        enabled: boolean;
+    };
+    /**
+     * Enable tracking
+     */
+    enable(): void;
+    /**
+     * Disable tracking
+     */
+    disable(): void;
+}
+/**
+ * Get or create the global performance tracker instance
+ */
+export declare function getPerformanceTracker(config?: PerformanceTrackerConfig): PerformanceTracker;
+/**
+ * Reset the global performance tracker (mainly for testing)
+ */
+export declare function resetPerformanceTracker(): void;
+//# sourceMappingURL=performance-tracker.d.ts.map

package/dist/metrics/performance-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-tracker.d.ts","sourceRoot":"","sources":["../../src/metrics/performance-tracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,EAEZ,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAU;gBAEb,MAAM,GAAE,wBAA6B;IAKjD;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK5B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAc5B;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAWxC;;OAEG;IACH,UAAU,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,YAAY,EAAE;IAkClD;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,cAAc;IAgC1D;;OAEG;IACH,OAAO,CAAC,UAAU;IAMlB;;OAEG;IACH,UAAU,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,cAAc,EAAE;IAqCpD;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM;IAkB1E;;OAEG;IACH,OAAO,CAAC,SAAS;IAmBjB;;OAEG;IACH,OAAO,CAAC,aAAa;IA0BrB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,QAAQ,IAAI;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;KAClB;IASD;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB;AAKD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,wBAAwB,GAAG,kBAAkB,CAc3F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/metrics/performance-tracker.js

@@ -0,0 +1,270 @@
+/**
+ * Performance Tracker
+ *
+ * Tracks execution timing metrics for MCP tool operations.
+ * Provides aggregate statistics and export functionality.
+ */
+/**
+ * Performance tracking and metrics collection
+ */
+export class PerformanceTracker {
+    metrics = [];
+    activeTimers = new Map();
+    maxRetention;
+    enabled;
+    constructor(config = {}) {
+        this.maxRetention = config.maxRetention ?? 1000;
+        this.enabled = config.enabled ?? true;
+    }
+    /**
+     * Start a timer with a unique ID
+     */
+    startTimer(id) {
+        if (!this.enabled)
+            return;
+        this.activeTimers.set(id, Date.now());
+    }
+    /**
+     * End a timer and return elapsed time in milliseconds
+     */
+    endTimer(id) {
+        if (!this.enabled)
+            return 0;
+        const startTime = this.activeTimers.get(id);
+        if (!startTime) {
+            console.error(`[PerformanceTracker] Timer '${id}' not found`);
+            return 0;
+        }
+        const duration = Date.now() - startTime;
+        this.activeTimers.delete(id);
+        return duration;
+    }
+    /**
+     * Record a timing metric
+     */
+    recordMetric(metric) {
+        if (!this.enabled)
+            return;
+        this.metrics.push(metric);
+        // Enforce retention limit (LRU eviction)
+        if (this.metrics.length > this.maxRetention) {
+            this.metrics.shift(); // Remove oldest
+        }
+    }
+    /**
+     * Get metrics matching filter criteria
+     */
+    getMetrics(filter) {
+        let results = [...this.metrics];
+        if (!filter)
+            return results;
+        // Apply filters
+        if (filter.toolName) {
+            results = results.filter((m) => m.toolName === filter.toolName);
+        }
+        if (filter.phase) {
+            results = results.filter((m) => m.phase === filter.phase);
+        }
+        if (filter.success !== undefined) {
+            results = results.filter((m) => m.success === filter.success);
+        }
+        if (filter.since) {
+            results = results.filter((m) => m.timestamp >= filter.since);
+        }
+        if (filter.until) {
+            results = results.filter((m) => m.timestamp <= filter.until);
+        }
+        // Apply limit
+        if (filter.limit && filter.limit > 0) {
+            results = results.slice(-filter.limit); // Most recent N
+        }
+        return results;
+    }
+    /**
+     * Calculate aggregate statistics for metrics
+     */
+    getAggregateStats(metrics) {
+        if (metrics.length === 0) {
+            return {
+                count: 0,
+                avgDuration: 0,
+                minDuration: 0,
+                maxDuration: 0,
+                p50: 0,
+                p95: 0,
+                p99: 0,
+                successRate: 0,
+                totalDuration: 0,
+            };
+        }
+        const durations = metrics.map((m) => m.duration).sort((a, b) => a - b);
+        const successCount = metrics.filter((m) => m.success).length;
+        const totalDuration = durations.reduce((sum, d) => sum + d, 0);
+        return {
+            count: metrics.length,
+            avgDuration: totalDuration / metrics.length,
+            minDuration: durations[0],
+            maxDuration: durations[durations.length - 1],
+            p50: this.percentile(durations, 0.5),
+            p95: this.percentile(durations, 0.95),
+            p99: this.percentile(durations, 0.99),
+            successRate: successCount / metrics.length,
+            totalDuration,
+        };
+    }
+    /**
+     * Calculate percentile value
+     */
+    percentile(sortedValues, p) {
+        if (sortedValues.length === 0)
+            return 0;
+        const index = Math.ceil(sortedValues.length * p) - 1;
+        return sortedValues[Math.max(0, index)];
+    }
+    /**
+     * Get summary metrics for a tool or phase
+     */
+    getSummary(filter) {
+        const metrics = this.getMetrics(filter);
+        if (metrics.length === 0) {
+            return [];
+        }
+        // Group by tool name and phase
+        const grouped = new Map();
+        for (const metric of metrics) {
+            const key = `${metric.toolName}:${metric.phase}`;
+            if (!grouped.has(key)) {
+                grouped.set(key, []);
+            }
+            grouped.get(key).push(metric);
+        }
+        // Generate summaries
+        const summaries = [];
+        for (const [key, metricGroup] of grouped.entries()) {
+            const [toolName, phase] = key.split(':');
+            summaries.push({
+                toolName,
+                phase: phase,
+                stats: this.getAggregateStats(metricGroup),
+                recentMetrics: metricGroup.slice(-5), // Last 5 measurements
+            });
+        }
+        // Sort by average duration (slowest first)
+        summaries.sort((a, b) => b.stats.avgDuration - a.stats.avgDuration);
+        return summaries;
+    }
+    /**
+     * Export metrics in specified format
+     */
+    exportMetrics(format, filter) {
+        const metrics = this.getMetrics(filter);
+        switch (format) {
+            case 'json':
+                return JSON.stringify(metrics, null, 2);
+            case 'csv':
+                return this.exportCSV(metrics);
+            case 'summary':
+                return this.exportSummary(filter);
+            default:
+                throw new Error(`Unknown export format: ${format}`);
+        }
+    }
+    /**
+     * Export metrics as CSV
+     */
+    exportCSV(metrics) {
+        const headers = ['timestamp', 'toolName', 'phase', 'duration', 'success', 'error'];
+        const rows = metrics.map((m) => [
+            m.timestamp,
+            m.toolName,
+            m.phase,
+            m.duration,
+            m.success,
+            m.error || '',
+        ]);
+        const csv = [
+            headers.join(','),
+            ...rows.map((row) => row.map((cell) => `"${cell}"`).join(',')),
+        ].join('\n');
+        return csv;
+    }
+    /**
+     * Export summary statistics
+     */
+    exportSummary(filter) {
+        const summaries = this.getSummary(filter);
+        if (summaries.length === 0) {
+            return 'No metrics available';
+        }
+        const lines = ['Performance Metrics Summary', '='.repeat(50), ''];
+        for (const summary of summaries) {
+            const stats = summary.stats;
+            lines.push(`Tool: ${summary.toolName} | Phase: ${summary.phase}`);
+            lines.push(`  Count: ${stats.count}`);
+            lines.push(`  Avg: ${stats.avgDuration.toFixed(2)}ms`);
+            lines.push(`  Min: ${stats.minDuration.toFixed(2)}ms`);
+            lines.push(`  Max: ${stats.maxDuration.toFixed(2)}ms`);
+            lines.push(`  P50: ${stats.p50.toFixed(2)}ms`);
+            lines.push(`  P95: ${stats.p95.toFixed(2)}ms`);
+            lines.push(`  P99: ${stats.p99.toFixed(2)}ms`);
+            lines.push(`  Success Rate: ${(stats.successRate * 100).toFixed(1)}%`);
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Clear all metrics
+     */
+    clear() {
+        this.metrics = [];
+        this.activeTimers.clear();
+    }
+    /**
+     * Get tracker statistics
+     */
+    getStats() {
+        return {
+            totalMetrics: this.metrics.length,
+            activeTimers: this.activeTimers.size,
+            retention: this.maxRetention,
+            enabled: this.enabled,
+        };
+    }
+    /**
+     * Enable tracking
+     */
+    enable() {
+        this.enabled = true;
+    }
+    /**
+     * Disable tracking
+     */
+    disable() {
+        this.enabled = false;
+    }
+}
+// Global singleton instance
+let globalTracker = null;
+/**
+ * Get or create the global performance tracker instance
+ */
+export function getPerformanceTracker(config) {
+    if (!globalTracker) {
+        // Check environment variables for configuration
+        const envConfig = {
+            enabled: process.env.PINEPAPER_METRICS_ENABLED !== 'false',
+            maxRetention: process.env.PINEPAPER_METRICS_RETENTION
+                ? parseInt(process.env.PINEPAPER_METRICS_RETENTION, 10)
+                : 1000,
+        };
+        globalTracker = new PerformanceTracker({ ...envConfig, ...config });
+    }
+    return globalTracker;
+}
+/**
+ * Reset the global performance tracker (mainly for testing)
+ */
+export function resetPerformanceTracker() {
+    globalTracker = null;
+}
+//# sourceMappingURL=performance-tracker.js.map

package/dist/metrics/performance-tracker.js.map

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

package/dist/metrics/types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Performance Metrics Types
+ *
+ * Type definitions for performance tracking and metrics collection.
+ */
+/**
+ * Phase of tool execution being measured
+ */
+export type MetricPhase = 'validation' | 'code_generation' | 'browser_execution' | 'screenshot' | 'total';
+/**
+ * A single timing metric for a tool execution phase
+ */
+export interface TimingMetric {
+    /** Tool name (e.g., 'pinepaper_create_item') */
+    toolName: string;
+    /** Execution phase being measured */
+    phase: MetricPhase;
+    /** Duration in milliseconds */
+    duration: number;
+    /** Unix timestamp when metric was recorded */
+    timestamp: number;
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** Error message if operation failed */
+    error?: string;
+    /** Additional metadata about the operation */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Aggregate statistics for a set of metrics
+ */
+export interface AggregateStats {
+    /** Total number of measurements */
+    count: number;
+    /** Average duration in milliseconds */
+    avgDuration: number;
+    /** Minimum duration in milliseconds */
+    minDuration: number;
+    /** Maximum duration in milliseconds */
+    maxDuration: number;
+    /** Median duration (50th percentile) in milliseconds */
+    p50: number;
+    /** 95th percentile duration in milliseconds */
+    p95: number;
+    /** 99th percentile duration in milliseconds */
+    p99: number;
+    /** Success rate (0-1) */
+    successRate: number;
+    /** Total duration of all operations in milliseconds */
+    totalDuration: number;
+}
+/**
+ * Filter options for querying metrics
+ */
+export interface MetricsFilter {
+    /** Filter by tool name */
+    toolName?: string;
+    /** Filter by execution phase */
+    phase?: MetricPhase;
+    /** Filter by success status */
+    success?: boolean;
+    /** Filter metrics since this timestamp (Unix timestamp) */
+    since?: number;
+    /** Filter metrics until this timestamp (Unix timestamp) */
+    until?: number;
+    /** Maximum number of results to return */
+    limit?: number;
+}
+/**
+ * Export format for metrics
+ */
+export type MetricsExportFormat = 'json' | 'csv' | 'summary';
+/**
+ * Metrics summary for tool or phase
+ */
+export interface MetricsSummary {
+    /** Tool name or 'all' for aggregate */
+    toolName: string;
+    /** Phase or 'all' for aggregate */
+    phase: MetricPhase | 'all';
+    /** Aggregate statistics */
+    stats: AggregateStats;
+    /** Recent measurements (last N) */
+    recentMetrics?: TimingMetric[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/metrics/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/metrics/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,YAAY,GACZ,iBAAiB,GACjB,mBAAmB,GACnB,YAAY,GACZ,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IAEjB,qCAAqC;IACrC,KAAK,EAAE,WAAW,CAAC;IAEnB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IAEjB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAElB,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IAEjB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IAEd,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IAEpB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IAEpB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IAEpB,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;IAEZ,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IAEZ,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IAEZ,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IAEpB,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,gCAAgC;IAChC,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IAEjB,mCAAmC;IACnC,KAAK,EAAE,WAAW,GAAG,KAAK,CAAC;IAE3B,2BAA2B;IAC3B,KAAK,EAAE,cAAc,CAAC;IAEtB,mCAAmC;IACnC,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;CAChC"}

package/dist/metrics/types.js

@@ -0,0 +1,7 @@
+/**
+ * Performance Metrics Types
+ *
+ * Type definitions for performance tracking and metrics collection.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/metrics/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/metrics/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/tools/definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAM/C,eAAO,MAAM,eAAe,EAAE,IAAI,EA8hCjC,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAE5D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,CAO3D"}
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AA4I/C,eAAO,MAAM,eAAe,EAAE,IAAI,EA65CjC,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAE5D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,CAO3D"}