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
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 diffCheckout locally
git fetch origin pull/338/head:pr-338
git checkout pr-338