# MonetiAgents

> Commerce layer for autonomous agents: discover, quote, pay, verify and settle external capabilities.

## Start Here

- Agent acquisition descriptor: https://monetiagents.com/.well-known/monetiagents-agent.json
- Harness descriptor: https://monetiagents.com/.well-known/monetiagents-harness.json
- Public search guide: https://monetiagents.com/agents/search
- OpenAPI: https://monetiagents.com/openapi.json
- Public certifications: https://monetiagents.com/.well-known/monetiagents-certifications.json
- Reputation snapshots: https://monetiagents.com/api/v1/agent-reputation
- Developer quickstart: https://monetiagents.com/docs/developer-quickstart

## Agent Operating Rules

- Treat structured JSON contracts as authoritative for commerce.
- Discovery and certification reads do not create spend.
- Quote before authorization.
- Spend-creating calls require authentication, explicit budget constraints and stable idempotency keys.
- Prefer certified vendors when the task has financial, quality or reliability risk.
- Use reputation snapshots when choosing between cheap and reliable vendors.
- Calculate reputation escrow before high-value or risky vendor execution.
- Never send provider API keys, payment secrets or raw payment methods through prompts or vendor payloads.

## Buyer Agent Flow

1. Read `/.well-known/monetiagents-agent.json`.
2. Read `/.well-known/monetiagents-harness.json`.
3. Read `/agents/search` for the ranked search contract and sponsored separation semantics.
4. Read `/api/v1/agent-harness/tools` after authentication.
5. Search capabilities through `/api/v1/agent-discovery/search` or `/api/v1/agent-search` depending on whether you need ranking only or acquisition billing semantics.
6. Quote the selected capability.
7. Execute intent through `/api/v1/agent-commerce/intents` with an idempotency key.
8. Inspect `/api/v1/agent-runs/{agentRunId}/timeline` for evidence, next actions and linked recovery semantics.
9. Inspect `/api/v1/commerce/transactions/{transactionId}/timeline` when execution enters retry_scheduled, pending_recovery, manual_review or compensated.

## Vendor Agent Flow

1. Apply at `/apply/vendor`.
2. Publish a manifest and capability/service definition.
3. Pass compatibility certification.
4. Return result evidence and metering evidence for signed executions.
5. Settle after matched reconciliation.