[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_359":360,"_361":362},"routes/_app.x.$handle.$name",{"_107":106,"_38":51,"_115":93,"_33":116,"_13":14,"_117":-5,"_11":118,"_119":120,"_121":122,"_123":124,"_125":126,"_26":-5,"_127":128,"_129":130,"_131":31,"_132":133,"_134":135,"_136":-5,"_137":-5,"_138":139},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":18,"_19":-5},"project",{"_49":50,"_38":51,"_44":52,"_53":-5,"_54":31,"_55":56,"_57":56,"_58":59,"_60":-5,"_19":61,"_62":-5,"_63":31,"_64":-5,"_65":-5,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_76":-5,"_77":78,"_79":78,"_80":81,"_82":81,"_83":81,"_84":78,"_85":78,"_86":87,"_88":89,"_90":91,"_92":31},"version",17,"changes",[25],"aiChatInfo",{"_20":21,"_22":-5,"_23":-5,"_24":-5},"userId","aiChatMessageId","b4f9a1f4-f871-4c59-b572-6fce6ee8bae0","aiChatThreadId","aiChatThreadUserId","aiChatThreadTitle",{"_26":27,"_28":29,"_30":31,"_32":31,"_33":34,"_35":34},"file",{"_36":37,"_38":34,"_39":40,"_41":43,"_44":45,"_46":14,"_47":48,"_30":31},"previous",{"_36":37,"_38":34,"_39":40,"_41":42},"deleted",false,"deletedHere","path","mpp.ts","latestPath","fileId","019e75a2-f04c-7499-b28f-5cccd964d007","name","fileType","script","content","// Tempo / MPP payment rail — mainnet (chain 4217), USDC.e, priced PER PIECE.\n//\n// Letters are priced per page (we count the PDF's pages on the unpaid request\n// and charge pages × rate + a base postage fee). Postcards are a flat rate. So\n// the 402 tells the agent the exact cost up front. mppx settles directly\n// against the Tempo RPC (no facilitator). Pay in one line:\n// tempo request -X POST --json '{...}' /v1/mail\nimport { Mppx, tempo } from \"npm:mppx@0.6.28/hono\";\nimport { privateKeyToAccount } from \"npm:viem/accounts\";\nimport type { MailType } from \"./mail.ts\";\n\nexport const USDC_E = {\n symbol: \"USDC.e\",\n address: \"0x20C000000000000000000000b9537d11c60E8b50\",\n decimals: 6,\n};\n\nfunction envUsd(key: string, fallback: number): number {\n return parseFloat(Deno.env.get(key) || String(fallback)) || fallback;\n}\n\n/** Flat postage/handling fee applied to every piece (covers postage). */\nexport function baseFeeUsd(): number {\n return envUsd(\"MAIL_BASE_FEE\", 1.0);\n}\n\n/** Marginal cost per printed page on a letter. */\nexport function perPageUsd(): number {\n return envUsd(\"MAIL_PRICE_PER_PAGE\", 0.25);\n}\n\n/** Flat all-in price for a postcard. */\nexport function postcardUsd(): number {\n return envUsd(\"MAIL_POSTCARD_PRICE\", 1.5);\n}\n\nexport function priceLabel(): string {\n return `letters $${baseFeeUsd().toFixed(2)} + $${perPageUsd().toFixed(2)}/page · postcards $${postcardUsd().toFixed(2)}`;\n}\n\nexport function recipient(): string {\n return Deno.env.get(\"TEMPO_RECIPIENT\") || \"0xed5bd29c47d40a054591b18cc2142cea8ab7c18a\";\n}\n\n// --- page counting ----------------------------------------------------------\n\nfunction base64ToBytes(b64: string): Uint8Array {\n const bin = atob(b64.replace(/^data:.*;base64,/, \"\"));\n const out = new Uint8Array(bin.length);\n for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);\n return out;\n}\n\nasync function docBytes(input: { fileUrl?: string; contentBase64?: string }): Promise {\n if (input.contentBase64) {\n try {\n return base64ToBytes(input.contentBase64);\n } catch {\n return null;\n }\n }\n if (input.fileUrl) {\n try {\n const res = await fetch(input.fileUrl);\n if (!res.ok) return null;\n const buf = new Uint8Array(await res.arrayBuffer());\n return buf.byteLength <= 25_000_000 ? buf : null; // 25 MB cap\n } catch {\n return null;\n }\n }\n return null;\n}\n\n/** Count PDF pages. Falls back to 1 page if the doc can't be fetched/parsed. */\nexport async function countPages(input: { fileUrl?: string; contentBase64?: string }): Promise {\n const bytes = await docBytes(input);\n if (!bytes) return 1;\n try {\n const { PDFDocument } = await import(\"npm:pdf-lib\"); // dynamic so an import error can't kill the val\n const doc = await PDFDocument.load(bytes, { updateMetadata: false });\n return Math.max(1, doc.getPageCount());\n } catch {\n return 1; // non-PDF / unparseable → bill a single page\n }\n}\n\n/** Total price for a piece of mail, in USD (string, 2dp). */\nexport function amountForMail(type: MailType, pages: number): string {\n if (type === \"postcard\") return postcardUsd().toFixed(2);\n return (baseFeeUsd() + Math.max(1, pages) * perPageUsd()).toFixed(2);\n}\n\n// --- mppx client ------------------------------------------------------------\n\nfunction signer() {\n const k = Deno.env.get(\"MPP_SIGNER_KEY\");\n return k ? privateKeyToAccount(k as `0x${string}`) : undefined;\n}\n\n/** Payment is configured only when we have a server signing account. mppx's\n * tempo() throws on init without one, so we gate on it to fail soft. */\nexport function paymentConfigured(): boolean {\n return !!Deno.env.get(\"MPP_SIGNER_KEY\") && !!Deno.env.get(\"MPP_SECRET_KEY\");\n}\n\nlet _client: ReturnType | null = null;\nfunction client() {\n // secretKey from MPP_SECRET_KEY; mainnet + USDC.e are the tempo() defaults.\n // `account` is a server signer tempo() requires (session settlement; unused by charge).\n _client ??= Mppx.create({ methods: [tempo({ recipient: recipient(), account: signer() })] });\n return _client;\n}\n\n/** Hono middleware: price the piece (letter = base + pages×rate; postcard =\n * flat) and charge it. Lazily inits so a config error only affects this route,\n * not the whole val. */\nexport function chargeMail() {\n return async (c: any, next: any) => {\n let body: any = {};\n try {\n body = await c.req.json();\n } catch {\n body = {};\n }\n const type: MailType = body?.type === \"postcard\" ? \"postcard\" : \"letter\";\n const pages = type === \"letter\"\n ? await countPages({\n fileUrl: body?.file_url ? String(body.file_url) : undefined,\n contentBase64: body?.content_base64 ? String(body.content_base64) : undefined,\n })\n : 1;\n const amount = amountForMail(type, pages);\n c.set(\"mailType\", type);\n c.set(\"mailPages\", pages);\n c.set(\"mailAmount\", amount);\n return client().charge({ amount })(c, next);\n };\n}\n\nexport function paymentInfo() {\n const r = recipient();\n return {\n protocol: \"mpp\",\n method: \"tempo\",\n network: \"tempo\",\n chainId: 4217,\n asset: USDC_E,\n pricing: {\n model: \"per_piece\",\n base_fee_usd: baseFeeUsd(),\n per_page_usd: perPageUsd(),\n postcard_usd: postcardUsd(),\n currency: \"USDC.e\",\n },\n price: priceLabel(),\n recipient: r,\n payTo: r, // alias for UI compatibility\n facilitator: \"none (settles via Tempo RPC)\",\n mode: \"mpp\",\n payableBy: [\"tempo-mpp\"],\n };\n}\n","// Tempo / MPP payment rail — mainnet (chain 4217), USDC.e, priced PER PIECE.\n//\n// Letters are priced per page (we count the PDF's pages on the unpaid request\n// and charge pages × rate + a base postage fee). Postcards are a flat rate. So\n// the 402 tells the agent the exact cost up front. mppx settles directly\n// against the Tempo RPC (no facilitator). Pay in one line:\n// tempo request -X POST --json '{...}' /v1/mail\nimport { Mppx, tempo } from \"npm:mppx@0.6.28/hono\";\nimport { privateKeyToAccount } from \"npm:viem/accounts\";\nimport type { MailType } from \"./mail.ts\";\n\nexport const USDC_E = {\n symbol: \"USDC.e\",\n address: \"0x20C000000000000000000000b9537d11c60E8b50\",\n decimals: 6,\n};\n\nfunction envUsd(key: string, fallback: number): number {\n return parseFloat(Deno.env.get(key) || String(fallback)) || fallback;\n}\n\n/** Flat postage/handling fee applied to every piece (covers postage). */\nexport function baseFeeUsd(): number {\n return envUsd(\"MAIL_BASE_FEE\", 1.0);\n}\n\n/** Marginal cost per printed page on a letter. */\nexport function perPageUsd(): number {\n return envUsd(\"MAIL_PRICE_PER_PAGE\", 0.25);\n}\n\n/** Flat all-in price for a postcard. */\nexport function postcardUsd(): number {\n return envUsd(\"MAIL_POSTCARD_PRICE\", 1.5);\n}\n\nexport function priceLabel(): string {\n return `letters $${baseFeeUsd().toFixed(2)} + $${perPageUsd().toFixed(2)}/page · postcards $${postcardUsd().toFixed(2)}`;\n}\n\nexport function recipient(): string {\n return Deno.env.get(\"TEMPO_RECIPIENT\") || \"0xed5bd29c47d40a054591b18cc2142cea8ab7c18a\";\n}\n\n// --- page counting ----------------------------------------------------------\n\nfunction base64ToBytes(b64: string): Uint8Array {\n const bin = atob(b64.replace(/^data:.*;base64,/, \"\"));\n const out = new Uint8Array(bin.length);\n for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);\n return out;\n}\n\nasync function docBytes(input: { fileUrl?: string; contentBase64?: string }): Promise {\n if (input.contentBase64) {\n try {\n return base64ToBytes(input.contentBase64);\n } catch {\n return null;\n }\n }\n if (input.fileUrl) {\n try {\n const res = await fetch(input.fileUrl);\n if (!res.ok) return null;\n const buf = new Uint8Array(await res.arrayBuffer());\n return buf.byteLength <= 25_000_000 ? buf : null; // 25 MB cap\n } catch {\n return null;\n }\n }\n return null;\n}\n\n/** Count PDF pages. Falls back to 1 page if the doc can't be fetched/parsed. */\nexport async function countPages(input: { fileUrl?: string; contentBase64?: string }): Promise {\n const bytes = await docBytes(input);\n if (!bytes) return 1;\n try {\n const { PDFDocument } = await import(\"npm:pdf-lib\"); // dynamic so an import error can't kill the val\n const doc = await PDFDocument.load(bytes, { updateMetadata: false });\n return Math.max(1, doc.getPageCount());\n } catch {\n return 1; // non-PDF / unparseable → bill a single page\n }\n}\n\n/** Total price for a piece of mail, in USD (string, 2dp). */\nexport function amountForMail(type: MailType, pages: number): string {\n if (type === \"postcard\") return postcardUsd().toFixed(2);\n return (baseFeeUsd() + Math.max(1, pages) * perPageUsd()).toFixed(2);\n}\n\n// --- mppx client ------------------------------------------------------------\n\nfunction signer() {\n const k = Deno.env.get(\"MPP_SIGNER_KEY\");\n return k ? privateKeyToAccount(k as `0x${string}`) : undefined;\n}\n\n/** Payment is configured only when we have a server signing account. mppx's\n * tempo() throws on init without one, so we gate on it to fail soft. */\nexport function paymentConfigured(): boolean {\n return !!Deno.env.get(\"MPP_SIGNER_KEY\") && !!Deno.env.get(\"MPP_SECRET_KEY\");\n}\n\nlet _client: ReturnType | null = null;\nfunction client() {\n // secretKey from MPP_SECRET_KEY; mainnet + USDC.e are the tempo() defaults.\n // `account` is a server signer tempo() requires (session settlement; unused by charge).\n _client ??= Mppx.create({ methods: [tempo({ recipient: recipient(), account: signer() })] });\n return _client;\n}\n\n/** Hono middleware: price the piece (letter = base + pages×rate; postcard =\n * flat) and charge it. Lazily inits so a config error only affects this route,\n * not the whole val. */\nexport function chargeMail() {\n return async (c: any, next: any) => {\n let body: any = {};\n try {\n body = await c.req.json();\n } catch {\n body = {};\n }\n const type: MailType = body?.type === \"postcard\" ? \"postcard\" : \"letter\";\n const pages = type === \"letter\"\n ? await countPages({\n fileUrl: body?.file_url ? String(body.file_url) : undefined,\n contentBase64: body?.content_base64 ? String(body.content_base64) : undefined,\n })\n : 1;\n const amount = amountForMail(type, pages);\n c.set(\"mailType\", type);\n c.set(\"mailPages\", pages);\n c.set(\"mailAmount\", amount);\n // Fail soft if the MPP rail isn't configured yet (e.g. a fresh fork): tell\n // the caller exactly what's missing instead of crashing the route.\n if (!paymentConfigured()) {\n return c.json({\n error: \"payment_not_configured\",\n message:\n \"This instance has no MPP signing key set, so it can't issue payment challenges yet. Set MPP_SIGNER_KEY and MPP_SECRET_KEY (and TEMPO_RECIPIENT) to enable paid mailings.\",\n price_usd: amount,\n type,\n pages,\n }, 503);\n }\n return client().charge({ amount })(c, next);\n };\n}\n\nexport function paymentInfo() {\n const r = recipient();\n return {\n protocol: \"mpp\",\n method: \"tempo\",\n network: \"tempo\",\n chainId: 4217,\n asset: USDC_E,\n pricing: {\n model: \"per_piece\",\n base_fee_usd: baseFeeUsd(),\n per_page_usd: perPageUsd(),\n postcard_usd: postcardUsd(),\n currency: \"USDC.e\",\n },\n price: priceLabel(),\n recipient: r,\n payTo: r, // alias for UI compatibility\n facilitator: \"none (settles via Tempo RPC)\",\n mode: \"mpp\",\n payableBy: [\"tempo-mpp\"],\n };\n}\n","createdAt",["D",1780090450347],"branchVersion","branchId","404a0522-5ba5-11f1-b599-ee650bb23af1","id","4042da18-5ba5-11f1-b599-ee650bb23af1","agentsnailmail",["D",1780090073094],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Fax API for AI agents — paid per fax over x402 (USDC)","imageUrl","4d11709c-f58a-4ebd-9aff-ea1a657da2f8","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",0,"orgId","e7772d02-8afa-4fe7-81f0-5d0c516ee833","tursoName","4042da185ba511f1b599ee650bb23af1","tursoHostname","4042da185ba511f1b599ee650bb23af1-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789509043237],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_107":106,"_114":110},"org",{"_107":106,"_108":-5,"_109":110,"_19":61,"_111":112,"_113":31},"branch",{"_13":14,"_38":93,"_49":48,"_94":50,"_95":96,"_97":98,"_99":56,"_100":101,"_102":103,"_104":51,"_105":106},"isOwned","main","projectId","forkedBranchId","dbdd6128-5b69-11f1-a7a0-ee650bb23af1","forkedBranchVersion",140,"forkedProjectPrivacy","forkedProjectId","dbdc95e0-5b69-11f1-a7a0-ee650bb23af1","forkedProjectOrgId","e81e7335-6d4c-4764-a902-d0962bbfa9f7","projectName","userHandle","jchan7","handle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yb3FTYVlZMHVTOVMzVkV2T1hoT2hGb1o4c1YifQ","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_49":50,"_38":51,"_44":354,"_53":-5,"_54":31,"_55":56,"_57":56,"_58":59,"_60":-5,"_19":61,"_62":-5,"_63":31,"_64":-5,"_65":-5,"_66":67,"_68":69,"_70":71,"_72":73,"_74":355,"_76":-5,"_77":78,"_79":78,"_80":81,"_82":81,"_83":81,"_84":78,"_85":78,"_86":356,"_88":357,"_90":358,"_92":31},"tree",[231,242,243,244,245,246,247,248,249],"files",[231,232,233,234,235,236,237,238,239,240,241,242,243,244,245,246,247,248,249],"counts",{"_220":67,"_221":163,"_222":67,"_223":224,"_225":226},"contents",[150,151,152,153,154,155,156,157,158],"upstreamProject",{"_49":101,"_38":147,"_58":59,"_60":-5,"_55":56,"_86":148},"upstreamBranch",{"_49":96,"_44":140,"_141":142,"_38":93,"_94":101,"_13":143,"_95":-5,"_97":-5,"_144":145,"_53":-5,"_92":31,"_55":56,"_105":146,"_68":103,"_104":147},"emptyEnvVars","flags",[],"hasHttpFiles",true,"grants","orgs","customDomains",{},["D",1780064564360],"updatedAt",["D",1783436101628],150,"lockfileKey","1783436101842-esm.town_v_stevekrouse_agentfax@150-main","stevekrouse","agentfax",{"_107":146,"_114":149},"https://images.clerk.dev/uploaded/img_2PqHa2Gsy93xQrjh2w78Xu0cChW.jpeg",{"_49":214,"_38":215,"_36":216,"_162":-5,"_47":48,"_46":163,"_164":135,"_44":217,"_13":67,"_39":218,"_41":-5,"_30":31,"_167":-5,"_33":219},{"_49":208,"_38":209,"_36":210,"_162":-5,"_47":48,"_46":163,"_164":135,"_44":211,"_13":67,"_39":26,"_41":212,"_30":31,"_167":-5,"_33":213},{"_49":201,"_38":202,"_36":203,"_162":-5,"_47":48,"_46":204,"_164":135,"_44":205,"_13":163,"_39":40,"_41":206,"_30":31,"_167":-5,"_33":207},{"_49":194,"_38":195,"_36":196,"_162":-5,"_47":48,"_46":197,"_164":135,"_44":198,"_13":67,"_39":40,"_41":199,"_30":31,"_167":-5,"_33":200},{"_49":186,"_38":187,"_36":188,"_162":-5,"_47":48,"_46":189,"_164":135,"_44":190,"_13":163,"_39":191,"_41":192,"_30":31,"_167":-5,"_33":193},{"_49":182,"_38":34,"_36":37,"_162":-5,"_47":48,"_46":14,"_164":135,"_44":183,"_13":184,"_39":40,"_41":43,"_30":31,"_167":-5,"_33":185},{"_49":175,"_38":176,"_36":177,"_162":-5,"_47":48,"_46":178,"_164":135,"_44":179,"_13":163,"_39":40,"_41":180,"_30":31,"_167":-5,"_33":181},{"_49":169,"_38":170,"_36":171,"_162":-5,"_47":48,"_46":163,"_164":135,"_44":172,"_13":67,"_39":40,"_41":173,"_30":31,"_167":-5,"_33":174},{"_49":159,"_38":160,"_36":161,"_162":-5,"_47":48,"_46":163,"_164":135,"_44":165,"_13":67,"_39":40,"_41":166,"_30":31,"_167":-5,"_33":168},"4050d7bc-5ba5-11f1-b599-ee650bb23af1","payment.ts","019e75a2-f04c-7499-b28f-694c692de314","parentId",1,"latest",["D",1780090073094],"// x402 payment wiring.\n//\n// One standard x402 endpoint (USDC, `exact` scheme) is payable by Coinbase\n// x402 agents, Circle agent wallets, and Tempo/MPP agents alike. We gate\n// `POST /v1/fax` with the official x402-hono middleware, which encodes the\n// correct per-network USDC EIP-712 domain so any compliant client can pay.\n//\n// Config (all optional — sane defaults so it runs out of the box):\n// FAX_PAYMENT_MODE \"x402\" (default) | \"sandbox\" (skip payment, for testing)\n// FAX_NETWORK \"base-sepolia\" (default, keyless facilitator) | \"base\"\n// FAX_PRICE_USD \"$0.50\" (default), price per fax\n// FAX_PAYTO_ADDRESS 0x... wallet that receives the USDC\n// CDP_API_KEY_ID / CDP_API_KEY_SECRET required only when FAX_NETWORK=\"base\"\nimport type { Hono } from \"npm:hono\";\nimport { paymentMiddleware } from \"npm:x402-hono\";\n\nexport type PaymentMode = \"x402\" | \"sandbox\";\n\nexport const USDC: Record = {\n \"base\": { address: \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\", decimals: 6 },\n \"base-sepolia\": { address: \"0x036CbD53842c5426634e7929541eC2318f3dCF7e\", decimals: 6 },\n};\n\nexport function paymentMode(): PaymentMode {\n return (Deno.env.get(\"FAX_PAYMENT_MODE\") || \"x402\").toLowerCase() === \"sandbox\"\n ? \"sandbox\"\n : \"x402\";\n}\n\nfunction hasUsableCdpKey(): boolean {\n const id = Deno.env.get(\"CDP_API_KEY_ID\");\n const secret = Deno.env.get(\"CDP_API_KEY_SECRET\") || \"\";\n // Real CDP secrets are PEM EC keys or long base64 Ed25519 keys. Reject short/malformed.\n return !!id && (secret.includes(\"BEGIN\") || secret.length >= 50);\n}\n\nexport function network(): string {\n const n = Deno.env.get(\"FAX_NETWORK\") || \"base-sepolia\";\n // Mainnet settlement needs a valid CDP facilitator key. If it's missing or\n // malformed, fall back to the keyless Base Sepolia facilitator so the service\n // keeps working — and auto-upgrades to mainnet once a valid key is set.\n if (n === \"base\" && !hasUsableCdpKey()) return \"base-sepolia\";\n return n;\n}\n\nexport function priceUsd(): string {\n const p = Deno.env.get(\"FAX_PRICE_USD\") || \"$0.50\";\n return p.startsWith(\"$\") ? p : `$${p}`;\n}\n\nexport function payToAddress(): string {\n // Default to Steve's known EVM address; override per-deployment.\n return Deno.env.get(\"FAX_PAYTO_ADDRESS\") || \"0xd6f0870b8e1c6af8d712cc506ccf5e96ac040592\";\n}\n\nexport function facilitatorUrl(): string {\n return network() === \"base\"\n ? \"https://api.cdp.coinbase.com/platform/v2/x402\"\n : \"https://x402.org/facilitator\";\n}\n\n/** Public, machine-readable description of how to pay this service. */\nexport function paymentInfo() {\n const net = network();\n return {\n protocol: \"x402\",\n x402Version: 1,\n scheme: \"exact\",\n network: net,\n asset: { symbol: \"USDC\", address: USDC[net]?.address ?? null, decimals: 6 },\n price: priceUsd(),\n payTo: payToAddress(),\n facilitator: facilitatorUrl(),\n mode: paymentMode(),\n payableBy: [\"coinbase-x402\", \"circle-agent-wallets\"],\n };\n}\n\nconst ROUTE_CONFIG = {\n price: priceUsd(),\n network: network(),\n config: {\n description: \"Send a fax to any phone number. Billed once per fax.\",\n mimeType: \"application/json\",\n maxTimeoutSeconds: 120,\n outputSchema: {\n type: \"object\",\n properties: {\n id: { type: \"string\" },\n status: { type: \"string\", enum: [\"queued\", \"sending\", \"delivered\", \"failed\"] },\n to: { type: \"string\" },\n },\n },\n },\n};\n\n/** Install x402 payment gating on POST /v1/fax (no-op in sandbox mode). */\nexport async function installPayment(app: Hono): Promise {\n if (paymentMode() === \"sandbox\") return;\n\n let facilitator: { url: string } | unknown = { url: facilitatorUrl() };\n if (network() === \"base\") {\n // CDP facilitator helper reads CDP_API_KEY_ID / CDP_API_KEY_SECRET.\n const mod = await import(\"npm:@coinbase/x402\");\n facilitator = mod.facilitator;\n }\n\n app.use(\n paymentMiddleware(\n payToAddress() as `0x${string}`,\n { \"POST /v1/fax\": ROUTE_CONFIG },\n facilitator as any,\n ),\n );\n}\n\n/** Decode the x402 X-PAYMENT header to learn who paid (best-effort). */\nexport function decodePayer(header: string | undefined): { payer: string | null; network: string | null } {\n if (!header) return { payer: null, network: null };\n try {\n const payload = JSON.parse(atob(header));\n return {\n payer: payload?.payload?.authorization?.from ?? null,\n network: payload?.network ?? null,\n };\n } catch {\n return { payer: null, network: null };\n }\n}\n","label",[160],"4050bcaa-5ba5-11f1-b599-ee650bb23af1","og.ts","019e75a2-f04c-7499-b28f-6749339e70f4",["D",1780090073094],"// Open Graph / Twitter card image (1200×630), generated with satori (JSX→SVG)\n// + resvg-wasm (SVG→PNG). Served at GET /og.png. Modeled on stevekrouse/secret-share.\nimport satori from \"npm:satori@0.10.13\";\nimport { initWasm, Resvg } from \"npm:@resvg/resvg-wasm@2.6.2\";\n\n// Static-weight TTFs (variable fonts crash satori's opentype.js). PT Sans is the\n// sans sibling of the PT Serif that secret-share uses — same reliable repo path.\nconst SANS_BOLD_TTF =\n \"https://raw.githubusercontent.com/google/fonts/main/ofl/ptsans/PT_Sans-Web-Bold.ttf\";\nconst SANS_REGULAR_TTF =\n \"https://raw.githubusercontent.com/google/fonts/main/ofl/ptsans/PT_Sans-Web-Regular.ttf\";\nconst RESVG_WASM_URL = \"https://unpkg.com/@resvg/resvg-wasm@2.6.2/index_bg.wasm\";\n\nlet fontsPromise: Promise<{ bold: ArrayBuffer; regular: ArrayBuffer }> | null = null;\nfunction loadFonts() {\n if (!fontsPromise) {\n const get = (url: string, label: string) =>\n fetch(url).then((r) => {\n if (!r.ok) throw new Error(`${label} font fetch failed: ${r.status}`);\n return r.arrayBuffer();\n });\n fontsPromise = Promise.all([\n get(SANS_BOLD_TTF, \"Bold\"),\n get(SANS_REGULAR_TTF, \"Regular\"),\n ]).then(([bold, regular]) => ({ bold, regular }));\n }\n return fontsPromise;\n}\n\nlet wasmPromise: Promise | null = null;\nfunction ensureResvg(): Promise {\n if (!wasmPromise) {\n wasmPromise = fetch(RESVG_WASM_URL)\n .then((r) => {\n if (!r.ok) throw new Error(`resvg wasm fetch failed: ${r.status}`);\n return r.arrayBuffer();\n })\n .then((bytes) => initWasm(bytes));\n }\n return wasmPromise;\n}\n\nfunction pill(text: string) {\n return {\n type: \"div\",\n props: {\n style: {\n display: \"flex\",\n fontSize: 26,\n color: \"#d4d4d4\",\n background: \"#1f1f1f\",\n borderRadius: \"999px\",\n padding: \"12px 28px\",\n },\n children: text,\n },\n };\n}\n\n// The favicon's fax glyph as a satori SVG node (0–32 grid), scaled to `size`.\nfunction faxIcon(size: number) {\n return {\n type: \"svg\",\n props: {\n width: size,\n height: size,\n viewBox: \"0 0 32 32\",\n children: [\n { type: \"rect\", props: { width: 32, height: 32, rx: 7, fill: \"#10b981\" } },\n { type: \"rect\", props: { x: 9, y: 5, width: 14, height: 7, rx: 1.5, fill: \"#0a0a0a\" } },\n { type: \"rect\", props: { x: 6, y: 12, width: 20, height: 14, rx: 2.5, fill: \"#0a0a0a\" } },\n { type: \"circle\", props: { cx: 22, cy: 16, r: 1.2, fill: \"#10b981\" } },\n { type: \"rect\", props: { x: 10, y: 19, width: 12, height: 8, rx: 1, fill: \"#10b981\" } },\n { type: \"rect\", props: { x: 12, y: 21, width: 8, height: 1.4, rx: 0.7, fill: \"#0a0a0a\" } },\n { type: \"rect\", props: { x: 12, y: 23.6, width: 6, height: 1.4, rx: 0.7, fill: \"#0a0a0a\" } },\n ],\n },\n };\n}\n\nasync function renderSvg(): Promise {\n const { bold, regular } = await loadFonts();\n const tree = {\n type: \"div\",\n props: {\n style: {\n width: \"1200px\",\n height: \"630px\",\n display: \"flex\",\n background: \"#0a0a0a\",\n padding: \"56px\",\n fontFamily: \"Sans\",\n },\n children: [\n {\n type: \"div\",\n props: {\n style: {\n flex: 1,\n display: \"flex\",\n flexDirection: \"row\",\n alignItems: \"center\",\n justifyContent: \"space-between\",\n padding: \"0 72px\",\n border: \"1px solid #262626\",\n borderRadius: \"28px\",\n background: \"#000\",\n },\n children: [\n {\n type: \"div\",\n props: {\n style: { display: \"flex\", flexDirection: \"column\", maxWidth: \"640px\" },\n children: [\n {\n type: \"div\",\n props: {\n style: { display: \"flex\", fontSize: 28, fontWeight: 700, color: \"#10b981\", letterSpacing: \"6px\" },\n children: \"FAX FOR AI AGENTS\",\n },\n },\n {\n type: \"div\",\n props: {\n style: { display: \"flex\", fontSize: 110, fontWeight: 700, color: \"#ffffff\", letterSpacing: \"-3px\", marginTop: \"18px\" },\n children: \"agentfax\",\n },\n },\n {\n type: \"div\",\n props: {\n style: { display: \"flex\", fontSize: 36, color: \"#a3a3a3\", lineHeight: 1.35, marginTop: \"20px\" },\n children: \"Pay per fax in USDC over Tempo/MPP. No signup, no API key.\",\n },\n },\n {\n type: \"div\",\n props: {\n style: { display: \"flex\", flexDirection: \"row\", gap: \"14px\", marginTop: \"34px\" },\n children: [pill(\"$0.20 / page\"), pill(\"USDC.e on Tempo\")],\n },\n },\n ],\n },\n },\n faxIcon(300),\n ],\n },\n },\n ],\n },\n };\n return await satori(tree as any, {\n width: 1200,\n height: 630,\n fonts: [\n { name: \"Sans\", data: bold, weight: 700, style: \"normal\" },\n { name: \"Sans\", data: regular, weight: 400, style: \"normal\" },\n ],\n });\n}\n\nexport async function renderOg(): Promise {\n try {\n const svg = await renderSvg();\n await ensureResvg();\n const png = new Resvg(svg).render().asPng();\n return new Response(png, {\n headers: { \"content-type\": \"image/png\", \"cache-control\": \"public, max-age=3600\" },\n });\n } catch (err) {\n const msg = err instanceof Error ? err.stack || err.message : String(err);\n return new Response(`OG render failed:\\n${msg}`, {\n status: 500,\n headers: { \"content-type\": \"text/plain\" },\n });\n }\n}\n",[170],"9f278484-5ba5-11f1-8c63-ee650bb23af1","notify.ts","019e75a2-f04c-7499-b28f-6259a130bbf9",5,["D",1780090232290],"// Owner notification — fire a celebratory email whenever a piece of mail is\n// successfully paid for and sent. Best-effort only: callers should never let\n// this block or fail the mailing itself. By default std/email sends to the val\n// owner's address.\nimport { email } from \"https://esm.town/v/std/email\";\n\nexport interface PaidMailNotice {\n id: string;\n type: string; // \"letter\" | \"postcard\"\n toCity: string | null;\n toState: string | null;\n toZip: string | null;\n pages: number | null;\n amount: string | null;\n payer: string | null;\n network: string;\n provider: string;\n status: string;\n expectedDelivery?: string | null;\n live: boolean; // true = real physical mail went out\n created_at: string;\n // Running totals (after this piece), for a little dopamine in the email.\n totals?: { pieces: number; pages: number };\n}\n\nexport async function notifyPaidMail(n: PaidMailNotice): Promise {\n const amount = n.amount ? `$${n.amount}` : \"(unknown)\";\n const dest = [n.toCity, n.toState, n.toZip].filter(Boolean).join(\", \") || \"(unknown)\";\n const realTag = n.live ? \"\" : \" [sandbox]\";\n const icon = n.type === \"postcard\" ? \"📮\" : \"✉️\";\n const subject = `💸${icon} Paid ${n.type}! ${amount} → ${dest}${realTag}`;\n\n const totalsLine = n.totals\n ? `\\nRunning total: ${n.totals.pieces} pieces, ${n.totals.pages} pages 🎉`\n : \"\";\n\n const text = `Someone just paid to send a ${n.type} on AgentSnailMail!${n.live ? \"\" : \"\\n(sandbox / test mode — no physical mail was actually sent)\"}\n\n Amount: ${amount}\n Type: ${n.type}\n To: ${dest}\n Pages: ${n.pages ?? \"?\"}\n Delivery: ${n.expectedDelivery ?? \"(unknown)\"}\n Payer: ${n.payer ?? \"(unknown wallet)\"}\n Network: ${n.network}\n Provider: ${n.provider}\n Status: ${n.status}\n Job ID: ${n.id}\n When: ${n.created_at}\n${totalsLine}`;\n\n await email({ subject, text });\n}\n",[176],"211f9e40-5ba6-11f1-966c-ee650bb23af1",["D",1780090450347],3,[34],"c30a1c4a-5ba5-11f1-8826-ee650bb23af1","main.ts","019e75a2-f04c-7499-b28f-586d0727a187",6,["D",1780090292498],"http","// AgentSnailMail — a print-and-mail API for AI agents, paid per piece over\n// Tempo/MPP (USDC.e). An agent triggers it to send out *real, physical* mail.\n//\n// No signup, no API key (for the agent): it calls POST /v1/mail with a recipient\n// address and either a letter document or postcard artwork, gets back a 402 with\n// an MPP \"Payment\" challenge, pays in USDC.e on Tempo, and the mail goes out via\n// Lob. Pay in one line with the Tempo CLI:\n// tempo request -X POST --json '{...}' /v1/mail\n//\n// We never store the mail contents — they're forwarded to the print/mail network\n// and dropped. We keep only a minimal metadata log (destination city/state/zip,\n// type, pages, amount, paying wallet). Status is read live from the provider.\nimport { Hono } from \"npm:hono\";\nimport { parseVal, serveFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { activeProvider, decodeJobId, getStatus, isLive, type MailInput, sendMail, validateInput } from \"./mail.ts\";\nimport {\n amountForMail,\n baseFeeUsd,\n chargeMail,\n paymentInfo,\n perPageUsd,\n postcardUsd,\n priceLabel,\n recipient,\n USDC_E,\n} from \"./mpp.ts\";\nimport { renderPage } from \"./frontend/render.tsx\";\nimport { renderOg } from \"./og.ts\";\nimport { logMail, mailStats, mailStatsSafe } from \"./db.ts\";\nimport { notifyPaidMail } from \"./notify.ts\";\n\nconst app = new Hono();\n\nconst origin = (c: { req: { url: string } }) => new URL(c.req.url).origin;\n\n// Best-effort: pull the paying wallet from the MPP credential (the address that\n// isn't our recipient). Returns null if it can't be read — metadata only.\nfunction decodePayer(authHeader: string | undefined, recip: string): string | null {\n if (!authHeader) return null;\n try {\n const json = atob(authHeader.replace(/^Payment\\s+/i, \"\").trim().replace(/-/g, \"+\").replace(/_/g, \"/\"));\n const addrs = [...json.matchAll(/0x[a-fA-F0-9]{40}/g)].map((m) => m[0]);\n return addrs.find((a) => a.toLowerCase() !== recip.toLowerCase()) ?? null;\n } catch {\n return null;\n }\n}\n\n// Parse the request body into a MailInput. `to`/`from` accept either nested\n// objects or flat snake_case fields for CLI ergonomics.\nfunction parseAddress(raw: any): any {\n if (!raw || typeof raw !== \"object\") return undefined;\n return {\n name: raw.name ?? raw.full_name,\n line1: raw.line1 ?? raw.address_line1,\n line2: raw.line2 ?? raw.address_line2,\n city: raw.city ?? raw.address_city,\n state: raw.state ?? raw.address_state,\n zip: raw.zip ?? raw.address_zip,\n country: raw.country ?? raw.address_country,\n };\n}\n\nfunction toMailInput(body: Record): MailInput {\n return {\n type: (body.type === \"postcard\" ? \"postcard\" : \"letter\"),\n to: parseAddress(body.to),\n from: body.from ? parseAddress(body.from) : undefined,\n fileUrl: body.file_url ? String(body.file_url) : undefined,\n contentBase64: body.content_base64 ? String(body.content_base64) : undefined,\n fileName: body.file_name ? String(body.file_name) : undefined,\n front: body.front ? String(body.front) : undefined,\n back: body.back ? String(body.back) : undefined,\n message: body.message ? String(body.message) : undefined,\n color: body.color === undefined ? undefined : Boolean(body.color),\n size: body.size ? String(body.size) : undefined,\n };\n}\n\n// --- Landing page (SSR) -----------------------------------------------------\napp.get(\"/\", async (c) =>\n c.html(renderPage({\n baseUrl: origin(c),\n payment: paymentInfo(),\n provider: activeProvider(),\n live: isLive(),\n price: priceLabel(),\n stats: await mailStatsSafe(500),\n })));\n\n// View source (required for Val Town UIs)\napp.get(\"/source\", (c) => c.redirect(parseVal().links.self.val));\n\n// Static frontend assets (favicon, client demo script)\napp.get(\"/frontend/*\", (c) => serveFile(c.req.path));\n\n// Social card image (Open Graph / Twitter)\napp.get(\"/og.png\", () => renderOg());\n\n// --- Discovery manifest -----------------------------------------------------\nfunction manifest(base: string) {\n return {\n name: \"agentsnailmail\",\n description:\n \"Send real, physical mail (letters & postcards) to any address. Paid per piece in USDC.e over Tempo/MPP — no signup, no API key.\",\n data_retention:\n \"mail contents are never stored; only minimal send metadata is logged (destination city/state/zip, type, pages, amount, payer)\",\n payment: paymentInfo(),\n endpoints: {\n send_mail: {\n method: \"POST\",\n path: \"/v1/mail\",\n paid: true,\n body: {\n type: '\"letter\" | \"postcard\" — required',\n to: \"address object { name, line1, line2?, city, state, zip, country? } — required\",\n from: \"address object (optional return address; a default is used otherwise)\",\n file_url: \"string (public PDF URL) — letters: provide this or content_base64\",\n content_base64: \"string (base64 PDF bytes) — letters\",\n file_name: \"string (optional, used with content_base64)\",\n front: \"string (postcards: PDF/PNG URL or inline HTML for the front)\",\n back: \"string (postcards: PDF/PNG URL or inline HTML for the back)\",\n message: \"string (postcards: simple text for the back, if no `back` artwork)\",\n color: \"boolean (letters: color vs B&W, default false)\",\n size: 'string (postcards: \"4x6\" | \"6x9\" | \"6x11\", default \"4x6\")',\n metadata: \"object (optional, echoed back, not stored)\",\n },\n returns: { id: \"string\", type: \"string\", status: \"queued|processing|mailed|delivered|failed\", expected_delivery: \"string|null\" },\n },\n get_mail: { method: \"GET\", path: \"/v1/mail/{id}\", paid: false, note: \"live status from the mail network\" },\n info: { method: \"GET\", path: \"/v1/info\", paid: false },\n },\n example: {\n tempo_cli:\n `tempo request -X POST --json '{\"type\":\"letter\",\"to\":{\"name\":\"Jane Doe\",\"line1\":\"210 King St\",\"city\":\"San Francisco\",\"state\":\"CA\",\"zip\":\"94107\"},\"file_url\":\"https://example.com/letter.pdf\"}' ${base}/v1/mail`,\n curl:\n `curl -X POST ${base}/v1/mail -H 'content-type: application/json' -d '{\"type\":\"postcard\",\"to\":{\"name\":\"Jane Doe\",\"line1\":\"210 King St\",\"city\":\"San Francisco\",\"state\":\"CA\",\"zip\":\"94107\"},\"message\":\"Hello from my agent!\"}'`,\n note:\n \"Without payment this returns HTTP 402 with an MPP 'Payment' challenge. The Tempo CLI (or any MPP client) pays in USDC.e and retries automatically.\",\n },\n };\n}\napp.get(\"/v1/info\", (c) => c.json(manifest(origin(c))));\n\n// MPP discovery document (OpenAPI 3.1 + x-payment-info / x-service-info) so\n// registries like MPPScan can index the service.\napp.get(\"/openapi.json\", (c) => {\n const base = origin(c);\n return c.json({\n openapi: \"3.1.0\",\n info: {\n title: \"agentsnailmail\",\n version: \"1.0.0\",\n description:\n \"Pay-per-piece API for AI agents to send real, physical mail — letters & postcards to any address, priced per piece in USDC.e over Tempo/MPP.\",\n \"x-guidance\":\n \"Send physical mail by POSTing to /v1/mail with `type` (\\\"letter\\\" or \\\"postcard\\\"), a `to` address object ({name, line1, city, state, zip}), and content: letters need `file_url` (a public PDF URL) or `content_base64`; postcards need `front` artwork and a `back`/`message`. Pricing is per piece in USDC.e on Tempo via MPP: letters are a base fee + per page, postcards a flat rate. An unpaid request returns HTTP 402 with a payment challenge — pay it with any MPP client (e.g. `tempo request`) and retry the same request. The mail contents are forwarded to the print/mail network and never stored. Poll GET /v1/mail/{id} for live delivery status.\",\n },\n servers: [{ url: base }],\n \"x-service-info\": {\n name: \"agentsnailmail\",\n description:\n \"Send real, physical mail (letters & postcards) to any address, priced per piece in USDC.e over Tempo/MPP. No signup, no API key; mail contents are never stored.\",\n categories: [\"social\"],\n tags: [\"mail\", \"snail-mail\", \"letters\", \"postcards\", \"agents\", \"tempo\", \"mpp\", \"lob\"],\n docs: { homepage: base, apiReference: `${base}/v1/info`, llms: `${base}/llms.txt` },\n },\n paths: {\n \"/v1/mail\": {\n post: {\n summary: \"Send physical mail\",\n description: \"Send a real letter or postcard to a mailing address, priced per piece. Pay with MPP (USDC.e on Tempo).\",\n requestBody: {\n required: true,\n content: {\n \"application/json\": {\n schema: {\n type: \"object\",\n required: [\"type\", \"to\"],\n properties: {\n type: { type: \"string\", enum: [\"letter\", \"postcard\"], description: \"What to send\" },\n to: {\n type: \"object\",\n description: \"Recipient mailing address\",\n required: [\"name\", \"line1\", \"city\", \"state\", \"zip\"],\n properties: {\n name: { type: \"string\" },\n line1: { type: \"string\" },\n line2: { type: \"string\" },\n city: { type: \"string\" },\n state: { type: \"string\", description: \"2-letter state/province\" },\n zip: { type: \"string\" },\n country: { type: \"string\", description: \"ISO-2, default US\" },\n },\n },\n from: { type: \"object\", description: \"Optional return address (same shape as `to`)\" },\n file_url: { type: \"string\", description: \"Letters: public URL to a PDF (provide this or content_base64)\" },\n content_base64: { type: \"string\", description: \"Letters: base64-encoded PDF bytes\" },\n front: { type: \"string\", description: \"Postcards: front artwork (PDF/PNG URL or HTML)\" },\n back: { type: \"string\", description: \"Postcards: back artwork (PDF/PNG URL or HTML)\" },\n message: { type: \"string\", description: \"Postcards: simple back message if no `back` artwork\" },\n color: { type: \"boolean\", description: \"Letters: color vs B&W (default false)\" },\n size: { type: \"string\", description: 'Postcards: \"4x6\" | \"6x9\" | \"6x11\" (default 4x6)' },\n metadata: { type: \"object\", description: \"Optional, echoed back in the response\" },\n },\n },\n },\n },\n },\n \"x-payment-info\": {\n price: {\n mode: \"dynamic\",\n currency: \"USD\",\n min: amountForMail(\"postcard\", 1),\n max: amountForMail(\"letter\", 100),\n unit: \"piece\",\n },\n protocols: [{\n mpp: {\n method: \"tempo\",\n network: \"tempo\",\n chainId: 4217,\n asset: USDC_E.address,\n amount: String(Math.round((baseFeeUsd() + perPageUsd()) * 1e6)),\n recipient: recipient(),\n },\n }],\n offers: [{\n method: \"tempo\",\n intent: \"charge\",\n currency: USDC_E.address,\n amount: String(Math.round((baseFeeUsd() + perPageUsd()) * 1e6)),\n description:\n `Letters: $${baseFeeUsd().toFixed(2)} base + $${perPageUsd().toFixed(2)}/page. Postcards: flat $${\n postcardUsd().toFixed(2)\n }. In ${USDC_E.symbol}.`,\n }],\n },\n responses: {\n \"200\": {\n description: \"Mail accepted; returns a job id and live status.\",\n content: {\n \"application/json\": {\n schema: {\n type: \"object\",\n properties: {\n id: { type: \"string\", description: \"Mail job id (use with GET /v1/mail/{id})\" },\n type: { type: \"string\", description: \"letter | postcard\" },\n status: { type: \"string\", description: \"queued | processing | mailed | delivered | failed\" },\n pages: { type: \"integer\", description: \"Number of pages (letters)\" },\n expected_delivery: { type: \"string\", description: \"Estimated delivery date (YYYY-MM-DD)\" },\n price_usd: { type: \"string\", description: \"Total charged, in USD\" },\n },\n },\n },\n },\n },\n \"402\": { description: \"Payment Required — pay the MPP challenge and retry.\" },\n },\n },\n },\n },\n });\n});\n\n// llms.txt — point agents at the manifest so they can self-onboard.\napp.get(\"/llms.txt\", (c) => {\n const base = origin(c);\n return c.text(\n `# agentsnailmail\n\n> A pay-per-piece HTTP API for AI agents to send real, physical mail. Send letters & postcards to any address and pay per piece in USDC.e over Tempo/MPP — no signup, no API key. Mail contents are never stored; only minimal send metadata is logged.\n\n## Docs\n- [Machine-readable manifest](${base}/v1/info): payment terms (network, asset, price, recipient), the request schema, and a ready-to-run example.\n- [Homepage](${base}/): overview and a live payment demo.\n\n## Using it\n- POST ${base}/v1/mail with {\"type\":\"letter\",\"to\":{\"name\":\"Jane Doe\",\"line1\":\"210 King St\",\"city\":\"San Francisco\",\"state\":\"CA\",\"zip\":\"94107\"},\"file_url\":\"https://.../letter.pdf\"}. For a postcard use {\"type\":\"postcard\", ..., \"message\":\"Hi!\"}. An unpaid request returns HTTP 402 with an MPP Payment challenge; pay with the Tempo CLI (\\`tempo request\\`) or any MPP client and retry.\n- GET ${base}/v1/mail/{id}: live delivery status.\n`,\n 200,\n { \"content-type\": \"text/plain; charset=utf-8\" },\n );\n});\n\n// --- Read mail status (free, proxied live — we hold no state) ---------------\napp.get(\"/v1/mail/:id\", async (c) => {\n const id = c.req.param(\"id\");\n const decoded = decodeJobId(id);\n if (!decoded) return c.json({ error: \"bad_id\", id }, 400);\n const s = await getStatus(id).catch(() => null);\n if (!s) return c.json({ error: \"not_found\", id }, 404);\n return c.json({\n id,\n type: decoded.type,\n status: s.status,\n pages: s.pages,\n expected_delivery: s.expectedDelivery ?? null,\n error: s.error ?? null,\n _links: { self: `${origin(c)}/v1/mail/${id}` },\n });\n});\n\n// --- Send mail (paid via Tempo/MPP) -----------------------------------------\napp.post(\"/v1/mail\", chargeMail(), async (c) => {\n let body: Record = {};\n try {\n body = await c.req.json();\n } catch {\n return c.json({ error: \"invalid_json\", message: \"Request body must be JSON.\" }, 400);\n }\n\n const input = toMailInput(body);\n\n const validationError = validateInput(input);\n if (validationError) return c.json({ error: \"invalid_request\", message: validationError }, 400);\n\n const result = await sendMail(input);\n if (!result.jobId && result.status === \"failed\") {\n return c.json({ error: \"provider_error\", message: result.error ?? \"Failed to submit mail.\" }, 502);\n }\n\n const pages = (c.get(\"mailPages\") as number) ?? result.pages;\n const amount = (c.get(\"mailAmount\") as string) ?? null;\n const payer = decodePayer(c.req.header(\"Authorization\"), recipient());\n const created_at = new Date().toISOString();\n\n // Log innocuous metadata only — never the mail contents. Best-effort; never blocks the mailing.\n try {\n await logMail({\n id: result.jobId,\n type: result.type,\n toCity: input.to?.city ?? null,\n toState: input.to?.state ?? null,\n toZip: input.to?.zip ?? null,\n pages,\n amount,\n payer,\n network: \"tempo\",\n provider: result.provider,\n status: result.status,\n created_at,\n });\n } catch (_e) { /* metadata is best-effort */ }\n\n // 🎉 Email the owner that someone paid to send mail. Best-effort; never blocks the mailing.\n try {\n await notifyPaidMail({\n id: result.jobId,\n type: result.type,\n toCity: input.to?.city ?? null,\n toState: input.to?.state ?? null,\n toZip: input.to?.zip ?? null,\n pages,\n amount,\n payer,\n network: \"tempo\",\n provider: result.provider,\n status: result.status,\n expectedDelivery: result.expectedDelivery,\n live: isLive(),\n created_at,\n totals: await mailStats().catch(() => undefined),\n });\n } catch (_e) { /* notification is best-effort */ }\n\n return c.json({\n id: result.jobId,\n type: result.type,\n status: result.status,\n pages,\n expected_delivery: result.expectedDelivery ?? null,\n provider: result.provider,\n live: isLive(),\n price_usd: amount ? `${amount}` : priceLabel(),\n pricing: \"per_piece\",\n error: result.error ?? null,\n metadata: body.metadata ?? undefined,\n created_at,\n _links: { self: `${origin(c)}/v1/mail/${result.jobId}` },\n }, 200);\n});\n\n// Unwrap Hono errors so logs show real stack traces.\napp.onError((err) => Promise.reject(err));\n\nexport default app.fetch;\n",[187],"7ffcd1cc-5ba5-11f1-8826-ee650bb23af1","mail.ts","7ffcd276-5ba5-11f1-8826-ee650bb23af1",2,["D",1780090180006],"// Pluggable print-and-mail backend.\n//\n// The document is never stored — it's forwarded to the print/mail network and\n// dropped; we hand back a job id and read status live from the provider. (A\n// separate metadata log in db.ts records send info only — never the document.)\n//\n// Live: Lob Print & Mail API (https://docs.lob.com). A *live* secret key\n// (live_...) sends real, physical mail. A *test* secret key (test_...) — or no\n// key at all (built-in sandbox) — simulates sending so the full pay -> mail loop\n// is demoable without a Lob account or real postage.\n\nexport type MailStatus = \"queued\" | \"processing\" | \"mailed\" | \"delivered\" | \"failed\";\nexport type Provider = \"lob\" | \"lob_test\" | \"sandbox\";\nexport type MailType = \"letter\" | \"postcard\";\n\nexport interface Address {\n name: string;\n line1: string;\n line2?: string;\n city: string;\n state: string;\n zip: string;\n country?: string; // ISO-2, default \"US\"\n}\n\nexport interface MailInput {\n type: MailType;\n to: Address;\n from?: Address; // optional return address (Lob requires one; we supply a default)\n // Letters: a printable document.\n fileUrl?: string; // public URL to a PDF (preferred — Lob fetches it)\n contentBase64?: string; // base64-encoded PDF bytes\n fileName?: string; // used with contentBase64\n // Postcards: front/back artwork (URL to PDF/PNG or inline HTML).\n front?: string;\n back?: string;\n message?: string; // simple postcard back message (if no `back` artwork)\n color?: boolean; // letters: color vs black & white (default false)\n size?: string; // postcards: \"4x6\" | \"6x9\" | \"6x11\" (default \"4x6\")\n}\n\nexport interface MailSendResult {\n provider: Provider;\n jobId: string; // opaque, provider-namespaced id we hand back to the caller\n type: MailType;\n status: MailStatus;\n pages: number | null;\n expectedDelivery?: string | null;\n error?: string;\n}\n\n// --- Default return address -------------------------------------------------\n// Lob requires a `from` address. Callers may override per-request; otherwise we\n// use MAIL_FROM_* env vars, falling back to a generic placeholder.\nfunction defaultFrom(): Address {\n return {\n name: Deno.env.get(\"MAIL_FROM_NAME\") || \"AgentSnailMail\",\n line1: Deno.env.get(\"MAIL_FROM_LINE1\") || \"210 King St\",\n line2: Deno.env.get(\"MAIL_FROM_LINE2\") || undefined,\n city: Deno.env.get(\"MAIL_FROM_CITY\") || \"San Francisco\",\n state: Deno.env.get(\"MAIL_FROM_STATE\") || \"CA\",\n zip: Deno.env.get(\"MAIL_FROM_ZIP\") || \"94107\",\n country: Deno.env.get(\"MAIL_FROM_COUNTRY\") || \"US\",\n };\n}\n\nfunction lobKey(): string | undefined {\n return Deno.env.get(\"LOB_API_KEY\")?.trim() || undefined;\n}\n\nexport function activeProvider(): Provider {\n const k = lobKey();\n if (!k) return \"sandbox\";\n return k.startsWith(\"live_\") ? \"lob\" : \"lob_test\";\n}\n\n/** True when real, physical mail will be sent (a live_ Lob key is configured). */\nexport function isLive(): boolean {\n return activeProvider() === \"lob\";\n}\n\n// --- Input handling ---------------------------------------------------------\n\nfunction validateAddress(a: Address | undefined, label: string): string | null {\n if (!a || typeof a !== \"object\") return `\\`${label}\\` must be an address object.`;\n if (!a.name?.trim()) return `\\`${label}.name\\` is required.`;\n if (!a.line1?.trim()) return `\\`${label}.line1\\` is required.`;\n if (!a.city?.trim()) return `\\`${label}.city\\` is required.`;\n if (!a.state?.trim()) return `\\`${label}.state\\` is required (2-letter state/province).`;\n if (!a.zip?.trim()) return `\\`${label}.zip\\` is required.`;\n return null;\n}\n\nexport function validateInput(input: MailInput): string | null {\n if (input.type !== \"letter\" && input.type !== \"postcard\") {\n return \"`type` must be either \\\"letter\\\" or \\\"postcard\\\".\";\n }\n const toErr = validateAddress(input.to, \"to\");\n if (toErr) return toErr;\n if (input.from) {\n const fromErr = validateAddress(input.from, \"from\");\n if (fromErr) return fromErr;\n }\n if (input.type === \"letter\") {\n if (!input.fileUrl && !input.contentBase64) {\n return \"Letters need a document via `file_url` (a public PDF URL) or `content_base64`.\";\n }\n if (input.fileUrl && !/^https?:\\/\\//.test(input.fileUrl)) {\n return \"`file_url` must be an http(s) URL.\";\n }\n } else {\n // postcard\n if (!input.front && !input.message) {\n return \"Postcards need `front` artwork (a PDF/PNG URL or HTML) — and a `back` or `message`.\";\n }\n }\n return null;\n}\n\n// --- Job id (provider-namespaced, carries no payload) -----------------------\n\nfunction prefixFor(p: Provider): string {\n return p === \"lob\" ? \"lob\" : p === \"lob_test\" ? \"lbt\" : \"sbx\";\n}\n\nexport function encodeJobId(provider: Provider, type: MailType, providerRef: string): string {\n return `${prefixFor(provider)}_${type === \"postcard\" ? \"pc\" : \"ltr\"}_${providerRef}`;\n}\n\nexport function decodeJobId(id: string): { provider: Provider; type: MailType; ref: string } | null {\n const parts = id.split(\"_\");\n if (parts.length < 3) return null;\n const [prefix, kind, ...rest] = parts;\n const provider: Provider | null = prefix === \"lob\" ? \"lob\" : prefix === \"lbt\" ? \"lob_test\" : prefix === \"sbx\" ? \"sandbox\" : null;\n if (!provider) return null;\n const type: MailType | null = kind === \"pc\" ? \"postcard\" : kind === \"ltr\" ? \"letter\" : null;\n if (!type) return null;\n return { provider, type, ref: rest.join(\"_\") };\n}\n\n// --- Send -------------------------------------------------------------------\n\nexport async function sendMail(input: MailInput): Promise {\n return activeProvider() === \"sandbox\" ? sendViaSandbox(input) : sendViaLob(input);\n}\n\n/** Live status lookup — no local state. */\nexport async function getStatus(\n jobId: string,\n): Promise<{ status: MailStatus; pages: number | null; expectedDelivery?: string | null; error?: string } | null> {\n const decoded = decodeJobId(jobId);\n if (!decoded) return null;\n return decoded.provider === \"sandbox\" ? sandboxStatus(decoded.ref) : lobStatus(decoded.type, decoded.ref);\n}\n\n// --- Lob Print & Mail API ---------------------------------------------------\n\nconst LOB_BASE = \"https://api.lob.com/v1\";\n\nfunction lobAuthHeader(): string {\n // Basic auth: API key as username, blank password.\n return \"Basic \" + btoa(`${lobKey()}:`);\n}\n\nfunction lobAddress(a: Address): Record {\n return {\n name: a.name,\n address_line1: a.line1,\n ...(a.line2 ? { address_line2: a.line2 } : {}),\n address_city: a.city,\n address_state: a.state,\n address_zip: a.zip,\n address_country: a.country || \"US\",\n };\n}\n\nasync function sendViaLob(input: MailInput): Promise {\n const provider = activeProvider(); // \"lob\" or \"lob_test\"\n const from = input.from ?? defaultFrom();\n const form = new FormData();\n\n // Addresses (inline objects via bracketed form fields).\n for (const [k, v] of Object.entries(lobAddress(input.to))) form.append(`to[${k}]`, v);\n for (const [k, v] of Object.entries(lobAddress(from))) form.append(`from[${k}]`, v);\n\n let endpoint: string;\n if (input.type === \"letter\") {\n endpoint = `${LOB_BASE}/letters`;\n form.append(\"color\", String(!!input.color));\n form.append(\"address_placement\", \"top_first_page\");\n if (input.fileUrl) {\n form.append(\"file\", input.fileUrl);\n } else if (input.contentBase64) {\n const blob = new Blob([base64ToBytes(input.contentBase64)], { type: \"application/pdf\" });\n form.append(\"file\", blob, input.fileName || \"letter.pdf\");\n }\n } else {\n endpoint = `${LOB_BASE}/postcards`;\n form.append(\"size\", input.size || \"4x6\");\n form.append(\"front\", input.front || \"Hello!\");\n form.append(\n \"back\",\n input.back || `${escapeHtml(input.message || \"\")}`,\n );\n }\n\n let res: Response;\n try {\n res = await fetch(endpoint, {\n method: \"POST\",\n headers: { Authorization: lobAuthHeader() },\n body: form,\n });\n } catch (e) {\n return { provider, jobId: \"\", type: input.type, status: \"failed\", pages: null, error: String((e as Error).message) };\n }\n\n const j = await res.json().catch(() => ({} as any));\n if (!res.ok || !j?.id) {\n return {\n provider,\n jobId: \"\",\n type: input.type,\n status: \"failed\",\n pages: null,\n error: j?.error?.message || `Lob error (HTTP ${res.status})`,\n };\n }\n return {\n provider,\n jobId: encodeJobId(provider, input.type, String(j.id)),\n type: input.type,\n status: mapLobStatus(j),\n pages: typeof j.pages === \"number\" ? j.pages : input.type === \"postcard\" ? 1 : null,\n expectedDelivery: j.expected_delivery_date ?? null,\n };\n}\n\nasync function lobStatus(\n type: MailType,\n ref: string,\n): Promise<{ status: MailStatus; pages: number | null; expectedDelivery?: string | null; error?: string }> {\n const path = type === \"postcard\" ? \"postcards\" : \"letters\";\n const res = await fetch(`${LOB_BASE}/${path}/${encodeURIComponent(ref)}`, {\n headers: { Authorization: lobAuthHeader() },\n });\n const j = await res.json().catch(() => ({} as any));\n return {\n status: mapLobStatus(j),\n pages: typeof j?.pages === \"number\" ? j.pages : null,\n expectedDelivery: j?.expected_delivery_date ?? null,\n error: j?.error?.message || undefined,\n };\n}\n\n// Lob tracking events drive real status; on create the object has no events yet.\n// We derive a coarse status from the latest tracking event name when present.\nexport function mapLobStatus(j: any): MailStatus {\n const events: any[] = Array.isArray(j?.tracking_events) ? j.tracking_events : [];\n const latest = events.length ? String(events[events.length - 1].name || \"\").toLowerCase() : \"\";\n if (latest.includes(\"delivered\")) return \"delivered\";\n if (latest.includes(\"returned\") || latest.includes(\"failed\")) return \"failed\";\n if (latest.includes(\"in_transit\") || latest.includes(\"in_local_area\") || latest.includes(\"processed\")) return \"mailed\";\n if (latest.includes(\"mailed\")) return \"mailed\";\n // No events yet: it's been accepted and is being produced.\n return j?.id ? \"processing\" : \"queued\";\n}\n\n// --- Sandbox (stateless: outcome is encoded in the job ref) -----------------\n// A \"to\" zip of 00000 simulates a failure, so the failure path is demoable.\n\nfunction sendViaSandbox(input: MailInput): MailSendResult {\n const willFail = (input.to.zip || \"\").trim() === \"00000\";\n const status: MailStatus = willFail ? \"failed\" : \"processing\";\n const ref = `${status}.${crypto.randomUUID().slice(0, 8)}`;\n const expected = new Date(Date.now() + 5 * 86400_000).toISOString().slice(0, 10);\n return {\n provider: \"sandbox\",\n jobId: encodeJobId(\"sandbox\", input.type, ref),\n type: input.type,\n status,\n pages: input.type === \"postcard\" ? 1 : (status === \"failed\" ? null : 1),\n expectedDelivery: willFail ? null : expected,\n error: willFail ? \"undeliverable_address (simulated)\" : undefined,\n };\n}\n\nfunction sandboxStatus(ref: string): { status: MailStatus; pages: number | null; expectedDelivery?: string | null; error?: string } {\n const status = (ref.split(\".\")[0] as MailStatus) || \"processing\";\n const expected = new Date(Date.now() + 5 * 86400_000).toISOString().slice(0, 10);\n return {\n status,\n pages: status === \"failed\" ? null : 1,\n expectedDelivery: status === \"failed\" ? null : expected,\n error: status === \"failed\" ? \"undeliverable_address (simulated)\" : undefined,\n };\n}\n\n// --- helpers ----------------------------------------------------------------\n\nfunction escapeHtml(s: string): string {\n return s.replace(/&/g, \"&\").replace(//g, \">\");\n}\n\nfunction base64ToBytes(b64: string): Uint8Array {\n const bin = atob(b64.replace(/^data:.*;base64,/, \"\"));\n const out = new Uint8Array(bin.length);\n for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);\n return out;\n}\n",[195],"981ae44c-5ba5-11f1-9682-ee650bb23af1","db.ts","019e75a2-f04c-7499-b28f-50026d0c1ed3",4,["D",1780090220450],"// Minimal metadata log — NEVER the document content. We record only innocuous\n// send metadata (destination city/state/zip, mail type, pages, amount, paying\n// wallet) so we can show a running total and basic analytics. The mail payload\n// (the actual letter/postcard contents) is never persisted.\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\n\nconst TABLE = \"mail_log_v1\";\n\nlet ready: Promise | null = null;\nfunction init(): Promise {\n ready ??= sqlite\n .execute(`CREATE TABLE IF NOT EXISTS ${TABLE} (\n id TEXT PRIMARY KEY,\n mail_type TEXT,\n to_city TEXT,\n to_state TEXT,\n to_zip TEXT,\n pages INTEGER,\n amount_usd TEXT,\n payer TEXT,\n network TEXT,\n provider TEXT,\n status TEXT,\n created_at TEXT NOT NULL\n )`)\n .then(() => undefined);\n return ready;\n}\n\nexport interface MailLog {\n id: string;\n type: string;\n toCity: string | null;\n toState: string | null;\n toZip: string | null;\n pages: number | null;\n amount: string | null;\n payer: string | null;\n network: string;\n provider: string;\n status: string;\n created_at: string;\n}\n\nexport interface MailStats {\n pieces: number;\n pages: number;\n paidUsd: number;\n /** Cumulative pieces over time (oldest→newest), for a sparkline. */\n series: number[];\n}\n\nexport async function logMail(rec: MailLog): Promise {\n await init();\n await sqlite.execute({\n sql: `INSERT OR REPLACE INTO ${TABLE}\n (id, mail_type, to_city, to_state, to_zip, pages, amount_usd, payer, network, provider, status, created_at)\n VALUES (?,?,?,?,?,?,?,?,?,?,?,?)`,\n args: [\n rec.id,\n rec.type,\n rec.toCity,\n rec.toState,\n rec.toZip,\n rec.pages,\n rec.amount,\n rec.payer,\n rec.network,\n rec.provider,\n rec.status,\n rec.created_at,\n ],\n });\n}\n\n// Downsample a series to at most `max` points so the sparkline stays light as\n// the log grows. Always keeps the last point (the current total).\nfunction downsample(values: number[], max: number): number[] {\n if (values.length <= max) return values;\n const step = (values.length - 1) / (max - 1);\n return Array.from({ length: max }, (_, i) => values[Math.round(i * step)]);\n}\n\nexport async function mailStats(): Promise {\n await init();\n const { rows } = await sqlite.execute(\n `SELECT pages, amount_usd FROM ${TABLE} ORDER BY created_at ASC LIMIT 1000`,\n );\n let pages = 0;\n let paidUsd = 0;\n const series: number[] = [];\n let count = 0;\n for (const row of rows as unknown as { pages: number | null; amount_usd: string | null }[]) {\n pages += Number(row.pages ?? 0);\n paidUsd += Number.parseFloat(row.amount_usd ?? \"\") || 0;\n count += 1;\n series.push(count);\n }\n return { pieces: rows.length, pages, paidUsd, series: downsample(series, 48) };\n}\n\n// Page-load wrapper: race the query against a hard timeout so a slow/unavailable\n// DB never blocks the landing page. Returns null on timeout, error, or no data —\n// the caller drops the stats widget entirely in that case.\nexport async function mailStatsSafe(timeoutMs = 500): Promise {\n let timer: number | undefined;\n const stats = await Promise.race([\n mailStats().catch(() => null),\n new Promise((resolve) => {\n timer = setTimeout(() => resolve(null), timeoutMs);\n }),\n ]);\n clearTimeout(timer);\n if (!stats || stats.pieces === 0) return null;\n return stats;\n}\n",[202],"405007e2-5ba5-11f1-b599-ee650bb23af1","README.md","019e75a2-f04c-7499-b28f-4f9f137955ed",["D",1780090073094],"# agentfax\n\nA fax API for AI agents — **paid per page over [Tempo/MPP](https://mpp.dev) (USDC.e)**. No signup, no\nAPI key, no dashboard. An agent calls one endpoint, gets a `402 Payment Required` with an MPP `Payment`\nchallenge, pays in USDC.e on Tempo, and the fax goes out. It's \"AgentMail, but for faxes.\"\n\nPay it in one line with the Tempo CLI:\n\n```bash\ntempo request -X POST --json '{\"to\":\"+14155550123\",\"file_url\":\"https://example.com/doc.pdf\"}' \\\n https://agentfax.val.run/v1/fax\n```\n\n## Why it's interesting\n\n- **Permissionless monetization.** No marketplace to apply to. You stand up an HTTP endpoint that\n returns a 402 `WWW-Authenticate: Payment` challenge pointing at your wallet; any MPP client pays it.\n- **No facilitator, no keys to babysit.** `mppx` verifies and settles the payment directly against the\n Tempo chain — there's no payment processor in the middle.\n- **Per-page pricing.** On the unpaid request we count the PDF's pages and price the charge as\n pages × rate, so the 402 tells the agent the exact cost up front.\n- **Documents are never stored.** The file is forwarded to the fax network and dropped — it never\n touches our database. We keep only a minimal send-metadata log (destination, pages, amount, payer).\n- **Pluggable fax backend.** Real faxing via the [Sinch Fax API v3](https://developers.sinch.com/docs/fax/)\n when keys are set; otherwise a **sandbox** that simulates sending, so the whole pay→fax loop works with\n no fax account.\n\n## Endpoints\n\n| Method | Path | Paid | Description |\n|--------|------|------|-------------|\n| `POST` | `/v1/fax` | ✅ MPP | Send a fax. Returns `402` (MPP `Payment` challenge) until paid, then a job id. |\n| `GET` | `/v1/fax/{id}` | free | Live delivery status (proxied from the carrier). |\n| `GET` | `/v1/info` | free | Machine-readable manifest (price, network, recipient, schema, example). |\n| `GET` | `/openapi.json` | free | MPP discovery document (for registries like MPPScan). |\n| `GET` | `/llms.txt` | free | Pointer file so an agent can self-onboard. |\n| `GET` | `/og.png` | free | Social card image. |\n\n### Send a fax\n\n`to` is required (E.164). Provide the document as either `file_url` (a public PDF URL) or\n`content_base64` (+ optional `file_name`). `metadata` is optional and echoed back.\n\nUnpaid, `POST /v1/fax` returns `402` with a `WWW-Authenticate: Payment` header. The Tempo CLI (or any\nMPP client) reads it, signs the USDC.e payment, and retries automatically.\n\n## Payments\n\n- **Rail:** MPP (the open `Payment` HTTP-auth scheme) on **Tempo mainnet** (chain id 4217).\n- **Asset:** USDC.e — `0x20C000000000000000000000b9537d11c60E8b50` (6 decimals).\n- **Price:** per page (`FAX_PRICE_PER_PAGE`, default `$0.20`).\n- **Settlement:** verified directly against the Tempo RPC by `mppx` — no facilitator.\n- **You get paid** at `TEMPO_RECIPIENT` (your Tempo wallet).\n- **x402 (Coinbase / Circle) is parked** in the codebase (`payment.ts`); re-enable it with a valid CDP\n facilitator key to also accept Base USDC agents.\n\n## What we store\n\nThe document itself is **never stored**. We keep a minimal SQLite metadata log (`db.ts`) — destination,\npage count, amount, paying wallet, status, timestamp — for a running total. No document content, ever.\n\n## Configuration\n\nSensible defaults; for production set your Sinch keys and Tempo recipient.\n\n| Env var | Default | Purpose |\n|---------|---------|---------|\n| `TEMPO_RECIPIENT` | a demo wallet | Tempo address that **receives** the USDC.e. |\n| `MPP_SECRET_KEY` | (set) | Server HMAC secret binding challenges to credentials. |\n| `MPP_SIGNER_KEY` | (set) | Server signer `mppx` requires (session settlement; unused by one-shot charge). |\n| `FAX_PRICE_PER_PAGE` | `0.20` | Price per page, in USD. |\n| `SINCH_KEY_ID` / `SINCH_KEY_SECRET` | unset → sandbox | Sinch Fax access key (OAuth2) for real faxing. |\n| `SINCH_PROJECT_ID` | unset → sandbox | Sinch project the Fax API is scoped to. |\n| `SINCH_FROM` | unset | Optional sender fax number. |\n\n### Go live (real faxes)\n\n1. **Fund your Tempo wallet** with a little USDC.e (`tempo wallet fund`).\n2. **Add your Sinch Fax credentials** (from dashboard.sinch.com — Access Keys + Project ID):\n\n 👉 Add SINCH_KEY_ID here: https://www.val.town/x/stevekrouse/agentfax/environment-variables?key=SINCH_KEY_ID\n\n 👉 Add SINCH_KEY_SECRET here: https://www.val.town/x/stevekrouse/agentfax/environment-variables?key=SINCH_KEY_SECRET\n\n 👉 Add SINCH_PROJECT_ID here: https://www.val.town/x/stevekrouse/agentfax/environment-variables?key=SINCH_PROJECT_ID\n\n## Files\n\n- `main.ts` — Hono server: routes, MPP payment gate, SSR landing page, metadata logging.\n- `mpp.ts` — Tempo/MPP rail via `mppx` (mainnet, USDC.e), per-page pricing, `paymentInfo()`.\n- `fax.ts` — fax backend (Sinch Fax v3 + sandbox), job-id codec, live status.\n- `db.ts` — minimal metadata log (never the document content).\n- `og.ts` — Open Graph / Twitter card image.\n- `payment.ts` — parked x402 rail (re-enable with a CDP key).\n- `frontend/` — SSR React + Twind landing page.\n\nBuilt on [Val Town](https://val.town). Faxes via [Sinch](https://developers.sinch.com/docs/fax/). Payments via [Tempo/MPP](https://mpp.dev).\n",[209],"405006a2-5ba5-11f1-b599-ee650bb23af1","frontend","019e75a2-f04c-7499-b28f-4ab4005ebedc",["D",1780090073094],"directory",[215],"pulls","branches","forks","envVars",{"_227":229,"_230":229},"connections",{"_227":67,"_228":67},"count","unfilledCount",12,"emptyCount",{"_49":214,"_38":215,"_36":216,"_162":-5,"_47":48,"_46":163,"_164":135,"_44":351,"_13":67,"_39":218,"_41":-5,"_30":31,"_167":-5,"_251":352,"_33":353},{"_49":347,"_38":315,"_36":309,"_162":216,"_47":48,"_46":163,"_164":135,"_44":348,"_13":67,"_39":218,"_41":-5,"_30":31,"_167":-5,"_251":349,"_33":350},{"_49":340,"_38":341,"_36":342,"_162":309,"_47":48,"_46":229,"_164":135,"_44":343,"_13":163,"_39":40,"_41":344,"_30":31,"_167":-5,"_251":345,"_33":346},{"_49":332,"_38":333,"_36":334,"_162":309,"_47":48,"_46":335,"_164":135,"_44":336,"_13":163,"_39":40,"_41":337,"_30":31,"_167":-5,"_251":338,"_33":339},{"_49":324,"_38":325,"_36":326,"_162":309,"_47":48,"_46":327,"_164":135,"_44":328,"_13":163,"_39":40,"_41":329,"_30":31,"_167":-5,"_251":330,"_33":331},{"_49":316,"_38":317,"_36":318,"_162":309,"_47":48,"_46":319,"_164":135,"_44":320,"_13":163,"_39":40,"_41":321,"_30":31,"_167":-5,"_251":322,"_33":323},{"_49":306,"_38":307,"_36":308,"_162":309,"_47":48,"_46":310,"_164":135,"_44":311,"_13":163,"_39":40,"_41":312,"_30":31,"_167":-5,"_251":313,"_33":314},{"_49":298,"_38":299,"_36":300,"_162":216,"_47":48,"_46":301,"_164":135,"_44":302,"_13":163,"_39":40,"_41":303,"_30":31,"_167":-5,"_251":304,"_33":305},{"_49":290,"_38":291,"_36":292,"_162":216,"_47":48,"_46":293,"_164":135,"_44":294,"_13":163,"_39":40,"_41":295,"_30":31,"_167":-5,"_251":296,"_33":297},{"_49":283,"_38":284,"_36":285,"_162":216,"_47":48,"_46":163,"_164":135,"_44":286,"_13":67,"_39":26,"_41":287,"_30":31,"_167":-5,"_251":288,"_33":289},{"_49":275,"_38":276,"_36":277,"_162":216,"_47":48,"_46":278,"_164":135,"_44":279,"_13":163,"_39":40,"_41":280,"_30":31,"_167":-5,"_251":281,"_33":282},{"_49":208,"_38":209,"_36":210,"_162":-5,"_47":48,"_46":163,"_164":135,"_44":272,"_13":67,"_39":26,"_41":212,"_30":31,"_167":-5,"_251":273,"_33":274},{"_49":201,"_38":202,"_36":203,"_162":-5,"_47":48,"_46":204,"_164":135,"_44":269,"_13":163,"_39":40,"_41":206,"_30":31,"_167":-5,"_251":270,"_33":271},{"_49":194,"_38":195,"_36":196,"_162":-5,"_47":48,"_46":197,"_164":135,"_44":266,"_13":67,"_39":40,"_41":199,"_30":31,"_167":-5,"_251":267,"_33":268},{"_49":186,"_38":187,"_36":188,"_162":-5,"_47":48,"_46":189,"_164":135,"_44":263,"_13":163,"_39":191,"_41":192,"_30":31,"_167":-5,"_251":264,"_33":265},{"_49":182,"_38":34,"_36":37,"_162":-5,"_47":48,"_46":14,"_164":135,"_44":260,"_13":184,"_39":40,"_41":43,"_30":31,"_167":-5,"_251":261,"_33":262},{"_49":175,"_38":176,"_36":177,"_162":-5,"_47":48,"_46":178,"_164":135,"_44":257,"_13":163,"_39":40,"_41":180,"_30":31,"_167":-5,"_251":258,"_33":259},{"_49":169,"_38":170,"_36":171,"_162":-5,"_47":48,"_46":163,"_164":135,"_44":254,"_13":67,"_39":40,"_41":173,"_30":31,"_167":-5,"_251":255,"_33":256},{"_49":159,"_38":160,"_36":161,"_162":-5,"_47":48,"_46":163,"_164":135,"_44":250,"_13":67,"_39":40,"_41":166,"_30":31,"_167":-5,"_251":252,"_33":253},["D",1780090073094],"children",[],[160],["D",1780090073094],[],[170],["D",1780090232290],[],[176],["D",1780090450347],[],[34],["D",1780090292498],[],[187],["D",1780090180006],[],[195],["D",1780090220450],[],[202],["D",1780090073094],[],[209],"0b986ffc-5ba6-11f1-911a-ee650bb23af1","render.tsx","019e75a2-f04c-7499-b28f-4488837e553b",15,["D",1780090414225],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n// Server-side render of the landing page. Per Val Town's React SSR quirk we\n// import react-dom/server from esm.sh with a pinned `?deps` to avoid the\n// \"ReactCurrentDispatcher\" mismatch that `npm:` imports trigger.\nimport { renderToString } from \"https://esm.sh/react-dom@18.2.0/server?deps=react@18.2.0\";\nimport { App, type PageData } from \"./App.tsx\";\n\nexport function renderPage(data: PageData): string {\n const body = renderToString();\n const desc = \"Have an AI agent send real, physical mail — letters & postcards. Pay per piece in USDC.e over Tempo/MPP, no signup, no API key.\";\n return `\n\n \n \n \n agentsnailmail — a snail mail API for AI agents\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n

${body}

\n \n \n \n`;\n}\n",[],[215,276],"404ff7ac-5ba5-11f1-b599-ee650bb23af1","favicon.svg","019e75a2-f04c-7499-b28f-421f4310be91",["D",1780090073094],"\n",[],[215,284],"05ab907e-5ba6-11f1-b079-ee650bb23af1","demo.js","019e75a2-f04c-7499-b28f-3ccd15cc430d",14,["D",1780090404243],"// Minimal client JS: fire a real POST /v1/mail with no payment and show the\n// response (the 402 challenge in MPP mode, or a simulated mailing in sandbox).\nconst btn = document.getElementById(\"try-btn\");\nconst out = document.getElementById(\"try-out\");\n\nbtn?.addEventListener(\"click\", async () => {\n const label = btn.textContent;\n btn.disabled = true;\n btn.textContent = \"Calling…\";\n out.className = \"text-neutral-200\";\n out.textContent = \"\";\n try {\n const res = await fetch(\"/v1/mail\", {\n method: \"POST\",\n headers: { \"content-type\": \"application/json\" },\n body: JSON.stringify({\n type: \"postcard\",\n to: {\n name: \"Jane Doe\",\n line1: \"210 King St\",\n city: \"San Francisco\",\n state: \"CA\",\n zip: \"94107\",\n },\n message: \"Hello from my agent!\",\n }),\n });\n const text = await res.text();\n let pretty = text;\n try {\n pretty = JSON.stringify(JSON.parse(text), null, 2);\n } catch (_) { /* leave as text */ }\n out.textContent = `HTTP ${res.status} ${res.statusText}\\n\\n${pretty}`;\n } catch (e) {\n out.textContent = \"Error: \" + (e && e.message ? e.message : String(e));\n } finally {\n btn.disabled = false;\n btn.textContent = label;\n }\n});\n\n// \"Copy prompt for your agent\" — copy the onboarding prompt to the clipboard.\nconst copyBtn = document.getElementById(\"copy-prompt\");\ncopyBtn?.addEventListener(\"click\", async () => {\n const text = copyBtn.dataset.prompt || \"\";\n const orig = copyBtn.textContent;\n try {\n await navigator.clipboard.writeText(text);\n } catch (_) {\n const ta = document.createElement(\"textarea\");\n ta.value = text;\n document.body.appendChild(ta);\n ta.select();\n try { document.execCommand(\"copy\"); } catch (e) { /* ignore */ }\n document.body.removeChild(ta);\n }\n copyBtn.textContent = \"Copied — paste it to your agent\";\n setTimeout(() => { copyBtn.textContent = orig; }, 2200);\n});\n",[],[215,291],"c9044d64-5ba5-11f1-8c63-ee650bb23af1","App.tsx","019e75a2-f04c-7499-b28f-39887cfea8af",8,["D",1780090302521],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { type Cfg } from \"./components/ui.tsx\";\nimport { Hero } from \"./components/Hero.tsx\";\nimport { Api } from \"./components/Api.tsx\";\nimport { Footer, HowItWorks, Networks, Privacy, Shingle, TryIt } from \"./components/Sections.tsx\";\nimport { type MailStats } from \"../db.ts\";\n\nexport interface PageData {\n baseUrl: string;\n payment: {\n network: string;\n price: string;\n payTo: string;\n facilitator: string;\n mode: string;\n asset: { symbol: string; address: string | null; decimals: number };\n };\n provider: \"lob\" | \"lob_test\" | \"sandbox\";\n live: boolean;\n price: string;\n stats: MailStats | null;\n}\n\nexport function App(data: PageData) {\n const cfg: Cfg = {\n baseUrl: data.baseUrl,\n network: data.payment.network,\n price: data.payment.price,\n assetSymbol: data.payment.asset.symbol,\n assetAddress: data.payment.asset.address,\n payTo: data.payment.payTo,\n facilitator: data.payment.facilitator,\n provider: data.provider,\n live: data.live,\n mode: data.payment.mode,\n };\n\n return (\n

\n \n \n \n \n \n \n \n

\n );\n}\n",[],[215,299],"d0afce08-5ba5-11f1-b511-ee650bb23af1","ui.tsx","019e75a2-f04c-7499-b28f-3239b8544638","019e75a2-f04c-7499-b28f-343b07dbc4f9",9,["D",1780090315397],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n// Shared presentational primitives. Server-rendered; no client JS.\n\nexport interface Cfg {\n baseUrl: string;\n network: string;\n price: string;\n assetSymbol: string;\n assetAddress: string | null;\n payTo: string;\n facilitator: string;\n provider: \"lob\" | \"lob_test\" | \"sandbox\";\n live: boolean;\n mode: string;\n}\n\nexport function Section(\n { id, className = \"\", children }: { id?: string; className?: string; children: any },\n) {\n return (\n

\n {children}\n

\n );\n}\n\nexport function Eyebrow({ children }: { children: any }) {\n return (\n

\n {children}\n

\n );\n}\n\nconst TONES: Record = {\n neutral: \"bg-neutral-800/80 text-neutral-300 border-neutral-700\",\n green: \"bg-emerald-500/10 text-emerald-300 border-emerald-500/30\",\n amber: \"bg-amber-500/10 text-amber-300 border-amber-500/30\",\n blue: \"bg-sky-500/10 text-sky-300 border-sky-500/30\",\n};\n\nexport function Pill({ tone = \"neutral\", children }: { tone?: string; children: any }) {\n return (\n \n {children}\n \n );\n}\n\nexport function Card({ className = \"\", children }: { className?: string; children: any }) {\n return (\n

\n {children}\n

\n );\n}\n\nexport function CodeBlock(\n { label, children }: { label?: string; children: any },\n) {\n return (\n

\n {label\n ? (\n

\n {label}\n

\n )\n : null}\n

\n        {children}\n

\n );\n}\n\nexport function Mono({ children }: { children: any }) {\n return {children};\n}\n",[],[215,315,307],"components","dd800242-5ba5-11f1-b332-ee650bb23af1","Stats.tsx","019e75a2-f04c-7499-b28f-2d0cdd6807b5",10,["D",1780090336887],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n// Small, friendly one-line \"public business\" ticker for under the hero CTA:\n// pieces mailed · revenue · profit · how long we've been live, plus a tiny\n// growth sparkline. All server-rendered, no client JS. The sparkline is a plain\n// SSR

\n \n \n \n \n \n We've mailed {pieces} for{\" \"}\n {usd(stats.paidUsd)}{\" \"}\n ({usd(profit)} profit){\" \"}\n since launching {timeAgo(LAUNCHED_AT)}\n \n \n

\n );\n}\n",[],[215,315,317],"ffa534aa-5ba5-11f1-b079-ee650bb23af1","Sections.tsx","019e75a2-f04c-7499-b28f-2a39915d4026",13,["D",1780090394176],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport {\n Card,\n type Cfg,\n CodeBlock,\n Eyebrow,\n Mono,\n Pill,\n Section,\n} from \"./ui.tsx\";\n\nexport function HowItWorks() {\n const steps = [\n {\n n: \"01\",\n t: \"Ask\",\n d: \"Your agent POSTs a recipient address and a letter document (or postcard artwork) to /v1/mail. With no payment attached, it gets back HTTP 402 — exactly what to pay and where.\",\n },\n {\n n: \"02\",\n t: \"Pay\",\n d: \"The agent's wallet pays and retries with an Authorization: Payment header. We verify the payment on-chain — no facilitator, no keys.\",\n },\n {\n n: \"03\",\n t: \"Mail\",\n d: \"We print it and hand it to the postal network, return a job id, and drop the payload. Poll /v1/mail/{id} for status.\",\n },\n ];\n return (\n

\n How it works\n

\n Ask → pay → mail, in one request loop.\n

\n {steps.map((s) => (\n \n

{s.n}

{s.t}

{s.d}

\n \n ))}\n

\n );\n}\n\nexport function Networks() {\n return (\n

\n Payments\n

\n Pay from any MPP client.\n

\n Paid in USDC.e on Tempo mainnet, verified on-chain — no facilitator, no\n keys. tempo request pays in one line, and any MPP-aware\n agent can pay with no SDK lock-in.\n

\n );\n}\n\nexport function Shingle() {\n return (\n

\n Want to hang a shingle?\n

\n Start making money by accepting payments on Tempo MPP.\n

\n Immediately — no marketplace, no approval. This app is open source and\n runs on Val Town.\n

\n \n Remix on Val Town\n \n \n Read the source\n \n

\n );\n}\n\nexport function Privacy({ stats }: { stats: { pieces: number; pages: number } | null }) {\n return (\n

\n \n What we store\n

\n Your mail contents are never stored.\n

\n The letter or postcard goes straight to the print/mail network and is dropped — it never touches our database.\n We keep only minimal send metadata: destination city/state/zip, page count, amount, and the paying wallet.\n {stats && stats.pieces > 0\n ? ` So far we've mailed ${stats.pieces.toLocaleString()} piece${stats.pieces === 1 ? \"\" : \"s\"} (${stats.pages.toLocaleString()} page${stats.pages === 1 ? \"\" : \"s\"}).`\n : \"\"}\n

\n contents never stored\n metadata only\n on-chain settlement\n

\n \n

\n );\n}\n\nexport function TryIt({ cfg }: { cfg: Cfg }) {\n return (\n

\n Try it\n

\n See the 402 challenge live.\n

\n Send a real request with no payment attached and see the exact 402 an\n agent would get.\n

\n \n Send a test request\n \n \n \n {`// press the button to call ${cfg.baseUrl}/v1/mail`}\n \n \n

\n {cfg.live\n ? \"This instance is live — paid requests print and mail real, physical pieces via Lob.\"\n : \"This instance runs in sandbox mode — paid requests simulate the full pay→mail loop without printing real mail. Add a Lob key to go live.\"}\n

\n );\n}\n\nexport function Footer({ cfg }: { cfg: Cfg }) {\n return (\n \n );\n}\n",[],[215,315,325],"e7598d88-5ba5-11f1-b3e0-ee650bb23af1","Hero.tsx","019e75a2-f04c-7499-b28f-2662d63a284c",11,["D",1780090353414],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { type Cfg, CodeBlock, Eyebrow, Pill, Section } from \"./ui.tsx\";\nimport { type MailStats as MailStatsData } from \"../../db.ts\";\nimport { MailStats } from \"./Stats.tsx\";\n\nfunction shorten(addr: string) {\n return addr && addr.length > 12 ? `${addr.slice(0, 6)}…${addr.slice(-4)}` : addr;\n}\n\nexport function Hero({ cfg, stats }: { cfg: Cfg; stats: MailStatsData | null }) {\n const agentPrompt =\n `You can send real, physical mail (letters & postcards) through AgentSnailMail — a pay-per-piece HTTP API for AI agents. ` +\n `Read ${cfg.baseUrl}/v1/info to learn the endpoints, parameters, and pricing ` +\n `(and ${cfg.baseUrl} for more context). It's paid per piece over Tempo/MPP (USDC.e over HTTP 402), ` +\n `so use your wallet to pay. Once you understand the API, send a postcard for me.`;\n\n return (\n

\n Snail mail for AI agents\n

\n Your agent can mail a letter now.\n

\n One HTTP endpoint. Your agent pays a few cents in {cfg.assetSymbol} over{\" \"}\n \n Tempo/MPP\n , and a real letter or postcard gets printed and dropped in the mail — no account, no API key.\n

\n\n

\n Tempo mainnet\n {cfg.price}\n no content storage\n {cfg.live ? live · real mail : sandbox}\n

\n\n

\n \n Copy prompt for your agent\n \n

\n\n {stats ? : null}\n\n

\n \n {`$ tempo request -X POST ${cfg.baseUrl}/v1/mail \\\\\n --json '{\n \"type\": \"letter\",\n \"to\": {\n \"name\": \"Jane Doe\",\n \"line1\": \"210 King St\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94107\"\n },\n \"file_url\": \"https://example.com/letter.pdf\"\n }'`}\n \n \n {`HTTP/1.1 402 Payment Required\nWWW-Authenticate: Payment\n method=\"tempo\", intent=\"charge\",\n amount=\"1500000\" // 2-pg letter, in ${cfg.assetSymbol}\n currency=\"0x20C0…60E8b50\" // ${cfg.assetSymbol}\n recipient=\"${shorten(cfg.payTo)}\"\n chainId=4217 // Tempo mainnet`}\n \n

\n Any MPP client reads the challenge, pays, and retries — your code just gets back a job id.\n

\n );\n}\n",[],[215,315,333],"f04044d2-5ba5-11f1-9121-ee650bb23af1","Api.tsx","019e75a2-f04c-7499-b28f-21419bead9eb",["D",1780090368348],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { type Cfg, Card, CodeBlock, Eyebrow, Mono, Pill, Section } from \"./ui.tsx\";\n\nfunction Endpoint(\n { method, path, paid, children }: { method: string; path: string; paid?: boolean; children: any },\n) {\n const methodTone = method === \"GET\" ? \"blue\" : \"green\";\n return (\n \n

