Retire agent-economy/desk examples; deepen marketplace's agent framework

txodds and marketplace are now the kit's only two examples (agent-economy and
the txodds-agent-desk companion UI are removed, with every doc/script cross-
reference updated to match). marketplace is expanded from a market script
into a genuinely orchestrated agent example: a capability/safety/tool-loop
framework in packages/agent-runtime/src/agent/, a Coral-native signal-agent
built on it, and LLM-trace/arena-leaderboard panels in the web visualizer.
txodds gets a disclaimer that its free TxLINE tier is scoped to the World Cup
2026 window. docs/AGENT_ORCHESTRATION.md documents the full pattern set,
a maturity ladder, and a worked example for adding a new specialist agent.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

Author: trilltino

.github/workflows/ci.yml

@@ -34,29 +34,6 @@ jobs:
       - run: npm exec -w marketplace-web -- playwright install --with-deps chromium
       - run: npm run e2e -w marketplace-web
 
-  solana-agent-kit-smoke:
-    name: Solana Agent Kit mock smoke
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v5
-      - uses: actions/setup-node@v5
-        with:
-          node-version: 22
-      - run: npm install --no-audit --no-fund
-      - run: npm run build:packages
-      - run: npm run smoke -w agent-economy-solana-agent-kit
-
-  web-build-smoke:
-    name: Agent economy dashboard build
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v5
-      - uses: actions/setup-node@v5
-        with:
-          node-version: 22
-      - run: npm install --no-audit --no-fund
-      - run: npm run build -w agent-economy-web
-
   escrow:
     name: Escrow + arbiter contracts
     runs-on: ubuntu-latest

CLAUDE.md

@@ -24,9 +24,7 @@ The Rust surface is limited to `examples/txodds/escrow`, which contains the escr
 | `packages/solana-agent-tools/` | Read-only Solana context tools and optional Solana Agent Kit adapter. |
 | `examples/txodds/` | TxODDS proxy, web UI, service implementation, research watcher, and escrow workspace. |
 | `examples/marketplace/` | CoralOS market launchers, feed server, React visualizer, and ledger persistence. |
-| `examples/agent-economy/` | Autonomous purchase, checkout bridge, HTTP 402 quickstart, and dashboard. |
-| `examples/txodds-agent-desk/` | Browser/Tauri operator UI over proxy, ledger, receipts, reputation, and watcher data. |
-| `coral-agents/` | Buyer, seller, verifier, broker, echo, and user-proxy agent containers. |
+| `coral-agents/` | Buyer, seller, verifier, broker, and echo agent containers. |
 | `scripts/` | Setup, wallet provisioning, example runner, and readiness e2e scripts. |
 
 ## Common Commands
@@ -82,11 +80,19 @@ CoralOS provides:
 - per-session agent launching;
 - thread messages and mentions;
 - blocking wait primitives;
-- extended session state for feed/UI replay;
-- puppet API for the checkout bridge.
+- extended session state for feed/UI replay.
 
 The market protocol is owned by `packages/agent-runtime/src/market/protocol.ts`; Coral transports opaque strings.
 
+## Agent Orchestration Framework
+
+`packages/agent-runtime/src/agent/` holds capability grants, process-level safety gates
+(`BudgetGuard`/`StepCounter`), a `Tool` contract with an audit-log shape, an evaluation/ranking
+helper, and a bounded provider-agnostic LLM tool-calling loop (`runToolLoop`). `coral-agents/signal-agent`
+is the first agent built on it — a Coral-native replacement for hand-running the TxODDS research
+watcher. See `docs/AGENT_ORCHESTRATION.md` for the full pattern set, a maturity ladder, and a worked
+example for adding a new specialist agent.
+
 ## Payment and Policy
 
 Solana value movement is devnet by default. Runtime helpers reject mainnet RPC URLs unless `ALLOW_MAINNET=1` is set.

CONTRIBUTING.md

@@ -11,8 +11,7 @@ Contributions are welcome. The `main` branch is the integration branch — targe
 | `examples/txodds/` | TypeScript | The World Cup Oracle — the edge transform, the proxy (+ run grading), the web app, the research watcher |
 | `examples/txodds/escrow/` | Rust (Anchor) | The escrow + arbiter settlement contracts |
 | `examples/marketplace/` | TypeScript | The competitive market (3 rounds: classic / freelancer / research), the feed server, the React visualizer |
-| `examples/agent-economy/` | TypeScript | Autonomous purchase, bridge checkout, quickstart, and dashboard |
-| `coral-agents/` | TypeScript | The per-session agents: buyer, seller (+ personas), verifier, broker, echo, user-proxy |
+| `coral-agents/` | TypeScript | The per-session agents: buyer, seller (+ personas), verifier, broker, echo |
 
 ## Prerequisites
 

