paralith-mcp 0.1.0 → 0.3.0

package/README.md

@@ -9,7 +9,13 @@ Solana and Sui. Public docs: `products/orderbook/app/src/docs/pages/ai/mcp.md`
 
 Read-only, no install: connect your MCP client to `https://mcp.paralithmarkets.com/mcp`.
 
-To play, trade and bridge, run it locally with a phrase made for the agent (Node 20+):
+To play, trade and bridge, connect every agent app on this machine (Claude Code, Claude Desktop, Codex, Grok), each with its own new wallet:
+
+```bash
+npx -y paralith-mcp@latest setup
+```
+
+Or by hand, with a phrase made for the agent (Node 20+):
 
 ```bash
 claude mcp add paralith --env PARALITH_MNEMONIC_FILE=/path/to/agent-phrase.txt -- npx -y paralith-mcp@latest
@@ -30,7 +36,9 @@ PARALITH_MNEMONIC_FILE=phrase.txt node scripts/call.mjs wallet '{}'  # call one
 npm test                          # also fails if dist/ or the tool reference is stale
 ```
 
-- `src/server.mjs`: stdio entry. No phrase means read-only.
+- `src/server.mjs`: stdio entry. No phrase means read-only. `setup` runs `src/setup.mjs` instead.
+- `src/setup.mjs`: one wallet per agent app, written into each app's MCP config; `src/agents.mjs` records their public addresses.
+- `src/progress.mjs`: the `progress` tool, one read across game, venues, vaults, bridge and gas, for one agent or all.
 - `src/http.mjs`: hosted read-only endpoint, `POST /mcp`, `GET /health`.
 - `src/build.mjs`: `buildServer()` and the account tools.
 - `src/keys.mjs`: phrase to AO/Base/Solana/Sui signers.

package/dist/chains.json

@@ -4,11 +4,11 @@
     "chainId": 8453,
     "rpc": "https://mainnet.base.org",
     "explorer": "https://basescan.org",
