@tempoxyz/patron 0.0.1 → 0.0.11

package/README.md

@@ -7,11 +7,11 @@ npx @tempoxyz/patron
 ```
 
 First run signs you in with Tempo Wallet, asks for a monthly budget (default $5), buys
-tokens and adds a hook to Claude Code. After that, every page Claude Code fetches pays its
-site one token. Nothing stays running: the hook runs once per read and exits, and when
-tokens run low it starts a one-shot purchase that exits when done.
+seals and adds a hook to Claude Code. After that, every page Claude Code fetches pays its
+site one seal. Nothing stays running: the hook runs once per read and exits, and when
+seals run low it starts a one-shot purchase that exits when done.
 
-Run `npx @tempoxyz/patron` again for status (tokens left, pages paid, budget used, rank) and to pause,
+Run `npx @tempoxyz/patron` again for status (seals left, pages paid, budget used, rank) and to pause,
 change the budget or uninstall.
 
 ## Commands
@@ -19,7 +19,7 @@ change the budget or uninstall.
 | Command | What it does |
 | :- | :- |
 | `patron` | Set up, or show status and options |
-| `patron status` | Tokens left, pages paid this month, budget used, leaderboard rank |
+| `patron status` | Seals left, pages paid 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 |
@@ -29,17 +29,17 @@ change the budget or uninstall.
 
 ## Privacy
 
-Tokens are Privacy Pass blind tokens (RFC 9578). The gateway knows your address bought a
-number of tokens, but cannot link a token to you when it is spent. Each read sends one token
+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
 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, tokens encrypted with AES-256-GCM under a key
+Local state lives in `~/.patron`: settings, seals encrypted with AES-256-GCM under a key
 file readable only by you, and this month's per-site counts, which never leave the machine.
 
 ## Budget
 
-The budget caps purchases: Patron never buys more than the monthly budget's worth of tokens
+The budget caps purchases: Patron never buys more than the monthly budget's worth of seals
 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,10 +4,10 @@ const require = __patronCreateRequire(import.meta.url)
 
 // src/bin.ts
 if (process.argv[2] === "hook") {
-  const { runHookProcess } = await import("./chunks/hook-process-QQ34YQIA.js");
+  const { runHookProcess } = await import("./chunks/hook-process-SIOU4SZZ.js");
   await runHookProcess().catch(() => void 0);
   process.exit(0);
 } else {
-  const { run } = await import("./chunks/-MVQH5G3L.js");
+  const { run } = await import("./chunks/-E6NINF53.js");
   process.exitCode = await run(process.argv.slice(2));
 }

package/dist/chunks/{-MVQH5G3L.js → -E6NINF53.js}

@@ -22,7 +22,7 @@ import {
   isPatronHandler,
   loadIssuer,
   needsRefill,
-  normalizeDomain,
+  normalizePayee,
   parseUsd,
   profileMessage,
   purchasableTokens,
@@ -38,7 +38,7 @@ import {
   withPatronGroup,
   withoutPatronHandlers,
   writeJsonObject
-} from "./chunk-6Q7AFS33.js";
+} from "./chunk-G2PONYHX.js";
 import {
   AGENT_IDS,
   ensureHome,
@@ -51,7 +51,7 @@ import {
   withLock,
   writeConfig,
   writePrivateFile
-} from "./chunk-NLCZ2IHE.js";
+} from "./chunk-6TTNL3HT.js";
 
 // src/index.ts
 import { readFileSync } from "node:fs";
@@ -415,6 +415,45 @@ async function onPath(commands, path) {
   return false;
 }
 
+// src/terminal-style.ts
+var RESET = "\x1B[0m";
+var ANSI = {
+  bold: "\x1B[1m",
+  cyan: "\x1B[36m",
+  dim: "\x1B[2m",
+  green: "\x1B[32m",
+  purple: "\x1B[35m",
+  red: "\x1B[31m",
+  yellow: "\x1B[33m"
+};
+function supportsColor(output, requested = true) {
+  return requested && process.env.NO_COLOR === void 0 && process.env.TERM !== "dumb" && Boolean(output.isTTY);
+}
+function styleText(value, style, enabled) {
+  return enabled ? `${ANSI[style]}${value}${RESET}` : value;
+}
+
+// src/banner.ts
+function scrollBanner(version, color) {
+  const dim = (text) => styleText(text, "dim", color);
+  const bold = (text) => styleText(text, "bold", color);
+  const width = 30;
+  const line = (text, style = (value) => value) => `   ${dim("|")} ${style(text.padEnd(width - 2))} ${dim("|")}`;
+  return [
+    dim(`    ${"_".repeat(width)}`),
+    dim(`   /\\${" ".repeat(width)}\\`),
+    `  ${dim("(  )")}  ${bold("P A T R O N")}${" ".repeat(width - 14)}${dim(")")}`,
+    dim(`   \\/${"_".repeat(width - 1)}/`),
+    line("pay every page you read"),
+    line("$0.001+ a page, privately"),
+    line(`v${version}`, dim),
+    dim(`   |${"_".repeat(width)}|`),
+    dim(`   /\\${" ".repeat(width)}\\`),
+    dim(`  (  )${"_".repeat(width)})`),
+    dim("   \\/")
+  ].join("\n");
+}
+
 // src/gateway.ts
 var STANDING_TIMEOUT_MS = 3e3;
 function shortAddress(address) {
@@ -477,24 +516,6 @@ function openPromptInput() {
   }
 }
 
-// src/terminal-style.ts
-var RESET = "\x1B[0m";
-var ANSI = {
-  bold: "\x1B[1m",
-  cyan: "\x1B[36m",
-  dim: "\x1B[2m",
-  green: "\x1B[32m",
-  purple: "\x1B[35m",
-  red: "\x1B[31m",
-  yellow: "\x1B[33m"
-};
-function supportsColor(output, requested = true) {
-  return requested && process.env.NO_COLOR === void 0 && process.env.TERM !== "dumb" && Boolean(output.isTTY);
-}
-function styleText(value, style, enabled) {
-  return enabled ? `${ANSI[style]}${value}${RESET}` : value;
-}
-
 // src/prompts.ts
 function createPrompter(output = process.stdout, color = false, input) {
   const promptInput = input ? { close: () => void 0, input } : openPromptInput();
@@ -552,7 +573,7 @@ ${styleText(title, "bold", color)}
 // src/purchase.ts
 var REFILL_LOCK_STALE_MS = 5 * 60 * 1e3;
 var defaultOpenWallet = async (settings, config, issuer, maxUnits) => {
-  const { openWallet } = await import("./wallet-3AFTEAOI.js");
+  const { openWallet } = await import("./wallet-MEBNL43A.js");
   return openWallet(settings, config.wallet, issuer, maxUnits);
 };
 async function buyWithinBudget(settings, config, wanted, openWallet = defaultOpenWallet) {
@@ -616,7 +637,7 @@ function formatStatus(view, color) {
   const lines = [
     `${styleText("Patron", "bold", color)}  ${state}${network}`,
     row(
-      "Tokens left",
+      "Seals left",
       `${tokensLeft.toLocaleString("en-US")} (${tokensUsd(tokensLeft)})`,
       color
     ),
@@ -633,7 +654,7 @@ function formatStatus(view, color) {
     ),
     row(
       "Rank",
-      standing?.rank ? `#${standing.rank} \xB7 ${standing.tokens.toLocaleString("en-US")} tokens bought` : styleText("not ranked yet", "dim", color),
+      standing?.rank ? `#${standing.rank} \xB7 ${standing.tokens.toLocaleString("en-US")} seals bought` : styleText("not ranked yet", "dim", color),
       color
     ),
     row(
@@ -660,11 +681,11 @@ var HELP = `patron@${VERSION} \u2014 pay the websites your agents read, privatel
 Usage: patron [command]
 
   (none)            Set up, or show status and options
-  status            Tokens left, pages paid, budget and rank
+  status            Seals left, pages paid, 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
-  tip <url> [usd]   Tip a site (default $0.10)
+  tip <url> [usd]   Tip a site or @handle on X (default $0.10)
   name <handle>     Set your public leaderboard name
   uninstall         Remove agent hooks
   hook              Run by agents after each web read (reads the event JSON)
@@ -797,15 +818,7 @@ async function syncAgents(deps, config) {
 }
 async function setup(deps) {
   const settings = deps.settings;
-  say(deps, styleText(`Patron v${VERSION}`, "bold", deps.color));
-  say(
-    deps,
-    styleText(
-      "Pay every site your agents read, $0.001 a page, privately.",
-      "dim",
-      deps.color
-    )
-  );
+  say(deps, scrollBanner(VERSION, deps.color));
   say(deps);
   const issuer = await loadIssuer(settings.home, settings.gatewayUrl, {
     fetch: deps.fetch,
@@ -819,7 +832,7 @@ async function setup(deps) {
     deps,
     settings.privateKey ? "Using PATRON_PRIVATE_KEY" : "Signing in with Tempo Wallet"
   );
-  const { signIn } = await import("./wallet-3AFTEAOI.js");
+  const { signIn } = await import("./wallet-MEBNL43A.js");
   const account = await signIn(settings, { budgetUnits, issuer, output: deps.stdout });
   done(deps, `Signed in as ${account.address}`);
   const config = {
@@ -835,9 +848,9 @@ async function setup(deps) {
   };
   await writeConfig(settings.home, config);
   const first = purchasableTokens(config, await readUsage(settings.home), STARTER_TOKENS);
-  step(deps, `Buying ${first.toLocaleString("en-US")} tokens (${tokensUsd(first)})`);
+  step(deps, `Buying ${first.toLocaleString("en-US")} seals (${tokensUsd(first)})`);
   const bought = await buyWithinBudget(settings, config, STARTER_TOKENS, deps.openWallet);
-  done(deps, `${bought.toLocaleString("en-US")} tokens ready`);
+  done(deps, `${bought.toLocaleString("en-US")} seals ready`);
   deps.startRefill();
   const agents = await detectAgents(deps.agents);
   if (agents.length === 0) {
@@ -933,7 +946,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-3AFTEAOI.js");
+    const { authorizeBudget } = await import("./wallet-MEBNL43A.js");
     const issuer = await loadIssuer(settings.home, settings.gatewayUrl, {
       fetch: deps.fetch
     });
@@ -972,9 +985,10 @@ async function changePerPage(deps, input) {
   done(deps, `Each site now gets $${(tokens / 1e3).toFixed(3)} per page.`);
 }
 async function tip(deps, url, amount = "0.10") {
-  const domain = url ? normalizeDomain(url) : null;
+  const domain = url ? normalizePayee(url) : null;
   const usd = parseUsd(amount);
-  if (!domain || usd === void 0) throw new UsageError("Usage: patron tip <url> [usd]");
+  if (!domain || usd === void 0)
+    throw new UsageError("Usage: patron tip <url or @handle> [usd]");
   const count = tipTokens(usd);
   if (count < 1) throw new UsageError("The smallest tip is $0.001.");
   const { config, settings } = await loadSetup(deps);
@@ -986,7 +1000,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")} tokens (${tokensUsd(missing)})`);
+    step(deps, `Buying ${missing.toLocaleString("en-US")} seals (${tokensUsd(missing)})`);
     await buyWithinBudget(settings, config, missing, deps.openWallet);
   }
   const issuer = await loadIssuer(settings.home, settings.gatewayUrl, {
@@ -1024,13 +1038,13 @@ async function tip(deps, url, amount = "0.10") {
     });
   if (paid === 0)
     throw new Error(
-      rejection ? `Patron rejected the tip to ${domain}: ${rejection}.` : `Could not reach Patron to tip ${domain}; your tokens were kept.`
+      rejection ? `Patron rejected the tip to ${domain}: ${rejection}.` : `Could not reach Patron to tip ${domain}; your seals were kept.`
     );
   if (paid < count)
     say(
       deps,
       styleText(
-        `  ${count - paid} of ${count} tokens did not go through.`,
+        `  ${count - paid} of ${count} seals did not go through.`,
         "yellow",
         deps.color
       )
@@ -1044,7 +1058,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-3AFTEAOI.js")).openWallet(s, c.wallet, i, max));
+  const open = deps.openWallet ?? (async (s, c, i, max) => (await import("./wallet-MEBNL43A.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 });
@@ -1067,7 +1081,7 @@ async function uninstall(deps) {
     const prompter = deps.prompter();
     try {
       purge = await prompter.confirm(
-        `Also delete ${deps.settings.home}${tokensLeft > 0 ? ` and ${tokensLeft} unspent tokens (${tokensUsd(tokensLeft)})` : ""}?`,
+        `Also delete ${deps.settings.home}${tokensLeft > 0 ? ` and ${tokensLeft} unspent seals (${tokensUsd(tokensLeft)})` : ""}?`,
         false
       );
     } finally {

package/dist/chunks/{chunk-NLCZ2IHE.js → chunk-6TTNL3HT.js}

@@ -143,7 +143,8 @@ async function readConfig(home) {
     relayUrl: String(config.relayUrl ?? ""),
     version: 1,
     wallet: config.wallet === "key" ? "key" : "tempo",
-    ...typeof config.name === "string" ? { name: config.name } : {}
+    ...typeof config.name === "string" ? { name: config.name } : {},
+    ...typeof config.tokensPerPage === "number" ? { tokensPerPage: config.tokensPerPage } : {}
   };
 }
 async function writeConfig(home, config) {
@@ -180,7 +181,7 @@ function isUsageRecord(value) {
 }
 function unreadableUsage(path) {
   return new Error(
-    `${path} is unreadable, so Patron stops buying tokens. Delete it to restart this month's budget count.`
+    `${path} is unreadable, so Patron stops buying seals. Delete it to restart this month's budget count.`
   );
 }
 async function updateUsage(home, update, now = /* @__PURE__ */ new Date()) {

package/dist/chunks/{chunk-6Q7AFS33.js → chunk-G2PONYHX.js}

@@ -10,7 +10,7 @@ import {
   statePaths,
   withLock,
   writePrivateFile
-} from "./chunk-NLCZ2IHE.js";
+} from "./chunk-6TTNL3HT.js";
 
 // ../../node_modules/.pnpm/tldts@7.4.19/node_modules/tldts/dist/cjs/index.js
 var require_cjs = __commonJS({
@@ -8608,6 +8608,76 @@ function normalizeDomain(input2) {
   return parsed.domain;
 }
 
+// ../protocol/src/payee.ts
+var X_PAYEE_PREFIX = "x.com/";
+var X_HOSTS = /* @__PURE__ */ new Set([
+  "x.com",
+  "www.x.com",
+  "mobile.x.com",
+  "twitter.com",
+  "www.twitter.com",
+  "mobile.twitter.com"
+]);
+var X_RESERVED = /* @__PURE__ */ new Set([
+  "about",
+  "account",
+  "bookmarks",
+  "communities",
+  "compose",
+  "download",
+  "explore",
+  "grok",
+  "hashtag",
+  "home",
+  "i",
+  "intent",
+  "jobs",
+  "lists",
+  "login",
+  "logout",
+  "messages",
+  "notifications",
+  "premium",
+  "privacy",
+  "search",
+  "settings",
+  "share",
+  "signup",
+  "tos"
+]);
+var X_HANDLE = /^[a-z0-9_]{1,15}$/;
+function xPayee(handle) {
+  const lower = handle.replace(/^@/, "").toLowerCase();
+  return X_HANDLE.test(lower) && !X_RESERVED.has(lower) ? `${X_PAYEE_PREFIX}${lower}` : null;
+}
+function normalizePayee(input2) {
+  const trimmed = input2.trim();
+  if (!trimmed) return null;
+  if (trimmed.startsWith("@")) return xPayee(trimmed);
+  let url2;
+  try {
+    url2 = new URL(
+      /^[a-z][a-z0-9+.-]*:\/\//i.test(trimmed) ? trimmed : `https://${trimmed}`
+    );
+  } catch {
+    return null;
+  }
+  const host = url2.hostname.toLowerCase().replace(/\.$/, "");
+  const bareHost = !/^[a-z][a-z0-9+.-]*:\/\//i.test(trimmed) && !trimmed.includes("/");
+  if (X_HOSTS.has(host) && !bareHost && (url2.protocol === "https:" || url2.protocol === "http:")) {
+    const [first, second] = url2.pathname.split("/").filter(Boolean);
+    if (!first) return null;
+    if (/^[a-z]{2}(-[a-z]{2})?$/i.test(first) && second && X_RESERVED.has(second.toLowerCase()))
+      return null;
+    try {
+      return xPayee(decodeURIComponent(first));
+    } catch {
+      return null;
+    }
+  }
+  return normalizeDomain(trimmed);
+}
+
 // ../protocol/src/encoding.ts
 function toBase64Url(bytes) {
   let binary = "";
@@ -28410,12 +28480,27 @@ var LeaderboardResponse = external_exports.object({
   sites: external_exports.array(
     external_exports.object({ domain: external_exports.string(), earnedUsd: usd, visits: external_exports.number().int() })
   ),
+  /** Claimed X profiles, by earnings: their own leaderboard. */
+  creators: external_exports.array(external_exports.object({ handle: external_exports.string(), earnedUsd: usd, visits: external_exports.number().int() })).default([]),
   totals: external_exports.object({ tokens: external_exports.number().int(), sites: external_exports.number().int(), usd })
 });
 var ClaimRequest = external_exports.object({
+  /** A registrable domain, or an X profile as "x.com/<handle>". */
   domain: external_exports.string().min(1).max(253),
+  address,
+  /** For an X profile: the URL of a post by that profile containing claimRecordValue(address). */
+  proofUrl: external_exports.string().url().max(512).optional(),
+  /** For an X profile, instead of proofUrl: the proof Sign in with X returned to the claim page. */
+  xProof: external_exports.string().max(1024).optional()
+});
+var XSignInRequest = external_exports.object({
+  /** The X handle to sign in as, with or without @. */
+  handle: external_exports.string().min(1).max(16),
+  /** The address the proof will claim for. */
   address
 });
+var XSignInResponse = external_exports.object({ authorizationUrl: external_exports.string().url() });
+var XConfig = external_exports.object({ signIn: external_exports.boolean() });
 var ClaimResponse = external_exports.object({
   ok: external_exports.boolean(),
   domain: external_exports.string(),
@@ -35702,8 +35787,18 @@ function codexPaths(env, home) {
 function withCodexStopHook(settings, command) {
   return withPatronGroup(settings, EVENT, stopGroup(command));
 }
+var CODEX_HOOK_STATUS = "Patron: pay the sites this turn read";
 function stopGroup(command) {
-  return { hooks: [{ command, timeout: HOOK_TIMEOUT_SECONDS, type: "command" }] };
+  return {
+    hooks: [
+      {
+        command,
+        statusMessage: CODEX_HOOK_STATUS,
+        timeout: HOOK_TIMEOUT_SECONDS,
+        type: "command"
+      }
+    ]
+  };
 }
 function hasStopGroup(settings, command) {
   const groups = isObject2(settings.hooks) ? settings.hooks[EVENT] : void 0;
@@ -35795,9 +35890,9 @@ export {
   MIN_TOKENS_PER_PAGE,
   MAX_TOKENS_PER_PAGE,
   clampTokensPerPage,
-  normalizeDomain,
   formatUsd,
   tokensToUnits,
+  normalizePayee,
   LeaderboardResponse,
   PatronInfo,
   profileMessage,

package/dist/chunks/{hook-process-QQ34YQIA.js → hook-process-SIOU4SZZ.js}

@@ -6,20 +6,20 @@ import {
   codexHome,
   loadIssuer,
   needsRefill,
-  normalizeDomain,
+  normalizePayee,
   refillSize,
   resolveSettings,
   settingsFor,
   spend,
   startRefill
-} from "./chunk-6Q7AFS33.js";
+} from "./chunk-G2PONYHX.js";
 import {
   readConfig,
   readUsage,
   updateUsage,
   withLock,
   writePrivateFile
-} from "./chunk-NLCZ2IHE.js";
+} from "./chunk-6TTNL3HT.js";
 
 // src/hook.ts
 import { homedir } from "node:os";
@@ -50,7 +50,7 @@ function hookUrls(payload) {
 function hookDomains(payload) {
   const domains = [];
   for (const url of hookUrls(payload)) {
-    const domain = normalizeDomain(url);
+    const domain = normalizePayee(url);
     if (domain && !domains.includes(domain)) domains.push(domain);
     if (domains.length >= MAX_DOMAINS_PER_HOOK) break;
   }
@@ -179,7 +179,7 @@ async function takeTranscriptDomains(home, transcriptPath2, options) {
       const known = /* @__PURE__ */ new Set([...state.paid, ...state.pending]);
       const pending = [...state.pending];
       for (const url of codexRolloutUrls(lines)) {
-        const domain = normalizeDomain(url);
+        const domain = normalizePayee(url);
         if (domain && !known.has(domain)) {
           known.add(domain);
           pending.push(domain);
@@ -336,9 +336,11 @@ async function payReads(dependencies, deadline) {
   const paid = [];
   let empty = false;
   const perPage = clampTokensPerPage(config.tokensPerPage);
-  reads: for (const domain of domains) {
-    for (let token = 0; token < perPage; token++) {
-      if (Date.now() >= deadline) break reads;
+  let pending = domains.slice();
+  rounds: for (let round = 0; round < perPage && pending.length > 0; round++) {
+    const next = [];
+    for (const domain of pending) {
+      if (Date.now() >= deadline) break rounds;
       const result = await spend({
         domain,
         fetch: boundedFetch,
@@ -348,11 +350,13 @@ async function payReads(dependencies, deadline) {
       }).catch(() => null);
       if (result === void 0) {
         empty = true;
-        break reads;
+        break rounds;
       }
-      if (token === 0 && result?.ok) paid.push(result.domain || domain);
-      if (!result?.ok) break;
+      if (!result?.ok) continue;
+      if (round === 0) paid.push(result.domain || domain);
+      next.push(domain);
     }
+    pending = next;
   }
   const now = dependencies.now?.() ?? /* @__PURE__ */ new Date();
   if (paid.length > 0)

package/dist/chunks/{wallet-3AFTEAOI.js → wallet-MEBNL43A.js}

@@ -2,7 +2,7 @@ import { createRequire as __patronCreateRequire } from 'node:module'
 const require = __patronCreateRequire(import.meta.url)
 import {
   statePaths
-} from "./chunk-NLCZ2IHE.js";
+} from "./chunk-6TTNL3HT.js";
 
 // src/wallet.ts
 import { Store } from "accounts";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tempoxyz/patron",
-	"version": "0.0.1",
+	"version": "0.0.11",
 	"description": "Pay the websites your AI agents read, privately",
 	"type": "module",
 	"bin": {
@@ -41,7 +41,7 @@
 		"vitest": "4.1.12"
 	},
 	"dependencies": {
-		"accounts": "0.21.0",
+		"accounts": "0.21.1",
 		"mppx": "0.15.0",
 		"viem": "2.57.12"
 	}