mcp-agent-foundry 1.0.0

package/dist/observability/metrics.d.ts

@@ -0,0 +1,250 @@
+/**
+ * Metrics Collection Module
+ *
+ * Simple in-memory metrics collection for AgentRouter observability.
+ * Tracks:
+ * - Request counts (by role, provider, status)
+ * - Latency histograms with percentile calculations (by role, provider)
+ * - Token usage (input, output by provider)
+ * - Error counts (by type, provider)
+ * - Circuit breaker state changes
+ *
+ * No external dependencies - pure TypeScript implementation.
+ */
+/**
+ * Token usage statistics for a provider.
+ */
+export interface TokenStats {
+    input: number;
+    output: number;
+    total: number;
+}
+/**
+ * Latency statistics with percentiles.
+ */
+export interface LatencyStats {
+    count: number;
+    min: number;
+    max: number;
+    mean: number;
+    p50: number;
+    p95: number;
+    p99: number;
+}
+/**
+ * Circuit breaker state.
+ */
+export type CircuitBreakerState = 'closed' | 'open' | 'half-open';
+/**
+ * Circuit breaker state change event.
+ */
+export interface CircuitBreakerEvent {
+    provider: string;
+    previousState: CircuitBreakerState;
+    newState: CircuitBreakerState;
+    timestamp: number;
+}
+/**
+ * Request status for metrics tracking.
+ */
+export type RequestStatus = 'success' | 'error' | 'timeout' | 'rate_limited';
+/**
+ * Input for recording a request.
+ */
+export interface RequestRecord {
+    role: string;
+    provider: string;
+    status: RequestStatus;
+    durationMs: number;
+    tokens?: {
+        input: number;
+        output: number;
+    };
+}
+/**
+ * Aggregated metrics snapshot.
+ */
+export interface Metrics {
+    requests: {
+        total: number;
+        byRole: Map<string, number>;
+        byProvider: Map<string, number>;
+        byStatus: Map<string, number>;
+    };
+    latency: {
+        p50: number;
+        p95: number;
+        p99: number;
+        byProvider: Map<string, LatencyStats>;
+        byRole: Map<string, LatencyStats>;
+    };
+    tokens: {
+        input: number;
+        output: number;
+        byProvider: Map<string, TokenStats>;
+    };
+    errors: {
+        total: number;
+        byType: Map<string, number>;
+        byProvider: Map<string, number>;
+    };
+    circuitBreaker: {
+        stateChanges: CircuitBreakerEvent[];
+        currentStates: Map<string, CircuitBreakerState>;
+    };
+    startTime: number;
+    lastUpdated: number;
+}
+/**
+ * JSON-serializable metrics format.
+ */
+export interface MetricsJSON {
+    requests: {
+        total: number;
+        byRole: Record<string, number>;
+        byProvider: Record<string, number>;
+        byStatus: Record<string, number>;
+    };
+    latency: {
+        p50: number;
+        p95: number;
+        p99: number;
+        byProvider: Record<string, LatencyStats>;
+        byRole: Record<string, LatencyStats>;
+    };
+    tokens: {
+        input: number;
+        output: number;
+        byProvider: Record<string, TokenStats>;
+    };
+    errors: {
+        total: number;
+        byType: Record<string, number>;
+        byProvider: Record<string, number>;
+    };
+    circuitBreaker: {
+        stateChanges: CircuitBreakerEvent[];
+        currentStates: Record<string, CircuitBreakerState>;
+    };
+    startTime: number;
+    lastUpdated: number;
+    uptimeMs: number;
+}
+/**
+ * Metrics collector for tracking AgentRouter performance and usage.
+ *
+ * Thread-safe for single-threaded Node.js runtime.
+ * Maintains rolling latency data for percentile calculations.
+ *
+ * @example
+ * ```typescript
+ * const metrics = new MetricsCollector();
+ *
+ * // Record a successful request
+ * metrics.recordRequest({
+ *   role: 'coder',
+ *   provider: 'anthropic',
+ *   status: 'success',
+ *   durationMs: 1234,
+ *   tokens: { input: 100, output: 500 }
+ * });
+ *
+ * // Record an error
+ * metrics.recordError('RateLimitError', 'openai');
+ *
+ * // Get metrics snapshot
+ * const snapshot = metrics.getMetrics();
+ * console.log(`Total requests: ${snapshot.requests.total}`);
+ * console.log(`P95 latency: ${snapshot.latency.p95}ms`);
+ * ```
+ */
+export declare class MetricsCollector {
+    private requestCount;
+    private requestsByRole;
+    private requestsByProvider;
+    private requestsByStatus;
+    private latencyValues;
+    private latencyByProvider;
+    private latencyByRole;
+    private totalInputTokens;
+    private totalOutputTokens;
+    private tokensByProvider;
+    private errorCount;
+    private errorsByType;
+    private errorsByProvider;
+    private circuitBreakerEvents;
+    private circuitBreakerStates;
+    private readonly startTime;
+    private lastUpdated;
+    private readonly maxLatencySamples;
+    private readonly maxCircuitBreakerEvents;
+    /**
+     * Create a new MetricsCollector.
+     *
+     * @param options Configuration options
+     * @param options.maxLatencySamples Maximum number of latency samples to keep (default: 10000)
+     * @param options.maxCircuitBreakerEvents Maximum circuit breaker events to keep (default: 1000)
+     */
+    constructor(options?: {
+        maxLatencySamples?: number;
+        maxCircuitBreakerEvents?: number;
+    });
+    /**
+     * Record a completed request.
+     *
+     * @param record Request details to record
+     */
+    recordRequest(record: RequestRecord): void;
+    /**
+     * Record an error occurrence.
+     *
+     * @param errorType The type/class of the error
+     * @param provider The provider that produced the error (optional)
+     */
+    recordError(errorType: string, provider?: string): void;
+    /**
+     * Record a circuit breaker state change.
+     *
+     * @param provider The provider whose circuit breaker changed
+     * @param previousState The previous state
+     * @param newState The new state
+     */
+    recordCircuitBreakerChange(provider: string, previousState: CircuitBreakerState, newState: CircuitBreakerState): void;
+    /**
+     * Get the current metrics snapshot.
+     *
+     * @returns Aggregated metrics with calculated percentiles
+     */
+    getMetrics(): Metrics;
+    /**
+     * Reset all metrics to initial state.
+     * Useful for testing or periodic resets.
+     */
+    reset(): void;
+    /**
+     * Export metrics as a JSON string.
+     *
+     * @returns JSON string representation of all metrics
+     */
+    toJSON(): string;
+    /**
+     * Get a summary string suitable for logging.
+     *
+     * @returns Human-readable summary of key metrics
+     */
+    getSummary(): string;
+    private incrementMap;
+    private addLatencySample;
+    private addLatencySampleToMap;
+    private calculateLatencyStatsByKey;
+}
+/**
+ * Default metrics collector instance for the agent-router package.
+ * Pre-configured and ready to use.
+ */
+export declare const metrics: MetricsCollector;
+/**
+ * Re-export for convenience.
+ */
+export default metrics;
+//# sourceMappingURL=metrics.d.ts.map

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

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

