@tempoxyz/patron 0.0.16 → 0.0.18

package/README.md

@@ -7,9 +7,10 @@ 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 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.
+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
+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,
 change the budget or uninstall.
@@ -24,9 +25,23 @@ change the budget or uninstall.
 | `patron budget <usd>` | Change the monthly budget |
 | `patron tip <url> [usd]` | Tip a site, $0.10 by default |
 | `patron name <handle>` | Set your public leaderboard name |
+| `patron per-page <usd>` | What each site gets per page read, $0.001 to $0.01 |
 | `patron uninstall` | Remove agent hooks, optionally local data |
 | `patron hook` | Run by agents after each web read |
 
+## What gets paid
+
+- 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
+  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`.
+  X profiles and posts pay the profile.
+- Never paid: mail, chat and private documents (Gmail, Google Docs, Slack, WhatsApp), sign-in
+  pages, banking, health portals, link shorteners (`t.co`, `bit.ly`), localhost and IPs.
+
 ## Privacy
 
 Seals are Privacy Pass blind tokens (RFC 9578). The gateway knows your address bought a
@@ -48,9 +63,9 @@ limit equal to the budget, renewed every 30 days.
 | Agent | Hook |
 | :- | :- |
 | Claude Code | Async `PostToolUse` hook for WebFetch and WebSearch in `~/.claude/settings.json` |
-
-Codex runs web search as a hosted tool that hooks do not see, and Cursor and Amp have no
-documented hook for web reads, so they are not supported yet.
+| Cursor | `postToolUse` hook for WebFetch and WebSearch in `~/.cursor/hooks.json` |
+| Codex | `notify` and a `Stop` hook; pays the sites in the session rollout at the end of each turn |
+| Amp | Plugin in `~/.config/amp/plugins/patron.ts` for `read_web_page` and `web_search` |
 
 ## Environment
 

package/dist/bin.js

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

package/dist/chunks/{-UIKBA3CN.js → -643GYNS6.js}

@@ -1,46 +1,50 @@
 import { createRequire as __patronCreateRequire } from 'node:module'
 const require = __patronCreateRequire(import.meta.url)
 import {
-  DEFAULT_MONTHLY_BUDGET_USD,
   FileTokenStore,
   LeaderboardResponse,
-  MAX_TOKENS_PER_PAGE,
-  MIN_TOKENS_PER_PAGE,
-  PACK_SIZE,
   PatronInfo,
   STARTER_TOKENS,
-  TOKEN_PRICE_UNITS,
   budgetTokens,
   buyTokens,
-  clampTokensPerPage,
   codexHome,
   codexPaths,
-  formatUsd,
   hasPatronHandler,
   installCodex,
   isObject,
   isPatronHandler,
   loadIssuer,
   needsRefill,
-  normalizePayee,
   parseUsd,
   profileMessage,
   purchasableTokens,
   readJsonObject,
   redeem,
   removeCodex,
-  resolveSettings,
-  settingsFor,
-  startRefill,
   tipTokens,
-  tokensToUnits,
   upgradeCodex,
   withHooksKey,
   withPatronGroup,
   withPatronStatus,
   withoutPatronHandlers,
   writeJsonObject
-} from "./chunk-4Z6ZIXMK.js";
+} from "./chunk-XJOIDBXC.js";
+import {
+  startRefill
+} from "./chunk-CV2WYKM7.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-CF4LJZLC.js";
 import {
   AGENT_IDS,
   ensureHome,
@@ -53,7 +57,8 @@ import {
   withLock,
   writeConfig,
   writePrivateFile
-} from "./chunk-FXE4CGY7.js";
+} from "./chunk-RDEPJ6XD.js";
+import "./chunk-GTMLTZRN.js";
 
 // src/index.ts
 import { readFileSync } from "node:fs";
@@ -614,7 +619,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-JDUPZN7E.js");
+  const { openWallet } = await import("./wallet-WNPT6R4M.js");
   return openWallet(settings, config.wallet, issuer, maxUnits);
 };
 async function buyWithinBudget(settings, config, wanted, openWallet = defaultOpenWallet) {
@@ -885,7 +890,7 @@ async function setup(deps) {
     deps,
     settings.privateKey ? "Using PATRON_PRIVATE_KEY" : "Signing in with Tempo Wallet"
   );
-  const { signIn } = await import("./wallet-JDUPZN7E.js");
+  const { signIn } = await import("./wallet-WNPT6R4M.js");
   const account = await signIn(settings, { budgetUnits, issuer, output: deps.stdout });
   done(deps, `Signed in as ${account.address}`);
   const config = {
@@ -999,7 +1004,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-JDUPZN7E.js");
+    const { authorizeBudget } = await import("./wallet-WNPT6R4M.js");
     const issuer = await loadIssuer(settings.home, settings.gatewayUrl, {
       fetch: deps.fetch
     });
@@ -1111,7 +1116,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-JDUPZN7E.js")).openWallet(s, c.wallet, i, max));
+  const open = deps.openWallet ?? (async (s, c, i, max) => (await import("./wallet-WNPT6R4M.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 });