@kya-os/cli 2.0.0 → 2.0.2

package/node_modules/@kya-os/contracts/dist/reputation/schemas.d.ts

@@ -0,0 +1,1600 @@
+/**
+ * Reputation Engine Schemas
+ *
+ * Zod schemas and TypeScript types for the Bayesian reputation scoring system.
+ * These schemas define the data structures for agent reputation calculation,
+ * including input data, score outputs, and configuration options.
+ *
+ * The reputation system uses a Bayesian approach:
+ *   final_score = (1 - confidence) × prior_score + confidence × empirical_score
+ *
+ * Related Spec: MCP-I §5.1 (Reputation), CLAUDE-reputation-engine.md
+ */
+import { z } from "zod";
+/**
+ * MCP Compliance Level
+ *
+ * Levels 0-3 representing increasing levels of MCP compliance:
+ * - 0: No MCP compliance
+ * - 1: Basic MCP compliance (+5 prior points)
+ * - 2: Standard MCP compliance (+10 prior points)
+ * - 3: Advanced MCP compliance (+15 prior points)
+ */
+export declare const MCPLevelSchema: z.ZodNumber;
+export type MCPLevel = z.infer<typeof MCPLevelSchema>;
+/**
+ * Credential Flags Schema
+ *
+ * Boolean flags representing various verified credentials and certifications.
+ * Each flag contributes to the prior score calculation.
+ */
+export declare const CredentialFlagsSchema: z.ZodObject<{
+    /** Identity has been verified through a trusted provider */
+    identityVerified: z.ZodDefault<z.ZodBoolean>;
+    /** Agent has passed a security audit */
+    securityAuditPassed: z.ZodDefault<z.ZodBoolean>;
+    /** Agent source code is open source */
+    openSource: z.ZodDefault<z.ZodBoolean>;
+    /** GitHub account is verified */
+    githubVerified: z.ZodDefault<z.ZodBoolean>;
+    /** Company email has been verified */
+    companyEmailVerified: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    identityVerified: boolean;
+    securityAuditPassed: boolean;
+    openSource: boolean;
+    githubVerified: boolean;
+    companyEmailVerified: boolean;
+}, {
+    identityVerified?: boolean | undefined;
+    securityAuditPassed?: boolean | undefined;
+    openSource?: boolean | undefined;
+    githubVerified?: boolean | undefined;
+    companyEmailVerified?: boolean | undefined;
+}>;
+export type CredentialFlags = z.infer<typeof CredentialFlagsSchema>;
+/**
+ * Interaction Metrics Schema
+ *
+ * Quantitative metrics about an agent's interactions with other agents/users.
+ * Used in calculating empirical score and confidence level.
+ */
+export declare const InteractionMetricsSchema: z.ZodObject<{
+    /** Total number of interactions */
+    totalInteractions: z.ZodDefault<z.ZodNumber>;
+    /** Number of successful interactions */
+    successfulInteractions: z.ZodDefault<z.ZodNumber>;
+    /** Number of failed interactions */
+    failedInteractions: z.ZodDefault<z.ZodNumber>;
+    /** Number of unique interaction partners */
+    uniquePartners: z.ZodDefault<z.ZodNumber>;
+    /** Total transaction/interaction volume (monetary or unit-based) */
+    totalVolume: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    totalInteractions: number;
+    successfulInteractions: number;
+    failedInteractions: number;
+    uniquePartners: number;
+    totalVolume: number;
+}, {
+    totalInteractions?: number | undefined;
+    successfulInteractions?: number | undefined;
+    failedInteractions?: number | undefined;
+    uniquePartners?: number | undefined;
+    totalVolume?: number | undefined;
+}>;
+export type InteractionMetrics = z.infer<typeof InteractionMetricsSchema>;
+/**
+ * Review Metrics Schema
+ *
+ * Metrics derived from user/agent reviews.
+ * Primary source for empirical score calculation.
+ */
+export declare const ReviewMetricsSchema: z.ZodObject<{
+    /** Total number of reviews received */
+    totalReviews: z.ZodDefault<z.ZodNumber>;
+    /** Average rating (1.0 to 5.0 scale) */
+    averageRating: z.ZodOptional<z.ZodNumber>;
+    /** Number of positive reviews (4+ stars) */
+    positiveReviews: z.ZodDefault<z.ZodNumber>;
+    /** Number of negative reviews (2 or fewer stars) */
+    negativeReviews: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    totalReviews: number;
+    positiveReviews: number;
+    negativeReviews: number;
+    averageRating?: number | undefined;
+}, {
+    totalReviews?: number | undefined;
+    averageRating?: number | undefined;
+    positiveReviews?: number | undefined;
+    negativeReviews?: number | undefined;
+}>;
+export type ReviewMetrics = z.infer<typeof ReviewMetricsSchema>;
+/**
+ * Issue Metrics Schema
+ *
+ * Metrics related to disputes, abuse reports, and other issues.
+ * Negatively impacts reputation score.
+ */
+export declare const IssueMetricsSchema: z.ZodObject<{
+    /** Number of disputes filed against this agent */
+    disputesFiled: z.ZodDefault<z.ZodNumber>;
+    /** Number of disputes lost (decided against this agent) */
+    disputesLost: z.ZodDefault<z.ZodNumber>;
+    /** Number of verified abuse reports */
+    abuseReportsVerified: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    disputesFiled: number;
+    disputesLost: number;
+    abuseReportsVerified: number;
+}, {
+    disputesFiled?: number | undefined;
+    disputesLost?: number | undefined;
+    abuseReportsVerified?: number | undefined;
+}>;
+export type IssueMetrics = z.infer<typeof IssueMetricsSchema>;
+/**
+ * Agent Data Schema
+ *
+ * Complete input data structure for reputation calculation.
+ * Combines identity, credentials, interactions, reviews, and issues.
+ *
+ * This is the primary input to the reputation calculation engine.
+ */
+export declare const AgentDataSchema: z.ZodObject<{
+    /** Decentralized Identifier (DID) of the agent */
+    did: z.ZodEffects<z.ZodString, string, string>;
+    /** Timestamp when the agent was registered (ISO 8601) */
+    createdAt: z.ZodOptional<z.ZodString>;
+    /** MCP compliance level (0-3) */
+    mcpLevel: z.ZodDefault<z.ZodNumber>;
+    /** Credential flags */
+    credentials: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        /** Identity has been verified through a trusted provider */
+        identityVerified: z.ZodDefault<z.ZodBoolean>;
+        /** Agent has passed a security audit */
+        securityAuditPassed: z.ZodDefault<z.ZodBoolean>;
+        /** Agent source code is open source */
+        openSource: z.ZodDefault<z.ZodBoolean>;
+        /** GitHub account is verified */
+        githubVerified: z.ZodDefault<z.ZodBoolean>;
+        /** Company email has been verified */
+        companyEmailVerified: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        identityVerified: boolean;
+        securityAuditPassed: boolean;
+        openSource: boolean;
+        githubVerified: boolean;
+        companyEmailVerified: boolean;
+    }, {
+        identityVerified?: boolean | undefined;
+        securityAuditPassed?: boolean | undefined;
+        openSource?: boolean | undefined;
+        githubVerified?: boolean | undefined;
+        companyEmailVerified?: boolean | undefined;
+    }>>>;
+    /** Interaction metrics */
+    interactions: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        /** Total number of interactions */
+        totalInteractions: z.ZodDefault<z.ZodNumber>;
+        /** Number of successful interactions */
+        successfulInteractions: z.ZodDefault<z.ZodNumber>;
+        /** Number of failed interactions */
+        failedInteractions: z.ZodDefault<z.ZodNumber>;
+        /** Number of unique interaction partners */
+        uniquePartners: z.ZodDefault<z.ZodNumber>;
+        /** Total transaction/interaction volume (monetary or unit-based) */
+        totalVolume: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        totalInteractions: number;
+        successfulInteractions: number;
+        failedInteractions: number;
+        uniquePartners: number;
+        totalVolume: number;
+    }, {
+        totalInteractions?: number | undefined;
+        successfulInteractions?: number | undefined;
+        failedInteractions?: number | undefined;
+        uniquePartners?: number | undefined;
+        totalVolume?: number | undefined;
+    }>>>;
+    /** Review metrics */
+    reviews: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        /** Total number of reviews received */
+        totalReviews: z.ZodDefault<z.ZodNumber>;
+        /** Average rating (1.0 to 5.0 scale) */
+        averageRating: z.ZodOptional<z.ZodNumber>;
+        /** Number of positive reviews (4+ stars) */
+        positiveReviews: z.ZodDefault<z.ZodNumber>;
+        /** Number of negative reviews (2 or fewer stars) */
+        negativeReviews: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        totalReviews: number;
+        positiveReviews: number;
+        negativeReviews: number;
+        averageRating?: number | undefined;
+    }, {
+        totalReviews?: number | undefined;
+        averageRating?: number | undefined;
+        positiveReviews?: number | undefined;
+        negativeReviews?: number | undefined;
+    }>>>;
+    /** Issue metrics */
+    issues: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        /** Number of disputes filed against this agent */
+        disputesFiled: z.ZodDefault<z.ZodNumber>;
+        /** Number of disputes lost (decided against this agent) */
+        disputesLost: z.ZodDefault<z.ZodNumber>;
+        /** Number of verified abuse reports */
+        abuseReportsVerified: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        disputesFiled: number;
+        disputesLost: number;
+        abuseReportsVerified: number;
+    }, {
+        disputesFiled?: number | undefined;
+        disputesLost?: number | undefined;
+        abuseReportsVerified?: number | undefined;
+    }>>>;
+    /** Optional metadata for custom extensions */
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    issues: {
+        disputesFiled: number;
+        disputesLost: number;
+        abuseReportsVerified: number;
+    };
+    did: string;
+    mcpLevel: number;
+    credentials: {
+        identityVerified: boolean;
+        securityAuditPassed: boolean;
+        openSource: boolean;
+        githubVerified: boolean;
+        companyEmailVerified: boolean;
+    };
+    interactions: {
+        totalInteractions: number;
+        successfulInteractions: number;
+        failedInteractions: number;
+        uniquePartners: number;
+        totalVolume: number;
+    };
+    reviews: {
+        totalReviews: number;
+        positiveReviews: number;
+        negativeReviews: number;
+        averageRating?: number | undefined;
+    };
+    metadata?: Record<string, unknown> | undefined;
+    createdAt?: string | undefined;
+}, {
+    did: string;
+    issues?: {
+        disputesFiled?: number | undefined;
+        disputesLost?: number | undefined;
+        abuseReportsVerified?: number | undefined;
+    } | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    createdAt?: string | undefined;
+    mcpLevel?: number | undefined;
+    credentials?: {
+        identityVerified?: boolean | undefined;
+        securityAuditPassed?: boolean | undefined;
+        openSource?: boolean | undefined;
+        githubVerified?: boolean | undefined;
+        companyEmailVerified?: boolean | undefined;
+    } | undefined;
+    interactions?: {
+        totalInteractions?: number | undefined;
+        successfulInteractions?: number | undefined;
+        failedInteractions?: number | undefined;
+        uniquePartners?: number | undefined;
+        totalVolume?: number | undefined;
+    } | undefined;
+    reviews?: {
+        totalReviews?: number | undefined;
+        averageRating?: number | undefined;
+        positiveReviews?: number | undefined;
+        negativeReviews?: number | undefined;
+    } | undefined;
+}>;
+export type AgentData = z.infer<typeof AgentDataSchema>;
+/**
+ * Partial Agent Data Schema
+ *
+ * For updates and partial data scenarios.
+ * All fields are optional except DID.
+ */
+export declare const PartialAgentDataSchema: z.ZodObject<{
+    createdAt: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    mcpLevel: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    credentials: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        /** Identity has been verified through a trusted provider */
+        identityVerified: z.ZodDefault<z.ZodBoolean>;
+        /** Agent has passed a security audit */
+        securityAuditPassed: z.ZodDefault<z.ZodBoolean>;
+        /** Agent source code is open source */
+        openSource: z.ZodDefault<z.ZodBoolean>;
+        /** GitHub account is verified */
+        githubVerified: z.ZodDefault<z.ZodBoolean>;
+        /** Company email has been verified */
+        companyEmailVerified: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        identityVerified: boolean;
+        securityAuditPassed: boolean;
+        openSource: boolean;
+        githubVerified: boolean;
+        companyEmailVerified: boolean;
+    }, {
+        identityVerified?: boolean | undefined;
+        securityAuditPassed?: boolean | undefined;
+        openSource?: boolean | undefined;
+        githubVerified?: boolean | undefined;
+        companyEmailVerified?: boolean | undefined;
+    }>>>>;
+    interactions: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        /** Total number of interactions */
+        totalInteractions: z.ZodDefault<z.ZodNumber>;
+        /** Number of successful interactions */
+        successfulInteractions: z.ZodDefault<z.ZodNumber>;
+        /** Number of failed interactions */
+        failedInteractions: z.ZodDefault<z.ZodNumber>;
+        /** Number of unique interaction partners */
+        uniquePartners: z.ZodDefault<z.ZodNumber>;
+        /** Total transaction/interaction volume (monetary or unit-based) */
+        totalVolume: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        totalInteractions: number;
+        successfulInteractions: number;
+        failedInteractions: number;
+        uniquePartners: number;
+        totalVolume: number;
+    }, {
+        totalInteractions?: number | undefined;
+        successfulInteractions?: number | undefined;
+        failedInteractions?: number | undefined;
+        uniquePartners?: number | undefined;
+        totalVolume?: number | undefined;
+    }>>>>;
+    reviews: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        /** Total number of reviews received */
+        totalReviews: z.ZodDefault<z.ZodNumber>;
+        /** Average rating (1.0 to 5.0 scale) */
+        averageRating: z.ZodOptional<z.ZodNumber>;
+        /** Number of positive reviews (4+ stars) */
+        positiveReviews: z.ZodDefault<z.ZodNumber>;
+        /** Number of negative reviews (2 or fewer stars) */
+        negativeReviews: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        totalReviews: number;
+        positiveReviews: number;
+        negativeReviews: number;
+        averageRating?: number | undefined;
+    }, {
+        totalReviews?: number | undefined;
+        averageRating?: number | undefined;
+        positiveReviews?: number | undefined;
+        negativeReviews?: number | undefined;
+    }>>>>;
+    issues: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        /** Number of disputes filed against this agent */
+        disputesFiled: z.ZodDefault<z.ZodNumber>;
+        /** Number of disputes lost (decided against this agent) */
+        disputesLost: z.ZodDefault<z.ZodNumber>;
+        /** Number of verified abuse reports */
+        abuseReportsVerified: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        disputesFiled: number;
+        disputesLost: number;
+        abuseReportsVerified: number;
+    }, {
+        disputesFiled?: number | undefined;
+        disputesLost?: number | undefined;
+        abuseReportsVerified?: number | undefined;
+    }>>>>;
+    metadata: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+} & {
+    did: z.ZodEffects<z.ZodString, string, string>;
+}, "strip", z.ZodTypeAny, {
+    did: string;
+    issues?: {
+        disputesFiled: number;
+        disputesLost: number;
+        abuseReportsVerified: number;
+    } | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    createdAt?: string | undefined;
+    mcpLevel?: number | undefined;
+    credentials?: {
+        identityVerified: boolean;
+        securityAuditPassed: boolean;
+        openSource: boolean;
+        githubVerified: boolean;
+        companyEmailVerified: boolean;
+    } | undefined;
+    interactions?: {
+        totalInteractions: number;
+        successfulInteractions: number;
+        failedInteractions: number;
+        uniquePartners: number;
+        totalVolume: number;
+    } | undefined;
+    reviews?: {
+        totalReviews: number;
+        positiveReviews: number;
+        negativeReviews: number;
+        averageRating?: number | undefined;
+    } | undefined;
+}, {
+    did: string;
+    issues?: {
+        disputesFiled?: number | undefined;
+        disputesLost?: number | undefined;
+        abuseReportsVerified?: number | undefined;
+    } | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    createdAt?: string | undefined;
+    mcpLevel?: number | undefined;
+    credentials?: {
+        identityVerified?: boolean | undefined;
+        securityAuditPassed?: boolean | undefined;
+        openSource?: boolean | undefined;
+        githubVerified?: boolean | undefined;
+        companyEmailVerified?: boolean | undefined;
+    } | undefined;
+    interactions?: {
+        totalInteractions?: number | undefined;
+        successfulInteractions?: number | undefined;
+        failedInteractions?: number | undefined;
+        uniquePartners?: number | undefined;
+        totalVolume?: number | undefined;
+    } | undefined;
+    reviews?: {
+        totalReviews?: number | undefined;
+        averageRating?: number | undefined;
+        positiveReviews?: number | undefined;
+        negativeReviews?: number | undefined;
+    } | undefined;
+}>;
+export type PartialAgentData = z.infer<typeof PartialAgentDataSchema>;
+/**
+ * Score Components Schema (Bayesian Algorithm)
+ *
+ * Breakdown of how the final score was calculated using the Bayesian algorithm.
+ * Provides transparency into the scoring algorithm.
+ *
+ * Formula: final_score = (1 - confidence) × prior_score + confidence × empirical_score
+ */
+export declare const ScoreComponentsSchema: z.ZodObject<{
+    /** Prior score based on credentials (50-80 points) */
+    priorScore: z.ZodNumber;
+    /** Empirical score based on interactions and reviews (0-100 points) */
+    empiricalScore: z.ZodNumber;
+    /** Weight applied to confidence (derived from interactions) */
+    confidenceWeight: z.ZodNumber;
+    /** Weight applied to prior (1 - confidenceWeight) */
+    priorWeight: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    priorScore: number;
+    empiricalScore: number;
+    confidenceWeight: number;
+    priorWeight: number;
+}, {
+    priorScore: number;
+    empiricalScore: number;
+    confidenceWeight: number;
+    priorWeight: number;
+}>;
+export type ScoreComponents = z.infer<typeof ScoreComponentsSchema>;
+/**
+ * Reputation Factors Schema
+ *
+ * Detailed breakdown of factors contributing to the reputation score.
+ * This provides a human-readable explanation of why an agent has a particular score.
+ *
+ * Compatible with Know That AI API response format.
+ */
+export declare const ReputationFactorsSchema: z.ZodObject<{
+    /** Score based on successful vs failed interactions (0-100) */
+    interactionScore: z.ZodNumber;
+    /** Score based on consistency of behavior over time (0-100) */
+    consistencyScore: z.ZodNumber;
+    /** Score based on account age / longevity (0-100) */
+    longevityScore: z.ZodNumber;
+    /** Score based on diversity of interaction partners (0-100) */
+    partnerDiversityScore: z.ZodNumber;
+    /** Score based on positive feedback received (0-100) */
+    feedbackScore: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    interactionScore: number;
+    consistencyScore: number;
+    longevityScore: number;
+    partnerDiversityScore: number;
+    feedbackScore: number;
+}, {
+    interactionScore: number;
+    consistencyScore: number;
+    longevityScore: number;
+    partnerDiversityScore: number;
+    feedbackScore: number;
+}>;
+export type ReputationFactors = z.infer<typeof ReputationFactorsSchema>;
+/**
+ * Confidence Level Schema
+ *
+ * Human-readable confidence categories.
+ */
+export declare const ConfidenceLevelSchema: z.ZodEnum<["Low", "Medium", "High", "VeryHigh"]>;
+export type ConfidenceLevel = z.infer<typeof ConfidenceLevelSchema>;
+/**
+ * Reputation Level Schema (Detailed)
+ *
+ * Human-readable reputation categories based on score ranges.
+ * Uses granular levels for detailed reputation assessment.
+ */
+export declare const ReputationLevelSchema: z.ZodEnum<["Unknown", "Poor", "BelowAverage", "Average", "Good", "Excellent", "Outstanding"]>;
+export type ReputationLevel = z.infer<typeof ReputationLevelSchema>;
+/**
+ * Simple Reputation Level Schema
+ *
+ * Human-readable reputation categories matching Know That AI API.
+ * Uses 5-tier levels for simplified reputation display.
+ */
+export declare const SimpleReputationLevelSchema: z.ZodEnum<["Very Low", "Low", "Medium", "High", "Very High"]>;
+export type SimpleReputationLevel = z.infer<typeof SimpleReputationLevelSchema>;
+/**
+ * Convert detailed ReputationLevel to SimpleReputationLevel
+ *
+ * Maps the 7-tier detailed levels to the 5-tier simple levels.
+ */
+export declare function toSimpleReputationLevel(level: ReputationLevel): SimpleReputationLevel;
+/**
+ * Get simple reputation level from numeric score
+ *
+ * @param score - Numeric score (0-100)
+ * @returns Simple reputation level
+ */
+export declare function getSimpleReputationLevel(score: number): SimpleReputationLevel;
+/**
+ * Reputation Score Schema
+ *
+ * Complete output from the reputation calculation engine.
+ * Includes the final score, confidence metrics, and component breakdown.
+ */
+export declare const ReputationScoreSchema: z.ZodObject<{
+    /** Final reputation score (0-100) */
+    score: z.ZodNumber;
+    /** Confidence in the score (0-1) */
+    confidence: z.ZodNumber;
+    /** Human-readable confidence level */
+    confidenceLevel: z.ZodEnum<["Low", "Medium", "High", "VeryHigh"]>;
+    /** Human-readable reputation level */
+    level: z.ZodEnum<["Unknown", "Poor", "BelowAverage", "Average", "Good", "Excellent", "Outstanding"]>;
+    /** Detailed score component breakdown (Bayesian algorithm) */
+    components: z.ZodObject<{
+        /** Prior score based on credentials (50-80 points) */
+        priorScore: z.ZodNumber;
+        /** Empirical score based on interactions and reviews (0-100 points) */
+        empiricalScore: z.ZodNumber;
+        /** Weight applied to confidence (derived from interactions) */
+        confidenceWeight: z.ZodNumber;
+        /** Weight applied to prior (1 - confidenceWeight) */
+        priorWeight: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        priorScore: number;
+        empiricalScore: number;
+        confidenceWeight: number;
+        priorWeight: number;
+    }, {
+        priorScore: number;
+        empiricalScore: number;
+        confidenceWeight: number;
+        priorWeight: number;
+    }>;
+    /** Optional detailed factors breakdown (for Know That AI API compatibility) */
+    factors: z.ZodOptional<z.ZodObject<{
+        /** Score based on successful vs failed interactions (0-100) */
+        interactionScore: z.ZodNumber;
+        /** Score based on consistency of behavior over time (0-100) */
+        consistencyScore: z.ZodNumber;
+        /** Score based on account age / longevity (0-100) */
+        longevityScore: z.ZodNumber;
+        /** Score based on diversity of interaction partners (0-100) */
+        partnerDiversityScore: z.ZodNumber;
+        /** Score based on positive feedback received (0-100) */
+        feedbackScore: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        interactionScore: number;
+        consistencyScore: number;
+        longevityScore: number;
+        partnerDiversityScore: number;
+        feedbackScore: number;
+    }, {
+        interactionScore: number;
+        consistencyScore: number;
+        longevityScore: number;
+        partnerDiversityScore: number;
+        feedbackScore: number;
+    }>>;
+    /** Whether this score is provisional (limited data) */
+    isProvisional: z.ZodBoolean;
+    /** Timestamp when the score was calculated (ISO 8601) */
+    calculatedAt: z.ZodString;
+    /** DID of the agent this score belongs to */
+    agentDid: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    agentDid: string;
+    confidence: number;
+    score: number;
+    confidenceLevel: "Low" | "Medium" | "High" | "VeryHigh";
+    level: "Unknown" | "Poor" | "BelowAverage" | "Average" | "Good" | "Excellent" | "Outstanding";
+    components: {
+        priorScore: number;
+        empiricalScore: number;
+        confidenceWeight: number;
+        priorWeight: number;
+    };
+    isProvisional: boolean;
+    calculatedAt: string;
+    factors?: {
+        interactionScore: number;
+        consistencyScore: number;
+        longevityScore: number;
+        partnerDiversityScore: number;
+        feedbackScore: number;
+    } | undefined;
+}, {
+    agentDid: string;
+    confidence: number;
+    score: number;
+    confidenceLevel: "Low" | "Medium" | "High" | "VeryHigh";
+    level: "Unknown" | "Poor" | "BelowAverage" | "Average" | "Good" | "Excellent" | "Outstanding";
+    components: {
+        priorScore: number;
+        empiricalScore: number;
+        confidenceWeight: number;
+        priorWeight: number;
+    };
+    isProvisional: boolean;
+    calculatedAt: string;
+    factors?: {
+        interactionScore: number;
+        consistencyScore: number;
+        longevityScore: number;
+        partnerDiversityScore: number;
+        feedbackScore: number;
+    } | undefined;
+}>;
+export type ReputationScore = z.infer<typeof ReputationScoreSchema>;
+/**
+ * Calculator Preset Schema
+ *
+ * Pre-defined calculator configurations for different use cases.
+ */
+export declare const CalculatorPresetSchema: z.ZodEnum<["Testing", "Conservative", "Aggressive"]>;
+export type CalculatorPreset = z.infer<typeof CalculatorPresetSchema>;
+/**
+ * Calculator Weights Schema
+ *
+ * Weight distribution for scoring components.
+ * All weights should sum to 1.0.
+ */
+export declare const CalculatorWeightsSchema: z.ZodEffects<z.ZodObject<{
+    /** Weight for review-based scoring */
+    reviews: z.ZodDefault<z.ZodNumber>;
+    /** Weight for interaction-based scoring */
+    interactions: z.ZodDefault<z.ZodNumber>;
+    /** Weight for consistency metrics */
+    consistency: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    interactions: number;
+    reviews: number;
+    consistency: number;
+}, {
+    interactions?: number | undefined;
+    reviews?: number | undefined;
+    consistency?: number | undefined;
+}>, {
+    interactions: number;
+    reviews: number;
+    consistency: number;
+}, {
+    interactions?: number | undefined;
+    reviews?: number | undefined;
+    consistency?: number | undefined;
+}>;
+export type CalculatorWeights = z.infer<typeof CalculatorWeightsSchema>;
+/**
+ * Calculator Config Schema
+ *
+ * Configuration options for the reputation calculator.
+ */
+export declare const CalculatorConfigSchema: z.ZodObject<{
+    /** K value for confidence calculation: confidence = n / (n + k) */
+    kValue: z.ZodDefault<z.ZodNumber>;
+    /** Optional preset (overrides other settings) */
+    preset: z.ZodOptional<z.ZodEnum<["Testing", "Conservative", "Aggressive"]>>;
+    /** Component weights */
+    weights: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        /** Weight for review-based scoring */
+        reviews: z.ZodDefault<z.ZodNumber>;
+        /** Weight for interaction-based scoring */
+        interactions: z.ZodDefault<z.ZodNumber>;
+        /** Weight for consistency metrics */
+        consistency: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        interactions: number;
+        reviews: number;
+        consistency: number;
+    }, {
+        interactions?: number | undefined;
+        reviews?: number | undefined;
+        consistency?: number | undefined;
+    }>, {
+        interactions: number;
+        reviews: number;
+        consistency: number;
+    }, {
+        interactions?: number | undefined;
+        reviews?: number | undefined;
+        consistency?: number | undefined;
+    }>>;
+    /** Base prior score (default: 50) */
+    basePriorScore: z.ZodDefault<z.ZodNumber>;
+    /** Maximum prior score (default: 80) */
+    maxPriorScore: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    kValue: number;
+    basePriorScore: number;
+    maxPriorScore: number;
+    preset?: "Testing" | "Conservative" | "Aggressive" | undefined;
+    weights?: {
+        interactions: number;
+        reviews: number;
+        consistency: number;
+    } | undefined;
+}, {
+    kValue?: number | undefined;
+    preset?: "Testing" | "Conservative" | "Aggressive" | undefined;
+    weights?: {
+        interactions?: number | undefined;
+        reviews?: number | undefined;
+        consistency?: number | undefined;
+    } | undefined;
+    basePriorScore?: number | undefined;
+    maxPriorScore?: number | undefined;
+}>;
+export type CalculatorConfig = z.infer<typeof CalculatorConfigSchema>;
+/**
+ * Score Change Prediction Schema
+ *
+ * Input for predicting how a score would change given hypothetical changes.
+ */
+export declare const ScoreChangePredictionRequestSchema: z.ZodObject<{
+    /** Current agent data */
+    current: z.ZodObject<{
+        /** Decentralized Identifier (DID) of the agent */
+        did: z.ZodEffects<z.ZodString, string, string>;
+        /** Timestamp when the agent was registered (ISO 8601) */
+        createdAt: z.ZodOptional<z.ZodString>;
+        /** MCP compliance level (0-3) */
+        mcpLevel: z.ZodDefault<z.ZodNumber>;
+        /** Credential flags */
+        credentials: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            /** Identity has been verified through a trusted provider */
+            identityVerified: z.ZodDefault<z.ZodBoolean>;
+            /** Agent has passed a security audit */
+            securityAuditPassed: z.ZodDefault<z.ZodBoolean>;
+            /** Agent source code is open source */
+            openSource: z.ZodDefault<z.ZodBoolean>;
+            /** GitHub account is verified */
+            githubVerified: z.ZodDefault<z.ZodBoolean>;
+            /** Company email has been verified */
+            companyEmailVerified: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            identityVerified: boolean;
+            securityAuditPassed: boolean;
+            openSource: boolean;
+            githubVerified: boolean;
+            companyEmailVerified: boolean;
+        }, {
+            identityVerified?: boolean | undefined;
+            securityAuditPassed?: boolean | undefined;
+            openSource?: boolean | undefined;
+            githubVerified?: boolean | undefined;
+            companyEmailVerified?: boolean | undefined;
+        }>>>;
+        /** Interaction metrics */
+        interactions: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            /** Total number of interactions */
+            totalInteractions: z.ZodDefault<z.ZodNumber>;
+            /** Number of successful interactions */
+            successfulInteractions: z.ZodDefault<z.ZodNumber>;
+            /** Number of failed interactions */
+            failedInteractions: z.ZodDefault<z.ZodNumber>;
+            /** Number of unique interaction partners */
+            uniquePartners: z.ZodDefault<z.ZodNumber>;
+            /** Total transaction/interaction volume (monetary or unit-based) */
+            totalVolume: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            totalInteractions: number;
+            successfulInteractions: number;
+            failedInteractions: number;
+            uniquePartners: number;
+            totalVolume: number;
+        }, {
+            totalInteractions?: number | undefined;
+            successfulInteractions?: number | undefined;
+            failedInteractions?: number | undefined;
+            uniquePartners?: number | undefined;
+            totalVolume?: number | undefined;
+        }>>>;
+        /** Review metrics */
+        reviews: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            /** Total number of reviews received */
+            totalReviews: z.ZodDefault<z.ZodNumber>;
+            /** Average rating (1.0 to 5.0 scale) */
+            averageRating: z.ZodOptional<z.ZodNumber>;
+            /** Number of positive reviews (4+ stars) */
+            positiveReviews: z.ZodDefault<z.ZodNumber>;
+            /** Number of negative reviews (2 or fewer stars) */
+            negativeReviews: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            totalReviews: number;
+            positiveReviews: number;
+            negativeReviews: number;
+            averageRating?: number | undefined;
+        }, {
+            totalReviews?: number | undefined;
+            averageRating?: number | undefined;
+            positiveReviews?: number | undefined;
+            negativeReviews?: number | undefined;
+        }>>>;
+        /** Issue metrics */
+        issues: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            /** Number of disputes filed against this agent */
+            disputesFiled: z.ZodDefault<z.ZodNumber>;
+            /** Number of disputes lost (decided against this agent) */
+            disputesLost: z.ZodDefault<z.ZodNumber>;
+            /** Number of verified abuse reports */
+            abuseReportsVerified: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            disputesFiled: number;
+            disputesLost: number;
+            abuseReportsVerified: number;
+        }, {
+            disputesFiled?: number | undefined;
+            disputesLost?: number | undefined;
+            abuseReportsVerified?: number | undefined;
+        }>>>;
+        /** Optional metadata for custom extensions */
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        issues: {
+            disputesFiled: number;
+            disputesLost: number;
+            abuseReportsVerified: number;
+        };
+        did: string;
+        mcpLevel: number;
+        credentials: {
+            identityVerified: boolean;
+            securityAuditPassed: boolean;
+            openSource: boolean;
+            githubVerified: boolean;
+            companyEmailVerified: boolean;
+        };
+        interactions: {
+            totalInteractions: number;
+            successfulInteractions: number;
+            failedInteractions: number;
+            uniquePartners: number;
+            totalVolume: number;
+        };
+        reviews: {
+            totalReviews: number;
+            positiveReviews: number;
+            negativeReviews: number;
+            averageRating?: number | undefined;
+        };
+        metadata?: Record<string, unknown> | undefined;
+        createdAt?: string | undefined;
+    }, {
+        did: string;
+        issues?: {
+            disputesFiled?: number | undefined;
+            disputesLost?: number | undefined;
+            abuseReportsVerified?: number | undefined;
+        } | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        createdAt?: string | undefined;
+        mcpLevel?: number | undefined;
+        credentials?: {
+            identityVerified?: boolean | undefined;
+            securityAuditPassed?: boolean | undefined;
+            openSource?: boolean | undefined;
+            githubVerified?: boolean | undefined;
+            companyEmailVerified?: boolean | undefined;
+        } | undefined;
+        interactions?: {
+            totalInteractions?: number | undefined;
+            successfulInteractions?: number | undefined;
+            failedInteractions?: number | undefined;
+            uniquePartners?: number | undefined;
+            totalVolume?: number | undefined;
+        } | undefined;
+        reviews?: {
+            totalReviews?: number | undefined;
+            averageRating?: number | undefined;
+            positiveReviews?: number | undefined;
+            negativeReviews?: number | undefined;
+        } | undefined;
+    }>;
+    /** Hypothetical changes to apply */
+    changes: z.ZodObject<{
+        /** Additional reviews to add */
+        additionalReviews: z.ZodOptional<z.ZodNumber>;
+        /** New average rating after changes */
+        newAverageRating: z.ZodOptional<z.ZodNumber>;
+        /** Additional interactions */
+        additionalInteractions: z.ZodOptional<z.ZodNumber>;
+        /** Additional successful interactions */
+        additionalSuccessfulInteractions: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        additionalReviews?: number | undefined;
+        newAverageRating?: number | undefined;
+        additionalInteractions?: number | undefined;
+        additionalSuccessfulInteractions?: number | undefined;
+    }, {
+        additionalReviews?: number | undefined;
+        newAverageRating?: number | undefined;
+        additionalInteractions?: number | undefined;
+        additionalSuccessfulInteractions?: number | undefined;
+    }>;
+    /** Optional calculator configuration */
+    config: z.ZodOptional<z.ZodObject<{
+        /** K value for confidence calculation: confidence = n / (n + k) */
+        kValue: z.ZodDefault<z.ZodNumber>;
+        /** Optional preset (overrides other settings) */
+        preset: z.ZodOptional<z.ZodEnum<["Testing", "Conservative", "Aggressive"]>>;
+        /** Component weights */
+        weights: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+            /** Weight for review-based scoring */
+            reviews: z.ZodDefault<z.ZodNumber>;
+            /** Weight for interaction-based scoring */
+            interactions: z.ZodDefault<z.ZodNumber>;
+            /** Weight for consistency metrics */
+            consistency: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            interactions: number;
+            reviews: number;
+            consistency: number;
+        }, {
+            interactions?: number | undefined;
+            reviews?: number | undefined;
+            consistency?: number | undefined;
+        }>, {
+            interactions: number;
+            reviews: number;
+            consistency: number;
+        }, {
+            interactions?: number | undefined;
+            reviews?: number | undefined;
+            consistency?: number | undefined;
+        }>>;
+        /** Base prior score (default: 50) */
+        basePriorScore: z.ZodDefault<z.ZodNumber>;
+        /** Maximum prior score (default: 80) */
+        maxPriorScore: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        kValue: number;
+        basePriorScore: number;
+        maxPriorScore: number;
+        preset?: "Testing" | "Conservative" | "Aggressive" | undefined;
+        weights?: {
+            interactions: number;
+            reviews: number;
+            consistency: number;
+        } | undefined;
+    }, {
+        kValue?: number | undefined;
+        preset?: "Testing" | "Conservative" | "Aggressive" | undefined;
+        weights?: {
+            interactions?: number | undefined;
+            reviews?: number | undefined;
+            consistency?: number | undefined;
+        } | undefined;
+        basePriorScore?: number | undefined;
+        maxPriorScore?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    changes: {
+        additionalReviews?: number | undefined;
+        newAverageRating?: number | undefined;
+        additionalInteractions?: number | undefined;
+        additionalSuccessfulInteractions?: number | undefined;
+    };
+    current: {
+        issues: {
+            disputesFiled: number;
+            disputesLost: number;
+            abuseReportsVerified: number;
+        };
+        did: string;
+        mcpLevel: number;
+        credentials: {
+            identityVerified: boolean;
+            securityAuditPassed: boolean;
+            openSource: boolean;
+            githubVerified: boolean;
+            companyEmailVerified: boolean;
+        };
+        interactions: {
+            totalInteractions: number;
+            successfulInteractions: number;
+            failedInteractions: number;
+            uniquePartners: number;
+            totalVolume: number;
+        };
+        reviews: {
+            totalReviews: number;
+            positiveReviews: number;
+            negativeReviews: number;
+            averageRating?: number | undefined;
+        };
+        metadata?: Record<string, unknown> | undefined;
+        createdAt?: string | undefined;
+    };
+    config?: {
+        kValue: number;
+        basePriorScore: number;
+        maxPriorScore: number;
+        preset?: "Testing" | "Conservative" | "Aggressive" | undefined;
+        weights?: {
+            interactions: number;
+            reviews: number;
+            consistency: number;
+        } | undefined;
+    } | undefined;
+}, {
+    changes: {
+        additionalReviews?: number | undefined;
+        newAverageRating?: number | undefined;
+        additionalInteractions?: number | undefined;
+        additionalSuccessfulInteractions?: number | undefined;
+    };
+    current: {
+        did: string;
+        issues?: {
+            disputesFiled?: number | undefined;
+            disputesLost?: number | undefined;
+            abuseReportsVerified?: number | undefined;
+        } | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        createdAt?: string | undefined;
+        mcpLevel?: number | undefined;
+        credentials?: {
+            identityVerified?: boolean | undefined;
+            securityAuditPassed?: boolean | undefined;
+            openSource?: boolean | undefined;
+            githubVerified?: boolean | undefined;
+            companyEmailVerified?: boolean | undefined;
+        } | undefined;
+        interactions?: {
+            totalInteractions?: number | undefined;
+            successfulInteractions?: number | undefined;
+            failedInteractions?: number | undefined;
+            uniquePartners?: number | undefined;
+            totalVolume?: number | undefined;
+        } | undefined;
+        reviews?: {
+            totalReviews?: number | undefined;
+            averageRating?: number | undefined;
+            positiveReviews?: number | undefined;
+            negativeReviews?: number | undefined;
+        } | undefined;
+    };
+    config?: {
+        kValue?: number | undefined;
+        preset?: "Testing" | "Conservative" | "Aggressive" | undefined;
+        weights?: {
+            interactions?: number | undefined;
+            reviews?: number | undefined;
+            consistency?: number | undefined;
+        } | undefined;
+        basePriorScore?: number | undefined;
+        maxPriorScore?: number | undefined;
+    } | undefined;
+}>;
+export type ScoreChangePredictionRequest = z.infer<typeof ScoreChangePredictionRequestSchema>;
+/**
+ * Score Change Prediction Response Schema
+ */
+export declare const ScoreChangePredictionResponseSchema: z.ZodObject<{
+    /** Current score */
+    currentScore: z.ZodObject<{
+        /** Final reputation score (0-100) */
+        score: z.ZodNumber;
+        /** Confidence in the score (0-1) */
+        confidence: z.ZodNumber;
+        /** Human-readable confidence level */
+        confidenceLevel: z.ZodEnum<["Low", "Medium", "High", "VeryHigh"]>;
+        /** Human-readable reputation level */
+        level: z.ZodEnum<["Unknown", "Poor", "BelowAverage", "Average", "Good", "Excellent", "Outstanding"]>;
+        /** Detailed score component breakdown (Bayesian algorithm) */
+        components: z.ZodObject<{
+            /** Prior score based on credentials (50-80 points) */
+            priorScore: z.ZodNumber;
+            /** Empirical score based on interactions and reviews (0-100 points) */
+            empiricalScore: z.ZodNumber;
+            /** Weight applied to confidence (derived from interactions) */
+            confidenceWeight: z.ZodNumber;
+            /** Weight applied to prior (1 - confidenceWeight) */
+            priorWeight: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            priorScore: number;
+            empiricalScore: number;
+            confidenceWeight: number;
+            priorWeight: number;
+        }, {
+            priorScore: number;
+            empiricalScore: number;
+            confidenceWeight: number;
+            priorWeight: number;
+        }>;
+        /** Optional detailed factors breakdown (for Know That AI API compatibility) */
+        factors: z.ZodOptional<z.ZodObject<{
+            /** Score based on successful vs failed interactions (0-100) */
+            interactionScore: z.ZodNumber;
+            /** Score based on consistency of behavior over time (0-100) */
+            consistencyScore: z.ZodNumber;
+            /** Score based on account age / longevity (0-100) */
+            longevityScore: z.ZodNumber;
+            /** Score based on diversity of interaction partners (0-100) */
+            partnerDiversityScore: z.ZodNumber;
+            /** Score based on positive feedback received (0-100) */
+            feedbackScore: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            interactionScore: number;
+            consistencyScore: number;
+            longevityScore: number;
+            partnerDiversityScore: number;
+            feedbackScore: number;
+        }, {
+            interactionScore: number;
+            consistencyScore: number;
+            longevityScore: number;
+            partnerDiversityScore: number;
+            feedbackScore: number;
+        }>>;
+        /** Whether this score is provisional (limited data) */
+        isProvisional: z.ZodBoolean;
+        /** Timestamp when the score was calculated (ISO 8601) */
+        calculatedAt: z.ZodString;
+        /** DID of the agent this score belongs to */
+        agentDid: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        agentDid: string;
+        confidence: number;
+        score: number;
+        confidenceLevel: "Low" | "Medium" | "High" | "VeryHigh";
+        level: "Unknown" | "Poor" | "BelowAverage" | "Average" | "Good" | "Excellent" | "Outstanding";
+        components: {
+            priorScore: number;
+            empiricalScore: number;
+            confidenceWeight: number;
+            priorWeight: number;
+        };
+        isProvisional: boolean;
+        calculatedAt: string;
+        factors?: {
+            interactionScore: number;
+            consistencyScore: number;
+            longevityScore: number;
+            partnerDiversityScore: number;
+            feedbackScore: number;
+        } | undefined;
+    }, {
+        agentDid: string;
+        confidence: number;
+        score: number;
+        confidenceLevel: "Low" | "Medium" | "High" | "VeryHigh";
+        level: "Unknown" | "Poor" | "BelowAverage" | "Average" | "Good" | "Excellent" | "Outstanding";
+        components: {
+            priorScore: number;
+            empiricalScore: number;
+            confidenceWeight: number;
+            priorWeight: number;
+        };
+        isProvisional: boolean;
+        calculatedAt: string;
+        factors?: {
+            interactionScore: number;
+            consistencyScore: number;
+            longevityScore: number;
+            partnerDiversityScore: number;
+            feedbackScore: number;
+        } | undefined;
+    }>;
+    /** Predicted score after changes */
+    predictedScore: z.ZodObject<{
+        /** Final reputation score (0-100) */
+        score: z.ZodNumber;
+        /** Confidence in the score (0-1) */
+        confidence: z.ZodNumber;
+        /** Human-readable confidence level */
+        confidenceLevel: z.ZodEnum<["Low", "Medium", "High", "VeryHigh"]>;
+        /** Human-readable reputation level */
+        level: z.ZodEnum<["Unknown", "Poor", "BelowAverage", "Average", "Good", "Excellent", "Outstanding"]>;
+        /** Detailed score component breakdown (Bayesian algorithm) */
+        components: z.ZodObject<{
+            /** Prior score based on credentials (50-80 points) */
+            priorScore: z.ZodNumber;
+            /** Empirical score based on interactions and reviews (0-100 points) */
+            empiricalScore: z.ZodNumber;
+            /** Weight applied to confidence (derived from interactions) */
+            confidenceWeight: z.ZodNumber;
+            /** Weight applied to prior (1 - confidenceWeight) */
+            priorWeight: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            priorScore: number;
+            empiricalScore: number;
+            confidenceWeight: number;
+            priorWeight: number;
+        }, {
+            priorScore: number;
+            empiricalScore: number;
+            confidenceWeight: number;
+            priorWeight: number;
+        }>;
+        /** Optional detailed factors breakdown (for Know That AI API compatibility) */
+        factors: z.ZodOptional<z.ZodObject<{
+            /** Score based on successful vs failed interactions (0-100) */
+            interactionScore: z.ZodNumber;
+            /** Score based on consistency of behavior over time (0-100) */
+            consistencyScore: z.ZodNumber;
+            /** Score based on account age / longevity (0-100) */
+            longevityScore: z.ZodNumber;
+            /** Score based on diversity of interaction partners (0-100) */
+            partnerDiversityScore: z.ZodNumber;
+            /** Score based on positive feedback received (0-100) */
+            feedbackScore: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            interactionScore: number;
+            consistencyScore: number;
+            longevityScore: number;
+            partnerDiversityScore: number;
+            feedbackScore: number;
+        }, {
+            interactionScore: number;
+            consistencyScore: number;
+            longevityScore: number;
+            partnerDiversityScore: number;
+            feedbackScore: number;
+        }>>;
+        /** Whether this score is provisional (limited data) */
+        isProvisional: z.ZodBoolean;
+        /** Timestamp when the score was calculated (ISO 8601) */
+        calculatedAt: z.ZodString;
+        /** DID of the agent this score belongs to */
+        agentDid: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        agentDid: string;
+        confidence: number;
+        score: number;
+        confidenceLevel: "Low" | "Medium" | "High" | "VeryHigh";
+        level: "Unknown" | "Poor" | "BelowAverage" | "Average" | "Good" | "Excellent" | "Outstanding";
+        components: {
+            priorScore: number;
+            empiricalScore: number;
+            confidenceWeight: number;
+            priorWeight: number;
+        };
+        isProvisional: boolean;
+        calculatedAt: string;
+        factors?: {
+            interactionScore: number;
+            consistencyScore: number;
+            longevityScore: number;
+            partnerDiversityScore: number;
+            feedbackScore: number;
+        } | undefined;
+    }, {
+        agentDid: string;
+        confidence: number;
+        score: number;
+        confidenceLevel: "Low" | "Medium" | "High" | "VeryHigh";
+        level: "Unknown" | "Poor" | "BelowAverage" | "Average" | "Good" | "Excellent" | "Outstanding";
+        components: {
+            priorScore: number;
+            empiricalScore: number;
+            confidenceWeight: number;
+            priorWeight: number;
+        };
+        isProvisional: boolean;
+        calculatedAt: string;
+        factors?: {
+            interactionScore: number;
+            consistencyScore: number;
+            longevityScore: number;
+            partnerDiversityScore: number;
+            feedbackScore: number;
+        } | undefined;
+    }>;
+    /** Score difference */
+    scoreDelta: z.ZodNumber;
+    /** Confidence difference */
+    confidenceDelta: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    currentScore: {
+        agentDid: string;
+        confidence: number;
+        score: number;
+        confidenceLevel: "Low" | "Medium" | "High" | "VeryHigh";
+        level: "Unknown" | "Poor" | "BelowAverage" | "Average" | "Good" | "Excellent" | "Outstanding";
+        components: {
+            priorScore: number;
+            empiricalScore: number;
+            confidenceWeight: number;
+            priorWeight: number;
+        };
+        isProvisional: boolean;
+        calculatedAt: string;
+        factors?: {
+            interactionScore: number;
+            consistencyScore: number;
+            longevityScore: number;
+            partnerDiversityScore: number;
+            feedbackScore: number;
+        } | undefined;
+    };
+    predictedScore: {
+        agentDid: string;
+        confidence: number;
+        score: number;
+        confidenceLevel: "Low" | "Medium" | "High" | "VeryHigh";
+        level: "Unknown" | "Poor" | "BelowAverage" | "Average" | "Good" | "Excellent" | "Outstanding";
+        components: {
+            priorScore: number;
+            empiricalScore: number;
+            confidenceWeight: number;
+            priorWeight: number;
+        };
+        isProvisional: boolean;
+        calculatedAt: string;
+        factors?: {
+            interactionScore: number;
+            consistencyScore: number;
+            longevityScore: number;
+            partnerDiversityScore: number;
+            feedbackScore: number;
+        } | undefined;
+    };
+    scoreDelta: number;
+    confidenceDelta: number;
+}, {
+    currentScore: {
+        agentDid: string;
+        confidence: number;
+        score: number;
+        confidenceLevel: "Low" | "Medium" | "High" | "VeryHigh";
+        level: "Unknown" | "Poor" | "BelowAverage" | "Average" | "Good" | "Excellent" | "Outstanding";
+        components: {
+            priorScore: number;
+            empiricalScore: number;
+            confidenceWeight: number;
+            priorWeight: number;
+        };
+        isProvisional: boolean;
+        calculatedAt: string;
+        factors?: {
+            interactionScore: number;
+            consistencyScore: number;
+            longevityScore: number;
+            partnerDiversityScore: number;
+            feedbackScore: number;
+        } | undefined;
+    };
+    predictedScore: {
+        agentDid: string;
+        confidence: number;
+        score: number;
+        confidenceLevel: "Low" | "Medium" | "High" | "VeryHigh";
+        level: "Unknown" | "Poor" | "BelowAverage" | "Average" | "Good" | "Excellent" | "Outstanding";
+        components: {
+            priorScore: number;
+            empiricalScore: number;
+            confidenceWeight: number;
+            priorWeight: number;
+        };
+        isProvisional: boolean;
+        calculatedAt: string;
+        factors?: {
+            interactionScore: number;
+            consistencyScore: number;
+            longevityScore: number;
+            partnerDiversityScore: number;
+            feedbackScore: number;
+        } | undefined;
+    };
+    scoreDelta: number;
+    confidenceDelta: number;
+}>;
+export type ScoreChangePredictionResponse = z.infer<typeof ScoreChangePredictionResponseSchema>;
+/**
+ * Validate agent data
+ *
+ * @param data - The data to validate
+ * @returns Validation result
+ */
+export declare function validateAgentData(data: unknown): z.SafeParseReturnType<{
+    did: string;
+    issues?: {
+        disputesFiled?: number | undefined;
+        disputesLost?: number | undefined;
+        abuseReportsVerified?: number | undefined;
+    } | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    createdAt?: string | undefined;
+    mcpLevel?: number | undefined;
+    credentials?: {
+        identityVerified?: boolean | undefined;
+        securityAuditPassed?: boolean | undefined;
+        openSource?: boolean | undefined;
+        githubVerified?: boolean | undefined;
+        companyEmailVerified?: boolean | undefined;
+    } | undefined;
+    interactions?: {
+        totalInteractions?: number | undefined;
+        successfulInteractions?: number | undefined;
+        failedInteractions?: number | undefined;
+        uniquePartners?: number | undefined;
+        totalVolume?: number | undefined;
+    } | undefined;
+    reviews?: {
+        totalReviews?: number | undefined;
+        averageRating?: number | undefined;
+        positiveReviews?: number | undefined;
+        negativeReviews?: number | undefined;
+    } | undefined;
+}, {
+    issues: {
+        disputesFiled: number;
+        disputesLost: number;
+        abuseReportsVerified: number;
+    };
+    did: string;
+    mcpLevel: number;
+    credentials: {
+        identityVerified: boolean;
+        securityAuditPassed: boolean;
+        openSource: boolean;
+        githubVerified: boolean;
+        companyEmailVerified: boolean;
+    };
+    interactions: {
+        totalInteractions: number;
+        successfulInteractions: number;
+        failedInteractions: number;
+        uniquePartners: number;
+        totalVolume: number;
+    };
+    reviews: {
+        totalReviews: number;
+        positiveReviews: number;
+        negativeReviews: number;
+        averageRating?: number | undefined;
+    };
+    metadata?: Record<string, unknown> | undefined;
+    createdAt?: string | undefined;
+}>;
+/**
+ * Validate reputation score
+ *
+ * @param score - The score to validate
+ * @returns Validation result
+ */
+export declare function validateReputationScore(score: unknown): z.SafeParseReturnType<{
+    agentDid: string;
+    confidence: number;
+    score: number;
+    confidenceLevel: "Low" | "Medium" | "High" | "VeryHigh";
+    level: "Unknown" | "Poor" | "BelowAverage" | "Average" | "Good" | "Excellent" | "Outstanding";
+    components: {
+        priorScore: number;
+        empiricalScore: number;
+        confidenceWeight: number;
+        priorWeight: number;
+    };
+    isProvisional: boolean;
+    calculatedAt: string;
+    factors?: {
+        interactionScore: number;
+        consistencyScore: number;
+        longevityScore: number;
+        partnerDiversityScore: number;
+        feedbackScore: number;
+    } | undefined;
+}, {
+    agentDid: string;
+    confidence: number;
+    score: number;
+    confidenceLevel: "Low" | "Medium" | "High" | "VeryHigh";
+    level: "Unknown" | "Poor" | "BelowAverage" | "Average" | "Good" | "Excellent" | "Outstanding";
+    components: {
+        priorScore: number;
+        empiricalScore: number;
+        confidenceWeight: number;
+        priorWeight: number;
+    };
+    isProvisional: boolean;
+    calculatedAt: string;
+    factors?: {
+        interactionScore: number;
+        consistencyScore: number;
+        longevityScore: number;
+        partnerDiversityScore: number;
+        feedbackScore: number;
+    } | undefined;
+}>;
+/**
+ * Validate calculator config
+ *
+ * @param config - The config to validate
+ * @returns Validation result
+ */
+export declare function validateCalculatorConfig(config: unknown): z.SafeParseReturnType<{
+    kValue?: number | undefined;
+    preset?: "Testing" | "Conservative" | "Aggressive" | undefined;
+    weights?: {
+        interactions?: number | undefined;
+        reviews?: number | undefined;
+        consistency?: number | undefined;
+    } | undefined;
+    basePriorScore?: number | undefined;
+    maxPriorScore?: number | undefined;
+}, {
+    kValue: number;
+    basePriorScore: number;
+    maxPriorScore: number;
+    preset?: "Testing" | "Conservative" | "Aggressive" | undefined;
+    weights?: {
+        interactions: number;
+        reviews: number;
+        consistency: number;
+    } | undefined;
+}>;
+/**
+ * Get reputation level from score
+ *
+ * @param score - Numeric score (0-100)
+ * @returns Reputation level
+ */
+export declare function getReputationLevel(score: number): ReputationLevel;
+/**
+ * Get confidence level from confidence value
+ *
+ * @param confidence - Numeric confidence (0-1)
+ * @returns Confidence level
+ */
+export declare function getConfidenceLevel(confidence: number): ConfidenceLevel;
+/**
+ * Calculate confidence from interaction count using the k formula
+ *
+ * confidence = n / (n + k)
+ *
+ * @param interactionCount - Number of interactions
+ * @param kValue - K value (default: 15)
+ * @returns Confidence value (0-1)
+ */
+export declare function calculateConfidence(interactionCount: number, kValue?: number): number;
+/**
+ * Check if agent data indicates a provisional score
+ * (insufficient data for high confidence)
+ *
+ * @param data - Agent data
+ * @returns true if score should be marked provisional
+ */
+export declare function isProvisionalScore(data: AgentData): boolean;