in reviewhumanPR #338Identity

Agora (formerly Adgentic): run the exchange against Track sellers with a fault-profile compatibility matrix

Adgentic is an exchange for shopping agents. A buyer agent posts its owner's need, seller agents return signed, structured offers, Offer Review checks them against each seller's registered records and strips prompt injection, and the buyer…

Author

meganshi-418 avatar

@meganshi-418

github profile →
Status
In review
Opened on
Nov 10
Branch
integration/adgentic-track-mailbox

Description

The pitch.

> Our project is now called **Agora**; it was called Adgentic during development, so code, paths and the repository still use that name.

## Summary

Adgentic is an exchange for shopping agents. A buyer agent posts its owner's need, seller agents return signed, structured offers, Offer Review checks them against each seller's registered records and strips prompt injection, and the buyer agent accepts one. It runs as an MCP server in its own repository.

This PR adds `integrations/adgentic/`. It runs the whole Adgentic exchange as the buyer-side participant of a Town Track run and registers Town's mailbox seller as an external seller on the exchange. A Town agent then competes for an Adgentic buyer's order through Town's coordinator, under Town's fault profiles. The PR contains the bridge, a compatibility matrix with checks fixed before running, opt-in tests and evidence bundles. It makes no changes to Town source.

## Integration

- **Interface tested:** the Track HTTP mailbox (join, capability discovery for `quote.read`, send, claim under lease, fenced ack).
- `adgentic_buyer.py` is a `cmd:` buyer harness. It starts the Adgentic MCP server from a separate checkout and acts as the Adgentic buyer agent through Adgentic's real tools (`post_intent`, `get_offers`, `accept_offer`). The buyer is scripted by default, or Claude Code with `--buyer claude`.
- `town_seller_connector.py` is an Adgentic plugin loaded through `ADGENTIC_PLUGINS`. Inside the exchange process it joins the Town run, discovers the seller, sends `quote_request`, turns the `quote_response` into an Ed25519-signed Adgentic offer, and claims and acknowledges every response with the buyer's correctness assertion.
- The Town task maps to an Adgentic intent: `sku` → category, `quantity` → quantity, `expected_total_cents` → budget, priority `price`.
- Adgentic is hosted separately at https://github.com/meganshi-418/adgentic, commit `8e1a07458b1b5546e78dddb96ca1600bc02a4d1b`. That commit adds the generic plugin hook and an optional intent `quantity`; default behavior is unchanged.

## Reproduce

- Town: `6f9a7c064486c4a0ae9242f1ff341b8a4aad0244` (nandatown 0.2.0, Track evaluator 0.5.0)
- Adgentic: `8e1a07458b1b5546e78dddb96ca1600bc02a4d1b`

```bash
git clone https://github.com/meganshi-418/adgentic ../adgentic
git -C ../adgentic checkout 8e1a07458b1b5546e78dddb96ca1600bc02a4d1b
python3 -m venv ../adgentic/.venv && ../adgentic/.venv/bin/pip install -r ../adgentic/requirements.txt
python3 -m venv .venv && source .venv/bin/activate && pip install -e '.[dev]'
export NANDATOWN_HOME=$(mktemp -d) ADGENTIC_DIR=$(cd ../adgentic && pwd)

# one run
nandatown run quote-crash-restart \
  --agent buyer=cmd:"$ADGENTIC_DIR/.venv/bin/python integrations/adgentic/adgentic_buyer.py --adgentic-dir $ADGENTIC_DIR"
# full matrix: 11 cases x 3 repeats, ~2 min, no model calls
python integrations/adgentic/run_matrix.py --adgentic-dir "$ADGENTIC_DIR" --repeats 3
# opt-in tests (skipped when ADGENTIC_DIR is unset)
ADGENTIC_DIR="$ADGENTIC_DIR" python -m pytest -q integrations/adgentic
```

Each run is checked by `nandatown verify` on the bundle and by the Adgentic log (intents, Town requests and responses, offers, signatures re-verified against registered keys, review verdicts, acceptances), not by either agent's own report.

## Results and limitations

Expected values were set in `run_matrix.py` before running. 33/33 runs matched, with identical outcomes across the 3 repeats of every case. `nandatown verify` passed on all 33 bundles, and 42/42 offer signatures verified.

| Case | Expected | Observed |
|---|---|---|
| quote-clean, crash-restart, amnesia-restart, drop-wakeup, duplicate-delivery, lost-ack | Town passed; one intent, one Town request, one approved offer; Adgentic accepts the Town quote once | As expected in every run; the crash-restart quote arrived after redelivery (~2.7 s) |
| amnesia-fresh-ids | Town fails on purpose; Adgentic accepts once | Town failed `response`, `correct` and `amne

…

Try it

Open PR on GitHubView diff

Checkout locally

git fetch origin pull/338/head:pr-338
git checkout pr-338