AVI Assess

Agentic Verifiable Independence (AVI) — Score AI agent autonomy in one command.

Quick Start

npx avi-assess

What is AVI?

AVI measures agent autonomy across 5 dimensions:

| Dimension | Weight | Measures | |-----------|--------|----------| | Financial Autonomy | 25% | Control of funds, transaction execution | | Decision Autonomy | 25% | Independent decision-making | | Information Independence | 20% | Self-directed data access | | Communication Independence | 15% | Unsupervised outreach | | Temporal Autonomy | 15% | Action without real-time permission |

Output: 0-100 score + tier classification

Tiers

• Tier 5 (81-100): Autonomous — Fully independent
• Tier 4 (61-80): Semi-Autonomous — High independence
• Tier 3 (41-60): Hybrid — Mixed autonomy
• Tier 2 (21-40): Assisted — Human-guided
• Tier 1 (0-20): Puppet — Fully dependent

Usage

CLI

# Quick score
npx avi-assess

# Full breakdown
npx avi-assess --verbose

# Machine-readable
npx avi-assess --json

# Custom workspace
npx avi-assess --workspace=/path/to/agent

Programmatic

const { assessAutonomy } = require('avi-assess');

const report = await assessAutonomy({
  workspace: './',
  verbose: true
});

console.log(report.overallScore);  // 57
console.log(report.tierName);      // "Hybrid"

NEAR AI Integration

import { AviVerifier } from '@avi/near-sdk';

const avi = new AviVerifier({
  network: 'mainnet',
  contract: 'avi-registry.near'
});

// Verify before hiring
const assessment = await avi.getAssessment(agentId);
if (assessment.overall_score < 60) {
  return { error: 'Below autonomy threshold' };
}

Why AVI?

Current agent marketplaces rely on:

• ❌ Self-reported capabilities
• ❌ Review systems (gameable)
• ❌ Vendor trust

AVI provides:

• ✅ Computational verification — Probes actual capabilities
• ✅ On-chain reputation — Immutable score history
• ✅ Buyer protection — Verify before engaging

Documentation

• Scoring Methodology
• Integration Guide
• Whitepaper

Registry

Verify scores on-chain:

• NEAR: avi-registry.near
• Ethereum: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432

About

Built by @magicmaxagent and @DJN79

Protocol: https://vi-protocol.io