@vorionsys/platform-core 0.1.0

package/dist/trust-engine/signal-diversity.js

@@ -0,0 +1,238 @@
+/**
+ * Signal Diversity Requirements for Trust Tier Promotion
+ *
+ * Prevents gaming by requiring diverse signal sources and types
+ * before allowing tier promotion. Agents cannot inflate their trust
+ * score from a single source or signal dimension.
+ *
+ * @packageDocumentation
+ */
+import { CertificationTier } from '@vorionsys/contracts/car';
+/**
+ * Default diversity requirements
+ *
+ * Higher tiers require more diverse signal sources to prevent
+ * single-source trust inflation attacks.
+ */
+export const DEFAULT_DIVERSITY_CONFIG = {
+    minSourcesForTier: {
+        0: 0, // T0 Sandbox: no requirements
+        1: 1, // T1 Observed: at least 1 source
+        2: 2, // T2 Provisional: at least 2 sources
+        3: 2, // T3 Monitored: at least 2 sources
+        4: 3, // T4 Standard: at least 3 sources
+        5: 3, // T5 Trusted: at least 3 sources
+        6: 4, // T6 Certified: at least 4 sources
+        7: 4, // T7 Autonomous: at least 4 sources
+    },
+    minDimensionsForTier: {
+        0: 0, // T0: no requirements
+        1: 1, // T1: 1 dimension
+        2: 2, // T2: 2 dimensions
+        3: 3, // T3: 3 dimensions
+        4: 4, // T4: all 4 dimensions
+        5: 4, // T5: all 4 dimensions
+        6: 4, // T6: all 4 dimensions
+        7: 4, // T7: all 4 dimensions
+    },
+    diversityWindowDays: 30,
+    minSignalsPerDimension: 2, // Need at least 2 signals to count as covered
+};
+/** All signal dimensions */
+export const ALL_DIMENSIONS = [
+    'behavioral',
+    'compliance',
+    'identity',
+    'context',
+];
+/**
+ * Extract dimension from signal type
+ *
+ * Signal types are expected to be prefixed with dimension, e.g.:
+ * - "behavioral.action_success"
+ * - "compliance.audit_passed"
+ * - "identity.verification_complete"
+ * - "context.environment_stable"
+ */
+export function getSignalDimension(signalType) {
+    const prefix = signalType.split('.')[0];
+    if (ALL_DIMENSIONS.includes(prefix)) {
+        return prefix;
+    }
+    return null;
+}
+/**
+ * Analyze signal diversity within a time window
+ *
+ * @param signals - All signals to analyze
+ * @param config - Diversity configuration
+ * @returns Diversity analysis results
+ */
+export function analyzeSignalDiversity(signals, config = DEFAULT_DIVERSITY_CONFIG) {
+    const uniqueSources = new Set();
+    const coveredDimensions = new Set();
+    const signalsPerDimension = {
+        behavioral: 0,
+        compliance: 0,
+        identity: 0,
+        context: 0,
+    };
+    const now = Date.now();
+    const windowMs = config.diversityWindowDays * 24 * 60 * 60 * 1000;
+    const cutoff = now - windowMs;
+    let signalsInWindow = 0;
+    for (const signal of signals) {
+        const signalTime = new Date(signal.timestamp).getTime();
+        if (signalTime < cutoff)
+            continue;
+        signalsInWindow++;
+        // Track unique sources
+        if (signal.source) {
+            uniqueSources.add(signal.source);
+        }
+        // Track dimension coverage
+        const dimension = getSignalDimension(signal.type);
+        if (dimension) {
+            signalsPerDimension[dimension]++;
+        }
+    }
+    // Determine which dimensions are "covered" (have enough signals)
+    for (const dimension of ALL_DIMENSIONS) {
+        if (signalsPerDimension[dimension] >= config.minSignalsPerDimension) {
+            coveredDimensions.add(dimension);
+        }
+    }
+    return {
+        uniqueSources,
+        coveredDimensions,
+        signalsPerDimension,
+        totalSignals: signals.length,
+        signalsInWindow,
+    };
+}
+/**
+ * Validate if an entity can be promoted to a target tier
+ *
+ * @param signals - Entity's trust signals
+ * @param currentTier - Current trust tier
+ * @param targetTier - Tier attempting to promote to
+ * @param config - Diversity configuration
+ * @returns Validation result with gaps if not valid
+ */
+export function validateTierPromotion(signals, currentTier, targetTier, config = DEFAULT_DIVERSITY_CONFIG) {
+    // Same tier or demotion - no diversity check needed
+    if (targetTier <= currentTier) {
+        return {
+            valid: true,
+            currentTier,
+            targetTier,
+            gaps: [],
+            diversity: analyzeSignalDiversity(signals, config),
+            requirements: {
+                minSources: config.minSourcesForTier[targetTier],
+                minDimensions: config.minDimensionsForTier[targetTier],
+            },
+        };
+    }
+    const diversity = analyzeSignalDiversity(signals, config);
+    const requiredSources = config.minSourcesForTier[targetTier];
+    const requiredDimensions = config.minDimensionsForTier[targetTier];
+    const gaps = [];
+    // Check source diversity
+    if (diversity.uniqueSources.size < requiredSources) {
+        gaps.push(`Insufficient signal sources: have ${diversity.uniqueSources.size}, need ${requiredSources} for T${targetTier}`);
+    }
+    // Check dimension coverage
+    if (diversity.coveredDimensions.size < requiredDimensions) {
+        const missing = ALL_DIMENSIONS.filter((d) => !diversity.coveredDimensions.has(d));
+        gaps.push(`Insufficient dimension coverage: have ${diversity.coveredDimensions.size}, need ${requiredDimensions}. Missing: ${missing.join(', ')}`);
+    }
+    return {
+        valid: gaps.length === 0,
+        currentTier,
+        targetTier,
+        gaps,
+        diversity,
+        requirements: {
+            minSources: requiredSources,
+            minDimensions: requiredDimensions,
+        },
+    };
+}
+/**
+ * Calculate the maximum tier achievable given current signal diversity
+ *
+ * @param signals - Entity's trust signals
+ * @param config - Diversity configuration
+ * @returns Maximum tier that diversity requirements allow
+ */
+export function getMaxTierForDiversity(signals, config = DEFAULT_DIVERSITY_CONFIG) {
+    const diversity = analyzeSignalDiversity(signals, config);
+    // Find highest tier where requirements are met
+    for (let tier = 7; tier >= 0; tier--) {
+        const requiredSources = config.minSourcesForTier[tier];
+        const requiredDimensions = config.minDimensionsForTier[tier];
+        if (diversity.uniqueSources.size >= requiredSources &&
+            diversity.coveredDimensions.size >= requiredDimensions) {
+            return tier;
+        }
+    }
+    return 0;
+}
+// =============================================================================
+// CERTIFICATION TIER CONVERSION
+// =============================================================================
+/**
+ * Convert TrustLevel to CertificationTier
+ */
+export function trustLevelToCertificationTier(level) {
+    const mapping = {
+        0: CertificationTier.T0_SANDBOX,
+        1: CertificationTier.T1_OBSERVED,
+        2: CertificationTier.T2_PROVISIONAL,
+        3: CertificationTier.T3_MONITORED,
+        4: CertificationTier.T4_STANDARD,
+        5: CertificationTier.T5_TRUSTED,
+        6: CertificationTier.T6_CERTIFIED,
+        7: CertificationTier.T7_AUTONOMOUS,
+    };
+    return mapping[level];
+}
+/**
+ * Validate certification tier promotion using diversity
+ *
+ * @param signals - Entity's trust signals
+ * @param currentTier - Current certification tier
+ * @param targetTier - Target certification tier
+ * @param config - Diversity configuration
+ */
+export function validateCertificationTierPromotion(signals, currentTier, targetTier, config = DEFAULT_DIVERSITY_CONFIG) {
+    // Convert certification tiers to trust levels (they align 0-7)
+    const currentLevel = Object.values(CertificationTier).indexOf(currentTier);
+    const targetLevel = Object.values(CertificationTier).indexOf(targetTier);
+    return validateTierPromotion(signals, currentLevel, targetLevel, config);
+}
+// =============================================================================
+// DIVERSITY SCORE
+// =============================================================================
+/**
+ * Calculate a diversity score (0-100) for an entity's signals
+ *
+ * Higher score = more diverse signal portfolio
+ *
+ * @param signals - Entity's trust signals
+ * @param config - Diversity configuration
+ * @returns Diversity score 0-100
+ */
+export function calculateDiversityScore(signals, config = DEFAULT_DIVERSITY_CONFIG) {
+    const diversity = analyzeSignalDiversity(signals, config);
+    // Max requirements for T7
+    const maxSources = config.minSourcesForTier[7];
+    const maxDimensions = config.minDimensionsForTier[7];
+    // Source diversity (50% weight)
+    const sourceScore = Math.min(diversity.uniqueSources.size / maxSources, 1) * 50;
+    // Dimension coverage (50% weight)
+    const dimensionScore = Math.min(diversity.coveredDimensions.size / maxDimensions, 1) * 50;
+    return Math.round(sourceScore + dimensionScore);
+}
+//# sourceMappingURL=signal-diversity.js.map