CORAL.md

@@ -13,8 +13,7 @@ CoralOS provides:
 - container launch for registered local agents;
 - thread-based messaging with mentions;
 - blocking coordination primitives;
-- extended session state for feeds and dashboards;
-- puppet API calls used by the human checkout bridge.
+- extended session state for feeds and dashboards.
 
 CoralOS does not hold wallets in this repository. `examples/txodds/coral/coral.toml` has no wallet section, and all value movement is performed by agent processes through Solana clients.
 
@@ -26,7 +25,7 @@ CoralOS does not hold wallets in this repository. `examples/txodds/coral/coral.t
 | Protocol      | `packages/agent-runtime/src/market/protocol.ts`                       | Market message formatters/parsers. Coral transports these as strings.  |
 | Agents        | `coral-agents/`                                                       | Buyer, seller, verifier, broker, echo, and user-proxy implementations. |
 | Orchestration | `docker-compose.yml`, `examples/*/coral*.ts`, marketplace launchers | Start CoralOS and create sessions from agent graphs.                   |
-| UI/feed       | `examples/marketplace/feed`, `examples/agent-economy/bridge`        | Read extended session state and expose browser-safe APIs.              |
+| UI/feed       | `examples/marketplace/feed`                                          | Read extended session state and expose browser-safe APIs.              |
 
 ## Runtime API
 
@@ -65,7 +64,7 @@ Tool names are discovered dynamically by substring to tolerate small CoralOS nam
 | `verifier-agent` | Checks delivery hash/structure and replies `VERIFIED pass                                          |
 | `broker`         | Opens private seller threads, buys upstream, and resells with a markup.                            |
 | `echo-agent`     | Minimal connectivity test agent.                                                                   |
-| `user_proxy`     | Idle session participant driven by the puppet API for human checkout.                              |
+| `user_proxy`     | Idle session participant driven by the puppet API. No example currently launches it.                |
 
 Seller personas reuse the seller image with different manifest options.
 
@@ -87,7 +86,6 @@ Relevant examples:
 | `examples/marketplace/start.ts`           | Classic market.                           |
 | `examples/marketplace/freelancer.ts`      | Harness sellers plus verifier.            |
 | `examples/marketplace/research.ts`        | Event-driven buyer plus research sellers. |
-| `examples/agent-economy/bridge/server.ts` | Seller plus`user-proxy` for checkout.   |
 
 ## Market Flow
 
@@ -122,16 +120,6 @@ The Solana deposit/release/refund calls are outside CoralOS. CoralOS carries coo
 
 When CoralOS is unavailable, feed endpoints can replay finished sessions from ledger files.
 
-## Puppet API
-
-The checkout bridge uses the puppet API to send messages as `user-proxy`:
-
-```text
-POST /api/v1/puppet/{namespace}/{session}/user-proxy/thread...
-```
-
-The puppet API is send-only for this use case, so the bridge reads seller replies through extended session state.
-
 ## Configuration
 
 `examples/txodds/coral/coral.toml` configures local development:

README.md

@@ -27,7 +27,7 @@ Responsibilities are separated by subsystem:
 | Harness runtime | Adapter boundary for seller execution through`node-llm`, `claude-code`, or an arbitrary CLI.                     |
 | Payment runtime | Rail abstraction, rail routing, payment verification records, and rail-specific policy helpers.                      |
 | TxODDS example  | Default paid service, proxy, browser UI, research watcher, escrow clients, and Anchor programs.                      |
-| Coral agents    | Buyer, seller, verifier, broker, echo, and user-proxy agent processes launched per session.                          |
+| Coral agents    | Buyer, seller, verifier, broker, and echo agent processes launched per session.                                      |
 
 ## Repository Layout
 
@@ -40,16 +40,14 @@ Responsibilities are separated by subsystem:
 | `coral-agents/`                | Dockerized agents registered with CoralOS.                                                             |
 | `examples/txodds/`             | Default TxODDS oracle, proxy, web UI, research watcher, and escrow programs.                           |
 | `examples/marketplace/`        | Multi-seller market launchers, feed server, React visualizer, and run ledger persistence.              |
-| `examples/agent-economy/`      | Autonomous agent purchase, human checkout bridge, bare HTTP 402 quickstart, and dashboard.             |
-| `examples/txodds-agent-desk/`  | Browser/Tauri operator UI over proxy, ledger, receipts, settlement, reputation, and watcher data.      |
 | `scripts/`                     | Setup, example launcher, wallet provisioning, and readiness gate scripts.                              |
 
 ## Requirements
 
 | Requirement                     | Used by                                                                               |
 | ------------------------------- | ------------------------------------------------------------------------------------- |
-| Node.js 20+                     | Runtime packages, scripts, TxODDS, marketplace, agent economy, desk browser mode.     |
-| Docker                          | CoralOS sessions, marketplace, verifier/buyer/seller/broker/user-proxy agents.        |
+| Node.js 20+                     | Runtime packages, scripts, TxODDS, marketplace.                                       |
+| Docker                          | CoralOS sessions, marketplace, verifier/buyer/seller/broker agents.                   |
 | Devnet SOL                      | Buyer, broker, and wallet checkout flows.                                             |
 | LLM provider key                | Optional for live model output; deterministic fallbacks are present in several paths. |
 | Rust, Solana CLI, Anchor 0.32.x | Only needed to rebuild or redeploy`examples/txodds/escrow`.                         |
@@ -138,13 +136,6 @@ Run commands from the repo root unless noted.
 | `npm run research`                       | Launch event-driven research market.                               | Docker plus TxODDS proxy and watcher.                     |
 | `npm run research:watch`                 | Start the TxODDS odds-move watcher.                                | TxODDS proxy.                                             |
 | `npm run marketplace:web`                | Start the React market visualizer.                                 | Feed server or dashboard start endpoint.                  |
-| `npm run agent-economy`                  | Start autonomous agent-to-agent purchase example.                  | Docker and built agent images.                            |
-| `npm run agent-economy:bridge`           | Start human checkout bridge.                                       | Docker, CoralOS, wallet setup.                            |
-| `npm run agent-economy:quickstart`       | Start bare HTTP 402 seller.                                        | Node and wallet env.                                      |
-| `npm run agent-economy:quickstart:buyer` | Start bare HTTP 402 buyer.                                         | Quickstart server running.                                |
-| `npm run agent-economy:web`              | Start the agent-economy dashboard.                                 | Bridge backend.                                           |
-| `npm run desk`                           | Start the TxODDS Agent Desk in browser mode.                       | TxODDS proxy recommended.                                 |
-| `npm run desk:app`                       | Start the Tauri desktop shell.                                     | Rust/Tauri prerequisites.                                 |
 
 ## TxODDS Single-Agent Flow
 
@@ -175,6 +166,8 @@ npm run marketplace
 
 The buyer opens a market thread, posts `WANT`, collects `BID` messages, awards a seller, deposits to escrow, waits for delivery, optionally requests verifier approval, and releases through policy.
 
+`examples/marketplace/` is a first-class, self-standing example: it also ships a shared agent framework (capability grants, budget/step safety gates, a bounded LLM tool-call loop), a Coral-native signal agent that folds live odds-move detection into the market itself, and a trace/arena UI. See [docs/AGENT_ORCHESTRATION.md](docs/AGENT_ORCHESTRATION.md) for the full pattern set and how to extend it with new agent roles.
+
 The marketplace feed server converts Coral extended session state into typed rounds and ledger records:
 
 ```sh
@@ -251,7 +244,7 @@ runs/<session>/round-<n>/
   txs.json
 ```
 
-`proof.json` is the compact E2E success artifact. The ledger is used by the marketplace feed, visualizer, reputation calculation, TxODDS proxy, and Agent Desk. Finished sessions can be replayed from ledger files when CoralOS is unavailable.
+`proof.json` is the compact E2E success artifact. The ledger is used by the marketplace feed, visualizer, reputation calculation, and TxODDS proxy. Finished sessions can be replayed from ledger files when CoralOS is unavailable.
 
 ## Policy Boundaries
 
@@ -298,7 +291,6 @@ Package and example READMEs contain narrower test commands.
 - Do not commit `.env`, private keys, API keys, seed phrases, or generated wallet secrets.
 - Treat RPC responses, receipts, LLM output, verifier payloads, and Coral messages as untrusted input.
 - Keep mainnet disabled unless a separate review defines custody, policy, monitoring, and rollback controls.
-- The Agent Desk is a local operator UI, not an authenticated hosted admin system.
 
 ## License
 

TXODDS.md

@@ -2,6 +2,8 @@
 
 This repository includes a TxODDS TxLINE integration used by the default paid service. The integration reads World Cup and International Friendlies data from TxLINE, derives a fair-line analysis, and can bind that analysis to devnet Solana settlement.
 
+> **The free TxLINE guest tier is scoped to the World Cup 2026 tournament window.** It is a promotional grant tied to that event, not a standing free API — do not build against it assuming indefinite availability. See `examples/txodds/README.md` and `examples/txodds/WORLDCUP_API.md` for details.
+
 ## Data Source
 
 | Item | Value |

build-agents.sh

@@ -34,11 +34,18 @@ build_claude_seller() {
   echo "    seller-agent-claude:0.1.0 done (the HARNESS=claude-code seller)"
 }
 
+build_signal() {
+  echo "==> Building signal-agent:0.1.0"
+  docker build -f "$ROOT/coral-agents/signal-agent/Dockerfile" -t signal-agent:0.1.0 "$ROOT"
+  echo "    signal-agent:0.1.0 done (run as a host process today — see coral-agents/signal-agent/README.md)"
+}
+
 case "${1:-all}" in
   seller)   build_seller ;;
   buyer)    build_buyer ;;
   verifier) build_verifier ;;
   claude)   build_seller; build_claude_seller ;;
+  signal)   build_signal ;;
   all)
     build_seller
     build_buyer
@@ -49,6 +56,7 @@ case "${1:-all}" in
     echo "  cd examples/txodds && npm run coral        # World Cup oracle round"
     echo "  cd examples/marketplace && npm run freelancer   # verifier-gated freelancer market"
     echo "Optional Claude Code seller: bash build-agents.sh claude"
+    echo "Research market signal detector (runs as a host process, see coral-agents/signal-agent): npm run signal:watch"
     ;;
-  *) echo "Usage: bash build-agents.sh [seller|buyer|verifier|claude|all]"; exit 1 ;;
+  *) echo "Usage: bash build-agents.sh [seller|buyer|verifier|claude|signal|all]"; exit 1 ;;
 esac

coral-agents/README.md

@@ -13,7 +13,8 @@ Each agent has a `coral-agent.toml` manifest and an implementation in its folder
 | `verifier-agent` | Checks delivery hash/structure and replies `VERIFIED pass|fail`. No wallet authority. |
 | `broker` | Requests quotes from upstream sellers, buys from one seller, and resells to the buyer. |
 | `echo-agent` | Minimal MCP connectivity check. |
-| `user_proxy` | Idle Python participant used by the checkout bridge puppet API. |
+| `signal-agent` | Polls TxODDS odds, detects sharp moves, and queues research `WANT`s for the event-driven research market. Bounded by the `packages/agent-runtime` agent-safety framework. |
+| `user_proxy` | Idle Python participant driven by the puppet API. No example in this repo currently launches it. |
 
 Seller personas reuse the seller image with different manifest defaults such as `AGENT_NAME`, `PERSONA`, `FLOOR_SOL`, `SERVICES`, and `HARNESS`.
 
@@ -24,7 +25,7 @@ bash build-agents.sh
 bash build-agents.sh claude
 ```
 
-The `claude` build creates `seller-agent-claude:0.1.0` with the Claude Code CLI available for the harness adapter.
+The `claude` build creates `seller-agent-claude:0.1.0` with the Claude Code CLI available for the harness adapter. `signal-agent` is built/typechecked/tested like every other agent (`npm run build -w signal-agent`, etc.) but is run as a host process today, not launched by CoralOS — see `signal-agent/README.md`.
 
 ## Settlement Boundary
 
@@ -37,5 +38,4 @@ Agents hold signing authority and run policy checks. Harness processes only prod
 | `examples/txodds/coral/round.ts` | TxODDS buyer and seller personas. |
 | `examples/marketplace/start.ts` | Classic marketplace. |
 | `examples/marketplace/freelancer.ts` | Harness sellers and verifier. |
-| `examples/marketplace/research.ts` | Event-mode buyer and research seller personas. |
-| `examples/agent-economy/bridge/server.ts` | Checkout bridge sessions. |
+| `examples/marketplace/research.ts` | Event-mode buyer and research seller personas. Event feed comes from `signal-agent` (or the legacy `examples/txodds` watcher). |

coral-agents/signal-agent/Dockerfile

@@ -0,0 +1,23 @@
+# Build from repo root:
+#   docker build -f coral-agents/signal-agent/Dockerfile -t signal-agent:0.1.0 .
+
+FROM node:20-alpine AS builder
+WORKDIR /app
+
+COPY package.json ./
+COPY packages ./packages
+COPY coral-agents ./coral-agents
+COPY examples ./examples
+RUN npm install --no-audit --no-fund --ignore-scripts
+RUN npm run build:packages
+RUN npm run build -w signal-agent
+
+FROM node:20-alpine
+WORKDIR /app
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/packages ./packages
+COPY --from=builder /app/coral-agents/signal-agent/dist ./dist
+COPY --from=builder /app/coral-agents/signal-agent/package.json ./package.json
+
+EXPOSE 4600
+CMD ["node", "dist/index.js"]