vrsai · Capabilities Package Install Preflight

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://api.vrsai.tech/v1/capabilities/package_install_preflight", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "purl": "pkg:npm/%40colors/colors@1.5.0"
  }),
});
const data = await res.json();

curl -X POST \
  "https://api.vrsai.tech/v1/capabilities/package_install_preflight" \
  -H "Content-Type: application/json" \
  -d '{"purl":"pkg:npm/%40colors/colors@1.5.0"}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "decision": "ALLOW",
  "evidence": [
    {
      "attempts": 1,
      "latency_ms": 120,
      "observed_at": "2026-08-26T00:00:00.000Z",
      "source": "npm_registry",
      "status": "OK"
    },
    {
      "attempts": 1,
      "latency_ms": 240,
      "observed_at": "2026-08-26T00:00:00.000Z",
      "source": "osv",
      "status": "OK"
    },
    {
      "attempts": 1,
      "latency_ms": 90,
      "observed_at": "2026-08-26T00:00:00.000Z",
      "source": "deps_dev",
      "status": "OK"
    }
  ],
  "input_fingerprint": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "observations": {
    "deps_dev": {
      "advisory_ids": [],
      "canonical_name": "@colors/colors",
      "canonical_version": "1.5.0",
      "licenses": [
        "MIT"
      ]
    },
    "evidence_complete": true,
    "provenance": {
      "attestation_types": [],
      "expected_repository_match": "NOT_REQUESTED",
      "source_repositories": [],
      "verified": false
    },
    "registry": {
      "deprecated": false,
      "distribution_hashes": [],
      "exists": true,
      "install_scripts": [],
      "integrity": "sha512-fixture-integrity",
      "repository_metadata": {
        "url": "https://github.com/Marak/colors.js",
        "verified": false
      },
      "yanked": "NONE",
      "yanked_reasons": []
    },
    "vulnerabilities": {
      "families": [],
      "family_count": 0,
      "malicious_package_signal": false,
      "max_severity": "NONE",
      "raw_record_count": 0
    }
  },
  "observed_at": "2026-08-26T00:00:00.000Z",
  "package": {
    "ecosystem": "npm",
    "name": "@colors/colors",
    "purl": "pkg:npm/%40colors/colors@1.5.0",
    "version": "1.5.0"
  },
  "policy_version": "balanced-2026-08-26",
  "reason_codes": [
    "NO_BLOCKING_SIGNAL_OBSERVED"
  ],
  "unknowns": []
}