\n {method}\n {path}\n {paid ? 402 · paid : free}\n

\n {children}\n \n );\n}\n\nexport function Api({ cfg }: { cfg: Cfg }) {\n return (\n

\n API\n

Three endpoints. That's the whole thing.

\n Discover the service at GET /v1/info. Everything an agent needs — price, network,\n receiving address, and the request schema — is machine-readable.\n

\n\n

\n \n

\n Send a real letter or postcard. Returns 402 with payment terms until paid; on success returns a job id.\n

\n \n {`{\n \"type\": \"letter\", // or \"postcard\"\n \"to\": {\n \"name\": \"Jane Doe\",\n \"line1\": \"210 King St\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94107\" // country defaults to US\n },\n \"file_url\": \"https://…/letter.pdf\", // a public PDF URL …\n \"content_base64\": \"JVBERi0…\", // … or raw base64 bytes\n \"color\": false, // optional\n \"metadata\": { \"ref\": \"inv-42\" } // optional, echoed back, not stored\n}`}\n \n \n {`{\n \"type\": \"postcard\",\n \"to\": { \"name\": \"Jane Doe\", \"line1\": \"210 King St\",\n \"city\": \"San Francisco\", \"state\": \"CA\", \"zip\": \"94107\" },\n \"front\": \"https://…/front.png\", // PDF/PNG URL or inline HTML\n \"message\": \"Hello from my agent!\" // simple back message\n}`}\n \n \n {`{\n \"id\": \"lbt_ltr_ltr_5f3a…\",\n \"type\": \"letter\",\n \"status\": \"processing\",\n \"pages\": 2,\n \"expected_delivery\": \"2026-06-05\",\n \"price_usd\": \"1.50\",\n \"_links\": { \"self\": \"${cfg.baseUrl}/v1/mail/lbt_ltr_…\" }\n}`}\n \n \n\n \n

\n Poll delivery status — proxied live from the mail network. Status is one of{\" \"}\n queued, processing, mailed, delivered,{\" \"}\n failed. We hold no record of the contents.\n

\n \n\n \n

\n The machine-readable manifest: payment terms, the request schema, and a ready-to-run example.\n

\n \n

\n );\n}\n",[],[215,315,341],"404fdc7c-5ba5-11f1-b599-ee650bb23af1",["D",1780090073094],[233,234,235,236,237],[215,315],["D",1780090073094],[232,238,239,240,241],[215],["D",1780090073094],["D",1789509043237],{"_107":106,"_114":110},{"_107":106,"_108":-5,"_109":110,"_19":61,"_111":112,"_113":31},{"_13":14,"_38":93,"_49":48,"_94":50,"_95":96,"_97":98,"_99":56,"_100":101,"_102":103,"_104":51,"_105":106},"ctx",{"_86":-5,"_137":392,"_393":394,"_395":396,"_397":31,"_398":31,"_399":31,"_400":135,"_401":-5,"_402":-7,"_403":-7,"_404":67,"_405":31,"_406":31,"_407":-5,"_408":31,"_409":31,"_410":31,"_411":-5},"ENV",{"_363":364,"_365":366,"_367":93,"_368":369,"_370":371,"_372":373,"_374":375,"_376":377,"_378":379,"_380":381,"_382":383,"_384":385,"_386":387,"_388":389,"_390":391},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v17