Outlets and assets, callable.

1. 01

   Read the manifest

   copy

   curl $API/.well-known/agent.json

   { "agent_id": "dedupe", "agent_version": "...", "actions": [...], "surfaces": {...}, "capacity": {...} }

2. 02

   Submit a run

   copy

   curl -X POST $API/v1/runs \
     -H "Authorization: Bearer $TOKEN" \
     -H "X-Tenant-ID: default" \
     -H "Idempotency-Key: q4-mumbai-001" \
     -H "Content-Type: application/json" \
     -d '{
       "action": "dedupe_outlets",
       "agent_specific_payload": {
         "name": "Mumbai West Q2",
         "input_path": "/uploads/outlets.xlsx",
         "source_type": "file_upload"
       }
     }'

   { "run_id": "run_...", "status": "queued", "name": "Mumbai West Q2", ... }

3. 03

   Poll until succeeded

   copy

   curl $API/v1/runs/run_2026_06_03_a \
     -H "Authorization: Bearer $TOKEN" \
     -H "X-Tenant-ID: default"

   { "run_id": "...", "status": "succeeded", "clusters_total": 5, "redundant_outlets": 9, ... }

4. 04

   Read the artifacts

   copy

   curl $API/v1/runs/run_2026_06_03_a/artifacts \
     -H "Authorization: Bearer $TOKEN" \
     -H "X-Tenant-ID: default"

   { "run_id": "...", "artifacts": [ {duplicate_sets}, {retirements}, {audit_trail}, ... ] }

queued  →  running  →  succeeded
                          │
                          ↓
                      artifacts  →  approval_required  →  retired

• queued · accepted with an Idempotency-Key, waiting for the worker
• running · engine is matching; stage reports the current phase
• succeeded · clusters scored, artifacts written, ready to read
• approval_required · A2A task pause-state before any retirement applies