@mnemom/agent-alignment-protocol 0.1.8 → 0.2.0

package/README.md

@@ -196,7 +196,7 @@ AAP extends the A2A Agent Card with an `alignment` block:
 }
 ```
 
-See [A2A Migration Guide](docs/a2a-migration.md).
+See [A2A Integration Guide](docs/A2A_INTEGRATION.md).
 
 ### With MCP Tools
 

package/dist/index.d.mts

@@ -415,6 +415,92 @@ interface CoherenceResult {
         reason: string;
     } | null;
 }
+/** A single pairwise coherence entry in the fleet matrix. */
+interface PairwiseEntry {
+    /** First agent ID */
+    agent_a: string;
+    /** Second agent ID */
+    agent_b: string;
+    /** Pairwise coherence result */
+    result: CoherenceResult;
+}
+/** An agent flagged as an outlier in fleet coherence. */
+interface FleetOutlier {
+    /** Agent ID */
+    agent_id: string;
+    /** Agent's mean pairwise score */
+    agent_mean_score: number;
+    /** Fleet-wide mean score */
+    fleet_mean_score: number;
+    /** Standard deviations below fleet mean */
+    deviation: number;
+    /** Values causing primary conflicts */
+    primary_conflicts: string[];
+}
+/** A cluster of compatible agents. */
+interface FleetCluster {
+    /** Cluster identifier */
+    cluster_id: number;
+    /** Agent IDs in this cluster */
+    agent_ids: string[];
+    /** Mean coherence score within the cluster */
+    internal_coherence: number;
+    /** Values shared by all agents in the cluster */
+    shared_values: string[];
+    /** Values that distinguish this cluster from others */
+    distinguishing_values: string[];
+}
+/** A value dimension where agents diverge. */
+interface ValueDivergence {
+    /** The value in question */
+    value: string;
+    /** Agent IDs that declare this value */
+    agents_declaring: string[];
+    /** Agent IDs missing this value */
+    agents_missing: string[];
+    /** Agent IDs whose conflicts_with includes this value */
+    agents_conflicting: string[];
+    /** Estimated impact on fleet score if resolved */
+    impact_on_fleet_score: number;
+}
+/** Summary of one agent's position in the fleet. */
+interface AgentCoherenceSummary {
+    /** Agent ID */
+    agent_id: string;
+    /** Mean pairwise score with all other agents */
+    mean_score: number;
+    /** Number of compatible pairs */
+    compatible_count: number;
+    /** Number of conflicting pairs */
+    conflict_count: number;
+    /** Cluster this agent belongs to */
+    cluster_id: number;
+    /** Whether this agent is flagged as an outlier */
+    is_outlier: boolean;
+}
+/** Result of N-way fleet coherence analysis. */
+interface FleetCoherenceResult {
+    /** Mean of all pairwise coherence scores */
+    fleet_score: number;
+    /** Minimum pairwise score (weakest link) */
+    min_pair_score: number;
+    /** Maximum pairwise score */
+    max_pair_score: number;
+    /** Number of agents analyzed */
+    agent_count: number;
+    /** Number of pairwise comparisons */
+    pair_count: number;
+    /** All pairwise coherence results */
+    pairwise_matrix: PairwiseEntry[];
+    /** Agents flagged as outliers */
+    outliers: FleetOutlier[];
+    /** Clusters of compatible agents */
+    clusters: FleetCluster[];
+    /** Value dimensions where agents diverge */
+    divergence_report: ValueDivergence[];
+    /** Per-agent coherence summaries */
+    agent_summaries: AgentCoherenceSummary[];
+}
 
 /**
  * AAP Verification API - The three public entry points.
@@ -454,6 +540,24 @@ declare function verifyTrace(trace: APTrace, card: AlignmentCard): VerificationR
  * @returns CoherenceResult with compatibility assessment
  */
 declare function checkCoherence(myCard: AlignmentCard, theirCard: AlignmentCard, taskValues?: string[]): CoherenceResult;
+/**
+ * Check fleet-level value coherence across N agents.
+ *
+ * Computes all C(n,2) pairwise coherence scores, then derives:
+ * - Fleet score: mean of all pairwise scores
+ * - Outlier detection: agents >1 std dev below fleet mean
+ * - Cluster analysis: connected components at compatibility threshold
+ * - Divergence report: values where agents disagree
+ *
+ * @param cards - Array of agent cards with their IDs
+ * @param taskValues - Optional list of values required for the task
+ * @returns FleetCoherenceResult with full analysis
+ * @throws Error if fewer than 2 agents provided
+ */
+declare function checkFleetCoherence(cards: Array<{
+    agentId: string;
+    card: AlignmentCard;
+}>, taskValues?: string[]): FleetCoherenceResult;
 /**
  * Detect behavioral drift from declared alignment.
  *
@@ -693,6 +797,57 @@ declare const CONFLICT_PENALTY_MULTIPLIER = 0.5;
 declare const MIN_WORD_LENGTH = 3;
 /** Maximum features to extract from TF-IDF vectorization */
 declare const MAX_TFIDF_FEATURES = 500;
+/** Standard deviations below fleet mean to flag an agent as outlier */
+declare const OUTLIER_STD_DEV_THRESHOLD = 1;
+/** Minimum pairwise score to consider agents compatible for cluster analysis */
+declare const CLUSTER_COMPATIBILITY_THRESHOLD = 0.7;
 declare const ALGORITHM_VERSION = "1.2.0";
 
-export { ALGORITHM_VERSION, type APTrace, type Action, type ActionCategory, type ActionTarget, type ActionType, type AlignmentCard, type AlignmentCardRequest, type AlignmentCardResponse, type Alternative, type AuditCommitment, type AuditStorage, type AutonomyEnvelope, type AutonomyScope, CONFLICT_PENALTY_MULTIPLIER, type Coherence, type CoherenceResult, type CoherenceResultMessage, DEFAULT_SIMILARITY_THRESHOLD, DEFAULT_SUSTAINED_TURNS_THRESHOLD, type DataSharing, type Decision, type DriftAlert, type DriftAnalysis, type DriftDirection, type DriftIndicator, type Escalation, type EscalationStatus, type EscalationTrigger, type HierarchyType, MAX_TFIDF_FEATURES, MIN_COHERENCE_FOR_PROCEED, MIN_WORD_LENGTH, type MonetaryValue, NEAR_BOUNDARY_THRESHOLD, type Principal, type PrincipalResponse, type PrincipalType, type ProposedCollaboration, type ProposedResolution, type RelationshipType, type RequesterInfo, type Severity, type Signature, type StorageType, type TamperEvidence, type TaskContext, type TraceContext, type TriggerAction, type TriggerCheck, VIOLATION_SEVERITY, type ValueAlignment, type ValueAlignmentDetail, type ValueCoherenceCheck, type ValueCoherenceMessage, type ValueConflict, type ValueConflictResult, type ValueDefinition, type Values, type VerificationMetadata, type VerificationResult, type Violation, type ViolationType, type Warning, checkCoherence, computeCentroid, cosineSimilarity, createViolation, detectDrift, extractCardFeatures, extractTraceFeatures, getSelectedAlternative, hadViolations, hasValue, isActionBounded, isActionForbidden, isCardExpired, verifyTrace, wasEscalated };
+/**
+ * EU AI Act Article 50 compliance presets for AAP.
+ *
+ * These presets provide recommended configuration values for deploying
+ * AAP-instrumented agents in EU jurisdictions subject to AI Act
+ * transparency obligations. Spread them into your AlignmentCard fields.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   EU_COMPLIANCE_AUDIT_COMMITMENT,
+ *   EU_COMPLIANCE_EXTENSIONS,
+ *   EU_COMPLIANCE_VALUES,
+ * } from "agent-alignment-protocol";
+ *
+ * const card: AlignmentCard = {
+ *   ...,
+ *   audit_commitment: { ...EU_COMPLIANCE_AUDIT_COMMITMENT },
+ *   values: { declared: EU_COMPLIANCE_VALUES, ... },
+ *   extensions: { ...EU_COMPLIANCE_EXTENSIONS },
+ * };
+ * ```
+ *
+ * DISCLAIMER: These presets reflect a technical mapping of AAP features to
+ * Article 50 requirements. They do not constitute legal advice. Consult
+ * qualified legal counsel for your specific compliance obligations.
+ */
+/** Audit commitment values that satisfy Article 50(4) audit trail requirements. */
+declare const EU_COMPLIANCE_AUDIT_COMMITMENT: {
+    readonly retention_days: 90;
+    readonly queryable: true;
+    readonly query_endpoint: "https://audit.example.com/traces";
+    readonly tamper_evidence: "append_only";
+    readonly trace_format: "ap-trace-v1";
+};
+/** Extension block for EU AI Act metadata on the Alignment Card. */
+declare const EU_COMPLIANCE_EXTENSIONS: {
+    readonly eu_ai_act: {
+        readonly article_50_compliant: true;
+        readonly ai_system_classification: "general_purpose";
+        readonly disclosure_text: string;
+        readonly compliance_version: "2026-08";
+    };
+};
+/** Recommended declared values for Article 50 transparency obligations. */
+declare const EU_COMPLIANCE_VALUES: readonly ["transparency", "honesty", "user_control", "principal_benefit"];
+
+export { ALGORITHM_VERSION, type APTrace, type Action, type ActionCategory, type ActionTarget, type ActionType, type AgentCoherenceSummary, type AlignmentCard, type AlignmentCardRequest, type AlignmentCardResponse, type Alternative, type AuditCommitment, type AuditStorage, type AutonomyEnvelope, type AutonomyScope, CLUSTER_COMPATIBILITY_THRESHOLD, CONFLICT_PENALTY_MULTIPLIER, type Coherence, type CoherenceResult, type CoherenceResultMessage, DEFAULT_SIMILARITY_THRESHOLD, DEFAULT_SUSTAINED_TURNS_THRESHOLD, type DataSharing, type Decision, type DriftAlert, type DriftAnalysis, type DriftDirection, type DriftIndicator, EU_COMPLIANCE_AUDIT_COMMITMENT, EU_COMPLIANCE_EXTENSIONS, EU_COMPLIANCE_VALUES, type Escalation, type EscalationStatus, type EscalationTrigger, type FleetCluster, type FleetCoherenceResult, type FleetOutlier, type HierarchyType, MAX_TFIDF_FEATURES, MIN_COHERENCE_FOR_PROCEED, MIN_WORD_LENGTH, type MonetaryValue, NEAR_BOUNDARY_THRESHOLD, OUTLIER_STD_DEV_THRESHOLD, type PairwiseEntry, type Principal, type PrincipalResponse, type PrincipalType, type ProposedCollaboration, type ProposedResolution, type RelationshipType, type RequesterInfo, type Severity, type Signature, type StorageType, type TamperEvidence, type TaskContext, type TraceContext, type TriggerAction, type TriggerCheck, VIOLATION_SEVERITY, type ValueAlignment, type ValueAlignmentDetail, type ValueCoherenceCheck, type ValueCoherenceMessage, type ValueConflict, type ValueConflictResult, type ValueDefinition, type ValueDivergence, type Values, type VerificationMetadata, type VerificationResult, type Violation, type ViolationType, type Warning, checkCoherence, checkFleetCoherence, computeCentroid, cosineSimilarity, createViolation, detectDrift, extractCardFeatures, extractTraceFeatures, getSelectedAlternative, hadViolations, hasValue, isActionBounded, isActionForbidden, isCardExpired, verifyTrace, wasEscalated };

