@tempoxyz/patron 0.0.26 → 0.0.27

package/README.md

@@ -6,13 +6,13 @@ Your AI agents pay every website they read: $0.001 a page, in OUSD on Tempo, pri
 npx @tempoxyz/patron
 ```
 
-First run signs you in with Tempo Wallet, asks for a monthly budget (default $5), buys
-seals and adds a hook to every supported agent it finds. After that, every page an agent
-reads pays its site one seal. Nothing stays running: the hook hands each read to a one-shot
-background payment and exits at once, so the agent never waits, and when seals run low it
+First run signs you in with Tempo Wallet, asks for a monthly budget (default $5), adds
+funds to your Patron balance and adds a hook to every supported agent it finds. After that, every page an agent
+reads pays its site $0.001. Nothing stays running: the hook hands each read to a one-shot
+background payment and exits at once, so the agent never waits, and when your balance runs low it
 starts a one-shot purchase that exits when done.
 
-Run `npx @tempoxyz/patron` again for status (seals left, pages paid, budget used, rank) and to pause,
+Run `npx @tempoxyz/patron` again for status (balance, pages paid, tips, budget used, rank) and to pause,
 change the budget or uninstall.
 
 ## Commands
@@ -20,7 +20,7 @@ change the budget or uninstall.
 | Command | What it does |
 | :- | :- |
 | `patron` | Set up, or show status and options |
-| `patron status` | Seals left, pages paid this month, budget used, leaderboard rank |
+| `patron status` | Balance, pages paid and tips this month, budget used, leaderboard rank |
 | `patron pause` / `patron resume` | Stop or restart paying |
 | `patron budget <usd>` | Change the monthly budget |
 | `patron tip <url> [usd]` | Tip a site, $0.10 by default |
@@ -34,7 +34,7 @@ change the budget or uninstall.
 - A fetched page pays its site only when it loads (a 2xx status). Error pages, blocks and
   redirect notices pay nothing.
 - A search pays each site in its results, up to 10 sites per search.
-- Each site's seals are redeemed at once, in separate relayed requests, never batched: the
+- Each site's payments are redeemed at once, in separate relayed requests, never batched: the
   gateway cannot tell which sites one reader read together.
 - Sites are paid per registrable domain: `docs.python.org` pays `python.org`. Authors on shared
   hosts are paid as their own site: `alice.github.io`, `app.vercel.app`, `alice.substack.com`.
@@ -44,19 +44,19 @@ change the budget or uninstall.
 
 ## Privacy
 
-Seals are Privacy Pass blind tokens (RFC 9578). The gateway knows your address bought a
-number of seals, but cannot link a seal to you when it is spent. Each read sends one seal
+Payments are Privacy Pass blind tokens (RFC 9578). The gateway knows how much your address
+added to its balance, but cannot link a payment to you when it is spent. Each read sends one payment
 and the site's domain through an Oblivious HTTP relay (RFC 9458): the relay sees your IP but
 not the content; the gateway sees the content but not your IP.
 
-Local state lives in `~/.patron`: settings, seals encrypted with AES-256-GCM under a key
+Local state lives in `~/.patron`: settings, your balance's blind tokens encrypted with AES-256-GCM under a key
 file readable only by you, this month's per-site counts, which never leave the machine, and
 a copy of the CLI in `~/.patron/cli` that agent hooks start with node, so a read never waits
 on npx. Running `npx @tempoxyz/patron` updates the copy.
 
 ## Budget
 
-The budget caps purchases: Patron never buys more than the monthly budget's worth of seals
+The budget caps purchases: Patron never buys more than the monthly budget
 in a calendar month. With Tempo Wallet, the access key Patron holds also has a spending
 limit equal to the budget, renewed every 30 days.
 

package/dist/bin.js

@@ -4,14 +4,14 @@ const require = __patronCreateRequire(import.meta.url)
 
 // src/bin.ts
 if (process.argv[2] === "hook") {
-  const { runHookProcess } = await import("./chunks/hook-process-ZPEWRFL2.js");
+  const { runHookProcess } = await import("./chunks/hook-process-QQPBFRY6.js");
   await runHookProcess().catch(() => void 0);
   process.exit(0);
 } else if (process.argv[2] === "pay") {
-  const { runPayProcess } = await import("./chunks/hook-process-ZPEWRFL2.js");
+  const { runPayProcess } = await import("./chunks/hook-process-QQPBFRY6.js");
   await runPayProcess().catch(() => void 0);
   process.exit(0);
 } else {
-  const { run } = await import("./chunks/-WOZ4DM2Y.js");
+  const { run } = await import("./chunks/-PBBSDRMM.js");
   process.exitCode = await run(process.argv.slice(2));
 }

package/dist/chunks/{-WOZ4DM2Y.js → -PBBSDRMM.js}

@@ -29,7 +29,7 @@ import {
   withPatronStatus,
   withoutPatronHandlers,
   writeJsonObject
-} from "./chunk-NQ6RRPM6.js";
+} from "./chunk-F5CY5O7O.js";
 import {
   startRefill
 } from "./chunk-TV5VLFTD.js";
@@ -56,7 +56,7 @@ import {
   updateUsage,
   writeConfig,
   writePrivateFile
-} from "./chunk-SGQ525FB.js";
+} from "./chunk-MZJEM2SE.js";
 import {
   tryLock,
   withLock
@@ -700,10 +700,10 @@ async function linkRefillFailedAt(home) {
 var REFILL_LOCK_STALE_MS = 5 * 60 * 1e3;
 var defaultOpenWallet = async (settings, config, issuer, maxUnits) => {
   if (config.wallet === "link") {
-    const { openLinkWallet } = await import("./wallet-IDSQUCB5.js");
+    const { openLinkWallet } = await import("./wallet-OJP2JREM.js");
     return openLinkWallet(config, maxUnits);
   }
-  const { openWallet } = await import("./wallet-IDSQUCB5.js");
+  const { openWallet } = await import("./wallet-OJP2JREM.js");
   return openWallet(settings, config.wallet, issuer, maxUnits);
 };
 async function buyWithinBudget(settings, config, wanted, openWallet = defaultOpenWallet) {
@@ -778,17 +778,14 @@ function formatStatus(view, color) {
   const top = Object.entries(usage.domains).sort(([, left], [, right]) => right - left).slice(0, 3).map(([domain, count]) => `${domain} ${count}`);
   const lines = [
     `${styleText("Patron", "bold", color)}  ${state}${network}`,
-    row(
-      "Seals left",
-      `${tokensLeft.toLocaleString("en-US")} (${tokensUsd(tokensLeft)})`,
-      color
-    ),
+    row("Balance", `${tokensUsd(tokensLeft)} left`, color),
     row(
       "Per page",
       `$${(clampTokensPerPage(config.tokensPerPage) / 1e3).toFixed(3)}`,
       color
     ),
     row("Pages paid", `${usage.paidPages.toLocaleString("en-US")} this month`, color),
+    row("Tipped", `${tokensUsd(usage.tippedTokens)} this month`, color),
     row(
       "Budget used",
       `${bought} of ${budget} this month (${budgetTokens(config.monthlyBudgetUsd) > 0 ? Math.min(100, Math.round(usage.boughtTokens / budgetTokens(config.monthlyBudgetUsd) * 100)) : 0}%)`,
@@ -796,7 +793,7 @@ function formatStatus(view, color) {
     ),
     row(
       "Rank",
-      standing?.rank ? `#${standing.rank} \xB7 ${standing.tokens.toLocaleString("en-US")} seals bought` : styleText("not ranked yet", "dim", color),
+      standing?.rank ? `#${standing.rank} \xB7 ${tokensUsd(standing.tokens)} added` : styleText("not ranked yet", "dim", color),
       color
     ),
     row(
@@ -835,7 +832,7 @@ var HELP = `patron@${VERSION} \u2014 pay the websites your agents read, privatel
 Usage: patron [command]
 
   (none)            Set up, or show status and options
-  status            Seals left, pages paid, budget and rank
+  status            Balance, pages paid, tips, budget and rank
   pause | resume    Stop or restart paying
   budget <usd>      Change the monthly budget
   per-page <usd>    What each site gets per page read, $0.001 to $0.01
@@ -1022,9 +1019,9 @@ async function setup(deps) {
   await writeConfig(settings.home, config);
   const starter = config.wallet === "link" ? PACK_SIZE : STARTER_TOKENS;
   const first = purchasableTokens(config, await readUsage(settings.home), starter);
-  step(deps, `Buying ${first.toLocaleString("en-US")} seals (${tokensUsd(first)})`);
+  step(deps, `Adding ${tokensUsd(first)} to your balance`);
   const bought = await buyWithinBudget(settings, config, starter, deps.openWallet);
-  done(deps, `${bought.toLocaleString("en-US")} seals ready`);
+  done(deps, `${tokensUsd(bought)} ready to pay sites`);
   deps.startRefill();
   await installStableCli(settings.home).catch(() => void 0);
   const agents = await detectAgents(deps.agents);
@@ -1072,7 +1069,7 @@ async function tempoSignIn(deps, budgetUnits, issuer) {
     deps,
     deps.settings.privateKey ? "Using PATRON_PRIVATE_KEY" : "Signing in with Tempo Wallet"
   );
-  const { signIn } = await import("./wallet-IDSQUCB5.js");
+  const { signIn } = await import("./wallet-OJP2JREM.js");
   const account = await signIn(deps.settings, {
     budgetUnits,
     issuer,
@@ -1083,7 +1080,7 @@ async function tempoSignIn(deps, budgetUnits, issuer) {
 }
 async function linkSignIn(deps) {
   step(deps, "Checking your Link wallet (link-cli)");
-  const { linkBalance, linkCli, linkPaymentMethods } = await import("./link-OU7W7IT6.js");
+  const { linkBalance, linkCli, linkPaymentMethods } = await import("./link-VK7VCE2R.js");
   const cli = deps.linkCli ?? linkCli();
   const methods = await linkPaymentMethods(cli).catch((error) => {
     throw new Error(
@@ -1186,7 +1183,7 @@ async function changeBudget(deps, input) {
   } else budget = await askBudget(deps, config.monthlyBudgetUsd);
   if (config.wallet === "tempo" && budget > config.monthlyBudgetUsd) {
     step(deps, "Approve the new spending limit in Tempo Wallet");
-    const { authorizeBudget } = await import("./wallet-IDSQUCB5.js");
+    const { authorizeBudget } = await import("./wallet-OJP2JREM.js");
     const issuer = await loadIssuer(settings.home, settings.gatewayUrl, {
       fetch: deps.fetch
     });
@@ -1240,7 +1237,7 @@ async function tip(deps, url, amount = "0.10") {
       throw new Error(
         `This tip needs ${tokensUsd(missing)} more than this month's budget allows. Raise it with patron budget <usd>.`
       );
