paralith-mcp 0.1.0 → 0.2.0

package/dist/client.mjs

@@ -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/http.mjs

@@ -277,7 +277,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 z8 } from "zod";
 
 // src/tool.mjs
 import { z } from "zod";
@@ -1420,11 +1420,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 +1626,79 @@ function registerVaults(server) {
   );
 }
 
+// src/show.mjs
+import fs3 from "node:fs";
+import path3 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 = path3.dirname(fileURLToPath2(import.meta.url));
+function viewHtml() {
+  for (const file of [path3.join(HERE2, "view.html"), path3.join(HERE2, "..", "dist", "view.html")]) {
+    if (fs3.existsSync(file)) return fs3.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/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 +1715,15 @@ 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 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.2.0" },
     { instructions: READ_ONLY ? `${READ_ONLY_NOTE}
 
 ${INSTRUCTIONS}` : INSTRUCTIONS }
@@ -1679,7 +1754,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: z8.string(), key: z8.string() },
     async ({ process: process2, key }) => readKey(process2, key),
     READ
   );
@@ -1688,10 +1763,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: z8.string(),
+      tags: z8.record(z8.string(), z8.string()).describe('e.g. {"Action": "Pass.Info"}'),
+      data: z8.string().optional(),
+      push_outbox: z8.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 +1795,7 @@ ${INSTRUCTIONS}` : INSTRUCTIONS }
   registerBridge(server);
   registerDao(server);
   registerVaults(server);
+  registerShow(server);
   return server;
 }
 

package/dist/server.mjs

@@ -276,7 +276,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 z8 } from "zod";
 
 // src/tool.mjs
 import { z } from "zod";
@@ -1419,11 +1419,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)
     }),
@@ -1625,6 +1625,79 @@ function registerVaults(server) {
   );
 }
 
+// src/show.mjs
+import fs3 from "node:fs";
+import path3 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 = path3.dirname(fileURLToPath2(import.meta.url));
+function viewHtml() {
+  for (const file of [path3.join(HERE2, "view.html"), path3.join(HERE2, "..", "dist", "view.html")]) {
+    if (fs3.existsSync(file)) return fs3.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/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.
@@ -1641,13 +1714,15 @@ 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 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.2.0" },
     { instructions: READ_ONLY ? `${READ_ONLY_NOTE}
 
 ${INSTRUCTIONS}` : INSTRUCTIONS }
@@ -1678,7 +1753,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: z8.string(), key: z8.string() },
     async ({ process: process2, key }) => readKey(process2, key),
     READ
   );
@@ -1687,10 +1762,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: z8.string(),
+      tags: z8.record(z8.string(), z8.string()).describe('e.g. {"Action": "Pass.Info"}'),
+      data: z8.string().optional(),
+      push_outbox: z8.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.");
@@ -1719,6 +1794,7 @@ ${INSTRUCTIONS}` : INSTRUCTIONS }
   registerBridge(server);
   registerDao(server);
   registerVaults(server);
+  registerShow(server);
   return server;
 }