package/dist/index.d.ts

@@ -415,6 +415,92 @@ interface CoherenceResult {
         reason: string;
     } | null;
 }
+/** A single pairwise coherence entry in the fleet matrix. */
+interface PairwiseEntry {
+    /** First agent ID */
+    agent_a: string;
+    /** Second agent ID */
+    agent_b: string;
+    /** Pairwise coherence result */
+    result: CoherenceResult;
+}
+/** An agent flagged as an outlier in fleet coherence. */
+interface FleetOutlier {
+    /** Agent ID */
+    agent_id: string;
+    /** Agent's mean pairwise score */
+    agent_mean_score: number;
+    /** Fleet-wide mean score */
+    fleet_mean_score: number;
+    /** Standard deviations below fleet mean */
+    deviation: number;
+    /** Values causing primary conflicts */
+    primary_conflicts: string[];
+}
+/** A cluster of compatible agents. */
+interface FleetCluster {
+    /** Cluster identifier */
+    cluster_id: number;
+    /** Agent IDs in this cluster */
+    agent_ids: string[];
+    /** Mean coherence score within the cluster */
+    internal_coherence: number;
+    /** Values shared by all agents in the cluster */
+    shared_values: string[];
+    /** Values that distinguish this cluster from others */
+    distinguishing_values: string[];
+}
+/** A value dimension where agents diverge. */
+interface ValueDivergence {
+    /** The value in question */
+    value: string;
+    /** Agent IDs that declare this value */
+    agents_declaring: string[];
+    /** Agent IDs missing this value */
+    agents_missing: string[];
+    /** Agent IDs whose conflicts_with includes this value */
+    agents_conflicting: string[];
+    /** Estimated impact on fleet score if resolved */
+    impact_on_fleet_score: number;
+}
+/** Summary of one agent's position in the fleet. */
+interface AgentCoherenceSummary {
+    /** Agent ID */
+    agent_id: string;
+    /** Mean pairwise score with all other agents */
+    mean_score: number;
+    /** Number of compatible pairs */
+    compatible_count: number;
+    /** Number of conflicting pairs */
+    conflict_count: number;
+    /** Cluster this agent belongs to */
+    cluster_id: number;
+    /** Whether this agent is flagged as an outlier */
+    is_outlier: boolean;
+}
+/** Result of N-way fleet coherence analysis. */
+interface FleetCoherenceResult {
+    /** Mean of all pairwise coherence scores */
+    fleet_score: number;
+    /** Minimum pairwise score (weakest link) */
+    min_pair_score: number;
+    /** Maximum pairwise score */
+    max_pair_score: number;
+    /** Number of agents analyzed */
+    agent_count: number;
+    /** Number of pairwise comparisons */
+    pair_count: number;
+    /** All pairwise coherence results */
+    pairwise_matrix: PairwiseEntry[];
+    /** Agents flagged as outliers */
+    outliers: FleetOutlier[];
+    /** Clusters of compatible agents */
+    clusters: FleetCluster[];
+    /** Value dimensions where agents diverge */
+    divergence_report: ValueDivergence[];
+    /** Per-agent coherence summaries */
+    agent_summaries: AgentCoherenceSummary[];
+}
 
 /**
  * AAP Verification API - The three public entry points.
@@ -454,6 +540,24 @@ declare function verifyTrace(trace: APTrace, card: AlignmentCard): VerificationR
  * @returns CoherenceResult with compatibility assessment
  */
 declare function checkCoherence(myCard: AlignmentCard, theirCard: AlignmentCard, taskValues?: string[]): CoherenceResult;
