@kya-os/contracts 1.6.17 → 1.6.19

package/dist/reputation/constants.js

@@ -0,0 +1,259 @@
+"use strict";
+/**
+ * Reputation Engine Constants
+ *
+ * Configuration constants for the reputation scoring system.
+ * These values control the behavior of the Bayesian algorithm
+ * and define standard thresholds and limits.
+ *
+ * Related Spec: MCP-I §5.1 (Reputation), CLAUDE-reputation-engine.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REPUTATION_ALGORITHM_VERSION = exports.REPUTATION_CONTRACTS_VERSION = exports.CREDENTIAL_VALIDITY = exports.RATE_LIMITS = exports.CACHE_CONFIG = exports.PERFORMANCE_TARGETS = exports.EMPIRICAL_SCORE = exports.PROVISIONAL_THRESHOLDS = exports.CALCULATOR_PRESETS = exports.DEFAULT_WEIGHTS = exports.REPUTATION_THRESHOLDS = exports.CONFIDENCE_THRESHOLDS = exports.K_VALUES = exports.CREDENTIAL_BONUSES = exports.MCP_LEVEL_BONUSES = exports.PRIOR_SCORE = void 0;
+// ============================================================================
+// SCORING CONSTANTS
+// ============================================================================
+/**
+ * Prior score configuration
+ *
+ * Prior score represents the baseline reputation based on credentials
+ * before any empirical data (reviews, interactions) is considered.
+ */
+exports.PRIOR_SCORE = {
+    /** Base prior score for all agents */
+    BASE: 50,
+    /** Maximum achievable prior score */
+    MAX: 80,
+    /** Minimum prior score */
+    MIN: 50,
+};
+/**
+ * MCP Level bonuses to prior score
+ *
+ * Each MCP compliance level adds points to the prior score.
+ */
+exports.MCP_LEVEL_BONUSES = {
+    /** Level 0: No MCP compliance */
+    LEVEL_0: 0,
+    /** Level 1: Basic MCP compliance */
+    LEVEL_1: 5,
+    /** Level 2: Standard MCP compliance */
+    LEVEL_2: 10,
+    /** Level 3: Advanced MCP compliance */
+    LEVEL_3: 15,
+};
+/**
+ * Credential bonuses to prior score
+ *
+ * Each verified credential adds points to the prior score.
+ */
+exports.CREDENTIAL_BONUSES = {
+    /** Identity verification bonus */
+    IDENTITY_VERIFIED: 5,
+    /** Security audit passed bonus */
+    SECURITY_AUDIT: 7,
+    /** Open source bonus */
+    OPEN_SOURCE: 3,
+    /** GitHub verification bonus */
+    GITHUB_VERIFIED: 3,
+    /** Company email verification bonus */
+    COMPANY_EMAIL: 2,
+    /** Agent age > 365 days bonus */
+    AGE_OVER_YEAR: 5,
+};
+// ============================================================================
+// CONFIDENCE CALCULATION
+// ============================================================================
+/**
+ * K values for confidence calculation
+ *
+ * Confidence is calculated as: n / (n + k)
+ * where n is the number of interactions.
+ *
+ * Higher k = slower confidence growth (more conservative)
+ * Lower k = faster confidence growth (more aggressive)
+ */
+exports.K_VALUES = {
+    /** Testing preset: Fast confidence growth */
+    TESTING: 5,
+    /** Aggressive preset: Moderate confidence growth */
+    AGGRESSIVE: 10,
+    /** Conservative preset: Slow confidence growth (default) */
+    CONSERVATIVE: 20,
+    /** Default k value */
+    DEFAULT: 15,
+};
+/**
+ * Confidence level thresholds
+ */
+exports.CONFIDENCE_THRESHOLDS = {
+    /** Low confidence upper bound */
+    LOW: 0.25,
+    /** Medium confidence upper bound */
+    MEDIUM: 0.5,
+    /** High confidence upper bound */
+    HIGH: 0.75,
+    /** VeryHigh is anything above HIGH */
+};
+// ============================================================================
+// REPUTATION LEVEL THRESHOLDS
+// ============================================================================
+/**
+ * Reputation level score thresholds
+ *
+ * Maps numeric scores to human-readable reputation levels.
+ */
+exports.REPUTATION_THRESHOLDS = {
+    /** Poor: 0-29 */
+    POOR_MAX: 30,
+    /** Below Average: 30-44 */
+    BELOW_AVERAGE_MAX: 45,
+    /** Average: 45-59 */
+    AVERAGE_MAX: 60,
+    /** Good: 60-74 */
+    GOOD_MAX: 75,
+    /** Excellent: 75-89 */
+    EXCELLENT_MAX: 90,
+    /** Outstanding: 90-100 */
+};
+// ============================================================================
+// WEIGHT PRESETS
+// ============================================================================
+/**
+ * Default component weights
+ *
+ * How much each factor contributes to the empirical score.
+ */
+exports.DEFAULT_WEIGHTS = {
+    /** Weight for review-based scoring */
+    REVIEWS: 0.4,
+    /** Weight for interaction-based scoring */
+    INTERACTIONS: 0.3,
+    /** Weight for consistency metrics */
+    CONSISTENCY: 0.3,
+};
+/**
+ * Preset configurations
+ */
+exports.CALCULATOR_PRESETS = {
+    TESTING: {
+        kValue: exports.K_VALUES.TESTING,
+        weights: { ...exports.DEFAULT_WEIGHTS },
+        basePriorScore: exports.PRIOR_SCORE.BASE,
+        maxPriorScore: exports.PRIOR_SCORE.MAX,
+    },
+    CONSERVATIVE: {
+        kValue: exports.K_VALUES.CONSERVATIVE,
+        weights: { ...exports.DEFAULT_WEIGHTS },
+        basePriorScore: exports.PRIOR_SCORE.BASE,
+        maxPriorScore: exports.PRIOR_SCORE.MAX,
+    },
+    AGGRESSIVE: {
+        kValue: exports.K_VALUES.AGGRESSIVE,
+        weights: { ...exports.DEFAULT_WEIGHTS },
+        basePriorScore: exports.PRIOR_SCORE.BASE,
+        maxPriorScore: exports.PRIOR_SCORE.MAX,
+    },
+};
+// ============================================================================
+// PROVISIONAL SCORE THRESHOLDS
+// ============================================================================
+/**
+ * Thresholds for determining provisional scores
+ *
+ * A score is provisional when there isn't enough data
+ * for confident assessment.
+ */
+exports.PROVISIONAL_THRESHOLDS = {
+    /** Minimum interactions for non-provisional */
+    MIN_INTERACTIONS: 5,
+    /** Minimum reviews for non-provisional */
+    MIN_REVIEWS: 3,
+    /** Minimum confidence for non-provisional */
+    MIN_CONFIDENCE: 0.25,
+};
+// ============================================================================
+// EMPIRICAL SCORE CALCULATION
+// ============================================================================
+/**
+ * Empirical score calculation constants
+ */
+exports.EMPIRICAL_SCORE = {
+    /** Default score when no reviews exist */
+    DEFAULT_NO_REVIEWS: 50,
+    /** Minimum average rating */
+    MIN_RATING: 1.0,
+    /** Maximum average rating */
+    MAX_RATING: 5.0,
+    /** Rating to score multiplier: score = (rating - 1) * 25 */
+    RATING_MULTIPLIER: 25,
+};
+// ============================================================================
+// PERFORMANCE TARGETS
+// ============================================================================
+/**
+ * Performance targets for reputation calculation
+ */
+exports.PERFORMANCE_TARGETS = {
+    /** Target time for single agent calculation (ms) */
+    SINGLE_AGENT_MS: 1,
+    /** Target time for batch of 1000 agents (ms) */
+    BATCH_1000_MS: 100,
+    /** Target time in browser/WASM (ms) */
+    WASM_SINGLE_MS: 5,
+};
+// ============================================================================
+// CACHING
+// ============================================================================
+/**
+ * Cache configuration
+ */
+exports.CACHE_CONFIG = {
+    /** Default cache TTL in seconds */
+    DEFAULT_TTL_SECONDS: 300,
+    /** Maximum cache TTL in seconds */
+    MAX_TTL_SECONDS: 3600,
+    /** Stale-while-revalidate window in seconds */
+    SWR_SECONDS: 60,
+};
+// ============================================================================
+// RATE LIMITING
+// ============================================================================
+/**
+ * Rate limiting configuration
+ */
+exports.RATE_LIMITS = {
+    /** Requests per minute for single calculations */
+    SINGLE_CALCULATE_RPM: 100,
+    /** Requests per minute for batch calculations */
+    BATCH_CALCULATE_RPM: 10,
+    /** Maximum batch size */
+    MAX_BATCH_SIZE: 1000,
+};
+// ============================================================================
+// CREDENTIAL VALIDITY
+// ============================================================================
+/**
+ * Reputation credential validity periods
+ */
+exports.CREDENTIAL_VALIDITY = {
+    /** Default validity period in milliseconds (7 days) */
+    DEFAULT_MS: 7 * 24 * 60 * 60 * 1000,
+    /** Minimum validity period in milliseconds (1 hour) */
+    MIN_MS: 60 * 60 * 1000,
+    /** Maximum validity period in milliseconds (30 days) */
+    MAX_MS: 30 * 24 * 60 * 60 * 1000,
+    /** Recommended freshness for scores (24 hours) */
+    RECOMMENDED_FRESHNESS_MS: 24 * 60 * 60 * 1000,
+};
+// ============================================================================
+// VERSION
+// ============================================================================
+/**
+ * Reputation contracts version
+ */
+exports.REPUTATION_CONTRACTS_VERSION = "1.0.0";
+/**
+ * Reputation algorithm version
+ */
+exports.REPUTATION_ALGORITHM_VERSION = "1.0.0-bayesian";