monomind 2.7.11 → 2.7.13

package/packages/@monomind/cli/dist/src/pricing/model-pricing.js

@@ -1,61 +0,0 @@
-/** Canonical pricing map — union of all models from collector + server tables. */
-export const MODEL_PRICING = {
-    // ── Opus ────────────────────────────────────────────────────────────────────
-    'claude-opus-4-8': { in: 5e-6, out: 25e-6, cw: 6.25e-6, cr: 0.5e-6 },
-    'claude-opus-4-6': { in: 5e-6, out: 25e-6, cw: 6.25e-6, cr: 0.5e-6 },
-    'claude-opus-4-5': { in: 5e-6, out: 25e-6, cw: 6.25e-6, cr: 0.5e-6 },
-    'claude-opus-4': { in: 15e-6, out: 75e-6, cw: 18.75e-6, cr: 1.5e-6 },
-    // ── Sonnet ──────────────────────────────────────────────────────────────────
-    'claude-sonnet-4-6': { in: 3e-6, out: 15e-6, cw: 3.75e-6, cr: 0.3e-6 },
-    'claude-sonnet-4-5': { in: 3e-6, out: 15e-6, cw: 3.75e-6, cr: 0.3e-6 },
-    'claude-sonnet-4': { in: 3e-6, out: 15e-6, cw: 3.75e-6, cr: 0.3e-6 },
-    'claude-3-7-sonnet': { in: 3e-6, out: 15e-6, cw: 3.75e-6, cr: 0.3e-6 },
-    'claude-3-5-sonnet': { in: 3e-6, out: 15e-6, cw: 3.75e-6, cr: 0.3e-6 },
-    // ── Haiku ───────────────────────────────────────────────────────────────────
-    'claude-haiku-4-5': { in: 1e-6, out: 5e-6, cw: 1.25e-6, cr: 0.1e-6 },
-    'claude-haiku-4': { in: 0.8e-6, out: 4e-6, cw: 1e-6, cr: 0.08e-6 },
-    'claude-3-5-haiku': { in: 0.8e-6, out: 4e-6, cw: 1e-6, cr: 0.08e-6 },
-    // ── OpenAI ──────────────────────────────────────────────────────────────────
-    'gpt-4o': { in: 2.5e-6, out: 10e-6, cw: 2.5e-6, cr: 1.25e-6 },
-    'gpt-4o-mini': { in: 0.15e-6, out: 0.6e-6, cw: 0.15e-6, cr: 0.075e-6 },
-    // ── Google ──────────────────────────────────────────────────────────────────
-    'gemini-2.5-pro': { in: 1.25e-6, out: 10e-6, cw: 1.25e-6, cr: 0.315e-6 },
-};
-/** Short-name aliases → canonical model keys. */
-const _ALIAS = {
-    haiku: 'claude-haiku-4-5',
-    sonnet: 'claude-sonnet-4-6',
-    opus: 'claude-opus-4-6',
-};
-/**
- * Canonical default model IDs — single source of truth for code that needs
- * to reference a specific tier without hard-coding a string literal.
- *
- * Consumers should import these instead of writing raw model-id strings so
- * that a model upgrade only requires editing this one object.
- */
-export const MODEL_DEFAULTS = {
-    /** Fast/cheap routing model (Tier 2). */
-    haiku: _ALIAS['haiku'],
-    /** Balanced capability model (Tier 3 default). */
-    sonnet: _ALIAS['sonnet'],
-    /** Most capable model (Tier 3 high). */
-    opus: _ALIAS['opus'],
-};
-/**
- * Resolve a raw model string (may include date suffix or @version) to its
- * pricing entry.  Returns `null` when the model is unknown.
- */
-export function getModelPrice(modelId) {
-    let key = (modelId || '').replace(/@.*$/, '').replace(/-\d{8}$/, '');
-    key = _ALIAS[key] ?? key;
-    if (MODEL_PRICING[key])
-        return MODEL_PRICING[key];
-    // Prefix / substring fallback for versioned model strings
-    for (const k of Object.keys(MODEL_PRICING)) {
-        if (key.startsWith(k) || key.includes(k))
-            return MODEL_PRICING[k];
-    }
-    return null;
-}
-//# sourceMappingURL=model-pricing.js.map

