Skip to content

Commit bdc9de3

Browse files
committed
Add coral marketplace agents and runtime updates
1 parent a8fd71a commit bdc9de3

80 files changed

Lines changed: 4029 additions & 93 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.claude/settings.local.json

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
{
2+
"permissions": {
3+
"allow": [
4+
"Bash(powershell -Command ' *)",
5+
"Bash(grep -r \"///\" --include=\"*.rs\")",
6+
"Bash(cargo check *)"
7+
]
8+
}
9+
}

CLAUDE.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -29,9 +29,12 @@ is **Venice AI** (free credits; `LLM_PROVIDER` also accepts `openai`/`anthropic`
2929
|-----------|---------|
3030
| `examples/txodds/` | The World Cup Oracle (the headline example). `agent/` (`edge.ts` — the verified-odds→LLM-call transform; `service.ts` — the `deliverService` fork point; `escrow.ts` — the buyer-side escrow client), `server/` (`mint.ts`, `proxy.ts` — the live data + escrow proxy), `web/` (the no-build React app), `escrow/` (the Anchor escrow + arbiter programs — the settlement spine). |
3131
| `examples/agent-economy/` | **Three front doors** on CoralOS (needs Docker): `autonomous/` (agent→agent purchase), `bridge/` (HTTP bridge + React checkout — the human front door), `quickstart/` (bare 402 pay-per-call, no Docker/CoralOS), `web/` (3-tab dashboard), `config/coral.toml`. Escrow references point at `examples/txodds/escrow/`. |
32-
| `examples/marketplace/` | **Competitive bidding market** (needs Docker): `start.ts` launches a buyer + persona sellers in one CoralOS session; `feed/` (SSE feed folding session state into rounds, with tests), `web/` (React visualizer + Playwright tests). Settles via the escrow. |
33-
| `packages/agent-runtime/` | The runtime, one folder each under `src/`: the LLM provider shim (`llm/`), Solana Pay + devnet guard (`solana/`), a CoralOS MCP client (`coral/`), and the market protocol (`market/`). Root `src/index.ts` re-exports all of them. The oracle uses `llm/` + `solana/`; `coral/` + `market/` power the multi-agent examples. |
34-
| `coral-agents/` | The agents coral-server launches per session: `buyer-agent`, `seller-agent` (+ the `seller-worldcup` persona), plus `broker/` (swarm — buys upstream, resells at a markup, escrow both legs), `echo-agent/` (minimal test agent), `user_proxy/` (the human's puppet for the bridge). |
32+
| `examples/marketplace/` | **Competitive bidding market** (needs Docker): `start.ts` launches a buyer + persona sellers in one CoralOS session; `feed/` (folds session state into rounds AND persists each round to the **run ledger** `runs/`; serves `/api/runs` + `/api/reputation`; replays a session from disk when coral is down), `web/` (React visualizer + Playwright tests). Settles via the escrow. |
33+
| `examples/freelancer/` | **Verifier-gated freelancer market** (needs Docker): heterogeneous harnesses (`seller-scribe` node-llm vs `seller-claude` Claude Code) bid on a brief; `verifier-agent` gates the release. |
34+
| `examples/research/` | **Event-driven research market** (needs Docker + the txodds proxy): `src/watcher.ts` turns live odds moves into queued WANTs (`detectEvents`, tested); the buyer polls it via `WANT_FEED_URL` — quiet board, no spend. |
35+
| `packages/agent-runtime/` | The runtime, one folder each under `src/`: the LLM provider shim (`llm/`), Solana Pay + devnet guard (`solana/`), a CoralOS MCP client (`coral/`), the market protocol incl. VERIFY/VERIFIED (`market/`), the **run ledger + reputation** (`ledger/`), and the **policy choke point** (`policy/` — spend caps, payout/award-price binding, verifier gate). Root `src/index.ts` re-exports all of them. |
36+
| `packages/harness-runtime/` | The **harness adapter SDK**: one `HarnessAdapter` interface (`quote`/`run`, hash-bound deliveries, streamed events) so a seller can be a prompt (`node-llm`), headless Claude Code (`claude-code`, Coral MCP config injection), or any CLI (`HARNESS=cli HARNESS_CMD='hermes {prompt}'`). Harness processes never hold keys. Build after agent-runtime. |
37+
| `coral-agents/` | The agents coral-server launches per session: `buyer-agent` (policy-enforced, verifier-gated, event-mode capable), `seller-agent` (harness-adapter seller; personas `seller-worldcup`/`seller-scribe`/`seller-claude`/`seller-moves`/`seller-stats` reuse its image), `verifier-agent` (independent delivery checks — release gate), plus `broker/` (swarm — buys upstream, resells at a markup, escrow both legs), `echo-agent/` (minimal test agent), `user_proxy/` (the human's puppet for the bridge). |
3538
| `scripts/` | `txodds.js` (the `npm run dev` launcher — proxy + web + browser) and `setup.js` (devnet wallet generation → `.env`). |
3639

3740
## Commands
@@ -57,7 +60,8 @@ npm run mint # mint a fresh TxLINE free-tier token into .env (opt
5760
cd packages/agent-runtime && npm install
5861
cd packages/agent-runtime && npm run typecheck
5962
cd packages/agent-runtime && npm test
60-
cd packages/agent-runtime && npm run build # dependents (examples/txodds) need its dist
63+
cd packages/agent-runtime && npm run build # dependents (examples/txodds, harness-runtime, agents) need its dist
64+
cd packages/harness-runtime && npm run build # after agent-runtime; the seller needs its dist
6165
```
6266

6367
### Typecheck / test the example

0 commit comments

Comments
 (0)