package/dist/trust-engine/signal-diversity.js.map

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

package/dist/versioning/deprecation.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Deprecation Tracking
+ *
+ * Tracks deprecated features with sunset dates and replacement guidance.
+ * Provides warnings and compatibility checking.
+ *
+ * @packageDocumentation
+ */
+export interface Deprecation {
+    /** Feature identifier */
+    feature: string;
+    /** Version when deprecated */
+    deprecatedIn: string;
+    /** Version when removed (if known) */
+    removedIn?: string;
+    /** Replacement feature/approach */
+    replacement?: string;
+    /** Deprecation message */
+    message: string;
+    /** Documentation link */
+    link?: string;
+    /** Whether warnings have been logged */
+    warned?: boolean;
+}
+export interface DeprecationRegistry {
+    /** Register a deprecation */
+    register(deprecation: Deprecation): void;
+    /** Check if a feature is deprecated */
+    isDeprecated(feature: string, currentVersion?: string): boolean;
+    /** Check if a feature is removed */
+    isRemoved(feature: string, currentVersion?: string): boolean;
+    /** Get deprecation info */
+    get(feature: string): Deprecation | undefined;
+    /** Get all deprecations */
+    getAll(): Deprecation[];
+    /** Warn about a deprecated feature (logs once) */
+    warn(feature: string): void;
+    /** Check feature and throw if removed */
+    check(feature: string, currentVersion?: string): void;
+}
+export declare function createDeprecationRegistry(currentVersion: string): DeprecationRegistry;
+export declare function getDeprecationRegistry(): DeprecationRegistry;
+/**
+ * Decorator to mark a function as deprecated
+ */
+export declare function deprecated(options: {
+    message: string;
+    replacement?: string;
+    since?: string;
+    until?: string;
+}): MethodDecorator;
+export declare const VORION_DEPRECATIONS: Deprecation[];
+/**
+ * Initialize deprecation registry with pre-defined deprecations
+ */
+export declare function initDeprecations(currentVersion: string): DeprecationRegistry;
+/**
+ * Check API version compatibility
+ */
+export declare function checkApiCompatibility(clientVersion: string, serverVersion: string, deprecations: DeprecationRegistry): {
+    compatible: boolean;
+    warnings: string[];
+    errors: string[];
+};
+//# sourceMappingURL=deprecation.d.ts.map

