Risk Engine

import { assessRisk, financialContext } from '@mnemom/risk';

const assessment = await assessRisk('agent-abc-123', {
  action_type: 'financial_transaction',
  risk_tolerance: 'conservative',
  amount: 50000,
  counterparty_id: 'vendor-xyz',
});

console.log(assessment.risk_level);      // 'low' | 'medium' | 'high' | 'critical'
console.log(assessment.recommendation);  // 'approve' | 'review' | 'deny'
console.log(assessment.risk_score);      // 0.0 – 1.0

import { assessTeamRisk } from '@mnemom/risk';

const teamAssessment = await assessTeamRisk(
  ['agent-a', 'agent-b', 'agent-c'],
  {
    action_type: 'multi_agent_coordination',
    risk_tolerance: 'moderate',
    team_task: 'customer-support-pipeline',
    coordination_mode: 'sequential',
  }
);

console.log(teamAssessment.team_risk_level);       // 'low' | 'medium' | 'high' | 'critical'
console.log(teamAssessment.team_recommendation);   // 'approve_team' | 'approve_individuals_only' | 'deny'
console.log(teamAssessment.shapley_values);        // { 'agent-a': 0.12, 'agent-b': -0.03, ... }
console.log(teamAssessment.synergy_type);          // 'synergistic' | 'neutral' | 'anti-synergistic'

// Team risk assessments contribute to the Team Trust Rating —
// the Coherence History and Operational Record components are
// computed from historical team risk assessment results.

import { createRiskGate } from '@mnemom/risk';

const gate = createRiskGate({
  maxApproveScore: 0.30,   // auto-approve below this
  maxReviewScore: 0.60,    // require review between 0.30–0.60
  // above 0.60 → auto-deny
});

const decision = await gate.check('agent-abc-123', {
  action_type: 'data_access',
  risk_tolerance: 'moderate',
});

if (decision.allowed) {
  // proceed with the action
} else if (decision.requiresReview) {
  // escalate to human supervisor
} else {
  // block the action
  console.log(decision.reason);
}

import { createTeamRiskGate } from '@mnemom/risk';

const teamGate = createTeamRiskGate({
  maxApproveScore: 0.25,
  allowIndividualsOnly: true, // if team is denied but individuals pass, allow solo ops
});

const teamDecision = await teamGate.check(
  ['agent-a', 'agent-b', 'agent-c'],
  { action_type: 'task_delegation', risk_tolerance: 'conservative' }
);

switch (teamDecision.recommendation) {
  case 'approve_team':
    // full team operation allowed
    break;
  case 'approve_individuals_only':
    // dispatch agents individually, no joint operations
    break;
  case 'deny':
    // block everything
    break;
}

import { financialContext, delegationContext, dataAccessContext } from '@mnemom/risk';

// Financial transaction with amount and counterparty
const ctx1 = financialContext(50000, 'vendor-xyz', 'conservative');

// Task delegation with team context
const ctx2 = delegationContext('customer-support-pipeline', 'sequential');

// Data access with use case
const ctx3 = dataAccessContext('audit-report-generation');

import { getRiskHistory } from '@mnemom/risk';

const history = await getRiskHistory('agent-abc-123', { limit: 50 });

for (const assessment of history) {
  console.log(`${assessment.created_at}: ${assessment.risk_score} (${assessment.risk_level})`);
}

import { getAssessment } from '@mnemom/risk';

const assessment = await getAssessment('ra_01HXY...');

if (assessment.proof_status === 'verified') {
  console.log('Risk score is cryptographically proven correct');
  console.log('Proof ID:', assessment.proof_id);
}