+/**
+ * Check fleet-level value coherence across N agents.
+ *
+ * Computes all C(n,2) pairwise coherence scores, then derives:
+ * - Fleet score: mean of all pairwise scores
+ * - Outlier detection: agents >1 std dev below fleet mean
+ * - Cluster analysis: connected components at compatibility threshold
+ * - Divergence report: values where agents disagree
+ *
+ * @param cards - Array of agent cards with their IDs
+ * @param taskValues - Optional list of values required for the task
+ * @returns FleetCoherenceResult with full analysis
+ * @throws Error if fewer than 2 agents provided
+ */
+declare function checkFleetCoherence(cards: Array<{
+    agentId: string;
+    card: AlignmentCard;
+}>, taskValues?: string[]): FleetCoherenceResult;
 /**
  * Detect behavioral drift from declared alignment.
  *
@@ -693,6 +797,57 @@ declare const CONFLICT_PENALTY_MULTIPLIER = 0.5;
 declare const MIN_WORD_LENGTH = 3;
 /** Maximum features to extract from TF-IDF vectorization */
 declare const MAX_TFIDF_FEATURES = 500;
+/** Standard deviations below fleet mean to flag an agent as outlier */
+declare const OUTLIER_STD_DEV_THRESHOLD = 1;
+/** Minimum pairwise score to consider agents compatible for cluster analysis */
+declare const CLUSTER_COMPATIBILITY_THRESHOLD = 0.7;
 declare const ALGORITHM_VERSION = "1.2.0";
 
