@mnemom/mnemom 0.17.9-next.0 → 0.17.10

package/dist/lib/try-me.js

@@ -21,8 +21,8 @@
  * consumes and tolerate everything else (`[key: string]: unknown`) so a manifest
  * bump that adds fields never breaks the CLI.
  */
-import { MnemomApiError, readApiError } from "./api.js";
-import { getApiUrl } from "./config.js";
+import { MnemomApiError, normalizeApiError, readApiError } from "./api.js";
+import { getApiUrl, getWebsiteUrl } from "./config.js";
 // ── resolve (zero-auth; the token IS the credential) ─────────────────────────
 const TOKEN_RE = /^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/;
 /** True iff `token` is shaped like a try-me token (tryme_… / a bare slug). */
@@ -212,7 +212,28 @@ export async function birthAgent(manifest, name, opts = {}) {
     const agentId = response.headers.get(manifest.gateway.agent_header.toLowerCase());
     if (!response.ok && !agentId) {
         const text = await response.text().catch(() => "");
-        throw new MnemomApiError(response.status, `Birth call failed (${response.status}) and no agent id was minted: ${text.slice(0, 300)}`);
+        let raw;
+        try {
+            raw = JSON.parse(text);
+        }
+        catch {
+            raw = null;
+        }
+        const parsed = normalizeApiError(raw);
+        const outOfMu = describeOutOfMu({
+            status: response.status,
+            code: parsed.code,
+            message: parsed.message,
+            details: parsed.details,
+        });
+        if (outOfMu) {
+            throw new MnemomApiError(response.status, outOfMu, {
+                code: parsed.code,
+                details: parsed.details,
+            });
+        }
+        throw new MnemomApiError(response.status, `Birth call failed (${response.status}) and no agent id was minted: ` +
+            (parsed.message ?? text.slice(0, 300)), { code: parsed.code, details: parsed.details });
     }
     if (!agentId || !/^mnm-/.test(agentId)) {
         throw new Error(`Birth succeeded (${response.status}) but the gateway returned no mnm- agent id on the ` +
@@ -220,6 +241,52 @@ export async function birthAgent(manifest, name, opts = {}) {
     }
     return { agentId, status: response.status };
 }
+/**
+ * Error codes that mean "Dojo play needs µ": the gateway's 402 `billing_error`
+ * (balance_depleted / dojo_billing_account_required) and mnemom-api's Dojo and
+ * card-publish balance refusals.
+ */
+const OUT_OF_MU_CODES = new Set([
+    "billing_error",
+    "balance_depleted",
+    "balance_required",
+    "dojo_balance_depleted",
+    "dojo_billing_unconfigured",
+]);
+/**
+ * Where to recharge: the server's `details.top_up_url` (absolute, or a path on
+ * the website), else the website's billing page.
+ */
+export function rechargeUrl(details, websiteBase = getWebsiteUrl()) {
+    const base = websiteBase.replace(/\/$/, "");
+    const fromServer = details && typeof details === "object"
+        ? details.top_up_url
+        : undefined;
+    if (typeof fromServer === "string") {
+        if (/^https?:\/\//.test(fromServer))
+            return fromServer;
+        if (fromServer.startsWith("/"))
+            return `${base}${fromServer}`;
+    }
+    return `${base}/settings/billing`;
+}
+/**
+ * The human message for a refusal that means the org is out of µ (or has no
+ * billing account): what happened, where to recharge, and how to resume.
+ * Undefined for any other refusal.
+ */
+export function describeOutOfMu(refusal, websiteBase = getWebsiteUrl()) {
+    const isOutOfMu = refusal.status === 402 || (refusal.code !== undefined && OUT_OF_MU_CODES.has(refusal.code));
+    if (!isOutOfMu)
+        return undefined;
+    const url = rechargeUrl(refusal.details, websiteBase);
+    const said = refusal.message?.trim();
+    const lead = said || "Your organization's µ balance is used up.";
+    const withUrl = lead.includes(url) ? lead : `${lead} Recharge at ${url}.`;
+    const headline = /^out of µ/i.test(withUrl) ? withUrl : `Out of µ — ${withUrl}`;
+    return (`${headline} Dojo play is charged to your organization's µ balance; ` +
+        "once it is recharged, re-run this command to keep going.");
+}
 /**
  * Read the PUBLIC (no-auth) agent projection used to detect the human's claim.
  * Never throws — a transient 404/5xx (the agent not yet queryable, or a blip)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnemom/mnemom",
-  "version": "0.17.9-next.0",
+  "version": "0.17.10",
   "description": "Transparent AI agent tracing",
   "type": "module",
   "bin": {