@tempoxyz/patron 0.0.26 → 0.0.28

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-IMQMGXBT.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-IMQMGXBT.js");
   await runPayProcess().catch(() => void 0);
   process.exit(0);
 } else {
-  const { run } = await import("./chunks/-WOZ4DM2Y.js");
+  const { run } = await import("./chunks/-5Q7V7W7W.js");
   process.exitCode = await run(process.argv.slice(2));
 }

package/dist/chunks/{-WOZ4DM2Y.js → -5Q7V7W7W.js}

@@ -3,8 +3,6 @@ const require = __patronCreateRequire(import.meta.url)
 import {
   FileTokenStore,
   LINK_TOKEN_STEP,
-  LeaderboardResponse,
-  PatronInfo,
   STARTER_TOKENS,
   budgetTokens,
   buyTokens,
@@ -17,7 +15,6 @@ import {
   loadIssuer,
   needsRefill,
   parseUsd,
-  profileMessage,
   purchasableTokens,
   readJsonObject,
   redeem,
@@ -29,26 +26,20 @@ import {
   withPatronStatus,
   withoutPatronHandlers,
   writeJsonObject
-} from "./chunk-NQ6RRPM6.js";
+} from "./chunk-EKFENOVR.js";
 import {
   startRefill
 } from "./chunk-TV5VLFTD.js";
 import {
-  DEFAULT_MONTHLY_BUDGET_USD,
-  MAX_TOKENS_PER_PAGE,
-  MIN_TOKENS_PER_PAGE,
-  PACK_SIZE,
-  TOKEN_PRICE_UNITS,
-  clampTokensPerPage,
-  formatUsd,
-  normalizePayee,
   resolveSettings,
-  settingsFor,
-  tokensToUnits
-} from "./chunk-WZRGCKEK.js";
+  settingsFor
+} from "./chunk-OQXACACU.js";
 import {
   AGENT_IDS,
+  LeaderboardResponse,
+  PatronInfo,
   ensureHome,
+  profileMessage,
   readConfig,
   readJson,
   readUsage,
@@ -56,11 +47,20 @@ import {
   updateUsage,
   writeConfig,
   writePrivateFile
-} from "./chunk-SGQ525FB.js";
+} from "./chunk-EV7OA6GK.js";
 import {
+  DEFAULT_MONTHLY_BUDGET_USD,
+  MAX_TOKENS_PER_PAGE,
+  MIN_TOKENS_PER_PAGE,
+  PACK_SIZE,
+  TOKEN_PRICE_UNITS,
+  clampTokensPerPage,
+  formatUsd,
+  normalizePayee,
+  tokensToUnits,
   tryLock,
   withLock
-} from "./chunk-O64T22EK.js";
+} from "./chunk-EISHX7Q3.js";
 import "./chunk-GTMLTZRN.js";
 
 // src/index.ts
@@ -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-6TDMXRWW.js");
     return openLinkWallet(config, maxUnits);
   }
-  const { openWallet } = await import("./wallet-IDSQUCB5.js");
+  const { openWallet } = await import("./wallet-6TDMXRWW.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
@@ -864,6 +861,19 @@ function defaults() {
     stdout: process.stdout
   };
 }
