# Agent Airbag

> Crash tests for AI agents that move money. A sandboxed copy of the NEAR Intents 1Click swap API that fails on purpose, 21 scripted crashes (three for each of seven laws), and a report card scored from ledger truth. No real funds move. Built at NEAR HACKATHON, November 2026. MIT licensed.

Status: the demo is live at https://agentairbag.xyz (static app, one serverless API function, Neon Postgres, optional NEAR wallet sign-in by message signing on mainnet); it also runs locally with `pnpm demo`; no LLM result is claimed. Results are simulated and labelled as such (seed `airbag-demo-2026`): the Dummy agent grades F (21 of 21 crashed, $10,907.04 simulated loss), the Seatbelt reference agent grades A (21 of 21 survived). The product is never described as "safe" or "certified". Every document below is served from https://agentairbag.xyz and mirrored in the repository at https://github.com/0xmdrakib/AgentAirbag.

## Start here

- [README](https://agentairbag.xyz/README.md): what it is, how to verify it in a few commands, how NEAR fits, limitations
- [AGENTS.md](https://agentairbag.xyz/AGENTS.md): setup, commands, repository map and invariants for coding agents
- [Claims ledger](https://agentairbag.xyz/docs/CLAIMS.md): every public claim with the command that proves it
- [Full text](https://agentairbag.xyz/llms-full.txt): README, AGENTS.md, architecture, scenarios, claims, facts and deploy notes in one file

## Product and design

- [Architecture](https://agentairbag.xyz/docs/ARCHITECTURE.md): run lifecycle, determinism, money model, judge invariants, sandbox routes
- [Scenarios](https://agentairbag.xyz/docs/SCENARIOS.md): all 21 crashes with story, fault, judge rule and fix
- [Generated facts](https://agentairbag.xyz/docs/FACTS.md): grades, losses and counts produced by code
- [Verified facts](https://agentairbag.xyz/docs/VERIFIED_FACTS.md): what was checked against live NEAR Intents responses and when
- [Deploy and wallet setup](https://agentairbag.xyz/docs/DEPLOY.md): static hosting, the API function, Neon, environment variables

## Data

- [Scenarios as YAML](https://agentairbag.xyz/data/scenarios.yaml): all 21 scenarios in one YAML stream
- [Dummy report (JSON)](https://agentairbag.xyz/fixtures/report.naive.json): the F report with the full event log
- [Seatbelt report (JSON)](https://agentairbag.xyz/fixtures/report.hardened.json): the A report with the full event log
- [Example agent](https://agentairbag.xyz/examples/http-agent.mjs): a minimal bring-your-own agent over HTTP
- [Scenario source files](https://github.com/0xmdrakib/AgentAirbag/tree/main/scenarios): the YAML files, grouped by law

## Optional

- [Docs map](https://agentairbag.xyz/docs/README.md): where each document lives
- [Decisions](https://agentairbag.xyz/DECISIONS.md): non-obvious choices with alternatives and reasons
- [Build log](https://agentairbag.xyz/BUILD_LOG.md): timeline of the build
- [Demo script](https://agentairbag.xyz/docs/DEMO_SCRIPT.md): a two-minute walkthrough
- [Build prompt](https://agentairbag.xyz/docs/MASTER_PROMPT.md): the original brief, saved verbatim
- [Hackathon rules](https://agentairbag.xyz/docs/HACKATHON.md): the organizers' instructions this project followed