package/packages/@monomind/cli/dist/src/production/circuit-breaker.d.ts

@@ -1,121 +0,0 @@
-/**
- * Production Circuit Breaker
- *
- * Implements the circuit breaker pattern to prevent cascading failures:
- * - Closed: Normal operation
- * - Open: Failing fast, not calling service
- * - Half-Open: Testing if service recovered
- *
- * @module @monomind/cli/production/circuit-breaker
- */
-/**
- * Circuit breaker states.
- * - `closed`: Normal operation, requests pass through.
- * - `open`: Failing fast, requests are rejected immediately.
- * - `half-open`: Testing recovery, a percentage of requests pass through.
- */
-export type CircuitState = 'closed' | 'open' | 'half-open';
-/**
- * Circuit breaker configuration options.
- */
-export interface CircuitBreakerConfig {
-    /** Number of failures within the window before opening the circuit. */
-    failureThreshold: number;
-    /** Time (ms) to wait in the open state before transitioning to half-open. */
-    resetTimeoutMs: number;
-    /** Number of consecutive successes in half-open before closing. */
-    successThreshold: number;
-    /** Sliding window (ms) over which failures are counted. */
-    failureWindowMs: number;
-    /** Fraction of requests (0-1) allowed through while half-open. */
-    halfOpenRequestPercentage: number;
-    /** Called when the circuit transitions to the open state. */
-    onOpen?: (failureCount: number) => void;
-    /** Called when the circuit transitions to the closed state. */
-    onClose?: () => void;
-    /** Called on any state transition. */
-    onStateChange?: (oldState: CircuitState, newState: CircuitState) => void;
-}
-/**
- * Snapshot of circuit breaker statistics.
- */
-export interface CircuitBreakerStats {
-    state: CircuitState;
-    failures: number;
-    successes: number;
-    lastFailure: Date | null;
-    lastSuccess: Date | null;
-    stateChangedAt: Date;
-    totalRequests: number;
-    totalFailures: number;
-    totalSuccesses: number;
-}
-export declare class CircuitBreaker {
-    private config;
-    private state;
-    private failures;
-    private successCount;
-    private stateChangedAt;
-    private totalRequests;
-    private totalFailures;
-    private totalSuccesses;
-    private lastFailure;
-    private lastSuccess;
-    constructor(config?: Partial<CircuitBreakerConfig>);
-    /**
-     * Get current circuit state
-     */
-    getState(): CircuitState;
-    /**
-     * Check if request is allowed
-     */
-    isAllowed(): boolean;
-    /**
-     * Execute a function through the circuit breaker
-     */
-    execute<T>(fn: () => Promise<T>): Promise<T>;
-    /**
-     * Record a successful operation
-     */
-    recordSuccess(): void;
-    /**
-     * Record a failed operation
-     */
-    recordFailure(): void;
-    /**
-     * Manually open the circuit
-     */
-    open(): void;
-    /**
-     * Manually close the circuit
-     */
-    close(): void;
-    /**
-     * Reset the circuit breaker
-     */
-    reset(): void;
-    /**
-     * Get circuit statistics
-     */
-    getStats(): CircuitBreakerStats;
-    /**
-     * Get failure rate
-     */
-    getFailureRate(): number;
-    private checkStateTransition;
-    private transitionTo;
-}
-/**
- * Get or create a circuit breaker by name
- */
-export declare function getCircuitBreaker(name: string, config?: Partial<CircuitBreakerConfig>): CircuitBreaker;
-/**
- * Get all circuit breaker stats
- */
-export declare function getAllCircuitStats(): Record<string, CircuitBreakerStats>;
-/**
- * Reset all circuit breakers
- */
-export declare function resetAllCircuits(): void;
-export default CircuitBreaker;
-//# sourceMappingURL=circuit-breaker.d.ts.map