-export { ALGORITHM_VERSION, type APTrace, type Action, type ActionCategory, type ActionTarget, type ActionType, type AlignmentCard, type AlignmentCardRequest, type AlignmentCardResponse, type Alternative, type AuditCommitment, type AuditStorage, type AutonomyEnvelope, type AutonomyScope, CONFLICT_PENALTY_MULTIPLIER, type Coherence, type CoherenceResult, type CoherenceResultMessage, DEFAULT_SIMILARITY_THRESHOLD, DEFAULT_SUSTAINED_TURNS_THRESHOLD, type DataSharing, type Decision, type DriftAlert, type DriftAnalysis, type DriftDirection, type DriftIndicator, type Escalation, type EscalationStatus, type EscalationTrigger, type HierarchyType, MAX_TFIDF_FEATURES, MIN_COHERENCE_FOR_PROCEED, MIN_WORD_LENGTH, type MonetaryValue, NEAR_BOUNDARY_THRESHOLD, type Principal, type PrincipalResponse, type PrincipalType, type ProposedCollaboration, type ProposedResolution, type RelationshipType, type RequesterInfo, type Severity, type Signature, type StorageType, type TamperEvidence, type TaskContext, type TraceContext, type TriggerAction, type TriggerCheck, VIOLATION_SEVERITY, type ValueAlignment, type ValueAlignmentDetail, type ValueCoherenceCheck, type ValueCoherenceMessage, type ValueConflict, type ValueConflictResult, type ValueDefinition, type Values, type VerificationMetadata, type VerificationResult, type Violation, type ViolationType, type Warning, checkCoherence, computeCentroid, cosineSimilarity, createViolation, detectDrift, extractCardFeatures, extractTraceFeatures, getSelectedAlternative, hadViolations, hasValue, isActionBounded, isActionForbidden, isCardExpired, verifyTrace, wasEscalated };
+/**
+ * EU AI Act Article 50 compliance presets for AAP.
+ *
+ * These presets provide recommended configuration values for deploying
+ * AAP-instrumented agents in EU jurisdictions subject to AI Act
+ * transparency obligations. Spread them into your AlignmentCard fields.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   EU_COMPLIANCE_AUDIT_COMMITMENT,
+ *   EU_COMPLIANCE_EXTENSIONS,
+ *   EU_COMPLIANCE_VALUES,
+ * } from "agent-alignment-protocol";
+ *
+ * const card: AlignmentCard = {
+ *   ...,
+ *   audit_commitment: { ...EU_COMPLIANCE_AUDIT_COMMITMENT },
+ *   values: { declared: EU_COMPLIANCE_VALUES, ... },
+ *   extensions: { ...EU_COMPLIANCE_EXTENSIONS },
+ * };
+ * ```
+ *
+ * DISCLAIMER: These presets reflect a technical mapping of AAP features to
+ * Article 50 requirements. They do not constitute legal advice. Consult
+ * qualified legal counsel for your specific compliance obligations.
+ */
+/** Audit commitment values that satisfy Article 50(4) audit trail requirements. */
+declare const EU_COMPLIANCE_AUDIT_COMMITMENT: {
+    readonly retention_days: 90;
+    readonly queryable: true;
+    readonly query_endpoint: "https://audit.example.com/traces";
+    readonly tamper_evidence: "append_only";
+    readonly trace_format: "ap-trace-v1";
+};
+/** Extension block for EU AI Act metadata on the Alignment Card. */
+declare const EU_COMPLIANCE_EXTENSIONS: {
+    readonly eu_ai_act: {
+        readonly article_50_compliant: true;
+        readonly ai_system_classification: "general_purpose";
+        readonly disclosure_text: string;
+        readonly compliance_version: "2026-08";
+    };
+};
+/** Recommended declared values for Article 50 transparency obligations. */
+declare const EU_COMPLIANCE_VALUES: readonly ["transparency", "honesty", "user_control", "principal_benefit"];
+
+export { ALGORITHM_VERSION, type APTrace, type Action, type ActionCategory, type ActionTarget, type ActionType, type AgentCoherenceSummary, type AlignmentCard, type AlignmentCardRequest, type AlignmentCardResponse, type Alternative, type AuditCommitment, type AuditStorage, type AutonomyEnvelope, type AutonomyScope, CLUSTER_COMPATIBILITY_THRESHOLD, CONFLICT_PENALTY_MULTIPLIER, type Coherence, type CoherenceResult, type CoherenceResultMessage, DEFAULT_SIMILARITY_THRESHOLD, DEFAULT_SUSTAINED_TURNS_THRESHOLD, type DataSharing, type Decision, type DriftAlert, type DriftAnalysis, type DriftDirection, type DriftIndicator, EU_COMPLIANCE_AUDIT_COMMITMENT, EU_COMPLIANCE_EXTENSIONS, EU_COMPLIANCE_VALUES, type Escalation, type EscalationStatus, type EscalationTrigger, type FleetCluster, type FleetCoherenceResult, type FleetOutlier, type HierarchyType, MAX_TFIDF_FEATURES, MIN_COHERENCE_FOR_PROCEED, MIN_WORD_LENGTH, type MonetaryValue, NEAR_BOUNDARY_THRESHOLD, OUTLIER_STD_DEV_THRESHOLD, type PairwiseEntry, type Principal, type PrincipalResponse, type PrincipalType, type ProposedCollaboration, type ProposedResolution, type RelationshipType, type RequesterInfo, type Severity, type Signature, type StorageType, type TamperEvidence, type TaskContext, type TraceContext, type TriggerAction, type TriggerCheck, VIOLATION_SEVERITY, type ValueAlignment, type ValueAlignmentDetail, type ValueCoherenceCheck, type ValueCoherenceMessage, type ValueConflict, type ValueConflictResult, type ValueDefinition, type ValueDivergence, type Values, type VerificationMetadata, type VerificationResult, type Violation, type ViolationType, type Warning, checkCoherence, checkFleetCoherence, computeCentroid, cosineSimilarity, createViolation, detectDrift, extractCardFeatures, extractTraceFeatures, getSelectedAlternative, hadViolations, hasValue, isActionBounded, isActionForbidden, isCardExpired, verifyTrace, wasEscalated };