package/dist/observability/metrics.js

@@ -0,0 +1,364 @@
+/**
+ * Metrics Collection Module
+ *
+ * Simple in-memory metrics collection for AgentRouter observability.
+ * Tracks:
+ * - Request counts (by role, provider, status)
+ * - Latency histograms with percentile calculations (by role, provider)
+ * - Token usage (input, output by provider)
+ * - Error counts (by type, provider)
+ * - Circuit breaker state changes
+ *
+ * No external dependencies - pure TypeScript implementation.
+ */
+// ============================================================================
+// Utilities
+// ============================================================================
+/**
+ * Calculate percentile from a sorted array of numbers.
+ */
+function calculatePercentile(sortedValues, percentile) {
+    if (sortedValues.length === 0)
+        return 0;
+    if (sortedValues.length === 1)
+        return sortedValues[0];
+    const index = (percentile / 100) * (sortedValues.length - 1);
+    const lower = Math.floor(index);
+    const upper = Math.ceil(index);
+    if (lower === upper)
+        return sortedValues[lower];
+    const fraction = index - lower;
+    return sortedValues[lower] + fraction * (sortedValues[upper] - sortedValues[lower]);
+}
+/**
+ * Calculate latency statistics from an array of latency values.
+ */
+function calculateLatencyStats(values) {
+    if (values.length === 0) {
+        return { count: 0, min: 0, max: 0, mean: 0, p50: 0, p95: 0, p99: 0 };
+    }
+    const sorted = [...values].sort((a, b) => a - b);
+    const sum = values.reduce((acc, val) => acc + val, 0);
+    return {
+        count: values.length,
+        min: sorted[0],
+        max: sorted[sorted.length - 1],
+        mean: sum / values.length,
+        p50: calculatePercentile(sorted, 50),
+        p95: calculatePercentile(sorted, 95),
+        p99: calculatePercentile(sorted, 99),
+    };
+}
+/**
+ * Convert a Map to a plain object for JSON serialization.
+ */
+function mapToObject(map) {
+    const obj = {};
+    for (const [key, value] of map) {
+        obj[key] = value;
+    }
+    return obj;
+}
+// ============================================================================
+// MetricsCollector Class
+// ============================================================================
+/**
+ * Metrics collector for tracking AgentRouter performance and usage.
+ *
+ * Thread-safe for single-threaded Node.js runtime.
+ * Maintains rolling latency data for percentile calculations.
+ *
+ * @example
+ * ```typescript
+ * const metrics = new MetricsCollector();
+ *
+ * // Record a successful request
+ * metrics.recordRequest({
+ *   role: 'coder',
+ *   provider: 'anthropic',
+ *   status: 'success',
+ *   durationMs: 1234,
+ *   tokens: { input: 100, output: 500 }
+ * });
+ *
+ * // Record an error
+ * metrics.recordError('RateLimitError', 'openai');
+ *
+ * // Get metrics snapshot
+ * const snapshot = metrics.getMetrics();
+ * console.log(`Total requests: ${snapshot.requests.total}`);
+ * console.log(`P95 latency: ${snapshot.latency.p95}ms`);
+ * ```
+ */
+export class MetricsCollector {
+    // Request counts
+    requestCount = 0;
+    requestsByRole = new Map();
+    requestsByProvider = new Map();
+    requestsByStatus = new Map();
+    // Latency tracking (store raw values for percentile calculation)
+    latencyValues = [];
+    latencyByProvider = new Map();
+    latencyByRole = new Map();
+    // Token tracking
+    totalInputTokens = 0;
+    totalOutputTokens = 0;
+    tokensByProvider = new Map();
+    // Error tracking
+    errorCount = 0;
+    errorsByType = new Map();
+    errorsByProvider = new Map();
+    // Circuit breaker tracking
+    circuitBreakerEvents = [];
+    circuitBreakerStates = new Map();
+    // Timing
+    startTime;
+    lastUpdated;
+    // Configuration
+    maxLatencySamples;
+    maxCircuitBreakerEvents;
+    /**
+     * Create a new MetricsCollector.
+     *
+     * @param options Configuration options
+     * @param options.maxLatencySamples Maximum number of latency samples to keep (default: 10000)
+     * @param options.maxCircuitBreakerEvents Maximum circuit breaker events to keep (default: 1000)
+     */
+    constructor(options) {
+        this.startTime = Date.now();
+        this.lastUpdated = this.startTime;
+        this.maxLatencySamples = options?.maxLatencySamples ?? 10000;
+        this.maxCircuitBreakerEvents = options?.maxCircuitBreakerEvents ?? 1000;
+    }
+    /**
+     * Record a completed request.
+     *
+     * @param record Request details to record
+     */
+    recordRequest(record) {
+        this.lastUpdated = Date.now();
+        // Increment request counts
+        this.requestCount++;
+        this.incrementMap(this.requestsByRole, record.role);
+        this.incrementMap(this.requestsByProvider, record.provider);
+        this.incrementMap(this.requestsByStatus, record.status);
+        // Record latency
+        this.addLatencySample(this.latencyValues, record.durationMs);
+        this.addLatencySampleToMap(this.latencyByProvider, record.provider, record.durationMs);
+        this.addLatencySampleToMap(this.latencyByRole, record.role, record.durationMs);
+        // Record tokens if provided
+        if (record.tokens) {
+            this.totalInputTokens += record.tokens.input;
+            this.totalOutputTokens += record.tokens.output;
+            const providerTokens = this.tokensByProvider.get(record.provider) ?? {
+                input: 0,
+                output: 0,
+                total: 0,
+            };
+            providerTokens.input += record.tokens.input;
+            providerTokens.output += record.tokens.output;
+            providerTokens.total += record.tokens.input + record.tokens.output;
+            this.tokensByProvider.set(record.provider, providerTokens);
+        }
+    }
+    /**
+     * Record an error occurrence.
+     *
+     * @param errorType The type/class of the error
+     * @param provider The provider that produced the error (optional)
+     */
+    recordError(errorType, provider) {
+        this.lastUpdated = Date.now();
+        this.errorCount++;
+        this.incrementMap(this.errorsByType, errorType);
+        if (provider) {
+            this.incrementMap(this.errorsByProvider, provider);
+        }
+    }
+    /**
+     * Record a circuit breaker state change.
+     *
+     * @param provider The provider whose circuit breaker changed
+     * @param previousState The previous state
+     * @param newState The new state
+     */
+    recordCircuitBreakerChange(provider, previousState, newState) {
+        this.lastUpdated = Date.now();
+        const event = {
+            provider,
+            previousState,
+            newState,
+            timestamp: Date.now(),
+        };
+        this.circuitBreakerEvents.push(event);
+        this.circuitBreakerStates.set(provider, newState);
+        // Trim old events if needed
+        if (this.circuitBreakerEvents.length > this.maxCircuitBreakerEvents) {
+            this.circuitBreakerEvents = this.circuitBreakerEvents.slice(-this.maxCircuitBreakerEvents);
+        }
+    }
+    /**
+     * Get the current metrics snapshot.
+     *
+     * @returns Aggregated metrics with calculated percentiles
+     */
+    getMetrics() {
+        const globalLatencyStats = calculateLatencyStats(this.latencyValues);
+        return {
+            requests: {
+                total: this.requestCount,
+                byRole: new Map(this.requestsByRole),
+                byProvider: new Map(this.requestsByProvider),
+                byStatus: new Map(this.requestsByStatus),
+            },
+            latency: {
+                p50: globalLatencyStats.p50,
+                p95: globalLatencyStats.p95,
+                p99: globalLatencyStats.p99,
+                byProvider: this.calculateLatencyStatsByKey(this.latencyByProvider),
+                byRole: this.calculateLatencyStatsByKey(this.latencyByRole),
+            },
+            tokens: {
+                input: this.totalInputTokens,
+                output: this.totalOutputTokens,
+                byProvider: new Map(this.tokensByProvider),
+            },
+            errors: {
+                total: this.errorCount,
+                byType: new Map(this.errorsByType),
+                byProvider: new Map(this.errorsByProvider),
+            },
+            circuitBreaker: {
+                stateChanges: [...this.circuitBreakerEvents],
+                currentStates: new Map(this.circuitBreakerStates),
+            },
+            startTime: this.startTime,
+            lastUpdated: this.lastUpdated,
+        };
+    }
+    /**
+     * Reset all metrics to initial state.
+     * Useful for testing or periodic resets.
+     */
+    reset() {
+        this.requestCount = 0;
+        this.requestsByRole.clear();
+        this.requestsByProvider.clear();
+        this.requestsByStatus.clear();
+        this.latencyValues = [];
+        this.latencyByProvider.clear();
+        this.latencyByRole.clear();
+        this.totalInputTokens = 0;
+        this.totalOutputTokens = 0;
+        this.tokensByProvider.clear();
+        this.errorCount = 0;
+        this.errorsByType.clear();
+        this.errorsByProvider.clear();
+        this.circuitBreakerEvents = [];
+        this.circuitBreakerStates.clear();
+        this.lastUpdated = Date.now();
+    }
+    /**
+     * Export metrics as a JSON string.
+     *
+     * @returns JSON string representation of all metrics
+     */
+    toJSON() {
+        const metrics = this.getMetrics();
+        const globalLatencyStats = calculateLatencyStats(this.latencyValues);
+        const jsonMetrics = {
+            requests: {
+                total: metrics.requests.total,
+                byRole: mapToObject(metrics.requests.byRole),
+                byProvider: mapToObject(metrics.requests.byProvider),
+                byStatus: mapToObject(metrics.requests.byStatus),
+            },
+            latency: {
+                p50: globalLatencyStats.p50,
+                p95: globalLatencyStats.p95,
+                p99: globalLatencyStats.p99,
+                byProvider: mapToObject(metrics.latency.byProvider),
+                byRole: mapToObject(metrics.latency.byRole),
+            },
+            tokens: {
+                input: metrics.tokens.input,
+                output: metrics.tokens.output,
+                byProvider: mapToObject(metrics.tokens.byProvider),
+            },
+            errors: {
+                total: metrics.errors.total,
+                byType: mapToObject(metrics.errors.byType),
+                byProvider: mapToObject(metrics.errors.byProvider),
+            },
+            circuitBreaker: {
+                stateChanges: metrics.circuitBreaker.stateChanges,
+                currentStates: mapToObject(metrics.circuitBreaker.currentStates),
+            },
+            startTime: metrics.startTime,
+            lastUpdated: metrics.lastUpdated,
+            uptimeMs: Date.now() - metrics.startTime,
+        };
+        return JSON.stringify(jsonMetrics, null, 2);
+    }
+    /**
+     * Get a summary string suitable for logging.
+     *
+     * @returns Human-readable summary of key metrics
+     */
+    getSummary() {
+        const m = this.getMetrics();
+        const uptimeSeconds = Math.floor((Date.now() - m.startTime) / 1000);
+        return [
+            `Metrics Summary (uptime: ${uptimeSeconds}s)`,
+            `  Requests: ${m.requests.total} total`,
+            `  Latency: p50=${m.latency.p50.toFixed(0)}ms, p95=${m.latency.p95.toFixed(0)}ms, p99=${m.latency.p99.toFixed(0)}ms`,
+            `  Tokens: ${m.tokens.input} input, ${m.tokens.output} output`,
+            `  Errors: ${m.errors.total} total`,
+        ].join('\n');
+    }
+    // ============================================================================
+    // Private Helpers
+    // ============================================================================
+    incrementMap(map, key) {
+        map.set(key, (map.get(key) ?? 0) + 1);
+    }
+    addLatencySample(values, sample) {
+        values.push(sample);
+        // Trim to max samples (remove oldest)
+        if (values.length > this.maxLatencySamples) {
+            values.shift();
+        }
+    }
+    addLatencySampleToMap(map, key, sample) {
+        let values = map.get(key);
+        if (!values) {
+            values = [];
+            map.set(key, values);
+        }
+        values.push(sample);
+        // Trim to max samples per key
+        if (values.length > this.maxLatencySamples) {
+            values.shift();
+        }
+    }
+    calculateLatencyStatsByKey(map) {
+        const result = new Map();
+        for (const [key, values] of map) {
+            result.set(key, calculateLatencyStats(values));
+        }
+        return result;
+    }
+}
+// ============================================================================
+// Singleton Instance
+// ============================================================================
+/**
+ * Default metrics collector instance for the agent-router package.
+ * Pre-configured and ready to use.
+ */
+export const metrics = new MetricsCollector();
+/**
+ * Re-export for convenience.
+ */
+export default metrics;
+//# sourceMappingURL=metrics.js.map

package/dist/observability/metrics.js.map

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

package/dist/persistence/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Persistence Module
+ *
+ * Provides state persistence for Agent Foundry, enabling state to survive
+ * server restarts and crashes. State is stored in .agent-foundry/state.json.
+ */
+export * from './state-schema.js';
+export * from './state-store.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/persistence/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}

package/dist/persistence/index.js

@@ -0,0 +1,9 @@
+/**
+ * Persistence Module
+ *
+ * Provides state persistence for Agent Foundry, enabling state to survive
+ * server restarts and crashes. State is stored in .agent-foundry/state.json.
+ */
+export * from './state-schema.js';
+export * from './state-store.js';
+//# sourceMappingURL=index.js.map

package/dist/persistence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/persistence/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}