package/packages/@monomind/cli/dist/src/production/circuit-breaker.js

@@ -1,262 +0,0 @@
-/**
- * Production Circuit Breaker
- *
- * Implements the circuit breaker pattern to prevent cascading failures:
- * - Closed: Normal operation
- * - Open: Failing fast, not calling service
- * - Half-Open: Testing if service recovered
- *
- * @module @monomind/cli/production/circuit-breaker
- */
-// ============================================================================
-// Default Configuration
-// ============================================================================
-const DEFAULT_CONFIG = {
-    failureThreshold: 5,
-    resetTimeoutMs: 30000,
-    successThreshold: 3,
-    failureWindowMs: 60000,
-    halfOpenRequestPercentage: 0.1,
-};
-// ============================================================================
-// Circuit Breaker Implementation
-// ============================================================================
-export class CircuitBreaker {
-    config;
-    state = 'closed';
-    failures = [];
-    successCount = 0;
-    stateChangedAt = Date.now();
-    totalRequests = 0;
-    totalFailures = 0;
-    totalSuccesses = 0;
-    lastFailure = null;
-    lastSuccess = null;
-    constructor(config = {}) {
-        this.config = { ...DEFAULT_CONFIG, ...config };
-    }
-    /**
-     * Get current circuit state
-     */
-    getState() {
-        this.checkStateTransition();
-        return this.state;
-    }
-    /**
-     * Check if request is allowed
-     */
-    isAllowed() {
-        this.checkStateTransition();
-        switch (this.state) {
-            case 'closed':
-                return true;
-            case 'open':
-                return false;
-            case 'half-open':
-                // Allow a percentage of requests through
-                return Math.random() < this.config.halfOpenRequestPercentage;
-            default:
-                return true;
-        }
-    }
-    /**
-     * Execute a function through the circuit breaker
-     */
-    async execute(fn) {
-        if (!this.isAllowed()) {
-            throw new Error('Circuit breaker is open. Service temporarily unavailable.');
-        }
-        this.totalRequests++;
-        try {
-            const result = await fn();
-            this.recordSuccess();
-            return result;
-        }
-        catch (error) {
-            this.recordFailure();
-            throw error;
-        }
-    }
-    /**
-     * Record a successful operation
-     */
-    recordSuccess() {
-        this.totalSuccesses++;
-        this.lastSuccess = new Date();
-        if (this.state === 'half-open') {
-            this.successCount++;
-            if (this.successCount >= this.config.successThreshold) {
-                this.transitionTo('closed');
-            }
-        }
-        // Reset failure count on success in closed state
-        if (this.state === 'closed') {
-            this.failures = [];
-        }
-    }
-    /**
-     * Record a failed operation
-     */
-    recordFailure() {
-        const now = Date.now();
-        this.totalFailures++;
-        this.lastFailure = new Date();
-        // Add failure timestamp
-        this.failures.push(now);
-        // Clean old failures outside window
-        this.failures = this.failures.filter(t => t > now - this.config.failureWindowMs);
-        // Hard cap: prevent unbounded growth under rapid-fire recordFailure() calls
-        // before the window filter prunes entries (e.g. clock skew or test hammering).
-        if (this.failures.length > 10_000) {
-            this.failures = this.failures.slice(-10_000);
-        }
-        // Check if we should open the circuit
-        if (this.state === 'closed' && this.failures.length >= this.config.failureThreshold) {
-            this.transitionTo('open');
-            if (this.config.onOpen) {
-                this.config.onOpen(this.failures.length);
-            }
-        }
-        // If half-open and we fail, go back to open
-        if (this.state === 'half-open') {
-            this.transitionTo('open');
-            if (this.config.onOpen) {
-                this.config.onOpen(this.failures.length);
-            }
-        }
-    }
-    /**
-     * Manually open the circuit
-     */
-    open() {
-        if (this.state !== 'open') {
-            this.transitionTo('open');
-        }
-    }
-    /**
-     * Manually close the circuit
-     */
-    close() {
-        if (this.state !== 'closed') {
-            this.transitionTo('closed');
-        }
-    }
-    /**
-     * Reset the circuit breaker
-     */
-    reset() {
-        this.state = 'closed';
-        this.failures = [];
-        this.successCount = 0;
-        this.stateChangedAt = Date.now();
-        this.totalRequests = 0;
-        this.totalFailures = 0;
-        this.totalSuccesses = 0;
-        this.lastFailure = null;
-        this.lastSuccess = null;
-    }
-    /**
-     * Get circuit statistics
-     */
-    getStats() {
-        return {
-            state: this.state,
-            failures: this.failures.length,
-            successes: this.successCount,
-            lastFailure: this.lastFailure,
-            lastSuccess: this.lastSuccess,
-            stateChangedAt: new Date(this.stateChangedAt),
-            totalRequests: this.totalRequests,
-            totalFailures: this.totalFailures,
-            totalSuccesses: this.totalSuccesses,
-        };
-    }
-    /**
-     * Get failure rate
-     */
-    getFailureRate() {
-        if (this.totalRequests === 0)
-            return 0;
-        return this.totalFailures / this.totalRequests;
-    }
-    // ============================================================================
-    // Private Methods
-    // ============================================================================
-    checkStateTransition() {
-        const now = Date.now();
-        if (this.state === 'open') {
-            // Check if we should transition to half-open
-            if (now - this.stateChangedAt >= this.config.resetTimeoutMs) {
-                this.transitionTo('half-open');
-            }
-        }
-    }
-    transitionTo(newState) {
-        const oldState = this.state;
-        if (oldState === newState)
-            return;
-        this.state = newState;
-        this.stateChangedAt = Date.now();
-        // Reset counters on state change
-        if (newState === 'half-open') {
-            this.successCount = 0;
-        }
-        if (newState === 'closed') {
-            this.failures = [];
-            this.successCount = 0;
-            if (this.config.onClose) {
-                this.config.onClose();
-            }
-        }
-        // Notify state change
-        if (this.config.onStateChange) {
-            this.config.onStateChange(oldState, newState);
-        }
-    }
-}
-// ============================================================================
-// Circuit Breaker Registry
-// ============================================================================
-const circuitBreakers = new Map();
-const MAX_CIRCUIT_BREAKERS = 1000;
-const MAX_CIRCUIT_BREAKER_NAME_LEN = 256;
-const FORBIDDEN_CB_NAMES = new Set(['__proto__', 'constructor', 'prototype']);
-/**
- * Get or create a circuit breaker by name
- */
-export function getCircuitBreaker(name, config) {
-    // Sanitize name: cap length and block prototype-pollution keys
-    const safeName = typeof name === 'string'
-        ? name.slice(0, MAX_CIRCUIT_BREAKER_NAME_LEN)
-        : 'default';
-    if (FORBIDDEN_CB_NAMES.has(safeName)) {
-        throw new Error(`Invalid circuit breaker name: ${safeName}`);
-    }
-    if (!circuitBreakers.has(safeName)) {
-        if (circuitBreakers.size >= MAX_CIRCUIT_BREAKERS) {
-            throw new Error(`Circuit breaker registry full (max ${MAX_CIRCUIT_BREAKERS})`);
-        }
-        circuitBreakers.set(safeName, new CircuitBreaker(config));
-    }
-    return circuitBreakers.get(safeName);
-}
-/**
- * Get all circuit breaker stats
- */
-export function getAllCircuitStats() {
-    const stats = {};
-    for (const [name, breaker] of circuitBreakers) {
-        stats[name] = breaker.getStats();
-    }
-    return stats;
-}
-/**
- * Reset all circuit breakers
- */
-export function resetAllCircuits() {
-    for (const breaker of circuitBreakers.values()) {
-        breaker.reset();
-    }
-}
-export default CircuitBreaker;
-//# sourceMappingURL=circuit-breaker.js.map