+var REFRESHES_STABLE_COPY = /* @__PURE__ */ new Set([
+  "status",
+  "pause",
+  "resume",
+  "budget",
+  "per-page",
+  "tip",
+  "name"
+]);
+async function refreshStableCli(deps) {
+  const config = await readConfig(deps.settings.home).catch(() => void 0);
+  if (config) await installStableCli(deps.settings.home).catch(() => void 0);
+}
 async function run(argv, overrides = {}) {
   const base = { ...defaults(), ...overrides };
   let shared;
@@ -876,6 +886,8 @@ async function run(argv, overrides = {}) {
   };
   const [command, ...args] = argv;
   try {
+    if (command !== void 0 && REFRESHES_STABLE_COPY.has(command))
+      await refreshStableCli(deps);
     switch (command) {
       case void 0:
         await main(deps);
@@ -1022,9 +1034,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 +1084,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-6TDMXRWW.js");
   const account = await signIn(deps.settings, {
     budgetUnits,
     issuer,
@@ -1083,7 +1095,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(
@@ -1184,9 +1196,9 @@ async function changeBudget(deps, input) {
     if (budget === void 0 || budget < 1e-3)
       throw new UsageError("Usage: patron budget <usd>, such as patron budget 10");
   } else budget = await askBudget(deps, config.monthlyBudgetUsd);
-  if (config.wallet === "tempo" && budget > 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-6TDMXRWW.js");
     const issuer = await loadIssuer(settings.home, settings.gatewayUrl, {
       fetch: deps.fetch
     });
@@ -1240,8 +1252,9 @@ 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)})`);
-    await buyWithinBudget(settings, config, missing, deps.openWallet);
+    const amount2 = Math.max(missing, purchasableTokens(config, usage, PACK_SIZE));
+    step(deps, `Adding ${tokensUsd(amount2)} to your balance`);
+    await buyWithinBudget(settings, config, amount2, deps.openWallet);
   }
   const issuer = await loadIssuer(settings.home, settings.gatewayUrl, {
     fetch: deps.fetch
@@ -1275,16 +1288,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 +1316,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-6TDMXRWW.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 +1339,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-WZRGCKEK.js → chunk-EISHX7Q3.js}

@@ -797,6 +797,10 @@ var TOKEN_PRICE_UNITS = 1000n;
 var PACK_SIZE = 1e3;
 var MAX_TOKENS_PER_PURCHASE = 5e3;
 var DEFAULT_MONTHLY_BUDGET_USD = 5;
+function accessKeyLimitUnits(budgetUnits) {
+  if (budgetUnits <= 0n) return 0n;
+  return budgetUnits + 50000n + budgetUnits / 100n;
+}
 var MIN_TOKENS_PER_PAGE = 1;
 var MAX_TOKENS_PER_PAGE = 10;
 var DEFAULT_TOKENS_PER_PAGE = 1;
@@ -956,36 +960,6 @@ function normalizePayee(input) {
   return normalizeDomain(trimmed);
 }
 
-// src/settings.ts
-import { homedir } from "node:os";
-import { join } from "node:path";
-var DEFAULT_GATEWAY_URL = "https://patron-gateway.tempo-dev.workers.dev";
-var DEFAULT_RELAY_URL = "https://patron-relay.tempo-dev.workers.dev";
-function resolveSettings(env = process.env) {
-  const key = env.PATRON_PRIVATE_KEY?.trim();
-  const privateKey = key && /^0x[0-9a-fA-F]{64}$/.test(key) ? key : void 0;
-  return {
-    gatewayUrl: env.PATRON_GATEWAY_URL || DEFAULT_GATEWAY_URL,
-    home: env.PATRON_HOME || join(homedir(), ".patron"),
-    network: env.PATRON_NETWORK === "testnet" ? "testnet" : "mainnet",
-    overridden: {
-      gatewayUrl: Boolean(env.PATRON_GATEWAY_URL),
-      network: Boolean(env.PATRON_NETWORK),
-      relayUrl: Boolean(env.PATRON_RELAY_URL)
-    },
-    relayUrl: env.PATRON_RELAY_URL || DEFAULT_RELAY_URL,
-    ...privateKey ? { privateKey } : {}
-  };
-}
-function settingsFor(settings, saved) {
-  return {
-    ...settings,
-    gatewayUrl: settings.overridden.gatewayUrl || !saved.gatewayUrl ? settings.gatewayUrl : saved.gatewayUrl,
-    network: settings.overridden.network ? settings.network : saved.network,
-    relayUrl: settings.overridden.relayUrl || !saved.relayUrl ? settings.relayUrl : saved.relayUrl
-  };
-}
-
 // ../protocol/src/encoding.ts
 function toBase64Url(bytes) {
   let binary = "";
@@ -1190,11 +1164,59 @@ function tokensToUnits(tokens) {
   return BigInt(tokens) * TOKEN_PRICE_UNITS;
 }
 
+// src/lock.ts
+import { open, rm, stat } from "node:fs/promises";
+async function withLock(path, fn, options = {}) {
+  const deadline = Date.now() + (options.timeoutMs ?? 3e3);
+  const staleMs = options.staleMs ?? 1e4;
+  for (; ; ) {
+    try {
+      const handle = await open(path, "wx", 384);
+      await handle.close();
+      break;
+    } catch (error) {
+      if (error.code !== "EEXIST") throw error;
+      const age = await stat(path).then(
+        (stats) => Date.now() - stats.mtimeMs,
+        () => 0
+      );
+      if (age > staleMs) {
+        await rm(path, { force: true });
+        continue;
+      }
+      if (Date.now() > deadline) throw new Error(`Patron state is busy: ${path}`);
+      await new Promise((resolve) => setTimeout(resolve, 10 + Math.random() * 20));
+    }
+  }
+  try {
+    return await fn();
+  } finally {
+    await rm(path, { force: true });
+  }
+}
+async function tryLock(path, staleMs) {
+  try {
+    const handle = await open(path, "wx", 384);
+    await handle.close();
+  } catch (error) {
+    if (error.code !== "EEXIST") throw error;
+    const age = await stat(path).then(
+      (stats) => Date.now() - stats.mtimeMs,
+      () => 0
+    );
+    if (age <= staleMs) return void 0;
+    await rm(path, { force: true });
+    return tryLock(path, staleMs);
+  }
+  return () => rm(path, { force: true });
+}
+
 export {
   TOKEN_PRICE_UNITS,
   PACK_SIZE,
   MAX_TOKENS_PER_PURCHASE,
   DEFAULT_MONTHLY_BUDGET_USD,
+  accessKeyLimitUnits,
   MIN_TOKENS_PER_PAGE,
   MAX_TOKENS_PER_PAGE,
   clampTokensPerPage,
@@ -1206,6 +1228,6 @@ export {
   isExcludedByDefault,
   formatUsd,
   tokensToUnits,
-  resolveSettings,
-  settingsFor
+  withLock,
+  tryLock
 };