@vorionsys/platform-core 0.1.0

package/dist/a2a/attestation.js

@@ -0,0 +1,353 @@
+/**
+ * A2A Attestation Service
+ *
+ * Generates and processes attestations for agent-to-agent interactions.
+ * Integrates with the Agent Anchor attestation system for trust scoring.
+ *
+ * @packageDocumentation
+ */
+import { createLogger } from '../common/logger.js';
+const logger = createLogger({ component: 'a2a-attestation' });
+// ============================================================================
+// A2A Attestation Service
+// ============================================================================
+export class A2AAttestationService {
+    pendingAttestations = [];
+    callbacks = [];
+    batchSize;
+    flushIntervalMs;
+    flushTimer = null;
+    constructor(config = {}) {
+        this.batchSize = config.batchSize ?? 50;
+        this.flushIntervalMs = config.flushIntervalMs ?? 5000;
+        logger.info({ batchSize: this.batchSize, flushIntervalMs: this.flushIntervalMs }, 'A2A attestation service initialized');
+    }
+    /**
+     * Start periodic flushing
+     */
+    start() {
+        if (this.flushTimer)
+            return;
+        this.flushTimer = setInterval(() => {
+            this.flush().catch((err) => {
+                logger.error({ error: err }, 'Failed to flush attestations');
+            });
+        }, this.flushIntervalMs);
+        logger.info('A2A attestation service started');
+    }
+    /**
+     * Stop periodic flushing
+     */
+    async stop() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        // Flush remaining
+        await this.flush();
+        logger.info('A2A attestation service stopped');
+    }
+    /**
+     * Register callback for attestation submission
+     */
+    onAttestation(callback) {
+        this.callbacks.push(callback);
+    }
+    // ==========================================================================
+    // Attestation Generation
+    // ==========================================================================
+    /**
+     * Generate attestation from A2A invoke result
+     */
+    generateAttestation(request, response, durationMs) {
+        const responsePayload = response?.payload;
+        const invokePayload = request.payload;
+        const outcome = this.determineOutcome(response, responsePayload);
+        const violations = this.extractViolations(response, responsePayload);
+        const attestationData = {
+            callerCarId: request.from,
+            calleeCarId: request.to,
+            action: invokePayload.action || 'unknown',
+            success: outcome === 'success',
+            responseTimeMs: durationMs,
+            trustNegotiated: !!request.trustContext.trustProof,
+            trustRequirementsMet: outcome !== 'rejected',
+            violations,
+            chainDepth: request.trustContext.callChain.length + 1,
+            delegationUsed: !!request.trustContext.delegation,
+        };
+        const attestation = {
+            id: `a2a-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+            type: 'a2a_interaction',
+            callerCarId: request.from,
+            calleeCarId: request.to,
+            action: invokePayload.action || 'unknown',
+            requestId: request.id,
+            rootRequestId: invokePayload.chainContext?.rootRequestId,
+            outcome,
+            data: attestationData,
+            chain: {
+                depth: request.trustContext.callChain.length + 1,
+                trustFloor: this.calculateTrustFloor(request.trustContext.callChain),
+                links: request.trustContext.callChain,
+            },
+            timestamp: new Date().toISOString(),
+        };
+        return attestation;
+    }
+    /**
+     * Record an attestation
+     */
+    async record(attestation) {
+        this.pendingAttestations.push(attestation);
+        logger.debug({
+            id: attestation.id,
+            caller: attestation.callerCarId,
+            callee: attestation.calleeCarId,
+            outcome: attestation.outcome,
+        }, 'Attestation recorded');
+        // Flush if batch full
+        if (this.pendingAttestations.length >= this.batchSize) {
+            await this.flush();
+        }
+    }
+    /**
+     * Flush pending attestations
+     */
+    async flush() {
+        if (this.pendingAttestations.length === 0) {
+            return 0;
+        }
+        const batch = [...this.pendingAttestations];
+        this.pendingAttestations = [];
+        logger.info({ count: batch.length }, 'Flushing A2A attestations');
+        // Submit to callbacks
+        for (const callback of this.callbacks) {
+            for (const attestation of batch) {
+                try {
+                    await callback(attestation);
+                }
+                catch (error) {
+                    logger.error({ error, attestationId: attestation.id }, 'Callback failed');
+                }
+            }
+        }
+        return batch.length;
+    }
+    // ==========================================================================
+    // Trust Impact Calculation
+    // ==========================================================================
+    /**
+     * Calculate trust impact for both caller and callee
+     */
+    calculateTrustImpact(attestation) {
+        const impacts = [];
+        // Caller impact
+        const callerImpact = this.calculateCallerImpact(attestation);
+        if (callerImpact.scoreChange !== 0) {
+            impacts.push(callerImpact);
+        }
+        // Callee impact
+        const calleeImpact = this.calculateCalleeImpact(attestation);
+        if (calleeImpact.scoreChange !== 0) {
+            impacts.push(calleeImpact);
+        }
+        return impacts;
+    }
+    /**
+     * Calculate caller trust impact
+     */
+    calculateCallerImpact(attestation) {
+        const factors = {};
+        let scoreChange = 0;
+        // Successful calls build trust
+        if (attestation.outcome === 'success') {
+            factors['successful_call'] = 1;
+            scoreChange += 1;
+            // Bonus for deep chains (shows coordination ability)
+            if (attestation.chain.depth > 2) {
+                factors['chain_coordination'] = Math.min(attestation.chain.depth - 2, 3);
+                scoreChange += factors['chain_coordination'];
+            }
+        }
+        // Failures reduce trust slightly
+        if (attestation.outcome === 'failure') {
+            factors['failed_call'] = -1;
+            scoreChange -= 1;
+        }
+        // Rejections (trust violations) are worse
+        if (attestation.outcome === 'rejected') {
+            factors['trust_rejection'] = -5;
+            scoreChange -= 5;
+        }
+        // Violations
+        const violationCount = attestation.data.violations.length;
+        if (violationCount > 0) {
+            factors['violations'] = -violationCount * 2;
+            scoreChange += factors['violations'];
+        }
+        return {
+            carId: attestation.callerCarId,
+            scoreChange,
+            reason: `A2A call to ${attestation.calleeCarId}: ${attestation.outcome}`,
+            factors,
+        };
+    }
+    /**
+     * Calculate callee trust impact
+     */
+    calculateCalleeImpact(attestation) {
+        const factors = {};
+        let scoreChange = 0;
+        // Successfully serving requests builds trust
+        if (attestation.outcome === 'success') {
+            factors['successful_service'] = 2;
+            scoreChange += 2;
+            // Fast responses are valued
+            if (attestation.data.responseTimeMs < 100) {
+                factors['fast_response'] = 1;
+                scoreChange += 1;
+            }
+        }
+        // Failures hurt callee reputation
+        if (attestation.outcome === 'failure') {
+            factors['service_failure'] = -2;
+            scoreChange -= 2;
+        }
+        // Timeouts are worse
+        if (attestation.outcome === 'timeout') {
+            factors['timeout'] = -5;
+            scoreChange -= 5;
+        }
+        return {
+            carId: attestation.calleeCarId,
+            scoreChange,
+            reason: `A2A service to ${attestation.callerCarId}: ${attestation.outcome}`,
+            factors,
+        };
+    }
+    // ==========================================================================
+    // Helpers
+    // ==========================================================================
+    /**
+     * Determine outcome from response
+     */
+    determineOutcome(response, payload) {
+        if (!response) {
+            return 'timeout';
+        }
+        if (!payload) {
+            return 'failure';
+        }
+        if (payload.error?.code === 'TRUST_INSUFFICIENT' ||
+            payload.error?.code === 'CAPABILITY_DENIED') {
+            return 'rejected';
+        }
+        if (payload.success) {
+            return 'success';
+        }
+        return 'failure';
+    }
+    /**
+     * Extract violations from response
+     */
+    extractViolations(response, payload) {
+        const violations = [];
+        if (!response || !payload) {
+            return violations;
+        }
+        if (payload.error) {
+            violations.push(`${payload.error.code}: ${payload.error.message}`);
+        }
+        return violations;
+    }
+    /**
+     * Calculate trust floor from chain
+     */
+    calculateTrustFloor(chain) {
+        if (chain.length === 0) {
+            return 7; // Maximum if no chain
+        }
+        return Math.min(...chain.map((l) => l.tier));
+    }
+    // ==========================================================================
+    // Analytics
+    // ==========================================================================
+    /**
+     * Generate A2A analytics for an agent
+     */
+    generateAnalytics(attestations, carId) {
+        const asCaller = attestations.filter((a) => a.callerCarId === carId);
+        const asCallee = attestations.filter((a) => a.calleeCarId === carId);
+        // Caller stats
+        const asCallerStats = {
+            total: asCaller.length,
+            success: asCaller.filter((a) => a.outcome === 'success').length,
+            failure: asCaller.filter((a) => a.outcome === 'failure').length,
+            rejected: asCaller.filter((a) => a.outcome === 'rejected').length,
+            timeout: asCaller.filter((a) => a.outcome === 'timeout').length,
+        };
+        // Callee stats
+        const asCalleeStats = {
+            total: asCallee.length,
+            success: asCallee.filter((a) => a.outcome === 'success').length,
+            failure: asCallee.filter((a) => a.outcome === 'failure').length,
+            rejected: asCallee.filter((a) => a.outcome === 'rejected').length,
+            timeout: asCallee.filter((a) => a.outcome === 'timeout').length,
+        };
+        // Top partners
+        const partnerCounts = new Map();
+        for (const a of asCaller) {
+            partnerCounts.set(a.calleeCarId, (partnerCounts.get(a.calleeCarId) || 0) + 1);
+        }
+        for (const a of asCallee) {
+            partnerCounts.set(a.callerCarId, (partnerCounts.get(a.callerCarId) || 0) + 1);
+        }
+        const topPartners = Array.from(partnerCounts.entries())
+            .map(([carId, count]) => ({ carId, count }))
+            .sort((a, b) => b.count - a.count)
+            .slice(0, 10);
+        // Avg response time (as callee)
+        const responseTimes = asCallee
+            .filter((a) => a.outcome === 'success')
+            .map((a) => a.data.responseTimeMs);
+        const avgResponseTime = responseTimes.length > 0
+            ? responseTimes.reduce((a, b) => a + b, 0) / responseTimes.length
+            : 0;
+        // Overall success rate
+        const totalInteractions = asCaller.length + asCallee.length;
+        const successfulInteractions = asCaller.filter((a) => a.outcome === 'success').length +
+            asCallee.filter((a) => a.outcome === 'success').length;
+        const successRate = totalInteractions > 0 ? successfulInteractions / totalInteractions : 0;
+        return {
+            asCallerStats,
+            asCalleeStats,
+            topPartners,
+            avgResponseTime,
+            successRate,
+        };
+    }
+    /**
+     * Get pending attestation count
+     */
+    getPendingCount() {
+        return this.pendingAttestations.length;
+    }
+}
+// ============================================================================
+// Factory Functions
+// ============================================================================
+let instance = null;
+export function createA2AAttestationService(config) {
+    if (!instance) {
+        instance = new A2AAttestationService(config);
+    }
+    return instance;
+}
+export function getA2AAttestationService() {
+    if (!instance) {
+        throw new Error('A2AAttestationService not initialized');
+    }
+    return instance;
+}
+//# sourceMappingURL=attestation.js.map

package/dist/a2a/attestation.js.map

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

package/dist/a2a/chain-of-trust.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Chain of Trust Service
+ *
+ * Tracks and manages trust chains for nested A2A calls.
+ * Implements trust inheritance policies and chain validation.
+ *
+ * @packageDocumentation
+ */
+import { type ChainContext, type ChainLink, type TrustInheritanceMode, type A2AAttestationData } from './types.js';
+/**
+ * Active chain tracking
+ */
+export interface ActiveChain {
+    /** Root request ID */
+    rootRequestId: string;
+    /** Chain links */
+    links: ChainLink[];
+    /** Trust inheritance mode */
+    inheritanceMode: TrustInheritanceMode;
+    /** Current effective trust tier */
+    effectiveTier: number;
+    /** Current effective trust score */
+    effectiveScore: number;
+    /** Started timestamp */
+    startedAt: Date;
+    /** Last activity */
+    lastActivityAt: Date;
+    /** Chain state */
+    state: 'active' | 'completed' | 'failed' | 'expired';
+    /** Attestation data collected */
+    attestations: A2AAttestationData[];
+}
+/**
+ * Chain validation result
+ */
+export interface ChainValidationResult {
+    valid: boolean;
+    effectiveTier: number;
+    effectiveScore: number;
+    warnings: string[];
+    violations: ChainViolation[];
+}
+/**
+ * Chain violation
+ */
+export interface ChainViolation {
+    type: 'depth_exceeded' | 'trust_drop' | 'loop_detected' | 'stale_chain' | 'invalid_link';
+    message: string;
+    linkIndex?: number;
+}
+/**
+ * Chain statistics
+ */
+export interface ChainStats {
+    totalChains: number;
+    activeChains: number;
+    completedChains: number;
+    failedChains: number;
+    avgChainDepth: number;
+    avgChainDuration: number;
+    loopDetections: number;
+    depthViolations: number;
+}
+export declare class ChainOfTrustService {
+    private activeChains;
+    private stats;
+    private defaultInheritanceMode;
+    constructor(inheritanceMode?: TrustInheritanceMode);
+    /**
+     * Start a new chain
+     */
+    startChain(rootRequestId: string, initiator: ChainLink, inheritanceMode?: TrustInheritanceMode): ActiveChain;
+    /**
+     * Add a link to an existing chain
+     */
+    addLink(rootRequestId: string, link: ChainLink): ChainValidationResult;
+    /**
+     * Complete a chain
+     */
+    completeChain(rootRequestId: string, attestation: A2AAttestationData): void;
+    /**
+     * Fail a chain
+     */
+    failChain(rootRequestId: string, reason: string): void;
+    /**
+     * Get active chain
+     */
+    getChain(rootRequestId: string): ActiveChain | undefined;
+    /**
+     * Build chain context from active chain
+     */
+    buildContext(rootRequestId: string): ChainContext | null;
+    /**
+     * Validate a new link
+     */
+    private validateLink;
+    /**
+     * Validate a complete chain context
+     */
+    validateChainContext(context: ChainContext): ChainValidationResult;
+    /**
+     * Calculate effective trust from chain
+     */
+    calculateEffectiveTrust(links: ChainLink[], mode: TrustInheritanceMode): {
+        tier: number;
+        score: number;
+    };
+    /**
+     * Get minimum tier required for an action given a chain
+     */
+    getMinimumTierForAction(chain: ChainLink[], actionMinTier: number, mode?: TrustInheritanceMode): number;
+    /**
+     * Generate chain visualization for debugging
+     */
+    visualizeChain(rootRequestId: string): string;
+    /**
+     * Export chain for analysis
+     */
+    exportChain(rootRequestId: string): {
+        chain: ActiveChain | null;
+        visualization: string;
+        validation: ChainValidationResult | null;
+    };
+    /**
+     * Update rolling averages
+     */
+    private updateAverages;
+    /**
+     * Get statistics
+     */
+    getStats(): ChainStats;
+    /**
+     * Get all active chains (for monitoring)
+     */
+    getActiveChains(): ActiveChain[];
+    /**
+     * Cleanup expired chains
+     */
+    cleanupExpiredChains(maxAgeMs?: number): number;
+}
+export declare function createChainOfTrustService(inheritanceMode?: TrustInheritanceMode): ChainOfTrustService;
+export declare function getChainOfTrustService(): ChainOfTrustService;
+//# sourceMappingURL=chain-of-trust.d.ts.map

package/dist/a2a/chain-of-trust.d.ts.map

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