package/packages/@monomind/cli/dist/src/production/error-handler.d.ts

@@ -1,119 +0,0 @@
-/**
- * Production Error Handling
- *
- * Provides standardized error handling with:
- * - Error classification
- * - Sanitization (no sensitive data leak)
- * - Structured error responses
- * - Error aggregation and reporting
- *
- * @module @monomind/cli/production/error-handler
- */
-/**
- * Error category derived from message-pattern classification.
- */
-export type ErrorCategory = 'validation' | 'authentication' | 'authorization' | 'not_found' | 'rate_limit' | 'timeout' | 'circuit_open' | 'external_service' | 'internal' | 'unknown';
-/**
- * Configuration for the {@link ErrorHandler}.
- */
-export interface ErrorHandlerConfig {
-    /** Include stack traces in structured errors (default: off in production). */
-    includeStack: boolean;
-    /** Redact sensitive keys/values from context and messages. */
-    sanitize: boolean;
-    /** Whether errors should be forwarded to monitoring. */
-    reportToMonitoring: boolean;
-    /** Per-category cap before responses are rate-limited. */
-    maxErrorsPerMinute: number;
-    /** Optional per-category overrides. */
-    errorCategories: Record<string, unknown>;
-}
-/**
- * Contextual metadata attached to a handled error.
- */
-export interface ErrorContext {
-    /** The input that triggered the error (sanitized when handled). */
-    input?: unknown;
-    /** Arbitrary additional context fields. */
-    [key: string]: unknown;
-}
-/**
- * The error payload embedded in a structured error response.
- */
-export interface StructuredErrorPayload {
-    code: string;
-    message: string;
-    category: ErrorCategory;
-    retryable: boolean;
-    retryAfterMs?: number;
-    details?: {
-        stack: string;
-    };
-}
-/**
- * A standardized, structured error response.
- */
-export interface StructuredError {
-    success: false;
-    error: StructuredErrorPayload;
-    context: ErrorContext;
-    timestamp: string;
-}
-/**
- * Aggregated error statistics returned by {@link ErrorHandler.getStats}.
- */
-export interface ErrorStats {
-    totalErrors: number;
-    byCategory: Record<string, number>;
-    recentErrors: StructuredError[];
-    /** Errors per minute over the last 5 minutes. */
-    errorRate: number;
-}
-export declare class ErrorHandler {
-    private config;
-    private errorCounts;
-    private errorLog;
-    private maxLogSize;
-    constructor(config?: Partial<ErrorHandlerConfig>);
-    /**
-     * Classify an error into a category
-     */
-    classifyError(error: Error | string): ErrorCategory;
-    /**
-     * Check if an error category is retryable
-     */
-    isRetryable(category: ErrorCategory): boolean;
-    /**
-     * Sanitize input to remove sensitive data
-     * Cycle-safe and depth-bounded — circular references and deeply nested objects
-     * will not cause stack overflow.
-     */
-    sanitize(input: unknown, _seen?: WeakSet<object>, _depth?: number): unknown;
-    /**
-     * Handle an error and return a structured response
-     */
-    handle(error: Error | string, context?: ErrorContext): StructuredError;
-    /**
-     * Wrap a handler with error handling
-     */
-    wrap<TArgs extends unknown[], TResult>(handler: (...args: TArgs) => Promise<TResult>, context?: ErrorContext): (...args: TArgs) => Promise<TResult | StructuredError>;
-    /**
-     * Get error statistics
-     */
-    getStats(): ErrorStats;
-    /**
-     * Clear error log
-     */
-    clearLog(): void;
-    private getErrorCode;
-    private getRetryDelay;
-    private sanitizeMessage;
-    private trackError;
-    private logError;
-}
-/**
- * Wrap a handler with error handling (convenience function)
- */
-export declare function withErrorHandling<TArgs extends unknown[], TResult>(handler: (...args: TArgs) => Promise<TResult>, context?: ErrorContext): (...args: TArgs) => Promise<TResult | StructuredError>;
-export default ErrorHandler;
-//# sourceMappingURL=error-handler.d.ts.map