free-pi-cli 0.2.10 → 0.2.12

package/dist/index.js

@@ -30,4 +30,4 @@ if (err) {
   console.error(err);
   process.exit(1);
 }
-await import("./main-b5491jxx.js");
+await import("./main-mh0wmxjc.js");

package/dist/{main-b5491jxx.js → main-mh0wmxjc.js}

@@ -48,7 +48,7 @@ function openBrowser(url, platform = process.platform, spawnImpl = spawn) {
 // package.json
 var package_default = {
   name: "free-pi-cli",
-  version: "0.2.10",
+  version: "0.2.12",
   description: "Free, ad-supported distribution of the pi coding agent. Inference paid for by ads.",
   license: "MIT",
   type: "module",
@@ -14512,7 +14512,10 @@ var MeResponseSchema = exports_external.object({
   handle: exports_external.string(),
   remaining_usd_today: exports_external.number(),
   cap_usd_today: exports_external.number(),
-  tier: AccountTierSchema
+  tier: AccountTierSchema,
+  credit_usd: exports_external.number(),
+  notice: exports_external.string().optional(),
+  buy_url: exports_external.string().optional()
 });
 var MeStatsResponseSchema = exports_external.object({
   user_id: exports_external.string(),
@@ -14521,6 +14524,7 @@ var MeStatsResponseSchema = exports_external.object({
   cap_usd_today: exports_external.number(),
   spent_usd_today: exports_external.number(),
   remaining_usd_today: exports_external.number(),
+  credit_usd: exports_external.number(),
   request_count_today: exports_external.number(),
   prompt_tokens_today: exports_external.number(),
   completion_tokens_today: exports_external.number(),
@@ -14915,6 +14919,12 @@ function inferErrorFromRemainingBudget(remainingUsdToday) {
 
 // ../pi-ads/src/meter.ts
 var METER_WIDGET_ID = "freepi-meter";
+var CONFIRM_TURNS = 3;
+var lastCreditUsd;
+var confirm;
+function creditAddedMessage(addedUsd) {
+  return `Payment received — $${addedUsd.toFixed(2)} of usage added to your balance.`;
+}
 async function renderMeter(deps, ctx) {
   const me = await fetchMe(deps);
   if (!me) {
@@ -14922,6 +14932,22 @@ async function renderMeter(deps, ctx) {
     return;
   }
   const theme = ctx.ui.theme;
+  const credit = typeof me.credit_usd === "number" ? me.credit_usd : undefined;
+  const added = credit !== undefined && lastCreditUsd !== undefined ? credit - lastCreditUsd : 0;
+  lastCreditUsd = credit;
+  if (added > 0)
+    confirm = { addedUsd: added, turnsLeft: CONFIRM_TURNS };
+  if (confirm && confirm.turnsLeft > 0) {
+    confirm.turnsLeft--;
+    ctx.ui.setWidget(METER_WIDGET_ID, [renderErrorLine(creditAddedMessage(confirm.addedUsd), theme)]);
+    return;
+  }
+  confirm = undefined;
+  const notice = typeof me.notice === "string" ? sanitizeText(me.notice).trim() : "";
+  if (notice !== "") {
+    ctx.ui.setWidget(METER_WIDGET_ID, [renderErrorLine(notice, theme)]);
+    return;
+  }
   const errorCode = inferErrorFromRemainingBudget(me.remaining_usd_today);
   if (errorCode === undefined) {
     ctx.ui.setWidget(METER_WIDGET_ID, undefined);
@@ -19261,15 +19287,38 @@ __export(exports_typebox, {
 // src/usage-tool.ts
 var USAGE_TOOL_NAME = "free_pi_usage";
 var PARAMS = exports_typebox.Object({});
+function percentUsed(spentUsd, capUsd) {
+  if (!(capUsd > 0))
+    return 100;
+  return Math.min(100, Math.max(0, Math.round(spentUsd / capUsd * 100)));
+}
 function formatStats(stats) {
+  const credit = stats.credit_usd;
   return [
-    `tier: ${stats.tier} (cap $${stats.cap_usd_today.toFixed(2)}/day)`,
-    `today: spent $${stats.spent_usd_today.toFixed(4)}, remaining $${stats.remaining_usd_today.toFixed(4)}, ${stats.request_count_today} request(s)`,
+    `tier: ${stats.tier}`,
+    `today: ${percentUsed(stats.spent_usd_today, stats.cap_usd_today)}% of your free daily allowance used, ${stats.request_count_today} request(s)`,
+    ...typeof credit === "number" ? [`credit: $${credit.toFixed(2)} purchased usage remaining`] : [],
     `today tokens: ${stats.prompt_tokens_today} prompt / ${stats.completion_tokens_today} completion`,
-    `lifetime: spent $${stats.lifetime.spent_usd.toFixed(4)}, ${stats.lifetime.request_count} request(s), ${stats.lifetime.prompt_tokens} prompt / ${stats.lifetime.completion_tokens} completion tokens`
+    `lifetime: ${stats.lifetime.request_count} request(s), ${stats.lifetime.prompt_tokens} prompt / ${stats.lifetime.completion_tokens} completion tokens`
   ].join(`
 `);
 }
+async function fetchUsageText(opts) {
+  try {
+    const token = await opts.getToken();
+    const doFetch = opts.fetchImpl ?? fetch;
+    const res = await doFetch(`${opts.baseUrl}/me/stats`, {
+      headers: { Authorization: `Bearer ${token}` },
+      signal: AbortSignal.timeout(5000)
+    });
+    if (!res.ok)
+      return { ok: false, text: `Could not fetch usage (HTTP ${res.status}).` };
+    const stats = await res.json();
+    return { ok: true, text: formatStats(stats), stats };
+  } catch (err) {
+    return { ok: false, text: `Could not fetch usage: ${String(err)}` };
+  }
+}
 function createUsageToolExtension(opts) {
   return {
     name: "free-pi-usage-tool",
@@ -19277,40 +19326,121 @@ function createUsageToolExtension(opts) {
       pi.registerTool({
         name: USAGE_TOOL_NAME,
         label: "My Usage",
-        description: "Reports the caller's own free-pi spend, remaining daily budget, token counts, and account tier. Read-only, takes no arguments, makes no changes.",
-        promptSnippet: "Check your own free-pi usage, spend, and remaining daily budget",
+        description: "Reports how much of the caller's free daily allowance is used (as a percentage), purchased credit, token counts, and account tier. Read-only, takes no arguments, makes no changes.",
+        promptSnippet: "Check your own free-pi usage and remaining daily allowance",
         parameters: PARAMS,
         async execute() {
-          try {
-            const token = await opts.getToken();
-            const doFetch = opts.fetchImpl ?? fetch;
-            const res = await doFetch(`${opts.baseUrl}/me/stats`, {
-              headers: { Authorization: `Bearer ${token}` },
-              signal: AbortSignal.timeout(5000)
-            });
-            if (!res.ok) {
-              return {
-                content: [{ type: "text", text: `Could not fetch usage (HTTP ${res.status}).` }],
-                details: { ok: false }
-              };
-            }
-            const stats = await res.json();
-            return {
-              content: [{ type: "text", text: formatStats(stats) }],
-              details: stats
-            };
-          } catch (err) {
+          const r = await fetchUsageText(opts);
+          return {
+            content: [{ type: "text", text: r.text }],
+            details: r.ok ? r.stats : { ok: false }
+          };
+        }
+      });
+    }
+  };
+}
+
+// src/buy-tool.ts
+async function resolveBuyPage(opts) {
+  try {
+    const token = await opts.getToken();
+    const doFetch = opts.fetchImpl ?? fetch;
+    const res = await doFetch(`${opts.baseUrl}/me`, {
+      headers: { Authorization: `Bearer ${token}` },
+      signal: AbortSignal.timeout(5000)
+    });
+    if (!res.ok)
+      return { kind: "error", text: `Could not fetch the buy page (HTTP ${res.status}).` };
+    const me = await res.json();
+    return me.buy_url ? { kind: "url", url: me.buy_url } : { kind: "unavailable" };
+  } catch (err) {
+    return { kind: "error", text: `Could not fetch the buy page: ${String(err)}` };
+  }
+}
+var BUY_NOT_AVAILABLE_TEXT = "Buying credits is not available on this server yet.";
+function buyPageText(url2) {
+  return `Opening the buy page in your browser. If it did not open (for example over SSH), visit:
+${url2}
+
+Packs: $5 → $4.00 of usage, $10 → $8.00. Card or USDC.`;
+}
+var BUY_TOOL_NAME = "free_pi_buy_credits";
+var PARAMS2 = exports_typebox.Object({});
+function createBuyToolExtension(opts) {
+  return {
+    name: "free-pi-buy-tool",
+    factory(pi) {
+      pi.registerTool({
+        name: BUY_TOOL_NAME,
+        label: "Buy Credits",
+        description: "Opens the free-pi buy-credits page in your browser (and prints the URL, for SSH sessions with no browser). Read-only against the server, takes no arguments.",
+        promptSnippet: "Buy more free-pi credits",
+        parameters: PARAMS2,
+        async execute() {
+          const page = await resolveBuyPage(opts);
+          if (page.kind === "error") {
+            return { content: [{ type: "text", text: page.text }], details: { ok: false } };
+          }
+          if (page.kind === "unavailable") {
             return {
-              content: [{ type: "text", text: `Could not fetch usage: ${String(err)}` }],
-              details: { ok: false }
+              content: [{ type: "text", text: BUY_NOT_AVAILABLE_TEXT }],
+              details: { available: false }
             };
           }
+          (opts.openBrowserImpl ?? openBrowser)(page.url);
+          return {
+            content: [{ type: "text", text: buyPageText(page.url) }],
+            details: { buy_url: page.url }
+          };
         }
       });
     }
   };
 }
 
+// src/error-notice.ts
+var NOTICE_DEDUPE_MS = 15000;
+function parseErrorEnvelope(errorMessage) {
+  if (typeof errorMessage !== "string")
+    return;
+  const m = /^(\d{3}): (\{[\s\S]*\})\s*$/.exec(errorMessage);
+  if (!m)
+    return;
+  try {
+    const body = JSON.parse(m[2]);
+    const message = body.message ?? body.error?.message;
+    const code = body.code ?? body.error?.code;
+    if (typeof message !== "string" || message.trim() === "")
+      return;
+    return { status: Number(m[1]), code: typeof code === "string" ? code : "unknown", message };
+  } catch {
+    return;
+  }
+}
+function createErrorNoticeExtension(opts = {}) {
+  const lastAt = new Map;
+  const now = opts.now ?? Date.now;
+  return {
+    name: "free-pi-error-notice",
+    factory(pi) {
+      pi.on("turn_end", (event, ctx) => {
+        const msg = event.message;
+        if (!msg || msg.stopReason !== "error")
+          return;
+        const env = parseErrorEnvelope(msg.errorMessage);
+        if (!env)
+          return;
+        const t = now();
+        if (t - (lastAt.get(env.code) ?? -Infinity) < NOTICE_DEDUPE_MS)
+          return;
+        lastAt.set(env.code, t);
+        ctx.ui.notify(env.message, env.status >= 500 ? "error" : "warning");
+      });
+    }
+  };
+}
+
 // src/tool-guard.ts
 async function reportToolGuardTrigger(opts, toolName) {
   try {
@@ -19340,6 +19470,21 @@ function createToolGuardExtension(opts) {
 
 // src/changelog.ts
 var CHANGELOG_HIGHLIGHTS = [
+  {
+    version: "0.2.12",
+    highlights: [
+      "New: /buy-credits and /usage slash commands — work instantly, even when you are out of usage.",
+      "Free usage is shown as a percentage, never a dollar figure; purchased credit stays in dollars.",
+      "Clearer messages: one readable line when a request is rejected, a heads-up at 80% of your daily allowance, and a confirmation when a purchase lands."
+    ]
+  },
+  {
+    version: "0.2.11",
+    highlights: [
+      'Out of free usage? You can now buy more — $5 or $10 packs, card or USDC. Ask pi to "buy credits" or follow the link in the out-of-usage notice.',
+      "The out-of-usage notice now comes from the server, and `free_pi_usage` shows your purchased balance."
+    ]
+  },
   {
     version: "0.2.10",
     highlights: [
@@ -19451,6 +19596,19 @@ async function runUpdate(ctx, deps = {}) {
     ctx.ui.notify("Update failed. Try manually: npm install -g free-pi-cli@latest", "error");
   }
 }
+async function buyCredits(opts, ctx) {
+  const page = await resolveBuyPage(opts);
+  if (page.kind === "error")
+    return ctx.ui.notify(page.text, "error");
+  if (page.kind === "unavailable")
+    return ctx.ui.notify(BUY_NOT_AVAILABLE_TEXT, "info");
+  (opts.openBrowserImpl ?? openBrowser)(page.url);
+  ctx.ui.notify(buyPageText(page.url), "info");
+}
+async function showUsage(opts, ctx) {
+  const r = await fetchUsageText(opts);
+  ctx.ui.notify(r.text, r.ok ? "info" : "error");
+}
 function createFreePiCommandsExtension(opts) {
   return {
     name: "free-pi-commands",
@@ -19467,6 +19625,14 @@ function createFreePiCommandsExtension(opts) {
         description: "Update free-pi-cli to the latest version.",
         handler: (_args, ctx) => runUpdate(ctx)
       });
+      pi.registerCommand("usage", {
+        description: "Show how much of today's free allowance you have used, and your purchased credit.",
+        handler: (_args, ctx) => showUsage(opts, ctx)
+      });
+      pi.registerCommand("buy-credits", {
+        description: "Buy more usage ($5 or $10 packs, card or USDC) — opens the buy page.",
+        handler: (_args, ctx) => buyCredits(opts, ctx)
+      });
     }
   };
 }
@@ -19491,7 +19657,7 @@ function catalogModelsFor(opts) {
   const id = opts.model || MODEL_ID;
   return [{ id, name: id }];
 }
-var ALLOWED_TOOL_NAMES = [...SAFE_TOOLS, USAGE_TOOL_NAME];
+var ALLOWED_TOOL_NAMES = [...SAFE_TOOLS, USAGE_TOOL_NAME, BUY_TOOL_NAME];
 function buildRuntimeOptions(opts, sessionId) {
   const models = catalogModelsFor(opts);
   const providerExtension = {
@@ -19509,6 +19675,11 @@ function buildRuntimeOptions(opts, sessionId) {
     baseUrl: opts.baseUrl,
     getToken: () => opts.jwt
   });
+  const buyToolExtension = createBuyToolExtension({
+    baseUrl: opts.baseUrl,
+    getToken: () => opts.jwt
+  });
+  const errorNoticeExtension = createErrorNoticeExtension();
   const toolGuardExtension = createToolGuardExtension({
     baseUrl: opts.baseUrl,
     getToken: () => opts.jwt,
@@ -19522,6 +19693,8 @@ function buildRuntimeOptions(opts, sessionId) {
     providerExtension,
     adsExtension,
     usageToolExtension,
+    buyToolExtension,
+    errorNoticeExtension,
     toolGuardExtension,
     commandsExtension
   ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-pi-cli",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "description": "Free, ad-supported distribution of the pi coding agent. Inference paid for by ads.",
   "license": "MIT",
   "type": "module",