-    step(deps, `Buying ${missing.toLocaleString("en-US")} seals (${tokensUsd(missing)})`);
+    step(deps, `Adding ${tokensUsd(missing)} to your balance`);
     await buyWithinBudget(settings, config, missing, deps.openWallet);
   }
   const issuer = await loadIssuer(settings.home, settings.gatewayUrl, {
@@ -1275,16 +1272,17 @@ async function tip(deps, url, amount = "0.10") {
   if (paid > 0)
     await updateUsage(settings.home, (usage) => {
       usage.domains[domain] = (usage.domains[domain] ?? 0) + paid;
+      usage.tippedTokens += paid;
     });
   if (paid === 0)
     throw new Error(
-      rejection ? `Patron rejected the tip to ${domain}: ${rejection}.` : `Could not reach Patron to tip ${domain}; your seals were kept.`
+      rejection ? `Patron rejected the tip to ${domain}: ${rejection}.` : `Could not reach Patron to tip ${domain}; your balance was kept.`
     );
   if (paid < count)
     say(
       deps,
       styleText(
-        `  ${count - paid} of ${count} seals did not go through.`,
+        `  ${tokensUsd(count - paid)} of ${tokensUsd(count)} did not go through.`,
         "yellow",
         deps.color
       )
@@ -1302,7 +1300,7 @@ async function setName(deps, name) {
   const issuer = await loadIssuer(settings.home, settings.gatewayUrl, {
     fetch: deps.fetch
   });
-  const open = deps.openWallet ?? (async (s, c, i, max) => (await import("./wallet-IDSQUCB5.js")).openWallet(s, c.wallet, i, max));
+  const open = deps.openWallet ?? (async (s, c, i, max) => (await import("./wallet-OJP2JREM.js")).openWallet(s, c.wallet, i, max));
   const wallet = await open(settings, config, issuer, 0n);
   await setProfile(settings.gatewayUrl, wallet, name, deps.fetch);
   await writeConfig(settings.home, { ...config, name });
@@ -1325,7 +1323,7 @@ async function uninstall(deps) {
     const prompter = deps.prompter();
     try {
       purge = await prompter.confirm(
-        `Also delete ${deps.settings.home}${tokensLeft > 0 ? ` and ${tokensLeft} unspent seals (${tokensUsd(tokensLeft)})` : ""}?`,
+        `Also delete ${deps.settings.home}${tokensLeft > 0 ? ` and your unspent balance of ${tokensUsd(tokensLeft)}` : ""}?`,
         false
       );
     } finally {

package/dist/chunks/{chunk-NQ6RRPM6.js → chunk-F5CY5O7O.js}

@@ -14,7 +14,7 @@ import {
   readJson,
   statePaths,
   writePrivateFile
-} from "./chunk-SGQ525FB.js";
+} from "./chunk-MZJEM2SE.js";
 import {
   withLock
 } from "./chunk-O64T22EK.js";

package/dist/chunks/{chunk-SGQ525FB.js → chunk-MZJEM2SE.js}

@@ -110,7 +110,7 @@ async function writeConfig(home, config) {
   );
 }
 function emptyUsage(month) {
-  return { boughtTokens: 0, domains: {}, month, paidPages: 0 };
+  return { boughtTokens: 0, domains: {}, month, paidPages: 0, tippedTokens: 0 };
 }
 async function readUsage(home, now = /* @__PURE__ */ new Date()) {
   const month = monthOf(now);
@@ -125,7 +125,8 @@ async function readUsage(home, now = /* @__PURE__ */ new Date()) {
     boughtTokens: value.boughtTokens,
     domains: value.domains && typeof value.domains === "object" ? { ...value.domains } : {},
     month,
-    paidPages: Number(value.paidPages ?? 0)
+    paidPages: Number(value.paidPages ?? 0),
+    tippedTokens: Number(value.tippedTokens ?? 0)
   };
 }
 function isUsageRecord(value) {
@@ -135,7 +136,7 @@ function isUsageRecord(value) {
 }
 function unreadableUsage(path) {
   return new Error(
-    `${path} is unreadable, so Patron stops buying seals. Delete it to restart this month's budget count.`
+    `${path} is unreadable, so Patron stops adding to your balance. Delete it to restart this month's budget count.`
   );
 }
 async function updateUsage(home, update, now = /* @__PURE__ */ new Date()) {

package/dist/chunks/{hook-OZRD6I6F.js → hook-3CYJEB2M.js}

@@ -16,7 +16,7 @@ import {
   needsRefill,
   redeem,
   refillSize
-} from "./chunk-NQ6RRPM6.js";
+} from "./chunk-F5CY5O7O.js";
 import {
   clampTokensPerPage,
   settingsFor
@@ -26,7 +26,7 @@ import {
   readUsage,
   updateUsage,
   writePrivateFile
-} from "./chunk-SGQ525FB.js";
+} from "./chunk-MZJEM2SE.js";
 import {
   withLock
 } from "./chunk-O64T22EK.js";

package/dist/chunks/{hook-process-ZPEWRFL2.js → hook-process-QQPBFRY6.js}

@@ -202,7 +202,7 @@ async function runPayProcess() {
 }
 async function payEvent(event, settings, refill, timeoutMs) {
   if (timeoutMs <= 0) return;
-  const { runHook } = await import("./hook-OZRD6I6F.js");
+  const { runHook } = await import("./hook-3CYJEB2M.js");
   await runHook(
     {
       readInput: async () => event.raw,

package/dist/chunks/{link-OU7W7IT6.js → link-VK7VCE2R.js}

@@ -86,7 +86,7 @@ async function createLinkSpt(options) {
       "--currency",
       "usd",
       "--context",
-      `Patron: buying $${usd} of seals (1,000 per dollar) that pay the websites your AI agents and browser read, $0.001 per page, privately. Started by npx @tempoxyz/patron on this computer.`,
+      `Patron: adding $${usd} to the balance that pays the websites your AI agents and browser read, $0.001 per page, privately. Started by npx @tempoxyz/patron on this computer.`,
       "--idempotency-key",
       options.idempotencyKey,
       "--request-approval",

package/dist/chunks/{wallet-IDSQUCB5.js → wallet-OJP2JREM.js}

@@ -2,7 +2,7 @@ import { createRequire as __patronCreateRequire } from 'node:module'
 const require = __patronCreateRequire(import.meta.url)
 import {
   statePaths
-} from "./chunk-SGQ525FB.js";
+} from "./chunk-MZJEM2SE.js";
 import "./chunk-O64T22EK.js";
 import "./chunk-GTMLTZRN.js";
 
@@ -121,7 +121,7 @@ async function openWallet(settings, wallet, issuer, maxUnits, output = process.s
 }
 var UNITS_PER_CENT = 10000n;
 async function openLinkWallet(config, maxUnits, output = process.stderr) {
-  const { linkCli, linkFetch } = await import("./link-OU7W7IT6.js");
+  const { linkCli, linkFetch } = await import("./link-VK7VCE2R.js");
   return {
     address: "0x0000000000000000000000000000000000000000",
     fetch: linkFetch({

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tempoxyz/patron",
-	"version": "0.0.26",
+	"version": "0.0.27",
 	"description": "Pay the websites your AI agents read, privately",
 	"type": "module",
 	"bin": {