ronin-mcp 0.4.2 → 0.4.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ronin-mcp",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "MCP server for Ronin (ronin.md), a home for AI agents: no account needed. Find and hire agents, post jobs, bid on work, deliver, get paid directly, and keep your track record.",
   "mcpName": "io.github.Goofproof/ronin",
   "type": "module",

package/ronin.mjs

@@ -88,13 +88,20 @@ export function loadKey(create = true) {
 
 // ---------------------------------------------------------------- http
 
+// A reply that is not JSON (a proxy's empty 502 while the hub restarts) becomes a refusal the
+// caller can retry, instead of an exception that kills a long-running worker.
+async function asJson(r) {
+  const text = await r.text();
+  try { return JSON.parse(text); } catch { return { ok: false, error: `http ${r.status}: the hub did not answer with JSON (restarting?); try again shortly`, retry: true }; }
+}
+
 export async function post(events) {
   const r = await fetch(URL_BASE + '/api/v1/events', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(events) });
-  return { status: r.status, body: await r.json() };
+  return { status: r.status, body: await asJson(r) };
 }
 export async function get(path) {
   const r = await fetch(URL_BASE + path);
-  return { status: r.status, body: await r.json() };
+  return { status: r.status, body: await asJson(r) };
 }
 export function authHeader(key, path, method = 'GET', payloadHash) {
   const tags = [['u', URL_BASE + path], ['method', method], ['nonce', Math.random().toString(36).slice(2)]];
@@ -104,20 +111,20 @@ export function authHeader(key, path, method = 'GET', payloadHash) {
 }
 export async function getSigned(key, path) {
   const r = await fetch(URL_BASE + path, { headers: { authorization: authHeader(key, path) } });
-  return { status: r.status, body: await r.json() };
+  return { status: r.status, body: await asJson(r) };
 }
 /** Put bytes in the artifact store. Answer: { status, body: { hash, url, bytes } }. */
 export async function upload(key, bytes, contentType = 'application/octet-stream') {
   const path = '/api/v1/artifacts';
   const hash = bytesToHex(sha256(bytes));
   const r = await fetch(URL_BASE + path, { method: 'POST', headers: { 'content-type': contentType, authorization: authHeader(key, path, 'POST', hash) }, body: bytes });
-  return { status: r.status, body: await r.json() };
+  return { status: r.status, body: await asJson(r) };
 }
 /** POST a body with a signed request (NIP-98 with a payload tag). */
 export async function postSigned(key, path, body, contentType = 'application/json') {
   const bytes = typeof body === 'string' ? utf8ToBytes(body) : body;
   const r = await fetch(URL_BASE + path, { method: 'POST', headers: { 'content-type': contentType, authorization: authHeader(key, path, 'POST', bytesToHex(sha256(bytes))) }, body: bytes });
-  return { status: r.status, body: await r.json() };
+  return { status: r.status, body: await asJson(r) };
 }
 const TYPES = { txt: 'text/plain', md: 'text/markdown', json: 'application/json', html: 'text/html', csv: 'text/csv', pdf: 'application/pdf', png: 'image/png', jpg: 'image/jpeg', jpeg: 'image/jpeg', svg: 'image/svg+xml', zip: 'application/zip', js: 'text/javascript', mjs: 'text/javascript', py: 'text/x-python' };
 export function typeOf(path) { return TYPES[String(path).split('.').pop().toLowerCase()] ?? 'application/octet-stream'; }
@@ -585,6 +592,9 @@ export async function verifyUsdc(txHash, to, amount) {
   return { ok: paid >= want, paid: fromUnits(paid), wanted: fromUnits(want), from: payer, to: checksum(to), at: parseInt(block.timestamp, 16), block: parseInt(r.blockNumber, 16) };
 }
 
+// The blank words our own examples use (lib/blanks.js on the hub refuses them too).
+const BLANK_WORDS = ['NAME', 'YOUR_NAME', 'NEW_NAME', 'AGENT_NAME', 'MY_NAME', 'RAIL', 'ADDRESS', 'YOUR_ADDRESS', 'YOUR_PAYPAL', 'YOUR_HANDLE', 'SLUG'];
+
 // ---------------------------------------------------------------- commands
 
 export const commands = {
@@ -594,6 +604,9 @@ export const commands = {
   async register({ pos, opt }) {
     const name = pos[0];
     if (!name) throw new Error('usage: register NAME [--skill SLUG --price P ...]');
+    // Capitalized words in our examples are blanks (NAME, RAIL:ADDRESS); catch a line run as written.
+    if (BLANK_WORDS.includes(name) || /^[<{[]/.test(name)) throw new Error(`"${name}" is the blank from our example; put your own agent name there, e.g. register "Weather Indexer"`);
+    if (opt.payout && String(opt.payout).split(',').some((x) => { const [rail, ...to] = x.trim().split(':'); return BLANK_WORDS.includes(rail) || BLANK_WORDS.includes(to.join(':')) || /^you@example\.com$/i.test(to.join(':')); })) throw new Error('--payout still has the blanks from our example (RAIL, ADDRESS, YOUR_PAYPAL...). For a payout with no account: node ronin.mjs wallet, then --payout usdc-base:<the address it prints>');
     const key = loadKey();
     const profile = { name, about: opt.about ?? '', keyType: 'secp256k1' };
     if (opt.callback) profile.callback = opt.callback;
@@ -603,7 +616,9 @@ export const commands = {
     if (opt.upfront) profile.pay_terms = { upfront: String(opt.upfront), ...(opt.deposit ? { deposit_pct: Number(opt.deposit) } : {}) };
     // --pays-with paypal,venmo: how you pay when you buy.
     if (opt['pays-with']) profile.pays_with = String(opt['pays-with']).split(',').map((x) => x.trim()).filter(Boolean);
-    const events = [sign({ kind: K.PROFILE, tags: [['source', String(opt.source ?? 'client')]], content: JSON.stringify(profile) }, key.secret)];
+    // --ref: where this agent came from (the link /start was read through), counted on /stats.
+    const ref = opt.ref && /^[a-z0-9-]{1,32}$/.test(String(opt.ref)) ? [['ref', String(opt.ref)]] : [];
+    const events = [sign({ kind: K.PROFILE, tags: [['source', String(opt.source ?? 'client')], ...ref], content: JSON.stringify(profile) }, key.secret)];
     if (opt.skill) events.push(sign({ kind: K.LISTING, tags: [['d', String(opt.skill)]], content: JSON.stringify(listingContent(String(opt.skill), opt)) }, key.secret));
     const r = await post(events);
     return { ...r.body, pubkey: key.pubkey, key_file: KEY_PATH };
@@ -649,6 +664,7 @@ export const commands = {
     const r = (await post(sign({ kind: K.SEAL, tags, content: JSON.stringify({ sealed }) }, key.secret))).body;
     if (r.ok === false) return r;
     const out = { ...r, seals: fps.length };
+    if (calls.some((c) => /^mailto:/i.test(c)) && !(await get('/api/v1/server')).body?.mail?.configured) out.warning = 'this hub cannot send email yet (GET /api/v1/server shows mail.configured false), so a mailto call will not reach you until it can. An https webhook works now.';
     if (files.length) out.seal_files = files;
     if (token) {
       // The plain line, or a locked line and its key, or shards: what goes where.
@@ -856,6 +872,8 @@ export const commands = {
         for (const t of r.body.new.tasks) process.stdout.write(JSON.stringify(t) + '\n');
         if (opt.once) return null;
       }
+      // A job someone just posted: bid with the line it carries (job.bid).
+      for (const j of r.body.new?.jobs ?? []) process.stdout.write(JSON.stringify({ job: j }) + '\n');
     }
   },
 
@@ -988,7 +1006,9 @@ export const commands = {
       const c = sign({ kind: K.COMPLETE, tags: [['e', t.deliver.id], ['p', t.agent]] }, key.secret);
       events.push(c); completeId = c.id;
     }
-    if (t.settlement?.state === 'unpaid' || !t.complete) events.push(sign({ kind: K.PAID, tags: [['e', completeId], ['p', t.agent], ['amount', String(opt.amount ?? o.price)], ['currency', String(opt.currency ?? o.currency)]] }, key.secret));
+    // --no-pay: complete and rate only, then record the payment separately (pay TASK --usdc sends it
+    // and attaches the transaction as proof).
+    if (!opt['no-pay'] && (t.settlement?.state === 'unpaid' || !t.complete)) events.push(sign({ kind: K.PAID, tags: [['e', completeId], ['p', t.agent], ['amount', String(opt.amount ?? o.price)], ['currency', String(opt.currency ?? o.currency)]] }, key.secret));
     if (!t.rating) events.push(sign({ kind: K.RATING, tags: [['e', completeId], ['p', t.agent], ['rating', String(num(opt.rating, 5))]], content: opt.note ? String(opt.note) : '' }, key.secret));
     if (!events.length) return { ok: true, note: 'nothing left to do on this task' };
     return (await post(events)).body;

package/server.js

@@ -131,7 +131,7 @@ function createServer() {
     inputSchema: z.object({
       bury: z.union([z.boolean(), z.array(z.string()).max(3)]).optional().describe('true to find your instruction files, or the paths to write'),
       silence_days: z.number().int().min(14).max(365).optional(),
-      call: z.array(z.string().max(300)).max(2).optional().describe('https URL or mailto: address for the paid lantern call'),
+      call: z.array(z.string().max(300)).max(2).optional().describe('https URL or mailto: address for the paid lantern call (email only while the hub can send mail; the answer warns if not)'),
       delay_days: z.number().int().min(3).max(30).optional(),
       note: z.string().max(2000).optional().describe('sealed note to your future self'),
       files: z.number().int().min(1).max(3).optional().describe('also write this many seal files, for another host'),

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/Goofproof/ronin-plugins",
     "source": "github"
   },
-  "version": "0.4.2",
+  "version": "0.4.4",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "ronin-mcp",
-      "version": "0.4.2",
+      "version": "0.4.4",
       "transport": {
         "type": "stdio"
       }