package/dist/versioning/deprecation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecation.d.ts","sourceRoot":"","sources":["../../src/versioning/deprecation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IACzC,uCAAuC;IACvC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAChE,oCAAoC;IACpC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7D,2BAA2B;IAC3B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IAC9C,2BAA2B;IAC3B,MAAM,IAAI,WAAW,EAAE,CAAC;IACxB,kDAAkD;IAClD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,yCAAyC;IACzC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvD;AA6FD,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,mBAAmB,CAGrF;AAED,wBAAgB,sBAAsB,IAAI,mBAAmB,CAK5D;AAMD;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,eAAe,CA2BlB;AAMD,eAAO,MAAM,mBAAmB,EAAE,WAAW,EAkC5C,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,mBAAmB,CAQ5E;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,mBAAmB,GAChC;IACD,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CA+BA"}

package/dist/versioning/deprecation.js

@@ -0,0 +1,199 @@
+/**
+ * Deprecation Tracking
+ *
+ * Tracks deprecated features with sunset dates and replacement guidance.
+ * Provides warnings and compatibility checking.
+ *
+ * @packageDocumentation
+ */
+import { createLogger } from '../common/logger.js';
+import { parseVersion, gte } from './semver.js';
+const logger = createLogger({ component: 'deprecation' });
+// ============================================================================
+// Deprecation Registry Implementation
+// ============================================================================
+class DeprecationRegistryImpl {
+    deprecations = new Map();
+    currentVersion;
+    constructor(currentVersion) {
+        this.currentVersion = parseVersion(currentVersion);
+    }
+    register(deprecation) {
+        this.deprecations.set(deprecation.feature, { ...deprecation, warned: false });
+        logger.debug({ feature: deprecation.feature, deprecatedIn: deprecation.deprecatedIn }, 'Deprecation registered');
+    }
+    isDeprecated(feature, currentVersion) {
+        const deprecation = this.deprecations.get(feature);
+        if (!deprecation)
+            return false;
+        const version = currentVersion ? parseVersion(currentVersion) : this.currentVersion;
+        const deprecatedIn = parseVersion(deprecation.deprecatedIn);
+        return gte(version, deprecatedIn);
+    }
+    isRemoved(feature, currentVersion) {
+        const deprecation = this.deprecations.get(feature);
+        if (!deprecation || !deprecation.removedIn)
+            return false;
+        const version = currentVersion ? parseVersion(currentVersion) : this.currentVersion;
+        const removedIn = parseVersion(deprecation.removedIn);
+        return gte(version, removedIn);
+    }
+    get(feature) {
+        return this.deprecations.get(feature);
+    }
+    getAll() {
+        return Array.from(this.deprecations.values());
+    }
+    warn(feature) {
+        const deprecation = this.deprecations.get(feature);
+        if (!deprecation)
+            return;
+        if (deprecation.warned)
+            return;
+        deprecation.warned = true;
+        const context = {
+            feature,
+            deprecatedIn: deprecation.deprecatedIn,
+        };
+        if (deprecation.removedIn) {
+            context.removedIn = deprecation.removedIn;
+        }
+        if (deprecation.replacement) {
+            context.replacement = deprecation.replacement;
+        }
+        if (deprecation.link) {
+            context.link = deprecation.link;
+        }
+        logger.warn(context, `Deprecated: ${deprecation.message}`);
+    }
+    check(feature, currentVersion) {
+        if (this.isRemoved(feature, currentVersion)) {
+            const deprecation = this.deprecations.get(feature);
+            throw new Error(`Feature '${feature}' was removed in version ${deprecation.removedIn}. ` +
+                (deprecation.replacement ? `Use '${deprecation.replacement}' instead.` : ''));
+        }
+        if (this.isDeprecated(feature, currentVersion)) {
+            this.warn(feature);
+        }
+    }
+}
+// ============================================================================
+// Factory Functions
+// ============================================================================
+let registry = null;
+export function createDeprecationRegistry(currentVersion) {
+    registry = new DeprecationRegistryImpl(currentVersion);
+    return registry;
+}
+export function getDeprecationRegistry() {
+    if (!registry) {
+        throw new Error('DeprecationRegistry not initialized');
+    }
+    return registry;
+}
+// ============================================================================
+// Decorator for Deprecated Functions
+// ============================================================================
+/**
+ * Decorator to mark a function as deprecated
+ */
+export function deprecated(options) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        let warned = false;
+        descriptor.value = function (...args) {
+            if (!warned) {
+                warned = true;
+                logger.warn({
+                    method: String(propertyKey),
+                    since: options.since,
+                    until: options.until,
+                    replacement: options.replacement,
+                }, `Deprecated: ${options.message}`);
+            }
+            return originalMethod.apply(this, args);
+        };
+        return descriptor;
+    };
+}
+// ============================================================================
+// Pre-defined Deprecations
+// ============================================================================
+export const VORION_DEPRECATIONS = [
+    // API Deprecations
+    {
+        feature: 'api.v1.legacy_aci_format',
+        deprecatedIn: '1.0.0',
+        removedIn: '2.0.0',
+        replacement: 'Standard CAR format (a3i.org.class:domains-level@version)',
+        message: 'Legacy CAR format with embedded trust tier is deprecated',
+        link: 'https://docs.vorion.dev/car#migration',
+    },
+    {
+        feature: 'api.v1.trust_score_in_response',
+        deprecatedIn: '1.1.0',
+        replacement: 'GET /v1/agents/{carId}/trust',
+        message: 'Trust score in agent response is deprecated; use dedicated endpoint',
+    },
+    // SDK Deprecations
+    {
+        feature: 'sdk.getTrustLevel',
+        deprecatedIn: '1.0.0',
+        removedIn: '2.0.0',
+        replacement: 'getTrustScore()',
+        message: 'getTrustLevel() is deprecated; use getTrustScore() for numeric scores',
+    },
+    // Protocol Deprecations
+    {
+        feature: 'a2a.v0.message_format',
+        deprecatedIn: '1.0.0',
+        removedIn: '1.5.0',
+        replacement: 'A2A v1.0 message format',
+        message: 'A2A v0 message format is deprecated',
+    },
+];
+/**
+ * Initialize deprecation registry with pre-defined deprecations
+ */
+export function initDeprecations(currentVersion) {
+    const reg = createDeprecationRegistry(currentVersion);
+    for (const deprecation of VORION_DEPRECATIONS) {
+        reg.register(deprecation);
+    }
+    return reg;
+}
+// ============================================================================
+// Compatibility Helpers
+// ============================================================================
+/**
+ * Check API version compatibility
+ */
+export function checkApiCompatibility(clientVersion, serverVersion, deprecations) {
+    const warnings = [];
+    const errors = [];
+    const client = parseVersion(clientVersion);
+    const server = parseVersion(serverVersion);
+    // Major version mismatch = incompatible
+    if (client.major !== server.major) {
+        errors.push(`Major version mismatch: client ${clientVersion}, server ${serverVersion}`);
+        return { compatible: false, warnings, errors };
+    }
+    // Client newer than server = potential issues
+    if (client.minor > server.minor) {
+        warnings.push(`Client version ${clientVersion} may use features not available on server ${serverVersion}`);
+    }
+    // Check for deprecated features
+    const allDeprecations = deprecations.getAll();
+    for (const dep of allDeprecations) {
+        if (deprecations.isDeprecated(dep.feature, clientVersion)) {
+            if (deprecations.isRemoved(dep.feature, serverVersion)) {
+                errors.push(`Feature '${dep.feature}' used by client was removed in server version`);
+            }
+            else {
+                warnings.push(`Feature '${dep.feature}' is deprecated: ${dep.message}`);
+            }
+        }
+    }
+    return { compatible: errors.length === 0, warnings, errors };
+}
+//# sourceMappingURL=deprecation.js.map

