How dineshkumar2006471/agentproof works
AgentProof registers deployed AI agents, turns their stated promises into versioned contracts and scenario tests, then runs verification asynchronously against the live endpoint and records explainable evidence for private or shareable reports. The graph includes the documented AWS queue/worker architecture and major billing, authentication, public-verification, and operator surfaces. Source excerpts confirm agent registration, run orchestration, contract drafting, and checkout; links for unsampled capability routes follow README-level documentation rather than inspected implementations.
Main entry points: dynamodb.ts DynamoDB records · layout.tsx Agent workspace · handler.ts Verification worker · route.ts Run and export APIs
Components 26
Workspace and API
- Agent workspace
src/app/agents/layout.tsx - Agent registry API
src/app/api/agents/route.ts - Agent detail API
src/app/api/agents/[id]/route.ts
Verification lifecycle
- Contract drafting API
src/app/api/agents/[id]/contract/draft/route.ts - Contract API
src/app/api/agents/[id]/contract/route.ts - Contract engine
src/lib/openai/contract-engine.ts - Test generation API
src/app/api/agents/[id]/generate-tests/route.ts - Scenario generator
src/lib/openai/test-generator.ts - Run orchestration API
src/app/api/agents/[id]/run/route.ts - Verification worker
workers/test-runner-worker/handler.ts - Semantic evaluation
src/lib/openai/semantic-judge.ts - Run and export APIs
src/app/api/runs/[id]/route.ts - Run report view
src/app/agents/[id]/report/[run]/page.tsx - Public report surface
src/app/verify/[publicId]/page.tsx - Public verification API
src/app/api/verify/[publicId]/route.ts
Platform services
- Amazon SQS
- DynamoDB records
src/lib/aws/dynamodb.ts - Report artifacts
src/lib/aws/s3.ts - Cognito authentication
src/lib/auth/cognito.ts - Authentication routes
src/app/api/auth/sign-in/route.ts
Plans and operations
- Checkout API
src/app/api/billing/checkout/route.ts - Dodo Payments
src/lib/dodo.ts - Payment webhook
src/app/api/webhooks/dodo/route.ts - Operator metrics
src/lib/founder.ts
Other components
- Browser / user
- Deployed agent endpoint
Connections 34
- Browser / user → Agent workspace: uses
- Agent workspace → Agent registry API: registers agents
- Agent workspace → Agent detail API: manages agents
- Agent registry API → DynamoDB records: reads/writes agents
- Agent detail API → DynamoDB records: reads/writes contracts
- Agent workspace → Contract drafting API: requests draft
- Contract drafting API → Contract engine: drafts contract
- Contract engine → DynamoDB records: returns contract data
- Contract API → DynamoDB records: stores contract
- Agent workspace → Test generation API: generates tests
- Test generation API → Scenario generator: creates scenarios
- Scenario generator → DynamoDB records: stores test matrix
- Agent workspace → Run orchestration API: starts verification
- Run orchestration API → DynamoDB records: loads inputs, records run
- Run orchestration API → Amazon SQS: enqueues run
- Amazon SQS → Verification worker: dispatches job
- Verification worker → Deployed agent endpoint: posts scenarios
- Verification worker → Semantic evaluation: evaluates responses
- Verification worker → DynamoDB records: records evidence and score
- Verification worker → Report artifacts: stores report artifacts
- Agent workspace → Run and export APIs: reviews or exports
- Run and export APIs → DynamoDB records: reads run evidence
- Run and export APIs → Report artifacts: reads artifacts
- Run report view → Run and export APIs: loads report data
- Browser / user → Public report surface: views shared report
- Public report surface → Public verification API: loads verification
- Public verification API → DynamoDB records: reads public evidence
- Agent workspace → Authentication routes: signs in
- Authentication routes → Cognito authentication: authenticates
- Browser / user → Checkout API: starts checkout
- Checkout API → Dodo Payments: creates checkout
- Dodo Payments → Payment webhook: sends payment event
- Payment webhook → DynamoDB records: updates plan state
- Operator metrics → DynamoDB records: reads aggregate signals