${body}

\n \n \n \n`;\n}\n",[162,154],"60bc7f133696c4f31a8df179179e83f4774ddf03258943ed0abdd5a8706e2cad","frontend","c23392be-5b83-11f1-9e9b-ee650bb23af1","1881fa52-5b6b-11f1-a9ea-ee650bb23af1","9e1c8bb4-274b-4708-8b6c-c29d6ea270c2",94,["D",1780075688203],"/** @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 = \"Send a fax from an AI agent. Pay per fax in USDC.e over Tempo/MPP — no signup, no API key.\";\n return `\n\n \n \n \n agentfax — a fax 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",[162,154],"6113e29b36f27c2412ce1696ad5b8920d0d23c6eedbd45e573ddffcefc7182ba","frontend/demo.js",{"_32":182,"_13":175,"_89":183,"_91":165,"_92":33,"_93":184,"_95":26,"_34":185,"_40":97,"_98":99,"_100":186,"_66":48,"_102":-5,"_103":-7,"_82":187,"_105":188},{"_32":174,"_13":175,"_89":176,"_91":156,"_92":58,"_93":177,"_95":26,"_34":178,"_40":97,"_98":99,"_100":179,"_66":48,"_102":-5,"_103":-7,"_82":180,"_105":181},"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",[162,175],"9b54bc72c187ca99c4988da2c4a4e318c61c034f51d8eeb0df853795af87ccbf","3309e8f4-5b74-11f1-a656-ee650bb23af1","1bc83bae-5b6b-11f1-a9af-ee650bb23af1",38,["D",1780069005517],"// Minimal client JS: fire a real POST /v1/fax with no payment and show the\n// response (the 402 challenge in x402 mode, or a simulated fax in sandbox mode).\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/fax\", {\n method: \"POST\",\n headers: { \"content-type\": \"application/json\" },\n body: JSON.stringify({\n to: \"+14155550123\",\n file_url: \"https://example.com/invoice.pdf\",\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",[162,175],"817eb5f7e1f182fec97e2d99a59972f71d0b9d8c62039c6cf82c0294d161960a","frontend/components/ui.tsx",{"_32":202,"_13":193,"_89":203,"_91":204,"_92":33,"_93":205,"_95":26,"_34":206,"_40":207,"_98":99,"_100":208,"_66":48,"_102":-5,"_103":-7,"_82":209,"_105":210},{"_32":192,"_13":193,"_89":194,"_91":195,"_92":58,"_93":196,"_95":26,"_34":197,"_40":97,"_98":99,"_100":198,"_66":48,"_102":-5,"_103":-7,"_82":199,"_105":200},"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",[162,201,193],"08786f70f4928f22a24e32b220bb4c6a2b8ce9236d532d255a8c53ec2cc42fa1","components","653b27e6-5b6c-11f1-b3c6-ee650bb23af1","d94cc79a-5b6a-11f1-8821-ee650bb23af1","2cfc3eb1-20cd-46f7-9c4d-6cd1b987b684",25,["D",1780065653799],2,"/** @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: \"phaxio\" | \"sandbox\";\n mode: \"x402\" | \"sandbox\";\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\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",[162,201,193],"88c75430959d1b28150ead973ef8ceaab0d56ae8363276a3f1b8c8aedb4c9485","frontend/components/Stats.tsx",{"_32":221,"_13":215,"_89":222,"_91":204,"_92":33,"_93":223,"_95":48,"_34":224,"_40":225,"_98":99,"_100":226,"_66":48,"_102":-5,"_103":-7,"_82":227,"_105":228},{"_32":214,"_13":215,"_89":216,"_91":195,"_92":58,"_93":22,"_95":26,"_34":217,"_40":97,"_98":99,"_100":218,"_66":48,"_102":-5,"_103":-7,"_82":219,"_105":220},"dd800242-5ba5-11f1-b332-ee650bb23af1","Stats.tsx","019e75a2-f04c-7499-b28f-2d0cdd6807b5",["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",[162,201,215],"57618373f377450576caca163641cbd9365e2af9ab9bb7f75befeb363525f089","b0480300-5ba1-11f1-9de6-ee650bb23af1","b04803dc-5ba1-11f1-9de6-ee650bb23af1",136,["D",1780088543036],0,"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n// Small, friendly one-line \"public business\" ticker for under the hero CTA:\n// faxes sent · revenue · profit · how long we've been live, plus a tiny growth\n// sparkline. All server-rendered, no client JS. The sparkline is a plain SSR\n//

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

