agent-decision-preflight

Before an autonomous coding agent installs or adopts software, return a bounded GO, WARN, or BLOCK decision with evidence and a portable SALT19 verification receipt.

Price: $0.45 USDC equivalent
Endpoint: POST /v1/agent-decision-preflight
Network: Base mainnet · eip155:8453
Asset: USDC
MCP tool: agent-decision-preflight
External payability: PASS · 2026-10-08T19:55:01.298Z

When an agent should use it

should my coding agent install this dependency
verify software before an autonomous agent adopts it
GO WARN BLOCK decision before installing a package or repository
software adoption preflight with evidence for an AI coding agent

Input schema

{
  "type": "object",
  "properties": {
    "decision_type": {
      "type": "string",
      "enum": [
        "npm_dependency",
        "github_repository"
      ]
    },
    "target": {
      "type": "object",
      "properties": {
        "package": {
          "type": "string",
          "minLength": 1,
          "maxLength": 214
        },
        "version": {
          "type": "string",
          "maxLength": 64
        },
        "repo": {
          "type": "string",
          "maxLength": 512
        }
      },
      "additionalProperties": false
    },
    "constraints": {
      "type": "object",
      "properties": {
        "max_vulnerabilities": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100
        },
        "require_license": {
          "type": "boolean"
        },
        "require_latest": {
          "type": "boolean"
        },
        "max_days_since_push": {
          "type": "integer",
          "minimum": 1,
          "maximum": 3650
        }
      },
      "additionalProperties": false
    }
  },
  "required": [
    "decision_type",
    "target"
  ],
  "additionalProperties": false
}

Example request

{
  "decision_type": "npm_dependency",
  "target": {
    "package": "hono",
    "version": "4.13.3"
  },
  "constraints": {
    "max_vulnerabilities": 0,
    "require_license": true
  }
}

Example output

{
  "verdict": "GO",
  "score": 100,
  "confidence": 0.95,
  "reasons": [
    "No OSV vulnerability records returned for this package/version."
  ],
  "evidence": {
    "package": "hono",
    "version": "4.13.3",
    "vulnerabilities": 0
  },
  "receipt": {
    "evidence_sha256": "...",
    "verification_url": "https://api.salt19.com/receipts/..."
  }
}

x402 flow

POST /v1/agent-decision-preflight
→ HTTP 402 + PAYMENT-REQUIRED
→ buyer authorizes locally
→ retry same request with PAYMENT-SIGNATURE
→ one governed execution + machine-readable JSON

Discovery: OpenAPI · x402 · llms.txt

A valid 402/payability probe is operational evidence, not proof of independent demand, future settlement, or semantic correctness.