-    "bridge": "0xCE13574d0Ca4A0dE9c5E5039fD2E9F6ec2593409",
-    "deployBlock": 52295541,
+    "bridge": "0x871ae9cd37B76F9216076d775928C733687596e6",
+    "deployBlock": 52429067,
     "tokens": [
       {
-        "address": "0x405c70597266BefB0504389E333F10785B7919a9",
+        "address": "0xce2ED346Ff3E537E2D99B47F5162b0A07431d9a4",
         "symbol": "TEST-USDC",
         "decimals": 6,
         "faucet": true
@@ -19,95 +19,132 @@
     "cluster": "mainnet-beta",
     "rpc": "https://api.mainnet-beta.solana.com",
     "explorer": "https://solscan.io",
-    "programId": "thXGuX413NPvD7zPrSv658UmVEwdki2Tu3zhbU6LoiM",
+    "programId": "41aBnUWVghxSWboMKY2F1MhtAYhPMU83igKbfvtjVjcr",
     "deployed": true,
     "tokens": [
       {
-        "mint": "2oJf5PQxWYjLfPQ5yTBt5XE34F1zoP1fHCeFwoPcrdDn",
+        "mint": "4CjGDd6atsPPe7YPukt3aaHAuXUfhsA9KPkgbgVrcGyq",
         "symbol": "TEST-USDC",
         "decimals": 6,
         "tokenProgram": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
         "faucet": true
       }
     ],
-    "programIndex": 4
+    "programIndex": 5
   },
   "sui": {
     "network": "mainnet",
     "rpc": "https://fullnode.mainnet.sui.io:443",
     "graphql": "https://graphql.mainnet.sui.io/graphql",
     "explorer": "https://suivision.xyz",
-    "package": "0x43e8e6eea948b92358e799d9f27042ce9d77cf160ad2736ab0f5fd852d1ffa24",
-    "originalPackage": "0x43e8e6eea948b92358e799d9f27042ce9d77cf160ad2736ab0f5fd852d1ffa24",
-    "bridge": "0x63e9050c72530fb577379f6b9d979aba3b84afeb83833cbe47a6972443fcd300",
-    "faucet": "0x24cdc90a23c129fe3afcc2bbb5c8bd0a63f10dad06ca6c04e03c41eb1e955ac3",
+    "package": "0x647f58c931f3f9c48ada70a3f91bc554f8945bcad16967e02a0bd49fffe9aed6",
+    "originalPackage": "0x647f58c931f3f9c48ada70a3f91bc554f8945bcad16967e02a0bd49fffe9aed6",
+    "bridge": "0x270b73af9e6543d196ba7a3bc160f87aabdc662e8601af46ceb0d465ae103337",
+    "faucet": "0x4c549789110006fadc343790b770fffa314269bcbeafd4f48853c3bf3d9639ef",
     "tokens": [
       {
-        "type": "0x43e8e6eea948b92358e799d9f27042ce9d77cf160ad2736ab0f5fd852d1ffa24::test_usdc::TEST_USDC",
+        "type": "0x647f58c931f3f9c48ada70a3f91bc554f8945bcad16967e02a0bd49fffe9aed6::test_usdc::TEST_USDC",
         "symbol": "TEST-USDC",
         "decimals": 6,
         "faucet": true
       }
     ],
-    "adminCap": "0xbfade5103b48bde0bdb5dcc0b016bb9571a93f79895de542e8853f522166d404",
+    "adminCap": "0xdd6abffeb51098b05be212f89fe44e78cbef062edfeec6078b225f9e75267570",
     "deployed": true,
     "upgradeCap": "0xa1fb1dc179dcdc0579dca5b50a8d1162c1a3c40f531fb723f21de206c1ca78cd"
   },
-  "relayers": {
-    "base": "0xDaaefC6Fe9C820DB57E9be7C0b566800de11ac22",
-    "solana": "9eVvxEPKgpQ4Y2BZV8BWVAeRHWWfSEJy3vrM2AFNzdQ2",
-    "sui": "0x46bd8f40263f6e056262f82f13c61d0849d813a030cde4c5bd6a8dd768144e9f",
-    "ao": "z2OMYtbWHqNZY01ehkN0tsepznlrZQW-6dXPQO5lxDM"
-  },
   "deploy": {
     "sui": {
-      "id": "0x43e8e6eea948b92358e799d9f27042ce9d77cf160ad2736ab0f5fd852d1ffa24",
-      "version": "sha256:a1fa3e2c74ded1733922a0055ed98b964223253daa25386a1adcec5e84e1b280",
-      "localHash": "sha256:a1fa3e2c74ded1733922a0055ed98b964223253daa25386a1adcec5e84e1b280",
-      "deployedAt": "2026-10-07T13:59:55.943Z",
-      "tx": "2ENtda5acLVU3RyTfTC4U9n56C9F4wNJfhPK8fZq7FtB",
+      "id": "0x647f58c931f3f9c48ada70a3f91bc554f8945bcad16967e02a0bd49fffe9aed6",
+      "version": "sha256:d8675a23dc00cfe0d9e73f128ed5948d05e9a708afc1a68829906bec0aaeb432",
+      "localHash": "sha256:d8675a23dc00cfe0d9e73f128ed5948d05e9a708afc1a68829906bec0aaeb432",
+      "deployedAt": "2026-10-10T16:08:52.325Z",
+      "tx": "7CjZL9MGDVXUgSeGCNmT69HWtksnNyJaacFDTrAGahhu",
       "action": "FRESH"
     },
     "pusd": {
-      "id": "sXuny0tvUizug41AHbbvWfDcjkqK0MEjrWSBTQwp3ac",
-      "version": "sha256:4371b32bcc00fd14e85e740ac0f09d41bb6192509bee171d83594c901185eabc",
-      "localHash": "sha256:4371b32bcc00fd14e85e740ac0f09d41bb6192509bee171d83594c901185eabc",
-      "deployedAt": "2026-10-09T21:40:48.119Z",
-      "tx": "sXuny0tvUizug41AHbbvWfDcjkqK0MEjrWSBTQwp3ac",
+      "id": "xhYkQ8qm7zssDC2nrOfzkk2Xy8rPVvlEMWestfrAvK8",
+      "version": "sha256:5c7aee2fad4dd8c558bbbcc4cf1dd19da28c5faf834bf4a801cf82969c0225c8",
+      "localHash": "sha256:5c7aee2fad4dd8c558bbbcc4cf1dd19da28c5faf834bf4a801cf82969c0225c8",
+      "deployedAt": "2026-10-10T15:51:14.512Z",
+      "tx": "xhYkQ8qm7zssDC2nrOfzkk2Xy8rPVvlEMWestfrAvK8",
       "action": "FRESH"
     },
     "base": {
-      "id": "0xCE13574d0Ca4A0dE9c5E5039fD2E9F6ec2593409",
-      "version": "0x85ba7d3498f2cf2c87849ee1d4966867465431d233837f1158964dece0af9028",
-      "localHash": "0x85ba7d3498f2cf2c87849ee1d4966867465431d233837f1158964dece0af9028",
-      "deployedAt": "2026-10-07T13:41:12.236Z",
-      "tx": "0xb07dcc2967c1f803f7177ce99359f235319771fa0037982d983d1fd586bfdfef",
-      "action": "FRESH"
+      "id": "0x871ae9cd37B76F9216076d775928C733687596e6",
+      "version": "0xe9e86188e3c0aa76ab1148c6cdee756045799152b0d796c2c74138ffae8ad03b",
+      "localHash": "0xe9e86188e3c0aa76ab1148c6cdee756045799152b0d796c2c74138ffae8ad03b",
+      "baselined": false,
+      "recordedAt": "2026-10-10T16:09:39.076Z",
+      "deployedAt": null
     },
     "solana": {
-      "id": "thXGuX413NPvD7zPrSv658UmVEwdki2Tu3zhbU6LoiM",
-      "version": "sha256:3ab07b185fa24f3da2a57352b9e2eed5f37475752cb2258d182d8a61afab7d2b",
-      "localHash": "sha256:3ab07b185fa24f3da2a57352b9e2eed5f37475752cb2258d182d8a61afab7d2b",
-      "deployedAt": "2026-10-07T13:59:36.619Z",
-      "tx": "4gzQJeXcj6WZyhTP1djC95LVAsEiH78gVcNBk57KESYkwzWqRNDkkGgotQwENYEXfzqZpfRFcmysrBoHh44TMxz1",
+      "id": "41aBnUWVghxSWboMKY2F1MhtAYhPMU83igKbfvtjVjcr",
+      "version": "sha256:4279831e73a9247928ad5c4490bb203bc498d834da24f6da0ff20562898ec47e",
+      "localHash": "sha256:4279831e73a9247928ad5c4490bb203bc498d834da24f6da0ff20562898ec47e",
+      "deployedAt": "2026-10-10T16:08:35.744Z",
+      "tx": "J8trVshLfVhCxSJHnXXLhxdbkmkWLEhpE9FEjTHDK8qTkYY7izhX2zAtVscsztaTn7nMDnLhT88BHBw9MsVmbVC",
       "action": "FRESH"
     },
     "lastRun": {
-      "at": "2026-10-09T21:41:00.279Z",
-      "startedAt": "2026-10-09T19:17:15.931Z",
+      "at": "2026-10-10T16:09:39.077Z",
+      "startedAt": "2026-10-10T15:51:02.462Z",
       "steps": [
         {
           "component": "pusd",
           "action": "FRESH",
           "status": "done",
-          "tx": "sXuny0tvUizug41AHbbvWfDcjkqK0MEjrWSBTQwp3ac"
+          "tx": "xhYkQ8qm7zssDC2nrOfzkk2Xy8rPVvlEMWestfrAvK8"
+        },
+        {
+          "component": "base",
+          "action": "FRESH",
+          "status": "done"
+        },
+        {
+          "component": "solana",
+          "action": "FRESH",
+          "status": "done",
+          "tx": "J8trVshLfVhCxSJHnXXLhxdbkmkWLEhpE9FEjTHDK8qTkYY7izhX2zAtVscsztaTn7nMDnLhT88BHBw9MsVmbVC"
+        },
+        {
+          "component": "sui",
+          "action": "FRESH",
+          "status": "done",
+          "tx": "7CjZL9MGDVXUgSeGCNmT69HWtksnNyJaacFDTrAGahhu"
         },
         {
           "component": "tokens",
           "action": "CONFIGURE",
           "status": "done"
+        },
+        {
+          "component": "graph",
+          "action": "CONFIGURE",
+          "status": "done"
+        },
+        {
+          "component": "site",
+          "action": "CONFIGURE",
+          "status": "done"
         }
       ]
     }
+  },
+  "attestors": [
+    {
+      "ao": "tkqULqMDeHKXCN79Cm_bDIV560JxXl6pBSmdPgxqwSw",
+      "operator": "efH9MDGEFZqQ4nTTRNxl8WXJi2NbZvd2xVgCWmG5EeM",
+      "base": "0xcefcaae4d5077eda2b126e9b315b5d7c4dd2ff38",
+      "solana": "BBuQ11wQE6K5bj6Cx7X5VpVDB9CG83nbeDdDSinavUz",
+      "sui": "0x397c399eb2f7e24e8f5d1988f71284baac48149b9e8cdcd741b353c771118ebc",
+      "epoch": 0
+    }
+  ],
+  "retiredRelayers": {
+    "base": "0xDaaefC6Fe9C820DB57E9be7C0b566800de11ac22",
+    "solana": "9eVvxEPKgpQ4Y2BZV8BWVAeRHWWfSEJy3vrM2AFNzdQ2",
+    "sui": "0x46bd8f40263f6e056262f82f13c61d0849d813a030cde4c5bd6a8dd768144e9f",
+    "ao": "z2OMYtbWHqNZY01ehkN0tsepznlrZQW-6dXPQO5lxDM"
   }
 }