\n );\n}\n",[162,201,215],"498d90973e4c157c191a6f1c6611faf00f70d7efd94966ff5383b5bfc1824102","frontend/components/Sections.tsx",{"_32":240,"_13":233,"_89":241,"_91":204,"_92":33,"_93":60,"_95":26,"_34":242,"_40":157,"_98":99,"_100":243,"_66":48,"_102":-5,"_103":-7,"_82":244,"_105":245},{"_32":232,"_13":233,"_89":234,"_91":195,"_92":58,"_93":235,"_95":26,"_34":236,"_40":97,"_98":99,"_100":237,"_66":48,"_102":-5,"_103":-7,"_82":238,"_105":239},"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",[162,201,233],"9c665a70ccf471615cc781772aff14cf2a24ab9aacca0f09ac7607c53ba577cd","baa7554e-5ba1-11f1-b145-ee650bb23af1","fdf73a3a-5b6a-11f1-aa1f-ee650bb23af1",["D",1780088560435],"/** @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 number and document to /v1/fax. 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: \"Fax\",\n d: \"We send the fax, return a job id, and drop the payload. Poll /v1/fax/{id} for status.\",\n },\n ];\n return (\n

\n How it works\n

\n Ask → pay → fax, 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: { faxes: number; pages: number } | null }) {\n return (\n

\n \n What we store\n

\n Your documents are never stored.\n

\n The document goes straight to the fax network and is dropped — it never touches our database.\n We keep only minimal send metadata: destination, page count, amount, and the paying wallet.\n {stats && stats.faxes > 0\n ? ` So far we've relayed ${stats.faxes.toLocaleString()} fax${stats.faxes === 1 ? \"\" : \"es\"} (${stats.pages.toLocaleString()} page${stats.pages === 1 ? \"\" : \"s\"}).`\n : \"\"}\n

\n documents 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/fax`}\n \n \n

\n Want to watch a real{\" \"}\n fax arrive? Have an agent fax +19725329272 —{\" \"}\n \n Faxbeep\n 's free public test line — then find your pages in its gallery.\n (That's how the demo above was verified.)\n

\n );\n}\n\nexport function Footer() {\n return (\n \n );\n}",[162,201,233],"01bed85b9056644df4d05b67f632a77b8d2911ac62e20800d1e18fbb1e03ff97","frontend/components/Hero.tsx",{"_32":257,"_13":250,"_89":258,"_91":204,"_92":33,"_93":259,"_95":26,"_34":260,"_40":157,"_98":99,"_100":261,"_66":48,"_102":-5,"_103":-7,"_82":262,"_105":263},{"_32":249,"_13":250,"_89":251,"_91":195,"_92":58,"_93":252,"_95":26,"_34":253,"_40":97,"_98":99,"_100":254,"_66":48,"_102":-5,"_103":-7,"_82":255,"_105":256},"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",[162,201,250],"85479a6a33493ca636b5e0001624e2a704f063192c8a047786539eb7562a89bc","a885b5f4-5ba1-11f1-ae60-ee650bb23af1","e3d46286-5b6a-11f1-ae79-ee650bb23af1",135,["D",1780088530019],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { type Cfg, CodeBlock, Eyebrow, Pill, Section } from \"./ui.tsx\";\nimport { type FaxStats as FaxStatsData } from \"../../db.ts\";\nimport { FaxStats } 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: FaxStatsData | null }) {\n const agentPrompt =\n `You can send a real fax through agentfax — a pay-per-fax 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 call over Tempo/MPP (USDC.e over HTTP 402), ` +\n `so use your wallet to pay. Once you understand the API, send a test fax for me.`;\n\n return (\n

\n Fax for AI agents\n

\n Your agent can send a fax now.\n

\n One HTTP endpoint. Your agent pays a few cents in {cfg.assetSymbol} over{\" \"}\n \n Tempo/MPP\n , and the fax goes out — no account, no API key.\n

\n\n

\n Tempo mainnet\n {cfg.price}\n no document storage\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/fax \\\\\n --json '{\n \"to\": \"+14155550123\",\n \"file_url\": \"https://example.com/invoice.pdf\"\n }'`}\n \n \n {`HTTP/1.1 402 Payment Required\nWWW-Authenticate: Payment\n method=\"tempo\", intent=\"charge\",\n amount=\"400000\" // 2 pages × ${cfg.price}, 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",[162,201,250],"a8357a67a17a0eef6d8f0207158ae09984a605c1e4ab9827f1494e04409b2b48","frontend/components/Api.tsx",{"_32":275,"_13":268,"_89":276,"_91":204,"_92":33,"_93":277,"_95":26,"_34":278,"_40":111,"_98":99,"_100":279,"_66":48,"_102":-5,"_103":-7,"_82":280,"_105":281},{"_32":267,"_13":268,"_89":269,"_91":195,"_92":58,"_93":270,"_95":26,"_34":271,"_40":97,"_98":99,"_100":272,"_66":48,"_102":-5,"_103":-7,"_82":273,"_105":274},"f04044d2-5ba5-11f1-9121-ee650bb23af1","Api.tsx","019e75a2-f04c-7499-b28f-21419bead9eb",12,["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",[162,201,268],"276f3fa9a713657133dcd6d8c546d1438539dcbad1a152dd8f15bba1b81dafef","87ba0408-5b81-11f1-929e-ee650bb23af1","ed7aa17e-5b6a-11f1-8984-ee650bb23af1",86,["D",1780074731107],"/** @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 fax. Returns 402 with payment terms until paid; on success returns a job id.\n

\n \n {`{\n \"to\": \"+14155550123\", // E.164, required\n \"file_url\": \"https://…/doc.pdf\", // a public PDF URL …\n \"content_base64\": \"JVBERi0…\", // … or raw base64 bytes\n \"file_name\": \"doc.pdf\", // optional\n \"metadata\": { \"ref\": \"inv-42\" } // optional, echoed back, not stored\n}`}\n \n \n {`{\n \"id\": \"snc_8675309\",\n \"status\": \"sending\",\n \"to\": \"+14155550123\",\n \"pages\": 2,\n \"price_usd\": \"$0.40\",\n \"_links\": { \"self\": \"${cfg.baseUrl}/v1/fax/snc_8675309\" }\n}`}\n \n \n\n \n

\n Poll delivery status — proxied live from the fax network. Status is one of{\" \"}\n queued, sending, delivered, failed. We hold\n no record of the destination or document.\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",[162,201,268],"596a335834c1baaddc1530a139a8e9d01d4712cf5d8ce323467c7176e1a67739","frontend/App.tsx",{"_32":293,"_13":286,"_89":294,"_91":165,"_92":33,"_93":295,"_95":26,"_34":296,"_40":297,"_98":99,"_100":298,"_66":48,"_102":-5,"_103":-7,"_82":299,"_105":300},{"_32":285,"_13":286,"_89":287,"_91":156,"_92":58,"_93":288,"_95":26,"_34":289,"_40":97,"_98":99,"_100":290,"_66":48,"_102":-5,"_103":-7,"_82":291,"_105":292},"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",[162,286],"38b5cebe3311d998267578d2a26b94ea3961d30c712e0422b758aa29b3876ba1","a236357a-5ba1-11f1-ba47-ee650bb23af1","14a4fede-5b6b-11f1-9995-ee650bb23af1",134,["D",1780088519443],7,"/** @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 FaxStats } 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: \"sinch\" | \"sandbox\";\n price: string;\n stats: FaxStats | 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 mode: data.payment.mode,\n };\n\n return (\n

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

\n );\n}\n",[162,286],"98765d67a38ddd802888cee3e3e21df2cdf5dff8209094b6a5f0d91e5fed5ff6","db.ts",{"_32":311,"_13":301,"_89":312,"_91":-5,"_92":33,"_93":313,"_95":48,"_34":314,"_40":97,"_98":99,"_100":315,"_66":48,"_102":-5,"_103":-7,"_82":316,"_105":317},{"_32":304,"_13":301,"_89":305,"_91":-5,"_92":58,"_93":306,"_95":26,"_34":307,"_40":97,"_98":99,"_100":308,"_66":48,"_102":-5,"_103":-7,"_82":309,"_105":310},"981ae44c-5ba5-11f1-9682-ee650bb23af1","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",[301],"734c302354ce4d87bff07a6ccc12793db6fcbad22cc47f976011839e66e0eaff","9ec39f72-5ba1-11f1-b552-ee650bb23af1","ef1ec8b6-5b83-11f1-a640-ee650bb23af1",133,["D",1780088513648],"// Minimal metadata log — NEVER the document content. We record only innocuous\n// send metadata (destination, pages, amount, paying wallet) so we can show a\n// running total and basic analytics. The fax payload is never persisted.\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\n\nconst TABLE = \"fax_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 to_number 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 FaxLog {\n id: string;\n to: string;\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 FaxStats {\n faxes: number;\n pages: number;\n paidUsd: number;\n /** Cumulative pages over time (oldest→newest), for a sparkline. */\n series: number[];\n}\n\nexport async function logFax(rec: FaxLog): Promise {\n await init();\n await sqlite.execute({\n sql: `INSERT OR REPLACE INTO ${TABLE}\n (id, to_number, pages, amount_usd, payer, network, provider, status, created_at)\n VALUES (?,?,?,?,?,?,?,?,?)`,\n args: [rec.id, rec.to, rec.pages, rec.amount, rec.payer, rec.network, rec.provider, rec.status, rec.created_at],\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 faxStats(): 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 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 series.push(pages);\n }\n return { faxes: 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 faxStatsSafe(timeoutMs = 500): Promise {\n let timer: number | undefined;\n const stats = await Promise.race([\n faxStats().catch(() => null),\n new Promise((resolve) => {\n timer = setTimeout(() => resolve(null), timeoutMs);\n }),\n ]);\n clearTimeout(timer);\n if (!stats || stats.faxes === 0) return null;\n return stats;\n}\n",[301],"49b617e6f25f46617975c4bcb4c2b80fc3f89e9f5697e0e3b0b38e60d234216c",{"_82":319,"_84":320,"_86":-7},"fax.ts",{"_32":321,"_13":319,"_89":322,"_91":-5,"_92":33,"_93":323,"_95":48,"_34":324,"_40":94,"_98":99,"_100":325,"_66":48,"_102":-5,"_103":-7,"_82":326,"_105":327},"f6f3cd96-5b85-11f1-b2d1-ee650bb23af1","fb07a1c6-5b69-11f1-aa33-ee650bb23af1",115,["D",1780076635687],"// Pluggable fax backend.\n//\n// The document is never stored — it's forwarded to the fax network and dropped;\n// we hand back a job id and read status live from the provider. (A separate\n// metadata log in db.ts records send info only — never the document.)\n//\n// Live: Sinch Fax API v3 — needs SINCH_KEY_ID + SINCH_KEY_SECRET (OAuth2) and\n// SINCH_PROJECT_ID. Otherwise: a deterministic sandbox that simulates sending so\n// the full pay -> fax loop is demoable without a fax account.\n\nexport type FaxStatus = \"queued\" | \"sending\" | \"delivered\" | \"failed\";\nexport type Provider = \"sinch\" | \"sandbox\";\n\nexport interface FaxInput {\n to: string;\n fileUrl?: string; // public URL to a PDF (preferred — Sinch fetches it)\n contentBase64?: string; // base64-encoded document bytes\n fileName?: string; // used with contentBase64\n}\n\nexport interface FaxSendResult {\n provider: Provider;\n jobId: string; // opaque, provider-namespaced id we hand back to the caller\n status: FaxStatus;\n pages: number | null;\n error?: string;\n}\n\nfunction sinchKeyId() {\n return Deno.env.get(\"SINCH_KEY_ID\");\n}\nfunction sinchKeySecret() {\n return Deno.env.get(\"SINCH_KEY_SECRET\");\n}\nfunction sinchProjectId() {\n return Deno.env.get(\"SINCH_PROJECT_ID\");\n}\n\nexport function activeProvider(): Provider {\n return sinchKeyId() && sinchKeySecret() && sinchProjectId() ? \"sinch\" : \"sandbox\";\n}\n\n// --- Input handling ---------------------------------------------------------\n\nexport function normalizeNumber(to: string): string {\n const digits = to.trim().replace(/[^\\d+]/g, \"\");\n if (digits.startsWith(\"+\")) return digits;\n if (/^\\d{10}$/.test(digits)) return \"+1\" + digits; // bare NANP\n if (/^1\\d{10}$/.test(digits)) return \"+\" + digits;\n return \"+\" + digits;\n}\n\nexport function validateInput(input: FaxInput): string | null {\n if (!input.to || normalizeNumber(input.to).replace(/\\D/g, \"\").length < 8) {\n return \"`to` must be a valid phone number in E.164 format, e.g. +14155550123\";\n }\n if (!input.fileUrl && !input.contentBase64) {\n return \"Provide 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 return null;\n}\n\n// --- Job id (provider-namespaced, carries no payload) -----------------------\n\nexport function encodeJobId(provider: Provider, providerRef: string): string {\n return `${provider === \"sinch\" ? \"snc\" : \"sbx\"}_${providerRef}`;\n}\n\nexport function decodeJobId(id: string): { provider: Provider; ref: string } | null {\n const i = id.indexOf(\"_\");\n if (i < 0) return null;\n const prefix = id.slice(0, i);\n const ref = id.slice(i + 1);\n if (prefix === \"snc\") return { provider: \"sinch\", ref };\n if (prefix === \"sbx\") return { provider: \"sandbox\", ref };\n return null;\n}\n\n// --- Send -------------------------------------------------------------------\n\nexport async function sendFax(input: FaxInput): Promise {\n return activeProvider() === \"sinch\" ? sendViaSinch(input) : sendViaSandbox(input);\n}\n\n/** Live status lookup — no local state. */\nexport async function getStatus(\n jobId: string,\n): Promise<{ status: FaxStatus; pages: number | null; error?: string } | null> {\n const decoded = decodeJobId(jobId);\n if (!decoded) return null;\n return decoded.provider === \"sinch\" ? sinchStatus(decoded.ref) : sandboxStatus(decoded.ref);\n}\n\n// --- Sinch Fax API v3 -------------------------------------------------------\n\nlet _token: { value: string; exp: number } | null = null;\nasync function sinchToken(): Promise {\n const now = Date.now();\n if (_token && _token.exp > now + 60_000) return _token.value;\n const res = await fetch(\"https://auth.sinch.com/oauth2/token\", {\n method: \"POST\",\n headers: {\n Authorization: \"Basic \" + btoa(`${sinchKeyId()}:${sinchKeySecret()}`),\n \"content-type\": \"application/x-www-form-urlencoded\",\n },\n body: \"grant_type=client_credentials\",\n });\n const j = await res.json().catch(() => ({}));\n if (!j.access_token) throw new Error(`Sinch auth failed (HTTP ${res.status})`);\n _token = { value: j.access_token, exp: now + (Number(j.expires_in) || 3600) * 1000 };\n return _token.value;\n}\n\nfunction faxApiBase() {\n return `https://fax.api.sinch.com/v3/projects/${sinchProjectId()}/faxes`;\n}\n\nasync function sendViaSinch(input: FaxInput): Promise {\n let token: string;\n try {\n token = await sinchToken();\n } catch (e) {\n return { provider: \"sinch\", jobId: \"\", status: \"failed\", pages: null, error: String((e as Error).message) };\n }\n\n const form = new FormData();\n form.append(\"to\", normalizeNumber(input.to));\n const from = Deno.env.get(\"SINCH_FROM\");\n if (from) form.append(\"from\", from);\n if (input.fileUrl) {\n form.append(\"contentUrl\", 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 || \"document.pdf\");\n }\n\n const res = await fetch(faxApiBase(), {\n method: \"POST\",\n headers: { Authorization: `Bearer ${token}` },\n body: form,\n });\n const j = await res.json().catch(() => ({}));\n if (!res.ok || !j?.id) {\n return {\n provider: \"sinch\",\n jobId: \"\",\n status: \"failed\",\n pages: null,\n error: j?.message || j?.error || `Sinch error (HTTP ${res.status})`,\n };\n }\n return {\n provider: \"sinch\",\n jobId: encodeJobId(\"sinch\", String(j.id)),\n status: mapSinchStatus(j.status),\n pages: j.numberOfPages ?? null,\n };\n}\n\nasync function sinchStatus(ref: string): Promise<{ status: FaxStatus; pages: number | null; error?: string }> {\n const token = await sinchToken();\n const res = await fetch(`${faxApiBase()}/${encodeURIComponent(ref)}`, {\n headers: { Authorization: `Bearer ${token}` },\n });\n const j = await res.json().catch(() => ({}));\n return { status: mapSinchStatus(j?.status), pages: j?.numberOfPages ?? null, error: j?.errorType || undefined };\n}\n\nexport function mapSinchStatus(s: string | undefined): FaxStatus {\n switch (s) {\n case \"COMPLETED\":\n return \"delivered\";\n case \"FAILURE\":\n return \"failed\";\n case \"QUEUED\":\n return \"queued\";\n default:\n return \"sending\"; // IN_PROGRESS + unknowns\n }\n}\n\n// --- Sandbox (stateless: outcome is encoded in the job ref) -----------------\n\nconst SANDBOX_FAIL_NUMBERS = new Set([\"+15550000000\", \"+10000000000\"]);\n\nfunction sendViaSandbox(input: FaxInput): FaxSendResult {\n const to = normalizeNumber(input.to);\n const status: FaxStatus = SANDBOX_FAIL_NUMBERS.has(to) ? \"failed\" : \"delivered\";\n const ref = `${status}.${crypto.randomUUID().slice(0, 8)}`;\n return {\n provider: \"sandbox\",\n jobId: encodeJobId(\"sandbox\", ref),\n status,\n pages: status === \"delivered\" ? 1 : null,\n error: status === \"failed\" ? \"no_answer (simulated)\" : undefined,\n };\n}\n\nfunction sandboxStatus(ref: string): { status: FaxStatus; pages: number | null; error?: string } {\n const status = (ref.split(\".\")[0] as FaxStatus) || \"delivered\";\n return {\n status,\n pages: status === \"delivered\" ? 1 : null,\n error: status === \"failed\" ? \"no_answer (simulated)\" : undefined,\n };\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",[319],"bbc7e57cef51ba74cc3ce13f4f5a8f597fd667207d1f9c583d33753b3ede3d57",{"_82":329,"_84":-7,"_86":330},"mail.ts",{"_32":331,"_13":329,"_89":332,"_91":-5,"_92":58,"_93":207,"_95":26,"_34":333,"_40":225,"_98":99,"_100":334,"_66":48,"_102":-5,"_103":-7,"_82":335,"_105":336},"7ffcd1cc-5ba5-11f1-8826-ee650bb23af1","7ffcd276-5ba5-11f1-8826-ee650bb23af1",["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",[329],"e792d00be021c371fbd8dc3e6095c79395446fd4e7e16b5ccd37a07c4328e8b2",["D",1780090073094],"legacyEnvVars","httpPrivacy","description","Fax API for AI agents — paid per fax over x402 (USDC)","imageUrl","userId","4d11709c-f58a-4ebd-9aff-ea1a657da2f8","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount","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",{"_11":12,"_378":374},"org",{"_11":12,"_372":-5,"_373":374,"_343":344,"_375":376,"_377":48},"branch","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yb3FTYVlZMHVTOVMzVkV2T1hoT2hGb1o4c1YifQ","tier","free","canRestrictVals","profileImageUrl","","adoptOrgId",{"_32":59,"_13":14,"_34":526,"_46":-5,"_338":48,"_49":50,"_339":50,"_340":341,"_342":-5,"_343":344,"_345":-5,"_346":48,"_347":-5,"_348":-5,"_349":225,"_53":350,"_351":352,"_353":354,"_355":527,"_357":-5,"_358":359,"_360":359,"_361":362,"_363":362,"_364":362,"_365":359,"_366":359,"_367":528,"_369":529,"_371":530,"_47":48},"tree",[458,469,470,471,472,473,474,475,476],"files",[458,459,460,461,462,463,464,465,466,467,468,469,470,471,472,473,474,475,476],"counts",{"_448":225,"_449":97,"_450":225,"_451":452,"_453":454},"contents",[407,408,409,410,411,412,413,414,415],"file","upstreamProject",{"_32":39,"_13":56,"_340":341,"_342":-5,"_49":50,"_367":405},"upstreamBranch",{"_32":33,"_34":403,"_36":404,"_13":16,"_38":39,"_40":41,"_42":-5,"_43":-5,"_44":45,"_46":-5,"_47":48,"_49":50,"_51":52,"_53":54,"_55":56},"emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},["D",1780064564360],["D",1783436101628],{"_11":52,"_378":406},"https://images.clerk.dev/uploaded/img_2PqHa2Gsy93xQrjh2w78Xu0cChW.jpeg",{"_32":444,"_13":162,"_89":156,"_91":-5,"_92":58,"_93":97,"_95":26,"_34":445,"_40":225,"_98":446,"_100":-5,"_66":48,"_102":-5,"_82":447},{"_32":438,"_13":439,"_89":440,"_91":-5,"_92":58,"_93":97,"_95":26,"_34":441,"_40":225,"_98":390,"_100":442,"_66":48,"_102":-5,"_82":443},{"_32":304,"_13":301,"_89":305,"_91":-5,"_92":58,"_93":306,"_95":26,"_34":436,"_40":97,"_98":99,"_100":308,"_66":48,"_102":-5,"_82":437},{"_32":331,"_13":329,"_89":332,"_91":-5,"_92":58,"_93":207,"_95":26,"_34":434,"_40":225,"_98":99,"_100":334,"_66":48,"_102":-5,"_82":435},{"_32":134,"_13":131,"_89":135,"_91":-5,"_92":58,"_93":136,"_95":26,"_34":432,"_40":97,"_98":138,"_100":139,"_66":48,"_102":-5,"_82":433},{"_32":118,"_13":115,"_89":119,"_91":-5,"_92":58,"_93":57,"_95":26,"_34":430,"_40":111,"_98":99,"_100":121,"_66":48,"_102":-5,"_82":431},{"_32":88,"_13":83,"_89":90,"_91":-5,"_92":58,"_93":94,"_95":26,"_34":428,"_40":97,"_98":99,"_100":101,"_66":48,"_102":-5,"_82":429},{"_32":422,"_13":423,"_89":424,"_91":-5,"_92":58,"_93":97,"_95":26,"_34":425,"_40":225,"_98":99,"_100":426,"_66":48,"_102":-5,"_82":427},{"_32":416,"_13":417,"_89":418,"_91":-5,"_92":58,"_93":97,"_95":26,"_34":419,"_40":225,"_98":99,"_100":420,"_66":48,"_102":-5,"_82":421},"4050d7bc-5ba5-11f1-b599-ee650bb23af1","payment.ts","019e75a2-f04c-7499-b28f-694c692de314",["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",[417],"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",[423],["D",1780090232290],[83],["D",1780090450347],[115],["D",1780090292498],[131],["D",1780090180006],[329],["D",1780090220450],[301],"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",[439],"405006a2-5ba5-11f1-b599-ee650bb23af1",["D",1780090073094],"directory",[162],"pulls","branches","forks","envVars",{"_455":270,"_457":270},"connections",{"_455":225,"_456":225},"count","unfilledCount","emptyCount",{"_32":444,"_13":162,"_89":156,"_91":-5,"_92":58,"_93":97,"_95":26,"_34":523,"_40":225,"_98":446,"_100":-5,"_66":48,"_102":-5,"_103":524,"_82":525},{"_32":519,"_13":201,"_89":195,"_91":156,"_92":58,"_93":97,"_95":26,"_34":520,"_40":225,"_98":446,"_100":-5,"_66":48,"_102":-5,"_103":521,"_82":522},{"_32":267,"_13":268,"_89":269,"_91":195,"_92":58,"_93":270,"_95":26,"_34":271,"_40":97,"_98":99,"_100":272,"_66":48,"_102":-5,"_103":517,"_82":518},{"_32":249,"_13":250,"_89":251,"_91":195,"_92":58,"_93":252,"_95":26,"_34":253,"_40":97,"_98":99,"_100":254,"_66":48,"_102":-5,"_103":515,"_82":516},{"_32":232,"_13":233,"_89":234,"_91":195,"_92":58,"_93":235,"_95":26,"_34":236,"_40":97,"_98":99,"_100":237,"_66":48,"_102":-5,"_103":513,"_82":514},{"_32":214,"_13":215,"_89":216,"_91":195,"_92":58,"_93":22,"_95":26,"_34":217,"_40":97,"_98":99,"_100":218,"_66":48,"_102":-5,"_103":511,"_82":512},{"_32":192,"_13":193,"_89":194,"_91":195,"_92":58,"_93":196,"_95":26,"_34":197,"_40":97,"_98":99,"_100":198,"_66":48,"_102":-5,"_103":509,"_82":510},{"_32":285,"_13":286,"_89":287,"_91":156,"_92":58,"_93":288,"_95":26,"_34":289,"_40":97,"_98":99,"_100":290,"_66":48,"_102":-5,"_103":507,"_82":508},{"_32":174,"_13":175,"_89":176,"_91":156,"_92":58,"_93":177,"_95":26,"_34":178,"_40":97,"_98":99,"_100":179,"_66":48,"_102":-5,"_103":505,"_82":506},{"_32":498,"_13":499,"_89":500,"_91":156,"_92":58,"_93":97,"_95":26,"_34":501,"_40":225,"_98":390,"_100":502,"_66":48,"_102":-5,"_103":503,"_82":504},{"_32":153,"_13":154,"_89":155,"_91":156,"_92":58,"_93":157,"_95":26,"_34":158,"_40":97,"_98":99,"_100":159,"_66":48,"_102":-5,"_103":496,"_82":497},{"_32":438,"_13":439,"_89":440,"_91":-5,"_92":58,"_93":97,"_95":26,"_34":493,"_40":225,"_98":390,"_100":442,"_66":48,"_102":-5,"_103":494,"_82":495},{"_32":304,"_13":301,"_89":305,"_91":-5,"_92":58,"_93":306,"_95":26,"_34":307,"_40":97,"_98":99,"_100":308,"_66":48,"_102":-5,"_103":491,"_82":492},{"_32":331,"_13":329,"_89":332,"_91":-5,"_92":58,"_93":207,"_95":26,"_34":333,"_40":225,"_98":99,"_100":334,"_66":48,"_102":-5,"_103":489,"_82":490},{"_32":134,"_13":131,"_89":135,"_91":-5,"_92":58,"_93":136,"_95":26,"_34":137,"_40":97,"_98":138,"_100":139,"_66":48,"_102":-5,"_103":487,"_82":488},{"_32":118,"_13":115,"_89":119,"_91":-5,"_92":58,"_93":57,"_95":26,"_34":120,"_40":111,"_98":99,"_100":121,"_66":48,"_102":-5,"_103":485,"_82":486},{"_32":88,"_13":83,"_89":90,"_91":-5,"_92":58,"_93":94,"_95":26,"_34":96,"_40":97,"_98":99,"_100":101,"_66":48,"_102":-5,"_103":483,"_82":484},{"_32":422,"_13":423,"_89":424,"_91":-5,"_92":58,"_93":97,"_95":26,"_34":480,"_40":225,"_98":99,"_100":426,"_66":48,"_102":-5,"_103":481,"_82":482},{"_32":416,"_13":417,"_89":418,"_91":-5,"_92":58,"_93":97,"_95":26,"_34":477,"_40":225,"_98":99,"_100":420,"_66":48,"_102":-5,"_103":478,"_82":479},["D",1780090073094],[],[417],["D",1780090073094],[],[423],[],[83],[],[115],[],[131],[],[329],[],[301],["D",1780090073094],[],[439],[],[162,154],"404ff7ac-5ba5-11f1-b599-ee650bb23af1","favicon.svg","019e75a2-f04c-7499-b28f-421f4310be91",["D",1780090073094],"\n",[],[162,499],[],[162,175],[],[162,286],[],[162,201,193],[],[162,201,215],[],[162,201,233],[],[162,201,250],[],[162,201,268],"404fdc7c-5ba5-11f1-b599-ee650bb23af1",["D",1780090073094],[460,461,462,463,464],[162,201],["D",1780090073094],[459,465,466,467,468],[162],["D",1780090073094],["D",1789509043237],{"_11":12,"_378":374},{"_11":12,"_372":-5,"_373":374,"_343":344,"_375":376,"_377":48},{"_40":57,"_13":16,"_32":58,"_38":59,"_42":33,"_43":60,"_61":50,"_62":39,"_63":54,"_55":14,"_51":12},"ctx",{"_367":-5,"_400":564,"_565":566,"_567":568,"_569":48,"_570":48,"_571":48,"_572":26,"_573":-5,"_574":-7,"_575":-7,"_576":225,"_577":48,"_578":48,"_579":-5,"_580":48,"_581":48,"_582":48,"_583":-5},"ENV",{"_535":536,"_537":538,"_539":16,"_540":541,"_542":543,"_544":545,"_546":547,"_548":549,"_550":551,"_552":553,"_554":555,"_556":557,"_558":559,"_560":561,"_562":563},"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"]

Compare

Mergejchan7/mainintostevekrouse/main

db.ts+41-19

frontend/App.tsx+5-3

frontend/components/Api.tsx+34-17

frontend/components/Hero.tsx+23-15

frontend/components/Sections.tsx+24-27

frontend/components/Stats.tsx+10-11

frontend/components/ui.tsx+3-2

frontend/demo.js+12-5

frontend/render.tsx+4-4

Hmain.ts+170-81

mpp.ts+68-20

notify.ts+31-21

mail.ts+310-0

fax.ts+0-216