paralith-mcp 0.3.1 → 0.4.0

package/dist/graph.json

@@ -1,34 +1,34 @@
 {
   "node": "https://hyperbeam.tylerw.ai",
   "owner": "DA9qhP25ZPz6MHIhO-7aNHDN3LsTAL7yCKYIkqr13Z8",
-  "deployedAt": "2026-10-10T15:51:09.959Z",
+  "deployedAt": "2026-10-12T02:01:10.919Z",
   "processes": {
-    "game": "bqkZT1qY8Qpea7QsKZEk8q7m0yUE8-G3Miq8EFXnRJg",
-    "rune": "0j4rkkEqUO25aXI8LoDuou2Ibr0GSMGsXrFRxwrSfY8",
-    "pusd": "xhYkQ8qm7zssDC2nrOfzkk2Xy8rPVvlEMWestfrAvK8",
-    "dao": "YAPgWNxRQksjYn_zfUw-h-JkwpmJDtPL1K9yifR5S_Q",
+    "game": "AUitn972WGLDj0pMCVbXXacTtOk2PNchgP2qaP_kNoI",
+    "rune": "rYfYbQu9vIin_FKcpkxLtcF21pIQbdY-pOkkM5igyVg",
+    "pusd": "N4VZxxFb4qArB4SJawvqnLZSRPX9GFs7iGnRQ3Kr-4M",
+    "dao": "YAPCQK-3STKc-XND5-O4v-wEQBv7M4S-i__rkQKvQdk",
     "elements": {
-      "earth": "3CS-LPEfD4YJwpuh1kuPGOv3lGwIlOAWOT15ATGIbPg",
-      "air": "y51gmVYD1GoJWtMxAtePMnvMCR0aT-jSfnsMKjFeU70",
-      "fire": "os6EKVQGuukvgTFmaZbGj23Xt3frHB3cb8ljquCdJ18",
-      "water": "P9OPPoVw9MxpIz8QghA6TcYUhXrYG3Ro09KM8shX5QM"
+      "earth": "wCtjJMScFI6jjioNQdRDUdyFWiqYubaRYyUeeMYYOjI",
+      "air": "1he9rnfufmEoPFeDYV_LzkA7e3AM98MXARal2Oq-4lc",
+      "fire": "4lffB0KjBEix1I7g1nBmeIdllhqhyHH75NiUQs5De2o",
+      "water": "EwiZp-92W7k8xZntMs2u3HAJ-RdDqTdAzvia_6KxlI0"
     },
-    "internalVenue": "pxw-Y9Hl8CNQlPGLr-2Ez_9BVjjEP6wisxrZhe-AyxU",
-    "externalVenue": "D3SUysjoweBXtoGFm4zoq1dKSt7Dc5b_V9x_weLJV7Y",
-    "hunt": "4iABQxFjL3LtMGgfZQuwsH5WHKKjjSu7b7XfxEN_j40",
+    "internalVenue": "H0KOjdtL_IT57KZgHlTd2yK6xcsQVy3AqxTcLS-TRCk",
+    "externalVenue": "nrRF3SiPWoeLU0lUCFUXSzowNlEKli7z8Wtu050l2Uk",
+    "hunt": "kKpOdP--5hA3fy-i5q6-agoHFNKuYW4c_9Qg8NvAIew",
     "huntWorkers": [
-      "4iABQxFjL3LtMGgfZQuwsH5WHKKjjSu7b7XfxEN_j40",
-      "2RBkmldqPdij2PopnEPuStLl6Pb6OcIrpilfK64Q1m8",
-      "EATa5vTV53J1c711CEjiuks2Kllq3Gi-kVSXFqe7O7M",
-      "SHXyU87725eI8i6qSET70Pwovf744DJqEfajTZI4N4M",
-      "iesbJSITvqtDXMHxhGeOOXUXofnD-nh1qro9PH5IHNQ"
+      "kKpOdP--5hA3fy-i5q6-agoHFNKuYW4c_9Qg8NvAIew",
+      "NsIK9D0VScuNdf7-avycKxPSTEiHXPBlbFuCEv5ZEuw",
+      "JYtYuPA5weAbXykDnmDUhlU3LacxkY15qWppEDtTP4s",
+      "lJgsZ3GadofVafa8FI3C6fGTf6Aq0yfZFi44P6vRti0",
+      "GUMGAcSdCmKhb75M3NHUkLsdyoAHu7ixyuEldDsXA3c"
     ],
     "battleWorkers": [
-      "Xk8XXWY2QY-UCd1Y_yqx6SHlVt5bNUbQnwzngMgxbzc",
-      "IPjes-iFyMZH_JCx1z-4c-7JEdJgd3RGgbglgl3_u2s",
-      "-m-6qgUsU6ybjOpMMlPHvG1bIlHypFMORKw4blCpRnU",
-      "mSzalVGuEgxAG_tCEhVivSPMhSvmp5ePMHRIW0-gASM",
-      "PkPEU-yZpgn9LwXWYPahUKOPe-Hw2sHB0DPBNPoxQeA"
+      "MgxNZ60Ejc01E5MeuZ1s_8PeLNhExjOz9wUGo3utE1w",
+      "Ww_GXme0Sn3-jIcji0dPxV0nXLYqBesChXqqXQTC0Hc",
+      "4YYgYXTzS_PjbQMthDwf93zik-kvoXYTzrNHA30ijAY",
+      "EWlpRzX-waNNKj0bvT9pzj_N4_bv2ndYPMOJaiVkWlw",
+      "v5_n4eOw24s1wGjI8-fjoGTfQHwjcO-tcHFxIiO5Qrk"
     ]
   },
   "huntNode": "https://hyperbeam.tylerw.ai",

package/dist/http.mjs

@@ -304,6 +304,34 @@ import { z as z9 } from "zod";
 
 // src/tool.mjs
 import { z } from "zod";
+
+// src/update.mjs
+var VERSION = "0.3.2";
+var CHECK_MS = 6 * 36e5;
+var NOTE_MS = 36e5;
+var latest = null;
+var checkedAt = 0;
+var notedAt = 0;
+var newer = (a, b) => {
+  const [x, y] = [a, b].map((v) => v.split(".").map(Number));
+  for (let i = 0; i < 3; i++) if (x[i] !== y[i]) return x[i] > y[i];
+  return false;
+};
+function check(now) {
+  checkedAt = now;
+  fetch("https://registry.npmjs.org/paralith-mcp/latest", { signal: AbortSignal.timeout(1e4) }).then((r) => r.ok ? r.json() : null).then((j) => {
+    if (j?.version) latest = j.version;
+  }, () => {
+  });
+}
+function updateNote(now = Date.now()) {
+  if (now - checkedAt > CHECK_MS) check(now);
+  if (!latest || !newer(latest, VERSION) || now - notedAt < NOTE_MS) return null;
+  notedAt = now;
+  return `paralith-mcp ${latest} is out (this is ${VERSION}). Tell the user to restart this app to get it.`;
+}
+
+// src/tool.mjs
 var migrationSeen = null;
 async function migrationRefusal(read = readKey, now = Date.now()) {
   if (!migrationSeen || now - migrationSeen.at > 15e3) {
@@ -328,7 +356,8 @@ function tool(server, name, description, inputSchema, run, annotations = {}, vie
       const raw = await run(args ?? {});
       const value = view && !args?.full ? await view(raw) : raw;
       const text = typeof value === "string" ? value : JSON.stringify(value, bigints, 2);
-      return { content: [{ type: "text", text: text ?? "null" }] };
+      const note = READ_ONLY ? null : updateNote();
+      return { content: [{ type: "text", text: text ?? "null" }, ...note ? [{ type: "text", text: note }] : []] };
     } catch (error) {
       return { isError: true, content: [{ type: "text", text: explain(error) }] };
     }
@@ -725,9 +754,9 @@ function registerGame(server) {
   tool(
     server,
     "hunt_act",
-    "Act in your live hunt. search: find a wild creature (3 s cooldown). attack: one round with a move. capture: one try with 1-3 Rune (+1 Scroll), ends the run. decline: leave a defeated creature. end: finish the run and get unspent supplies back. retry_settlement: re-send a stuck final.",
+    "Act in your live hunt. A hunt is one encounter. search: find the wild creature (once per hunt). attack: one round with a move; losing ends the run. After a win: capture (one try with 1-3 Rune + 1 Scroll, consumed either way, ends the run) or end. end: finish the run and get unspent supplies back. retry_settlement: re-send a stuck final.",
     {
-      action: z2.enum(["search", "attack", "capture", "decline", "end", "retry_settlement"]),
+      action: z2.enum(["search", "attack", "capture", "end", "retry_settlement"]),
       move: z2.string().optional(),
       round: z2.number().int().optional(),
       runes: z2.number().int().min(1).max(3).optional()
@@ -745,8 +774,6 @@ function registerGame(server) {
         }
         case "capture":
           return api.huntCapture(route, runes ?? 1);
-        case "decline":
-          return api.huntDeclineCapture(route);
         case "end":
           return api.huntEnd(route);
         case "retry_settlement":
@@ -1873,7 +1900,7 @@ Core loop: game_daily once a day; game_companion feed/play/quest/claim to keep e
 game_level_up when exp allows; game_learn_move when an offer is pending.
 Arena: arena_enter (25 energy + 25 happiness, 4 fights), arena_fight mode=bot, then arena_attack each round
 (read arena_battle for moves and uses left; Rally and Mend are free once each), arena_end leave when done.
-Hunt: hunt_begin -> hunt_act search -> attack until defeated -> capture (1-3 Rune + a Scroll) or decline -> end.
+Hunt: hunt_begin -> hunt_act search -> attack until defeated -> capture (1-3 Rune + a Scroll) or end. One encounter per hunt.
 Markets: exchange_markets / exchange_book / exchange_order on venue "game" (items vs Gold) or "token" (elements vs TEST-RUNE).
 Vaults (pooled liquidity, one amm/active/grid per market): vault_list, vault_position, vault_deposit, vault_shares (withdraw/lock/burn), vault_fund, vault_crank.
 Rune: rune_move withdraw (game -> token) / deposit (token -> game). Bridge: bridge_balances, bridge_faucet, bridge_deposit, bridge_redeem.
@@ -1906,7 +1933,7 @@ var READ_ONLY_NOTE = `This endpoint is READ-ONLY: it explains the protocol and r
 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.3.1" },
+    { name: "paralith", version: VERSION },
     { instructions: READ_ONLY ? `${READ_ONLY_NOTE}
 
 ${INSTRUCTIONS}` : INSTRUCTIONS }

package/dist/server.mjs

@@ -511,6 +511,38 @@ var init_runtime = __esm({
   }
 });
 
+// src/update.mjs
+function check(now) {
+  checkedAt = now;
+  fetch("https://registry.npmjs.org/paralith-mcp/latest", { signal: AbortSignal.timeout(1e4) }).then((r) => r.ok ? r.json() : null).then((j) => {
+    if (j?.version) latest = j.version;
+  }, () => {
+  });
+}
+function updateNote(now = Date.now()) {
+  if (now - checkedAt > CHECK_MS) check(now);
+  if (!latest || !newer(latest, VERSION) || now - notedAt < NOTE_MS) return null;
+  notedAt = now;
+  return `paralith-mcp ${latest} is out (this is ${VERSION}). Tell the user to restart this app to get it.`;
+}
+var VERSION, CHECK_MS, NOTE_MS, latest, checkedAt, notedAt, newer;
+var init_update = __esm({
+  "src/update.mjs"() {
+    "use strict";
+    VERSION = "0.3.2";
+    CHECK_MS = 6 * 36e5;
+    NOTE_MS = 36e5;
+    latest = null;
+    checkedAt = 0;
+    notedAt = 0;
+    newer = (a, b) => {
+      const [x, y] = [a, b].map((v) => v.split(".").map(Number));
+      for (let i = 0; i < 3; i++) if (x[i] !== y[i]) return x[i] > y[i];
+      return false;
+    };
+  }
+});
+
 // src/tool.mjs
 import { z } from "zod";
 async function migrationRefusal(read = readKey, now = Date.now()) {
@@ -536,7 +568,8 @@ function tool(server, name, description, inputSchema, run2, annotations = {}, vi
       const raw = await run2(args ?? {});
       const value = view && !args?.full ? await view(raw) : raw;
       const text = typeof value === "string" ? value : JSON.stringify(value, bigints, 2);
-      return { content: [{ type: "text", text: text ?? "null" }] };
+      const note = READ_ONLY ? null : updateNote();
+      return { content: [{ type: "text", text: text ?? "null" }, ...note ? [{ type: "text", text: note }] : []] };
     } catch (error) {
       return { isError: true, content: [{ type: "text", text: explain(error) }] };
     }
@@ -557,6 +590,7 @@ var init_tool = __esm({
   "src/tool.mjs"() {
     "use strict";
     init_runtime();
+    init_update();
     migrationSeen = null;
     bigints = (_k, v) => typeof v === "bigint" ? v.toString() : v;
     READ = { readOnlyHint: true, openWorldHint: true };
@@ -943,9 +977,9 @@ function registerGame(server) {
   tool(
     server,
     "hunt_act",
-    "Act in your live hunt. search: find a wild creature (3 s cooldown). attack: one round with a move. capture: one try with 1-3 Rune (+1 Scroll), ends the run. decline: leave a defeated creature. end: finish the run and get unspent supplies back. retry_settlement: re-send a stuck final.",
+    "Act in your live hunt. A hunt is one encounter. search: find the wild creature (once per hunt). attack: one round with a move; losing ends the run. After a win: capture (one try with 1-3 Rune + 1 Scroll, consumed either way, ends the run) or end. end: finish the run and get unspent supplies back. retry_settlement: re-send a stuck final.",
     {
-      action: z2.enum(["search", "attack", "capture", "decline", "end", "retry_settlement"]),
+      action: z2.enum(["search", "attack", "capture", "end", "retry_settlement"]),
       move: z2.string().optional(),
       round: z2.number().int().optional(),
       runes: z2.number().int().min(1).max(3).optional()
@@ -963,8 +997,6 @@ function registerGame(server) {
         }
         case "capture":
           return api.huntCapture(route, runes ?? 1);
-        case "decline":
-          return api.huntDeclineCapture(route);
         case "end":
           return api.huntEnd(route);
         case "retry_settlement":
@@ -2152,7 +2184,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z as z9 } from "zod";
 function buildServer() {
   const server = new McpServer(
-    { name: "paralith", version: "0.3.1" },
+    { name: "paralith", version: VERSION },
     { instructions: READ_ONLY ? `${READ_ONLY_NOTE}
 
 ${INSTRUCTIONS}` : INSTRUCTIONS }
@@ -2242,6 +2274,7 @@ var init_build = __esm({
     init_vaults();
     init_show();
     init_progress();
+    init_update();
     DOCS = process.env.PARALITH_DOCS_URL || "https://docs.paralithmarkets.com";
     INSTRUCTIONS = `Paralith on AO (HyperBEAM): Rune Realm (a companion game), two order books, and the PUSD bridge.
 Everything is TEST-prefixed while unreleased. Reads are free; every write is a signed message (a few seconds round trip, longer under load).
@@ -2251,7 +2284,7 @@ Core loop: game_daily once a day; game_companion feed/play/quest/claim to keep e
 game_level_up when exp allows; game_learn_move when an offer is pending.
 Arena: arena_enter (25 energy + 25 happiness, 4 fights), arena_fight mode=bot, then arena_attack each round
 (read arena_battle for moves and uses left; Rally and Mend are free once each), arena_end leave when done.
-Hunt: hunt_begin -> hunt_act search -> attack until defeated -> capture (1-3 Rune + a Scroll) or decline -> end.
+Hunt: hunt_begin -> hunt_act search -> attack until defeated -> capture (1-3 Rune + a Scroll) or end. One encounter per hunt.
 Markets: exchange_markets / exchange_book / exchange_order on venue "game" (items vs Gold) or "token" (elements vs TEST-RUNE).
 Vaults (pooled liquidity, one amm/active/grid per market): vault_list, vault_position, vault_deposit, vault_shares (withdraw/lock/burn), vault_fund, vault_crank.
 Rune: rune_move withdraw (game -> token) / deposit (token -> game). Bridge: bridge_balances, bridge_faucet, bridge_deposit, bridge_redeem.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "paralith-mcp",
-  "version": "0.3.1",
-  "description": "MCP server for Paralith on AO: an AI with one 24-word phrase plays Rune Realm, trades and bridges PUSD (TEST deployment).",
+  "version": "0.4.0",
+  "description": "MCP server for Paralith on AO: an AI with one 24-word phrase plays Rune Realm, trades and bridges PUSD; plus paralith-bridge, the bridge operator CLI (TEST deployment).",
   "license": "UNLICENSED",
   "homepage": "https://docs.paralithmarkets.com/ai/mcp",
   "keywords": [
@@ -15,7 +15,8 @@
   ],
   "type": "module",
   "bin": {
-    "paralith-mcp": "dist/server.mjs"
+    "paralith-mcp": "dist/server.mjs",
+    "paralith-bridge": "dist/bridge.mjs"
   },
   "files": [
     "dist",