package/dist/client.mjs

@@ -401,7 +401,7 @@ var init_slot_settle = __esm({
 var graph_default;
 var init_graph = __esm({
   "runerealm-graph:C:\\REPO\\paralith-mono\\products\\runerealm-ui\\src\\lib\\graph.json"() {
-    graph_default = { node: "https://hyperbeam.tylerw.ai", owner: "DA9qhP25ZPz6MHIhO-7aNHDN3LsTAL7yCKYIkqr13Z8", deployedAt: "", processes: { game: "bqkZT1qY8Qpea7QsKZEk8q7m0yUE8-G3Miq8EFXnRJg", rune: "0j4rkkEqUO25aXI8LoDuou2Ibr0GSMGsXrFRxwrSfY8", pusd: "sXuny0tvUizug41AHbbvWfDcjkqK0MEjrWSBTQwp3ac", dao: "YAPgWNxRQksjYn_zfUw-h-JkwpmJDtPL1K9yifR5S_Q", elements: { earth: "3CS-LPEfD4YJwpuh1kuPGOv3lGwIlOAWOT15ATGIbPg", air: "y51gmVYD1GoJWtMxAtePMnvMCR0aT-jSfnsMKjFeU70", fire: "os6EKVQGuukvgTFmaZbGj23Xt3frHB3cb8ljquCdJ18", water: "P9OPPoVw9MxpIz8QghA6TcYUhXrYG3Ro09KM8shX5QM" }, internalVenue: "pxw-Y9Hl8CNQlPGLr-2Ez_9BVjjEP6wisxrZhe-AyxU", externalVenue: "D3SUysjoweBXtoGFm4zoq1dKSt7Dc5b_V9x_weLJV7Y", hunt: "4iABQxFjL3LtMGgfZQuwsH5WHKKjjSu7b7XfxEN_j40", huntWorkers: ["4iABQxFjL3LtMGgfZQuwsH5WHKKjjSu7b7XfxEN_j40", "2RBkmldqPdij2PopnEPuStLl6Pb6OcIrpilfK64Q1m8", "EATa5vTV53J1c711CEjiuks2Kllq3Gi-kVSXFqe7O7M", "SHXyU87725eI8i6qSET70Pwovf744DJqEfajTZI4N4M", "iesbJSITvqtDXMHxhGeOOXUXofnD-nh1qro9PH5IHNQ"], battleWorkers: ["Xk8XXWY2QY-UCd1Y_yqx6SHlVt5bNUbQnwzngMgxbzc", "IPjes-iFyMZH_JCx1z-4c-7JEdJgd3RGgbglgl3_u2s", "-m-6qgUsU6ybjOpMMlPHvG1bIlHypFMORKw4blCpRnU", "mSzalVGuEgxAG_tCEhVivSPMhSvmp5ePMHRIW0-gASM", "PkPEU-yZpgn9LwXWYPahUKOPe-Hw2sHB0DPBNPoxQeA"] }, huntNode: "https://hyperbeam.tylerw.ai", marketNode: "https://hyperbeam.tylerw.ai", venueNode: "https://hyperbeam.tylerw.ai" };
+    graph_default = { node: "https://hyperbeam.tylerw.ai", owner: "DA9qhP25ZPz6MHIhO-7aNHDN3LsTAL7yCKYIkqr13Z8", deployedAt: "", processes: { game: "bqkZT1qY8Qpea7QsKZEk8q7m0yUE8-G3Miq8EFXnRJg", rune: "0j4rkkEqUO25aXI8LoDuou2Ibr0GSMGsXrFRxwrSfY8", pusd: "xhYkQ8qm7zssDC2nrOfzkk2Xy8rPVvlEMWestfrAvK8", dao: "YAPgWNxRQksjYn_zfUw-h-JkwpmJDtPL1K9yifR5S_Q", elements: { earth: "3CS-LPEfD4YJwpuh1kuPGOv3lGwIlOAWOT15ATGIbPg", air: "y51gmVYD1GoJWtMxAtePMnvMCR0aT-jSfnsMKjFeU70", fire: "os6EKVQGuukvgTFmaZbGj23Xt3frHB3cb8ljquCdJ18", water: "P9OPPoVw9MxpIz8QghA6TcYUhXrYG3Ro09KM8shX5QM" }, internalVenue: "pxw-Y9Hl8CNQlPGLr-2Ez_9BVjjEP6wisxrZhe-AyxU", externalVenue: "D3SUysjoweBXtoGFm4zoq1dKSt7Dc5b_V9x_weLJV7Y", hunt: "4iABQxFjL3LtMGgfZQuwsH5WHKKjjSu7b7XfxEN_j40", huntWorkers: ["4iABQxFjL3LtMGgfZQuwsH5WHKKjjSu7b7XfxEN_j40", "2RBkmldqPdij2PopnEPuStLl6Pb6OcIrpilfK64Q1m8", "EATa5vTV53J1c711CEjiuks2Kllq3Gi-kVSXFqe7O7M", "SHXyU87725eI8i6qSET70Pwovf744DJqEfajTZI4N4M", "iesbJSITvqtDXMHxhGeOOXUXofnD-nh1qro9PH5IHNQ"], battleWorkers: ["Xk8XXWY2QY-UCd1Y_yqx6SHlVt5bNUbQnwzngMgxbzc", "IPjes-iFyMZH_JCx1z-4c-7JEdJgd3RGgbglgl3_u2s", "-m-6qgUsU6ybjOpMMlPHvG1bIlHypFMORKw4blCpRnU", "mSzalVGuEgxAG_tCEhVivSPMhSvmp5ePMHRIW0-gASM", "PkPEU-yZpgn9LwXWYPahUKOPe-Hw2sHB0DPBNPoxQeA"] }, huntNode: "https://hyperbeam.tylerw.ai", marketNode: "https://hyperbeam.tylerw.ai", venueNode: "https://hyperbeam.tylerw.ai" };
   }
 });
 
@@ -9801,9 +9801,12 @@ var ShardedVenue = class {
     return { cancelled: { cancelledIds }, account: await this.summed(address, targets) };
   }
   /** Housekeeping, on every pair: anyone may call it, nobody is paid to. */
-  async maintain(limit = 25) {
+  /** `pairIds` sweeps only those pairs: one signed message each, so name the ones holding expired orders. */
+  async maintain(limit = 25, pairIds) {
     let expired = 0;
-    for (const pair2 of Object.values(await this.pairs())) {
+    const pairs = await this.pairs();
+    const due = pairIds ? pairIds.filter((id) => pairs[id]).map((id) => pairs[id]) : Object.values(pairs);
+    for (const pair2 of due) {
       const reply = unwrap4(await this.transport.send(pair2.process, tags2({
         Action: "Order.Maintain",
         Limit: String(Math.max(1, Math.floor(limit)))
@@ -10016,9 +10019,9 @@ var cancelAllVenueOrders = async (process, item) => {
     ...item ? { Item: item } : {}
   });
 };
-var maintainVenueOrders = async (process, limit = 25) => {
+var maintainVenueOrders = async (process, limit = 25, pairIds) => {
   const s = await shard(process);
-  if (s) return s.maintain(limit);
+  if (s) return s.maintain(limit, pairIds);
   return write4(process, {
     Action: "Order.Maintain",
     Limit: String(Math.max(1, Math.floor(limit)))

package/dist/graph.json

@@ -1,11 +1,11 @@
 {
   "node": "https://hyperbeam.tylerw.ai",
   "owner": "DA9qhP25ZPz6MHIhO-7aNHDN3LsTAL7yCKYIkqr13Z8",
-  "deployedAt": "2026-10-09T21:40:15.402Z",
+  "deployedAt": "2026-10-10T15:51:09.959Z",
   "processes": {
     "game": "bqkZT1qY8Qpea7QsKZEk8q7m0yUE8-G3Miq8EFXnRJg",
     "rune": "0j4rkkEqUO25aXI8LoDuou2Ibr0GSMGsXrFRxwrSfY8",
-    "pusd": "sXuny0tvUizug41AHbbvWfDcjkqK0MEjrWSBTQwp3ac",
+    "pusd": "xhYkQ8qm7zssDC2nrOfzkk2Xy8rPVvlEMWestfrAvK8",
     "dao": "YAPgWNxRQksjYn_zfUw-h-JkwpmJDtPL1K9yifR5S_Q",
     "elements": {
       "earth": "3CS-LPEfD4YJwpuh1kuPGOv3lGwIlOAWOT15ATGIbPg",

package/dist/http.mjs

@@ -5,8 +5,8 @@ import http2 from "node:http";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 
 // src/runtime.mjs
-import fs2 from "node:fs";
-import path2 from "node:path";
+import fs3 from "node:fs";
+import path3 from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 
 // ../../backend/native/ans104.mjs
@@ -135,7 +135,7 @@ import { mnemonicToAccount } from "viem/accounts";
 import { Keypair } from "@solana/web3.js";
 import { Ed25519Keypair } from "@mysten/sui/keypairs/ed25519";
 import { getKeyFromMnemonic } from "arweave-mnemonic-keys";
-var CACHE_DIR = process.env.PARALITH_MCP_HOME || path.join(os.homedir(), ".paralith", "mcp");
+var HOME = process.env.PARALITH_MCP_HOME || path.join(os.homedir(), ".paralith", "mcp");
 function readPhrase(env = process.env) {
   const raw = env.PARALITH_MNEMONIC ?? (env.PARALITH_MNEMONIC_FILE ? fs.readFileSync(env.PARALITH_MNEMONIC_FILE, "utf8") : null);
   if (!raw) {
@@ -162,25 +162,27 @@ function slip10(seed, derivation) {
 async function aoJwk(phrase, env) {
   if (env.PARALITH_AO_JWK) return JSON.parse(fs.readFileSync(env.PARALITH_AO_JWK, "utf8"));
   const id = crypto2.createHash("sha256").update(phrase).digest("hex").slice(0, 24);
-  const file = path.join(CACHE_DIR, `ao-${id}.json`);
+  const file = path.join(HOME, `ao-${id}.json`);
   if (fs.existsSync(file)) return JSON.parse(fs.readFileSync(file, "utf8"));
   const jwk = await getKeyFromMnemonic(phrase);
-  fs.mkdirSync(CACHE_DIR, { recursive: true, mode: 448 });
+  fs.mkdirSync(HOME, { recursive: true, mode: 448 });
   fs.writeFileSync(file, JSON.stringify(jwk), { mode: 384 });
   return jwk;
 }
-async function deriveWallets(phrase, env = process.env) {
+function chainWallets(phrase) {
   const evm = mnemonicToAccount(phrase, { path: "m/44'/60'/0'/0/0" });
   const solana = Keypair.fromSeed(slip10(mnemonicToSeedSync(phrase), "m/44'/501'/0'/0'"));
   const sui = Ed25519Keypair.deriveKeypair(phrase, "m/44'/784'/0'/0'/0'");
-  const jwk = await aoJwk(phrase, env);
   return {
-    ao: { jwk, address: jwkToAddress(jwk) },
     base: { account: evm, address: evm.address },
     solana: { keypair: solana, address: solana.publicKey.toBase58() },
     sui: { keypair: sui, address: sui.getPublicKey().toSuiAddress() }
   };
 }
+async function deriveWallets(phrase, env = process.env) {
+  const jwk = await aoJwk(phrase, env);
+  return { ao: { jwk, address: jwkToAddress(jwk) }, ...chainWallets(phrase) };
+}
 var publicAddresses = (w) => ({
   ao: w.ao.address,
   base: w.base.address,
@@ -188,12 +190,32 @@ var publicAddresses = (w) => ({
   sui: w.sui.address
 });
 
+// src/agents.mjs
+import fs2 from "node:fs";
+import path2 from "node:path";
+var FILE = path2.join(HOME, "agents.json");
+function readAgents() {
+  try {
+    return JSON.parse(fs2.readFileSync(FILE, "utf8"));
+  } catch {
+    return {};
+  }
+}
+function saveAgent(name, entry) {
+  const all = readAgents();
+  all[name] = { ...all[name], ...entry, addresses: { ...all[name]?.addresses, ...entry.addresses } };
+  fs2.mkdirSync(HOME, { recursive: true, mode: 448 });
+  fs2.writeFileSync(FILE, `${JSON.stringify(all, null, 2)}
+`);
+  return all[name];
+}
+
 // src/runtime.mjs
-var HERE = path2.dirname(fileURLToPath(import.meta.url));
-var DIST = fs2.existsSync(path2.join(HERE, "graph.json")) ? HERE : path2.join(HERE, "..", "dist");
-var graph = JSON.parse(fs2.readFileSync(path2.join(DIST, "graph.json"), "utf8"));
+var HERE = path3.dirname(fileURLToPath(import.meta.url));
+var DIST = fs3.existsSync(path3.join(HERE, "graph.json")) ? HERE : path3.join(HERE, "..", "dist");
+var graph = JSON.parse(fs3.readFileSync(path3.join(DIST, "graph.json"), "utf8"));
 var NODE = graph.node.replace(/\/$/, "");
-var chains = JSON.parse(fs2.readFileSync(path2.join(DIST, "chains.json"), "utf8"));
+var chains = JSON.parse(fs3.readFileSync(path3.join(DIST, "chains.json"), "utf8"));
 var PROCESS_ALIASES = {
   game: graph.processes.game,
   rune: graph.processes.rune,
@@ -215,7 +237,8 @@ var loaded = null;
 function runtime() {
   loaded ??= (async () => {
     const wallets = READ_ONLY ? null : await deriveWallets(readPhrase());
-    const api = await import(pathToFileURL(path2.join(DIST, "client.mjs")).href);
+    if (wallets && process.env.PARALITH_AGENT) saveAgent(process.env.PARALITH_AGENT, { addresses: publicAddresses(wallets) });
+    const api = await import(pathToFileURL(path3.join(DIST, "client.mjs")).href);
     if (wallets) api.swarmWalletSlot.wallet = walletShim(wallets.ao.jwk);
     return { api, wallets };
   })();
@@ -277,7 +300,7 @@ async function until(what, read, done, timeoutMs = 6e5, everyMs = 3e3) {
 
 // src/build.mjs
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z as z7 } from "zod";
+import { z as z9 } from "zod";
 
 // src/tool.mjs
 import { z } from "zod";
@@ -1153,6 +1176,19 @@ function suiChain(w) {
     }
   };
 }
+async function gasOf(name, address) {
+  if (name === "base") {
+    const rpc = process.env.PARALITH_BASE_RPC || chains.base.rpc;
+    const pub = createPublicClient({ chain: { ...base, id: chains.base.chainId }, transport: http(rpc) });
+    return `${formatEther(await pub.getBalance({ address }))} ETH`;
+  }
+  if (name === "solana") {
+    const conn = new Connection(process.env.PARALITH_SOLANA_RPC || chains.solana.rpc, "confirmed");
+    return `${await conn.getBalance(new PublicKey(address)) / 1e9} SOL`;
+  }
+  const client = new SuiGrpcClient({ network: chains.sui.network, baseUrl: process.env.PARALITH_SUI_RPC || chains.sui.rpc });
+  return `${Number((await client.getBalance({ owner: address })).balance.balance) / 1e9} SUI`;
+}
 async function chainFor(name) {
   const { wallets } = await runtime();
   return { base: baseChain, solana: solanaChain, sui: suiChain }[name](wallets);
@@ -1420,11 +1456,11 @@ function registerDao(server) {
       exec_process: z5.string().regex(ID).optional().describe("Process the passed proposal sends its one message to."),
       exec_tags: z5.record(z5.string(), z5.string()).optional().describe('Tags of that message, e.g. {"Action": "Admin.SetRules", ...}. At most 16; required with exec_process.')
     },
-    async ({ title, body, link, exec_process, exec_tags }) => send({
+    async ({ title, body, link: link2, exec_process, exec_tags }) => send({
       Action: "Propose",
       Title: title,
       Body: body,
-      Link: link,
+      Link: link2,
       "Exec-Process": exec_process,
       "Exec-Tags": exec_tags && JSON.stringify(exec_tags)
     }),
@@ -1626,6 +1662,175 @@ function registerVaults(server) {
   );
 }
 
+// src/show.mjs
+import fs4 from "node:fs";
+import path4 from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+import { z as z7 } from "zod";
+import { registerAppResource, registerAppTool, RESOURCE_MIME_TYPE } from "@modelcontextprotocol/ext-apps/server";
+var GAME = (process.env.PARALITH_GAME_URL || "https://game.paralithmarkets.com").replace(/\/$/, "");
+var TRADE = (process.env.PARALITH_TRADE_URL || "https://trade.paralithmarkets.com").replace(/\/$/, "");
+var URI = "ui://paralith/view";
+var HERE2 = path4.dirname(fileURLToPath2(import.meta.url));
+function viewHtml() {
+  for (const file of [path4.join(HERE2, "view.html"), path4.join(HERE2, "..", "dist", "view.html")]) {
+    if (fs4.existsSync(file)) return fs4.readFileSync(file, "utf8");
+  }
+  throw new Error("view.html is missing: run npm run build");
+}
+var link = (base2, page, params) => {
+  const query = new URLSearchParams(Object.entries(params).filter(([, v]) => v !== void 0 && v !== ""));
+  return `${base2}/embed/${page}${query.size ? `?${query}` : ""}`;
+};
+var VIEWS = {
+  battle: (a) => a.battle_id && a.worker ? link(GAME, "battle", { w: a.worker, b: a.battle_id, a: a.address }) : link(GAME, "battle", { a: need2(a, "address") }),
+  companion: (a) => link(GAME, "companion", { a: need2(a, "address"), m: a.monster_id }),
+  hunt: (a) => link(GAME, "hunt", { a: need2(a, "address") }),
+  market: (a) => link(TRADE, "market", { venue: a.venue ?? "token", m: need2(a, "market") }),
+  vault: (a) => link(TRADE, "vault", { venue: a.venue ?? "token", m: need2(a, "market"), v: a.vault ?? "amm" }),
+  position: (a) => link(TRADE, "position", { venue: a.venue ?? "token", a: need2(a, "address") }),
+  bridge: (a) => link(TRADE, "bridge", { a: a.address, chain: a.chain, tx: a.tx })
+};
+function need2(args, key) {
+  if (!args[key]) throw new Error(`${key} is required to show this.`);
+  return args[key];
+}
+async function ownAddress() {
+  if (READ_ONLY) return void 0;
+  const { wallets } = await runtime();
+  return wallets?.ao.address;
+}
+function registerShow(server) {
+  const csp = { frameDomains: [GAME, TRADE] };
+  registerAppResource(
+    server,
+    "Paralith view",
+    URI,
+    { description: "Live game and exchange visuals." },
+    async () => ({ contents: [{ uri: URI, mimeType: RESOURCE_MIME_TYPE, text: viewHtml(), _meta: { ui: { csp } } }] })
+  );
+  registerAppTool(server, "show", {
+    description: "Show something with the game's and exchange's own visuals, live: battle (follows a player's arena fights, animated), companion (card), hunt, market (order book and chart), vault, position, bridge (transfers). Returns a link; clients that support MCP Apps also display it inline. Address defaults to yours.",
+    inputSchema: {
+      what: z7.enum(Object.keys(VIEWS)),
+      address: z7.string().optional().describe("AO address; omit for yours."),
+      monster_id: z7.string().optional().describe("companion: which one; omit for the active companion."),
+      battle_id: z7.string().optional().describe("battle: a specific battle, with worker."),
+      worker: z7.string().optional().describe("battle: the battle worker process id."),
+      venue: z7.enum(["game", "token"]).optional().describe("market/vault/position. Default token."),
+      market: z7.string().optional().describe("market/vault: the market, as exchange_markets lists it."),
+      vault: z7.enum(["amm", "active", "grid"]).optional(),
+      chain: z7.enum(["base", "solana", "sui"]).optional().describe("bridge: with tx, one transfer."),
+      tx: z7.string().optional()
+    },
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    _meta: { ui: { resourceUri: URI } }
+  }, async (args) => {
+    try {
+      const view = VIEWS[args.what]({ ...args, address: args.address ?? await ownAddress() });
+      return { structuredContent: { what: args.what, view }, content: [{ type: "text", text: `${args.what}: ${view}` }] };
+    } catch (error) {
+      return { isError: true, content: [{ type: "text", text: error.message }] };
+    }
+  });
+}
+
+// src/progress.mjs
+import { z as z8 } from "zod";
+var VENUES = { game: graph.processes.internalVenue, token: graph.processes.externalVenue };
+var count = (x) => Array.isArray(x) ? x.length : Object.values(x ?? {}).reduce((n, v) => n + Number(v || 0), 0);
+async function targets(who) {
+  const { wallets } = await runtime();
+  const agents = readAgents();
+  const self = wallets && { name: process.env.PARALITH_AGENT ?? "you", addresses: publicAddresses(wallets) };
+  if (!who || who === "me") {
+    if (!self) throw new Error("This server has no wallet; pass who: an AO address.");
+    return [self];
+  }
+  if (who === "all") {
+    const list = Object.entries(agents).map(([name, a]) => ({ name, addresses: a.addresses }));
+    if (self && !list.some((t) => t.name === self.name)) list.unshift(self);
+    if (!list.length) throw new Error("No agents are set up here. Run: npx -y paralith-mcp@latest setup");
+    return list;
+  }
+  if (agents[who]) return [{ name: who, addresses: agents[who].addresses }];
+  if (ID.test(who)) return [{ name: who, addresses: { ao: who } }];
+  throw new Error(`"${who}" is not an agent here (${Object.keys(agents).join(", ") || "none"}) or an AO address.`);
+}
+async function report({ name, addresses: a }) {
+  const { api } = await runtime();
+  const out = { agent: name, addresses: a };
+  const todo = [];
+  const gas = Object.fromEntries(await Promise.all(["base", "solana", "sui"].filter((c) => a[c]).map(async (c) => [c, await gasOf(c, a[c]).catch(() => "unreadable")])));
+  if (Object.keys(gas).length) out.gas = gas;
+  if (!a.ao) {
+    out.note = "AO key not derived yet: it appears once this agent's app has started the server.";
+    return out;
+  }
+  const [p, tokens, venues, redemptions] = await Promise.all([
+    api.readPlayer(a.ao).catch(() => null),
+    Promise.all(Object.entries({ rune: graph.processes.rune, pusd: graph.processes.pusd, ...graph.processes.elements }).map(async ([t, id]) => [t, await readAtoms(id, `balance-${a.ao}`).catch(() => 0n)])),
+    Promise.all(Object.entries(VENUES).map(async ([v, pid]) => [
+      v,
+      await api.readVenuePosition(pid, a.ao).catch(() => null),
+      await api.readVenueVaultPositions(pid, a.ao).catch(() => null)
+    ])),
+    readKey("pusd", "withdrawals").catch(() => null)
+  ]);
+  if (!p) {
+    out.game = { joined: false };
+    todo.push("Join the game (game_join).");
+  } else {
+    const raw = p.monsters?.[p.activeId] ?? p.collection?.[p.activeId];
+    const c = companion(raw);
+    out.game = {
+      faction: p.faction,
+      gold: p.gold,
+      rune: p.inventory?.rune ?? 0,
+      companion: c && { name: c.name, level: c.level, exp: c.exp, energy: c.energy, happiness: c.happiness },
+      arena: { wins: p.wins ?? 0, losses: p.losses ?? 0, rating: p.rating, sessionBattlesLeft: p.battlesRemaining ?? 0 },
+      ...p.battleFleet ? { inBattle: p.battleFleet.battleId } : {},
+      ...p.hunt ? { onHunt: p.hunt.runId } : {}
+    };
+    if (!p.dailyReadyAt || Number(p.dailyReadyAt) <= Date.now()) todo.push("Daily crate is ready (game_daily).");
+    if (count(p.lootboxes)) todo.push(`${count(p.lootboxes)} loot box(es) to open (game_lootbox).`);
+    if (raw && Number(raw.exp ?? 0) >= Number(raw.nextLevelExp ?? Infinity)) todo.push("Companion can level up (game_level_up).");
+    if (c && (c.energy < 25 || c.happiness < 25)) todo.push("Companion is below the arena's 25 energy/happiness: feed or play.");
+  }
+  const held = Object.fromEntries(tokens.filter(([, v]) => v > 0n).map(([t, v]) => [t, formatAtoms(v)]));
+  if (Object.keys(held).length) out.tokens = held;
+  const trading = {};
+  for (const [v, pos, vaults] of venues) {
+    const row = {};
+    if (pos?.orders?.length) row.openOrders = pos.orders.length;
+    if (pos?.fills?.length) row.recentFills = pos.fills.length;
+    const shares = Object.entries(vaults ?? {}).flatMap(([m, r]) => Object.entries(r).filter(([, x]) => BigInt(x?.shares ?? 0) > 0n).map(([s]) => `${m} ${s}`));
+    if (shares.length) row.vaults = shares;
+    if (Object.keys(row).length) trading[v] = row;
+  }
+  if (Object.keys(trading).length) out.trading = trading;
+  const pending = (redemptions ?? []).filter((w) => w.account === a.ao && w.status !== "released");
+  if (pending.length) out.bridge = { pendingRedemptions: pending.length };
+  if (Object.keys(gas).length && Object.values(gas).every((g) => /^0 /.test(g))) {
+    todo.push("No chain gas yet: fund an address above to bridge.");
+  }
+  if (todo.length) out.todo = todo;
+  return out;
+}
+function registerProgress(server) {
+  tool(
+    server,
+    "progress",
+    'How an agent is doing, in one free read: game (companion, Gold, Rune, arena record, live battle or hunt), tokens, open orders and vault shares on both venues, pending bridge redemptions, chain gas, and what needs doing next. who: omit for yourself, "all" for every agent set up on this machine, an agent name (claude, codex, grok) or an AO address.',
+    { who: z8.string().optional() },
+    async ({ who }) => {
+      const list = await Promise.all((await targets(who)).map(report));
+      return list.length === 1 ? list[0] : list;
+    },
+    READ
+  );
+}
+
 // src/build.mjs
 var DOCS = process.env.PARALITH_DOCS_URL || "https://docs.paralithmarkets.com";
 var INSTRUCTIONS = `Paralith on AO (HyperBEAM): Rune Realm (a companion game), two order books, and the PUSD bridge.
@@ -1642,13 +1847,17 @@ Vaults (pooled liquidity, one amm/active/grid per market): vault_list, vault_pos
 Rune: rune_move withdraw (game -> token) / deposit (token -> game). Bridge: bridge_balances, bridge_faucet, bridge_deposit, bridge_redeem.
 DAO (stake TEST-RUNE; a passed proposal may send one attached message): dao_info, dao_proposals, dao_stake stake/unstake/withdraw, dao_propose, dao_vote.
 
+To report how you (or every agent set up on this machine) are doing, call progress (who: "all" for every agent); it also lists what needs doing next.
+
+To let the user SEE something (an arena fight as it happens, a companion, a hunt, a market's book and chart, a vault, a position, bridge transfers), call show: it returns a live link and displays inline where the client supports it.
+
 Rules: if a tool says a write WAS accepted but unconfirmed, never resend it; re-read state instead.
 A refusal ({"error": ...}) costs nothing. Use game_catalog for exact costs and move stats; docs at ${DOCS}/llms-full.txt.`;
 var READ_ONLY_NOTE = `This endpoint is READ-ONLY: it explains the protocol and reads live state for any address.
 To play, trade or bridge, run the local server with a wallet phrase: ${DOCS}/ai/mcp`;
 function buildServer() {
   const server = new McpServer(
-    { name: "paralith", version: "0.1.0" },
+    { name: "paralith", version: "0.3.0" },
     { instructions: READ_ONLY ? `${READ_ONLY_NOTE}
 
 ${INSTRUCTIONS}` : INSTRUCTIONS }
@@ -1679,7 +1888,7 @@ ${INSTRUCTIONS}` : INSTRUCTIONS }
     server,
     "read_state",
     `Read any published key of any process, free: /<process>~process@1.0/now/<key>. process is an id or an alias (${Object.keys(PROCESS_ALIASES).join(", ")}). Returns null when absent.`,
-    { process: z7.string(), key: z7.string() },
+    { process: z9.string(), key: z9.string() },
     async ({ process: process2, key }) => readKey(process2, key),
     READ
   );
@@ -1688,10 +1897,10 @@ ${INSTRUCTIONS}` : INSTRUCTIONS }
     "send_message",
     "Escape hatch: sign and send a raw message to any process and return its reply. Prefer the specific tools; use this only for an action they do not cover. Tag values must be strings; never use a tag named Target.",
     {
-      process: z7.string(),
-      tags: z7.record(z7.string(), z7.string()).describe('e.g. {"Action": "Pass.Info"}'),
-      data: z7.string().optional(),
-      push_outbox: z7.boolean().optional().describe("Deliver the messages this one emits to other processes (e.g. a Transfer to a process).")
+      process: z9.string(),
+      tags: z9.record(z9.string(), z9.string()).describe('e.g. {"Action": "Pass.Info"}'),
+      data: z9.string().optional(),
+      push_outbox: z9.boolean().optional().describe("Deliver the messages this one emits to other processes (e.g. a Transfer to a process).")
     },
     async ({ process: process2, tags: tags2, data, push_outbox }) => {
       if (Object.keys(tags2).some((k) => k.toLowerCase() === "target")) throw new Error("Target is not a usable tag name.");
@@ -1720,6 +1929,8 @@ ${INSTRUCTIONS}` : INSTRUCTIONS }
   registerBridge(server);
   registerDao(server);
   registerVaults(server);
+  registerShow(server);
+  registerProgress(server);
   return server;
 }