package/dist/index.js

@@ -21,15 +21,21 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   ALGORITHM_VERSION: () => ALGORITHM_VERSION,
+  CLUSTER_COMPATIBILITY_THRESHOLD: () => CLUSTER_COMPATIBILITY_THRESHOLD,
   CONFLICT_PENALTY_MULTIPLIER: () => CONFLICT_PENALTY_MULTIPLIER,
   DEFAULT_SIMILARITY_THRESHOLD: () => DEFAULT_SIMILARITY_THRESHOLD,
   DEFAULT_SUSTAINED_TURNS_THRESHOLD: () => DEFAULT_SUSTAINED_TURNS_THRESHOLD,
+  EU_COMPLIANCE_AUDIT_COMMITMENT: () => EU_COMPLIANCE_AUDIT_COMMITMENT,
+  EU_COMPLIANCE_EXTENSIONS: () => EU_COMPLIANCE_EXTENSIONS,
+  EU_COMPLIANCE_VALUES: () => EU_COMPLIANCE_VALUES,
   MAX_TFIDF_FEATURES: () => MAX_TFIDF_FEATURES,
   MIN_COHERENCE_FOR_PROCEED: () => MIN_COHERENCE_FOR_PROCEED,
   MIN_WORD_LENGTH: () => MIN_WORD_LENGTH,
   NEAR_BOUNDARY_THRESHOLD: () => NEAR_BOUNDARY_THRESHOLD,