package/dist/versioning/deprecation.js.map

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

package/dist/versioning/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Versioning Module
+ *
+ * Provides semantic versioning utilities, deprecation tracking,
+ * and compatibility checking for the Vorion platform.
+ *
+ * @packageDocumentation
+ */
+export declare const PLATFORM_VERSION = "0.1.0";
+export { type Version, type VersionRange, SEMVER_REGEX, parseVersion, tryParseVersion, isValidVersion, formatVersion, compareVersions, eq, gt, lt, gte, lte, satisfies, isCompatible, isApproximatelyEqual, increment, maxVersion, minVersion, sortVersions, } from './semver.js';
+export { type Deprecation, type DeprecationRegistry, createDeprecationRegistry, getDeprecationRegistry, deprecated, VORION_DEPRECATIONS, initDeprecations, checkApiCompatibility, } from './deprecation.js';
+/** Current API version */
+export declare const API_VERSION = "v1";
+/** Supported API versions */
+export declare const SUPPORTED_API_VERSIONS: readonly ["v1"];
+/** Minimum SDK version for current API */
+export declare const MIN_SDK_VERSION = "0.1.0";
+/** Maximum SDK version for current API */
+export declare const MAX_SDK_VERSION = "0.99.99";
+/** A2A protocol version */
+export declare const A2A_PROTOCOL_VERSION = "1.0";
+/** Supported A2A protocol versions */
+export declare const SUPPORTED_A2A_VERSIONS: readonly ["1.0"];
+/** Current schema version */
+export declare const SCHEMA_VERSION = "4";
+/** ADL (Agent Definition Language) version */
+export declare const ADL_VERSION = "1.0";
+/**
+ * Check if an SDK version is compatible with the current API
+ */
+export declare function isSDKVersionCompatible(sdkVersion: string): boolean;
+/**
+ * Check if an A2A protocol version is supported
+ */
+export declare function isA2AVersionSupported(protocolVersion: string): boolean;
+/**
+ * Get version info for health/status endpoints
+ */
+export declare function getVersionInfo(): {
+    platform: string;
+    api: string;
+    a2a: string;
+    schema: string;
+    adl: string;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/versioning/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,eAAO,MAAM,gBAAgB,UAAU,CAAC;AAGxC,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,eAAe,EACf,EAAE,EACF,EAAE,EACF,EAAE,EACF,GAAG,EACH,GAAG,EACH,SAAS,EACT,YAAY,EACZ,oBAAoB,EACpB,SAAS,EACT,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,UAAU,EACV,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAM1B,0BAA0B;AAC1B,eAAO,MAAM,WAAW,OAAO,CAAC;AAEhC,6BAA6B;AAC7B,eAAO,MAAM,sBAAsB,iBAAkB,CAAC;AAEtD,0CAA0C;AAC1C,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC,0CAA0C;AAC1C,eAAO,MAAM,eAAe,YAAY,CAAC;AAMzC,2BAA2B;AAC3B,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAE1C,sCAAsC;AACtC,eAAO,MAAM,sBAAsB,kBAAmB,CAAC;AAMvD,6BAA6B;AAC7B,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,8CAA8C;AAC9C,eAAO,MAAM,WAAW,QAAQ,CAAC;AAQjC;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAUlE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb,CAQA"}

package/dist/versioning/index.js

@@ -0,0 +1,76 @@
+/**
+ * Versioning Module
+ *
+ * Provides semantic versioning utilities, deprecation tracking,
+ * and compatibility checking for the Vorion platform.
+ *
+ * @packageDocumentation
+ */
+// Platform version
+export const PLATFORM_VERSION = '0.1.0';
+// SemVer utilities
+export { SEMVER_REGEX, parseVersion, tryParseVersion, isValidVersion, formatVersion, compareVersions, eq, gt, lt, gte, lte, satisfies, isCompatible, isApproximatelyEqual, increment, maxVersion, minVersion, sortVersions, } from './semver.js';
+// Deprecation tracking
+export { createDeprecationRegistry, getDeprecationRegistry, deprecated, VORION_DEPRECATIONS, initDeprecations, checkApiCompatibility, } from './deprecation.js';
+// ============================================================================
+// API Version Constants
+// ============================================================================
+/** Current API version */
+export const API_VERSION = 'v1';
+/** Supported API versions */
+export const SUPPORTED_API_VERSIONS = ['v1'];
+/** Minimum SDK version for current API */
+export const MIN_SDK_VERSION = '0.1.0';
+/** Maximum SDK version for current API */
+export const MAX_SDK_VERSION = '0.99.99';
+// ============================================================================
+// Protocol Version Constants
+// ============================================================================
+/** A2A protocol version */
+export const A2A_PROTOCOL_VERSION = '1.0';
+/** Supported A2A protocol versions */
+export const SUPPORTED_A2A_VERSIONS = ['1.0'];
+// ============================================================================
+// Schema Version Constants
+// ============================================================================
+/** Current schema version */
+export const SCHEMA_VERSION = '4';
+/** ADL (Agent Definition Language) version */
+export const ADL_VERSION = '1.0';
+// ============================================================================
+// Compatibility Utilities
+// ============================================================================
+import { parseVersion, gte, lte } from './semver.js';
+/**
+ * Check if an SDK version is compatible with the current API
+ */
+export function isSDKVersionCompatible(sdkVersion) {
+    try {
+        const version = parseVersion(sdkVersion);
+        const min = parseVersion(MIN_SDK_VERSION);
+        const max = parseVersion(MAX_SDK_VERSION);
+        return gte(version, min) && lte(version, max);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if an A2A protocol version is supported
+ */
+export function isA2AVersionSupported(protocolVersion) {
+    return SUPPORTED_A2A_VERSIONS.includes(protocolVersion);
+}
+/**
+ * Get version info for health/status endpoints
+ */
+export function getVersionInfo() {
+    return {
+        platform: PLATFORM_VERSION,
+        api: API_VERSION,
+        a2a: A2A_PROTOCOL_VERSION,
+        schema: SCHEMA_VERSION,
+        adl: ADL_VERSION,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/versioning/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/versioning/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,mBAAmB;AACnB,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAExC,mBAAmB;AACnB,OAAO,EAGL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,eAAe,EACf,EAAE,EACF,EAAE,EACF,EAAE,EACF,GAAG,EACH,GAAG,EACH,SAAS,EACT,YAAY,EACZ,oBAAoB,EACpB,SAAS,EACT,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,uBAAuB;AACvB,OAAO,EAGL,yBAAyB,EACzB,sBAAsB,EACtB,UAAU,EACV,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,0BAA0B;AAC1B,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC;AAEhC,6BAA6B;AAC7B,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,IAAI,CAAU,CAAC;AAEtD,0CAA0C;AAC1C,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AAEvC,0CAA0C;AAC1C,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAC;AAEzC,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E,2BAA2B;AAC3B,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAE1C,sCAAsC;AACtC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAK,CAAU,CAAC;AAEvD,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E,6BAA6B;AAC7B,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAElC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC;AAEjC,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,EAAgB,MAAM,aAAa,CAAC;AAEnE;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;QAE1C,OAAO,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,eAAuB;IAC3D,OAAO,sBAAsB,CAAC,QAAQ,CAAC,eAAsB,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAO5B,OAAO;QACL,QAAQ,EAAE,gBAAgB;QAC1B,GAAG,EAAE,WAAW;QAChB,GAAG,EAAE,oBAAoB;QACzB,MAAM,EAAE,cAAc;QACtB,GAAG,EAAE,WAAW;KACjB,CAAC;AACJ,CAAC"}