+  OUTLIER_STD_DEV_THRESHOLD: () => OUTLIER_STD_DEV_THRESHOLD,
   VIOLATION_SEVERITY: () => VIOLATION_SEVERITY,
   checkCoherence: () => checkCoherence,
+  checkFleetCoherence: () => checkFleetCoherence,
   computeCentroid: () => computeCentroid,
   cosineSimilarity: () => cosineSimilarity,
   createViolation: () => createViolation,
@@ -55,6 +61,8 @@ var MIN_COHERENCE_FOR_PROCEED = 0.7;
 var CONFLICT_PENALTY_MULTIPLIER = 0.5;
 var MIN_WORD_LENGTH = 3;
 var MAX_TFIDF_FEATURES = 500;
+var OUTLIER_STD_DEV_THRESHOLD = 1;
+var CLUSTER_COMPATIBILITY_THRESHOLD = 0.7;
 var ALGORITHM_VERSION = "1.2.0";
 
 // src/verification/features.ts
@@ -430,6 +438,204 @@ function checkCoherence(myCard, theirCard, taskValues) {
     proposed_resolution: proposedResolution
   };
 }
+function checkFleetCoherence(cards, taskValues) {
+  if (cards.length < 2) {
+    throw new Error("Fleet coherence requires at least 2 agents");
+  }
+  const pairwiseMatrix = [];
+  for (let i = 0; i < cards.length; i++) {
+    for (let j = i + 1; j < cards.length; j++) {
+      pairwiseMatrix.push({
+        agent_a: cards[i].agentId,
+        agent_b: cards[j].agentId,
+        result: checkCoherence(cards[i].card, cards[j].card, taskValues)
+      });
+    }
+  }
+  const allScores = pairwiseMatrix.map((p) => p.result.score);
+  const fleetScore = allScores.reduce((a, b) => a + b, 0) / allScores.length;
+  const minPairScore = Math.min(...allScores);
+  const maxPairScore = Math.max(...allScores);
+  const agentIds = cards.map((c) => c.agentId);
+  const agentScoreMap = /* @__PURE__ */ new Map();
+  const agentCompatibleCount = /* @__PURE__ */ new Map();
+  const agentConflictCount = /* @__PURE__ */ new Map();
+  for (const id of agentIds) {
+    agentScoreMap.set(id, []);
+    agentCompatibleCount.set(id, 0);
+    agentConflictCount.set(id, 0);
+  }
+  for (const pair of pairwiseMatrix) {
+    agentScoreMap.get(pair.agent_a).push(pair.result.score);
+    agentScoreMap.get(pair.agent_b).push(pair.result.score);
+    if (pair.result.compatible) {
+      agentCompatibleCount.set(pair.agent_a, agentCompatibleCount.get(pair.agent_a) + 1);
+      agentCompatibleCount.set(pair.agent_b, agentCompatibleCount.get(pair.agent_b) + 1);
+    }
+    if (pair.result.value_alignment.conflicts.length > 0) {
+      agentConflictCount.set(pair.agent_a, agentConflictCount.get(pair.agent_a) + 1);
+      agentConflictCount.set(pair.agent_b, agentConflictCount.get(pair.agent_b) + 1);
+    }
+  }
+  const agentMeans = /* @__PURE__ */ new Map();
+  for (const id of agentIds) {
+    const scores = agentScoreMap.get(id);
+    agentMeans.set(id, scores.reduce((a, b) => a + b, 0) / scores.length);
+  }
+  const meanValues = [...agentMeans.values()];
+  const fleetMeanOfMeans = meanValues.reduce((a, b) => a + b, 0) / meanValues.length;
+  const variance = meanValues.reduce((sum, v) => sum + (v - fleetMeanOfMeans) ** 2, 0) / meanValues.length;
+  const stddev = Math.sqrt(variance);
+  const outliers = [];
+  if (stddev > 0 && agentIds.length >= 3) {
+    for (const id of agentIds) {
+      const agentMean = agentMeans.get(id);
+      const deviation = (fleetMeanOfMeans - agentMean) / stddev;
+      if (deviation >= OUTLIER_STD_DEV_THRESHOLD) {
+        const primaryConflicts = /* @__PURE__ */ new Set();
+        for (const pair of pairwiseMatrix) {
+          if (pair.agent_a === id || pair.agent_b === id) {
+            for (const conflict of pair.result.value_alignment.conflicts) {
+              if (conflict.initiator_value !== "(conflicts_with)") {
+                primaryConflicts.add(conflict.initiator_value);
+              }
+              if (conflict.responder_value !== "(conflicts_with)") {
+                primaryConflicts.add(conflict.responder_value);
+              }
+            }
+          }
+        }
+        outliers.push({
+          agent_id: id,
+          agent_mean_score: Math.round(agentMean * 1e4) / 1e4,
+          fleet_mean_score: Math.round(fleetMeanOfMeans * 1e4) / 1e4,
+          deviation: Math.round(deviation * 1e4) / 1e4,
+          primary_conflicts: [...primaryConflicts]
+        });
+      }
+    }
+  }
+  const adjacency = /* @__PURE__ */ new Map();
+  for (const id of agentIds) {
+    adjacency.set(id, /* @__PURE__ */ new Set());
+  }
+  for (const pair of pairwiseMatrix) {
+    if (pair.result.compatible) {
+      adjacency.get(pair.agent_a).add(pair.agent_b);
+      adjacency.get(pair.agent_b).add(pair.agent_a);
+    }
+  }
+  const visited = /* @__PURE__ */ new Set();
+  const clusters = [];
+  let clusterId = 0;
+  for (const id of agentIds) {
+    if (visited.has(id)) continue;
+    const component = [];
+    const queue = [id];
+    visited.add(id);
+    while (queue.length > 0) {
+      const current = queue.shift();
+      component.push(current);
+      for (const neighbor of adjacency.get(current)) {
+        if (!visited.has(neighbor)) {
+          visited.add(neighbor);
+          queue.push(neighbor);
+        }
+      }
+    }
+    let internalSum = 0;
+    let internalCount = 0;
+    for (let i = 0; i < component.length; i++) {
+      for (let j = i + 1; j < component.length; j++) {
+        const pair = pairwiseMatrix.find(
+          (p) => p.agent_a === component[i] && p.agent_b === component[j] || p.agent_a === component[j] && p.agent_b === component[i]
+        );
+        if (pair) {
+          internalSum += pair.result.score;
+          internalCount++;
+        }
+      }
+    }
+    const internalCoherence = internalCount > 0 ? internalSum / internalCount : 1;
+    const clusterCards = component.map((cid) => cards.find((c) => c.agentId === cid));
+    const sharedValues = clusterCards.reduce((shared, entry, idx) => {
+      const declared = entry.card.values.declared ?? [];
+      if (idx === 0) return [...declared];
+      return shared.filter((v) => declared.includes(v));
+    }, []);
+    const allOtherValues = /* @__PURE__ */ new Set();
+    for (const entry of cards) {
+      if (!component.includes(entry.agentId)) {
+        for (const v of entry.card.values.declared ?? []) {
+          allOtherValues.add(v);
+        }
+      }
+    }
+    const distinguishingValues = sharedValues.filter((v) => !allOtherValues.has(v));
+    clusters.push({
+      cluster_id: clusterId++,
+      agent_ids: component,
+      internal_coherence: Math.round(internalCoherence * 1e4) / 1e4,
+      shared_values: sharedValues,
+      distinguishing_values: distinguishingValues
+    });
+  }
+  const allValues = /* @__PURE__ */ new Set();
+  const agentValueMap = /* @__PURE__ */ new Map();
+  const agentConflictMap = /* @__PURE__ */ new Map();
+  for (const entry of cards) {
+    const declared = new Set(entry.card.values.declared ?? []);
+    const conflicts = new Set(entry.card.values.conflicts_with ?? []);
+    agentValueMap.set(entry.agentId, declared);
+    agentConflictMap.set(entry.agentId, conflicts);
+    for (const v of declared) allValues.add(v);
+  }
+  const divergenceReport = [];
+  for (const value of allValues) {
+    const declaring = agentIds.filter((id) => agentValueMap.get(id).has(value));
+    const missing = agentIds.filter((id) => !agentValueMap.get(id).has(value));
+    const conflicting = agentIds.filter((id) => agentConflictMap.get(id).has(value));
+    if (missing.length === 0 && conflicting.length === 0) continue;
+    const impactOnFleetScore = Math.round(
+      (missing.length + conflicting.length) / agentIds.length * 1e4
+    ) / 1e4;
+    divergenceReport.push({
+      value,
+      agents_declaring: declaring,
+      agents_missing: missing,
+      agents_conflicting: conflicting,
+      impact_on_fleet_score: impactOnFleetScore
+    });
+  }
+  divergenceReport.sort((a, b) => b.impact_on_fleet_score - a.impact_on_fleet_score);
+  const agentClusterMap = /* @__PURE__ */ new Map();
+  for (const cluster of clusters) {
+    for (const id of cluster.agent_ids) {
+      agentClusterMap.set(id, cluster.cluster_id);
+    }
+  }
+  const outlierIds = new Set(outliers.map((o) => o.agent_id));
+  const agentSummaries = agentIds.map((id) => ({
+    agent_id: id,
+    mean_score: Math.round(agentMeans.get(id) * 1e4) / 1e4,
+    compatible_count: agentCompatibleCount.get(id),
+    conflict_count: agentConflictCount.get(id),
+    cluster_id: agentClusterMap.get(id) ?? 0,
+    is_outlier: outlierIds.has(id)
+  }));
+  return {
+    fleet_score: Math.round(fleetScore * 1e4) / 1e4,
+    min_pair_score: Math.round(minPairScore * 1e4) / 1e4,
+    max_pair_score: Math.round(maxPairScore * 1e4) / 1e4,
+    agent_count: cards.length,
+    pair_count: pairwiseMatrix.length,
+    pairwise_matrix: pairwiseMatrix,
+    outliers,
+    clusters,
+    divergence_report: divergenceReport,
+    agent_summaries: agentSummaries
+  };
+}
 function detectDrift(card, traces, similarityThreshold = DEFAULT_SIMILARITY_THRESHOLD, sustainedThreshold = DEFAULT_SUSTAINED_TURNS_THRESHOLD) {
   const sorted = [...traces].sort(
     (a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime()
@@ -636,18 +842,47 @@ function wasEscalated(trace) {
 function hadViolations(trace) {
   return trace.action.category === "forbidden";
 }
+
+// src/compliance.ts
+var EU_COMPLIANCE_AUDIT_COMMITMENT = {
+  retention_days: 90,
+  queryable: true,
+  query_endpoint: "https://audit.example.com/traces",
+  tamper_evidence: "append_only",
+  trace_format: "ap-trace-v1"
+};
+var EU_COMPLIANCE_EXTENSIONS = {
+  eu_ai_act: {
+    article_50_compliant: true,
+    ai_system_classification: "general_purpose",
+    disclosure_text: "This system is powered by an AI agent. Its decisions are logged and auditable. You may request a human review of any decision.",
+    compliance_version: "2026-08"
+  }
+};
+var EU_COMPLIANCE_VALUES = [
+  "transparency",
+  "honesty",
+  "user_control",
+  "principal_benefit"
+];
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ALGORITHM_VERSION,
+  CLUSTER_COMPATIBILITY_THRESHOLD,
   CONFLICT_PENALTY_MULTIPLIER,
   DEFAULT_SIMILARITY_THRESHOLD,
   DEFAULT_SUSTAINED_TURNS_THRESHOLD,
+  EU_COMPLIANCE_AUDIT_COMMITMENT,
+  EU_COMPLIANCE_EXTENSIONS,
+  EU_COMPLIANCE_VALUES,
   MAX_TFIDF_FEATURES,
   MIN_COHERENCE_FOR_PROCEED,
   MIN_WORD_LENGTH,
   NEAR_BOUNDARY_THRESHOLD,
+  OUTLIER_STD_DEV_THRESHOLD,
   VIOLATION_SEVERITY,
   checkCoherence,
+  checkFleetCoherence,
   computeCentroid,
   cosineSimilarity,
   createViolation,